Partilhar via

Solucionar erros no Copilot Studio Kit

Este artigo fornece dicas para resolver erros de autenticação e política de dados no Copilot Studio Kit, juntamente com conselhos sobre como resolver falhas de execução de teste. Também fornece informações sobre como escalar os problemas.

Erros na política de dados

Se você encontrar erros de prevenção de perda de dados (como AppForbidden) ao usar o Copilot Studio Kit, verifique se os seguintes conectores são permitidos em sua política de dados:

  • SharePoint
  • Plataforma de energia para administradores
  • Perspetivas do Office 365
  • Microsoft Dataverse
  • [Legado] Microsoft Dataverse
  • Microsoft Entra ID
  • Canais do Direct Line no Copilot Studio
  • Power Apps para Criadores

Mais informações:

Erros de autenticação

Normalmente, dois registros de aplicativo são necessários para a autenticação do usuário final. Por exemplo:

  • KitAuthApp: Usado nas configurações do agente do Copilot Studio Kit.
  • CopilotStudioAuthApp: Usado no Copilot Studio, vinculado ao KitAuthApp.

Lista de verificação geral

  • Verifique se o agente personalizado (Copilot Studio) e o Copilot Studio Kit estão no mesmo locatário.
  • Antes de habilitar a autenticação do usuário, verifique se a autenticação está desabilitada na configuração do agente personalizado e do agente no Copilot Studio Kit. Em seguida, execute um teste para verificar a conectividade.

Lista de verificação para KitAuthApp

  • No portal do Azure, em Autenticação, verifique se o URI do Redirecionamento da Web é o URI do Dataverse onde o Copilot Studio Kit está implantado.
  • Verifique se o valor Tipos de conta suportados está definido como: Contas em qualquer locatário organizacional (Qualquer diretório de ID do Microsoft Entra - Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).
  • Em Permissões de API, verifique se User.Read a permissão está na lista, delegada e se o consentimento de administrador foi concedido.
  • Verifique se o segredo do cliente foi criado e se esse segredo está na Configuração do Agente (Autenticação do Usuário > Segredo do Cliente).

Lista de verificação para CopilotStudioAuthApp

  • No portal do Azure, em Autenticação, verifique se o URI de Redirecionamento da Web tem:
    • https://europe.token.botframework.com/.auth/web/redirect
    • https://token.botframework.com/.auth/web/redirect
  • Verifique se a concessão implícita e os fluxos híbridos estão habilitados para tokens de acesso e tokens de ID.
  • Verifique se o valor Tipos de conta suportados está definido como: Contas em qualquer locatário organizacional (Qualquer diretório de ID do Microsoft Entra - Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).
  • Em Certificados & segredos, verifique se o segredo do cliente é gerado e usado na configuração do agente do Copilot Studio (Configurações > , Autenticação de Segurança > , Segredo > do cliente).
  • Em Permissões de API, verifique se openid, profilee User.Read estão na lista, delegado e consentimento de administrador concedido.
  • Em Expor uma API, verifique se o escopo personalizado foi criado, se os administradores e usuários podem consentir e se o escopo está habilitado. Verifique se o escopo personalizado está inserido na configuração do agente do Copilot Studio (Configurações > Segurança > Autenticação > URL de troca de token).
  • Verifique se o ID do cliente KitAuthApp está nos aplicativos cliente autorizados.

Lista de verificação para configuração do agente no Copilot Studio

  • No Copilot Studio, vá para Definições>Segurança>Autenticação e verifique se:
    • A autenticação manual está ativada.
    • Exigir que os usuários entrem está habilitado (pelo menos para fins de solução de problemas).
    • O URL de redirecionamento está definido (como https://token.botframework.com/.auth/web/redirect).
    • O provedor de serviços é o Microsoft Entra ID V2 com segredos de cliente.
    • ID do cliente é o ID do cliente do CopilotStudioAuthApp.
    • O segredo do cliente é aquele gerado para CopilotStudioAuthApp.
    • URL de troca de token é o escopo personalizado criado em CopilotStudioAuthApp.
    • ID do inquilino é o inquilino onde ambos os registos de aplicações são criados.
    • Os Âmbitos incluem pelo menos profile e openid.
  • Verifique se o bot está publicado com essa configuração.
  • Verifique se o painel de teste do Copilot Studio funciona.
  • Certifique-se de que o site de demonstração funciona (incluindo login).

Lista de verificação para configuração do agente no Copilot Studio Kit

  • Verifique se o ponto de extremidade do token está definido corretamente (copie-o do canal móvel) ou se a segurança do canal está definida e se o segredo correto está configurado.
  • Verifique se a autenticação do usuário está definida como Entra ID v2.
  • Certifique-se de que o ID do cliente é o ID do cliente do KitAuthApp.
  • Verifique se o escopo é o escopo personalizado criado no CopilotStudioAuthApp e o mesmo que nas configurações de autenticação do Copilot Studio.
  • Verifique se o segredo do cliente em User Authentication > Client Secret corresponde ao valor do segredo do cliente criado para KitAuthApp.
  • Verifique se a Segurança do Canal está ativada nas configurações de Linha Direta e tem uma configuração válida.

Para obter mais informações: Configurar agentes no Copilot Studio Kit.

Lista de verificação para configuração de teste

Experimente o seu teste com e sem enviar o evento de início de conversação (encontre-o no separador Avançado do teste).

Lista de verificação para o navegador

Certifique-se de que o navegador permite cookies de terceiros.

Erros de execução de teste

Se um fluxo de nuvem falhar ao ser executado, o status da etapa correspondente será Erro.

No registo de Execução de Teste, a visualização Detalhes do erro exibe um URL que pode utilizar para navegar até a instância de execução do fluxo na nuvem com falha.

Captura de ecrã dos Detalhes do erro num registo de execução do teste do Copilot a mostrar uma ligação para a execução de fluxo de cloud com falha.

Em seguida, você pode solucionar problemas do fluxo de nuvem ainda mais no Power Automate.

Captura de ecrã do Power Automate a mostrar detalhes específicos sobre o erro.

Onde obter ajuda

Se você ainda tiver problemas, faça uma solicitação de suporte no GitHub.

Não reporte vulnerabilidades de segurança por meio de problemas públicos do GitHub. Em vez disso, reporte-os ao Microsoft Security Response Center (MSRC) em microsoft.com/msrc. Forneça o máximo de detalhes possível sobre o possível problema de segurança.

  • Last updated on