Lägg till en Foundry-agent som en ansluten agent (Microsoft Copilot)

Använd kopplade agenter för att låta din primära agent delegera specifika uppgifter till specialiserade agenter. Den här artikeln visar hur du ansluter en befintlig Microsoft Foundry-agent så att din primära agent kan överlämna uppgifter till den.

Du lägger till varje ansluten agent från samma dialogruta Lägg till en ansluten agent . För en översikt över uppkopplade agenter och hur routing fungerar, se Översikt över anslutna agenter. För att koppla en annan Copilot Studio-agent, se Lägg till en Copilot Studio-agent som en ansluten agent. För att ansluta en fjärragent över Agent2Agent (A2A)-protokollet, se Lägg till en A2A-agent som en ansluten agent. För att koppla en agent byggd med SDK för Microsoft 365-agenter, se Lägg till en SDK för Microsoft 365-agenter-agent som en ansluten agent.

Prerequisites

• En agent skapad med Microsoft Copilot harness för att vara den primära agenten. Se Skapa en agent (förhandsversion).
• En befintlig Foundry-agent skapad i ett projekt i Microsoft Foundry-portalen, med Activity-protokollet aktiverat och agentens Agent-ID tillgängligt. Foundry-agenter har inte Activity-protokollet aktiverat som standard. Se Aktivera aktivitetsprotokollet på din Foundry-agent.
• URL:en för Azure AI Project endpoint för projektet som är värd för Foundry-agenten.
• Tillstånd att få tillgång till Foundry-projektet. Anslutningen autentiseras med din Microsoft Entra ID-användarinloggning.

Lägg till en Foundry-agent

1. Logga in på Copilot Studio.

2. Välj och öppna den agent du vill använda som primär agent.

3. I agentens navigationsfält, välj fliken Bygg.

4. I komponentpanelen, välj Anslutna agenter för att öppna dialogen Lägg till en ansluten agent.

5. I dialogrutan väljer du Lägg till och sedan Lägg till Foundry-agent.

6. På steget Connect to Azure AI Foundry väljer du den anslutningen som agenten använder för att nå Microsoft Foundry:

   • Välj en befintlig anslutning från listan Anslutning.
   • Om ingen anslutning är tillgänglig, välj Skapa ny anslutning och fortsätt till nästa steg.

7. Om du skapar en ny anslutning, ange anslutningsdetaljerna och välj sedan Skapa:

   • Visningsnamn (valfritt): ett namn som hjälper dig att identifiera denna koppling senare.
   • Autentiseringstyp: Microsoft Entra ID användarinloggning. Detta värde är inställt för dig.
   • Azure AI Project Endpoint: endpoint-URL:en till Foundry-projektet som hostar agenten.

8. Gå tillbaka till steget Connect to Azure AI Foundry, bekräfta att din anslutning är vald och välj sedan Nästa.

9. I steget Granska och lägg till , ange uppgifterna för den Foundry-agent du vill koppla till och välj sedan Lägg till till agent:

   • Namn: namnet som visas för agentförfattaren.
   • Beskrivning: en tydlig beskrivning av när denna Foundry-agent ska användas. Orkestratorn använder denna beskrivning för att avgöra när en begäran ska skickas vidare till agenten, så gör den specifik och undvik överlappning med dina andra verktyg och agenter. Mer information finns i skriva effektiva metadata.
   • Agent ID: ID:t på Foundry-agenten du vill koppla upp dig mot.

10. Bekräfta att den anslutna agenten visas under Connected agents i komponentpanelen.

Aktivera Activity-protokollet på din Foundry-agent

Copilot Studio kommunicerar med en ansluten Foundry-agent genom att använda Activity-protokollet. Foundry-agenter har inte detta protokoll aktiverat som standard, så du måste aktivera det innan din primära agent kan utbyta meddelanden med Foundry-agenten. Om Activity-protokollet inte är aktiverat kan du fortfarande lägga till anslutningen, men att anropa Foundry-agenten misslyckas.

Du kan aktivera Activity-protokollet på något av följande sätt:

• Publicera Foundry-agenten till Microsoft 365 eller Microsoft Teams. När du publicerar en promptagent till Microsoft 365 eller Teams aktiveras Activity-protokollet och det nödvändiga BotServiceRbac auktoriseringsschemat automatiskt. Välj detta alternativ om du redan planerar att publicera agenten på dessa kanaler.

• Aktivera det manuellt med ett REST API-anrop. Om du inte publicerar agenten till Microsoft 365 eller Teams, anropa Foundry Agents - Update agent REST API för att lägga till protokollet activity och auktorisationsschemat BotServiceRbac i agenten.

För mer information om hur du konfigurerar och delar din Foundry-agent, se Konfigurera och dela din Microsoft Foundry-agent.

Aktivera Activity-protokollet med ett REST API-anrop

Anropa Foundry Agents – Uppdatera agent REST API. Ersätt {{endpoint}}, {{agent_name}}, och {{token}} med endpoint, agentnamn och åtkomsttoken för ditt Foundry-projekt.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview

{
    "agent_endpoint": {
        "protocols": [
            "responses",
            "activity"
        ],
        "authorization_schemes": [
            {
                "type": "Entra",
                "isolation_key_source": {
                    "kind": "Entra"
                }
            },
            {
                "type": "BotServiceRbac"
            }
        ]
    }
}

Hur orkestratören dirigerar till Foundry-agenten

Efter att du lagt till Foundry-agenten bestämmer orkestreringsruntimen automatiskt när den ska delegera till den. Routningsbeslutet baseras på:

• Den anslutna agentens namn och beskrivning
• Användarens meddelande och konversationskontext
• Instruktionerna för din primära agent

Testdelegering

Efter att du lagt till Foundry-agenten:

1. I agentens navigeringsfält väljer du fliken Förhandsversion.

2. Skicka ett meddelande som matchar Foundry-agentens domän.

3. Kontrollera att svaret kommer från Foundry-agenten och är lämpligt.

4. Skicka ett meddelande utanför Foundry-agentens domän för att bekräfta att din primära agent hanterar det.

Om du behöver ändra agent-ID eller beskrivning senare, redigera den anslutna agenten från komponentpanelen. Se Hantera anslutna agenter i en agent.

Relaterad information

• Översikt över anslutna agenter
• Lägg till en Copilot Studio-agent som en ansluten agent
• Lägg till en A2A-agent som en ansluten agent
• Lägg till en SDK för Microsoft 365-agenter-agent som en ansluten agent
• Hantera anslutna agenter i en agent
• Bygg en agent
• Konfigurera och dela din Microsoft Foundry-agent
• Vad är Microsoft Foundry Agent Service?