Sobre agentes codificados

Os agentes codificados da UiPath® são desenvolvidos diretamente com código no Ambiente de Desenvolvimento Integrado (IDE) preferido pelo desenvolvedor. Eles fornecem aos desenvolvedores controle completo sobre a lógica do agente, comportamento e integração com sistemas externos.

Usando um SDK da UiPath, você pode empacotar esse código e implantá-lo no Orchestrator como um pacote padrão .nupkg em um feed de pacotes de sua escolha. De lá, ele pode ser usado para criar processos em uma ou mais pastas.

O agente codificado é implantado como um processo UiPath dentro de pastas do Orchestrator. Uma vez integrado na plataforma, ele segue os mesmos princípios de governança dos processos padrão. Isso permite a implantação organizada dentro de pastas e significa que você pode agendar, disparar e monitorar a execução do agente, enquanto o integra a fluxos de trabalho de automação mais amplos.

A ilustração a seguir descreve o processo de criação, implantação e execução de um agente codificado dentro da UiPath Platform.

O processo inclui:

1. Definir a lógica do agente em um IDE, 2) Estabelecer uma conexão segura com a UiPath, 3) Implantar o agente no Orchestrator e 4) Executar o agente dentro do ecossistema da UiPath.

Idiomas e estruturas do SDK compatíveis

A biblioteca do SDK da UiPath e seus idiomas e estruturas compatíveis estão em contínua expansão. Oferecemos suporte a:

Idioma/framework	Repositório	Funcionalidade
Python (versões 3.11, 3.12, 3.13)	uipath-python	Python SDK that features a CLI for creation, packaging, and deployment of agents to the UiPath Platform. It also enables programmatic interaction with UiPath Platform resources like processes, assets, buckets, Context Grounding, data services, jobs, and more.
Python com LangGraph	Extensão uipath-python: uipath-langchain-python	Python SDK that enables developers to build and deploy LangGraph agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services and human-in-the-loop through Action Center.
LLamaIndex	uipath-llamaindex-python	Python SDK that enables developers to build and deploy LlamaIndex agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services and human-in-the-loop (HITL) semantics through Action Center integration.
Agentes OpenAI	uipath-openai-agents	Python SDK that enables developers to build and deploy OpenAI Agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services.

Para obter as informações mais recentes sobre as atualizações do SDK da UiPath, consulte a Política de lançamento.

Recursos de agentes codificados

Integração de recursos da UiPath por meio do SDK

Os SDKs da UiPath fornecem aos desenvolvedores a lógica necessária para invocar e interagir com outros recursos da UiPath diretamente dentro de seu código, permitindo uma integração perfeita com as funcionalidades existentes da UiPath. Por exemplo, os desenvolvedores podem usar ativos da UiPath para armazenamento e gerenciamento seguro de dados confidenciais, acessar e manipular dados armazenados em buckets da UiPath e estabelecer e gerenciar conexões com vários sistemas e serviços. Além disso, os desenvolvedores podem disparar e interagir com outros processos da UiPath de dentro do agente codificado.

Para obter detalhes sobre os recursos da UiPath que você pode usar em seu agente codificado, consulte a documentação do SDK.

Para marcar mais exemplos e padrões de implementação, consulte os projetos de amostra em nosso repositório GitHub (Python, LlamaIndex).

Intervenção humana para agentes codificados

Você pode definir pontos de interrupção dentro do seu agente para solicitar uma intervenção humana. Quando uma interrupção é acionada, a execução do agente é pausada e é solicitada uma intervenção do usuário designado. Após a intervenção humana, a execução é retomada.

O modo como você define os pontos de interrupção varia de acordo com o idioma do agente:

• Alguns frameworks, como o LangGraph, oferecem padrões de interrupção nativos, permitindo a intervenção humana na execução do agente.

• Com os SDKs da UiPath, você pode introduzir uma tarefa da UiPath como a lógica de interrupção. Quando uma interrupção é acionada, a execução é pausada e uma tarefa é criada no Action Center.

  • Os Usuários podem revisar o progresso do agente, fornecer feedback ou tomar decisões e agir sobre a tarefa gerada por meio de um aplicativo de ação.
  • Depois que a interação humana for concluída, o agente retoma sua execução a partir do ponto de interrupção.

Configuração de variáveis de ambiente para agentes codificados

Você pode configurar seu projeto com variáveis de ambiente usando ativos secretos, eliminando a necessidade de modificações diretas no código.

Aproveitando o suporte do Orchestrator para integração com armazenamentos de credenciais externos, como o CyberArk para ativos de credenciais, você pode vincular seu armazenamento do CyberArk e configurar uma variável de ambiente para que seu agente use esse ativo secreto. No runtime, o Orchestrator recupera com segurança a chave do CyberArk por meio do ativo e a disponibiliza para seu agente como uma variável de ambiente.

Navegue até o processo do seu agente no Orchestrator para definir e gerenciar chaves de API, parâmetros de runtime e outros valores de configuração necessários pelo código do seu agente. Para obter detalhes, consulte Iniciar um trabalho de agente.

Habilitação de rastreamento e depuração com LangSmith

Configure variáveis de ambiente padrão do LangSmith (como LANGCHAIN_TRACING_V2, LANGCHAIN_API_KEY, LANGCHAIN_PROJECT) para habilitar rastreamento detalhado da execução do seu agente dentro do LangSmith.

Essa integração fornece rastreamentos detalhados em sua conta LangSmith para cada execução do agente da UiPath. Isso permite que você analise o raciocínio do agente, o caminho de execução e identifique áreas para depuração e otimização de desempenho.