Introdução

Build your first conversational agent in Studio Web's Agent Builder, from initial configuration to a working HR assistant with document search.

This guide walks you through building your first conversational agent in Agent Builder: a simple HR assistant that answers questions about company policies using document search.

Pré-requisitos

Antes de começar, certifique-se de ter:

• Acesso ao Studio Web
• Uma pasta do Orchestrator com:
  • Um Unattended Robot atribuído
• Um índice de contextualização com os documentos da sua base de conhecimentos

Dica:

Se você ainda não tiver um índice de contextualização, você ainda pode concluir este tutorial.Seu agente responderá com base no conhecimento geral dele.

Etapa 1: criar o agente

1. Acesse studio.uipath.com.
2. Selecione Criar novo e, em seguida, selecione Agente.
3. Selecione Conversacional.

1. Descreva seu agente para o Autopilot para gerar uma configuração inicial. Por exemplo: "um assistente de RH que ajuda os funcionários a localizar informações sobre políticas, benefícios e procedimentos de integração da empresa".Se você preferir não usar o Autopilot, selecionar Iniciar do zero.

Etapa 2: configurar a solicitação do sistema

A solicitação do sistema define a persona e o comportamento do seu agente. Uma solicitação bem elaborada ajuda o agente a responder de forma consistente e apropriada.

1. Na seção Solicitação do sistema, defina a identidade e as diretrizes do seu agente. Por exemplo:

You are a friendly HR assistant for Contoso Corporation. Your role is to help employees find information about company policies, benefits, and HR procedures.

Guidelines:
- Always be professional and helpful
- If you don't know the answer, say so
- When citing policies, reference the specific document name
- Keep responses concise but complete

2. Selecione o Modelo para seu agente. Diferentes modelos oferecem vários recursos e características de desempenho.

Etapa 3: adicionar ferramentas

As ferramentas dão ao seu agente a capacidade de realizar ações e recuperar informações. Para este assistente de RH, adicione o índice de contextualização que você configurou anteriormente como uma ferramenta de contexto.

1. Selecionar Adicionar contexto.
2. Selecione seu índice de documentos de RH.
3. Forneça uma descrição. Por exemplo:

Provides information about company policies, benefits, and HR procedures.

4. (Opcional) Adicione ferramentas adicionais, como:
   • Analisar arquivos: permita que os usuários carreguem documentos para análise.
   • Conectores do Integration Service: conecte-se a sistemas externos como calendário ou e-mail.

Para obter opções detalhadas de configuração de ferramentas, consulte a seção Design.

Etapa 4: teste no chat do Debug

Antes de publicar, teste seu agente para certificar-se de que ele se comporta conforme o esperado.

1. Selecione Debug e depois Salvar e Debug para abrir a interface de chat.
2. Envie uma mensagem de teste, como: "Quantos feriados temos nos EUA?".
3. Revise a resposta do agente e consulte as citações (se estiver usando a contextualização).
4. Visualize o trace na aba Histórico para ver:
   • Chamadas e respostas do LLM
   • Chamadas de ferramenta com argumentos e saídas

1. Se a resposta for boa, selecione Adicionar a conjunto de avaliações para salvar essa conversa para testes futuros.

Etapa 5: publicar e implantar

Quando estiver satisfeito com o comportamento do seu agente, publique-o para torná-lo disponível para os usuários.

1. Selecione Parar na barra de ferramentas superior para interromper a execução da depuração.
2. Renomeie sua solução e seu agente no Explorer para "Assistente de RH".
3. Selecione Publicar na barra de ferramentas superior.
4. Escolha "Tenant do Orchestrator" como o Local.
5. Selecione Publicar.

O processo de publicação começará e você receberá uma mensagem quando o pacote estiver pronto para ser implantado.

1. Selecione Verificar pacote na mensagem.
2. Selecione Implantar pacote (ícone de foguete no extremo direito).
3. Escolha a pasta de destino do Orchestrator (deve ter a conta do Unattended Robot atribuída).
4. Selecione Ativar imediatamente.
5. Selecione Implantar.

Seu agente agora é publicado e implantado e disponível por meio do Gerenciamento de instâncias.

Etapa 6: acessar seu agente

Once published, your agent surfaces to users through any of the supported chat channels — Instance Management, Assistant, Microsoft Teams, Slack, iFrame embeds, and more, including custom chat UIs with the UiPath TypeScript SDK. See Deployment for the full channel list, feature availability per channel, and configuration steps.

Você criou e implantou seu primeiro agente de conversa. Para saber mais:

• Designing the agent — configuring the prompt, tools, context, file handling, and per-user connections.
• Evaluating the agent — create comprehensive test suites for your agent.
• Observability — monitor performance, usage metrics, and collect user feedback.
• Licensing — understand consumption and pricing for your deployment.

Need more advanced conversation modeling — routing, hand-off between specialist agents, or backend automations running in parallel with the conversation? See Build in Maestro Flow to model the whole chat as a conversational Flow.