Del via


Føj værktøjer til brugerdefinerede agenter

Værktøjer er de komponenter, der gør det muligt for din agent at interagere med eksterne systemer. Værktøjer udvider funktionaliteten af din agent, så den kan udføre forskellige handlinger som svar på brugeranmodninger eller autonome udløsere. Hvert værktøj repræsenterer en bestemt egenskab, som din agent kan udføre. Du kan f.eks. udstyre din agent med værktøjer, der gør ting som:

  • Send mails ved hjælp af Office 365 Outlook-connectoren
  • Kontrollér de aktuelle vejrforhold og prognoser
  • Læs og skriv data fra Dataverse
  • Læs og send meddelelser til Teams

Mekanismer til tilføjelse af værktøjer

Du kan udvide egenskaberne for din brugerdefinerede agent ved at tilføje et eller flere værktøjer. Din agent kan bruge værktøjer til at svare brugerne automatisk ved hjælp af generativ orkestrering. Du kan også kalde værktøjer direkte fra et emne.

Med generativ orkestrering (aktiv som standard) kan din agent automatisk vælge det mest relevante værktøj eller emne eller søge på tværs af viden for at reagere på en bruger. Denne orkestreringstilstand skaber en mere dynamisk og intelligent samtaleoplevelse.

I klassisk tilstand (generativ orkestrering slået fra) kan en agent kun bruge emner til at svare brugeren. Du kan dog stadig designe din agent til at kalde værktøjer eksplicit fra emner.

Du kan bruge flere forskellige mekanismer til at føje værktøjer til din agent:

  • Færdigbygget connector: Vælg mellem et udvalg af forudindstillede forbindelser til tusindvis af populære API'er fra både Microsoft- og ikke-Microsoft-tjenester.
  • Brugerdefineret connector: Definer en forbindelse til en brugerdefineret tjeneste eller et brugerdefineret system for at aktivere brugerdefinerede værktøjsindstillinger ved hjælp af Power Platform Connectors.
  • Agentflow: Definer et agentflow, herunder en eller flere handlinger, der skal udføres.
  • Prompt: Modelbaseret prompt med enkelt omgang, der kan referere til den viden, du angiver.
  • REST API-forbindelse: Definer en forbindelse til en REST API, og vælg et eller flere API-slutpunkter og -metoder, der skal tilføjes som værktøjer.
  • MCP-værktøj (Model Context Protocol): Opret forbindelse til en MCP-server for at få adgang til værktøjer.
  • Computerbrug (prøveversion) agent: Gør det muligt for din agent at interagere med et hvilket som helst system, der har en grafisk brugergrænseflade, til websteder og skrivebordsapps, vælge knapper, vælge menuer og angive tekst i felter på skærmen.

Når vi taler om værktøjer i denne artikel og i dette afsnit af dokumentationen, mener vi en af mekanismerne i denne gruppe. Disse værktøjstyper kan føjes til din agent og konfigureres på samme måde.

Der er to andre mekanismer, du kan bruge til at føje værktøjslignende funktionsmåde til din agent:

  • Færdigheder: Beholder til et sæt relaterede værktøjer.
  • Klientværktøj: Send en hændelsesaktivitet til klienten, så klienten udfører en handling og returnerer et svar.

Du kan finde flere oplysninger om færdigheder og klientværktøjer under links i afsnittet Relateret indhold .

Opret og tilføj et nyt værktøj på agentniveau

Oprettelse af nye værktøjer direkte i Copilot Studio strømliner udviklingsprocessen og sikrer korrekt integration med din agent. Værktøjer, der føjes til en agent, er tilgængelige til automatisk orkestrering under din agents samtaler.

  1. Åbn din agent ved at vælge Agenter i venstre navigationsrude og vælge din agent på listen.

  2. Gå til siden Funktioner for agenten.

  3. Vælg Tilføj et værktøj.

  4. Vælg Nyt værktøj i ruden Tilføj værktøj.

  5. Vælg den type værktøj, du vil tilføje, på den viste liste:

    • Prompt: Opret AI-drevne tekstgenererings- og analyseværktøjer
    • Agentflow: Opret processer med flere trin med betinget logik
    • Computerbrug: Aktivér GUI-automatisering for ældre systemer
    • Brugerdefineret connector: Opret forbindelse til beskyttede API'er og tjenester
    • REST API: Direkte integration med webtjenester
  6. Udfør konfigurationstrinnene, der er specifikke for den type værktøj, du har valgt. Hvis du f.eks. vælger Spørg, skal du udføre følgende trin:

    • Definer promptskabelonen og vejledningen
    • Angiv inddataparametre
    • Konfigurere videnkilder
    • Angiv svarformat og -begrænsninger
  7. Test din værktøjskonfiguration ved hjælp af eksempelpanelet for at sikre, at det fungerer som forventet.

  8. Vælg Gem for at oprette det nye værktøj.

  9. Vælg Føj til agent for at føje værktøjet til din agent. Du kan se det nye værktøj på siden Værktøjer for agenten.

Få vist og foretag ændringer i din værktøjskonfiguration

Du kan når som helst få vist og redigere konfigurationen af dit værktøj: Gå til siden Funktioner for din agent, og vælg værktøjet på listen over værktøjer.

Siden Værktøjsoplysninger åbnes, hvor konfigurationen af værktøjet vises. Oplysningerne vises i tre afsnit:

  • Oplysninger
  • Input
  • Fuldførelse (værktøjer til MCP-konnektorer)

Oplysninger

I afsnittet Detaljer kan du konfigurere grundlæggende oplysninger om dit værktøj.

Her kan du få vist og opdatere:

  • Navn: Navnet på værktøjet. Dette navn vises på listen over værktøjer til din agent. Vælg et navn, der tydeligt angiver værktøjets funktion.

  • Beskrivelse: En beskrivelse af værktøjet. Generativ orkestrering er afhængig af denne beskrivelse for at bestemme, hvornår din agent skal bruge værktøjet. Skriv tydelige, specifikke beskrivelser, herunder hvad værktøjet gør, og hvornår det skal bruges.

  • Flere oplysninger:

    • Tillad agent at bestemme dynamisk, hvornår værktøjet skal bruges: Når denne indstilling er valgt, kan agenten bruge generativ orkestrering til at bestemme, hvornår værktøjet skal bruges. Hvis denne indstilling ikke er valgt, bruger agenten kun værktøjet, når det udtrykkeligt kaldes fra et emne. Denne indstilling er som standard valgt, når generativ orkestrering er aktiveret.
    • Spørg slutbrugeren, før du kører: I slutbrugerens chatoplevelse skal du bede agenten om bekræftelse, før du kører værktøjet. Denne indstilling er som standard angivet til Nej .
    • Godkendelse: Vælg, om du vil bruge brugerens eller opretterens legitimationsoplysninger til værktøjet. Brugergodkendelse gælder som standard.
    • Beskrivelse: Du kan eventuelt tilføje en beskrivelse af det værktøj, der vises for brugeren, når værktøjet køres. Denne beskrivelse giver brugeren besked om, hvad vedkommende bliver bedt om at godkende.

Input

Her kan du få vist og konfigurere input for dit værktøj. Inputtet bruges til at indsamle oplysninger fra brugeren for at udfylde de påkrævede input til værktøjet. Oplysningerne vises som en tabel, én linje for hvert input.

Som standard er Udfyld ved hjælp af kolonneværdien for hvert input angivet til Dynamisk udfyldning med KUNSTIG INTELLIGENS. Agenten forsøger at udtrække værdien fra den tilgængelige kontekst, f.eks. fra brugerens meddelelse. Hvis der ikke findes en passende værdi, genereres der et spørgsmål for at bede brugeren om en værdi. Vælg Tilpas for at få adgang til mere detaljerede tilpasninger til indsamling og udfyldning af input:

  • Vist navn og beskrivelse: Sådan vises inputtet for brugeren.
  • Identificer som: Hvordan brugerens svar fortolkes, f.eks. som tekststreng eller knyttet til en foruddefineret enhed.
  • Forsøg logik igen: Hvis agenten ikke identificerer en enhed i brugerens sætning, kan den stille spørgsmålet igen.
  • Inputvalidering: Konfigurer ekstra valideringsfunktionsmåde for brugerens input ud over standarden for objekttypen.

Du kan også vælge at tilsidesætte et input med en eksplicit værdi i stedet for at lade agenten udtrække det. Hvis du vil indstille en tilsidesættelse, skal du sætte Fill vha til Brugerdefineret værdi og indtaste en værdi, vælge en variabel eller bruge en Power Fx-formel. Hvis et input tilsidesættes, beder agenten ikke brugeren om en værdi.

Færdiggørelse

Her kan du vælge, hvad der skal ske, når værktøjet er færdig med at køre.

Du kan få agenten til automatisk at generere et kontekstafhængigt svar for en bruger baseret på brugerens forespørgsel og resultatet af værktøjet.

Du kan også vælge at oprette et bestemt, formateret svar, som værktøjet skal returnere. Du kan indsætte referencer til outputvariabler fra værktøjet ved hjælp af variabelvælgeren. Du kan også bruge Power Fx-formler til at formatere svaret.

Under Efter kørsel skal du vælge en af nogle få forskellige indstillinger for, hvordan værktøjet skal reagere på brugeren, når værktøjet er kørt:

  • Svar ikke (standard): Agenten inkorporerer værktøjsoutputtet i sit svar
  • Skriv svaret med generativ AI: Lad AI udarbejde et kontekstafhængigt svar ved hjælp af værktøjsoutput
  • Send specifikt svar: Opret et skabelonsvar med variabel indsættelse
  • Send et adaptivt kort: Opret avancerede, interaktive svar med knapper og handlinger

Du kan også konfigurere, hvilke outputvariabler der skal gøres tilgængelige for agenten og andre værktøjer.

Valg af værktøj og inputsamling

Når du definerer et værktøj i Copilot Studio, kan du også angive oplysninger, der beskriver formålet med det. Disse oplysninger gør det muligt for agenten at identificere, hvornår værktøjet skal bruges, og også bruge generativ AI til at generere spørgsmål. Disse spørgsmål bruges til at indsamle oplysninger for at udfylde de input, der er nødvendige for at udføre værktøjet. Det betyder, at du ikke behøver at oprette spørgsmålsnoder manuelt for at indsamle alle nødvendige input, f.eks. input i et flow. Indsamling af input håndteres for dig under kørsel.

Agenten bruger flere faktorer til at bestemme valg af værktøj:

  • Værktøjets navn og beskrivelse
  • Den aktuelle samtalekontekst
  • Brugerhensigt, der er afledt af deres meddelelse
  • Tilgængelige input og output
  • Tidligere værktøjsforbrug i samtalen

Når du bruger generativ tilstand, returnerer værktøjer som standard deres oplysninger tilbage til agenten, så agenten kan generere et kontekstafhængigt svar på brugerens forespørgsel. Du kan også bede dit værktøj om altid at svare med det samme, enten ved at generere en meddelelse eller oprette en eksplicit meddelelse.

Tips

Når du bruger genererede spørgsmål fra et værktøj, skal du informere dine brugere om, at noget af samtalen genereres af AI.

Tilføj f.eks. en ekstra meddelelse i emnet Samtalestartsystem . Dette emne bestemmer den meddelelse, der vises for dine brugere, når en ny samtale starter.

Kald et eksisterende værktøj inde fra et emne

Du kan kalde et værktøj direkte fra et emne. Afhængigt af din use case kan du bruge dit værktøj som en del af et bredere emne, som bruger flere noder. Eller som i eksemplet med vejret kan det være alt, hvad du har brug for, hvis du føjer en node til et emne.

Sådan kalder du et værktøj fra et emne:

  1. I Copilot Studio skal du gå til Emne-siden for den agent, du vil redigere.

  2. Opret et nyt emne, og giv det et navnet Hent vejret.

  3. Tilføj følgende Udløserfraser:

    • kommer der regn
    • vejrudsigten for i dag
    • hent vejret
    • hvordan er vejret
  4. Vælg Tilføj node (+), og vælg derefter Tilføj et værktøj. Vælg værktøjet fra de tilgængelige værktøjer. Der er tre faner, der viser forskellige typer værktøjer:

    • Grundlæggende værktøjer
    • Stik
    • Værktøj

    Din handlingsnode føjes nu til dit emne.

  5. Vælg Gem.

Værktøjer (kun MCP-forbindelser)

Under Værktøjer kan du få vist navne og beskrivelser af de værktøjer, der er tilgængelige for MCP-connectoren. Værktøjerne vises i en tabel, én linje for hvert værktøj. For hvert værktøj kan du se:

  • Værktøjsnavn og -version
  • Input- og outputparametre
  • Anslået udførelsestid
  • Statistik over forbrug

Godkendelsesovervejelser i forbindelse med værktøjer

Nogle værktøjer kræver godkendelse for at fungere korrekt, f.eks. Dynamisk prompt eller andre, der kalder en Dataverse-API. Korrekt godkendelseskonfiguration sikrer sikkerhed, samtidig med at du bevarer en problemfri brugeroplevelse.

Værktøjer køres altid i agentens kørsel i brugerkonteksten og kan ikke køres, medmindre godkendelse er aktiveret. To typer godkendelsesmetoder understøttes:

  • Brugergodkendelse: Agenten bruger brugerens legitimationsoplysninger til at godkende med tjenesten. Denne metode sikrer, at brugerne kun får adgang til data, de har tilladelse til at se.
  • Autenticering af copilotforfatter: Agenten bruger forfatterens legitimationsoplysninger til at autenticere af tjenesten. Brug denne godkendelsestilstand til delte ressourcer, eller når brugerne ikke skal have individuel adgang.

Test dit værktøj

Med generativ orkestrering vælger orchestratoren dit værktøj, når det anser det for relevant for en brugerforespørgsel.

Du kan også kalde et eksisterende værktøj inde fra et emne.