Agentes avançados (visualização)

O recurso avançado para execuções longas, adicionando um espaço de trabalho de arquivos, delegação de subagentes, chamada de ferramentas programáticas e um intérprete de código JavaScript em sandbox.

Observação:

Essa funcionalidade está disponível em visualização, apenas no Automation Cloud. Ela não está disponível no Automation Suite.

Um agente é um modelo mais um colete. O modelo faz o raciocínio, enquanto o aproveitamento é tudo construído em torno dele: o loop que o direciona, as ferramentas que ele pode chamar e a memória na qual pode escrever. Os agentes de pouco código da UiPath oferecem dois aproveitamentos, e o mesmo modelo produz resultados diferentes dependendo de qual deles o executar.

O recurso padrão é um loop de raciocínio e ação. O agente lê o prompt, chama uma ferramenta, lê o resultado e as respostas, com tudo mantido em uma única janela de contexto. É eficiente e previsível para o trabalho que termina em algumas chamadas de ferramenta.

O recurso avançado foi criado para execuções longas. Ele mantém o trabalho intermediário em um espaço de trabalho de arquivo em vez de na solicitação, delega fatias de trabalho a subagentes, pode chamar suas ferramentas programaticamente a partir do código e compacta seu contexto à medida que a execução cresce. Isso permite que ele permaneça coerente em dezenas de chamadas de ferramenta e documentos longos, onde uma única janela de contexto seria preenchida e o agente perderia a trilha do que já fez.

Padrão comparado ao avançado

O recurso é escolhido por agente. Selecionar o recurso avançado para um agente não muda nada sobre como qualquer outro agente se comporta.

Recurso	Aproveitamento padrão	Aproveitamento avançado
Loop de execução	Raciocinar e agir, um passe pelas ferramentas	Agir, observar e ajustar, repetido até ser concluído
Memória de trabalho	A janela de contexto	Um espaço de trabalho de arquivos que o agente lê e grava
Delegação	Nenhum	Subagentes com seu próprio contexto isolado
Compactação de contexto	Não disponível	A saída da ferramenta concluída é descarregada e o histórico mais antigo é podado
Chamada da ferramenta	Uma chamada de ferramenta por vez de modelo	As ferramentas também podem ser chamadas a partir do código em uma única etapa
Leitura de arquivos	Precisa de uma ferramenta de processamento de arquivos, como Analisar Arquivos	Os arquivos chegam no espaço de trabalho e são lidos com ferramentas de arquivo integradas
Trabalho típico	Tarefas curtas e bem definidas	Tarefas de longa duração, várias etapas e com muitos documentos

Escolha de um colete

O recurso avançado é adequado para trabalhos que mostram dois ou mais dos seguintes sinais:

• O trabalho é executado por muito tempo, aceitando dezenas de chamadas de ferramentas em vez de um pequeno pequeno número.
• O trabalho intermediário do agente é importante e deve persistir como arquivos que podem ser abertos posteriormente.
• As partes do trabalho são independentes e se beneficiam de serem tratadas separadamente.
• O material envolvido é maior do que cabe em uma única solicitação, como documentos longos ou conjuntos de registros grandes.

Pesquisa, análise e fluxos de trabalho com muitos documentos são exemplos típicos. O mesmo acontece com qualquer tarefa em que o agente deve reunir evidências, ponderá-las com base em um conjunto de critérios e justificar uma conclusão.

O recurso padrão continua sendo a melhor escolha para tarefas curtas, previsíveis e concluídas em algumas chamadas de ferramenta. Também não traz restrições de visualização.

Capabilities

O recurso avançado adiciona o seguinte a um agente, sem configuração necessária.

Contexto e arquivos

• Espaço de trabalho de arquivos: um sistema de arquivos por execução com ferramentas para listar, ler, escrever, editar, excluir, pesquisar e combinar arquivos. Os resultados intermediários vão para arquivos em vez de para o prompt, que mantém o contexto pequeno.
• Acesso direto ao arquivo: um agente avançado não precisa da ferramenta Analisar arquivos . Os arquivos de entrada e os arquivos que um usuário carrega na janela de chat de um agente de conversa são baixados para o espaço de trabalho automaticamente e lidos com as ferramentas de arquivo integradas. Como eles chegam como arquivos reais, o agente pode pesquisar um documento longo e ler apenas as partes de que precisa, em vez de passar o arquivo inteiro pelo modelo.
• Memória do espaço de trabalho: notas que o agente mantém para si no espaço de trabalho, carregadas de volta no prompt do sistema a cada vez.
• Compactação de contexto: a saída da ferramenta concluída é descarregada e o histórico mais antigo é podado, para que os prompts permaneçam tratáveis em execuções longas.

A memória do Workspace não é a mesma funcionalidade que a memória do agente. A memória do espaço de trabalho pertence a uma única execução e reside no espaço de trabalho dessa execução. A memória do agente é um armazenamento separado e persistente que carrega memórias episódicas e de escalonamento entre execuções e pode ser compartilhada entre agentes.

Executando o trabalho

• Delegação de subagente: o agente entrega uma fatia do trabalho a um subagente de uso geral que é executado com seu próprio contexto e retorna apenas o seu resultado, deixando o contexto principal limpo.
• Chamada de ferramentas programáticas: o agente escreve JavaScript que chama suas próprias ferramentas diretamente, para que possa distribuir uma lista de itens, filtrar e agregar em uma única etapa em vez de fazer uma viagem de ida e volta do modelo por chamada de ferramenta. As ferramentas que pausam a execução para uma pessoa são excluídas e são chamadas normalmente, portanto, nenhum recurso é perdido.
• Intérprete de código: uma sandbox JavaScript persistente usada para cálculos, para chamada de ferramentas programáticas e para enviar subagentes. Não tem rede nem acesso ao sistema de arquivos.
• Autocorreção: chamadas de ferramenta com falha, incompatibilidades de esquema e pontos sem saída são detectados e repetidos com uma abordagem ajustada.

Seleção do recurso avançado

O aproveitamento é escolhido na configuração de Aproveitamento do agente quando um agente de pouco código é projetado. Duas opções são oferecidas, Arnês padrão e Arnês avançado, com a opção avançada marcada como uma visualização.

AVISO:

Mover um agente existente para o recurso avançado descarta permanentemente quaisquer valores Estáticos e de Argumento configurados em suas ferramentas, juntamente com quaisquer configurações por modelo. Voltar não os restaura.

Trabalhando com arquivos

As entradas de arquivo são declaradas no Gerenciador de dados da mesma forma que para o trilho padrão e podem ser referenciadas a partir do prompt por nome. O agente também pode encontrá-los por conta própria, porque cada arquivo de entrada é colocado em seu espaço de trabalho antes do início da execução.

Os arquivos do espaço de trabalho são carregados como anexos no trabalho, que é o que os faz suportar uma pausa para entrada humana e estar lá novamente quando a execução for retomada. Os nomes dos anexos são prefixados para marcá-los como arquivos do espaço de trabalho, para que apareçam no trabalho ao lado de quaisquer outros anexos.

Nem toda execução preserva seu espaço de trabalho. Por padrão, o espaço de trabalho de um agente autônomo é carregado quando a execução é suspensa, portanto, os arquivos de uma execução que termina sem suspensão não são retidos. Um agente de conversação retém seu espaço de trabalho entre trocas da mesma conversa.

Consumo

Os agentes avançados são cobrados por chamada de LLM, da mesma forma e contra as mesmas unidades que os agentes padrão. Para obter as taxas padrão por nível de modelo e plano de preços, consulte Licenciamento.

Durante a visualização pública, o consumo avançado de agente é 50% abaixo da taxa padrão.

Como o recurso avançado delega e revisa seu trabalho, uma única execução de agente avançada faz mais chamadas de LLM do que uma execução de agente padrão equivalente. O consumo total para uma execução depende de quantas chamadas o agente faz, não apenas da taxa por chamada.

Ainda não compatível

A seguir estão lacunas na visualização, em vez de características permanentes do recurso avançado.

• Não é possível configurar os valores do argumento da ferramenta. Cada parâmetro da ferramenta é fornecido pelo modelo. Os valores estáticos e de argumento não estão disponíveis.
• Proteções não são compatíveis. Um agente avançado que tem proteções configuradas recusa-se a ser executado, falhando na inicialização com o erro "As proteções ainda não são compatíveis com agentes avançados". Onde uma política de governança requer um escalonamento ou uma proteção humana antes que um agente possa ser publicado, apenas um escalonamento o satisfaz.
• Algumas atividades do Integration Service estão indisponíveis. As atividades afetadas aparecem desabilitadas em um agente avançado.
• Não é possível definir subagentes personalizados. O agente delega a um subagente integrado de uso geral. O suporte para configurar subagentes personalizados está chegando.
• Um agente avançado não pode ser clonado como um agente codificado. Para obter detalhes sobre essa conversão, consulte Clonar um agente de pouco código conforme codificado.

Informações relacionadas

• Licenciamento
• Memória do agente
• Limitações
• Agentes padrão versus agentes avançados no blog da UiPath