Legg til et verktøy i en agent (GitHub Copilot)

Du kan legge til verktøy i agenten din fra fanen Bygg . Verktøy lar agenten utføre handlinger, koble seg til eksterne tjenester og hente sanntidsdata under samtaler.

Note

Selen som brukes til å bygge denne agenten, bruker bruksbasert fakturering. Å bruke, bygge, teste og evaluere agenter kan forbruke Copilot-kreditter. Les mer i Oversikt over bruksbasert fakturering.

Forutsetninger

Legg til et eksisterende verktøy fra Bygg-fanen

  1. Logg inn på Copilot Studio og åpne agenten din.

  2. Velg fanen Bygg i agentens navigasjonsfelt.

  3. I komponentpanelet velger du Verktøy-knappen .

  4. I dialogen Legg til et verktøy , bla gjennom eller søk etter verktøyet du vil legge til. Bruk fanene Featured, Model Context Protocol (MCP),Connectors eller Workflows for å filtrere etter verktøytype.

Når du skriver inn et søkeord, erstattes fanen Utvalgt med en Alle-fane som viser matchende resultater på tvers av alle verktøytyper.

  1. Velg verktøyet for å se detaljene, inkludert en beskrivelse og handlingene det gir.

    Note

    Hvis organisasjonen din har blokkert et verktøy på grunn av datapolicyer, kan du ikke velge det. Lær mer i Verktøy som er blokkert av organisasjonens retningslinjer.

  2. Velg Legg til for å legge til verktøyet i agenten din.

Verktøy blokkert av organisasjonens retningslinjer

Organisasjonen din kan bruke styringsretningslinjer for å begrense hvilke verktøy og koblinger som er tilgjengelige i Copilot Studio.

Når en datapolicy blokkerer et verktøy, vises verktøyet utilgjengelig i panelet Legg til et verktøy , og du kan ikke velge det. Hold musepekeren over korsikonet ved siden av det utilgjengelige verktøyet for å se hvorfor verktøyet ikke er tilgjengelig. I noen miljøer dukker det opp et infoikon i stedet. Velg den for å åpne en forklaring om «Blokkert av policy ».

Skjermbilde som viser et verktøy blokkert av en datapolicy i panelet Legg til et verktøy.

Meldingen forklarer at organisasjonens datapolicy blokkerer verktøyet, så verktøyet kan ikke brukes, selv av en agent, og å publisere eller kjøre en agent som bruker det kan feile. Hvis du trenger tilgang til et blokkert verktøy, kontakt administratoren din.

Finn ut mer i Konfigurer datapolicyer for agenter.

Konfigurer et verktøy etter at du har lagt det til

Etter å ha lagt til et verktøy, kan det hende du må:

  • Autentiser: Noen verktøy krever at du logger inn eller oppgir legitimasjon før du kan bruke dem. Følg autentiseringsinstruksjonene når de dukker opp. Når et verktøy logger inn med hver brukers egen konto, setter brukerne opp tilkoblingen sin første gang agenten trenger den. Lær mer i Sett opp dine tilkoblinger når en agent spør.
  • Velg handlinger: For koblinger som tilbyr flere handlinger, kan du velge hvilke spesifikke handlinger som skal gjøres tilgjengelige for agenten din.
  • Gå gjennom beskrivelsen: Sørg for at verktøyets beskrivelse nøyaktig gjenspeiler hva det gjør. Agentens orkestreringskjøretid bruker beskrivelsen for å avgjøre når verktøyet skal aktiveres.

Legg til et nytt tilpasset verktøy

Hvis verktøyet du trenger ikke er oppført i dialogen Legg til et verktøy, kan du legge til et egendefinert verktøy. Agenter drevet av GitHub Copilot støtter følgende tilpassede verktøy:

For å starte, velg Legg til-knappen i dialogen Legg til et verktøy , og velg deretter Model Context Protocol (MCP) eller Workflow.

  • MCP-verktøy fra en eksisterende Model Context Protocol (MCP)-server. Bruk MCP-verktøy for å koble til tilpassede tjenester, databaser eller API-er som eksponerer funksjoner som verktøy gjennom MCP-standarden.
  • Arbeidsflyter du oppretter i flytdesigneren i Copilot Studio. Bruk arbeidsflyter for å definere flertrinnsprosesser som agenten din kan kjøre på forespørsel.

Filer agenten din oppretter

Noen verktøy produserer filer som utdata – for eksempel en generert rapport, et regneark eller et bilde. Disse filene er begrenset til 10 MB hver, og filer som overstiger grensen returneres ikke til brukeren. Lær mer i Filer agenten oppretter (GitHub Copilot forhåndsvisning).

Tips for effektive verktøybeskrivelser

Tips

Verktøyets navn og beskrivelse er viktige for nøyaktig verktøykalling. Den forbedrede orkestreringskjøretiden bruker dem til å avgjøre når et verktøy skal påkalles, altså:

  • Bruk klare, spesifikke navn som beskriver verktøyet (for eksempel «Opprett supportsak» i stedet for «Saksverktøy»).
  • Skriv beskrivelser som forklarer når verktøyet skal brukes og hva det gir tilbake.
  • Unngå vage eller overlappende beskrivelser mellom verktøyene.