Lägga till verktyg i anpassade agenter

2025-06-16

Verktyg är de byggstenar som gör det möjligt för din agent att interagera med externa system. Verktyg utökar funktionerna i din agent så att den kan utföra olika åtgärder som svar på användarbegäranden eller autonoma utlösare. Varje verktyg representerar en specifik funktion som agenten kan utföra. Du kan till exempel utrusta din agent med verktyg som gör saker som:

Skicka e-postmeddelanden med Office 365 Outlook-anslutningsappen
Kontrollera aktuella väderförhållanden och prognoser
Läsa och skriva data från Dataverse
Läsa och publicera meddelanden till Teams

Mekanismer för att lägga till verktyg

Du kan utöka funktionerna i din anpassade agent genom att lägga till ett eller flera verktyg. Din agent kan använda verktyg för att svara användarna automatiskt med generativ orkestrering. Du kan också anropa verktyg explicit inifrån ett ämne.

Med generativ orkestrering (aktiv som standard) kan agenten automatiskt välja det lämpligaste verktyget eller ämnet, eller söka efter kunskap, för att svara en användare. Det här orkestreringsläget skapar en mer dynamisk och intelligent konversationsupplevelse.

I klassiskt läge (generativ orkestrering inaktiverad) kan en agent bara använda ämnen för att svara användaren. Du kan dock fortfarande utforma din agent så att den uttryckligen anropar verktyg inifrån olika ämnen.

Det finns flera tillgängliga mekanismer för att lägga till verktyg i din agent:

Fördefinierad anslutningsapp: Välj bland ett urval av förinställda anslutningar till tusentals populära API:er från både Microsoft- och icke-Microsoft-tjänster.
Anpassad kontakt: Definiera en anslutning till en anpassad tjänst eller ett system för att möjliggöra anpassade verktygsalternativ med hjälp av Power Platform-kontakter.
Agentflöde: Definiera ett agentflöde, inklusive en eller flera åtgärder att utföra.
Prompt: Enstegsprompt baserad på modell, som kan referera till kunskap du tillhandahåller.
REST API-anslutning: Definiera en anslutning till ett REST API och välj en eller flera API-slutpunkter och metoder som ska läggas till som verktyg.
McP-verktyg (Model Context Protocol): Anslut till en MCP-server för att få åtkomst till verktyg.
Datoranvändningsagent (förhandsversion): Låter din agent interagera med alla system som har ett grafiskt användargränssnitt, för webbplatser och skrivbordsappar, välja knappar, välja menyer och ange text i fält på skärmen.

När vi pratar om verktyg i den här artikeln och det här avsnittet i dokumentationen menar vi en av mekanismerna i den här gruppen. Dessa verktygstyper kan läggas till i din agent och konfigureras på liknande sätt.

Det finns två andra mekanismer som du kan använda för att lägga till verktygsliknande beteende i din agent:

Färdigheter: Behållare för en uppsättning relaterade verktyg.
Klientverktyg: Skicka en händelseaktivitet till klienten så att klienten utför en åtgärd och returnerar ett svar.

Mer information om färdigheter och klientverktyg finns i länkarna i avsnittet Relaterat innehåll .

Skapa och lägga till ett nytt verktyg på agentnivå

Att skapa nya verktyg direkt i Copilot Studio effektiviserar utvecklingsprocessen och säkerställer korrekt integrering med din agent. Verktyg som läggs till i en agent är tillgängliga för automatisk orkestrering i agentens konversationer.

Öppna din anpassade agent genom att välja Agenter i vänster navigeringsfönster och välja din agent i listan.
Gå till sidan Verktyg för agenten.
Välj Lägg till ett verktyg.
I fönstret Lägg till verktyg väljer du Nytt verktyg.
Välj den typ av verktyg som du vill lägga till i listan som visas:
- Fråga: Skapa AI-baserade textgenererings- och analysverktyg
- Agentflöde: Skapa processer i flera steg med villkorsstyrd logik
- Datoranvändning: Aktivera GUI-automatisering för äldre system
- Anpassad anslutningsmodul: Anslut till proprietära API'er och tjänster
- REST API: Direktintegrering med webbtjänster
Utför konfigurationsstegen som är specifika för den typ av verktyg som du har valt. Om du till exempel väljer Fråga måste du utföra följande steg:
- Definiera promptmallen och anvisningarna
- Ange indataparametrarna
- Konfigurera kunskapskällor
- Ange svarsformat och begränsningar
Testa verktygskonfigurationen med hjälp av förhandsgranskningspanelen för att säkerställa att den fungerar som förväntat.
Välj Spara för att skapa det nya verktyget.
Välj Lägg till i agent för att lägga till verktyget i din agent. Du kan se det nya verktyget på sidan Verktyg för agenten.

Visa och göra ändringar i verktygskonfigurationen

Du kan visa och redigera konfigurationen av verktyget när som helst: gå till sidan Verktyg för din agent och välj verktyget i listan med verktyg.

Sidan Verktygsinformation öppnas och visar konfigurationen av verktyget. Informationen visas i tre avsnitt:

Detaljer
Indata
Slutförande (verktyg för MCP-anslutningsprogram)

Detaljer

I avsnittet Information kan du konfigurera grundläggande information om verktyget.

Här kan du visa och uppdatera:

Namn: Namnet på verktyget. Det här namnet visas i listan över verktyg för din agent. Välj ett namn som tydligt anger verktygets funktion.
Beskrivning: En beskrivning av verktyget. Generativ orkestrering förlitar sig på den här beskrivningen för att avgöra när din agent ska använda verktyget. Skriv tydliga, specifika beskrivningar, inklusive vad verktyget gör och när det ska användas.
Ytterligare information:
- Tillåt att agenten bestämmer dynamiskt när verktyget ska användas: När det här alternativet är valt kan agenten använda generativ orkestrering för att avgöra när verktyget ska användas. Om det här alternativet inte är markerat använder agenten bara verktyget när det uttryckligen anropas från ett ämne. (Som standard är det här alternativet valt när generativ orkestrering är aktiverat.)
- Fråga slutanvändaren innan du kör: I slutanvändarchatten ber du agenten om bekräftelse innan du kör verktyget. Det här alternativet är inställt på Nej som standard.
- Autentisering: Välj om du vill använda användarens eller tillverkarens autentiseringsuppgifter för verktyget. Som standard gäller användarautentisering.
- Beskrivning: Du kan också lägga till en beskrivning av verktyget som visas för användaren när verktyget körs. Den här beskrivningen låter användaren veta vad de uppmanas att autentisera.

Indata

Här kan du visa och konfigurera indata för verktyget. Indata används för att samla in information från användaren för att fylla i nödvändiga indata för verktyget. Informationen visas som en tabell, en rad för varje indata.

Som standard är värdet Fyll med kolumn för varje indata inställt på Dynamiskt fyllning med AI. Agent försöker extrahera värdet från tillgänglig kontext, till exempel från användarens meddelande. Om inget lämpligt värde hittas genereras en fråga för att be användaren om ett värde. Välj Anpassa för att få åtkomst till fler detaljerade anpassningar för insamling och fyllning av indata:

Visningsnamn och beskrivning: Hur indata visas för användaren.
Identifiera som: Hur användarens svar tolkas, till exempel som textsträng eller mappad till en fördefinierad entitet.
Logik för återförsök: Om agenten inte identifierar en entitet i användarens instruktion kan den ställa frågan igen.
Indataverifiering: Konfigurera extra valideringsbeteende för användarens indata utöver standardinställningen för entitetstypen.

Du kan också välja att åsidosätta indata med ett explicit värde i stället för att låta agenten extrahera den. Om du vill ange en åsidosättning anger du Ifyllning med till Anpassat värde och anger ett värde, väljer en variabel eller använder en Power Fx-formel. Om en indata har åsidosatts frågar agenten inte användaren efter ett värde.

Slutförande

Här kan du välja vad du vill ska hända när verktyget har körts klart.

Du kan låta agenten automatiskt generera ett kontextuellt svar för en användare, baserat på deras fråga och resultatet av verktyget.

Du kan också välja att skapa ett specifikt formaterat svar som verktyget ska returnera. Du kan infoga referenser till utdatavariabler från verktyget med hjälp av variabelväljaren. Du kan också använda Power Fx-formler för att formatera svaret.

Under Efter körning väljer du något av några olika alternativ för hur verktyget ska svara användaren när verktyget har körts:

Svara inte (standard): Agenten införlivar verktygets utdata i svaret
Skriv svaret med generativ AI: Låt AI skapa ett sammanhangsberoende svar med hjälp av verktygsutdata
Skicka specifikt svar: Skapa ett mallat svar med variabelinfogning
Skicka ett adaptivt kort: Skapa omfattande, interaktiva svar med knappar och åtgärder

Du kan också konfigurera vilka utdatavariabler som ska vara tillgängliga för agenten och andra verktyg.

Verktygsval och indatasamling

När du definierar ett verktyg i Copilot Studio anger du även information som beskriver dess syfte. Med den här informationen kan agenten identifiera när verktyget ska användas och även använda generativ AI för att generera frågor. Dessa frågor används för att samla in information för att fylla i de indata som behövs för att utföra verktyget. Därför behöver du inte manuellt skapa frågenoder för att samla in alla indata som behövs, till exempel indata i ett flöde. Indatainsamlingen hanteras åt dig vid körning.

Agenten använder flera faktorer för att fastställa val av verktyg:

Verktygets namn och beskrivning
Den aktuella konversationens kontext
Användar avsikt som härleds från deras meddelande
Tillgängliga indata och utdata
Tidigare verktygsanvändning i konversationen

När du använder generativt läge returnerar verktygen som standard sin information tillbaka till agenten, så att agenten kan generera ett kontextuellt svar på användarens fråga. Du kan också instruera verktyget att alltid svara omedelbart, antingen generera ett meddelande eller skapa ett explicit meddelande.

Tips!

När du använder genererade frågor från ett verktyg ska du informera användarna om att en del av konversationen genereras av AI.

Lägg till exempel till ett extra meddelande i systemavsnittet Konversationsstart . Detta ämne bestämmer vilket meddelande som visas för dina användare när en ny konversation startar.

Anropa ett befintligt verktyg inifrån ett ämne

Du kan anropa ett verktyg uttryckligen från ett ämne. Beroende på ditt användningsfall kan du använda verktyget som en del av ett bredare ämne, som använder fler noder. Eller som i väderexemplet kan det vara allt du behöver om du lägger till en nod i ett ämne.

Så här anropar du ett verktyg inifrån ett ämne:

I Copilot Studio, gå till sidan Ämnen för den agenten du vill redigera.
Skapa ett nytt ämne och kalla det Hämta väder.
Lägg till följande utlösande fraser:
- kommer det att regna
- dagens prognos
- hämta väder
- hur är vädret
Välj Lägg till nod (+) och välj sedan Lägg till ett verktyg. Välj verktyget från de tillgängliga verktygen. Det finns tre flikar som visar olika typer av verktyg:
- Grundläggande verktyg
- Anslutning
- Verktyg
Din åtgärdsnod har nu lagts till i ditt ämne.
Välj Spara.

Verktyg (endast MCP-anslutningar)

Under Verktyg kan du visa namn och beskrivningar av de verktyg som är tillgängliga för MCP-anslutningsappen. Verktygen visas i en tabell, en rad för varje verktyg. För varje verktyg kan du se:

Verktygsnamn och version
Indata- och utdataparametrar
Uppskattad exekveringstid
Användningsstatistik

Autentiseringsöverväganden för verktyg

Vissa verktyg kräver autentisering för att fungera korrekt, till exempel Dynamisk fråga eller andra som anropar ett Dataverse-API. Korrekt autentiseringskonfiguration garanterar säkerhet samtidigt som en smidig användarupplevelse upprätthålls.

Verktyg körs alltid i agentens körning i användarkontexten och kan inte köras om inte autentisering är aktiverat. Två typer av autentiseringsmetoder stöds:

Användarautentisering: Agenten använder användarens autentiseringsuppgifter för att autentisera med tjänsten. Den här metoden säkerställer att användarna endast får åtkomst till data som de har behörighet att se.
Copilot författarautentisering: Agenten använder autentiseringsuppgifterna för författaren för att autentisera med tjänsten. Använd det här autentiseringsläget för delade resurser eller när användare inte ska behöva individuell åtkomst.

Testa verktyget

Med generativ orkestrering väljer orkestratorn ditt verktyg när det bedömer att det är relevant för en användarfråga.

Du kan också anropa ett befintligt verktyg inifrån ett ämne.