Dodawanie narzędzi do agentów niestandardowych

Narzędzia to moduły konstrukcyjne, które umożliwiają agentowi interakcję z systemami zewnętrznymi. Narzędzia rozszerzają funkcjonalność agenta, umożliwiając mu wykonywanie różnych akcji w odpowiedzi na żądania użytkowników lub zadziałanie autonomicznych wyzwalaczy. Każde narzędzie reprezentuje określoną funkcjonalność, którą agent może wykonywać. Na przykład można wyposażyć agenta w narzędzia, które wykonują następujące czynności:

• Wysyłanie wiadomości e-mail przy użyciu łącznika usługi Office 365 Outlook
• Sprawdzanie bieżących warunków pogodowych i prognoz
• Odczytywanie i zapisywanie danych z usługi Dataverse
• Odczytywanie i publikowanie komunikatów w usłudze Teams

Mechanizmy dodawania narzędzi

Możliwości niestandardowego agenta można rozszerzyć, dodając jedno lub więcej narzędzi. Agent może za pomocą narzędzi do automatycznego odpowiadać użytkownikom przy użyciu generatywnej orkiestracji. Narzędzia można również wywołać jawnie z poziomu tematu.

Dzięki generatywnej orkiestracji (domyślnie aktywnej) agent może automatycznie wybrać najbardziej odpowiednie narzędzie lub temat albo przeszukiwać zasoby wiedzy, aby odpowiedzieć użytkownikowi. Ten tryb orkiestracji tworzy bardziej dynamiczne i inteligentne środowisko konwersacji.

W trybie klasycznym (orkiestracja generatywna wyłączona) agent może używać tylko tematów do odpowiadania użytkownikowi. Jednak nadal możesz zaprojektować agent tak, aby jawnie wywoływał narzędzia z poziomu tematów.

Dostępnych jest kilka mechanizmów dodawania narzędzi do agenta:

• Łącznik: łączenie się z autorskimi interfejsami API i usługami przy użyciu łączników platformy Power Platform w celu ściągnięcia danych lub wykonania akcji.
  • Wstępnie utworzony łącznik: wybierz spośród zbioru predefiniowanych połączeń z tysiącami popularnych interfejsów API do usług Microsoft i innych dostawców.
  • Łącznik niestandardowy: zdefiniuj połączenie z niestandardową usługą lub systemem, aby włączyć niestandardowe opcje narzędzi przy użyciu łączników platformy Power Platform. Łącznik musi mieć uprawnienia do wyświetlania i udostępniania w organizacji, aby agent mógł go używać.
• Przepływ agenta: zdefiniuj przepływ agenta, w tym co najmniej jedną akcję do wykonania.
• Monit: jednowątkowy monit oparty na modelu, który może się odwoływać do wskazanego źródła wiedzy i generować kod w celu analizowania danych.
• Interfejs API REST: zdefiniuj połączenie z interfejsem API REST oraz wybierz co najmniej jeden punkt końcowy i metody interfejsu API, które mają zostać dodane jako narzędzia.
• Protokół kontekstu modelu Model Context Protocol: połącz się z serwerem MCP, aby uzyskać dostęp do narzędzi i zasobów.
• Używanie komputera: umożliwia agentowi interakcję z dowolnym systemem mającym graficzny interfejs użytkownika, witrynami internetowymi i aplikacjami klasycznymi, klikanie przycisków, wybieranie menu i wprowadzanie tekstu do pól na ekranie.

Istnieją dwa inne mechanizmy, których można użyć do dodawania zachowania narzędziowego dla Twojego agenta:

• Umiejętności: kontener dla zestawu powiązanych narzędzi.
• Narzędzie klienta: Wyślij aktywność zdarzenia do klienta, aby klient wykonał akcję i zwrócił odpowiedź.

Aby uzyskać więcej informacji na temat umiejętności i narzędzi klienckich, zobacz linki w sekcji Powiązana zawartość.

Tworzenie i dodawanie nowego narzędzia na poziomie agenta

Tworzenie nowych narzędzi bezpośrednio w programie Copilot Studio usprawnia proces opracowywania i gwarantuje właściwą integrację z agentem. Narzędzia dodane do agenta są dostępne do automatycznej orkiestracji podczas konwersacji agenta.

1. Otwórz niestandardowego agenta, wybierając w lewym okienku nawigacji pozycję Agenci i wybierając agenta z listy.

2. Zostanie wyświetlona strona agenta Narzędzia.

3. Wybierz Dodaj narzędzia.

4. W okienku Dodawanie narzędzia wybierz opcję Nowe narzędzie.

5. Z wyświetlonej listy wybierz typ narzędzia, które chcesz dodać:

   • Monit
   • Przepływ agenta
   • Agent używania komputera
   • Łącznik niestandardowy
   • Protokół kontekstu modelu
   • interfejs API REST

   

6. Wykonaj czynności konfiguracyjne specyficzne dla wybranego typu narzędzia. Jeśli na przykład wybierzesz pozycję Monit, musisz wykonać następujące kroki:

   • Definiowanie szablonu i instrukcji monitu
   • Określ parametry wejściowe
   • Konfigurowanie źródeł wiedzy
   • Ustawianie formatu i ograniczeń odpowiedzi

7. Odpowiednio do sytuacji wybierz pozycję Zapisz lub Opublikuj, aby utworzyć nowe narzędzie.

8. Wybierz Dodaj i skonfiguruj. Narzędzie jest dodawane do agenta. Zostanie wyświetlona strona konfiguracji narzędzia. Tutaj można wyświetlać i wprowadzać zmiany w konfiguracji narzędzia.

Nowe narzędzie można wyświetlić na stronie Narzędzia agenta.

Wyświetlanie i wprowadzanie zmian w konfiguracji narzędzia

Konfigurację narzędzia można wyświetlać i edytować w dowolnym momencie: przejdź do strony Narzędzia agenta i wybierz narzędzie z listy narzędzi.

Zostanie otwarta strona konfiguracji narzędzia. Szczegóły są wyświetlane w trzech sekcjach:

• Szczegóły
• Dane wejściowe
• Zakończenie

Jeśli jako narzędzia połączono serwery MCP, strona konfiguracji wygląda inaczej niż dla innych typów narzędzi. Sekcja Szczegóły jest podobna, ale zamiast sekcji Dane wejściowe i Wykonanie są sekcje Narzędzia i Zasoby z informacjami o narzędziach i zasobach dostępnych dla serwera MCP. Aby uzyskać więcej informacji, zobacz Wyświetlanie narzędzi i zasobów na istniejącym serwerze MCP.

Szczegóły

Sekcja Szczegóły umożliwia skonfigurowanie podstawowych informacji o narzędziu.

W tym miejscu można wyświetlić i zaktualizować:

• Nazwa: nazwa narzędzia. Ta nazwa jest wyświetlana na liście narzędzi agenta. Wybierz nazwę, która wyraźnie wskazuje funkcję narzędzia.

• Opis: opis narzędzia. Generatywna orkiestracja bazuje na tym opisie w celu określenia, kiedy agent powinien używać narzędzia. Wprowadź jasne, konkretne opisy, w tym informacje o tym, co robi narzędzie i kiedy należy go użyć.

• Dodatkowe szczegóły:

  • Zezwalaj agentowi na dynamiczne decydowanie, kiedy użyć narzędzia: gdy ta opcja jest wybrana, agent może używać orkiestracji generatywnej do określenia, kiedy używać narzędzia. Jeśli ta opcja nie jest zaznaczona, agent używa tego narzędzia tylko wtedy, gdy jest jawnie wywoływane z określonego tematu. (Domyślnie ta opcja jest wybierana, gdy orkiestracja generowania jest włączona.)
  • Zapytaj użytkownika końcowego przed uruchomieniem: Na czacie użytkownika końcowego poproś agenta o potwierdzenie przed uruchomieniem narzędzia. Domyślnie ta opcja ma wartość Nie.
  • Uwierzytelnianie: wybierz, czy dla tego narzędzia chcesz używać poświadczeń użytkownika (Użytkownik końcowy), czy twórcy (Podane przez twórcę). Domyślnie jest stosowane uwierzytelnianie użytkownika.
  • Opis: Opcjonalnie można dodać opis narzędzia, który agent będzie wyświetlał użytkownikowi, gdy ten zechce uruchomić narzędzie. Ten opis informuje użytkownika o tym, co ma uwierzytelnić.

Dane wejściowe

W tym miejscu można wyświetlić i skonfigurować dane wejściowe dla narzędzia. Dane wejściowe są używane do zbierania informacji od użytkownika w celu wypełnienia danych wejściowych wymaganych dla narzędzia. Informacje są wyświetlane jako tabela, po jednym wierszu dla każdej danej wejściowej.

Domyślnie wartość kolumny Wypełnij przy użyciu dla każdego wejścia jest ustawiona na Dynamiczne wypełnianie za pomocą AI. Agent próbuje wyodrębnić wartość z dostępnego kontekstu — na przykład z wiadomości użytkownika. Jeśli nie zostanie znaleziona odpowiednia wartość, pomocnik generuje prośbę o podanie wartości przez użytkownika. Wybierz pozycję Dostosuj, aby uzyskać dostęp do bardziej szczegółowych dostosowań dotyczących zbierania i wypełniania danych wejściowych:

• Nazwa wyświetlana i opis: sposób wyświetlania danych wejściowych użytkownikowi.
• Zidentyfikuj jako: jak odpowiedź użytkownika zostanie zinterpretowana, na przykład jako ciąg tekstu lub zamapowana na wstępnie zdefiniowaną jednostkę.
• Logika ponawiania: Jeśli agent nie zidentyfikuje encji w wypowiedzi użytkownika, może ponownie zadać pytanie.
• Sprawdzanie poprawności danych wejściowych: skonfiguruj dodatkowe zachowanie weryfikacji danych wejściowych użytkownika, wykraczające poza domyślne dla tego typu encji.

Możesz również zastąpić dane wejściowe jawną wartością zamiast zezwalać agentowi na wyodrębnienie danych wejściowych. Aby ustawić nadpisanie, ustaw Wypełnij przy użyciu na Wartość niestandardowa i wprowadź wartość, wybierz zmienną lub użyj formuły Power FX. Jeśli dane wejściowe są zastępowane, agent nie prosi użytkownika o wartość.

Zakończenie

W tym miejscu można określić, co ma się dziać, gdy narzędzie zakończy pracę.

Agent może automatycznie wygenerować kontekstową odpowiedź dla użytkownika na podstawie zapytania i wyniku z narzędzia.

Alternatywnie można utworzyć określoną sformatowaną odpowiedź, która ma być zwracana przez narzędzie. Odwołania do zmiennych wyjściowych z narzędzia można wstawiać za pomocą selektora zmiennych. Do sformatowania odpowiedzi można również użyć formuł Power Fx.

W sekcji Po uruchomieniu wybierz jedną z kilku różnych opcji reakcji narzędzia na użytkownika po jego uruchomieniu:

• Nie odpowiadaj (ustawienie domyślne): agent uwzględnia dane wyjściowe narzędzia w odpowiedzi
• Napisz odpowiedź za pomocą generatywnej AI: Pozwól sztucznej inteligencji utworzyć odpowiedź kontekstową przy użyciu danych wyjściowych narzędzia
• Wyślij konkretną odpowiedź: Utwórz szablonową odpowiedź z wstawieniem zmiennej
• Wyślij kartę adaptacyjną: Twórz rozbudowane, interakcyjne odpowiedzi za pomocą przycisków i akcji

Można również określić, które zmienne wyjściowe mają być udostępniane agentowi i innym narzędziom.

Wybór narzędzi i zbieranie danych wejściowych

Podczas definiowania narzędzia w programie Copilot Studio należy również podać informacje opisujące jego przeznaczenie. Te informacje umożliwiają agentowi stwierdzenie, kiedy należy użyć narzędzia. Opis narzędzia pomaga również orkiestratorowi używać generatywnej sztucznej inteligencji do generowania pytań w celu zbierania danych wejściowych. Agent może używać pytań do zbierania informacji w celu uzupełnienia danych wejściowych potrzebnych do używania narzędzia. W związku z tym nie trzeba ręcznie tworzyć węzłów pytań, aby zebrać wszystkie potrzebne dane wejściowe, takie jak dane wejściowe w przepływie. Orkiestrator agenta obsługuje zbieranie danych wejściowych w czasie wykonywania.

Przy wybieraniu narzędzia agent uwzględnia kilka czynników:

• Nazwa i opis narzędzia
• Bieżący kontekst rozmowy
• Intencja użytkownika wywnioskowana z jego wiadomości
• Dostępne wejścia i wyjścia
• Poprzednie użycie narzędzia w konwersacji

W trybie generatywnym domyślnie narzędzia zwracają informacje do agenta. Na podstawie odpowiedzi z narzędzia agent może wygenerować kontekstową odpowiedź na zapytanie użytkownika. Alternatywnie można poinstruować narzędzie, aby zawsze odpowiadało natychmiast poprzez wygenerowanie komunikatu lub utworzenie jednoznacznej wiadomości.

Wywoływanie istniejącego narzędzia z poziomu tematu

Narzędzie można również wywołać jawnie z poziomu tematu. W zależności od przypadku użycia narzędzia można używać w ramach szerszego tematu, w którym jest używanych więcej węzłów. Lub, podobnie jak w przykładzie pogodowym, dodanie węzła do tematu może być wszystkim, czego potrzebujesz.

Wywołanie narzędzia z poziomu tematu:

1. W usłudze Copilot Studio przejdź do strony Tematy dotyczącej agenta, którego chcesz edytować.

2. Utwórz nowy temat i nadaj mu nazwę, na przykład Pobieranie pogody.

3. Dodaj odpowiednie elementy w sekcji Frazy wyzwalające. Aby kontynuować korzystanie z tego samego przykładu o pogodzie z poprzedniego kroku, frazy wyzwalające mogą obejmować:

   • czy będzie padać
   • dzisiejsza prognoza
   • pobieranie pogody
   • jaka jest pogoda

4. Wybierz pozycję Dodaj węzeł (+), a następnie wybierz pozycję Dodaj narzędzie. Wybierz narzędzie spośród dostępnych narzędzi. Istnieją trzy karty przedstawiające różne typy narzędzi:

   • Podstawowe narzędzia
   • Łącznik
   • Narzędzie

   Węzeł Akcja został dodany do tematu.

5. Wybierz pozycję Zapisz.

Informacje o łączniku MCP

Można wyświetlić nazwy i opisy narzędzi i zasobów MCP udostępnianych przez łącznik MCP. Informacje o narzędziach i zasobach są wyświetlane w tabeli, po jednym wierszu dla każdego narzędzia.

Zagadnienia dotyczące uwierzytelniania narzędzi

Niektóre narzędzia do poprawnego działania wymagają uwierzytelniania. Dotyczy to np. dynamicznych monitów oraz narzędzi wywołujących interfejs API usługi Dataverse. Właściwa konfiguracja uwierzytelniania zapewnia bezpieczeństwo przy zachowaniu sprawnie działającego środowiska użytkownika.

Narzędzia są zawsze uruchamiane w środowisku uruchomieniowym agenta w kontekście użytkownika i nie można ich uruchomić, jeśli nie jest włączone uwierzytelnianie. Obsługiwane są dwa typy uwierzytelniania:

• Poświadczenia użytkownika końcowego: agent używa poświadczeń użytkownika do uwierzytelniania w usłudze. Ta metoda gwarantuje, że użytkownicy uzyskują dostęp tylko do danych, do których mają uprawnienia.
• Poświadczenia podane przez twórcę: agent używa poświadczeń twórcy do uwierzytelniania w usłudze. Używaj tego trybu uwierzytelniania do zasobów udostępnionych lub gdy użytkownicy nie powinni potrzebować indywidualnego dostępu.

Przetestuj swoje narzędzie

W orkiestracji generatywnej orkiestrator wybiera narzędzie ustawione przez użytkownika, gdy uzna je za istotne dla zapytania użytkownika.

Alternatywnie możesz wywołać istniejące narzędzie z poziomu tematu.

Włączanie lub wyłączanie narzędzia w agencie

Narzędzie można włączyć lub wyłączyć dla agenta na stronie konfiguracji narzędzia. Wyłączenie narzędzia uniemożliwi agentowi korzystanie z narzędzia, ale narzędzie jest nadal połączone z agentem i można je włączyć później. Po dodaniu narzędzia do agenta jest ono domyślnie włączone.

Aby wyłączyć narzędzie w agencie:

1. Przejdź do agenta i wybierz stronę Narzędzia agenta.
2. Wybierz narzędzie, aby przejść do strony jego konfiguracji.
3. W górnej części strony konfiguracji wyłącz narzędzie przy użyciu przełącznika Włączone.
4. Wybierz Zapisz, aby zastosować zmianę.

Narzędzie nadal jest widoczne na liście narzędzi agenta, ale nie jest już włączone.

Usuwanie narzędzia z agenta

Wyłączenie narzędzia uniemożliwia korzystanie z niego, ale także zapewnia elastyczność włączenia go w przyszłości. Można również usunąć narzędzie bardziej trwale z agenta. Aby usunąć narzędzie z agenta:

1. Przejdź do agenta i wybierz stronę Narzędzia agenta.
2. Za liście narzędzi znajdź narzędzie i umieść kursor na jego nazwie. Wybierz trzy kropki (...).
3. Wybierz Usuń. Pojawi się okno potwierdzenia.
4. Wybierz Usuń, aby usunąć narzędzie.

Narzędzie zniknie z listy narzędzi agenta.

Powiązana zawartość

• Używanie łączników platformy
• Użycie monitów
• Używanie przepływów agenta z agentem
• Protokół kontekstu modelu (MCP, ang. model context protocol)
• Dodawanie narzędzi z interfejsu API REST
• Używanie umiejętności
• Narzędzia klienta
• Używanie komputera (wersja zapoznawcza)