- Introdução
- Agentes da UiPath no Studio Web
- Sobre os agentes da UiPath
- Licenciamento
- Prompts
- Trabalhando com arquivos
- Contexto
- Escalonamentos e memória do agente
- Avaliações
- Traços de agente
- Pontuação do agente
- Gerenciamento de agentes UiPath
- Agentes codificados da UiPath

Guia do Usuário de Agentes
Introdução aos agentes de conversação
Este guia orienta você na criação do seu primeiro agente de conversa: um assistente de RH simples que responde a perguntas sobre políticas da empresa usando pesquisa de documentos.
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
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
- Acesse studio.uipath.com.
- Selecione Criar novo e, em seguida, selecione Agente.
- Selecione Conversacional.

- 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.
- 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
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
- 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.
- Selecionar Adicionar contexto.
- Selecione seu índice de documentos de RH.
- Forneça uma descrição. Por exemplo:
Provides information about company policies, benefits, and HR procedures.
Provides information about company policies, benefits, and HR procedures.
- (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.
- Selecione Debug e depois Salvar e Debug para abrir a interface de chat.
- Envie uma mensagem de teste, como: "Quantos feriados temos nos EUA?".
- Revise a resposta do agente e consulte as citações (se estiver usando a contextualização).
- Visualize o trace na aba Histórico para ver:
- Chamadas e respostas do LLM
- Chamadas de ferramenta com argumentos e saídas

- 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.
- Selecione Parar na barra de ferramentas superior para interromper a execução da depuração.
- Renomeie sua solução e seu agente no Explorer para "Assistente de RH".
- Selecione Publicar na barra de ferramentas superior.
- Escolha "Tenant do Orchestrator" como o Local.
- Selecione Publicar.

O processo de publicação começará e você receberá uma mensagem quando o pacote estiver pronto para ser implantado.
- Selecione Verificar pacote na mensagem.
- Selecione Implantar pacote (ícone de foguete no extremo direito).
- Escolha a pasta de destino do Orchestrator (deve ter a conta do Unattended Robot atribuída).
- Selecione Ativar imediatamente.
- Selecione Implantar.
Seu agente agora é publicado e implantado e disponível por meio do Gerenciamento de instâncias.
Etapa 6: acessar seu agente
Após a publicação, você pode interagir com seu agente de várias maneiras:
- Gerenciamento de instâncias: acesse Agentes > Agentes implantados no Automation Cloud e selecione Chat em seu Agente de conversa.
- Autopilot for Everyone: acesse seu agente no menu suspenso do seletor Autopilot.
- Teams ou Slack: se configurado, interaja com seu agente por meio do plug-in do Autopilot.

Você criou e implantou seu primeiro agente de conversa. Para saber mais:
- Design: configure opções avançadas como escalonamentos, memória do agente e seleção de modelos
- Avaliação: crie conjuntos de testes abrangentes para seu agente
- Observabilidade: monitore o desempenho e colete feedback do usuário
- Licenciamento: entenda o consumo e os preços para sua implantação