Crie agentes de pouco código com Coding Agents

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

Um agente de codificação com habilidades da UiPath instaladas pode estruturar, configurar, validar e publicar agentes de pouco código da UiPath inteiramente a partir do seu terminal — sem 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 configurar (instalação do agente, registro, 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ê indica o resultado, não o comando.

Area	O que o agente pode fazer	Exemplo de pergunta
Estruturar	Crie um novo projeto de agente com a estrutura completa de diretório, 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ídias sociais."
Configurar solicitações e esquemas	Edite a solicitação do sistema, o modelo de mensagem do usuário, os esquemas de entrada/saída e as configurações do modelo de LLM em agent.json	"Atualizar a solicitação do sistema para lidar com os dados da 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 Apps de escalonamento	"Adicionar uma ferramenta de pesquisa do SharePoint e um processo de RPA para validação de documentos."
Atualizar e validar	Execute uip agent refresh para escrever artefatos e sincronizar esquemas de ponto de entrada e, em seguida, uip agent validate para verificar a estrutura JSON (Somente leitura); corrigir erros automaticamente	"Validar o agente e corrigir quaisquer erros."
Carregar e baixar	Carregue o projeto local no 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ção e casos de teste, execute-os no runtime do agente e revise as pontuações e rastreamentos de execução	"Executar o conjunto de avaliação de regressão e mostrar quais casos de teste tiveram pontuação abaixo de 0,7."
Empacotar e implantar	Crie um pacote e publique a solução por meio de uip solution pack e uip solution publish, realize a implantação como um processo e inicie um trabalho	"Implantar o agente de fatura na pasta de produção."

O loop de criação

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

Estruturar > Configurar > Adicionar recursos > Atualizar > Validar > Corrigir > Carregar

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

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

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

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

5. Validar — verifique a estrutura JSON com uip agent validate(SomenteLeitura).

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

7. Carregar — quando o projeto estiver limpo, carregue-o no Studio Web com uip solution upload.

Resultado: o projeto do agente agora está 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 arquivos resource.json diretamente em resources/<tool-name>/. O campo type em cada arquivo determina o tipo de ferramenta. O suporte à execução de 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
IXP (Extração e Processamento Inteligente) (Processamento de documentos)	ixp	Apenas registro

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

Builds de exemplo

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

O que perguntar	O que é criado
"Crie um novo agente de análise de sentimento para comentários de entrada de mídias sociais."	Agente independente com uma solicitação de 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 administração de um lote de comentários de entrada."	Solução com vários agentes com um agente de gerenciamento usando o agente de análise de sentimento como uma ferramenta
"Criar um fluxo para mim com um agente de IA para redigir e-mails profissionais."	Projeto de fluxo com um nó de agente em linha conectado aos nós de início e término

Avaliação de seu agente

O agente de codificação pode conduzir um loop completo de criação-avaliação-melhoria:

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

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

O exemplo pergunta:

• "Criar um conjunto de avaliação chamado testes de regressão com cinco casos de teste que cubram 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 — atualizar a solicitação do sistema para tornar a seleção de ferramentas mais explícita e reexecutar."

Os seguintes tipos de avaliadores 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 esperadas de uso de ferramentas e raciocínio
Precisão de contexto	Pontuação de relevância do contexto recuperado para a consulta
Fidelidade	Pontua se as respostas do agente estão baseadas no contexto fornecido

Veja também

• Introdução aos agentes da UiPath — laboratório prático para criar e implantar um agente de pouco código a partir da CLI.
• Instalar e configurar — configuração do agente e instalação de habilidades.
• Criar agentes codificados com os Coding Agents — agentes codificados baseados em Python a partir de um terminal de agente de codificação.
• Visão geral das habilidades — o modelo de habilidades que impulsiona esse comportamento.
• Referência do agente uip — referência de comando completa para o ciclo de vida do agente, ferramentas, avaliações, push, pull e implantação.