Przykładowy łącznik (wersja zapoznawcza)

Ważna

[Ten artykuł to dokumentacja wstępna, która może ulec zmianie].

Za pomocą akcji certyfikowanego łącznika w rozwiązaniu Contoso Hub — Łączniki można sprawdzić dostępne punkty rozszerzalności w aplikacji Sales.

Aby wypróbować akcję certyfikowanego łącznika, postępuj zgodnie z instrukcjami w temacie Zarządzanie rozszerzeniami agenta sprzedaży i włącz akcję łącznika Contoso Hub dla agenta sprzedaży.

Możesz edytować przykładowy łącznik i akcję, aby szybko rozpocząć pracę. Zapoznaj się z poniższymi wytycznymi podczas edytowania tworzenia łącznika i jego akcji:

  • Przykładowy łącznik zawiera symbol zastępczy dla ścieżek interfejsu API. Te symbole zastępcze można zastąpić rzeczywistymi ścieżkami interfejsów API.

  • Metody HTTP powinny być takie same, jak określone w przykładowej definicji OpenAPI.

  • Definicja OpenAPI zwracana przez łącznik służy do mapowania parametrów wejściowych i wyjściowych w oparciu o opisy. Wszystkie parametry wymagane w przykładowej definicji OpenAPI muszą się znajdować w faktycznej definicji łącznika oraz mieć poprawne opisy.

  • Typy parametrów wejściowych powinny być takie same, jak określone w definicji OpenAPI.

  • Interfejsy API opisane w definicji OpenAPI nie powinny zawierać żadnych innych wymaganych parametrów, które nie są obecne w przykładowej definicji OpenAPI. W przeciwnym razie Agent sprzedaży nie wywołuje interfejsów API i przestaje działać z powodu błędu wewnętrznego.

  • Nie należy używać connectorId jako parametru wejściowego w definicji OpenAPI, ponieważ jest to zarezerwowany parametr.

  • Właściwości obiektów wyjściowych oznaczonych jako wymagane w definicji OpenAPI muszą być obecne w odpowiedzi interfejsu API.

  • Każdy interfejs API łącznika powinien zakończyć swoje wykonanie w ciągu 5 sekund, a w szczególności akcje łącznika zwiększające istniejące możliwości.

  • Uwierzytelnianie powinno być obsługiwane przez konstrukcje łącznika Microsoft Power Platform i znajdować się poza zakresem poszczególnych interfejsów API.

  • Język bieżącego użytkownika jest przekazywany w nagłówku żądania jako Accept-Language. Używaj go do wszystkich operacji specyficznych dla języka.

  • Przeczytaj następujące nagłówki z żądania do łącznika i wyślij je do swojego zaplecza w celu lepszej diagnostyki:

    • x-ms-client-request-id: Unikatowy identyfikator używany na potrzeby śledzenia żądania wejściowego.
    • x-ms-user-agent: jako wartość jest używana "sales-copilot".

Rozszerzanie agenta sprzedaży przy użyciu aplikacji partnerskich
Kompilowanie rozszerzeń dla agenta sprzedaży

  • Last updated on