Konfigurera och hantera anslutningar

Agenter använder verktyg och kunskap för att utföra åtgärder för användarnas räkning och samla in relevant kontextuell information. Utvecklare lagrar ofta dessa verktyg och kunskapskällor i externa system, till exempel Microsoft Dataverse, Microsoft SharePoint eller andra API:er. För att få säker tillgång till dessa resurser behöver agenter autentisera sig för att etablera anslutningar mellan sig själva och det externa systemet. Agenten kan använda antingen agentförfattarens autentisering eller användarautentisering, beroende på situationen.

I Microsoft Copilot Studio använder du anslutningar för säker åtkomst till autentiserade tjänster för verktyg och kunskap. Du kan skapa anslutningar till olika datakällor, till exempel Microsoft Dataverse, Microsoft SharePoint eller externa API:er.

Visa och hantera agentanslutningar

I Copilot Studio kan du visa och konfigurera de anslutningar som agenten använder på sidan Anslutningsinställningar.

På sidan för anslutningsinställningar kan du konfigurera och hantera de anslutningar din agent använder. Du kan visa befintliga anslutningar, skapa nya och redigera eller koppla från dem efter behov.

Visa anslutningar på sidan Anslutningsinställningar

1. Gå till din agentsida i Copilot Studio genom att välja Agents och sedan välja den agent som du vill visa.

   Översiktssidan för agenten öppnas.

2. Välj Inställningar för att öppna sidan Agentinställningar .

3. Välj anslutningsinställningar.

En lista visas i en tabell med alla kopplingar kopplade till din agent. För varje anslutning kan du se:

• Anslutningens namn
• Verktyg och kunskapskällor som använder kopplingen
• Anslutningsstatus

Definitioner av anslutningsstatus

Anslutningsstatusen visar anslutningens nuvarande tillstånd. Flera möjliga statusar finns:

• Connected: Anslutningen är aktiv och agenten kan använda den för att få tillgång till det tillhörande verktyget eller kunskapen.
• Ej ansluten: Det finns ingen aktiv anslutning. Agenten kan inte få tillgång till det tillhörande verktyget eller kunskapen. Du behöver skapa en kontakt.
• Avaktiverad: Anslutningen är avaktiverad, möjligen av en admin, och agenten använder den inte just nu.
• Utgången: Autentiseringsuppgifterna för anslutningen är utgångna och inte längre giltiga. Du behöver autentisera anslutningen igen för att agenten ska kunna komma åt det tillhörande verktyget eller kunskapen.
• Stale: Anslutningen är inte längre giltig eller användbar, oftast för att den tappades eller gick ut på tid. Du behöver granska och uppdatera eller byta ut anslutningen för att agenten ska kunna komma åt det tillhörande verktyget eller kunskapen.

Filteranslutningar

Om du har många kontakter på din mäklare, filtrera listan för att hitta den kontakt du vill ha att göra med. Du kan använda olika filter för att visa anslutningar baserat på deras status, till exempel Aktiverad inaktiverad/, Ansluten/, Inaktiverad, Förfallen eller Anslutningsfel.

Välj eller skapa en individuell anslutning

1. Under Status för anslutningsposten i listan, välj hyperlänken bredvid statusen för att öppna panelen Skapa eller välja en anslutning .

2. Välj ... för att öppna anslutningskonfigurationen .

3. Välj en befintlig anslutning från listan eller välj Lägg till ny anslutning för att skapa en ny.

   Om du väljer Lägg till ny anslutning öppnas en anslutningsinställningspanel. Efter behov kan du uppmanas att logga in på tjänsten eller ange ytterligare information för att slutföra anslutningskonfigurationen.

4. När du är klar väljer du Skicka för att spara ändringarna.

   Anslutningen är nu konfigurerad och kopplad till din agent, och din agent kan använda anslutningen för att få tillgång till verktygen och kunskapen.

Visa detaljer och konfigurera anslutningsparametrar

Under Hantera för anslutningsposten i listan väljer du Se information om du vill visa mer information om anslutningen.

Informationen visas på två flikar:

• Information: Visar information om anslutningsnamn, beskrivning, status och skapande.
• Anslutningsparametrar: Visar anslutningsparametrarna, till exempel autentiseringsinformation, API-nycklar eller annan nödvändig information och låter dig konfigurera informationen.

Dela anslutningsparametrar för OBO-autentisering (On-Behalf-Of)

För vissa anslutningar som stödjer single sign-on (SSO) kan du ställa in anslutningen att använda On-Behalf-Of (OBO)-autentisering. I ett OBO-flöde delegerar användaren agenten att använda parametrarna för delad anslutning med tjänsten för användarens räkning. Denna autentiseringsmetod är användbar när agenten behöver åtkomst till resurser som kräver användarspecifika behörigheter eller när åtgärder måste utföras i samband med användarens identitet.

Aktivera parameterdelning för OBO

Under Anslutningsparametrar för anslutningsposten i listan kan du tillåta användaren att auktorisera delningsspecifika anslutningsparametrar.

1. Under Anslutningsparametrar aktiverar du Tillåt behörighet att dela parametrar.

   

2. Markera kryssrutor för de parametrar som du vill att användaren ska kunna dela.

   Användaren uppmanas att bevilja behörighet för dessa parametrar när agenten använder OBO-autentisering.

Användarupplevelse för OBO-autentisering

När agenten använder OBO-autentisering uppmanas användaren att bevilja behörighet för agenten att använda sina anslutningsparametrar. Användaren kan välja att tillåta eller neka den här behörigheten. Om användaren tillåter det kan agenten komma åt resurser och utföra åtgärder för användarens räkning. Agenten ansluter till tjänsten transparent med hjälp av parametrarna för delad anslutning.

Upprepade anslutningsprompter när du använder OAuth 2.0 med Microsoft Graph API-verktyg

När du använder OAuth 2.0-autentisering måste varje användare logga in och ge samtycke. När du delar eller hostar agenten har andra användare ännu inte gett sitt samtycke, så de ser Connect-kortet .

För att undvika upprepade uppmaningar kan du prova ett av följande autentiseringsalternativ:

• Aktivera Teams single sign-on (SSO) med on-behalf-of (OBO)-flödet: Användare behöver bara logga in en gång i Teams. Inget extra samtycke krävs i chatten.

• Använd programbehörigheter (tjänstens huvudnamn): Serverdelen anropar Microsoft Graph med appautentiseringsuppgifter. Inget användarsamtycke krävs.

• Använd generisk OAuth SSO för webbhostade agenter: Din app hanterar inloggning och skickar token till agenten.

• Bevilja administratörsrättigheter för delegerade scopes: Tar bort individuella behörighetspromptar för användare. En initial inloggning krävs fortfarande.

Relaterat innehåll

• Konfigurera OBO-autentisering för anpassade kopplare