Crie agentes codificados com Agentes de Codificação

Estruture, escreva, empacote e publique agentes codificados baseados em Python no UiPath Orchestrator inteiramente a partir de um agente de codificação e do 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 lida com orquestração, agendamento, escalonamento e governança assim que o agente é implantado.

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

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

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 SDK da UiPath de sua escolha e execute uip codedagent setup e uip codedagent new para estruturar a estrutura do projeto.	"Inicializar um novo projeto de agente codificado chamado invoice-processor."
Escrever lógica do agente	Escreva e itere no código do agente Python usando LangGraph, LlamaIndex ou Agentes OpenAI	"Adicione uma ferramenta que chame o índice de contextualização da UiPath para verificar a política da empresa."
Configurar	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	"Empacote o agente."
Publicar	uip codedagent publish para carregar o pacote no Orchestrator e criar automaticamente um processo	"Publicar o agente no meu espaço de trabalho pessoal."
Sincronizar com o Studio Web	uip codedagent push para carregar arquivos locais no projeto remoto do Studio Web ou para baixar todos uip codedagent pull arquivos do projeto remoto para seu espaço de trabalho local	"Enviar minhas alterações locais para o Studio Web."

O loop de compilação

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

Inicializar > Gravar > Avaliar > Pacote > 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 estruture 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 a lógica até que os resultados apareç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 quiser fazer alterações adicionais no Studio Web:

   • Enviar por push — execute uip codedagent push para carregar arquivos locais para o projeto remoto do Studio Web.
   • Puxar — 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 do 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 está sendo executado como um processo. A UiPath lida com agendamento, novas tentativas e registro em log.

Pacotes do 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 com intervenção humana, proteções, anexos de trabalho) por meio de extrações nativas do framework.

Exemplos de compilações

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 de plataforma.

O que perguntar	O que é criado
"Crie um agente codificado que pesquise um tópico e produza um relatório de resumo."	Agente de pesquisa com chamadas de LLM
"Crie um agente codificado que analisa um arquivo CSV fornecido como entrada."	Agente conectado para receber um anexo do trabalho como entrada
"Crie um agente codificado que use um índice de contextualização da UiPath para verificar a política da empresa."	Pipeline RAG (retrieval-augmented generation) em 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 cobrem proteções, humanos no processo, agentes distribuídos e agentes de conversação.
• Amostras do LlamaIndex — Padrões de integração da UiPath para o LlamaIndex.
• Amostras de Agentes OpenAI — Padrões de integração da UiPath para Agentes OpenAI.

Veja também

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