Lägg till ett verktyg i en agent (GitHub Copilot)

Du kan lägga till verktyg till din agent från fliken Bygg. Verktyg låter din agent utföra åtgärder, ansluta till externa tjänster och hämta realtidsdata under samtal.

Note

Funktionerna i denna artikel används av agenter eller arbetsflöden som drivs av GitHub Copilot-verktyget.

Användningsbaserad fakturering gäller för att använda, bygga, testa och utvärdera agenter. Dessa åtgärder kan förbruka Copilot-krediter. Läs mer i Hantera kostnader för agenter som drivs av GitHub Copilot-harnessen.

Förutsättningar

Lägg till ett befintligt verktyg från fliken Bygg

  1. Logga in på Copilot Studio och öppna din agent.

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

  3. I komponentpanelen, välj knappen Verktyg.

  4. I dialogen Lägg till ett verktyg , bläddra eller sök efter det verktyg du vill lägga till där. Använd flikarna Featured, Model Context Protocol (MCP), Connectors eller Workflows för att filtrera efter verktygstyp.

  5. Välj verktyget för att se dess detaljer, inklusive en beskrivning och de åtgärder det tillhandahåller.

    Note

    Om din organisation blockerade ett verktyg på grund av datapolicys kan du inte välja det. Läs mer i Verktyg som blockeras av din organisations policyer.

  6. Välj Lägg till för att lägga till verktyget i din agent.

Verktyg som är blockerade av organisationens policyer

Din organisation kan använda styrningspolicys för att begränsa vilka verktyg och kopplingar som finns tillgängliga i Copilot Studio.

När en datapolicy blockerar ett verktyg visas verktyget inaktiverat i panelen Lägg till ett verktyg och du kan inte välja det. Håll muspekaren över korsbilden av en korsikon i panelen Lägg till verktyg bredvid det inaktiverade verktyget för att se varför verktyget inte är tillgängligt.

Skärmdump som visar ett verktyg blockerat av en datapolicy i panelen Lägg till ett verktyg

Meddelandet identifierar policybegränsningen som förhindrar att verktyget kan användas. Om du behöver tillgång till ett blockerat verktyg, kontakta din administratör.

Läs mer i Konfigurera dataprinciper för agenter.

Konfigurera ett verktyg efter att du lagt till det

Efter att ha lagt till ett verktyg kan du behöva göra:

  • Autentisera: Vissa verktyg kräver att du loggar in eller lämnar uppgifter innan de kan användas. Följ autentiseringsinstruktionerna när de dyker upp.
  • Välj åtgärder: För kopplingar som tillhandahåller flera åtgärder kan du välja vilka specifika åtgärder som ska göras tillgängliga för din agent.
  • Gå igenom beskrivningen: Se till att verktygets beskrivning korrekt återspeglar vad det gör. Agentens körmiljö för orkestrering använder beskrivningen för att avgöra när verktyget ska anropas.

Lägg till ett nytt anpassat verktyg

Om verktyget du behöver inte finns i webbläsaren kan du lägga till ett anpassat verktyg. För närvarande har de agenter som drivs med GitHub Copilot-integrationen stöd för att lägga till följande som anpassade verktyg:

  • MCP-verktyg från en befintlig Model Context Protocol (MCP)-server. Detta gör att du kan ansluta till anpassade tjänster, databaser eller API:er som exponerar funktioner som verktyg via MCP-standarden.
  • Arbetsflöden som du skapar i Copilot Studio:s flödesdesigner. Detta gör att du kan definiera flerstegsprocesser som din agent kan utföra vid behov.

Tips för effektiva verktygsbeskrivningar

Tip

Verktygets namn och beskrivning är avgörande för korrekt verktygsinkallelse. Den förbättrade orkestreringsruntimen använder dessa för att avgöra när ett verktyg ska anropas, så:

  • Använd tydliga, specifika namn som beskriver verktyget (till exempel "Skapa supportärende" istället för "Ärendeverktyg")
  • Skriv beskrivningar som förklarar när verktyget ska användas och vad det ger
  • Undvik vaga eller överlappande beskrivningar mellan verktygen