Você criou um agente no Copilot Studio e quer incorporá-lo ao site da sua empresa, mas o agente não carrega ou o código de incorporação produz um erro. Esse problema geralmente ocorre porque o domínio do site não está autorizado nas configurações de publicação do Copilot Studio ou porque o agente exige autenticação que o site não pode fornecer. Este artigo explica a causa exata da falha e fornece uma correção passo a passo para fazer o agente funcionar no seu site.
Você aprenderá a verificar a autorização de domínio, ajustar as configurações de autenticação e confirmar que o snippet de incorporação está configurado corretamente. Não são necessárias habilidades de programação, mas você precisa de acesso ao portal de administração do Copilot Studio e ao código HTML do seu site.
Principais conclusões: corrigindo um agente do Copilot Studio que não carrega no seu site
- Copilot Studio > Configurações > Segurança > Prevenção contra perda de dados > Domínios permitidos: Adicione o domínio do seu site à lista de permissões para evitar que o agente seja bloqueado.
- Copilot Studio > Configurações > Canais > Web > Autenticação: Defina a autenticação como “Sem autenticação” ou configure um provedor OAuth válido para o seu site.
- Código de incorporação HTML do site: Certifique-se de que a tag
<script>aponte para o ID correto do agente e seja colocada antes do fechamento da tag</body>.
Por que seu agente do Copilot Studio falha ao carregar em um site
Ao publicar um agente do Copilot Studio, a plataforma gera um snippet de incorporação que inclui um ID exclusivo do agente e uma conexão com o Bot Framework da Microsoft. O agente deve verificar se o site solicitante está autorizado a hospedá-lo. Se o domínio do site não estiver explicitamente listado nas configurações de segurança do agente, o Bot Framework rejeita a solicitação e o agente não carrega.
Uma segunda causa comum é a incompatibilidade de autenticação. Os agentes do Copilot Studio podem exigir login do usuário via Azure AD, Microsoft Entra ID ou um provedor OAuth personalizado. Se o seu site não passar os tokens de autenticação necessários, o agente exibe um erro de login ou permanece em branco. Para sites públicos que não exigem login do usuário, o agente deve ser configurado para permitir acesso anônimo.
Uma terceira causa é um snippet de incorporação corrompido ou desatualizado. Se você copiou a tag de script antes de republicar o agente após uma alteração de configuração, o snippet pode conter um ID de agente antigo ou um URL de endpoint quebrado. Atualizar o snippet na página de publicação do Copilot Studio resolve isso.
Etapas para adicionar seu agente do Copilot Studio a um site
Siga estas etapas em ordem. Cada etapa aborda uma das três causas raiz descritas acima.
- Adicione o domínio do seu site à lista de domínios permitidos
Abra o Copilot Studio e vá para Configurações > Segurança > Prevenção contra perda de dados. Em Domínios permitidos, clique em Adicionar domínio. Digite o domínio completo do seu site, por exemplowww.suaempresa.com.br. Inclualocalhostse estiver testando localmente. Clique em Salvar. - Defina o modo de autenticação do agente para acesso anônimo
No Copilot Studio, selecione seu agente e vá para Configurações > Canais > Web. Em Autenticação, escolha Sem autenticação se o seu site não exigir login do usuário. Se o seu site usa Azure AD, selecione Azure AD (Microsoft Entra ID) e registre seu site como um URI de redirecionamento válido. Clique em Salvar. - Publique novamente o agente para gerar um snippet de incorporação novo
Vá para Publicar no painel de navegação esquerdo. Clique em Publicar novamente para forçar uma republicação completa. Aguarde a mensagem de confirmação. Esta etapa aplica todas as alterações de segurança e autenticação ao agente ativo. - Copie o código de incorporação atualizado
Após republicar, clique em Publicar > Canais > Web. Clique em Copiar ao lado do snippet de incorporação. O snippet se parece com isto:<script src="https://copilotstudio.microsoft.com/agents/abc123/embed.js"></script>. Não modifique a tag de script manualmente. - Insira o código de incorporação no HTML do seu site
Abra o arquivo HTML do seu site ou o template do sistema de gerenciamento de conteúdo. Cole a tag de script imediatamente antes do fechamento da tag</body>. Não a coloque dentro da seção<head>. Salve e publique a página. - Teste o agente no site ativo
Abra seu site em uma janela de navegação privada ou em um navegador onde você não esteja logado em nenhuma conta Microsoft. Confirme se o ícone do agente aparece e se você pode iniciar uma conversa. Se o agente não carregar, abra o console do desenvolvedor do navegador (F12) e verifique se há erros de JavaScript ou respostas HTTP 403.
Se o agente ainda apresentar problemas após a correção principal
O agente carrega, mas mostra uma janela de chat em branco
Isso indica que o agente está alcançando seu site, mas falha ao inicializar. O motivo mais comum é uma Política de Segurança de Conteúdo (CSP) no seu site que bloqueia o endpoint do Bot Framework. Adicione as seguintes diretivas aos cabeçalhos de resposta HTTP do seu site ou à tag <meta>:
script-src 'self' https://copilotstudio.microsoft.com; frame-src 'self' https://copilotstudio.microsoft.com; connect-src 'self' https://copilotstudio.microsoft.com
Após atualizar a CSP, limpe o cache do navegador e recarregue a página.
O agente exige login mesmo com a autenticação definida como nenhuma
Isso acontece quando o agente usa um tópico ou skill que chama uma API do Microsoft Graph ou um conector personalizado que requer contexto do usuário. Revise os tópicos do seu agente. Se algum tópico usar um fluxo do Power Automate que chama o Microsoft Graph com a identidade do usuário, remova esse fluxo ou configure-o para usar uma conta de serviço. Como alternativa, defina a autenticação do agente como Azure AD e garanta que seu site passe os tokens corretos.
O código de incorporação retorna um erro 404
Um erro 404 significa que o ID do agente no snippet de incorporação é inválido ou o agente foi excluído. Volte ao Copilot Studio e confirme se o agente ainda existe. Se você renomeou o agente, o ID permanece o mesmo. Se você excluiu o agente, crie um novo e publique-o. Copie o snippet de incorporação novo.
| Item | Agente do Copilot Studio (Anônimo) | Agente do Copilot Studio (Autenticado) |
|---|---|---|
| Autenticação | Nenhuma autenticação necessária | Azure AD, Microsoft Entra ID ou OAuth personalizado |
| Melhor para | Sites públicos sem login de usuário | Portais internos ou portais de clientes com login |
| Restrição de domínio | Deve ser adicionado à lista de domínios permitidos | Deve ser adicionado à lista de domínios permitidos e registrado como URI de redirecionamento |
| Snippet de incorporação | Tag de script padrão | Tag de script com parâmetro de endpoint de token |
| Acesso a dados do usuário | Sem contexto do usuário | Pode acessar dados do Microsoft Graph do usuário |
Agora você pode adicionar seu agente do Copilot Studio a qualquer site controlando as permissões de domínio, o modo de autenticação e o snippet de incorporação. Comece com a etapa de domínios permitidos, pois é o bloqueador mais comum. Após o agente carregar, teste uma conversa que use um tópico com um conector para confirmar a funcionalidade de ponta a ponta. Como verificação final, use as ferramentas de desenvolvedor do navegador para monitorar as solicitações de rede e verificar se todas as chamadas vão para copilotstudio.microsoft.com sem erros.