Del via

Integrere nett- eller opprinnelige apper med Microsoft 365 Agents SDK

Viktig!

Dette innholdet er ment for erfarne IT-teknikere, for eksempel IT-administratorer eller utviklere, som er kjent med utviklerverktøy, verktøy og integrerte utviklingsmiljøer (IDEer). Det krever ekspertise innen programvareutvikling.

Når du har opprettet og testet agenten i Copilot Studio, kan du distribuere den til den foretrukne kanalen for å teste hvordan målbrukerne vil samhandle med den.

Merk deg

Hvis du vil bruke innebyggingskoden for nettappen i Copilot Studio, må du angi sikkerhetsgodkjenningsalternativene til Ingen godkjenning. Gå til Sikkerhetsgodkjenning for innstillinger>>, og velg Ingen godkjenning for å gjøre den offentlig tilgjengelig.

Denne veiledningen dekker hvordan du tar Copilot Studio-agenten og integrerer den med det eksisterende nettprogrammet (vanligvis et nettsted) eller et opprinnelig program ved hjelp av Copilot Studio-klienten med Microsoft 365 Agents SDK.

Ulike deler av denne veiledningen er relevante avhengig av om du har et eksisterende brukergrensesnitt som du vil integrere agenten i, eller om du har tenkt å bruke et Microsoft-levert brukergrensesnitt. Bruk tabellen nedenfor til å finne inndelingen som passer til scenarioet.

Distribusjonsmetode Hvordan, hvor og hvorfor Hurtigkobling
Bruk standard innebyggingskode for webchat Med en agent som ikke har aktivert sikkerhetsinnstilling for godkjenning , er den tilgjengelig i publiseringsruten for webkanalen i Copilot Studio. Obs! Dette alternativet vises bare når du ikke har valgt godkjenning i Copilot Studio. Bruk standard kode for innebygging av webchat (uten utvikling/kode)
Koble til Copilot Studio med Agents SDK User-pålogging Bruk tilkoblingsstrengen eller konfigurasjonsinnstillingene for Agents SDK til å integrere direkte med agenten ved hjelp av brukerlegitimasjon ved hjelp av copiloten. Konfigurer appregistreringen for interaktiv brukerpålogging
Koble til Copilot Studio med Agents SDK Service Principal-pålogging Brukes der du vil at agenten skal ha sin egen identitet og ikke brukes på vegne av for brukeren som har tilgang til agenten. Nyttig i scenarioer der du ikke krever brukerkontekst, men du fortsatt trenger tilgang til privilegerte API-er eller informasjon og krever godkjenning. Obs! Hvis du vil utføre denne oppgaven, må du ha godkjenning for denne agenten i Copilot Studio satt til Ingen godkjenning. Konfigurer appregistreringen for Service Principal
Bruk eldre DirectLine til å koble til Copilot Studio Du kan koble til DirectLine ved hjelp av DirectLine-API-en og bør brukes der Agents SDK ikke støtter scenarioet ditt. Publiser en agent på mobilapper eller egne apper

Forutsetning

  • .NET Core / JS/ Python
  • Packages–Copilot Studio-klient
  • En agent

Metoder for å integrere Copilot Studio-agenten

  • Copilot Studio-klient (ved hjelp av Agents SDK): Denne metoden er den foretrukne måten å integrere med Copilot Studio på.

  • DirectLine: DirectLine er den eldre måten å integrere med Copilot Studio på, og bør brukes der det ikke er støtte for brukstilfellet med Copilot Studio-klienten.

    • Støtter ikke token for tjenestekontohaver

Kom i gang: Grunnleggende konfigurasjons- og agenttilkoblingstesting ved hjelp av SDK for Microsoft 365 Agents

  1. Last ned Copilot Studio-klienteksempelet fra Microsoft 365 Agents SDK.

    Vi forenklet integreringen med Agents SDK for nettet og opprinnelige apper ved å tilby et klientbibliotek som gjør det mulig for utviklere å skrive inn noen detaljer om agenten din og enkelt integrere det i programmene dine.

  2. Få Copilot Studio-klienteksempelet fra Agents SDK GitHub-repositoriet i enten C#, JavaScript eller Python.

  3. Hent innebyggingskoden eller tilkoblingsstrengen for agenten din i Copilot Studio.

    Du trenger tilgang til din agent i Copilot Studio for å få tilkoblingsstrengdetaljene (eller detaljene for konfigurasjonsinnstillingen) for å kunne koble til den.

    Åpne agenten i Copilot Studio, velg Innstillinger>for sikkerhetsgodkjenning>, og se gjennom innstillingene til agenten.

    • Hvis enten Authenticate med Microsoft eller Authenticate manuelt er valgt, ser du bare tilkoblingsstrengalternativet for å integrere med Agents SDK.

    • Hvis ingen godkjenning er valgt, ser du både innebyggingskoden du kan legge til på nettstedet og tilkoblingsstrengen. Alternativet Innebyggingskode bruker ikke Agents SDK og bruker standard ut-av-boksen Web Chat-komponenten.

    Skjermbilde av godkjenningsinnstillingene for en agent, som viser at ingen godkjenning er valgt.

  4. Hent tilkoblingsstrengen.

    Hvis du vil hente tilkoblingsstrengen for agenten din i Copilot Studio, velger du enten Nettapp eller Opprinnelig app på Kanaler-siden . Velg Kopier ved siden av tilkoblingsstrengen under Microsoft 365 Agents SDK. Bruk denne strengen til å koble til denne agenten fra koden til web- eller innfødt app.

    Skjermbilde av Copilot Studio's Channels-side.

    Skjermbilde av nettappkanalpanelet i Copilot Studio.

  5. Få informasjon om tradisjonelle konfigurasjonsinnstillinger.

    Hvis du ikke vil bruke tilkoblingsstrengmetoden , og i stedet bruker de tradisjonelle konfigurasjonsinnstillingene, trenger du noen andre metadata fra Copilot Studio-agenten.

    Velg Innstillinger>avansert. Under Metadata trenger du miljø-ID, leier-ID og skjemanavn. Registrer disse metadataverdiene for senere.

    Skjermbilde av siden for avanserte innstillinger for en agent i Copilot Studio.

  6. Konfigurer programregistreringen for de riktige tillatelsene for å få tilgang til Copilot Studio.

    Nettappen eller den opprinnelige appen må ha en appregistrering i Azure. Hvis du ikke har en appregistrering i Azure, kan du følge den fullstendige veiledningen om hvordan du konfigurerer en ved hjelp av Readme eller i Azure-dokumentasjonen. Hvis du vil ha mer informasjon, kan du se Registrer et program i Microsoft Entra ID.

    Merk deg

    Mest sannsynlig har du allerede en eksisterende appregistrering for registreringen, og du må bruke den i stedet. Du kan konfigurere godkjenningsmetoder for bruker - eller tjenestekontohaver for å få tilgang til agenten din.

Konfigurer appregistreringen for interaktiv brukerpålogging

  1. Gå til API-tillatelse>Legg til tillatelser, velg API-er organisasjonen min bruker, og søk etter Power Platform API.

  2. Velg delegerte tillatelser>Copilot Studio>Copilot Studio.Copilots.Invoke-tillatelse . Velg Legg til tillatelser.

For brukerpålogging kan du teste eksempelarbeidet med programregistreringen og Copilot Studio-agenten, ved å:

Legge til tilkoblingsstrengen i Copilot Studio-klientinnstillingene i appsettings.config-filen :

  • DirectConnectUrl
  • TenantID:
  • ClientID:
  • ClientSecret:

Legge til innstillingene for Copilot Studio-klienten i appsettings.config-filen :

  • EnvironmentID:
  • SchemaName:
  • TenantID:
  • AppClientID:
  • AppClientSecret:

Du skal nå kunne kjøre eksemplet og koble til agenten via appregistreringsinnstillingene ved hjelp av eksempelkonsollprogrammet.

Konfigurer appregistreringen for tjenestekontohaver

Alternativt kan du velge å konfigurere appregistreringen for tjenestegodkjenning i stedet for for brukergodkjenning.

  1. Gå til API-tillatelse, legg til tillatelser, velg API-er organisasjonen min bruker, og søk etter Power Platform APIpå appregistreringen.
  2. Velg Programtillatelser>Copilot Studio, og kontroller Copilot Studio.Copilots.Invoke-tillatelsen .
  3. Velg Legg til tillatelser.

For brukerpålogging kan du teste eksempelarbeidet med programregistreringen og Copilot Studio-agenten, ved å:

  1. Legge til tilkoblingsstrengen i Copilot Studio-klientinnstillingene i appsettings.config-filen :

    • DirectConnectUrl
    • TenantID:
    • UseS2SConnection: true
    • ClientID:
    • ClientSecret:

  2. Legge til innstillingene for Copilot Studio-klienten i appsettings.config-filen :

    • EnvironmentID:
    • SchemaName:
    • TenantID:
    • UseS2SConnection: true
    • AppClientID:
    • AppClientSecret:

Du skal nå kunne kjøre eksemplet og koble til agenten med appregistreringsinnstillingene ved hjelp av eksempelkonsollprogrammet.

Integrer Copilot Studio-klienten i eksisterende brukergrensesnitt/UX

Nå har du testet agenten din med Copilot Studio-klienten. Testingen bekrefter at agenten er koblet til eksempelkonsollappen, du er klar til å integrere biblioteket i det eksisterende nettstedet eller appen, og koble til/vise det med det eksisterende brukergrensesnittet.

Hvordan du integrerer agenten i programmet, er opp til deg og den eksisterende kodebasen. Vanligvis kan trinn for å integrere agenten inkludere:

  1. Refererer til biblioteket i programmet.
  2. Implementere objekter og metoder fra klientbiblioteket i prosjektet.
  3. Injiser med DI eller administrasjon av klienten basert på den eksisterende utformingen av programmet, slik at du refererer til appinnstillingene for konfigurasjonsdetaljene for agenten.

Bruk standard kode for innebygging av webchat (uten utvikling/kode)

Du kan legge til Copilot Studio-agenten på nettstedet ved hjelp av en iFrame, som kan bygges inn i HTML-koden for nettstedet/nettappen.

Denne koden er bare synlig hvis alternativet Ingen godkjenning er valgt i agentens innstillinger i Copilot Studio under Sikkerhet. Hvis Godkjenning med Microsoft eller Authenticate manuelt er valgt, er ikke innebyggingskoden synlig.

Skjermbilde av godkjenningsinnstillingene for en agent.

Bruk DirectLine til å koble til Copilot Studio

Se Publisere en agent til mobilapper eller egendefinerte apper for å bruke DirectLine til å integrere med Copilot Studio-agenten.