Solução de problemas com o UiPath para agentes de codificação

A codificação de agentes para solução de problemas traz diagnóstico de conversação para a UiPath Platform. Descreva uma falha em inglês simples a partir de qualquer terminal em sua máquina — incluindo o terminal integrado no UiPath Studio — e a habilidade seleciona o problema, classifica causas prováveis, testa cada caso com dados de plataforma ao vivo por meio de uip e informa exatamente o que deu errado. errado e como corrigi-lo.

A habilidade Solução de problemas faz parte do catálogo de habilidades da UiPath e é instalada em seu agente de codificação por meio de uip skills install.

Como funciona

Uma sessão de diagnóstico segue o mesmo fluxo de quatro estágios, independentemente do tipo de falha:

1. Triagem — Classifique o escopo da falha da descrição do usuário, o identificador de trabalho ou processo ou a mensagem de erro. Se a entrada for ambígua, a habilidade faz uma pergunta de esclarecimento.
2. Gerar casos — Produza uma lista classificada de possíveis causas, com base no manual de domínio relevante e em quaisquer evidências coletadas durante a triagem.
3. Testar casos — Confirme ou elimine uma versão de cada vez. A habilidade busca logs, traces, itens de fila, dados de recuperação, configuração e eventos de auditoria por meio de uip para coletar evidências.
4. Resolução — Apresentar a causa raiz, a cadeia de eventos que produziu a falha e uma correção objetiva. A habilidade pede aprovação explícita antes de alterar qualquer coisa.

O usuário pode estar envolvido em quatro momentos: esclarecendo o escopo durante a triagem, fornecendo contexto extra para a geração de sugestões, fornecendo o código-fonte ou arquivos de configuração quando necessário e aprovando correções recomendadas.

O que você pode diagnosticar hoje

A habilidade Solução de problemas abrange os seguintes domínios. Você descreve o problema; a habilidade busca a evidência e retorna uma causa raiz.

Domínio	O que você pode diagnosticar	Exemplo de pergunta
RPA	Trabalhos com falha (SelectorNotFoundException, TimeoutException e semelhantes), incompatibilidades de seletor, falhas de itens da fila, análise de dados do Healing Agent	"Por que o trabalho do InvoiceBot falhou esta hora?"
Orchestrator	Trabalhos travados ou com falha, problemas de permissão e função, erros de implantação e publicação, problemas de configuração de fila	"Por que meu robô não está coletando itens da fila Finanças?"
Maestro	Instâncias de processo com falha, falhas no nível da etapa, incidentes, cadeias de falha de vários domínios que envolvem agentes ou RPA	"Por que a instância do processo de aprovação falhou na etapa 3?"

O suporte para outros domínios da UiPath já está em vigor, mas ainda está sendo aprofundado. Mais domínios e diagnósticos mais avançados estão a caminho.

A habilidade opera com o mesmo acesso que você tem. Se você não puder ler certos logs ou pastas como um usuário conectado, a habilidade também não poderá lê-los.

Pré-requisitos

1. Habilidades da UiPath instaladas para seu agente. Consulte Usando o UiPath CLI com agentes de codificação para obter o comando de instalação por agente.
2. Uma sessão conectada (uip login). Consulte Autenticação.

Etapas

Execute a configuração descrita aqui Usando o UiPath CLI com Agentes de Codificação uma vez por máquina. Depois disso, a habilidade estará disponível em todas as sessões.

Inicie seu agente de codificação a partir de qualquer terminal em sua máquina ou do terminal integrado no UiPath Studio e, em seguida, inicie uma sessão de diagnóstico inserindo /uipath-troubleshoot para invocar a habilidade explicitamente ou descrevendo o problema diretamente — por exemplo, "Meu trabalho abc- 123 falhou, o que aconteceu?"

Responda às solicitações de acompanhamento da habilidade. Responda a perguntas de esclarecimento em inglês simples e compartilhe código-fonte, arquivos de configuração ou outros artefatos quando a habilidade os solicitar.

A habilidade imprime um resumo estruturado da causa raiz — o componente com falha, a cadeia de eventos que produziu a falha, evidências de suporte de logs e traces e uma correção recomendada. Antes de alterar qualquer coisa em sua máquina ou em seu tenant, a habilidade pede aprovação explícita.

O exemplo a seguir mostra uma sessão executada a partir do terminal integrado no UiPath Studio:

Dicas para sessões eficazes

Trate a habilidade como um colega ajudando você a depurar; o contexto e as idas e vindas melhoram o resultado:

• Seja específico. IDs de trabalhos, nomes de processos, nomes de filas e mensagens de erro exatas permitem que a habilidade pule etapas de esclarecimento.
• Continue a conversa. Se a primeira recomendação não corresponder ao que você observa, diga-o. Frases como "não é isso", "Já verifiquei isso" ou " vai mais fundo" mantêm a investigação em andamento.
• Redirecionar quando necessário. Se a habilidade seguir o thread errado, corrija-o — por exemplo, "o problema não está com permissões; o trabalho foi bem executado ontem".
• Compartilhar arquivos quando solicitado. XAML, project.json, arquivos de configuração e artefatos semelhantes melhoram drasticamente a qualidade do diagnóstico.
• Combine o acesso às expectativas. A habilidade usa sua sessão uip conectada e herda suas permissões. Se você não puder visualizar um log, a habilidade também não poderá.

Veja também

• Habilidades — o mecanismo mais amplo de habilidades
• Uso do UiPath CLI com Agentes de Codificação — instalando o catálogo de habilidades da UiPath no Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex e OpenCode
• Gerenciamento de ferramentas e habilidades — manutenção do dia a dia