Visão geral dos agentes de IA
O Waafir executa uma força de trabalho de agentes de IA especializados dentro da sala de dados. Um resume documentos, um tarja informações sensíveis, um produz relatórios de revisão, um propõe uma estrutura de pastas e um traduz. Juntos, eles cuidam da leitura e da arrumação repetitivas que, de outra forma, consumiriam o tempo de uma equipe da transação.
Esta página é o modelo de toda a camada de IA. Leia-a primeiro; as páginas de cada recurso descrevem cada agente em detalhe.
Os agentes
Toda organização começa com os mesmos cinco agentes principais configurados. Nenhuma configuração é necessária antes que eles funcionem; eles ficam prontos assim que sua sala de dados existe.
| Agente | O que faz | Execução |
|---|---|---|
| Summarizer | Escreve um resumo conciso de cada documento longo | Automaticamente, no upload |
| Redactor | Encontra e oculta com tarjas pretas informações sensíveis | Sob demanda, com sua revisão |
| Reviewer | Lê um documento e produz um relatório de revisão | Sob demanda, com sua revisão |
| Organizer | Propõe uma estrutura de pastas limpa | Sob demanda, com sua revisão |
| Translator | Traduz um documento para outro idioma | Sob demanda, com sua revisão |
Você pode ajustar o comportamento de cada agente — por exemplo, refinando suas instruções ou o modelo que ele usa —, mas esses cinco agentes principais estão sempre presentes e não podem ser removidos. Eles definem a base de capacidades da plataforma: você os ajusta, mas não os perde.
A lista não para em cinco. Alguns recursos são entregues como agentes que vêm com um add-on, e não com o plano básico — por exemplo, o Investor Update Generator, que redige relatórios periódicos para investidores, parte do add-on Materiais do Investidor. Ele roda na mesma estrutura e segue as mesmas regras de revisão e auditoria. O mesmo add-on redige, verifica e reescreve apresentações de investimento, e cada alteração que ele propõe aguarda que você a aplique. Veja Materiais e relatórios para investidores para essa interface.
As configurações de agentes também listam mais dois agentes integrados: o Prose Drafter, que só é executado pela API (veja Agentes pela API); e o Fact Extractor, que o Waafir usa internamente e que você não executa.
Automático versus sob demanda
A divisão na tabela acima é intencional e é a distinção mais importante a entender.
- O trabalho somente leitura é executado automaticamente. Resumir um documento não o altera e não traz risco, por isso é executado assim que um arquivo é enviado, sem nenhuma ação necessária. Os resumos aparecem nos seus documentos pouco depois de o processamento terminar.
- O trabalho que altera um documento, ou o que um investidor vê, é sob demanda e revisado. Tarjamento, organização e tradução nunca são aplicados silenciosamente. Você aciona o agente, ele produz uma proposta e você a confirma antes que ela entre em vigor.
Esse é o princípio do humano no circuito (human-in-the-loop), e ele não é opcional. A plataforma é construída de modo que a IA não possa fazer uma alteração destrutiva ou visível para investidores sem aprovação humana.
Uma execução típica de agente
Quando você aciona um agente sob demanda — tarjar um documento, por exemplo —, o fluxo é sempre o mesmo:
- Você inicia a ação a partir do documento.
- O agente faz seu raciocínio e produz um resultado proposto.
- A plataforma apresenta essa proposta em uma tela de revisão — uma comparação do tarjamento, uma prévia das pastas, um seletor de idioma.
- Você a confirma ou rejeita.
- A alteração só é aplicada mediante sua confirmação.
Se você rejeitar a proposta, nada muda. Cada página de recurso documenta a tela de revisão exata daquele agente.
Quando cada agente é executado
Cada agente é executado a partir de sua própria ação no produto: o Summarizer quando um arquivo é enviado, os demais quando você os inicia a partir de um documento ou de uma sala de dados. A única exceção é o Prose Drafter, que só uma chamada de API executa (abaixo). Não é possível programar nenhum agente para rodar em um agendamento, nem escolher outro gatilho para ele. Seja o que for que inicie um agente, a etapa de revisão não muda: qualquer alteração destrutiva ou visível para investidores é uma proposta que um humano aprova.
Agentes pela API
A API da plataforma pode executar um agente diretamente:
POST /api/v1/agents/draft_prose/invoke executa o Prose Drafter, que
escreve textos fundamentados apenas nas citações que você envia. Ele não altera
nada nas suas salas de dados; ele retorna texto.
- Requisição:
{ "citations": [{ "id": string, "text": string }], "instruction": string }. Até 50 citações, cada uma com até 8.000 caracteres e 60.000 no total; a instrução tem até 2.000 caracteres. O rascunho atribui suas afirmações aos ids das suas citações e informa quando as citações não sustentam uma resposta. - Resposta:
{ agent, runId, suggestionId, content, usage: { inputTokens, outputTokens } }. - Acesso: um token de acesso pessoal
com escopo
writee recursos de IA ativados para a sua organização (ativados por padrão; um administrador da organização pode desativá-los em Configurações → IA e Integrações). Limitado a 5 chamadas por minuto e contabilizado no orçamento diário de IA da sua organização. - Erros:
draft_proseé o único nome de agente aceito; qualquer outro retorna404. Se um administrador tiver desativado o Prose Drafter nas configurações de agentes, a chamada retorna409. A lista completa está na referência de endpoints.
A execução é registrada na trilha de auditoria apenas com contagens (quantas citações, o tamanho da instrução), não com o texto das citações nem o rascunho.
Trilha de auditoria
Toda ação da IA é registrada: qual agente foi executado, em qual documento, o que ele propôs e quem aprovou ou rejeitou. Essa trilha de auditoria é central para que a plataforma seja segura para uso com documentos sensíveis de transações — sempre há uma resposta para "o que a IA fez e quem aprovou?". Quando você precisar demonstrar controle sobre como uma sala de dados foi preparada, esse registro é a fonte.
Próximos passos
- Tarjamento — o agente Redactor em detalhe.
- Tradução — o agente Translator em detalhe.
- Organizar — o agente Organizer em detalhe.
- Pontuação de prontidão — como a plataforma avalia se uma sala de dados está pronta para investidores.
- Assistente de IA — a interface conversacional, que não é um desses agentes.