Um assistente que atende os seus visitantes a qualquer hora.

1. O navegador envia a conversa inteira e a assinatura da última resposta para POST /api/agent/messages. O histórico fica no navegador do visitante.
2. O Emissario confere a origem, os bloqueios de IP, a assinatura, as requisições por minuto e os tokens restantes do dia, antes de chamar qualquer modelo.
3. As regras entram: primeiro as do próprio Emissario, depois o seu instructions/README.md. Nenhuma mensagem consegue mudá-las.
4. Ferramentas: o modelo pode listar e ler os arquivos de instructions/, ou chamar as URLs declaradas, em até 5 rodadas por mensagem.
5. A resposta volta assinada com HMAC-SHA256. O Emissario registra os tokens usados, nunca a conversa.

• O repositório do agente é sincronizado como o site: em um intervalo, ou pelo botão Sincronizar. Os arquivos são lidos a cada mensagem.
• instructions/README.md guarda as instruções de sistema. Sem ele, o chat responde 503 no-instructions.
• instructions/SUMMARY.md, opcional, acrescenta regras para os resumos, por exemplo classificar a intenção.
• O modelo lista e lê os outros arquivos conforme precisa, até 64 KiB cada. Arquivos ocultos ficam de fora.
• emissario drop-agents-skills escreve a skill que o Claude Code, o Codex e o Antigravity carregam para escrever esses arquivos.

my-agent/
└── instructions/
    ├── README.md      # quem é o agente, o que ele responde
    ├── SUMMARY.md     # opcional: regras para os resumos
    ├── pricing.md     # lido quando o visitante pergunta
    └── policies/
        └── refunds.md

• Uma chamada em andamento reserva max-tokens até responder, então requisições simultâneas nunca passam de um limite juntas.
• Cada rodada de ferramenta e cada resumo contam, entrada e saída.
• Acima de um limite: 429 daily-limit ou ip-daily-limit, até a meia-noite.
• Uma conversa: até 50 mensagens, 4.000 caracteres por mensagem, 64 KiB por requisição, 60 s por resposta com ferramentas.
• O uso é guardado por 90 dias, com o IP em hash por padrão; um viewer vê os IPs mascarados.

Qualquer modelo compatível com a API da OpenAI que suporte chamada de ferramentas. O Emissario chama <base-url>/chat/completions.

• A chave de API é somente escrita: uma página mostra no máximo os quatro últimos caracteres, nunca para um viewer, nunca em um log.
• EMISSARIO_AGENT_API_KEY tem prioridade sobre a chave salva no backoffice.

• O chat envia a conversa e a assinatura para POST /api/agent/summaries; uma conversa que o agente nunca teve é recusada.
• A segunda passada troca CPF, CNPJ, e-mail, telefone e cartão por [cpf], [cnpj], [email], [phone] e [card].
• O visitante recebe uma referência de 16 caracteres. Um root apaga um resumo, ou todos antes de uma data, e pode colocar um em retenção legal.

• Cada URL tem um nome, uma descrição, GET ou POST, e cabeçalhos que o próprio servidor acrescenta.
• O modelo nunca escreve uma URL: ele chama um endpoint pelo nome.
• Os cabeçalhos são somente escrita: nunca mostrados ao modelo, a um viewer, nem de novo a um root.
• Nenhum redirecionamento é seguido; só texto ou JSON é lido, cortado em 32 KiB, em até 10 segundos.

name

implementation-prices

method

GET

url

https://example.com/prices.json

description

Os preços dos planos. Chame antes de falar de preço.

headers

Authorization: ••••••••