O guia do usuário da Stalwart¶

Este guia é para dois tipos de leitor: quem constrói agentes de IA com a Stalwart, e quem responde pelo que esses agentes fazem, como uma equipe de segurança, de risco ou de compliance. Ele explica o que cada produto do Stalwart Agents faz, como usá-lo e, tão importante quanto, onde termina cada uma das suas garantias.

O guardrail¶

O guardrail verifica cada chamada de ferramenta que um agente de LLM faz antes de ela rodar, seja qual for o framework em que o agente foi construído, e responde permitir, perguntar à pessoa ou recusar, citando a regra. Nada nele é adivinhado por um modelo de linguagem.

Saiba mais

Os produtos para desenvolvedores¶

Para equipes que constroem agentes de IA, uma chave de API dá mais seis produtos. O guia os chama pelos mesmos nomes que o site e a referência da API, com o nome em inglês entre parênteses, porque é o que você vai encontrar no código, nas chaves e nas conversas com o suporte.

O Construtor de Bots (Bot Builder) constrói um agente de IA seu a partir das ferramentas que a sua empresa já tem. Você descreve o agente num único arquivo, e as suas regras são verificadas a cada chamada de ferramenta antes de ela rodar.
A Verificação de Grafos de Agentes (Agent Graph Verification) verifica cada caminho de um agente, ou de uma equipe de agentes, antes de ele entrar no ar. Ela relata cada caminho que chega a uma ferramenta sem a verificação pela qual deveria passar, sem a confirmação que deveria pedir ou sem o passo que deveria vir antes.
O Caçador de Bugs em Guardrails (Guardrail Bug Hunter) encontra cada caminho pelos seus guardrails até uma ação que eles deveriam impedir. Ele mostra cada um acontecendo e entrega uma correção que já testou varrendo de novo.
A Verificação de Guardrails (Guardrail Verification) responde se uma ação pode acontecer sem a condição que deveria protegê-la, para uma pergunta ou uma tabela inteira delas. Se pode, você recebe um exemplo de como e um reparo; se não pode, recebe um certificado que prova isso.
A Escrita de Guardrails (Guardrail Writing) transforma uma regra escrita em palavras simples numa política de guardrails. O seu próprio modelo escreve o rascunho; a Stalwart então o verifica e o corrige onde ele erra.
A Verificação de Random Forests (Random Forest Verification) verifica um modelo de random forest treinado quanto a robustez, monotonicidade, equidade e alcançabilidade. Ela também pode partir de registros reais e procurar a menor mudança que inverteria uma decisão.

Idiomas

O seletor lê turnos escritos em inglês e em português do Brasil (pt-BR). O idioma é escolhido, nunca adivinhado a partir do turno: na página Settings do console (Language the selector reads), em language numa requisição de plano, ou no settings.language do seu arquivo de vocabulário; sem nenhum deles, inglês. Um turno em português pode ser digitado com os acentos ou sem eles. O português europeu não é uma gramática que o seletor tenha, e um turno em qualquer outra língua não é lido.

Um agente, num único arquivo¶

Você não precisa aprender um framework de agentes para usar nada disso. Uma equipe põe os produtos para trabalhar por meio de um único agente, descrito num arquivo: as suas ferramentas, as suas regras e quais mudanças desfazem quais. Antes de o agente rodar, cada caminho por ele é verificado. Enquanto ele roda, cada mensagem é lida e cada chamada de ferramenta é verificada, na sua própria máquina. E se uma execução falhar no meio, as suas mudanças são desfeitas, da última para a primeira. Este é o agente da loja que o guia usa em toda a Parte I:

# A central de atendimento da loja, e a central de cobrança para onde ela passa os estornos.
agents:
  desk:
    model: "anthropic:claude-sonnet-5-5"   # o seu provedor; a chave vem do seu ambiente
    tools: [get_order, charge_card, send_receipt, read_inbox]
    hands_off_to: [billing]
    on_unread: refuse                      # um turno que nenhuma ferramenta cobre é recusado, com o motivo
  billing:
    privilege: high
    tools: [refund_card]
tools:
  - python: shop.tools                     # cada função pública de shop/tools.py
rulebook: ./policy.co                      # as regras contra as quais cada chamada é verificada
facts:                                     # o que são o $card_on_file e o $order_paid do rulebook
  card_on_file: {from: get_order.card, same: order_id}           # lido da resposta de get_order
  order_paid: {from: get_order.status == paid, same: order_id}   # para o pedido que a chamada cita
runs: atomic                               # uma execução que falha é desfeita, da última escrita para trás
storage: sqlite:///runs.db                 # onde ficam as execuções e as confirmações pendentes

A Parte I o constrói passo a passo, usando só as palavras do arquivo acima.

Por onde começar¶

Se você só ler uma página: o guia inteiro, resumido numa única página.
Início rápido: cerca de quinze minutos, só no console, sem chave e sem terminal. Você começa um bot a partir de um modelo, experimenta e o roda no seu próprio computador.
Início rápido para desenvolvedores: cerca de meia hora. Você cria uma conta, monta o bot de atendimento de uma pequena loja, confere que ele não pode ser mal usado, conversa com ele, varre uma política de guardrails atrás de brechas e confere você mesmo uma prova.
O que este serviço faz, e o que ele não afirma: o capítulo 1. Leia a segunda metade dele antes de citar um resultado para alguém.

O guia tem cinco partes: o Construtor de Bots, o seletor do Construtor de Bots, o Caçador de Bugs em Guardrails, o caçador e o seletor juntos e verificação e escrita. Se você trabalha com governança ou segurança, o capítulo 39 é para você: ele mostra o que cada produto cobre nas listas Top 10 da OWASP de 2026 e no NIST AI Risk Management Framework, e o que uma correspondência dessas não quer dizer. O apêndice reúne as tabelas de referência, o glossário e o registro de mudanças.

Conferindo o nosso trabalho sem nós¶

Você não precisa confiar em nós para confiar num resultado. Um certificado pode ser conferido sem chave, sem rede e sem nenhum software nosso. A especificação do certificado explica como lê-lo, o verificador de referência é um único arquivo que você consegue ler numa tarde, e o corpus de certificados lhe dá certificados reais para testá-lo.

O guia offline. O guia inteiro num único arquivo, para ler sem rede ou para guardar num arquivo de auditoria: Inglês · Português.

O SHA-256 de cada arquivo está em SHA256SUMS, para que uma cópia possa ser conferida com a publicada aqui. Os links que saem do guia -- a referência da API, o site -- precisam da rede, e dizem isso; o guia offline não tem busca.

Em outros lugares¶

stalwart.it: os produtos, os planos e onde registrar seu interesse.
A referência da API: cada operação, e você pode testar cada uma com a sua própria chave.
A documentação do pacote: o pacote stalwart-agents, página por página, com a sua referência Python.

Os números dos capítulos nunca mudam, mesmo quando um capítulo vai para outra página, então um arquivo de auditoria que cita o capítulo 7 sempre aponta para o mesmo capítulo.