Legg til en underordnet agent

En underordnet agent er en lettvektsagent som eksisterer innenfor konteksten til din hovedagent. Underordnede agenter lar deg logisk gruppere verktøy, instruksjoner og kunnskap i klart definerte underagenter i en større agent. De er ideelle for engangstilfeller som svarer på én enkelt intensjon eller fullfører én enkelt oppgave. Denne artikkelen forklarer hvordan du oppretter og administrerer en underordnet agent.

Opprett en underordnet agent

1. Gå til Agenter-siden for hovedagenten, og velg Legg til en agent.

2. Velg Ny underordnet agent.

3. Skriv inn et særegent navn for den nye underordnede agenten.

4. Bestem når agenten skal brukes. Agenter reagerer som standard på brukere eller utløsere, basert på beskrivelsen.

   • Hvis du vil bruke standardvirkemåten (Agenten velger – basert på beskrivelse), skriver du inn en kort beskrivelse av agentens formål.
   • Ellers utvider du listen under Når vil dette bli brukt? Og velg ønsket virkemåte. Hvis du vil ha mer informasjon om virkemåten som støttes, kan du se Finn ut når du skal bruke agenten.

5. Skriv inn klare instruksjoner som du vil at agenten skal følge når den aktiveres. Hvis du vil referere til verktøy, variabler eller legge til Power Fx-formler i instruksjonene, skriver du inn en skråstrek (/) og velger ønsket alternativ fra menyen som vises.

   Viktig!

   Når du refererer til eksisterende verktøy i underagentinstruksjonene dine, bestem om verktøyet skal være tilgjengelig direkte for hovedagenten din eller bare når det eksplisitt kalles innenfor underagentinstruksjonene. Å begrense et verktøys bruk til eksplisitte instruksjonsreferanser bidrar til å forhindre forvirring blant orkestratorene når lignende verktøy eller agenter eksisterer. Hvis du for eksempel har en «Sjekk kontosaldo»-agent og et lignende «Hent kontosaldo»-verktøy, begrenser du verktøyet til å bare kalles av agenten for å unngå overlapping. Hvis du vil begrense at et verktøy bare skal være tilgjengelig når det refereres til fra en annen agent, fjerner du merket for Tillat at agenten bestemmer dynamisk når du skal bruke denne verktøyegenskapen i delen Tilleggsdetaljer på verktøyets detaljside.

6. Valgfritt, legg til kunnskap og verktøy som kun denne barneagenten kan bruke:

   • I Kunnskap-delen velger du Legg til og fortsett på samme måte som når du legger til kunnskap til hovedagenten.
   • Velg Legg til og fortsett på samme måte som når du legger til verktøy i hovedagenten, i Verktøy-delen.

7. Hvis du ikke vil at denne agenten skal være aktiv ennå, deaktiverer du Aktivert. Du kan gjøre din underordnede agent aktiv senere.

8. Velg Lagre.

Behandle inndata og utdata

Som standard mottar en underordnet agent en naturlig språkoppgave som skal utføres fra hovedagenten når agenten kaller den. Når den fullfører oppgaven, returnerer den et naturlig språklig sammendrag av hva som skjedde under utførelsen. I noen tilfeller vil du kanskje angi mer eksplisitte inndata- og utdataverdier for agenten.

Konfigurer input og inputsamling

1. Fra siden for overordnede agenter , velg barneagenten din.

2. Bla til Inputs-seksjonen .

3. Hvis du vil legge til inndata, velger du Legg til inndata. Definer et visningsnavn og en beskrivelse, som hjelper agenten med å forstå formålet med inndataene, slik at den kan fylle inndataene med en relevant verdi når du ringer denne agenten.

4. Velg en datatype.

5. Du kan eventuelt velge Gjør disse inndataene obligatoriske for å kreve at inndataene har en verdi før agenten kan kalles.

6. Velg Lagre.

Avanserte inngangskonfigurasjoner

Velg Avansert for å utvide seksjonen og se de andre innstillingene du kan konfigurere for inputen.

Avanserte innstillinger inkluderer følgende innstillinger knyttet til hvordan agenten fyller inn inputverdien når den kaller barneagenten:

• Bør be brukeren: Hvis denne innstillingen er aktivert, ber agenten eksplisitt sluttbrukeren om en verdi for inputen hvis agenten ikke finner verdien fra tilgjengelig kontekst. Dette er nyttig når du vil sikre at agenten får en verdi for denne inputen, selv om den oppringende agenten ikke gir en eller ikke har relevant kontekst for å fylle den. Når denne innstillingen er aktivert, genererer barneagenten en prompt for å be brukeren om nødvendig informasjon, noe som kan bidra til å forbedre nøyaktigheten i agentens svar.
• Prompt - Tilpass: Velg å tilpasse en spesifikk prompttekst for samling for mer deterministisk kontroll.
• Hvor mange reprompts: Spesifiser hvor mange ganger agenten skal reprompte brukeren for en verdi for denne inputen hvis den oppgitte verdien ikke er gyldig. Dette er nyttig for å sikre at agenten får en gyldig verdi for denne inputen. Du kan velge opptil to reprompts.
• Prøv på nytt – Tilpass: Velg å tilpasse spesifikk prompttekst for reprompts når den oppgitte verdien ikke oppfyller de angitte betingelsene, for mer deterministisk kontroll.
• Betingelse: Spesifiser betingelser som den oppgitte inputen må oppfylle for å anses som gyldig.
• Betingelse ikke oppfylt prompt: Tilpass en spesifikk promptformulering slik at brukeren ber om en annen verdi når den oppgitte verdien ikke oppfyller de angitte betingelsene.
• Handling hvis ingen enhet er funnet: Spesifiser hvilken handling agenten skal utføre hvis agenten ikke finner en verdi for denne inputen fra tilgjengelig kontekst, eller fra prompting. Velg om du vil eskalere, sette variabelen til en spesifikk verdi, eller la verdien stå tom.
• Melding om ingen enhet funnet: Hvis du velger at agenten skal eskalere når ingen verdi er funnet for denne inputen, tilpass meldingen agenten sender til brukeren.

Konfigurer barneagent-utganger og fullføringsatferd

Under Output kan du konfigurere utdataverdiene barneagenten returnerer til foreldreagenten når den er ferdig. Du kan også konfigurere oppførselen til foreldreagenten etter at barneagenten er ferdig.

Konfigurer foreldreagentens oppførsel etter at barneagenten er fullført

Du kan spesifisere oppførselen til foreldreagenten etter at barneagenten er ferdig under Etter kjøring i Outputs-seksjonen :

• Ikke svar: Som standard fortsetter foreldreagenten med neste steg i sin orkestreringsplan etter at barneagenten er ferdig og returnerer eventuelle utganger til foreldreagenten. Du kan også velge at foreldreagenten skal sende en melding til brukeren umiddelbart etter at barneagenten er ferdig, før du fortsetter med neste steg i orkestreringsplanen ved å velge ett av de andre alternativene.
• Skriv svaret med generativ AI: Foreldreagenten sender en melding til brukeren med et generativt AI-svar umiddelbart etter at barneagenten er ferdig, og bruker barneagentens utdata som kontekst for svaret.
• Send spesifikt svar: Foreldreagenten sender en spesifikk melding til brukeren umiddelbart etter at barneagenten er ferdig, uavhengig av barnets utdata. Når du velger dette alternativet, kan du tilpasse innholdet i meldingen.
• Send et adaptivt kort: Foreldreagenten sender et adaptivt kort til brukeren umiddelbart etter at barneagenten er ferdig. Når du velger dette alternativet, kan du tilpasse innholdet i det adaptive kortet.

Konfigurer utganger

1. Gå til detaljene for den underordnede agenten.

2. Bla til avsnittet Outputs .

3. Hvis du vil se gjeldende liste over utdata, utvider du delen Avansert i delen Utdata.

4. Hvis du vil legge til utdata, velger du Legg til utdata. Definer et visningsnavn og en beskrivelse, som hjelper agenten med å forstå formålet med utdataene, slik at den kan fylle dem med en relevant verdi når den returnerer verdier til den anropende agenten.

5. Velg en datatype.

6. Velg Lagre.

I delen Utdata kan du også velge å sende en melding til brukeren umiddelbart etter at den underordnede agenten er ferdig. Hvis du vil sende meldingen, endrer du delen Etter kjøring.

Bestem når du skal bruke agenten

Som standard svarer underordnede agenter på en brukerspørring basert på beskrivelsen. Du kan også konfigurere underordnede agenter til å fange opp andre hendelser og svare på dem under Når skal dette brukes?.

Annen informasjon

Avhengig av valget for Når vil dette bli brukt?, kan det hende at flere egenskaper er tilgjengelige. Følgende egenskaper er alltid tilgjengelige.

Betingelse

Angi betingelser som må oppfylles for at agenten skal kunne kalles opp. Du vil for eksempel kanskje at agenten bare skal kalles hvis kanalen som brukes av en ansatt, er Microsoft Teams.

Hvis du trenger mer komplekse betingelser, kan du bytte til Power Fx-formelredigeringen: velg Verktøy, og velg deretter Formel.

Prioritet

Mer enn én agent kan utløse én enkelt innkommende aktivitet, for eksempel en melding. Standardalternativet du velger for Når skal dette brukes? bestemmer rekkefølgen agentene aktiveres.

Underordnede agenter og temaer deler samme sett av utløsere eller hendelser som de kan respondere på. Hvis en agent og et emne er konfigurert til å svare på samme hendelse, for eksempel brukerinaktivitet, kan du bruke prioritetsegenskapen til å bestemme hvilken som går først.

Kjøringsrekkefølge:

1. En aktivitet oppstår
2. En melding mottas / En egendefinert klienthendelse forekommer / Samtalen endres / Den aktiveres
3. Agenten velger

Hvis flere agenter eller emner må kalles opp basert på samme type hendelse, kalles de opp i opprettelsesrekkefølgen (eldste først).

Du kan angi priority-egenskapen eksplisitt. Et lavere tall angir en høyere prioritet.

Barneagenter og bruk av verktøy

Copilot Studio-agenter som bruker generativ orkestrering, har begrensninger i maksimalt og anbefalt antall verktøy de kan bruke. For mer informasjon, se Begrensninger på verktøy i agenter.

Når en barneagent blir tilkalt, bruker den sine egne verktøy og kunnskap for å svare på brukeren eller hendelsen. Fordi barneagenter har sin egen orkestrering, har de sine egne grenser for antall verktøy, adskilt fra grensene til foreldreagenten.

Den separate grensen er en av fordelene med å bruke barneagenter: du kan logisk gruppere verktøy og kunnskap i mindre agenter som fokuserer på spesifikke oppgaver, uten å påvirke hovedagentens generelle grenser. Det er imidlertid en avveining i latensen som legges til av det ekstra laget med orkestrering.