Referência Completa de Campos
Esta página documenta todos os campos disponíveis na edição de agentes, suas opções e como usá-los.Seção: Informações Básicas
Campos Básicos
Nome
Campo: Nome
Campo: Nome
Limite: Máximo 100 caracteres
Placeholder: “Nomeie seu Agente”Descrição: Nome identificador do agente. Este nome será usado para identificar o agente em toda a plataforma, incluindo listas, dashboards e relatórios.Exemplos:
- “Assistente de Suporte Técnico”
- “Agente de Vendas”
- “Consultor de Produto”
- Use nomes descritivos e específicos
- Evite nomes genéricos como “Agente 1”
- Considere incluir o propósito no nome
Descrição
Campo: Descrição
Campo: Descrição
Limite: Máximo 500 caracteres
Placeholder: “Adicione uma breve descrição sobre o que este Agente faz”Descrição:
Descrição breve sobre o propósito e funcionalidade do agente. Esta descrição ajuda a entender rapidamente o que o agente faz e quando usá-lo.Exemplos:
- “Assistente especializado em resolver problemas técnicos de software”
- “Agente de vendas focado em produtos empresariais”
- “Consultor que ajuda clientes a escolher o plano ideal”
- Seja específico sobre o propósito
- Mencione o público-alvo se relevante
- Mantenha conciso mas informativo
Provedor
Campo: Provedor
Campo: Provedor
Placeholder: “Selecione um provedor”Descrição:
Selecione o provedor de LLM (Large Language Model) que será usado pelo agente. O provedor determina quais modelos estão disponíveis.Opções disponíveis:
- Depende dos provedores configurados na sua organização
- Exemplos comuns: Google (Gemini), OpenAI, Anthropic
- Ao selecionar um provedor, a lista de modelos é atualizada
- Se você mudar o provedor, o modelo selecionado será resetado
- Você pode deixar sem selecionar para usar o padrão do sistema
- Escolha baseado em custo, velocidade e qualidade desejada
- Considere os limites do seu plano
Modelo
Campo: Modelo
Campo: Modelo
Placeholder: “Selecione um modelo” ou “Selecione um provedor primeiro”Descrição:
Selecione o modelo de LLM específico que será usado pelo agente. Os modelos disponíveis dependem do provedor selecionado.Comportamento:
- Só fica habilitado após selecionar um provedor
- Cada modelo tem características diferentes de:
- Capacidade de raciocínio
- Velocidade de resposta
- Custo por token
- Tamanho máximo de contexto
- Modelos mais recentes geralmente têm melhor performance
- Modelos maiores são mais caros mas mais capazes
- Considere o caso de uso ao escolher
Seção: Persona (Personalidade)
Configuração de Personalidade
Nome da Persona
Campo: Nome da Persona
Campo: Nome da Persona
Limite: Máximo 100 caracteres
Placeholder: “Nome da Persona”Descrição:
Nome da personalidade do agente. Define como o agente se apresenta aos usuários. Este nome pode ser diferente do nome do agente.Exemplos:
- “Aurora”
- “Assistente Virtual”
- “Consultor Especializado”
- Use um nome amigável e memorável
- Pode ser o mesmo nome do agente ou diferente
- Considere a identidade da marca
Tom de Comunicação
Campo: Tom de Comunicação
Campo: Tom de Comunicação
Define o estilo de comunicação do agente. Escolha entre diferentes tons que refletem diferentes abordagens de interação.Opções disponíveis:
Casual
Amigável
Profissional
- Casual: Apps sociais, comunidades, conteúdo informal
- Amigável: Suporte ao cliente, onboarding, experiências do usuário
- Profissional: B2B, documentação técnica, ambientes corporativos
Formalidade
Campo: Formalidade
Campo: Formalidade
Nível de formalidade na comunicação, de muito formal (corporativo) a muito casual (descontraído).Opções disponíveis:
Muito Formal
Formal
Informal
Casual
Muito Casual
- Combine com o Tom de Comunicação para criar o estilo ideal
- Considere o público-alvo e contexto de uso
- Teste diferentes níveis para encontrar o equilíbrio certo
Tamanho das Respostas
Campo: Tamanho das Respostas
Campo: Tamanho das Respostas
Define o comprimento padrão das respostas do agente. Isso ajuda a controlar o nível de detalhamento.Opções disponíveis:
Concisa
Média
Detalhada
Explicativa
- Considere o contexto: mobile vs desktop
- Respostas muito longas podem cansar o usuário
- Respostas muito curtas podem não fornecer contexto suficiente
Nível de Interação
Campo: Nível de Interação
Campo: Nível de Interação
Define como o agente interage com os usuários, de reativo (só responde) a muito proativo (antecipa necessidades).Opções disponíveis:
Reativo (só responde)
Moderado (faz perguntas)
Proativo (sugere ações)
Muito Proativo (antecipa necessidades)
- Níveis mais proativos podem ser intrusivos se não bem configurados
- Combine com o Prompt do Sistema para definir comportamento específico
- Teste com usuários reais para encontrar o equilíbrio
Emojis
Campo: Emojis
Campo: Emojis
Padrão: DesligadoDescrição:
Permite que o agente use emojis nas respostas para tornar a comunicação mais expressiva e amigável.Quando usar:
- ✅ Comunicação casual e amigável
- ✅ Público jovem ou informal
- ✅ Aplicações sociais ou de entretenimento
- ❌ Contextos muito formais ou corporativos
- ❌ Comunicação técnica ou profissional
- Emojis podem melhorar o engajamento em contextos apropriados
- Use com moderação mesmo quando ativado
- Considere o público-alvo antes de ativar
Prompt do Sistema
Campo: Prompt do Sistema
Campo: Prompt do Sistema
Limite: Máximo 5000 caracteres
Placeholder: “Você é a Aurora, assistente digital da FindUP…”Descrição:
Instruções principais que definem o papel, personalidade e comportamento do agente. Este prompt orienta todas as respostas do agente e é fundamental para o desempenho.Estrutura recomendada:
- Seja específico sobre o papel e objetivo
- Defina claramente o que fazer e não fazer
- Use exemplos quando útil
- Revise e refine baseado em testes
- Mantenha atualizado conforme o agente evolui
Regras Personalizadas
Campo: Regras Personalizadas
Campo: Regras Personalizadas
Limite: Máximo 5000 caracteres
Placeholder: “Digite uma regra por linha…”Descrição:
Regras específicas de comportamento que o agente deve seguir. Digite uma regra por linha. Use ’-’ para criar listas ou numere para criar sequências.Formato:
- Comportamento específico: “Sempre ofereça um resumo ao final de explicações longas”
- Formato de resposta: “Use listas numeradas para passos sequenciais”
- Limitações: “Nunca faça promessas sobre prazos de entrega”
- Personalização: “Adapte o nível técnico da explicação ao conhecimento do usuário”
- Seja claro e específico
- Uma regra por linha facilita leitura
- Use formatação consistente
- Revise regularmente e ajuste conforme necessário
Seção: Placeholder de Input
Placeholder de Input
Placeholder
Campo: Placeholder
Campo: Placeholder
Limite: Máximo 200 caracteresDescrição:
Texto de exemplo que aparece no campo de chat antes do usuário começar a digitar. Ajuda a orientar o usuário sobre o que pode perguntar.Exemplos:
- “Digite sua pergunta aqui…”
- “Como posso ajudar você hoje?”
- “Pergunte qualquer coisa sobre nosso produto”
- “Descreva seu problema ou dúvida”
- “O que você gostaria de saber?”
- Seja claro e direto
- Use linguagem amigável
- Considere o contexto de uso
- Pode incluir exemplos: “Ex: Como funciona o produto?”
Seção: Iniciadores de Conversa
Iniciadores de Conversa
Adicionar Iniciadores
Criar Novo Iniciador
Escrever o Texto
- “Como funciona o produto?”
- “Preciso de ajuda técnica”
- “Quero saber sobre preços”
Escolher Ícone (Opcional)
Salvar
- Máximo recomendado: 4-6 iniciadores
- Mínimo: 0 (não obrigatório)
- Ordem: Os iniciadores aparecem na ordem em que foram adicionados
- Use perguntas que os usuários realmente fazem
- Seja específico: “Como configurar integração?” é melhor que “Ajuda”
- Organize por categoria ou frequência
- Revise e atualize regularmente baseado em uso
Seção: Base de Conhecimento
Base de Conhecimento
Gerenciar Documentos
Abrir Gerenciador
Escolher Tipo
- Documentos individuais: Selecione documentos específicos
- Coleções: Selecione coleções inteiras de documentos
Buscar e Selecionar
Confirmar
- Documentos conectados são processados automaticamente
- O conteúdo é indexado para busca RAG
- O agente pode acessar informações dos documentos nas respostas
- Alterações nos documentos são refletidas automaticamente
- Conecte documentos específicos e relevantes
- Organize em coleções para facilitar gerenciamento
- Revise regularmente para manter atualizado
- Teste se o agente está usando o conhecimento corretamente
Seção: Ferramentas (Tools)
Ferramentas e Integrações
Tipos de Ferramentas
APIs
APIs
- Consultar banco de dados
- Buscar informações em sistemas externos
- Executar ações em serviços terceiros
Webhooks
Webhooks
- Notificar sistemas quando conversa inicia
- Enviar dados para CRM
- Atualizar sistemas externos
Bancos de Dados
Bancos de Dados
- Consultar estoque
- Verificar status de pedidos
- Buscar informações de clientes
Ferramentas Customizadas
Ferramentas Customizadas
- Calculadoras específicas
- Processadores de dados customizados
- Integrações proprietárias
Adicionar Ferramenta
Abrir Gerenciador
Selecionar Tipo
Configurar Parâmetros
- Nome: Nome descritivo da ferramenta
- Endpoint/URL: URL ou endpoint da ferramenta
- Autenticação: Credenciais se necessário
- Descrição: O que a ferramenta faz
- Parâmetros: Campos de entrada necessários
Testar
Salvar
- Teste sempre antes de usar em produção
- Documente bem o propósito de cada ferramenta
- Monitore uso e performance
- Mantenha credenciais seguras
Seção: Configurações Gerais
Configurações Gerais
Model Temperature (Temperatura do Modelo)
Campo: Model Temperature
Campo: Model Temperature
Range: 0 a 2
Padrão: 0
Step: 0.1Descrição:
Controla a criatividade e aleatoriedade das respostas do modelo de IA.Valores e Significado:
0.0 - 0.3
0.4 - 0.7
0.8 - 2.0
- Suporte técnico: 0.2 - 0.4
- Vendas/Atendimento: 0.5 - 0.7
- Criativo/Conteúdo: 0.7 - 1.0
- Padrão: 0.5 - 0.7
- Valores muito baixos podem tornar respostas robóticas
- Valores muito altos podem reduzir consistência
- Teste diferentes valores para encontrar o ideal
- Considere o caso de uso ao ajustar
Max Allowed Tokens
Campo: Max Allowed Tokens
Campo: Max Allowed Tokens
Mínimo: 1
Padrão: 0 (sem limite)Descrição:
Define o número máximo de tokens que o agente pode usar em uma resposta. Tokens são unidades de texto processadas pelo modelo.Conversão aproximada:
- 1 token ≈ 0.75 palavras em inglês
- 1 token ≈ 0.5 palavras em português
- 100 tokens ≈ 75 palavras (inglês) ou 50 palavras (português)
Respostas Curtas
Respostas Médias
Respostas Longas
Sem Limite
- Limites menores reduzem custos
- Limites maiores permitem respostas mais completas
- Considere o contexto: mobile vs desktop
- Teste para encontrar o equilíbrio ideal
Timeout (ms)
Campo: Timeout
Campo: Timeout
Range: 1000 a 300000 (1 segundo a 5 minutos)
Padrão: Não definido (usa padrão do sistema)Descrição:
Tempo máximo que o sistema aguarda por uma resposta do modelo antes de considerar timeout.Valores Recomendados:
- Rápido: 5000-10000ms (5-10 segundos) - Para respostas simples
- Padrão: 15000-30000ms (15-30 segundos) - Para maioria dos casos
- Longo: 60000-120000ms (1-2 minutos) - Para processamento complexo
- Muito Longo: 180000-300000ms (3-5 minutos) - Para tarefas muito complexas
- Timeouts muito curtos podem causar erros desnecessários
- Timeouts muito longos podem deixar usuários esperando
- Considere a complexidade das tarefas do agente
- Ajuste baseado em feedback dos usuários
Max Simultaneous Chat
Campo: Max Simultaneous Chat
Campo: Max Simultaneous Chat
Range: 1 a 100
Padrão: Não definido (sem limite)Descrição:
Número máximo de conversas simultâneas que o agente pode processar ao mesmo tempo.Quando usar:
- Sem limite (padrão): Para maioria dos casos, permite escalar conforme necessário
- Limite definido: Para controlar custos ou garantir qualidade em casos específicos
- Limites muito baixos podem causar filas de espera
- Considere seus recursos e custos
- Monitore uso para ajustar se necessário
Disable Response Cache
Campo: Disable Response Cache
Campo: Disable Response Cache
Padrão: Desligado (cache habilitado)Descrição:
Quando desabilitado (padrão), o sistema cacheia respostas para perguntas similares, melhorando velocidade e reduzindo custos. Quando habilitado, desativa o cache.Quando desabilitar cache:
- ✅ Respostas precisam ser sempre atualizadas
- ✅ Dados dinâmicos que mudam frequentemente
- ✅ Quando personalização extrema é necessária
- ✅ Perguntas frequentes (FAQs)
- ✅ Informações estáticas
- ✅ Para reduzir custos e melhorar velocidade
- Cache geralmente melhora performance e reduz custos
- Desabilite apenas quando realmente necessário
- Monitore impacto ao desabilitar
Citations
Campo: Citations
Campo: Citations
Padrão: DesligadoDescrição:
Quando habilitado, o agente mostra citações das fontes de conhecimento usadas nas respostas (documentos, coleções RAG).Quando usar:
- ✅ Quando transparência sobre fontes é importante
- ✅ Para validação e verificação de informações
- ✅ Em contextos educacionais ou técnicos
- ❌ Quando citações podem poluir a interface
- ❌ Para conversas muito casuais
- Citações aumentam confiança do usuário
- Podem tornar respostas mais longas
- Úteis para conhecimento baseado em documentos
Show Steps
Campo: Show Steps
Campo: Show Steps
Padrão: DesligadoDescrição:
Quando habilitado, o agente mostra os passos de raciocínio ou processamento ao responder.Quando usar:
- ✅ Para tarefas complexas que requerem múltiplos passos
- ✅ Quando transparência do processo é importante
- ✅ Para debugging e otimização
- ❌ Para respostas simples e diretas
- ❌ Quando pode confundir o usuário
- Útil para entender como o agente chegou à resposta
- Pode tornar respostas mais longas
- Bom para casos técnicos ou educacionais
Follow Up Questions
Campo: Follow Up Questions
Campo: Follow Up Questions
Padrão: DesligadoDescrição:
Quando habilitado, o agente sugere perguntas de acompanhamento após responder, ajudando a continuar a conversa.Quando usar:
- ✅ Para guiar usuários através de processos
- ✅ Para descobrir necessidades adicionais
- ✅ Para melhorar engajamento
- ❌ Quando usuários querem respostas diretas
- ❌ Para casos muito simples
- Melhora engajamento e descoberta de necessidades
- Pode ser intrusivo se mal configurado
- Combine com Nível de Interação apropriado
Timeout (ms)
Campo: Timeout
Campo: Timeout
Range: 1000 a 300000 (1 segundo a 5 minutos)
Padrão: Não definido (usa padrão do sistema)Descrição:
Tempo máximo que o sistema aguarda por uma resposta do modelo antes de considerar timeout.Valores Recomendados:
- Rápido: 5000-10000ms (5-10 segundos) - Para respostas simples
- Padrão: 15000-30000ms (15-30 segundos) - Para maioria dos casos
- Longo: 60000-120000ms (1-2 minutos) - Para processamento complexo
- Muito Longo: 180000-300000ms (3-5 minutos) - Para tarefas muito complexas
- Timeouts muito curtos podem causar erros desnecessários
- Timeouts muito longos podem deixar usuários esperando
- Considere a complexidade das tarefas do agente
- Ajuste baseado em feedback dos usuários
Max Simultaneous Chat
Campo: Max Simultaneous Chat
Campo: Max Simultaneous Chat
Range: 1 a 100
Padrão: Não definido (sem limite)Descrição:
Número máximo de conversas simultâneas que o agente pode processar ao mesmo tempo.Quando usar:
- Sem limite (padrão): Para maioria dos casos, permite escalar conforme necessário
- Limite definido: Para controlar custos ou garantir qualidade em casos específicos
- Limites muito baixos podem causar filas de espera
- Considere seus recursos e custos
- Monitore uso para ajustar se necessário
Disable Response Cache
Campo: Disable Response Cache
Campo: Disable Response Cache
Padrão: Desligado (cache habilitado)Descrição:
Quando desabilitado (padrão), o sistema cacheia respostas para perguntas similares, melhorando velocidade e reduzindo custos. Quando habilitado, desativa o cache.Quando desabilitar cache:
- ✅ Respostas precisam ser sempre atualizadas
- ✅ Dados dinâmicos que mudam frequentemente
- ✅ Quando personalização extrema é necessária
- ✅ Perguntas frequentes (FAQs)
- ✅ Informações estáticas
- ✅ Para reduzir custos e melhorar velocidade
- Cache geralmente melhora performance e reduz custos
- Desabilite apenas quando realmente necessário
- Monitore impacto ao desabilitar
Citations
Campo: Citations
Campo: Citations
Padrão: DesligadoDescrição:
Quando habilitado, o agente mostra citações das fontes de conhecimento usadas nas respostas (documentos, coleções RAG).Quando usar:
- ✅ Quando transparência sobre fontes é importante
- ✅ Para validação e verificação de informações
- ✅ Em contextos educacionais ou técnicos
- ❌ Quando citações podem poluir a interface
- ❌ Para conversas muito casuais
- Citações aumentam confiança do usuário
- Podem tornar respostas mais longas
- Úteis para conhecimento baseado em documentos
Show Steps
Campo: Show Steps
Campo: Show Steps
Padrão: DesligadoDescrição:
Quando habilitado, o agente mostra os passos de raciocínio ou processamento ao responder.Quando usar:
- ✅ Para tarefas complexas que requerem múltiplos passos
- ✅ Quando transparência do processo é importante
- ✅ Para debugging e otimização
- ❌ Para respostas simples e diretas
- ❌ Quando pode confundir o usuário
- Útil para entender como o agente chegou à resposta
- Pode tornar respostas mais longas
- Bom para casos técnicos ou educacionais
Follow Up Questions
Campo: Follow Up Questions
Campo: Follow Up Questions
Padrão: DesligadoDescrição:
Quando habilitado, o agente sugere perguntas de acompanhamento após responder, ajudando a continuar a conversa.Quando usar:
- ✅ Para guiar usuários através de processos
- ✅ Para descobrir necessidades adicionais
- ✅ Para melhorar engajamento
- ❌ Quando usuários querem respostas diretas
- ❌ Para casos muito simples
- Melhora engajamento e descoberta de necessidades
- Pode ser intrusivo se mal configurado
- Combine com Nível de Interação apropriado
Seção: Acesso e Segurança
Acesso e Segurança
Security Access
Campo: Security Access
Campo: Security Access
Padrão: PRIVATEDescrição:
Define o nível de acesso ao agente. Controla quem pode ver e usar o agente.Opções disponíveis:
Privado
Público
Organização
Equipe
Restrito
Times com Acesso (TEAM e RESTRICTED)
- Tipo: Checkboxes múltiplos
- Descrição: Selecione quais equipes podem acessar o agente
- Comportamento:
- Para TEAM: Pelo menos uma equipe deve ser selecionada
- Para RESTRICTED: Opcional, pode combinar com usuários específicos
Usuários com Acesso (RESTRICTED apenas)
- Tipo: Checkboxes múltiplos
- Descrição: Selecione usuários específicos que podem acessar o agente
- Comportamento: Opcional, pode combinar com equipes
- Comece com PRIVATE durante desenvolvimento
- Use ORGANIZATION para agentes internos gerais
- Use TEAM para agentes específicos de departamento
- Use RESTRICTED para casos muito específicos
- Revise permissões regularmente por segurança
Salvando Alterações
Sistema de Auto-Save
- Salvando…: Quando há alterações sendo salvas
- Salvo: Quando todas as alterações foram salvas com sucesso
- Erro: Se houver algum problema ao salvar
- Alterações são salvas automaticamente após alguns segundos de inatividade
- Você também pode clicar em Salvar alterações para salvar manualmente
- Não é necessário salvar antes de navegar para outras páginas
