- 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 de seu primeiro agente de conversa: um assistente de RH simples que responde a perguntas sobre as políticas da empresa usando a 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 seus documentos da base de conhecimento
Se você ainda não tiver um índice de embasamento de contexto, ainda poderá concluir este tutorial. Seu agente responderá com base em seu conhecimento geral.
Etapa 1: criar o agente
- Acesse studio.uipath.com.
- Selecione Criar novo e, em seguida, selecione Agente.
- Selecione Conversation.

- Descreva seu agente para o Autopilot para gerar uma configuração inicial. Por exemplo: "Um assistente de RH que ajuda os funcionários a encontrar informações sobre as políticas, benefícios e procedimentos de integração da empresa." Se você preferir não usar o Autopilot, selecione Começar do zero.
Etapa 2: configurar o prompt do sistema
O prompt do sistema define o perfil e o comportamento do seu agente. Uma solicitação bem elaborada ajuda o agente a responder de forma consistente e adequada.
- 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 recursos e características de desempenho variáveis.

Etapa 3: Adicione 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: permite que os usuários carreguem documentos para análise.
- Conectores do Integration Service: conecte-se a sistemas externos, como calendário ou email.

Para obter opções detalhadas de configuração da ferramenta, consulte a seção Design .
Etapa 4: testar no chat de depuração
Antes de publicar, teste seu agente para verificar se ele se comporta conforme o esperado.
- Selecione Depurar e, em seguida, Salvar e depurar para abrir a interface do chat.
- Envie uma mensagem de teste, como: "Quantos feriados temos nos EUA?".
- Revise a resposta do agente e verifique as citações (se estiver usando a Contextualização).
- Visualize o rastreamento de execução na guia Histórico para ver:
- Chamadas e respostas de LLM
- Chamadas de ferramenta com argumentos e saídas

- Se a resposta for boa, selecione Adicionar ao conjunto de avaliação para salvar essa conversa para testes futuros.
Etapa 5: publicar e implantar
Depois de estar satisfeito com o comportamento do seu agente, publique-o para disponibilizá-lo para os usuários.
- Selecione Parar na barra de ferramentas superior para interromper a execução da depuração.
- Renomeie sua Solução e Agente no Explorer para "HR Assistant".
- 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 assim que o pacote estiver pronto para ser implantado.
- Selecione Verificar pacote na mensagem.
- Selecione Implantar pacote (ícone de cursor na extremidade direita).
- Escolha a pasta de destino do Orchestrator (deve ter uma conta de robô unattended atribuída).
- Selecione Ativar imediatamente.
- Selecione Implantar.
Seu agente agora está publicado, implantado e disponível por meio do Gerenciamento de instâncias.
Etapa 6: acesse 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 do 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: configurar opções avançadas, como escalonamentos, memória do agente e seleção de modelo
- 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