Solução de problemas

Soluções para problemas comuns do Delegate, incluindo erros de contexto de tela, problemas de permissão no macOS e Windows e falhas de conectividade ou integração de ferramentas.

Esta página é sua única referência para resolver problemas em Delegate.

Configuração e instalação

Não consigo ver meus aplicativos

• Verifique se o Contexto da tela está habilitado (alterar na parte inferior da janela)
• Verifique se as permissões de gravação/acessibilidade de tela são concedidas nas Configurações do sistema (macOS) ou se o UAC (Controle de Conta de Usuário) foi aceito (Windows)
• Reiniciar Delegate após conceder permissões

Delegate diz que não pode acessar um site

• Verifique sua conexão com a Internet
• Algumas redes corporativas bloqueiam certos serviços de IA. Entre em contato com seu departamento de TI se você suspeitar disso
• Tente usar outro site para isolar o problema

A extensão do navegador não foi detectada

• Verifique se a extensão está instalada e habilitada no navegador
• No Chrome: chrome://extensions → Delegate deve estar listado e habilitado
• Reinicie o navegador após a instalação
• Execute novamente o assistente de configuração em Configurações, se necessário

Não consigo entrar

• Verifique as credenciais da sua conta da UiPath
• Se sua organização usar SSO (Single Sign-On), certifique-se de que você esteja na rede corporativa ou na VPN
• Verifique se o tenant está selecionado corretamente

Tarefas e prompts

Delegate não entendeu o que eu queria

• Dividir a solicitação em etapas menores
• Seja mais explícito sobre o objetivo e o formato
• Forneça um exemplo da saída desejada

Ele começou a fazer algo que não esperava

• Pressione Esc para parar
• Pergunte "O que você está tentando fazer?" para entender seu raciocínio
• Redirecionar com uma instrução mais clara

A tarefa está demorando muito.

• Verifique se você está no modo de segundo plano (mais lento, mas não bloqueado)
• Solicitar uma atualização de status: "O que está demorando tanto?";
• Considere dividir em partes menores para tarefas complexas

Ele continua pedindo confirmação

• Você está no modo guiado. Isso é esperado por segurança
• Alterne para o modo Autônomo para fluxos de trabalho confiáveis e repetitivos
• Revise as configurações de segurança se quiser ajustar o que dispara a confirmação

Segurança e permissões

Delegate diz que não tem permissão

1. Verifique Configurações → Segurança → se a categoria de ferramenta relevante está habilitada.
2. Verifique as Permissões de ferramentas para a ferramenta específica ou operação do conector.
3. Verifique se o aplicativo ou site de destino está em Aplicativos/sites bloqueados em Automação de interface gráfica ou o caminho corresponde a uma categoria em Arquivos protegidos.
4. Tente alternar para o modo Categorizado temporariamente para ver a negação específica.

Aprovei uma ação, mas ela ainda falhou

1. Verifique as permissões no nível do sistema operacional (configurações de privacidade do macOS, Windows UAC).
2. Verifique se o aplicativo ou site não está em Aplicativos/sites bloqueados em Automação de interface gráfica.
3. Verifique se o caminho do arquivo corresponde a uma categoria em Arquivos protegidos.
4. Revise a mensagem de erro — ela pode indicar um problema diferente (rede, autenticação etc.)

Quero permitir um site bloqueado

1. Abra Configurações → Segurança → Automação de interface gráfica e marque Sites bloqueados — remova o site se ele estiver listado individualmente ou se tiver sido adicionado como parte de uma categoria (Bancos, Pagamentos, Criptografia, Gerenciador de senhas, Governo, Saúde).
2. Se a configuração estiver bloqueada e aparecer como gerenciada por sua organização, entre em contato com seu administrador — ela é aplicada por meio do Automation Ops e não pode ser alterada localmente.

Uma habilidade continua pedindo permissões que já concedi

1. Verifique se a habilidade está solicitando uma permissão diferente de antes.
2. Verifique se o manifesto da habilidade corresponde ao que ela realmente usa.
3. Algumas permissões são de escopo de sessão e exigem nova aprovação.
4. Verifique Configurações → Permissões → Agentes permitidos para garantir que o agente relevante esteja habilitado.

Conexões

Integration Service: falha de conexão ou erro de autenticação

Causas

• Token do OAuth expirado
• Senha alterada no serviço de origem
• Política da organização revogou acesso de terceiros
• Permissões insuficientes concedidas

Soluções

1. Vá para Configurações → Conexões → Reconectar.
2. Se falhar, revogue e recrie a conexão.
3. Verifique as configurações do aplicativo de terceiros do próprio serviço.
4. Verifique se você tem as permissões necessárias no aplicativo de origem.

Integration Service: nenhuma conexão encontrada para [service]

Causa: você solicitou ao Delegate para usar um serviço que não está conectado

Soluções

1. Crie a conexão em Configurações → Conexões.
2. Ou especifique uma abordagem diferente que não exija esse serviço.

Integration Service: permissões insuficientes

Causa: a conexão existe, mas não tem os escopos necessários para a ação solicitada

Soluções

1. Desconecte e reconecte, concedendo permissões adicionais quando solicitado.
2. Verifique com o administrador de TI se as políticas da organização restringem os escopos.

MCP: falha ao conectar ao servidor MCP

Causas

• O servidor remoto está inoperante ou inacessível
• Falha ao iniciar o processo local
• Rede/firewall bloqueando a conexão
• URL ou configuração inválida

Soluções

1. Verifique se o servidor está em execução (para local) ou acessível (para remoto).
2. Verifique se há erros de digitação no URL/comando.
3. Teste o ponto de extremidade manualmente (curva, navegador).
4. Verifique as configurações de firewall.
5. Revise os logs de processo locais para erros de inicialização.

MCP: servidor conectado, mas nenhuma ferramenta disponível

Causa: o servidor está em execução, mas não registrou nenhuma ferramenta ou as ferramentas falharam na inicialização

Soluções

1. Verifique a documentação do servidor para obter a configuração necessária.
2. Verifique se as variáveis de ambiente estão definidas corretamente.
3. Reinicie o servidor MCP.
4. Verifique nos logs do servidor os erros de inicialização.

MCP: falha na chamada da ferramenta ou erro de MCP

Causa: o servidor recebeu a solicitação, mas não conseguiu executar

Soluções

1. Verifique a mensagem de erro específica no cartão da ferramenta.
2. Verifique se os parâmetros necessários da ferramenta foram fornecidos.
3. Verifique se o recurso subjacente (arquivo, banco de dados, API) está acessível.
4. Revise os logs do servidor MCP para obter informações detalhadas do erro.

Rotinas

Rotina não encontrada

Causa: a rotina foi excluída ou a pasta LocalSkills foi movida

Soluções

1. Verifique se a rotina está em Configurações → Rotinas.
2. Se importado, reimporte a partir do arquivo original.
3. Verifique o caminho da pasta LocalSkills em Configurações → Habilidades e habilidades UiPath Marketplace.

Entrada obrigatória não encontrada

Causa: a Rotina espera um parâmetro que não foi fornecido

Soluções

1. Ao executar, preencha todas as entradas solicitadas.
2. Se estiver agendando, certifique-se de que os valores fixos sejam definidos para todas as entradas necessárias.
3. Edite a Rotina para tornar as entradas opcionais com padrões.

Falha da rotina na etapa X

Causa: uma ação na Rotina não pôde ser concluída

Soluções

1. Verifique a mensagem de erro no cartão da ferramenta.
2. Verifique se as conexões necessárias estão ativas (Configurações → Conexões).
3. Certifique-se de que os arquivos de entrada existam e estejam acessíveis.
4. Verifique se os aplicativos de destino estão instalados.
5. Execute no modo guiado para ver exatamente onde ele falha.

A rotina agendada não foi executada

Causa: serviço de agendamento não está sendo executado ou problema de permissões

Soluções

1. Verifique Configurações → Rotinas → Agendado para o status de execução.
2. Verifique se Delegate estava em execução no horário agendado.
3. Verifique se a máquina estava em repouso (os agendamentos podem não ser executados durante o modo de repouso).
4. Revise o histórico de execução para ver mensagens de erro.
5. Certifique-se de que as conexões ainda sejam válidas (não expiradas).

Armazenamentos e habilidades

O item não será instalado

Causas

• Problema de conectividade de rede
• Espaço em disco insuficiente
• Download corrompido
• Versão Delegate incompatível

Soluções

1. Verifique a conexão com a Internet.
2. Libere espaço em disco (consulte o diretório LocalSkills).
3. Tente instalar novamente.
4. Verifique se seu Delegate está atualizado.
5. Entre em contato com o editor se o problema persistir.

A habilidade instalada não aparece

Causas

• A habilidade está desabilitada
• Não adicionado à lista de HabilidadesHabilitadas
• Delegate precisa ser reiniciado

Soluções

1. Verifique Configurações → Habilidades e habilidades; Marketplace → a habilidade é listada e habilitada.
2. Reinicie Delegate.
3. Verifique a pasta LocalSkills para os arquivos de habilidade.

A habilidade falha quando tento usá-la

Causas

• Conexões necessárias ausentes
• Permissões necessárias ausentes
• Versão de habilidade desatualizada
• Incompatibilidade de versão do aplicativo

Soluções

1. Verifique a documentação da habilidade para pré-requisitos.
2. Crie as conexões necessárias em Configurações → Conexões.
3. Habilite as categorias de ferramentas necessárias em Configurações → Segurança.
4. Atualize a habilidade para a versão mais recente.
5. Verifique se a versão do aplicativo de destino é compatível.

O feed personalizado não está sendo carregado

Causas

• URL do Feed Inválido
• Servidor do feed inoperante
• Formato do feed incorreto
• Bloqueio de rede/firewall

Soluções

1. Verifique se o URL está correto e acessível em um navegador.
2. Verifique o formato do feed em relação à especificação da UiPath.
3. Entre em contato com o administrador do feed.
4. Verifique as configurações de firewall corporativo.

Configurações

As alterações de configuração não entram em vigor

Causa: algumas configurações exigem uma reinicialização do aplicativo; As configurações das guias Segurança e Permissões só podem ser alteradas por meio da interface gráfica Configurações, não editando o arquivo diretamente.

Soluções

1. Reinicie Delegate e verifique se a configuração entrou em vigor.
2. Se a configuração estiver na guia Segurança ou Permissões, use a interface gráfica Configurações em vez de editar o arquivo diretamente.
3. Se estiver editando o settings.json manualmente, verifique se você está editando o caminho do arquivo correto.

O arquivo de configurações está corrompido

Causa: o settings.json tem uma sintaxe JSON inválida, geralmente devido a um erro de edição manual. Delegate retorna às configurações padrão automaticamente.

Soluções

1. Feche a Delegate.
2. Exclua ou renomeie settings.json.
3. Restart Delegate — novos padrões são criados.
4. Reconfigure suas preferências.

Não é possível encontrar uma configuração

Causa: a configuração pode estar em uma guia diferente do esperado ou disponível apenas por meio da interface gráfica das Configurações.

Soluções

1. Verifique se a configuração está na guia Segurança (somente interface gráfica).
2. Verifique sua versão do Delegate — algumas configurações são específicas da versão.

As configurações seguras não serão salvas

Causa: a segurança no nível do sistema operacional está impedindo o acesso ao armazenamento de configurações criptografado: macOS Extractor ou API de Proteção de Dados do Windows (DPAPI).

Soluções

1. Verifique as permissões de segurança no nível do sistema operacional.
2. macOS: certifique-se de que as chaves estejam desbloqueadas.
3. Windows: certifique-se de que seu perfil de usuário esteja carregado corretamente.
4. Reinicie Delegate.
5. Se persistir, entre em contato com o Suporte da UiPath.