Voeg een Agent2Agent (A2A) agent toe als een connected agent (Microsoft Copilot)

Gebruik verbonden agenten zodat uw primaire agent specifieke taken kan delegeren aan gespecialiseerde agenten. Dit artikel laat zien hoe je een remote agent verbindt die beschikbaar is via het Agent2Agent (A2A) protocol, zodat je primaire agent taken aan hem kan overdragen.

Note

Het framework dat wordt gebruikt om deze agent te bouwen, maakt gebruik van gebruiksgebaseerde facturering. Het gebruiken, bouwen, testen en evalueren van agenten kan Copilot Credits kosten. Lees meer in Overzicht van gebruiksgebaseerde facturering.

Het A2A-protocol is een open standaard voor communicatie en samenwerking tussen agenten. Omdat het een open standaard is, kun je agenten koppelen die buiten Copilot Studio worden gehost en met andere frameworks zijn gebouwd, zolang ze A2A implementeren. Copilot Studio ontdekt de remote agent van zijn agentkaart en gebruikt vervolgens het A2A-protocol om taken aan deze te delegeren tijdens runtime.

Je voegt elke verbonden agent toe vanuit hetzelfde dialoogvenster Een verbonden agent toevoegen. Voor een overzicht van connected agents en hoe routing werkt, zie Connected agents overview. Om een andere Copilot Studio-agent te verbinden, zie Voeg een Copilot Studio-agent toe als een verbonden agent. Om een Microsoft Foundry-agent te verbinden, zie Voeg een Foundry-agent toe als verbonden agent.

Prerequisites

  • Een agent is gemaakt met het Microsoft Copilot-harnas om de primaire agent te zijn. Zie Een agent aanmaken (preview).
  • Een externe agent die het Agent-to-Agent-protocol implementeert en bereikbaar is via Copilot Studio via het publieke internet.
  • De URL van de agentkaart van de remote agent, meestal https://<your-agent-host>/.well-known/agent-card.json.
  • De authenticatiegegevens die de externe agent nodig heeft, indien van toepassing. Copilot Studio ondersteunt geen authenticatie, een API-sleutel en OAuth 2.0.
  • Voor OAuth 2.0 is toestemming vereist om een redirect-URI toe te voegen aan de app-registratie die door de identiteitsprovider van de externe agent wordt gebruikt. Copilot Studio genereert de redirect-URL tijdens de wizard, en je moet deze registreren voordat je de verbinding maakt.

Note

Omdat A2A-verbindingen gebruikmaken van de aangepaste connectorinfrastructuur, kunt u deze ook gebruiken om verbinding te maken met A2A-agents die on-premises of in een virtueel netwerk worden uitgevoerd.

Voeg een Agent2Agent (A2A) agent toe

De wizard leidt je door drie of vier stappen, afhankelijk van de gekozen authenticatiemethode:

  • Als je None of API-sleutel kiest: verbind met een A2A-agent, koppel met de A2A-agent, en klik vervolgens op Controleren en toevoegen.
  • Als je OAuth 2.0 kiest: Verbind met een A2A-agent, Voeg een redirect-URL toe, verbind met de A2A-agent, en Controleren en toevoegen.

  1. Meld u aan bij Copilot Studio.

  2. Kies en open de agent die u als primaire agent wilt gebruiken.

  3. Selecteer in de navigatiebalk van de agent het tabblad Bouw .

  4. Selecteer in het componentenpaneel Verbonden agenten om het dialoogvenster Een verbonden agent toevoegen te openen.

  5. Selecteer in het dialoogvenster Toevoegen en vervolgens A2A-agent toevoegen.

  6. Op de stap Connect to a A2A-agent voer je de gegevens van de remote agent in:

    • Agentkaart URL: de URL van de agentkaart van de externe agent, bijvoorbeeld https://agent.example.com/.well-known/agent-card.json. Copilot Studio leest de kaart om het eindpunt en de mogelijkheden van de agent te ontdekken.
    • Naam: de naam die aan de auteur van de agent wordt getoond. Als de agentkaart een naam bevat, vult Copilot Studio dit veld voor je in.
    • Beschrijving: een duidelijke beschrijving van wanneer deze A2A-agent gebruikt moet worden, tussen de 30 en 1.000 tekens. Als de agentenkaart een beschrijving bevat, vult Copilot Studio dit veld voor je in. De orchestrator gebruikt deze beschrijving om te beslissen wanneer een verzoek naar de agent wordt gestuurd, dus maak het specifiek en voorkom overlap met je andere tools en agenten. Lees meer over het schrijven van effectieve metadata.

    Note

    Als de naam en beschrijving niet automatisch worden ingevuld, heeft de externe agent misschien geen agentkaart, kan de kaart op een andere URL staan dan die je hebt ingevoerd, of kan Copilot Studio er niet bij komen. Controleer eerst de URL en probeer de agentkaart in je browser te openen. Als de kaart niet beschikbaar is, voer dan handmatig een naam en beschrijving in.

  7. Selecteer onder Authenticatie hoe Copilot Studio zich authenticeert met de externe agent en vul vervolgens de details in voor de methode die je hebt gekozen:

    Je kunt niet doorgaan totdat de authenticatiegegevens compleet zijn.

  8. Selecteer Volgende.

  9. Als je OAuth 2.0 hebt geselecteerd, verschijnt de stap Omleidings-URL toevoegen. Copilot Studio maakt de connector voor de A2A-agent, en het platform genereert een redirect-URL daarvoor. Registreer die URL bij je identiteitsprovider voordat je de verbinding aanmaakt:

    1. Wacht tot het Redirect-URL-veld is ingevuld. De connector moet bestaan voordat de URL wordt gegenereerd.
    2. Selecteer de kopieerknop naast het veld om de URL te kopiëren.
    3. Voeg in je OAuth-appregistratie de URL toe als een redirect-URI en sla de appregistratie op.
    4. Selecteer Volgende.

    Important

    Als je de redirect-URL niet eerst registreert, mislukt de eerste poging om de verbinding te autoriseren. De redirect-URL wordt per connector gegenereerd, dus deze is specifiek voor deze A2A-agent en kan niet opnieuw worden gebruikt vanuit een andere connector. Als je de URL later opnieuw nodig hebt, selecteer dan de A2A-agent onder Connected agents in het componentenpaneel om deze opnieuw te openen.

  10. In de stap Connect to the A2A agent kies je de verbinding die deze agent gebruikt om de remote agent te bereiken:

    • Selecteer een bestaande verbinding uit de lijst met beschikbare verbindingen.
    • Als er geen verbinding beschikbaar is, maak dan een nieuwe verbinding aan. Als de externe agent API-sleutelauthenticatie gebruikt, voer je de API-sleutelwaarde in wanneer je de verbinding aanmaakt.

  11. Selecteer Volgende.

  12. Controleer bij de stap Beoordelen en toevoegen de naam, beschrijving en de agent card URL, en selecteer vervolgens Toevoegen aan agent.

  13. Bevestig dat de verbonden agent onder Verbonden agenten in het componentenpaneel verschijnt.

Als je teruggaat en de authenticatie-instellingen op de stap Connect to an A2A agent verandert, verwijdert Copilot Studio de connector die is opgebouwd uit de vorige instellingen. Je moet een nieuwe redirect-URL registreren en opnieuw een verbinding kiezen.

Note

Je bent verantwoordelijk voor het zorgvuldig beoordelen en testen van verbonden agenten binnen de context van je specifieke gebruikssituaties, en het maken van alle passende beslissingen en aanpassingen. Wanneer u verbinding maakt met agenten van buiten Copilot Studio, bent u verantwoordelijk voor het gebruik van dergelijke agenten. Overwegingen zijn onder andere het waarborgen:

  • Datastromen, gegevensverwerking en gegevensdeling tussen agenten zijn geschikt voor jouw gebruikssituatie en voldoen aan relevante eisen en wetten.
  • Agenten voldoen aan de juiste normen voor kwaliteit, betrouwbaarheid, beveiliging en betrouwbaarheid.
  • Passende machtigingen, limieten en goedkeuringen worden ingericht, indien dat verstandig is voor jouw gebruiksscenario.
  • Juiste observabiliteit, identiteit en traceerbaarheid, en menselijke toezichtsfuncties zijn aanwezig.

VERIFICATIE van API-sleutel configureren

Wanneer je de API-sleutel selecteert, kies dan waar Copilot Studio de sleutel naartoe stuurt door een Parametertype te selecteren:

  • Header: de sleutel wordt als request-header verzonden. Voer in Header name de naam in van de header die de externe agent verwacht, zoals x-api-key.
  • Querystring: de sleutel wordt verzonden als een querystringparameter. Voer in het Parameterlabel de naam in van de querystringparameter die de externe agent verwacht.

Je voert de API-sleutelwaarde zelf in wanneer je de verbinding aanmaakt, niet in deze stap. Op die manier wordt de sleutel opgeslagen bij de verbinding en is hij niet zichtbaar in de agentconfiguratie.

OAuth 2.0-verificatie configureren

Wanneer je OAuth 2.0 selecteert, kies dan een configuratietype:

  • Dynamisch: Copilot Studio registreert een client bij de identiteitsprovider van de remote agent voor jou. Voer de autorisatie-URL en de token-URL in.

  • Handmatig: gebruik een app-registratie die je al hebt aangemaakt bij de identiteitsprovider van de externe agent. Voer de volgende waarden in:

    • Klant-ID: de klant-ID van je app-registratie.
    • client secret: het client secret van je app-registratie.
    • Autorisatie-URL: het authorization-endpoint van de identiteitsprovider.
    • Token-URL: het token-eindpunt van de identiteitsprovider.
    • Refresh token URL: het endpoint dat wordt gebruikt om toegangstokens te verversen.
    • Scopes (optioneel): de scopes die je moet aanvragen, gescheiden door spaties.

Gebruik Dynamic wanneer de identiteitsprovider van de remote agent dynamische clientregistratie ondersteunt. Gebruik Manual wanneer je de app-registratie wilt controleren, bijvoorbeeld wanneer je identiteitsprovider vooraf geregistreerde redirect-URI's of toestemming vereist.

Beide configuratietypes vereisen dat je een redirect-URL registreert bij je identiteitsprovider. Nadat je Next hebt geselecteerd, maakt Copilot Studio de connector aan en toont de gegenereerde redirect-URL in de stap Add redirect URL.

Zoek later de redirect-URL

Als je de wizard sluit of de redirect-URL verliest, kun je hem op elk moment opnieuw bekijken:

  1. Selecteer in het tabblad Build de A2A-agent onder Connected agents in het componentenpaneel.

  2. Kopieer in het dialoog 'A2A-agent bewerken ' de waarde in het veld ' Redirect URL '.

Het Redirect-URL-veld verschijnt alleen voor A2A-agenten die OAuth 2.0 gebruiken.

Hoe de orchestrator naar de A2A-agent routeert

Nadat je de A2A-agent hebt toegevoegd, bepaalt de orkestratieruntime automatisch wanneer ernaar moet worden gedelegeerd. De routeringsbeslissing is gebaseerd op:

  • De naam en beschrijving van de verbonden agent
  • Het bericht en de gesprekscontext van de gebruiker
  • De instructies van uw primaire agent

Tip

Schrijf een duidelijke, specifieke beschrijving voor de A2A-agent zodat de orkestrator nauwkeurig kan bepalen wanneer verzoeken naar hem gestuurd moeten worden. Vermijd overlappende beschrijvingen tussen verbonden agenten.

Testdelegatie

Nadat je de A2A-agent hebt toegevoegd:

  1. Selecteer op de agentnavigatiebalk het tabblad Voorbeeld.

  2. Stuur een bericht dat overeenkomt met het domein van de A2A-agent.

  3. Controleer of het antwoord van de A2A-agent komt en gepast is.

  4. Stuur een bericht buiten het domein van de A2A-agent om te bevestigen dat je primaire agent het regelt.

Als je later de naam of beschrijving moet wijzigen, bewerk dan de aangesloten agent vanuit het componentenpaneel. Zie Verbonden agenten in een agent beheren.

Problemen met de verbinding oplossen

Problem Wat u moet controleren
Het autoriseren van de verbinding mislukt met een redirect-URI-fout De doorverwijzings-URL die Copilot Studio heeft gegenereerd, is niet geregistreerd bij jouw identiteitsprovider. Kopieer de URL uit het dialoogvenster A2A-agent bewerken, voeg deze toe aan je app-registratie en autoriseer de verbinding opnieuw.
Het veld Redirect URL blijft leeg in de wizard De connector wordt nog steeds gemaakt. Als de stap in plaats daarvan een foutmelding geeft, selecteer Retry.
De naam en beschrijving worden niet ingevuld vanuit de agentkaart Controleer of de URL van de agentkaart correct is en dat Copilot Studio de kaart kan bereiken. Voer de naam en beschrijving handmatig in als de kaart niet beschikbaar is.
De verbinding die je hebt gemaakt werkt niet meer nadat je de wizard hebt bewerkt Het wijzigen van de authenticatie-instellingen maakt de connector die op basis van de vorige instellingen is gemaakt ongeldig. Registreer de nieuwe redirect-URL en kies opnieuw een verbinding.
  • Laatst bijgewerkt om