Łączenie z agentem platformy Microsoft Foundry (wersja zapoznawcza)

Note

W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.

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

Możesz połączyć agenta platformy Microsoft Foundry Agent z agentem niestandardowym, co umożliwi temu ostatniemu wywołanie go w celu odpowiadania użytkownikowi lub na wyzwalacz.

Ważna

Ten artykuł zawiera dokumentację usługi Microsoft Copilot Studio w wersji zapoznawczej i może ulec zmianie.

Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu można szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Jeśli tworzysz agenta gotowego do użycia w środowisku produkcyjnym, zobacz Omówienie usługi Microsoft Copilot Studio.

Wymagania wstępne

Zanim połączysz agenta Microsoft Foundry z Copilot Studio, agent Foundry musi mieć włączony punkt końcowy protokołu Activity. Nowo utworzony agent Foundry domyślnie udostępnia tylko Responses i punkty końcowe protokołu A2A . Jeśli punkt końcowy Activity nie jest włączony, połączenie z Copilot Studio kończy się niepowodzeniem w czasie wykonywania z kodem błędu 400. Dowiedz się więcej w artykule Włączanie przychodzącego ruch A2A na agencie Foundry.

Obecnie możesz włączyć endpoint Activity tylko programowo, korzystając z API REST lub Python SDK. Nie ma opcji włączenia tego w portalu Microsoft Foundry. Dowiedz się więcej o procedurze włączenia w Konfiguruj i udostępnij swojego agenta.

Po włączeniu punktu końcowego Działanie sekcja Punkty końcowe dla agenta w portalu Foundry nadal wyświetla tylko Odpowiedzi i A2A. To pominięcie interfejsu jest spodziewane i nie oznacza, że zmiana się nie powiodła. Połączenie z Copilot Studio działa po wdrożeniu aktualizacji.

Połącz się z agentem Microsoft Foundry

1. Przejdź do strony Agenci dla głównego agenta i wybierz pozycję Dodaj agenta.

2. W obszarze Połącz z agentem zewnętrznym wybierz pozycję Microsoft Foundry z dostępnych typów agentów.

3. Wybierz żądane połączenie z listy dostępnych połączeń lub utwórz nowe połączenie między programem Microsoft Foundry i agentem programu Copilot Studio. Aby utworzyć nowe połączenie, musisz podać adres URL punktu końcowego projektu Foundry.

   Note

   Podczas nawiązywania połączenia z agentami microsoft Foundry z programu Copilot Studio można łączyć się tylko z agentami utworzonymi w nowym portalu Microsoft Foundry. Połączenie z agentem utworzonym w poprzednim portalu skutkuje błędem 404 - Version not found.

4. Po utworzeniu połączenia wybierz pozycję Dalej.

5. Wprowadź odpowiednią nazwę i opis dla tego agenta zestawu SDK. Opis powinien wyjaśniać cel agenta Microsoft Foundry, co pozwala głównemu agentowi zrozumieć, kiedy należy go używać. Aby uzyskać więcej informacji, zobacz Pisanie efektywnych metadanych.

6. Wprowadź identyfikator agenta platformy Microsoft Foundry, z którym chcesz nawiązać połączenie.

7. Dostosuj opis (jeśli trzeba), aby był bardziej kontekstowy dla głównego agenta. Na przykład wprowadź bardziej szczegółowy opis, jeśli masz inne narzędzia lub agentów, w których opisy mogą się pokrywać. Zaktualizuj opis, aby Copilot Studio wiedziało, kiedy wywołać tego agenta.

8. Wybierz Dodaj Agenta.

9. Po utworzeniu agenta możesz natychmiast przetestować go. Jeśli musisz później dostosować Identyfikator agenta, możesz to zrobić na stronie szczegółów, wybierając agenta z listy Agenci.

Note

• Jeśli pierwsze testowe połączenie do połączonego agenta Foundry zakończy się błędem podobnym do „Łącznik 'Azure AI Foundry Agent Service' zwrócił błąd HTTP z kodem 400. Błąd wewnętrzny: Endpoint Agenta <name> nie obsługuje aktywności. Zaktualizuj punkt końcowy agenta, aby obsługiwał ten protokół.”, agent usługi Foundry nie ma włączonego punktu końcowego protokołu Activity. Zobacz Wymagania wstępne w tym artykule, a następnie włącz punkt końcowy działania, postępując zgodnie z instrukcjami w sekcji Konfigurowanie i udostępnianie agenta w dokumentacji Microsoft Foundry.

• Jesteś odpowiedzialny za dokładne przeglądanie i testowanie powiązanych agentów w kontekście swoich konkretnych zastosowań oraz za podejmowanie wszystkich odpowiednich decyzji i dostosowań. Gdy łączysz się z agentami spoza usługi Copilot Studio, ponosisz odpowiedzialność za korzystanie z tych agentów. Należy uwzględnić zapewnienie, że:

  • Przepływy danych, obsługa i wymiana danych między agentami są odpowiednie dla Twojego przypadku użycia i spełniają odpowiednie wymagania oraz przepisy.
  • Agenci spełniają odpowiednie standardy jakości, niezawodności, bezpieczeństwa i wiarygodności.
  • Odpowiednie uprawnienia, granice i zatwierdzenia są zapewnione, jeśli jest to rozsądne dla Twojego zastosowania.
  • Zapewniono odpowiednie mechanizmy obserwowalności, identyfikacji i identyfikowalności oraz funkcje nadzoru ze strony człowieka.