---
title: Inference hooks
url: https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks
description: Envie cada prompt governado ao servidor de segurança de IA da sua organização para obter um veredito de permitir ou negar antes que a inferência prossiga.
---
Os Inference hooks estão em beta e disponíveis para organizações Claude Enterprise. Configurá-los requer a permissão `organization:manage` no claude.ai, que apenas as funções Owner e Primary owner possuem; consulte [Configurar Inference hooks](https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks-configuration).
Os "Inference hooks" (ganchos de inferência) permitem que uma organização Claude Enterprise encaminhe cada prompt governado por um servidor de segurança de IA, um serviço HTTPS que a organização ou seu fornecedor de segurança opera, antes que a inferência seja executada. Quando um usuário envia um prompt, a Anthropic envia a transcrição da conversa ao seu servidor de segurança de IA e aguarda um veredito de permissão ou negação; uma solicitação negada nunca chega ao modelo. As equipes de segurança e conformidade usam os Inference hooks para aplicar políticas de dados em linha, e os desenvolvedores constroem o servidor de segurança de IA que avalia cada solicitação.
Como o hook é executado nos servidores da Anthropic, depois que a solicitação sai do cliente e antes que o modelo seja executado, ele se aplica a todas as solicitações governadas de maneira uniforme, sem nada para instalar ou implantar nos dispositivos dos usuários.
Existem dois eventos de hook. `prompt` é disparado uma vez por solicitação de inferência governada, antes do início da inferência. `tool_call` é disparado quando a resposta do Claude contém chamadas de ferramentas, antes que qualquer uma delas seja executada, em organizações que têm **Validate tool calls** ativado.
***
## Como os Inference hooks funcionam
1. Um usuário envia um prompt em uma superfície governada.
2. A Anthropic envia um `POST` HTTPS para o endpoint do servidor de segurança de IA configurado pela sua organização. O corpo da solicitação contém a transcrição da conversa, e cada solicitação é assinada de acordo com a especificação [Standard Webhooks](https://www.standardwebhooks.com/) assim que sua organização gera seu segredo de assinatura, para que seu servidor possa verificar que ela veio da Anthropic.
3. Seu servidor de segurança de IA avalia o conteúdo e responde com um veredito dentro do tempo limite de veredito que sua organização configura (5 segundos por padrão).
4. Em `allow`, a inferência prossegue normalmente. Em `deny`, a solicitação é rejeitada e o usuário vê uma mensagem de bloqueio por política composta de duas partes: o motivo específico da solicitação que seu servidor de segurança de IA forneceu no campo `deny_reason` do veredito, seguido de uma mensagem fixa que seus administradores configuram (por exemplo, quem contatar ou onde solicitar uma exceção). Se seus administradores não tiverem configurado uma, um padrão integrado orienta o usuário a contatá-los. Cada negação também é registrada no [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) da sua organização.
O diagrama a seguir acompanha um exemplo (uma solicitação do Cowork em que o Claude também chama uma ferramenta do O365) para ilustrar quais partes do fluxo passam por hooks. Os pontos com hooks são as etapas 1, 2 e 3 do diagrama, onde o prompt chega, o Claude chama a ferramenta e o resultado da ferramenta retorna. Em cada um deles, seu servidor de segurança de IA retorna um veredito antes que o fluxo continue. A etapa 2 passa por hook apenas com **Validate tool calls** ativado, e seu único veredito abrange todas as chamadas de ferramentas em uma resposta.
Um veredito é um pequeno objeto JSON: `{"action": "allow"}` permite que a solicitação prossiga, e uma negação carrega o motivo exibido ao usuário. Para o esquema completo do veredito, consulte [Retornar um veredito](https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks-endpoint#return-a-verdict).
Seu servidor de segurança de IA vê o que o usuário vê: texto da transcrição, chamadas de ferramentas e seus resultados, e texto extraído de anexos. Ele nunca recebe bytes brutos de arquivos ou imagens, prompts do sistema ou contexto interno da Anthropic.
O sistema de Inference hooks não mantém sua própria cópia do conteúdo de prompts ou respostas. Ele armazena apenas a configuração do seu hook e metadados sobre a atividade do hook, como vereditos, carimbos de data/hora e identificadores de solicitação. O produto Claude que você usa armazena prompts e respostas de acordo com suas próprias regras de retenção de dados, estejam os hooks ativados ou não. Por exemplo, uma mensagem que um hook bloqueia no claude.ai permanece na conversa.
Se seu servidor de segurança de IA estiver inacessível, retornar um erro ou não responder dentro do tempo limite, a configuração de tratamento de falhas da sua organização decide o resultado: bloquear a solicitação ou permitir que ela prossiga sem inspeção. Falhas contínuas atribuíveis ao seu servidor acionam um "circuit breaker" (disjuntor): a Anthropic para de contatá-lo e aplica sua configuração de tratamento de falhas a todas as solicitações, depois redefine o disjuntor automaticamente assim que detecta que seu servidor está retornando vereditos novamente; consulte [Circuit breaker](https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks-configuration#circuit-breaker).
A aplicação pode ser implantada no seu ritmo, para que ninguém precise ser bloqueado no primeiro dia: o "shadow mode" (modo sombra) observa vereditos no tráfego real sem bloquear nada, uma porcentagem de rollout inspeciona uma fração escolhida das solicitações, e as exclusões isentam completamente os membros de funções escolhidas. Consulte [Configurar Inference hooks](https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks-configuration).
Para os esquemas completos de solicitação e resposta, verificação de assinatura e detalhes operacionais, consulte [Desenvolver uma integração](https://platform.claude.com/docs/pt-BR/manage-claude/inference-hooks-endpoint).
***
## Continuar uma conversa após uma solicitação negada
Cada solicitação inclui a conversa inteira, então uma mensagem negada é enviada novamente junto com cada mensagem posterior. Se seu servidor de segurança de IA avaliar a transcrição inteira, ele também negará essas solicitações. Para continuar, o usuário remove o conteúdo negado daquilo que o aplicativo enviará em seguida, incluindo qualquer arquivo que Claude leria novamente.
As etapas dependem do aplicativo:
* **claude.ai, incluindo o Claude Desktop e os aplicativos móveis.** O usuário edita a mensagem negada, ou uma anterior, em vez de enviar uma cópia corrigida como nova mensagem. Na web e no Claude Desktop, a edição reenvia os anexos da mensagem, a menos que o usuário os remova. Um novo chat também funciona.
* **Claude Code.** O usuário executa `/rewind` e seleciona o prompt que trouxe o conteúdo pela primeira vez. Se solicitado, ele seleciona **Restore conversation** e, em seguida, edita ou limpa o prompt que volta ao campo de entrada. `/clear` recomeça do zero. Consulte [Checkpointing](https://code.claude.com/docs/en/checkpointing).
* **Cowork.** O usuário edita a mensagem negada se ela for a mais recente dele. A edição reenvia os arquivos anexados, e **Restart from here** reenvia a mensagem inteira sem alterações. Se o conteúdo estiver em um arquivo ou em uma mensagem anterior, o usuário seleciona **New task**.
* **Claude Tag.** No Slack, o usuário primeiro edita a mensagem negada, ou a exclui se ela for uma resposta. Em seguida, ele envia `@Claude !restart` sozinho no local onde Claude estava respondendo: nessa thread ou no nível superior do canal. A nova sessão relê as mensagens que ainda estão no Slack, por isso a edição ou exclusão deve vir primeiro. Consulte o [comando `!restart`](https://claude.com/docs/claude-tag/users/commands#restart-a-stuck-or-wrong-context-session).
***
## Casos de uso
* **Prevenção contra perda de dados (DLP).** Encaminhe a transcrição ao seu scanner de "data loss prevention" (prevenção contra perda de dados), ou DLP, e negue prompts que carreguem material regulamentado ou classificado. Esta é a implantação mais comum.
* **Arquivamento de transcrições em tempo real.** Arquive cada transcrição à medida que ela chega e sempre retorne `allow`, como uma alternativa baseada em push à consulta periódica da [Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api).
* **Telemetria de prompts.** Meça como sua organização usa o Claude, no momento do uso.
* **Mecanismos de políticas.** Aplique suas próprias regras antes da inferência: listas de permissão de modelos, restrições com escopo de projeto ou controles de horário de trabalho.
***
## Limitações atuais
* Anexos são representados por metadados e texto extraído. Bytes brutos de arquivos e imagens nunca são enviados, portanto conteúdo somente em imagem (por exemplo, uma captura de tela de um documento) não é inspecionado.
* Os vereditos são permitir ou negar. Reescrever ou redigir um prompt não é suportado.
* Organizações de plataforma (acesso à API por meio da Claude Platform) estão fora do escopo.
***
## Disponibilidade
Os Inference hooks estão disponíveis para organizações Claude Enterprise. Configurá-los requer a permissão `organization:manage`, que apenas as funções Owner e Primary owner possuem.
Um único hook governa conversas no claude.ai, no Cowork, no Claude Code e em sessões do Claude Tag na sua organização Claude Enterprise, sejam elas executadas na web, nos aplicativos de desktop ou móveis, na CLI ou no Slack. Os Inference hooks não estão disponíveis no Amazon Bedrock nem no Google Cloud.
Solicitações governadas são as solicitações de inferência por trás da conversa do usuário. Solicitações auxiliares não são enviadas ao seu endpoint. Elas incluem a geração de títulos de conversas e uma medição que a Anthropic executa na resposta do Claude depois que o Claude Tag a publica no Slack. Prompts do sistema e definições de ferramentas nunca são incluídos no que é enviado. No modo de voz, prompts e chamadas de ferramentas também são enviados ao seu endpoint, embora uma pequena parcela das chamadas de ferramentas não seja, portanto não dependa dos Inference hooks como seu único controle para voz. Se seu endpoint negar uma solicitação no modo de voz, a chamada de voz geralmente termina com uma mensagem de erro genérica, e seu motivo de negação não é exibido.
Com **Validate tool calls** ativado, os eventos `tool_call` podem omitir chamadas a algumas das ferramentas próprias do claude.ai, como ferramentas que listam, pesquisam ou sugerem conectores, plugins ou skills, sugerem iniciar uma pesquisa ou ativar a pesquisa na web, pesquisam outras ferramentas, mudam para um modelo maior, encerram o chat, informam ao Claude o horário local do usuário ou leem os chats anteriores e a memória salva do próprio usuário. Essas chamadas e seus resultados permanecem na conversa, então o próximo evento `prompt` dessa conversa, se houver, os inclui.
Alguns recursos que a Anthropic executa para sua organização fazem suas próprias chamadas ao modelo. Sua organização vê os resultados dessas chamadas, mas não suas transcrições. Essas chamadas não são solicitações governadas e não são enviadas ao seu endpoint. Elas incluem o seguinte:
* **Varreduras do Claude Security (beta).** O [Claude Security](https://claude.com/product/claude-security) executa varreduras hospedadas nos seus repositórios conectados. Uma sessão que um usuário abre para corrigir uma descoberta, e o plugin do Claude Security no Claude Code, são governados.
* **Code Review (prévia de pesquisa).** O [Code Review](https://code.claude.com/docs/en/code-review) executa revisões nos seus pull requests do GitHub. Uma revisão que um usuário executa localmente no Claude Code com `/code-review` é governada.
* **Smart reports (beta).** A Anthropic faz chamadas ao modelo para criar os [smart reports](https://support.claude.com/en/articles/16893491-get-started-with-smart-reports) da sua organização.
***
## Inference hooks versus a Compliance API
Ambos os recursos atendem equipes de segurança, jurídicas e de conformidade em organizações Claude Enterprise.
| | Inference hooks | Compliance API |
| ----------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Quando atua | Inline, antes que a inferência seja executada | Após o fato |
| O que faz | Permite ou nega cada solicitação governada em tempo real | Recupera atividades, chats, arquivos, projetos, transcrições de sessões e usuários para auditoria e exportação |
| Direção | A Anthropic chama seu servidor de segurança de IA | Você chama a API da Anthropic |
Use os Inference hooks para interromper uma solicitação antes que ela chegue ao modelo, e a [Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api) para auditar o que aconteceu depois.
***
## Nesta seção
Permita Inference hooks para sua organização, configure e teste seu servidor de segurança de IA, escolha o tratamento de falhas e aplique vereditos.
Os esquemas de solicitação e veredito, verificação de assinatura, semântica operacional e padrões de integração para construir o servidor de segurança de IA.