Ao tentar conversar com um agente do Copilot Studio no Microsoft Teams ou em um site personalizado, a mensagem “Este bot não está disponível” aparece em vez da conversa esperada. Esse erro geralmente significa que o agente não está configurado corretamente para o canal que você está usando ou as configurações de autenticação bloqueiam a conexão. O problema também pode ocorrer se o estado de publicação do agente ou as políticas de segurança impedirem a resposta. Este artigo explica por que o erro acontece e fornece correções passo a passo para tornar o agente disponível novamente.
Principais conclusões: Corrigindo o erro “Este bot não está disponível” no Copilot Studio
- Copilot Studio > Agentes > Detalhes do agente > Canais: Verifique se o canal que você está usando está habilitado e configurado com a URL de endpoint correta.
- Copilot Studio > Agentes > Detalhes do agente > Autenticação: Confirme se o método de autenticação corresponde aos requisitos do canal e se o ID do cliente e o segredo são válidos.
- Copilot Studio > Agentes > Detalhes do agente > Publicação: Confirme se o agente foi publicado no ambiente de produção e não está em rascunho ou não publicado.
Por que o Copilot Studio mostra “Este bot não está disponível”
O erro ocorre quando o agente do Copilot Studio não consegue estabelecer uma conexão com o canal do usuário final. A causa raiz mais comum é uma incompatibilidade entre o provedor de autenticação configurado no agente e os requisitos de autenticação do canal. Outra causa frequente é que o agente foi publicado em um ambiente de teste, mas não no ambiente de produção, então o canal vê apenas a versão não publicada. Além disso, o agente pode estar desabilitado para um canal específico, ou a URL de endpoint do canal pode estar incorreta. No Microsoft Teams, o agente também deve ser adicionado ao catálogo de aplicativos do Teams e atribuído à política de usuário ou grupo correta. Se alguma dessas etapas estiver ausente ou mal configurada, o canal retorna a mensagem “não disponível”.
Incompatibilidade do provedor de autenticação
Os agentes do Copilot Studio podem usar Microsoft Entra ID, Azure Active Directory v2 ou nenhuma autenticação para fins de demonstração. Quando um canal exige um tipo específico de autenticação, como o Teams que requer Entra ID, o agente deve ser configurado de acordo. Se o agente usar “Sem autenticação” e o canal esperar um token, a conexão falha.
Conflitos de estado de publicação
Os agentes têm versões de rascunho e publicadas. A versão publicada é a que fica disponível para os usuários finais. Se você editou o agente após a publicação e não publicou novamente, o canal ainda usará a versão publicada antiga. Se você nunca publicou o agente, o canal não vê nenhuma versão disponível.
Erros de configuração do canal
Cada canal no Copilot Studio tem suas próprias configurações. O canal do Teams, por exemplo, requer um arquivo de manifesto e um ID de aplicativo válido. O canal de site personalizado precisa de um segredo do Direct Line. Se esses valores estiverem ausentes ou incorretos, o canal não consegue rotear mensagens para o agente.
Etapas para corrigir o erro “Este bot não está disponível”
Siga estas etapas em ordem. Após cada etapa, teste o agente no canal onde o erro apareceu.
- Verifique o status de publicação do agente
Abra o Copilot Studio. Vá para Agentes e selecione seu agente. Na página de detalhes do agente, observe a seção Publicar. Se o status mostrar “Rascunho” ou “Última publicação” com uma data antiga, clique em Publicar para enviar a versão mais recente para produção. Aguarde a mensagem de confirmação e teste o agente novamente. - Verifique se o canal está habilitado
Na página de detalhes do agente, clique em Canais. Encontre o canal que você está usando, como Teams, Webchat ou Direct Line. Certifique-se de que a alternância esteja definida como Ativado. Se o canal estiver desativado, ative-o e salve as alterações. - Atualize a URL de endpoint do canal
Para canais de site personalizado, copie o segredo do Direct Line da configuração do canal. Para o Teams, regenere a URL de endpoint do canal se ela tiver expirado. Vá para Canais > [Seu Canal]. Clique em Editar e copie o novo endpoint. Substitua o endpoint antigo no seu site ou no registro do aplicativo do Teams. - Configure a autenticação para o canal
Vá para Detalhes do agente > Autenticação. Selecione o provedor de autenticação que corresponde ao seu canal. Para o Teams, escolha Microsoft Entra ID ou Azure AD v2. Insira o ID do Cliente do registro do seu aplicativo no Azure. Insira o Segredo do Cliente e defina o ID do Locatário. Salve a configuração. Se você estiver testando em um ambiente de demonstração, pode definir a autenticação como Sem autenticação, mas isso não é suportado em canais do Teams de produção. - Teste o agente no painel de teste do Copilot Studio
Antes de verificar o canal externo, use o painel de teste integrado. Na página de detalhes do agente, clique em Testar. Digite uma mensagem. Se o agente responder, o problema está no lado do canal. Se o agente não responder, revise os tópicos e gatilhos do agente em busca de erros. - Para o Teams: Adicione o agente ao catálogo de aplicativos do Teams
Se o agente for para o Microsoft Teams, vá para Canais > Microsoft Teams. Clique em Abrir centro de administração do Teams. Em Aplicativos do Teams > Gerenciar aplicativos, faça upload do pacote de aplicativos do agente. Atribua o aplicativo a usuários ou grupos usando Políticas de configuração. Aguarde de 10 a 30 minutos para a política se propagar e teste o agente no Teams. - Verifique as regras de firewall e rede
Se o agente estiver hospedado localmente ou usar conectores personalizados, verifique se o firewall permite tráfego HTTPS de saída parabotframework.come todos os subdomínios. Também permita tráfego paracopilotstudio.microsoft.come todos os subdomínios. O tráfego bloqueado impede que o canal alcance o agente.
Se o Copilot Studio ainda mostrar o erro após a correção principal
Alguns problemas exigem verificações adicionais além das etapas de configuração padrão. Abaixo estão três cenários específicos que causam a mesma mensagem de erro.
O agente usa um conector personalizado e o conector não foi publicado
Se o seu agente depende de um conector personalizado para acessar uma API externa, o conector deve ser publicado separadamente. No Copilot Studio, vá para Agentes > Conectores. Selecione seu conector personalizado e clique em Publicar. Se o conector estiver em modo rascunho, o agente não consegue recuperar dados e retorna o erro “não disponível”.
Token do canal expirado ou revogado
Os segredos do Direct Line e os tokens de aplicativos do Teams expiram após um período definido. No Copilot Studio, vá para Canais > Direct Line ou Teams. Clique em Regenerar para criar um novo segredo ou token. Atualize o endpoint no seu aplicativo com o novo valor. Tokens antigos fazem o canal rejeitar a conexão.
O agente excede os limites de cota
Os agentes do Copilot Studio têm cotas de mensagens baseadas na licença. Se o agente exceder o limite diário ou horário de mensagens, o canal bloqueia novas conversas. No Copilot Studio, vá para Configurações > Uso. Verifique a contagem de mensagens. Se o limite for atingido, aguarde o período de redefinição ou faça upgrade da licença.
Opções de canal do Copilot Studio: Direct Line vs Teams vs Webchat
| Item | Direct Line | Microsoft Teams | Webchat Personalizado |
|---|---|---|---|
| Autenticação necessária | Sim, com segredo do Direct Line | Sim, Microsoft Entra ID ou Azure AD v2 | Não, mas pode ser adicionada |
| Configuração de endpoint | Copiar segredo do Copilot Studio | Fazer upload do manifesto no centro de administração do Teams | Incorporar snippet JavaScript |
| Exigência de publicação | O agente deve ser publicado | O agente deve ser publicado e o aplicativo adicionado ao catálogo | O agente deve ser publicado |
| Causa comum de erro | Segredo expirado | Atribuição de política de aplicativo ausente | Segredo do Direct Line incorreto |
O erro “Este bot não está disponível” no Copilot Studio é quase sempre um problema de configuração ou publicação. Depois de verificar o status de publicação do agente, habilitar o canal correto e atualizar as configurações de autenticação, o agente deve responder normalmente. Se o problema persistir, examine o status do conector personalizado e as datas de expiração dos tokens. Para implantações no Teams, verifique se a política de aplicativo está atribuída aos usuários corretos. Como dica avançada, use os logs de diagnóstico do Copilot Studio acessando Detalhes do agente > Configurações > Logs de diagnóstico para ver o código de erro HTTP exato retornado pelo canal, que identifica a etapa com falha na cadeia de conexão.