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.

Você também pode conectar um projeto de agente codificado ao Studio Web, que atua como um plano de controle para depuração, avaliação e publicação junto com seu IDE. Para obter mais informações, consulte Agentes codificados no Studio Web.

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 que apresenta uma CLI para criação, empacotamento e implantação de agentes para a plataforma UiPath Cloud. Também permite a interação programática com recursos da UiPath Platform, como processos, ativos, buckets, contextualização, serviços de dados, trabalhos e muito mais.
Python com LangGraph	Extensão uipath-python: uipath-langchain-python	Python SDK que permite que os desenvolvedores criem e implantem agentes do LangGraph para a plataforma UiPath Cloud. Esse pacote fornece interação programática com os serviços da UiPath Platform e humanos no processo por meio do Action Center.
LLamaIndex	uipath-llamaindex-python	Python SDK que permite que os desenvolvedores criem e implantem agentes LlamaIndex na UiPath Platform. Esse pacote fornece interação programática com os serviços da plataforma UiPath Cloud e semântica de interação humana (HITL) por meio da integração do Action Center.
Agentes do OpenAI	Uipath-openai-agentes	SDK do Python, que permite que os desenvolvedores criem e implantem agentes da OpenAI na UiPath Cloud Platform. Esse pacote fornece interação programática com os serviços do UiPath Cloud Platform.

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.

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.

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.