Contextos

Um contexto é um bloco curto de informações que acompanha cada resposta do agente. Use-o para fatos que precisam estar sempre disponíveis, como identidade da empresa, público, tom de voz e regras universais.

O bloco pertence à organização. Ele só afeta um agente depois de ser anexado na seção Conhecimento desse agente e estar em um estado que o runtime utiliza.

Contexto ou base vetorizada?

	Contexto	Base vetorizada
Quando entra no prompt	Em cada chamada do agente, sem busca	Quando o agente consulta a base
Tamanho recomendado	Curto e estável	Grande ou consultado sob demanda
Custo	Acrescenta tokens a cada chamada	Acrescenta tokens quando há consulta e resultado
Bom para	Identidade, tom, políticas curtas e regras comuns	Manuais, catálogos, FAQs e documentação extensa

Pergunte: o agente precisa saber isso em todas as respostas? Se sim, use contexto. Se a informação só é necessária em situações específicas, use uma base vetorizada ou uma instrução no prompt do agente.

Abrir Contextos

1. No painel administrativo, abra Bases de Conhecimento.
2. Selecione a aba Contextos. A descrição atual da aba é Texto curto que vai junto em toda resposta.

A URL atual é /admin/bases/context. O endereço antigo /admin/context redireciona para ela.

Criar um bloco manualmente

1. Na aba Contextos, selecione Novo bloco. Se a organização ainda não tiver blocos, use Criar primeiro bloco.
2. Preencha Nome com até 120 caracteres. Esse nome também entra no prompt como título do conteúdo; escolha um rótulo claro, como Tom de voz ou Política de reembolso.
3. Escreva o Conteúdo em Markdown. Use Editar para escrever e Visualizar para conferir a formatação.
4. Selecione Salvar bloco.

O conteúdo aceita até 200.000 caracteres. A interface mostra uma estimativa aproximada de tokens, calculada como um token para cada quatro caracteres, e avisa acima de 2.000 tokens. Não interprete esse número como contagem exata do modelo.

Um bloco manual novo é criado como Ativo, mas ainda não fica anexado a nenhum agente.

Começar a partir do site

Quando a organização ainda não tem blocos, Montar a partir do site oferece duas formas de preparar rascunhos:

• Informe Nome da empresa e, opcionalmente, Site da empresa para pesquisar fontes públicas e gerar um bloco.
• Selecione Prefiro escrever eu mesmo para criar três rascunhos: O que a empresa faz, Para quem e O que nunca fazer.

Nos dois casos, o resultado fica como Rascunho. Revise o texto e, quando houver pesquisa, confira as fontes exibidas no editor antes de ativar o bloco.

Caution

Montar a partir do site usa um modelo de IA e consome créditos. Se a chamada ao modelo ocorrer e uma etapa posterior falhar, a tentativa também pode gerar consumo. A tela atual não apresenta esse aviso antes da execução.

Entender os estados

Estado na interface	Entra no prompt?	O que fazer
Ativo, sem selo	Sim	Manter enquanto o conteúdo estiver correto
Rascunho	Não	Revisar e usar Colocar no ar
Marcado como velho	Sim	Corrigir ou confirmar; a marca não interrompe o uso
Fora do ar	Não	Usar Colocar no ar para voltar a utilizar

Depois de 180 dias sem confirmação, a lista pede uma revisão. Ainda vale atualiza a data de confirmação, mas não altera o conteúdo nem os vínculos.

Use Tirar do ar para retirar um bloco ativo do prompt sem excluí-lo. Use Excluir bloco somente quando ele não for mais necessário: a exclusão também remove seus vínculos com agentes. O diálogo informa quantos agentes estão vinculados antes da confirmação.

Revisar sugestões e histórico

O botão Ver sugestões e histórico abre Sugestões e histórico, que reúne propostas pendentes e as versões recentes do bloco. O histórico conserva as 20 versões mais recentes. Ao usar Voltar para esta em uma versão, o SquadOS cria uma nova versão atual com o conteúdo escolhido; não apaga o restante do histórico.

Revise uma sugestão antes de aplicá-la. Ela pode alterar uma premissa que todos os agentes vinculados recebem em chamadas futuras.

Anexar a um agente

1. Abra Agentes e edite o agente.
2. Entre em Conhecimento.
3. Em Blocos de contexto, marque os blocos desejados.
4. Use a barra de salvamento da seção.

O runtime organiza os blocos válidos sob Organization context no prompt de sistema, na ordem dos vínculos. Para cada bloco, ele inclui o Nome como título e depois o Conteúdo. Blocos Rascunho e Fora do ar não são enviados; blocos ativos e Marcado como velho são enviados.

Caution

O selo Sugerido para todos é apenas uma indicação no produto atual. Ele não anexa o bloco automaticamente a agentes novos. Abra cada agente e confirme os blocos marcados.

A lista do editor do agente pode exibir blocos em qualquer estado sem mostrar o estado, e a estimativa total pode somar um rascunho ou bloco desligado que esteja marcado. Para saber o que realmente entra no prompt, use a tabela de estados acima.

Veja Ferramentas nativas — visão geral para entender a relação entre bases, contextos e AutoLearn.

Permissões atuais

A rota de Contextos exige acesso de leitura a bases. Entretanto, os controles de criação e alteração podem aparecer para quem não consegue concluí-los, porque a autorização do backend ainda segue o papel administrativo legado. Se uma ação visível retornar erro de permissão, peça a um administrador ou proprietário da organização para executá-la.

O que escrever

Bons candidatos:

• Identidade: o que a empresa faz, para quem e em qual mercado atua.
• Tom de voz: como a marca fala, o que evita prometer e como age quando não sabe.
• Regras curtas e universais: horário, política breve ou restrição que vale para todos os atendimentos.

Evite:

• catálogos, tabelas longas e manuais; use uma base vetorizada;
• instruções exclusivas de um agente; coloque-as no prompt desse agente;
• conteúdo instável sem responsável por revisar e confirmar;
• segredos, credenciais ou dados pessoais desnecessários.

Antes de ativar, confira se o texto é factual, curto, compreensível sem imagem ou contexto externo e seguro para todos os agentes vinculados.