Crie agentes codificados com Coding Agents

Prepare, escreva, empacote e publique agentes codificados baseados em Python no UiPath Orchestrator inteiramente a partir de um agente de codificação e terminal.

Um agente de codificação com a habilidade uipath-agents instalada pode estruturar, escrever, empacotar e publicar agentes baseados em Python no UiPath Orchestrator inteiramente a partir do seu terminal. Os agentes codificados são projetos Python padrão criados com LangGraph, LlamaIndex ou OpenAI Agents, e a UiPath cuida da orquestração, agendamento, escalonamento e governança após a implantação do agente.

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

Para obter uma referência completa dos comandos uip codedagent, consulte o guia da CLI da UiPath.

Pré-requisitos

• A habilidade uipath-agents instalada para seu agente de codificação. Consulte Instalar e configurar.
• Uma sessão conectada (uip login).
• Python 3.11 ou mais recente.
• O gerenciador de pacotes uv.

O que o agente pode fazer

Area	O que o agente pode fazer	Exemplo de pergunta
Inicializar um projeto	Crie um novo projeto Python com uv, adicione o pacote de SDK da UiPath de sua preferência e execute uip codedagent setup e uip codedagent new para criar a estrutura do projeto	"Inicialize um novo projeto de agente codificado chamado invoice-processor."
Escreva a lógica do agente	Escreva e itere no código do agente Python usando LangGraph, LlamaIndex ou OpenAI Agents	"Adicione uma ferramenta que chame o Índice de contextualização da UiPath para verificar a política da empresa."
Configurar	Execute uip codedagent init para conectar o projeto Python à camada de orquestração da UiPath	"Configurar o agente para o UiPath Orchestrator."
Pacote	Execute uip codedagent pack para agrupar o agente como um artefato implantável	"Empacotar o agente."
Publicar	Execute uip codedagent publish para carregar o pacote no Orchestrator e criar automaticamente um processo	"Publicar o agente no meu espaço de trabalho pessoal."
Sincronize com o Studio Web	Use uip codedagent push para carregar arquivos locais no projeto remoto do Studio Web ou uip codedagent pull para baixar todos os arquivos do projeto remoto para seu espaço de trabalho local	"Envie minhas alterações locais para o Studio Web."

O loop de criação

O agente de codificação segue este ciclo ao criar ou iterar em um agente codificado:

Inicializar > Escrever > Avaliar > Empacotar > Sincronizar com o Studio Web (opcional) > Publicar > Definir variáveis de ambiente > Executar

1. Inicializar — crie um novo projeto Python, adicione o SDK da UiPath e gere a estrutura do projeto:

   mkdir my-agent && cd my-agent
   uv init
   uv add uipath-langchain   # or uipath-llamaindex / uipath-openai-agents
   uip codedagent setup
   uip codedagent new my-agent
   uip login
   uip codedagent init
   

2. Escrever — peça ao agente de codificação para escrever e editar a lógica do agente Python. Os agentes codificados são Python padrão e não estão limitados a recursos específicos da UiPath.

3. Avaliar — teste o agente antes de publicar:

   • Analisar — peça ao agente de codificação para configurar um conjunto de testes, executá-lo e explicar as pontuações.

   • Iterar — refine a solicitação ou lógica até que os resultados pareçam certos.

4. Pacote — empacote o agente com uip codedagent pack para criar um artefato implantável.

5. Sincronizar com o Studio Web (opcional) — se você quiser fazer outras alterações no Studio Web:

   • Push — execute uip codedagent push para carregar arquivos locais para o projeto remoto do Studio Web.
   • Pull — execute uip codedagent pull para baixar todos os arquivos do projeto remoto do Studio Web para seu espaço de trabalho local.

6. Publicar — publique o agente com uip codedagent publish --my-workspace para carregar o pacote no Orchestrator. Um processo é criado automaticamente em seu espaço de trabalho pessoal na primeira publicação.

7. Defina variáveis de ambiente — no Orchestrator, abra a configuração de processo e adicione quaisquer variáveis de ambiente necessárias (chaves de API, strings de conexão).

8. Executar — inicie o trabalho.

Resultado: o agente é implantado no Orchestrator e executado como um processo. A UiPath cuida do agendamento, NovasTentativas e registro.

Pacotes de SDK

Escolha o pacote que corresponde à estrutura do seu agente:

Pacote	Framework
uipath-langchain	LangChain/LangGraph
uipath-llamaindex	LLamaIndex
uipath-openai-agents	Agentes OpenAI

Todos os três pacotes expõem os mesmos recursos da UiPath (contextualização, escalonamento da intervenção humana, proteções, anexos de trabalho) por meio de abstrações nativas do framework.

Builds de exemplo

Abra seu agente de codificação e descreva o agente que você deseja criar. Como os agentes codificados são Python padrão, não há limites para o que você pode pedir — o SDK da UiPath adiciona orquestração, governança e integração da plataforma.

O que perguntar	O que é criado
"Criar um agente codificado que pesquisa um tópico e produz um relatório de resumo."	Agente de pesquisa com chamadas de LLM
"Criar um agente codificado que analisa um arquivo CSV fornecido como entrada."	Agente configurado para receber um anexo de trabalho como entrada
"Criar um agente codificado que use um índice de contextualização da UiPath para consultar a política da empresa."	Pipeline de Geração Aumentada por Recuperação (RAG) em relação a um Índice de contextualização da UiPath

Amostras

Os seguintes repositórios contêm implementações de referência:

• Amostras do UiPath LangChain — mais de 20 amostras que abrangem proteções, intervenção humana, agentes distribuídos e agentes conversacionais.
• Amostras de LlamaIndex — Padrões de integração da UiPath para o LlamaIndex.
• Amostras de OpenAI Agents — padrões de integração da UiPath para OpenAI Agents.

Veja também

• Instalar e configurar — configuração do agente e instalação de habilidades.
• Crie agentes de pouco código com Coding Agents — crie agentes do Agent Builder a partir de um agente de codificação.
• Documentação do UiPath Python SDK — referência completa do SDK para agentes codificados.