Crie agentes de pouco código com Agentes de Codificação

Estruture, configure, avalie e publique agentes UiPath de pouco código inteiramente a partir de um agente de codificação e terminal, sem um navegador após o login inicial.

Um agente de codificação com as habilidades da UiPath instaladas pode estruturar, configurar, validar e publicar agentes de pouco código da UiPath inteiramente a partir do seu terminal, sem a necessidade de navegador após o login inicial. Você descreve o agente que deseja criar, o agente de codificação cria e itera os arquivos do projeto e carrega o resultado no Studio Web.

Para configuração (instalação do agente, login, instalação de habilidades), consulte Instalar e configurar.

Pré-requisitos

• A habilidade uipath-agents instalada para seu agente de codificação. Consulte Instalar e configurar.
• Uma sessão conectada (uip login).

O que o agente pode fazer

Cada linha abrange um estágio do ciclo de vida do agente. O agente de codificação escolhe os comandos uip agent certos da habilidade instalada — você declara o resultado, não o comando.

Area	O que o agente pode fazer	Exemplo de pergunta
Estrutura	Crie um novo projeto de agente com a estrutura de diretórios completa, incluindo agent.json, esquemas de entrada/saída e conjuntos de avaliação padrão	"Crie um novo agente de análise de sentimento para comentários de entrada de mídia social."
Configurar solicitações e esquemas	Edite o prompt do sistema, o modelo de mensagem do usuário, os esquemas de entrada/saída e as configurações do modelo LLM em agent.json	"Atualizar a solicitação do sistema para lidar com dados de fatura e adicionar um campo de confiança ao esquema de saída."
Adicionar e gerenciar ferramentas	Adicione processos de RPA, outros agentes, fluxos de trabalho de API, fluxos do Maestro, ferramentas de conector do Integration Service, contextualização e aplicativos de escalonamento	"Adicione uma ferramenta de pesquisa do SharePoint e um processo de RPA à validação de documentos."
Atualizar e validar	Execute uip agent refresh para escrever artefatos e sincronizar esquemas de entry-points, em seguida, uip agent validate para verificar a estrutura JSON (somente leitura); corrija erros automaticamente	"Validar o agente e corrigir os erros."
Carregar e baixar	Carregue o projeto local para o Studio Web (uip solution upload) ou baixe uma solução existente do Studio Web para editar localmente (uip solution download)	"Carregue o agente no Studio Web para que eu possa revisá-lo."
Avaliar	Crie conjuntos de avaliações e casos de teste, execute-os no Runtime do agente e revise pontuações e traces de execução	"Execute o conjunto de avaliação de regressão e mostre quais casos de teste pontuaram abaixo de 0,7."
Empacotar e implantar	Empacote e publique a solução por meio de uip solution pack e uip solution publish, implante-a como um processo e inicie um trabalho	"Implantar o agente de fatura na pasta Produção."

O loop de compilação

O agente de codificação segue esse ciclo ao criar ou iterar em um agente de pouco código:

Estrutura > Configurar > Adicionar recursos > Atualizar > Validar > Corrigir > Upload

1. Estrutura — crie a solução com uip solution init e, em seguida, estruture o agente com uip agent init.

2. Configurar — defina as solicitações, esquemas e configurações do modelo em agent.json.

3. Adicionar recursos — crie um arquivo resource.json em resources/<tool-name>/ para cada ferramenta precisa do agente.

4. Atualizar — escreva artefatos e sincronize esquemas de ponto de entrada com uip agent refresh.

5. Validar — verifique a estrutura do JSON com uip agent validate (somente leitura).

6. Corrigir — corrija quaisquer erros de validação e depois volte para Atualizar. Vários ciclos são esperados e normais.

7. Carregar — assim que o projeto estiver limpo, carregue-o para o Studio Web com uip solution upload.

Resultado: o projeto do agente agora é visível no Studio Web e disponível para revisão, avaliação ou implantação.

Estrutura do projeto do agente

Quando o agente de codificação executa uip solution init e uip agent init, ele cria a seguinte estrutura:

<AgentName>/
├── agent.json               # System prompt, user message template, LLM settings, input/output schemas
├── project.json             # Project metadata
├── entry-points.json        # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json         # Resource binding references
├── SolutionStorage.json     # Written after push — captures the Studio Web solution ID
│
├── resources/               # One directory per tool
│   └── <tool-name>/
│       └── resource.json    # Tool config: type, connector key, schema, connection ID
│
├── connections/             # Connection references for bound Integration Service tools
│
├── evals/                   # Evaluation configuration
│   ├── evaluators/          # Evaluator definitions (semantic similarity, trajectory by default)
│   └── eval-sets/           # Test case collections
│
└── userProfile/
    └── debug_overwrites.json  # Local connection overrides for debugging

Tipos de ferramentas

O agente de codificação registra tipos de ferramentas criando diretamente arquivos resource.json em resources/<tool-name>/. O campo type em cada arquivo determina o tipo de ferramenta. O suporte à execução em runtime varia — alguns tipos podem ser registrados para compatibilidade com o Studio Web, mas ainda não são executados no runtime do agente.

Tipo de ferramenta	resource.json Tipo	Executa no runtime do agente
Conector do Integration Service	integration	Sim
Processo do Orchestrator (RPA)	process	Sim (não interativo)
Subagente	agent	Sim
Fluxo de trabalho da API	api	Apenas registro
Fluxo do Maestro	processOrchestration	Apenas registro
Extração e Processamento Inteligente (IXP) (Processamento de documentos)	ixp	Apenas registro

A contextualização, os aplicativos de escalonamento e os servidores MCP são adicionados como recursos de solução separados em vez de arquivos resource.json do tipo de ferramenta. O agente de codificação os cria e sincroniza no projeto com uip solution resources refresh.

Exemplos de compilações

Abra seu agente de codificação e descreva o agente que você deseja. O agente carrega a habilidade UiPath Agents e lida com o resto.

O que perguntar	O que é criado
"Crie um novo agente de análise de sentimento para comentários de entrada de mídia social."	Agente independente com uma solicitação do sistema personalizada e esquemas de entrada/saída estruturados
"Adicione um agente gerenciador de mídia social que delegue ao agente de análise de sentimento a tarefa de lidar com um lote de comentários de entrada."	Solução de vários agentes com um agente gerente usando o agente de análise de sentimento como ferramenta
"Crie para mim um fluxo com um agente de IA para redigir e-mails profissionais."	Projeto de fluxo com um nó de agente em linha conectado aos nós inicial e final

Avaliando seu agente

O agente de codificação pode direcionar um loop completo de compilação-avaliação-aprimoramento:

1. Crie e configure o agente localmente.
2. Carregar para o Studio Web (uip solution upload) — as avaliações são executadas no runtime do agente e exigem que o projeto seja carregado primeiro.
3. Execute um conjunto de avaliações e aguarde os resultados.
4. Revise pontuações por caso de teste, rastreamentos de execução e mensagens de falha.
5. Ajuste as solicitações ou a configuração com base em falhas.
6. Carregue o agente atualizado (uip solution upload).
7. Execute novamente o conjunto de avaliação.

Resultado: a execução de avaliação é concluída com sucesso, com pontuações visíveis para cada caso de teste e indicadores claros de quais casos foram aprovados ou falharam.

Exemplo pergunta:

• "Crie um conjunto de avaliação chamado testes de regressão com cinco casos de teste abrangendo os principais cenários de entrada de faturas."
• "Executar o conjunto de avaliação de testes de regressão e mostrar os resultados."
• "O terceiro caso de teste falhou com uma pontuação de trajetória baixa — atualize o prompt do sistema para tornar a seleção de ferramentas mais explícita e execute novamente."

Os seguintes tipos de avaliador estão disponíveis:

Avaliador	O que ele mede
Similaridade semântica	Compara a saída esperada com a saída real semanticamente
Trajetória	Verifica se o agente seguiu as etapas de uso esperado da ferramenta e raciocínio
Precisão de contexto	Pontua a relevância do contexto recuperado para a consulta
Fidelidade	Pontua se as respostas do agente estão baseadas no contexto fornecido

Veja também

• Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
• Instalar e configurar — configuração do agente e instalação de habilidades.
• Crie agentes codificados com Agentes de Codificação — agentes codificados baseados em Python a partir de um terminal de agente de codificação.
• Visão geral de habilidades — o modelo de habilidade que direciona esse comportamento.
• referência do agente uip — referência de comando completa para ciclo de vida do agente, ferramentas, avaliações, push, pull e implantação.