Tilføj et værktøj til en agent (GitHub Copilot)

Du kan tilføje værktøjer til din agent fra fanen Byg. Værktøjer lader din agent udføre handlinger, forbinde til eksterne tjenester og hente realtidsdata under samtaler.

Bemærkning

Harness, der bruges til at bygge denne agent, bruger brugsbaseret fakturering. Brug, opbygning, test og evaluering af agenter kan forbruge Copilot Credits. Læs mere i Oversigt over forbrugsbaseret fakturering.

Forudsætninger

  • En agent skabt med GitHub Copilot-harnesset. Lær mere i Opret en agent.

Tilføj et eksisterende værktøj fra Build-fanen

  1. Log ind på Copilot Studio og åbn din agent.

  2. I agentens navigationslinje skal du vælge fanen Byg.

  3. I komponentpanelet skal du vælge knappen Værktøj.

  4. I dialogen Tilføj et værktøj skal du gennemse eller søge efter det værktøj, du vil tilføje. Brug fanerne Featured, Model Context Protocol (MCP), Connectors eller Workflows til at filtrere efter værktøjstype.

Når du indtaster et søgeord, erstattes fanen Udvalgt af en Alle-fane , der viser matchende resultater på tværs af alle værktøjstyper.

  1. Vælg værktøjet for at se dets detaljer, inklusive en beskrivelse og de handlinger, det tilbyder.

    Bemærkning

    Hvis din organisation har blokeret et værktøj på grund af datapolitikker, kan du ikke vælge det. Læs mere i Værktøjer, der er blokeret af din organisations politikker.

  2. Vælg Tilføj for at tilføje værktøjet til din agent.

Værktøjer blokeret af din organisations politikker

Din organisation kan bruge governance-politikker til at begrænse, hvilke værktøjer og connectors der er tilgængelige i Copilot Studio.

Når en datapolitik blokerer et værktøj, fremstår værktøjet utilgængeligt i panelet Tilføj et værktøj , og du kan ikke vælge det. Hold musen over krydsikonet ved siden af det utilgængelige værktøj for at se, hvorfor værktøjet ikke er tilgængeligt. I nogle miljøer vises der i stedet et infoikon. Vælg den for at åbne en forklaring om Blokeret af politikker.

Skærmbillede, der viser et værktøj, der er blokeret af en datapolitik i panelet Tilføj et værktøj.

Beskeden forklarer, at din organisations datapolitik blokerer værktøjet, så værktøjet ikke kan bruges, selv ikke af en agent, og at publicering eller drift af en agent, der bruger det, kan fejle. Hvis du har brug for adgang til et blokeret værktøj, kontakt din administrator.

Få mere at vide under Konfigurer datapolitikker for agenter.

Konfigurér et værktøj efter tilføjelsen

Efter at have tilføjet et værktøj, kan det være nødvendigt at:

  • Autentificer: Nogle værktøjer kræver, at du logger ind eller oplyser legitimationsoplysninger, før du kan bruge dem. Følg autentificeringsprompterne, når de dukker op. Når et værktøj logger ind med hver brugers egen konto, opsætter brugerne deres forbindelse til tjenesten første gang, agenten har brug for det. Læs mere i Konfigurer dine forbindelser, når en agent spørger.
  • Vælg handlinger: For connectors, der tilbyder flere handlinger, kan du vælge, hvilke specifikke handlinger der skal gøres tilgængelige for din agent.
  • Gennemgå beskrivelsen: Sørg for, at værktøjets beskrivelse nøjagtigt afspejler, hvad det gør. Agentens orkestreringsmiljø bruger beskrivelsen til at afgøre, hvornår værktøjet skal kaldes.

Tilføj et nyt brugerdefineret værktøj

Hvis det værktøj, du har brug for, ikke står i dialogen Tilføj et værktøj , kan du tilføje et brugerdefineret værktøj. Agenter drevet af GitHub Copilot understøtter følgende brugerdefinerede værktøjer:

For at starte skal du vælge knappen Tilføj i dialogen Tilføj et værktøj , og derefter vælge Model Context Protocol (MCP) eller Workflow.

  • MCP-værktøjer fra en eksisterende Model Context Protocol (MCP)-server. Brug MCP-værktøjer til at forbinde til brugerdefinerede tjenester, databaser eller API'er, der eksponerer kapabiliteter som værktøjer gennem MCP-standarden.
  • Arbejdsgange, som du opretter i Copilot Studio's flowdesigner. Brug arbejdsgange til at definere flertrinsprocesser, som din agent kan køre efter behov.

Filer, som din agent opretter

Nogle værktøjer producerer filer som output – for eksempel en genereret rapport, et regneark eller et billede. Disse filer er begrænset til 10 MB hver, og filer, der overstiger grænsen, returneres ikke til brugeren. Læs mere i Filer, som agenten opretter (GitHub Copilot preview).

Tips til effektive værktøjsbeskrivelser

Tip

Værktøjets navn og beskrivelse er vigtige for korrekt værktøjskald. Den forbedrede orkestreringskørsel bruger dem til at beslutte, hvornår et værktøj skal aktiveres, så:

  • Brug klare, specifikke navne, der beskriver værktøjet (for eksempel "Opret supportticket" i stedet for "Ticketværktøj").
  • Skriv beskrivelser, der forklarer, hvornår værktøjet skal bruges, og hvad det returnerer.
  • Undgå vage eller overlappende beskrivelser mellem værktøjerne.
  • Sidst opdateret den