Projeto de agentes de conversa

Configure o comportamento, os recursos e as integrações de sistemas empresariais para um agente de conversa no Studio Web.

Esta página abrange as opções de configuração em tempo de projeto para agentes de conversa no 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

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

As entradas são variáveis nomeadas definidas em um agente de conversa no Data Manager e podem ser modeladas na solicitação do sistema e em argumentos de chamada de ferramenta. Use entradas quando a superfície de chamada quiser passar contexto adicional para o agente em cada vez — além do que já está carregado no histórico de conversas.

Importante:

O histórico de conversas (mensagens do usuário, mensagens do agente e resultados anteriores de chamadas de ferramenta) já é passado implicitamente para o agente na execução de cada vez. As entradas devem ser definidas apenas para um contexto adicional que o agente não pode derivar da própria conversa. Comece sem entradas personalizadas e introduza-as quando seu caso de uso específico exigir.

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 Gerenciamento de instâncias e 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 dá a você controle direto sobre como os valores de entrada são definidos em sua superfície personalizada. Por exemplo, você pode conectar entradas ao estado da interface gráfica da Web — ou qualquer outro estado do lado do cliente — para que o agente receba o contexto de superfície mais recente automaticamente em cada etapa.

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
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.

Dica:

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.

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 que uma ferramenta crie um evento, envie um e-mail, atualize um registro de negócios ou dispare uma automação com efeitos colaterais externos.

Para exigir confirmação para uma ferramenta:

1. No designer de agentes, selecione a ferramenta que deseja configurar.
2. Nas configurações de proteções de ferramentas, 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. O usuário 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 será executada com as entradas originais propostas pelo agente.
• Se o usuário modificar as entradas e aprovar, a ferramenta será executada com as entradas modificadas.
• Se o usuário rejeitar a confirmação, a ferramenta não será executada.

Observação:

As confirmações de chamada de ferramenta são configuradas por ferramenta. Habilite-as para ações em que a revisão do usuário seja necessária antes da execução e deixe-as desabilitadas para ferramentas somente leitura ou ferramentas que sejam seguras para serem executadas automaticamente.

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.

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

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
• Melhores práticas para criar agentes: orientações de design adicionais