Projeto de agentes de conversa

Esta página abrange as opções de configuração em tempo de design 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 Enterprise.

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 para gerar uma configuração de início ou selecione Iniciar do zero.

Prompt do Sistema

O prompt do sistema é a base do comportamento do seu agente. Ele define o perfil, os objetivos, as restrições e as instruções do agente para lidar com diferentes cenários.

O que incluir

Um prompt abrangente do sistema deve abordar:

• Identidade e persona: quem é o agente? Que tom ele deve usar?
• Escopo e limites: quais tópicos o agente deve abordar? O que ele deve recusar?
• Diretrizes de uso de ferramentas: quando o agente deve usar ferramentas específicas?
• Critérios de escalonamento: quando o agente deve passar para um humano?
• Formato da resposta: como o agente deve estruturar as respostas?

Exemplo de prompt do sistema

You are an HR assistant for Contoso Corporation. Your role is to help employees with questions about company policies, benefits, and HR procedures.

## Guidelines
- Be professional, friendly, and concise
- Always search the knowledge base before answering policy questions
- Cite specific documents when referencing policies
- If you cannot find an answer, offer to escalate to an HR representative

## Boundaries
- Do not discuss individual employee performance or compensation
- Do not make promises about policy exceptions
- Redirect legal questions to the legal department

Uso do Autopilot para gerar prompts

O Autopilot pode ajudar você a criar prompts de sistema eficazes:

1. Na seção Prompt do sistema, descreva seu caso de uso em linguagem natural.
2. O Autopilot gera um prompt estruturado com base na sua descrição.
3. Revise e refine o prompt gerado para corresponder aos seus requisitos específicos.

Dica:

Comece com o prompt gerado do Autopilot e, em seguida, itere com base nos testes. O chat de Debug ajuda você a identificar lacunas em seu prompt que precisam ser resolvidas.

Usando a pontuação do Agente

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

• Qualidade do prompt 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 exibir a pontuação do seu agente:

1. No designer do agente, pesquise 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 a Pontuação do agente.

Seleção de modelo

Os agentes de conversa são compatíveis com vários Modelos de Linguagem Abrangente (LLMs). Selecione um modelo com base em seus requisitos de capacidade, latência e custo.

Para obter orientação sobre como escolher o modelo certo, consulte Como escolher o melhor modelo para seu agente.

Observação:

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

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 os agentes autônomos.

Tipos de ferramenta compatíveis

Tool type	Description	Use case
Embasamento de contexto	Pesquisar índices da base de conhecimento	Perguntas e respostas baseadas em RAG em documentos
Analisar arquivos.	Processar arquivos carregados com LLM	Análise de documentos, extração de formulários
Atividades do Integration Service	Conectores pré-construídos para sistemas externos	Calendário, email, operações de CRM
Fluxos de trabalho da API	Automações personalizadas baseadas em API	Integrações de back-end
Fluxos de trabalho de RPA	Automações multiplataforma e baseadas em janela	Interações com sistemas legados
Agentes autônomos	Execução de agente aninhada	Tarefas complexas em várias etapas
Servidores MCP	Integrações de protocolo de contexto do modelo	Ecossistemas de ferramenta externa
Modelos do IXP	Processamento inteligente de documentos	Extração de Documentos Estruturados

Adição de ferramentas

1. No designer do agente, 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 executam exclusivamente chamadas de API, use fluxos de trabalho de API em vez de fluxos de trabalho de RPA para obter um melhor desempenho em cenários de chat em tempo real.

Descrições de ferramentas

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

• O que a ferramenta faz
• Quando usá-lo (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 da ferramenta

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

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

Para obter detalhes, consulte Proteções.

Context

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

Adicionando um contexto

1. Selecionar Adicionar contexto.
2. Escolha um índice de Contextualização entre os índices disponíveis.
3. Configure os 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 como criar e gerenciar índices, consulte Contextos.

Manuseio de arquivo

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

Habilitando uploads de arquivos

Para habilitar a análise de arquivos, adicione uma ferramenta capaz de processá-los:

• Analisar arquivos: ferramenta integrada para análise geral de arquivos usando LLMs.
• Modelos 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, IXP

Importante:

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

Escalonamentos

Os escalonamentos permitem que o agente passe conversas para um humano quando não é possível resolver uma solicitação com confiança.

Como os escalonamentos funcionam

1. O agente determina que precisa de assistência humana (com base nos critérios de prompt 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. Após resolvido, o agente continua com a entrada do humano.

Configuração de escalonamentos

1. No designer do agente, selecione Adicionar escalonamento.
2. Configure o tipo de escalonamento.
3. Lembre-se de definir os critérios de escalonamento no prompt do seu 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 o tom e o comportamento consistentes.

Menos eficaz: "Você é um assistente útil." Mais eficaz: "Você é um assistente de RH amigável para a Contoso Enterprise que se especializa em ajudar os funcionários a entender as políticas e benefícios da empresa."

Projete para a imprevisibilidade

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

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

Guiar o uso da ferramenta explicitamente

Não suponha que o agente saiba quando usar as 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

Iterar com avaliações

Crie casos de teste para cenários esperados ( Assistente ) e inesperado (edge Case). Atualize a configuração do seu agente com base nos resultados da avaliação.

Próximas Etapas

• Avaliação: teste o comportamento de seu agente
• Implantação: publicar e implantar seu agente
• Melhores práticas para criar agentes: orientação adicional de design