BXat Documentação Abrir o BXat
Navegar na documentação

Agentes

Persona, habilidades e estante

Os campos do formulário de agente. Identidade, persona, habilidades, documentos da estante, conexões, memória e compartilhamento com o espaço de trabalho.

Editar um agente é mexer em três coisas: quem ele é (identidade e persona), o que ele sabe fazer (habilidades e conexões) e o que ele conhece (estante).

Para abrir o formulário de um agente seu: no computador, o lápis na linha dele; no celular, Opções do agente → Editar.

Identidade

  • Imagem, emoji ou cor: a cara do agente. A ordem é imagem própria, depois emoji, depois o robô da casa tingido com a cor escolhida. A imagem vale em todo lugar em que o agente aparece. Imagens quadradas funcionam melhor; a moldura é sempre circular.
  • Nome: como ele aparece nas Verticais e como é chamado com @ no modo Time. Evite nomes iguais aos de outros agentes.
  • Descrição: a linha que aparece sob o nome, na lista de contatos.

Persona / instruções

É um campo único. Ele já vem com um esqueleto em português: troque o que está entre parênteses.

  • Papel: quem o agente é ("analista de dados do time de marketing").
  • Objetivos: o que ele entrega em cada conversa.
  • Contexto: o que ele precisa saber sobre o seu negócio ou área.
  • Tom e estilo: formal ou leve, direto ou didático.
  • Regras: limites e comportamentos obrigatórios ("nunca invente números", "responda sempre em tópicos").

Persona boa é persona específica. "Seja útil" não muda nada; "responda sempre com os dados à mão e diga explicitamente quando não houver dado" muda tudo.

Habilidades

O que o agente sabe fazer. Ele decide quando usar cada uma.

  • Busca na web: procura e cita fontes da internet.
  • Escrita humana: corta os cacoetes de texto de IA em português. Vale para toda resposta do agente.
  • Busca acadêmica (BX-Scholar): artigos, Qualis e SJR, checagem de citações.
  • Um card para cada conector que a plataforma oferece aos agentes.

Menos habilidades rendem respostas mais previsíveis. Mais habilidades, um agente mais versátil.

Estante · Documentos

A Estante é o acervo permanente do agente: manuais, políticas, catálogos, apostilas. São documentos que ele conhece em todas as conversas, sem você anexar de novo. Use Adicionar documentos e pergunte normalmente; ele recupera os trechos relevantes na hora de responder.

Anexo de conversa vale só para aquela conversa; a Estante é permanente. Um agente de RH com o manual de benefícios na estante responde a qualquer momento "quantos dias de licença paternidade temos?", sem ninguém anexar nada.

A Estante e as Conexões só aparecem ao editar um agente já criado.

Conexões

Na seção Conexões você liga o agente a serviços externos (Notion, Google Analytics, VTEX e outros). Um serviço conectado vira ferramenta nas conversas com ele. Veja como funcionam as integrações e o catálogo de integrações.

Deixar este agente te conhecer

Ligado, o agente lê a sua memória global, para ter continuidade com o assistente geral. A memória que ele constrói nas conversas com você é descrita em memória dos agentes.

Compartilhar com seu workspace

Se você é membro de um espaço de trabalho, ligue Compartilhar com seu workspace: os colegas passam a ver o agente no grupo Do seu workspace e podem conversar com ele e convidá-lo para projetos. Colegas não editam o agente. Desligar torna o agente privado de novo.

Agentes pessoais que você não compartilha ficam só com você.