Criar Agents

Aprenda a criar novos agents no Cuneiform Chat.

Primeiros Passos

Acesse Agents na barra lateral
Clique no botão Create Agent no canto superior direito
Preencha as seções do formulário descritas abaixo

Informações Básicas

Esta seção captura os detalhes essenciais sobre o seu agent.

Campo	Obrigatório	Descrição
Name	Sim	Um nome para o seu agent (por exemplo, “Customer Support Agent”). Máximo de 100 caracteres.
Description	Não	Uma breve descrição do que esse agent faz. Máximo de 500 caracteres.

Dicas:

Escolha um nome descritivo que indique o propósito do agent
A descrição ajuda você e sua equipe a entender o papel do agent

Agent Persona

O agent persona define como seu agent se comporta e responde por meio de um system prompt.

Elementos principais:

Caixa Platform Rules — Mostra as regras de segurança integradas que são aplicadas automaticamente (clique para ver os detalhes)
Botão Generate — Abre o Agent Persona Builder para ajudar a criar sua persona
Botão Edit — Abre um painel para escrever ou editar a persona manualmente

Platform Rules

Essas guardrails de segurança são aplicadas automaticamente a todos os agents:

No fabrication — Não inventa fatos que não estejam no seu conteúdo
Acknowledges gaps — Diz “não sei” quando apropriado
Resists speculation — Não chuta informações faltantes
No professional impersonation — Não atua como advogado, médico, etc.
Corrects false premises — Aponta suposições incorretas
Blocks harmful content — Recusa solicitações inadequadas

As Platform Rules garantem que todos os agents se comportem de forma confiável e segura. Elas não podem ser desativadas. Veja Agent Persona Builder para detalhes.

Exemplo Rápido de Persona


You are a helpful assistant for [Your Company].
Answer questions based on the provided documentation.
Be concise and friendly.

Veja Agent Personas para orientações detalhadas sobre como escrever personas eficazes.

Suporte a Idiomas

Seu agent detecta automaticamente o idioma de cada mensagem do usuário e responde no mesmo idioma — sem precisar de configuração. 176 idiomas são suportados nativamente. Veja Agent Personas — Detecção de Idioma para detalhes.

Configuração do LLM

Esta seção controla as configurações do modelo de AI.

Modo Padrão:

Por padrão, as configurações de LLM usam os valores padrão do tier da sua organização. Você verá uma caixa de informação indicando “Using tier defaults”. Isso é recomendado para a maioria dos casos.

Modo Avançado:

Ative Advanced para personalizar:

Configuração	Descrição
Model	Escolha entre os modelos de AI disponíveis conforme seu plano
Temperature	Controla a criatividade das respostas (mais baixo = mais consistente, mais alto = mais criativo)

Show Document References:

Este toggle (sempre visível) controla se o agent inclui citações de fontes nas respostas:

Off (padrão) — As respostas não mencionam os documentos de origem
On — As respostas incluem referências aos documentos de origem (útil para casos jurídicos ou de compliance)

Controle de Acesso ao Conhecimento

Controle quais documentos seu agent pode acessar ao responder perguntas.

Modo	Comportamento	Quando Usar
Exclude Mode	O agent acessa TODOS os documentos EXCETO os selecionados	Ocultar documentos sensíveis do agent
Include Mode	O agent acessa APENAS os itens selecionados	Restringir o agent a um conjunto específico de conhecimento

Ao usar Include Mode:

Selecione as pastas específicas que o agent pode acessar
Selecione as tags específicas que o agent pode acessar
Selecione documentos individuais que o agent pode acessar

O agent só usará informações das fontes selecionadas ao responder.

Comece com Exclude Mode (acesso total ao conhecimento), a não ser que precise ocultar documentos específicos. Você sempre pode restringir o acesso depois.

Ações do Formulário

Na parte inferior do formulário:

Botão	Ação
Cancel	Descartar alterações e voltar
Reset	Limpar todos os campos e começar de novo (mostra um diálogo de confirmação)
Create Agent	Salvar o agent e abrir sua página de edição

Seu rascunho é salvo automaticamente enquanto você trabalha. Se sair e voltar, seu progresso será restaurado.

Após Criar

Quando você clica em Create Agent:

O agent é criado com o status Testing
Você é levado para a página de edição do agent
Teste o agent usando o Playground
Conecte integrações quando estiver pronto para colocar em produção
Mude o status para Active quando estiver pronto

Novos agents começam com o status Testing. Você pode testar no Playground, mas as integrações de canal ficam desativadas até você ativar o agent.

Gerenciar Agents

Na página Agents, você pode:

Edit — Clique em qualquer agent para modificar suas configurações
Test — Clique em Test no card de um agent para abrir o Playground
Change Status — Definir como Testing, Active, Inactive ou Archived

Veja Opções de Configuração para detalhes de todas as configurações do agent.