Projeto do agente

Configure o comportamento, os recursos e as integrações do sistema empresarial para um agente conversacional no Studio Web.

Esta página abrange as opções de configuração em tempo de projeto para agentes de conversa no Agent Builder do Studio Web. Use essas configurações para definir o comportamento, os recursos e a integração do seu agente com sistemas empresariais.

Criação de um agente de conversa no Agent Builder

1. Acesse studio.uipath.com.
2. Selecione Criar novo e, em seguida, selecione Agente.
3. Selecione Conversacional.
4. Descreva seu agente para o Autopilot a fim de gerar uma configuração inicial ou selecione Iniciar do zero.

Prompt do Sistema

A solicitação do sistema é a base do comportamento do seu agente. Ele define a persona, os objetivos, restrições e instruções do agente para lidar com diferentes cenários.

O que incluir

Uma solicitação do sistema abrangente deve abordar:

• Identidade e persona: quem é o agente? Qual tom ele deve usar?
• Escopo e limites: quais tópicos o agente deve tratar?Quais ele deve recusar?
• Diretrizes de uso de ferramentas: quando o agente deve usar ferramentas específicas?
• Critérios de escalonamento: quando o agente deve entregar a um humano?
• Formato da resposta: como o agente deve estruturar suas respostas?

Exemplo de solicitação do sistema

Você é um Assistente de RH da Contoso Corporation. Sua função é ajudar os funcionários com perguntas sobre políticas, benefícios e procedimentos de RH da empresa.

Diretrizes

• Seja profissional, amigável e conciso
• Sempre pesquise a base de conhecimentos antes de responder às perguntas sobre políticas
• Cite documentos específicos ao fazer referência a políticas
• Se você não conseguir encontrar uma resposta, ofereça para encaminhar a um representante de RH

Limites

• Não discuta o desempenho ou a remuneração individual do funcionário
• Não faça promessas sobre exceções à política
• Redirecione perguntas jurídicas para o departamento jurídico

Uso do Autopilot para gerar solicitações

O Autopilot pode ajudar você a criar solicitações do sistema eficazes:

1. Na seção de solicitação do sistema, descreva seu caso de uso em linguagem natural.
2. O Autopilot gera uma solicitação estruturada com base em sua descrição.
3. Revise e refine a solicitação gerada para corresponder aos seus requisitos específicos.

Dica:

Comece com a solicitação gerada do Autopilot e, em seguida, itere com base em testes. O Chat de Debug ajuda você a identificar lacunas em sua solicitação que precisam ser resolvidas.

Uso da pontuação do agente

A pontuação do agente analisa a configuração do seu agente e fornece recomendações para melhoria. A pontuação avalia:

• Qualidade da solicitação do sistema: clareza, integridade, consistência, sequência de raciocínio e demonstrações.
• Configuração da ferramenta: quantidade, clareza de contexto e integridade.

Para visualizar a pontuação do seu agente:

1. No designer do agente, procure o indicador Abrir pontuação de integridade.
2. Selecione-o para ver recomendações detalhadas.
3. Aborde as sugestões para melhorar a eficácia do seu agente.

Para obter detalhes, consulte Pontuação do agente.

Seleção de modelo

Os agentes de conversa são compatíveis com diversos grandes modelos de linguagem (LLMs). Selecione um modelo com base em seus requisitos de capacidade, latência e custo.

Para orientação sobre a escolha do modelo certo, consulte Escolha do melhor modelo para seu agente.

Observação:

Agentes de conversa estão disponíveis com modelos gerenciados pela UiPath e são compatíveis com Configurações de LLM para que você possa usar suas próprias assinaturas de LLM.

Entradas

Entradas são variáveis nomeadas definidas em um agente conversacional no Gerenciador de dados e podem ser modeladas na solicitação do sistema e nos argumentos de chamadas de ferramentas. Use entradas quando a superfície de chamada quiser passar contexto adicional para o agente a cada turno — além do que já está no histórico de conversas.

Importante:

O sistema já passa implicitamente o histórico de conversas (mensagens do usuário, mensagens do agente e resultados anteriores de chamadas de ferramentas) para o agente na execução de cada turno. Defina Entradas apenas para contexto adicional que o agente não possa obter da própria conversa. Comece sem entradas personalizadas e apresente-as quando seu caso de uso específico exigi-las.

Como as superfícies expõem entradas

A superfície de conversa pode definir valores de entrada iniciais quando inicia a conversa e também pode atualizá-los a qualquer momento durante a conversa.

• Superfícies pré-criadas, como o Gerenciamento de instâncias e a incorporação de iFrame, fornecem um formulário em que o usuário preenche os valores de entrada antes ou durante a conversa.
• O UiPath TypeScript SDK oferece controle direto sobre como os valores de entrada são definidos em sua superfície personalizada. Por exemplo, você pode conectar entradas ao estado de interface gráfica na web — ou qualquer outro estado do lado do cliente — para que o agente receba o contexto de superfície mais recente automaticamente a cada vez.

Ferramentas

As ferramentas estendem os recursos do seu agente além da conversa. Os agentes de conversa são compatíveis com as mesmas ferramentas que agentes autônomos.

Tipos de ferramentas compatíveis

Tipo de ferramenta	Description	Use case
Embasamento de contexto	Pesquisar índices de base de conhecimento	Perguntas e respostas baseadas em RAG sobre documentos
Analisar arquivos.	Processar arquivos carregados com LLM	Análise de Documento, extração de formulários
Atividades do Integration Service	Conectores configurados para sistemas externos	Calendário, e-mail, operações de CRM
Fluxos de trabalho da API	Automações baseadas em API personalizadas	Integrações de backend
Fluxos de trabalho de RPA	Automações multiplataforma e baseadas no Windows	Interações com o sistema legado
Agents autônomos	Execução do agente aninhado	Tarefas complexas e de várias etapas
Servidores MCP	Integrações de protocolo de contexto de modelo	Ecossistemas de ferramentas externas
Ferramentas do lado do cliente	Ferramentas executadas na superfície do cliente	Acessando dados do aplicativo host, disparando ações de interface do usuário
Modelos de Extração e Processamento Inteligente (IXP)	Processamento inteligente de documentos	Extração de documentos estruturados

Adição de ferramentas

1. No designer de agentes, selecione Adicionar ferramenta.
2. Escolha o tipo de ferramenta e configure seus parâmetros.
3. Forneça uma descrição clara de quando e como o agente deve usar a ferramenta.

Para fluxos de trabalho que realizam chamadas de API exclusivamente, use fluxos de trabalho de API em vez de fluxos de trabalho de RPA para um melhor desempenho em cenários de chat em tempo real.

Dica:

Se suas ferramentas usarem conectores do Integration Service, você pode permitir que os usuários escolham suas próprias conexões no runtime por meio de conexões pessoais. Isso é útil quando o agente precisa agir com as próprias credenciais do usuário, como enviar e-mails de sua conta ou acessar seu calendário pessoal.

Descrições das ferramentas

As descrições de ferramentas orientam o agente sobre quando usar cada ferramenta. Escreva descrições que expliquem claramente:

• O que a ferramenta faz
• Quando usá-la (opcional)

Exemplo de descrição de ferramenta

Search HR Policies: Use this tool to find information about company policies,
benefits, and HR procedures. Always use this tool before answering questions
about policies.

Proteções de ferramentas

Aplique proteções a ferramentas para aplicar políticas de runtime.As proteções podem:

• Restringir quando uma ferramenta pode ser executada.
• Valide entradas antes da execução.
• Filtrar ou transformar saídas.

Para obter detalhes, consulte Proteções.

Confirmações de chamadas de ferramentas

Use confirmações de chamadas de ferramentas para ferramentas que não devem ser executadas até que o usuário revise a ação proposta. Por exemplo, exija confirmação antes de uma ferramenta criar um evento, enviar um e-mail, atualizar um registro de negócios ou disparar uma automação com efeitos colaterais externos.

Para exigir confirmação para uma ferramenta:

1. No designer de agente, selecione a ferramenta que você deseja configurar.
2. Nas configurações de proteções da ferramenta, habilite Exigir confirmação.
3. Salve e publique o agente.

Quando uma ferramenta requer confirmação, o agente pausa antes de executar a ferramenta e mostra ao usuário os parâmetros de entrada que ele planeja usar. Você pode aprovar a chamada de ferramenta, modificar os valores de entrada antes da aprovação ou rejeitar a chamada de ferramenta.

No runtime:

• Se o usuário aprovar sem alterações, a ferramenta é executada com as entradas originais propostas pelo agente.
• Se o usuário modificar as entradas e aprovar, a ferramenta é executada com as entradas modificadas.
• Se o usuário rejeitar a confirmação, a ferramenta não será executada.

Observação:

Você configura as confirmações de chamadas de ferramentas por ferramenta. Habilite-as para ações em que seja necessária a revisão do usuário antes da execução, e deixe-as desabilitadas para ferramentas SomenteLeitura ou ferramentas que sejam seguras para execução automárica.

Context

O contexto conecta seu agente aos índices da base de conhecimento de contextualização, permitindo a geração aumentada por recuperação (RAG) para respostas precisas e baseadas em citações.

Adição de contexto

1. Selecionar Adicionar contexto.
2. Escolha um índice de contextualização entre seus índices disponíveis.
3. Configure parâmetros de pesquisa (opcional).

O agente consulta automaticamente o índice quando relevante para a pergunta do usuário e inclui citações em suas respostas.

Para obter detalhes sobre a criação e o gerenciamento de índices, consulte Contextos.

Tratamento de arquivos

Agentes de conversa podem processar arquivos carregados durante o chat. Isso permite casos de uso como análise de documentos, processamento de formulários e interpretação de imagens.

Habilitação de uploads de arquivos

Para habilitar a análise de arquivos, adicione uma ferramenta capaz de processar arquivos:

• Analisar arquivos: ferramenta integrada para análise de arquivos em geral usando LLMs.
• Modelos de Extração e Processamento Inteligente (IXP): para extração de documentos estruturados.

Tipos de arquivos compatíveis

Tipo de arquivo	Ferramenta recomendada
Imagens (GIF, JPE, JPEG, PNG, WEBP)	Analisar arquivos.
Documentos em PDF	Analisar arquivos, Extração e Processamento Inteligente (IXP)

Importante:

Os uploads de arquivos são limitados a 5 MB.

Escalonamentos

Os escalonamentos permitem que o agente entregue conversas a um humano quando não puder resolver uma solicitação de forma confiável.

Como os escalonamentos funcionam

1. O agente determina que precisa de assistência humana (com base em critérios de solicitação do seu sistema).
2. O agente cria uma tarefa de escalonamento no Action Center.
3. A conversa é pausada até que um humano resolva o escalonamento.
4. Uma vez resolvido, o agente continua com a entrada do humano.

Configuração de escalonamentos

1. No designer de agente, selecione Adicionar escalonamento.
2. Configure o tipo de escalonamento.
3. Lembre-se de definir critérios de escalonamento em sua solicitação do sistema.

Observação:

As conversas são executadas de forma síncrona durante o escalonamento. O agente pausa toda a interação até que o escalonamento seja resolvido. Se você precisar iniciar escalonamentos sem bloquear o chat, crie seu assistente de chat no Maestro Flow e execute um nó humano em uma ramificação paralela, para que a conversa continue enquanto a aprovação acontece em segundo plano.

Para obter detalhes, consulte Escalonamentos e Memória do agente.

Considerações de conexão

Quando seu agente usar ferramentas que dependem de conectores do Integration Service, considere como as conexões são gerenciadas no runtime.

• As conexões compartilhadas são configuradas por administradores em uma pasta do Orchestrator. Conexões compartilhadas, configuradas durante o design e a depuração, garantem que o agente tenha acesso aos conectores necessários após a publicação.
• Conexões pessoais (Prévia pública) permitem que usuários individuais escolha suas próprias conexões do Integration Service no runtime. Isso é útil quando o agente precisa agir com as próprias credenciais de um usuário — por exemplo, para enviar e-mails da sua conta ou acessar seu calendário pessoal.

Ao projetar um agente que seja compatível com conexões pessoais, tenha em mente o seguinte:

• Para habilitar conexões pessoais para usuários, cada ferramenta de agente deve ser configurada seguindo as instruções de configuração de conexões pessoais.
• As ferramentas do agente devem usar conectores que são compatíveis com conexões pessoais (por exemplo, Outlook, Slack, Salesforce).
• O agente configura automaticamente as conexões do espaço de trabalho pessoal do usuário quando uma conexão correspondente está disponível, tornando a configuração perfeita para a maioria dos usuários.
• Se a conexão configurada automaticamente falhar ou nenhuma conexão correspondente for encontrada, o usuário será solicitado a selecionar ou criar uma nova.
• Se nenhuma conexão pessoal for configurada para um conector, o agente retornará à conexão compartilhada na pasta do Orchestrator.
• Ao usar aplicativos externos, apenas conexões do espaço de trabalho pessoal do usuário estão disponíveis. As conexões de pasta compartilhada não são exibidas.

Para obter detalhes sobre como os usuários configuram conexões pessoais no runtime, consulte Conexões pessoais.

Melhores práticas de projeto

Comece com uma persona clara

Defina uma identidade específica para seu agente em vez de deixá-la genérica. Uma persona clara ajuda o agente a manter um tom e um comportamento consistentes.

Menos eficaz: "Você é um Assistant útil."Mais eficaz: "Você é um Assistant de RH amigável para a Contoso Corporation especializado em ajudar os funcionários a compreender as políticas e benefícios da empresa."

Design para imprevisibilidade

Os usuários podem fornecer informações incompletas, ambíguas ou incorretas. Sua solicitação do sistema deve instruir o agente a:

• Faça perguntas de esclarecimento quando necessário.
• Lide com informações parciais corretamente.
• Recupere-se de mal-entendidos.

Oriente o uso da ferramenta de forma explícita

Não suponha que o agente saiba quando usar ferramentas. Inclua instruções explícitas:

## Tool usage
- ALWAYS search the knowledge base before answering policy questions
- Use the calendar tool when the user asks about scheduling
- NEVER create calendar events without explicit user confirmation

Itere com avaliações

Crie casos de teste para cenários esperados (caminho feliz) e inesperados (caso extremo). Atualize a configuração do seu agente com base nos resultados das avaliações.

Próximas Etapas

• Avaliação: teste o comportamento do seu agente
• Implantação: publique e implante seu agente

Precisa de uma modelagem de conversas mais avançada — roteamento, transferência entre agentes especializados ou automações de back-end executadas em paralelo com a conversa? Consulte Build in Maestro Flow para modelar o chat inteiro como um Maestro Flow de conversação.