Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Jeśli potrzebne narzędzie nie jest dostępne jako gotowe, konektor lub workflow tool, możesz dodać własne narzędzie, importując REST API ze specyfikacji OpenAPI.
Dodanie interfejsu API REST jako narzędzia do agenta zasilanego przez harness Customer Conversation jest podobne do dodania interfejsu API REST do agenta zasilanego przez standardowy harness. Aby dowiedzieć się więcej, zobacz Rozszerz agenta za pomocą narzędzi z interfejsu API REST (wersja zapoznawcza).
Wymagania wstępne
- Kopia specyfikacji OpenAPI dla API REST, do którego chcesz się połączyć.
- Wiedza o rodzaju uwierzytelniania potrzebnym do połączenia z API oraz szczegóły uwierzytelniania.
Dodaj narzędzie REST API
Na zakładce Build wybierz kafelek głównego agenta, aby otworzyć panel konfiguracyjny. Jeśli dodałeś jakichkolwiek podagentów, wybierz zamiast tego kartę podagenta, aby skonfigurować tego podagenta.
W sekcji Narzędzia wybierz pozycję Dodaj narzędzie.
W oknie Dodaj narzędzie wybierz zakładkę REST API (lub wybierz Dodaj>API REST).
W dialogu nowego REST API wykonaj następujące kroki kreatora:
Prześlij specyfikację: Zaimportuj swoją specyfikację OpenAPI (Swagger 2.0) lub OpenAPI 3.0. Przeciągnij i upuść plik JSON lub YAML (do 5 MB) albo wybierz Przeglądaj, aby wybrać jeden.
Szczegóły wtyczki API: Nadaj swojemu narzędziu nazwę i opis, którego agent może użyć, aby zdecydować, kiedy je wywołać. Przejrzyj i, jeśli zajdzie taka potrzeba, edytuj następujące pola przed kontynuacją:
- Nazwa narzędzia: Początkowo wypełniona tytułem w przesłanej specyfikacji API.
- Opis: Początkowo wypełnione z opisu w przesłanej specyfikacji API. Dostarcz szczegółowy opis, ponieważ orkiestracja agenta wykorzystuje ten opis do określenia, kiedy użyć tego narzędzia.
- Rozwiązanie: Wybierz rozwiązanie Power Platform, w którym chcesz przechowywać to narzędzie, lub pozostaw je puste, aby system mógł automatycznie utworzyć narzędzie dla Ciebie.
Uwierzytelnianie: Wybierz sposób, w jaki agent uwierzytelnia się za pomocą tego API:
- Brak: Do dostępu do API nie jest wymagane uwierzytelnianie.
-
Klucz API: Twój agent prosi użytkownika o podanie klucza API w czasie działania, a następnie łączy się z API za pomocą tego klucza. Podajesz etykietę (nazwę wyświetlaną podczas połączenia), nazwę parametru (na przykład
X-API-Key), oraz lokalizację (nagłówek lub zapytanie). - OAuth 2.0: Użytkownicy uwierzytelniają się do API przez dostawcę tożsamości bez udostępniania swoich danych uwierzytelniających agentowi. Dostarczasz wartości takie jak Client ID, Client Secret, Authorization URL, Token URL oraz Refresh URL.
Wybierz narzędzia: W sekcji Dostępne narzędzia wybierz ikonę plus obok każdego narzędzia obsługiwanego przez API (połączenie endpoint i metody HTTP, takie jak get, put, post lub delete), które chcesz udostępnić swojemu agentowi. Użyj pola wyszukiwania, aby znaleźć konkretną operację.
Konfiguruj narzędzie: Dla każdego wybranego narzędzia skonfiguruj nazwę narzędzia i opis. Opisy są początkowo wypełniane ze specyfikacji API. Podaj szczegółowy opis, ponieważ orkiestracja agenta wykorzystuje ten opis do określenia, kiedy użyć tego konkretnego narzędzia.
Wybierz parametry narzędzia: Przejrzyj wartości wejściowe i wyjściowe oraz zaktualizuj opisy w razie potrzeby. Możesz aktualizować opisy parametrów, ale nie same wartości parametrów. Jeśli jakiś opis jest pusty, wypełnij go przed kontynuowaniem. Powtórz wybieranie narzędzi przez kroki Wybierz parametry narzędzia dla każdego narzędzia, które chcesz dodać z API.
Przegląd: Sprawdź nazwę narzędzia, opis, typ uwierzytelniania oraz liczbę wybranych narzędzi przed publikacją.
Publikuj: Wybierz Publikuj , aby utworzyć narzędzie i udostępnić je swojemu agentowi.
Połącz narzędzie po publikacji
Zanim agent będzie mógł użyć opublikowanego narzędzia, musisz utworzyć lub wybrać dla niego połączenie, niezależnie od wybranego typu uwierzytelniania, w tym Braku.
- Wybierz opublikowane narzędzie, aby dodać je do swojego agenta.
- W oknie dialogowym Połącz znazwa narzędzia wybierz Wybierz połączenie, następnie wybierz istniejące połączenie lub stwórz nowe:
- Wybierz + Nowe połączenie.
- W oknie dialogowym Połącz znazwa narzędzia opcjonalnie wpisz nazwę wyświetlaną dla połączenia. Ta nazwa pojawia się na liście połączeń.
- Wybierz Utwórz.
- Wybierz Dodaj i skonfiguruj , aby dokończyć dodawanie narzędzia do swojego agenta.