Projeto de agentes de conversa

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

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

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.

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