Voeg een tool toe aan een agent (GitHub Copilot)

Je kunt tools toevoegen aan je agent via het tabblad Bouw . Tools laten je agent acties uitvoeren, verbinding maken met externe diensten en realtime data ophalen tijdens gesprekken.

Notitie

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

Prerequisites

Voeg een bestaande tool toe via het tabblad Bouw

  1. Log in bij Copilot Studio en open je agent.

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

  3. Selecteer in het componentenpaneel de knop Tools .

  4. In het menu 'Een tool toevoegen ' blader of zoek je naar de tool die je wilt toevoegen. Gebruik de tabbladen Featured, Model Context Protocol (MCP), Connectors of Workflows om te filteren op gereedschapstype.

  5. Selecteer het hulpmiddel om de details te bekijken, inclusief een beschrijving en de acties die het aanbiedt.

    Notitie

    Als je organisatie een tool heeft geblokkeerd vanwege databeleid, kun je die niet selecteren. Lees meer in Tools die door het beleid van uw organisatie worden geblokkeerd.

  6. Selecteer Toevoegen om de tool aan je agent toe te voegen.

Hulpmiddelen die geblokkeerd worden door het beleid van uw organisatie

Uw organisatie kan governance-beleid gebruiken om te beperken welke tools en connectors beschikbaar zijn in Copilot Studio.

Wanneer een databeleid een tool blokkeert, verschijnt de tool uitgeschakeld in het panel 'Toevoegen een tool ' en kun je het niet selecteren. Beweeg de muisaanwijzer over het kruispictogram Afbeelding van een kruispictogram in het deelvenster Gereedschap toevoegen naast het uitgeschakelde gereedschap om te zien waarom het gereedschap niet beschikbaar is.

Screenshot die een tool toont die geblokkeerd is door een databeleid in het panel Gereedschap toevoegen

Het bericht identificeert de beleidsbeperking die voorkomt dat de tool wordt gebruikt. Als je toegang nodig hebt tot een geblokkeerde tool, neem dan contact op met je beheerder.

Meer informatie vindt u in Gegevensbeleid configureren voor agents.

Configureer een tool nadat je het hebt toegevoegd

Na het toevoegen van een tool moet je misschien:

  • Authenticeren: Sommige tools vereisen dat je inlogt of inloggegevens verstrekt voordat ze gebruikt kunnen worden. Volg de authenticatieprompts wanneer ze verschijnen.
  • Selecteer acties: Voor connectors die meerdere acties bieden, kun je selecteren welke specifieke acties beschikbaar worden gesteld aan je agent.
  • Bekijk de beschrijving: Zorg ervoor dat de beschrijving van het hulpmiddel nauwkeurig weergeeft wat het doet. De orchestratieruntime van de agent gebruikt de beschrijving om te bepalen wanneer de tool moet worden aangeroepen.

Voeg een nieuw aangepast hulpmiddel toe

Als de tool die je nodig hebt niet beschikbaar is in de browser, kun je een aangepaste tool toevoegen. Momenteel ondersteunen de agenten die worden aangedreven door de GitHub Copilot-kabel het toevoegen van de volgende als aangepaste tools:

  • MCP-tools van een bestaande Model Context Protocol (MCP)-server. Dit stelt je in staat om verbinding te maken met aangepaste diensten, databases of API's die mogelijkheden als tools via de MCP-standaard beschikbaar stellen.
  • Workflows die je maakt in de flow designer van Copilot Studio. Dit stelt je in staat om meerstapsprocessen te definiĆ«ren die je agent op aanvraag kan uitvoeren.

Bestanden die je agent aanmaakt

Sommige tools produceren bestanden als output - bijvoorbeeld een gegenereerd rapport, spreadsheet of afbeelding. Deze bestanden zijn elk beperkt tot 10 MB, en bestanden die de limiet overschrijden worden niet aan de gebruiker teruggegeven. Lees meer in Bestanden die de agent aanmaakt (GitHub Copilot preview).

Tips voor effectieve toolbeschrijvingen

Tip

De naam en beschrijving van het hulpmiddel zijn cruciaal voor een nauwkeurige tool-aanroeping. De enhanced orchestration runtime gebruikt deze om te bepalen wanneer een tool wordt aangeroepen, dus:

  • Gebruik duidelijke, specifieke namen die het hulpmiddel beschrijven (bijvoorbeeld "Aanmaken supportticket" in plaats van "Tickettool")
  • Schrijf beschrijvingen waarin wordt uitgelegd wanneer het hulpmiddel gebruikt moet worden en wat het teruglevert
  • Vermijd vage of overlappende beschrijvingen tussen tools