Pular para o conteúdo principal

​
Criando e Editando Agentes

Os Agentes são assistentes de IA personalizados que podem conversar com usuários, executar tarefas e automatizar processos. Este guia mostra como criar e editar agentes no Aurora AI.

Agente Básico

Agente conversacional padrão com personalidade e conhecimento configuráveis

Agente Workflow

Agente integrado com workflows para automações complexas

​
Visão Geral

Um agente no Aurora AI é composto por várias seções configuráveis:
  • Informações Básicas: Nome, descrição e status
  • Personalidade: Tom de voz, estilo e comportamento
  • Conhecimento: Documentos e coleções RAG
  • Canais: Onde o agente estará disponível
  • Ferramentas: Integrações e capacidades adicionais

​
Criando um Novo Agente

1

Acessar o Builder de Agentes

No menu lateral, clique em Builder e selecione Agentes. Você verá a lista de agentes existentes.
2

Escolher o Tipo de Agente

Clique em Criar Novo Agente e escolha o tipo:
  • Agente Básico: Para conversas e interações diretas
  • Agente Workflow: Para integração com workflows automatizados
3

Preencher Informações Básicas

No diálogo de criação, preencha:
  • Nome: Um nome descritivo para seu agente (ex: “Assistente de Suporte”)
  • Descrição: Explique o propósito do agente (opcional)
Clique em Criar para continuar.
4

Ser Redirecionado para Edição

Após criar, você será redirecionado automaticamente para a página de edição do agente, onde poderá configurar todas as opções.

​
Editando um Agente Existente

Para editar um agente existente:
1

Localizar o Agente

Na lista de agentes, encontre o agente que deseja editar. Use a busca ou filtros se necessário.
2

Abrir o Agente

Clique no card do agente ou no nome para abrir a página de detalhes.
3

Navegar para Edição

Na página de detalhes, você verá várias abas. A aba Básico contém as configurações principais do agente.

​
Seções de Configuração

A página de edição do agente está organizada em seções. Vamos explorar cada uma:

​
1. Informações Básicas

Campos Básicos

Configure as informações fundamentais do agente.
Campos disponíveis:
  • Nome: Nome do agente (obrigatório)
  • Descrição: Descrição do propósito e função do agente
  • Status: Escolha entre:
    • Rascunho: Agente não está publicado
    • Publicado: Agente está ativo e disponível
Apenas agentes com status “Publicado” estarão disponíveis nos canais configurados.

​
2. Personalidade (Persona)

Configurar Personalidade

Defina como o agente se comporta e responde aos usuários.
A seção de personalidade permite configurar:
Escolha o estilo de comunicação:
  • Formal: Linguagem profissional e respeitosa
  • Casual: Conversação descontraída e amigável
  • Técnico: Foco em precisão e detalhes técnicos
  • Criativo: Linguagem expressiva e envolvente
Você também pode escrever instruções customizadas para definir um tom específico.
Configure como o agente estrutura suas respostas:
  • Direto: Respostas curtas e objetivas
  • Detalhado: Explicações completas e contextuais
  • Conversacional: Diálogo natural e interativo
  • Estruturado: Informações organizadas em listas e seções
Defina regras de comportamento:
  • Empatia: Nível de compreensão emocional
  • Assertividade: Capacidade de tomar decisões
  • Criatividade: Uso de soluções inovadoras
  • Precisão: Foco em exatidão e fatos
A personalidade é fundamental para criar uma experiência consistente. Teste diferentes configurações no playground antes de publicar.

​
3. Placeholder de Input

Placeholder de Input

Configure o texto que aparece no campo de entrada antes do usuário digitar.
Este campo define o texto de exemplo que aparece no campo de chat antes do usuário começar a digitar. Exemplos:
  • “Digite sua pergunta aqui…”
  • “Como posso ajudar você hoje?”
  • “Pergunte qualquer coisa sobre nosso produto”

​
4. Iniciadores de Conversa

Iniciadores de Conversa

Adicione perguntas pré-definidas que os usuários podem clicar para começar.
Os iniciadores de conversa são perguntas ou frases que aparecem como botões no início da conversa, facilitando o início da interação.
1

Adicionar Iniciador

Clique no botão Adicionar Iniciador ou + na seção de iniciadores.
2

Escrever o Texto

Digite a pergunta ou frase que aparecerá como botão (ex: “Como funciona o produto?”).
3

Escolher Ícone (Opcional)

Selecione um ícone para o iniciador para torná-lo mais visualmente atraente.
4

Salvar

O iniciador será salvo automaticamente e aparecerá na interface do chat.
Limite de iniciadores: Recomendamos no máximo 4-6 iniciadores para não sobrecarregar a interface.

​
5. Base de Conhecimento

Base de Conhecimento

Conecte documentos e coleções RAG para enriquecer o conhecimento do agente.
A base de conhecimento permite que o agente acesse informações específicas dos seus documentos através do sistema RAG (Retrieval Augmented Generation).
1

Visualizar Documentos Conectados

Na seção “Base de Conhecimento”, você verá uma lista de documentos e coleções já conectados ao agente.
2

Adicionar Documentos

Clique em Adicionar Documento ou Gerenciar Documentos para abrir o diálogo de seleção.
3

Selecionar Documentos ou Coleções

Escolha entre:
  • Documentos individuais: Selecione documentos específicos
  • Coleções: Selecione coleções inteiras de documentos
Use a busca para encontrar documentos rapidamente.
4

Confirmar Seleção

Clique em Adicionar ou Salvar para conectar os documentos ao agente.
Documentos conectados são processados automaticamente e indexados para busca. Quanto mais específico e relevante o conteúdo, melhor o desempenho do agente.

​
6. Ferramentas (Tools)

Ferramentas e Integrações

Adicione ferramentas e integrações que o agente pode usar durante as conversas.
As ferramentas expandem as capacidades do agente, permitindo que ele execute ações além de apenas conversar.
  • APIs: Integrações com serviços externos
  • Webhooks: Chamadas HTTP para sistemas externos
  • Bancos de Dados: Consultas a bases de dados
  • Ferramentas Customizadas: Ferramentas desenvolvidas especificamente para seu caso de uso
1

Abrir Gerenciador de Ferramentas

Clique em Gerenciar Ferramentas ou Adicionar Ferramenta na seção Tools.
2

Selecionar Tipo

Escolha o tipo de ferramenta que deseja adicionar.
3

Configurar

Preencha os parâmetros necessários:
  • Nome da ferramenta
  • Endpoint ou configuração
  • Parâmetros de autenticação (se necessário)
  • Descrição do que a ferramenta faz
4

Testar

Use o botão de teste para verificar se a ferramenta está funcionando corretamente.
5

Salvar

Salve a ferramenta e ela estará disponível para o agente usar.

​
7. Configurações Gerais

Configurações Gerais

Ajuste configurações avançadas do agente.
Escolha qual modelo de IA o agente usará:
  • Gemini: Modelo padrão do Google
  • Outros modelos: Conforme disponibilidade
Cada modelo tem características diferentes de custo, velocidade e capacidade.
Ajuste a criatividade das respostas:
  • Baixa (0.1-0.3): Respostas mais determinísticas e consistentes
  • Média (0.5-0.7): Balance entre consistência e criatividade
  • Alta (0.8-1.0): Respostas mais criativas e variadas
Defina o tamanho máximo das respostas:
  • Respostas curtas: 500-1000 tokens
  • Respostas médias: 1000-2000 tokens
  • Respostas longas: 2000+ tokens

​
8. Acesso e Segurança

Acesso e Segurança

Configure quem pode acessar e usar o agente.
1

Configurar Visibilidade

Escolha quem pode ver e usar o agente:
  • Público: Todos os membros da organização
  • Equipe: Apenas membros de equipes específicas
  • Privado: Apenas você
2

Definir Permissões

Configure permissões de uso:
  • Quem pode conversar com o agente
  • Quem pode editar o agente
  • Quem pode ver métricas e analytics
3

Configurar Autenticação

Se necessário, configure autenticação adicional para acesso ao agente.

​
Salvando Alterações

Salvar Alterações

Todas as alterações são salvas automaticamente enquanto você edita.
O Aurora AI salva automaticamente suas alterações enquanto você trabalha. Você verá um indicador de status no canto superior direito mostrando:
  • Salvando…: Quando há alterações sendo salvas
  • Salvo: Quando todas as alterações foram salvas com sucesso
  • Erro: Se houver algum problema ao salvar
Certifique-se de ter conexão com a internet para que as alterações sejam salvas corretamente.

​
Testando o Agente

Antes de publicar, é essencial testar o agente:
1

Acessar o Playground

Na página de edição do agente, encontre a aba Playground ou Testar.
2

Fazer Perguntas de Teste

Digite perguntas típicas que os usuários fariam:
  • Perguntas sobre o conhecimento conectado
  • Solicitações que usam ferramentas
  • Cenários de uso comum
3

Avaliar Respostas

Verifique se as respostas são:
  • Precisas e relevantes
  • No tom de voz correto
  • Completas e úteis
4

Ajustar Configurações

Com base nos testes, ajuste:
  • Personalidade
  • Base de conhecimento
  • Configurações gerais

​
Publicando o Agente

Quando estiver satisfeito com a configuração:
1

Revisar Todas as Configurações

Navegue por todas as seções e verifique se está tudo configurado corretamente.
2

Alterar Status para Publicado

Na seção de Informações Básicas, altere o status de Rascunho para Publicado.
3

Salvar Alterações

Clique em Salvar alterações se ainda não salvou automaticamente.
4

Verificar Disponibilidade

O agente estará disponível nos canais configurados imediatamente após a publicação.

​
Referência Completa de Campos

Para documentação detalhada de cada campo e todas as opções disponíveis, consulte:

Referência Completa de Campos

Documentação completa de todos os campos, opções e configurações disponíveis na edição de agentes.

​
Próximos Passos

Agora que você criou seu agente, explore estas funcionalidades:

Referência de Campos

Veja documentação completa de todos os campos

Configurar Canais

Configure onde seu agente estará disponível

Ver Analytics

Monitore performance e métricas do agente

Gerenciar Conversas

Veja e gerencie conversas do agente

Adicionar Conhecimento

Enriqueça a base de conhecimento do agente

Personalizar Personalidade

Ajuste o tom e estilo do agente

Testar Agente

Use o playground para testar o agente

​
Dicas e Boas Práticas

Comece simples: Crie um agente básico primeiro e adicione complexidade gradualmente conforme você aprende o que funciona melhor.
Teste frequentemente: Use o playground regularmente durante o desenvolvimento para identificar problemas cedo.
Documentos específicos: Quanto mais específico e relevante o conhecimento conectado, melhor o desempenho do agente.
Itere e melhore: Monitore métricas e feedback dos usuários para continuamente melhorar o agente.

​
Troubleshooting

Verifique:
  • Se a base de conhecimento está conectada corretamente
  • Se a personalidade está configurada adequadamente
  • Se há documentos relevantes na base de conhecimento
  • Se o modelo de IA escolhido é adequado
Verifique:
  • Sua conexão com a internet
  • Se há erros de validação nos campos
  • Se você tem permissões para editar o agente
  • Tente recarregar a página
Verifique:
  • Se o status está como “Publicado”
  • Se os canais estão configurados corretamente
  • Se você tem permissões para acessar os canais
  • Aguarde alguns minutos para propagação