Fejlfinding af Copilot Agent Kit

Denne artikel giver tips til at løse fejl i datapolitik og godkendelse i Copilot Agent Kit samt råd om, hvordan du løser fejl i testkørsler. Den giver også information om, hvordan sager kan eskaleres.

Datapolitikfejl

Hvis du støder på fejl i datatabsforebyggelse, såsom AppForbidden, når du bruger Copilot Agent Kit, skal du sikre, at de datapolitikker, der anvendes i miljøet, tillader alle connectorer, der leveres i sætløsningen.

Læs mere i Connector-krav.

Flere oplysninger:

• Administrere datapolitikker
• Konfigurer datapolitikker for agenter
• Fejlfinding af håndhævelse af datapolitik for Copilot Studio

Godkendelsesfejl

Typisk kræves to app-registreringer for slutbrugergodkendelse. Eksempel:

• KitAuthApp: Bruges i Copilot Agent Kit-agentkonfigurationer.
• CopilotStudioAuthApp: Bruges i Copilot Studio, linket til KitAuthApp.

Generel checkliste

• Sørg for, at den brugerdefinerede agent (Copilot Studio) og Copilot Agent Kit er i den samme lejer.
• Inden du aktiverer brugergodkendelse, skal du sikre dig, at godkendelse er deaktiveret både i den brugerdefinerede agent og agentkonfiguration i Copilot Agent Kit. Kør derefter en test for at verificere forbindelsen.

Tjekliste for KitAuthApp

• I Azure Portal, under godkendelse, kontrollér at webomdirigerings-URI er den Dataverse URI, hvor Copilot Agent Kit er udrullet.
• Verificer, at værdien Understøttede kontotyper er sat til: Konti i en hvilken som helst organisationslejer (enhver Microsoft Entra ID-mappe – multiprofil) og personlige Microsoft-konti (for eksempel skype, XBOX).
• I API-tilladelser, kontrollér at User.Read-tilladelsen findes på listen, er delegeret, og at der er givet administratorsamtykke
• Kontroller, at klienthemmeligheden er oprettet, og at hemmeligheden er angivet i agentkonfigurationen (Brugergodkendelse > Klienthemmelighed).

Tjekliste for CopilotStudioAuthApp

• I Azure Portal under Godkendelse skal du verificere, at webomdirigerings-URI har:
  • https://europe.token.botframework.com/.auth/web/redirect
  • https://token.botframework.com/.auth/web/redirect
• Verificer, at Implicit tildeling og Hybridflows er aktiveret for adgangstokens og id-tokens.
• Verificer, at værdien Understøttede kontotyper er sat til: Konti i en hvilken som helst organisationslejer (enhver Microsoft Entra ID-mappe – multiprofil) og personlige Microsoft-konti (for eksempel skype, XBOX).
• I Certifikater & hemmeligheder skal du sikre, at klienthemmeligheden er genereret og bruges i Copilot Studio agentkonfiguration (Indstillinger > Sikkerhed > Godkendelse > Klienthemmelighed).
• I API-tilladelser, verificér at openid, profile og User.Read er på listen, er delegeret, og at admin-samtykke er givet.
• I Vis en API skal du kontrollere, at det brugerdefinerede omfang er oprettet, at administratorer og brugere kan give samtykke, og at omfanget er aktiveret. Kontrollér, at det brugerdefinerede omfang er indtastet i Copilot Studio agentkonfiguration (Indstillinger > Sikkerhed > Godkendelse > URL-adresse til tokenudveksling).
• Kontrollér, at klient-id'et for KitAuthApp er angivet i Godkendte klientprogrammer.

Tjekliste for agentkonfiguration i Copilot Studio

• I Copilot Studio skal du gå til Indstillinger>Sikkerhed>Godkendelse og kontrollere, at:
  • Godkend manuelt er aktiveret.
  • Kræv, at brugere logger på er aktiveret (i det mindste til fejlfinding).
  • URL til omdirigering er angivet (til https://token.botframework.com/.auth/web/redirect).
  • Tjenesteudbyder er Microsoft Entra ID V2 med klienthemmeligheder.
  • Klient-id er klient-id for CopilotStudioAuthApp.
  • Klienthemmeligheden er den, der genereres for CopilotStudioAuthApp.
  • URL-adresse til udveksling af token er det brugerdefinerede omfang, der oprettes i CopilotStudioAuthApp.
  • Lejer-id er den lejer, hvor begge app-registreringer oprettes.
  • Omfang inkluderer mindst profile og openid.
• Sørg for, at robotten er offentliggjort med denne konfiguration.
• Sørg for, at Copilot Studio testpanel virker.
• Sørg for, at demowebstedet fungerer (inkl. logon).

Tjekliste for agentkonfiguration i Copilot Agent Kit

• Sørg for, at token-slutpunktet er konfigureret korrekt (kopier det fra mobilkanalen), eller at kanalsikkerheden er aktiveret, og korrekt hemmelighed er konfigureret.
• Sørg for, at brugergodkendelse er konfigureret til Entra ID v2.
• Sørg for, at klient-id’et svarer til klient-id for KitAuthApp.
• Sørg for, at omfang er det brugerdefinerede omfang oprettet i CopilotStudioAuthApp og matcher det, der er angivet i godkendelsesindstillingerne i Copilot Studio.
• Sørg for, at klienthemmeligheden i Brugergodkendelse > Klienthemmelighed matcher værdien af klienthemmeligheden, der er oprettet for KitAuthApp.
• Sørg for, at Kanalsikkerhed er slået til i Direct Line-indstillingerne og er korrekt konfigureret.

Mere information: Konfigurer agenter i Copilot Agent Kit.

Tjekliste til testkonfiguration

Prøv din test med og uden at sende samtalestart-hændelsen (find den i fanen Avanceret i testen).

Tjekliste for browseren

Sørg for, at browseren tillader tredjepartscookies.

Fejl ved testkørsel

Hvis et cloudflow mislykkes, er den tilsvarende trinstatus Fejl.

I posten Testkørsel viser visningen Fejldetaljer en URL-adresse, som du kan bruge til at navigere til den mislykkede forekomst af cloudflowkørsel.

Du kan derefter fejlfinde cloudflowet yderligere i Power Automate.

Hvor kan man få hjælp

Hvis du stadig oplever problemer, opret en fejl på GitHub.

Copilot Agent Kit er et open source-projekt, der er licenseret under MIT-licensen, og som ikke understøttes af Microsoft.

Vedrørende relaterede, underliggende kernefunktioner i Microsoft Power Platform, skal du bruge din standardkanal til at kontakte Microsoft Support.

Indberet ikke sikkerhedssårbarheder via offentlige GitHub-fejl. I stedet skal du rapportere dem til Microsoft Security Response Center (MSRC) på microsoft.com/msrc. Giv så mange detaljer som muligt om det potentielle sikkerhedsproblem.

Relaterede oplysninger

• Fejlfinding af Overholdelseshub-problemer
• Fejlfinding af Microsoft-godkendelse
• Fejlfinding af almindelige problemer under forfining af rubrikker