Escalonamentos e memória do agente

Sobre escalonamentos

Como desenvolvedor, pode ser interessante dar ao seu agente uma maneira de validar os detalhes do caso de negócios com um ser humano antes de executar uma ferramenta ou solicitar assistência manual se eles encontrarem problemas.Em outros casos, pode haver exceções de negócios em um processo quando você quer que a aprovação de um agente seja feita por um humano ou algum outro tipo de decisão.

É aqui que os escalonamentos entram. Os escalonamentos são alimentados por apps no Action Center e fornecem aos desenvolvedores as ferramentas para projetar e configurar eventos com humanos no processo na execução do agente. Confira o guia de início rápido Criando escalonamentos de agente com apps do Action.

Memória do agente

Observação: essa funcionalidade está disponível como visualização.

A Memória do agente é um serviço incorporado em cada agente que permite que ele retenha fatos e observações entre execuções. Ele permite que os agentes tomem decisões mais informadas, aproveitando escalonamentos anteriores e suas resoluções, suportando a memória de longo prazo junto com índices de contextualização.

Como funciona

Quando um agente encontra um cenário que dispara uma escalonamento, ele primeiro verifica se memorizou anteriormente uma resolução para essa situação. Se existir uma memória correspondente, o agente pode resolver o problema automaticamente sem escalonamento. Se não, o escalonamento prossegue como de costume. Após resolvido, o agente armazena esse resultado como uma memória para uso futuro.

Há uma distinção entre memórias de design e runtime:

• Memória de tempo de design: armazena escalonamentos e suas resoluções durante a criação e testes do agente no Studio.
• Memória do runtime: captura escalonamentos resolvidos durante a execução do agente em tempo real em produção.

Cada escalonamento resolvido no Action Center armazena um par chave-valor da pergunta e contexto de suporte:

• A chave é a pergunta ou consulta de gatilho (limitada a 80 caracteres).
• O valor contém o contexto de resolução fornecido durante o processamento de escalonamento.

Eles são então associados utilizando similaridade semântica para as consultas recebidas.A pergunta (chave) tem um limite de 80 caracteres e o par valor-chave tem um TTL (tempo de vida útil) de 3 meses.

Como habilitar

Configurr a memória do agente durante a configuração de escalonamento:

1. Abra o painel Escalonamentos na definição do agente.
2. Selecione um aplicativo de escalonamento.
3. Habilitar a Memória do agente. Isso vincula o armazenamento de memória à versão mais recente do agente publicado.

4. Uma vez habilitado:

   • No runtime, o agente armazena cada tarefa do Action Center acionada por um escalonamento.
   • Os usuários que resolvem um escalonamento têm a opção de excluí-lo da memória se não for reutilizado.

Observação: o acesso à pasta Compartilhada é necessário para usar a Memória do agente.

Configuração de escalonamentos

Você pode criar vários escalonamentos para diferentes situações nas quais um agente pode exigir assistência humana.

Use o painel Propriedades para adicionar e configurar o escalonamento.

1. Selecionar um app de ação entre seus recursos disponíveis.

   Você deve primeiro implantar um aplicativo em seu tenant.

2. Adicione uma Solicitação para ajudar o agente a saber quando usar o escalonamento.

   A solicitação atua como uma condição de gatilho, orientando o agente quando esse escalonamento é apropriado.

3. Opcionalmente, habilite a Memória do agente.

   Ative essa opção para armazenar pares de perguntas e respostas de escalonamentos e use text embeddings para resolver automaticamente escalonamentos com conteúdo muito semelhante a escalonamentos anteriores. A memória do agente armazena separadamente os escalonamentos de tempo de design e runtime.

4. Na seção Atribuições, adicione o Destinatário de escalonamento.

   Você pode atribuir um escalonamento a um usuário específico em sua organização UiPath®.

5. Na seção Entradas, defina os campos e valores que o agente passará para o Aplicativo de Ação. Isso corresponde ao Esquema de Ação, os campos necessários no aplicativo selecionado.

   Para cada campo, adicione uma descrição para ajudar o agente a entender que tipo de valor deve ser passado. Essas descrições melhoram a capacidade do agente de inferir e preencher valores com base no contexto ao levantar o escalonamento.

6. Na seção Comportamento de resultado, especifique como cada resultado deve ser tratado pelo agente após um escalonamento ser resolvido. Para cada resultado definido no Aplicativo de ação:
   • Selecione Continuar se o agente deve retomar seu processo usando as entradas fornecidas pelo destinatário de escalonamento.
   • Selecione Encerrar se o agente deve ser encerrado assim que o resultado for selecionado. Para esta configuração, é possível controlar a autonomia do agente após a intervenção humana.

Após criar um escalonamento, você pode consultá-lo a partir do prompt do sistema. Use instruções explícitas, como: "Antes de usar a Ferramenta X, certifique-se de iniciar o escalonamento de Confirmação Humana e incluir os detalhes da ação proposta."

Observação:

No momento, os agentes não são compatíveis com o tipo de argumento Entrada/Saída para propriedades do Esquema de ação.