Konfigurer og administrer tilkoblinger

Agenter bruker verktøy og kunnskap til å utføre handlinger på vegne av brukere og samle inn relevant kontekstuell informasjon. Utviklere lagrer ofte disse verktøyene og kunnskapskildene i eksterne systemer, for eksempel Microsoft Dataverse, Microsoft SharePoint eller andre API-er. For å få tilgang til disse ressursene sikkert, må agentene autentisere seg for å etablere forbindelser mellom seg selv og det eksterne systemet. Agenten kan bruke enten agentforfatterens autentisering eller brukerautentisering, avhengig av situasjonen.

I Microsoft Copilot Studio bruker du tilkoblinger til sikker tilgang til godkjente tjenester for verktøy og kunnskap. Du kan opprette tilkoblinger til ulike datakilder, for eksempel Microsoft Dataverse, Microsoft SharePoint eller eksterne API-er.

Vise og administrere agenttilkoblinger

I Copilot Studio kan du vise og konfigurere tilkoblingene agenten bruker på Connection Settings-siden.

På siden for tilkoblingsinnstillinger kan du konfigurere og administrere tilkoblingene agenten din bruker. Du kan se eksisterende tilkoblinger, opprette nye og redigere eller koble dem fra etter behov.

Vis tilkoblinger på siden Tilkoblingsinnstillinger

1. Gå til agentsiden i Copilot Studio ved å velge Agents og deretter velge agenten du vil vise.

   Oversiktssiden for agenten åpnes.

2. Velg Innstillinger for å åpne agentinnstillinger-siden .

3. Velg tilkoblingsinnstillinger.

En liste vises i en tabell med alle forbindelsene knyttet til agenten din. For hver tilkobling kan du se:

• Tilkoblingsnavn
• Verktøy og kunnskapskilder ved bruk av forbindelsen
• Tilkoblingsstatus

Definisjoner av tilkoblingsstatus

Tilkoblingsstatusen indikerer den nåværende tilstanden til forbindelsen. Det finnes flere mulige statuser:

• Tilkoblet: Forbindelsen er aktiv, og agenten kan bruke den til å få tilgang til det tilknyttede verktøyet eller kunnskapen.
• Ikke tilkoblet: Det finnes ingen aktiv forbindelse. Agenten har ikke tilgang til det tilhørende verktøyet eller kunnskapen. Du må etablere en forbindelse.
• Deaktivert: Tilkoblingen er deaktivert, muligens av en admin, og agenten bruker den ikke akkurat nå.
• Utløpt: Autentiseringsopplysningene for tilkoblingen er utløpt og ikke lenger gyldige. Du må autentisere forbindelsen på nytt for at agenten skal få tilgang til det tilhørende verktøyet eller kunnskapen.
• Utdatert: Forbindelsen er ikke lenger gyldig eller brukbar, vanligvis fordi den ble avbrutt eller tidsavbrutt. Du må gjennomgå og oppdatere eller bytte ut tilkoblingen for at agenten skal få tilgang til det tilhørende verktøyet eller kunnskapen.

Filtertilkoblinger

Hvis du har mange kontakter hos agenten din, filtrer listen for å finne den forbindelsen du ønsker å forholde deg til. Du kan bruke forskjellige filtre for å vise tilkoblinger basert på statusen deres, for eksempel Aktivert/deaktivert, Tilkoblet/ikke tilkoblet, Deaktivert, Utløpt eller Tilkoblingsfeil.

Velg eller lag en individuell tilkobling

1. Under Status for tilkoblingsoppføringen i listen, velg hyperkoblingen ved siden av statusen for å åpne Opprett eller velg en tilkoblingsrute .

2. Velg ... for å åpne tilkoblingskonfigurasjonen .

3. Velg en eksisterende tilkobling fra listen eller velg Legg til ny tilkobling for å opprette en ny.

   Hvis du velger Legg til ny tilkobling, åpnes et oppsettspanel for tilkobling. Om nødvendig kan du bli bedt om å logge på tjenesten eller oppgi ytterligere informasjon for å fullføre tilkoblingsoppsettet.

4. Når du er ferdig, velger du Send for å lagre endringene.

   Tilkoblingen er nå konfigurert og knyttet til agenten din, og agenten din kan bruke forbindelsen til å få tilgang til verktøyene og kunnskapen.

Se detaljer og konfigurer tilkoblingsparametere

Velg Se detaljer under Behandle for tilkoblingsoppføringen i listen for å vise flere detaljer om tilkoblingen.

Informasjonen vises i to faner:

• Detaljer: Viser tilkoblingsnavnet, beskrivelsen, statusen og opprettingsdetaljene.
• Tilkoblingsparametere: Viser tilkoblingsparameterne, for eksempel godkjenningsdetaljer, API-nøkler eller annen nødvendig informasjon, og lar deg konfigurere detaljene.

Del tilkoblingsparametere for på-vegne-av-autentisering (OBO-autentisering)

For noen tilkoblinger som støtter single sign-on (SSO), kan du sette tilkoblingen til å bruke On-Behalf-Of (OBO)-autentisering. I en OBO-flyt delegerer brukeren agenten til å bruke de delte tilkoblingsparameterne med tjenesten på brukerens vegne. Denne autentiseringsmetoden er nyttig når agenten trenger tilgang til ressurser som krever brukerspesifikke tillatelser, eller når handlinger må utføres i konteksten av en brukers identitet.

Aktiver parameterdeling for OBO

Under Tilkoblingsparametere for tilkoblingsoppføringen i listen kan du gi brukeren tillatelse til å godkjenne deling av bestemte tilkoblingsparametere.

1. Aktiver Tillat tillatelse til å dele parametere under Tilkoblingsparametere.

   

2. Merk av i boksene for parameterne du vil tillate brukeren å dele.

   Brukeren blir bedt om å gi tillatelse for disse parameterne når agenten bruker OBO-autentisering.

Brukeropplevelse for OBO-autentisering

Når agenten bruker OBO-autentisering, blir brukeren bedt om å gi agenten tillatelse til å bruke tilkoblingsparameterne deres. Brukeren kan velge å tillate eller nekte denne tillatelsen. Hvis brukeren tillater det, kan agenten få tilgang til ressurser og utføre handlinger på vegne av brukeren. Agenten kobler seg til tjenesten på en transparent måte ved hjelp av de delte tilkoblingsparameterne.

Gjentatte tilkoblingsmeldinger når du bruker OAuth 2.0 med Microsoft Graph API-verktøy

Når du bruker OAuth 2.0-autentisering , må hver bruker logge inn og gi samtykke. Når du deler eller hoster agenten, har ikke andre brukere samtykket ennå, så de ser Connect-kortet .

For å unngå gjentatte forespørsler kan du prøve ett av følgende alternativer for autentisering:

• Aktiver Teams single sign-on (SSO) med on-behalf-of (OBO)-flyten: Brukere logger inn én gang i Teams. Ingen ekstra samtykke kreves i chatten.

• Bruk programtillatelser (tjenestekontohaver): Bakend kaller Microsoft Graph med applikasjonsreferanser. Brukerens samtykke er ikke nødvendig.

• Bruk generisk OAuth SSO for webhostede agenter: Appen din håndterer innlogging og sender tokenet videre til agenten.

• Gi administratorsamtykke for delegerte scopes: Fjerner per-bruker-tillatelsesprompter. En innledende innlogging er fortsatt nødvendig.

Relatert innhold

• Konfigurer OBO-autentisering for tilpassede koblinger