Ansluta till en Microsoft Foundry-agent (förhandsversion)

Note

Denna artikel beskriver funktioner i agenter eller agentflöden som använder standard harness.

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Du kan ansluta en Microsoft Foundry-agent till din anpassade agent så att den kan anropa den här agenten för att svara på en användare eller en utlösare.

Important

Den här artikeln innehåller dokumentation om förhandsversionen av Microsoft Copilot Studio och kan ändras.

Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att du kan få tidig tillgång och ge feedback.

Om du bygger en produktionsklar agent, se Översikt över Microsoft Copilot Studio.

Förutsättningar

Innan du kopplar en Microsoft Foundry-agent till Copilot Studio måste Foundry-agenten ha Activity-protokollets endpoint aktiverad. En nyskapad Foundry-agent exponerar endast Responses och A2A-protokollets endpoints som standard. Om Activity-endpointen inte är aktiverad misslyckas anslutningen till Copilot Studio vid körning med ett felmeddelande 400. Läs mer i Aktivera inkommande A2A på en Foundry-agent.

Du kan för närvarande aktivera Activity-endpointen endast programmatiskt, genom att använda REST API eller Python SDK. Det finns inget alternativ att aktivera det via Microsoft Foundry-portalen. Läs mer om aktiveringsprocessen i Configure and Share your agent.

Efter att du aktiverat Aktivitetsändpunkten fortsätter Foundry-portalens Endpoints-sektion för agenten att visa endast Svar och A2A. Att detta inte visas i användargränssnittet är förväntat och innebär inte att ändringen misslyckades. Anslutningen till Copilot Studio fungerar efter att uppdateringen har applicerats.

Koppla upp dig mot en Microsoft Foundry-agent

1. Gå till sidan Agenter för huvudagenten och välj Lägg till en agent.

2. Under Anslut till en extern agent väljer du Microsoft Foundry bland de tillgängliga agenttyperna.

3. Välj önskad anslutning i listan över tillgängliga anslutningar eller skapa en ny anslutning mellan Microsoft Foundry och din Copilot Studio-agent. Om du vill skapa en ny anslutning måste du ange slutpunkts-URL:en för Foundry-projektet.

   Note

   När du ansluter till Microsoft Foundry-agenter från Copilot Studio kan du bara ansluta till agenter som skapats i den nya Microsoft Foundry-portalen. Att ansluta till en agent som skapats i den tidigare portalen resulterar i ett felmeddelande som anger 404 - Version not found.

4. När anslutningen har skapats väljer du Nästa.

5. Ange ett lämpligt namn och beskrivning för din SDK-agent. Beskrivningen bör beskriva syftet med din Microsoft Foundry-agent, så att huvudagenten kan förstå när den ska användas. Mer information finns i skriva effektiva metadata.

6. Ange agent-ID:t för den Microsoft Foundry-agent som du vill ansluta till.

7. Justera beskrivningen (om det behövs) så att den blir mer kontextuell för huvudagenten. Gör till exempel beskrivningen mer specifik om du har andra verktyg eller agenter där beskrivningarna kan överlappa varandra. Uppdatera beskrivningen för att säkerställa att Copilot Studio kan förstå när denna agent ska anropas.

8. Välj Lägg till agent.

9. När agenten har skapats kan du testa din agent omedelbart. Om du behöver justera agent-ID:t senare kan du göra det på informationssidan genom att välja din agent i listan Agenter.

Note

• Om ditt första testanrop till den anslutna Foundry-agenten misslyckas med ett fel liknande "Anslutningen 'Azure AI Foundry Agent Service' returnerade ett HTTP-fel med kod 400. Inre fel: Agentens <name> endpoint stöder inte aktivitet. Vänligen uppdatera agentens endpoint för att stödja detta protokoll.", Foundry-agenten har inte Activity-protokollets endpoint aktiverat. Se Förkunskaper i denna artikel, aktivera sedan Aktivitetsändpunkten genom att följa Konfigurera och dela din agent i Microsoft Foundry-dokumentationen.

• Du ansvarar för att noggrant granska och testa anslutna agenter i kontexten av dina specifika användningsområden och fatta alla lämpliga beslut och anpassningar. När du ansluter till agenter utanför Copilot Studio ansvarar du för användningen av sådana agenter. Överväganden inkluderar att säkerställa:

  • Dataflöden, datahantering och datadelning mellan agenter är lämpliga för ditt användningsfall och uppfyller relevanta krav och lagar.
  • Agenter uppfyller lämpliga krav på kvalitet, tillförlitlighet, säkerhet och trovärdighet.
  • Lämpliga behörigheter, gränser och godkännanden tillhandahålls, om det är lämpligt för ditt användningsområde.
  • Korrekt observerbarhet, identitet och spårbarhet samt mänskliga tillsynsfunktioner finns på plats.