Solucionar erros no Copilot Studio Kit

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

Erros de política de dados

Se você encontrar erros de prevenção contra 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
  • Power Platform para Administradores de Sistemas
  • Office 365 Outlook
  • Microsoft Dataverse
  • [Herdado] Microsoft Dataverse
  • Microsoft Entra ID
  • Canais Direct Line no Copilot Studio
  • Power Apps para desenvolvedores

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 tanto no agente personalizado quanto na configuração do agente no Copilot Studio Kit. Em seguida, execute um teste para verificar a conectividade.

Lista de verificação para KitAuthApp

  • No portal Azure, em Autenticação, verifique se o URI Web Redirect é o URI do Dataverse em que Copilot Studio Kit está implantado.
  • Verifique se o valor dos tipos de conta com suporte está definido como: Contas em qualquer diretório organizacional (qualquer Microsoft Entra ID - Multitenant) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).
  • Em permissões de API, verifique se a User.Read permissão está na lista, delegada e tem o consentimento do administrador concedido.
  • Verifique se o segredo do cliente foi criado e se está na Configuração do Agente (Autenticação de 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 dos tipos de conta com suporte está definido como: Contas em qualquer diretório organizacional (qualquer Microsoft Entra ID - Multitenant) 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 > Segurança > Autenticação > Segredo do cliente).
  • Em permissões de API, verifique se openid, profile e User.Read estão na lista, delegadas e o consentimento do administrador concedido.
  • Em Expor uma API, verifique se o escopo personalizado foi criado, se os administradores e os usuários podem consentir e se o escopo está habilitado. Verifique se o escopo personalizado foi inserido na configuração do agente do Copilot Studio (Configurações > Segurança > Autenticação > URL de troca de token).
  • Verifique se a ID do cliente do KitAuthApp está nos aplicativos cliente autorizados.

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

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

Lista de verificação para a 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.
  • Verifique se a ID do cliente é a 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 Autenticação de Usuário > Segredo do Cliente está igual ao valor do segredo do cliente criado para o KitAuthApp.
  • Verifique se Channel Security está habilitado nas configurações de Direct Line e tem uma configuração válida.

Mais informações: Configurar agentes no Copilot Studio Kit.

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

Experimente o teste com e sem enviar o evento de início da conversa (localize-o na guia Avançado do teste).

Lista de verificação do navegador

Verifique se o navegador permite cookies de terceiros.

Erros de Execução de Teste

Se um fluxo de nuvem não for executado, o status da etapa correspondente será Erro.

No registro de Execução de Teste, a exibição Detalhes do Erro exibe uma URL que você pode usar para navegar até a instância de execução de fluxo de nuvem com falha.

Captura de tela dos detalhes do erro em um registro de execução de teste do Copilot mostrando um link para o processo de fluxo na nuvem com falha.

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

Captura de tela do Power Automate mostrando detalhes específicos sobre o erro.

Onde obter ajuda

Se você ainda tiver problemas, crie um issue no GitHub.

Copilot Studio Kit é um projeto open source licenciado sob a licença MIT, para o qual a Microsoft não fornece suporte.

Para os recursos principais relacionados e subjacentes do Microsoft Power Platform, use o canal padrão para entrar em contato com o Suporte da Microsoft.

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

  • Last updated on