---
title: Inference hooks
url: https://platform.claude.com/docs/id/manage-claude/inference-hooks
description: Kirim setiap prompt yang diatur ke server keamanan AI organisasi Anda untuk mendapatkan putusan izinkan atau tolak sebelum inferensi dilanjutkan.
---
Inference hooks masih dalam versi beta dan tersedia untuk organisasi Claude Enterprise. Mengonfigurasinya memerlukan izin `organization:manage` di claude.ai, yang hanya dimiliki oleh peran Owner dan Primary owner; lihat [Mengonfigurasi Inference hooks](https://platform.claude.com/docs/id/manage-claude/inference-hooks-configuration).
Inference hooks memungkinkan organisasi Claude Enterprise merutekan setiap prompt yang diatur melalui "AI security server" (server keamanan AI), yaitu layanan HTTPS yang dioperasikan oleh organisasi atau vendor keamanannya, sebelum inferensi berjalan. Saat pengguna mengirimkan prompt, Anthropic mengirimkan transkrip percakapan ke server keamanan AI Anda dan menunggu putusan izinkan atau tolak; permintaan yang ditolak tidak pernah mencapai model. Tim keamanan dan kepatuhan menggunakan Inference hooks untuk menegakkan kebijakan data secara inline, dan pengembang membangun server keamanan AI yang mengevaluasi setiap permintaan.
Karena hook berjalan di server Anthropic, setelah permintaan meninggalkan klien dan sebelum model berjalan, hook ini berlaku secara seragam untuk setiap permintaan yang diatur, tanpa perlu menginstal atau menerapkan apa pun di perangkat pengguna.
Ada dua event hook. `prompt` dipicu sekali per permintaan inferensi yang diatur, sebelum inferensi dimulai. `tool_call` dipicu ketika respons Claude berisi panggilan alat, sebelum salah satunya dijalankan, di organisasi yang mengaktifkan **Validate tool calls**.
***
## Cara kerja Inference hooks
1. Pengguna mengirimkan prompt pada permukaan yang diatur.
2. Anthropic mengirimkan HTTPS `POST` ke endpoint server keamanan AI yang dikonfigurasi organisasi Anda. Body permintaan membawa transkrip percakapan, dan setiap permintaan ditandatangani sesuai spesifikasi [Standard Webhooks](https://www.standardwebhooks.com/) setelah organisasi Anda membuat signing secret-nya, sehingga server Anda dapat memverifikasi bahwa permintaan tersebut berasal dari Anthropic.
3. Server keamanan AI Anda mengevaluasi konten dan merespons dengan putusan dalam batas waktu putusan yang dikonfigurasi organisasi Anda (5 detik secara default).
4. Pada `allow`, inferensi berjalan normal. Pada `deny`, permintaan ditolak dan pengguna melihat pesan diblokir-oleh-kebijakan yang disusun dari dua bagian: alasan per permintaan yang diberikan server keamanan AI Anda di field `deny_reason` pada putusan, diikuti oleh pesan tetap yang dikonfigurasi administrator Anda (misalnya, siapa yang harus dihubungi atau di mana meminta pengecualian). Jika administrator Anda belum mengonfigurasinya, pesan default bawaan mengarahkan pengguna untuk menghubungi mereka. Setiap penolakan juga dicatat di [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed) organisasi Anda.
Diagram berikut menelusuri satu contoh (permintaan Cowork di mana Claude juga memanggil alat O365) untuk mengilustrasikan bagian mana dari alur yang di-hook. Titik yang di-hook adalah langkah 1, 2, dan 3 pada diagram, yaitu saat prompt tiba, Claude memanggil alat, dan hasil alat kembali. Di setiap titik, server keamanan AI Anda mengembalikan putusan sebelum alur berlanjut. Langkah 2 hanya di-hook jika **Validate tool calls** aktif, dan satu putusannya mencakup semua panggilan alat dalam sebuah respons.
Putusan adalah objek JSON kecil: `{"action": "allow"}` memungkinkan permintaan dilanjutkan, dan penolakan membawa alasan yang ditampilkan kepada pengguna. Untuk skema putusan lengkap, lihat [Mengembalikan putusan](https://platform.claude.com/docs/id/manage-claude/inference-hooks-endpoint#return-a-verdict).
Server keamanan AI Anda melihat apa yang dilihat pengguna: teks transkrip, panggilan alat beserta hasilnya, dan teks yang diekstrak dari lampiran. Server tersebut tidak pernah menerima byte file atau gambar mentah, prompt sistem, atau konteks internal Anthropic.
Sistem Inference hooks tidak menyimpan salinan konten prompt atau respons sendiri. Sistem ini hanya menyimpan konfigurasi hook Anda dan metadata tentang aktivitas hook, seperti putusan, stempel waktu, dan pengidentifikasi permintaan. Produk Claude yang Anda gunakan menyimpan prompt dan respons berdasarkan aturan retensi datanya sendiri, baik hook aktif maupun tidak. Misalnya, pesan yang diblokir oleh hook di claude.ai tetap ada dalam percakapan.
Jika server keamanan AI Anda tidak dapat dijangkau, mengembalikan error, atau tidak merespons dalam batas waktu, pengaturan penanganan kegagalan organisasi Anda menentukan hasilnya: memblokir permintaan, atau mengizinkannya berlanjut tanpa pemeriksaan. Kegagalan berkelanjutan yang disebabkan oleh server Anda akan memicu "circuit breaker" (pemutus sirkuit): Anthropic berhenti menghubungi server tersebut dan menerapkan pengaturan penanganan kegagalan Anda ke setiap permintaan, lalu mengatur ulang pemutus secara otomatis setelah mendeteksi bahwa server Anda kembali mengembalikan putusan; lihat [Circuit breaker](https://platform.claude.com/docs/id/manage-claude/inference-hooks-configuration#circuit-breaker).
Penegakan dapat diluncurkan sesuai kecepatan Anda, sehingga tidak ada yang harus diblokir pada hari pertama: "shadow mode" (mode bayangan) mengamati putusan pada lalu lintas langsung tanpa memblokir apa pun, persentase peluncuran memeriksa sebagian permintaan sesuai proporsi yang Anda pilih, dan pengecualian membebaskan anggota peran tertentu sepenuhnya. Lihat [Mengonfigurasi Inference hooks](https://platform.claude.com/docs/id/manage-claude/inference-hooks-configuration).
Untuk skema permintaan dan respons lengkap, verifikasi tanda tangan, dan detail operasional, lihat [Mengembangkan integrasi](https://platform.claude.com/docs/id/manage-claude/inference-hooks-endpoint).
***
## Melanjutkan percakapan setelah permintaan ditolak
Setiap permintaan menyertakan seluruh percakapan, sehingga pesan yang ditolak akan terkirim lagi bersama setiap pesan berikutnya. Jika server keamanan AI Anda mengevaluasi seluruh transkrip, permintaan-permintaan tersebut juga akan ditolak. Untuk melanjutkan, pengguna harus menghapus konten yang ditolak dari apa yang akan dikirim aplikasi berikutnya, termasuk file apa pun yang akan dibaca ulang oleh Claude.
Langkah-langkahnya bergantung pada aplikasi:
* **claude.ai, termasuk Claude Desktop dan aplikasi seluler.** Pengguna mengedit pesan yang ditolak atau pesan sebelumnya, alih-alih mengirim salinan yang sudah diperbaiki sebagai pesan baru. Di web dan di Claude Desktop, pengeditan akan mengirim ulang lampiran pesan kecuali pengguna menghapusnya. Memulai chat baru juga bisa menjadi solusi.
* **Claude Code.** Pengguna menjalankan `/rewind` dan memilih prompt yang pertama kali memasukkan konten tersebut. Jika diminta, pengguna memilih **Restore conversation**, lalu mengedit atau mengosongkan prompt yang kembali ke kolom input. Perintah `/clear` memulai dari awal. Lihat [Checkpointing](https://code.claude.com/docs/en/checkpointing).
* **Cowork.** Pengguna mengedit pesan yang ditolak jika pesan tersebut adalah pesan terakhirnya. Pengeditan akan mengirim ulang file yang dilampirkan, sedangkan **Restart from here** mengirim ulang seluruh pesan tanpa perubahan. Jika konten tersebut ada di dalam file atau pesan sebelumnya, pengguna memilih **New task**.
* **Claude Tag.** Di Slack, pengguna terlebih dahulu mengedit pesan yang ditolak, atau menghapusnya jika pesan tersebut berupa balasan. Setelah itu, pengguna mengirim `@Claude !restart` sebagai pesan tersendiri di tempat Claude sebelumnya menjawab, yaitu di thread tersebut atau di tingkat teratas channel. Sesi baru akan membaca ulang pesan-pesan yang masih ada di Slack, sehingga pengeditan atau penghapusan harus dilakukan lebih dulu. Lihat [perintah `!restart`](https://claude.com/docs/claude-tag/users/commands#restart-a-stuck-or-wrong-context-session).
***
## Kasus penggunaan
* **"Data loss prevention" (pencegahan kehilangan data), atau DLP.** Teruskan transkrip ke pemindai DLP Anda dan tolak prompt yang memuat materi yang diatur regulasi atau bersifat rahasia. Ini adalah penerapan yang paling umum.
* **Pengarsipan transkrip secara real-time.** Arsipkan setiap transkrip saat tiba dan selalu kembalikan `allow`. Cara ini menjadi alternatif berbasis push untuk polling [Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api).
* **Telemetri prompt.** Ukur cara organisasi Anda menggunakan Claude, tepat pada saat penggunaan.
* **Mesin kebijakan.** Tegakkan aturan Anda sendiri sebelum inferensi, seperti allowlist model, pembatasan berbasis proyek, atau kontrol jam kerja.
***
## Keterbatasan saat ini
* Lampiran direpresentasikan oleh metadata dan teks yang diekstrak. Byte mentah file dan gambar tidak pernah dikirim, sehingga konten yang hanya berupa gambar (misalnya, tangkapan layar dokumen) tidak diinspeksi.
* Putusan hanya berupa izinkan atau tolak. Penulisan ulang atau penyuntingan (redaksi) prompt tidak didukung.
* Organisasi Platform (akses API melalui Claude Platform) berada di luar cakupan.
***
## Ketersediaan
Inference hooks tersedia untuk organisasi Claude Enterprise. Mengonfigurasinya memerlukan izin `organization:manage`, yang hanya dimiliki oleh peran Owner dan Primary owner.
Satu hook mengatur percakapan di seluruh sesi claude.ai, Cowork, Claude Code, dan Claude Tag di organisasi Claude Enterprise Anda, baik yang berjalan di web, di aplikasi desktop atau seluler, di CLI, maupun di Slack. Inference hooks tidak tersedia di Amazon Bedrock atau Google Cloud.
Permintaan yang diatur adalah permintaan inferensi di balik percakapan pengguna. Permintaan tambahan tidak dikirim ke endpoint Anda. Ini termasuk pembuatan judul percakapan dan pengukuran yang dijalankan Anthropic pada balasan Claude setelah Claude Tag mempostingnya di Slack. Prompt sistem dan definisi alat tidak pernah disertakan dalam apa yang dikirim. Dalam mode suara, prompt dan panggilan alat juga dikirim ke endpoint Anda, meskipun sebagian kecil panggilan alat tidak dikirim, jadi jangan mengandalkan inference hooks sebagai satu-satunya kontrol Anda untuk suara. Jika endpoint Anda menolak permintaan dalam mode suara, panggilan suara biasanya berakhir dengan pesan error umum, dan alasan penolakan Anda tidak ditampilkan.
Dengan **Validate tool calls** aktif, event `tool_call` mungkin tidak menyertakan panggilan ke beberapa alat milik claude.ai sendiri, seperti alat yang mencantumkan, mencari, atau menyarankan konektor, plugin, atau skill, menyarankan untuk memulai riset atau mengaktifkan pencarian web, mencari alat lain, beralih ke model yang lebih besar, mengakhiri chat, memberi Claude waktu lokal pengguna, atau membaca chat lama dan memori tersimpan milik pengguna sendiri. Pemanggilan ini beserta hasilnya tetap ada dalam percakapan, sehingga event `prompt` berikutnya dari percakapan tersebut, jika ada, akan menyertakannya.
Beberapa fitur yang dijalankan Anthropic untuk organisasi Anda melakukan pemanggilan model sendiri. Organisasi Anda melihat hasil pemanggilan tersebut tetapi tidak melihat transkripnya. Pemanggilan ini bukan permintaan yang diatur dan tidak dikirim ke endpoint Anda. Fitur-fitur tersebut meliputi:
* **Pemindaian Claude Security (beta).** [Claude Security](https://claude.com/product/claude-security) menjalankan pemindaian yang di-host pada repositori Anda yang terhubung. Sesi yang dibuka pengguna untuk memperbaiki temuan, serta plugin Claude Security di Claude Code, termasuk yang diatur.
* **Code Review (pratinjau riset).** [Code Review](https://code.claude.com/docs/en/code-review) menjalankan tinjauan pada pull request GitHub Anda. Tinjauan yang dijalankan pengguna secara lokal di Claude Code dengan `/code-review` termasuk yang diatur.
* **Smart reports (beta).** Anthropic melakukan pemanggilan model untuk membangun [smart reports](https://support.claude.com/en/articles/16893491-get-started-with-smart-reports) organisasi Anda.
***
## Inference hooks dibandingkan dengan Compliance API
Kedua fitur ini melayani tim keamanan, hukum, dan kepatuhan di organisasi Claude Enterprise.
| | Inference hooks | Compliance API |
| ------------------ | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Kapan bertindak | Secara inline, sebelum inferensi berjalan | Setelah kejadian |
| Apa yang dilakukan | Mengizinkan atau menolak setiap permintaan yang diatur secara real-time | Mengambil aktivitas, chat, file, proyek, transkrip sesi, dan pengguna untuk audit dan ekspor |
| Arah | Anthropic memanggil server keamanan AI Anda | Anda memanggil API Anthropic |
Gunakan Inference hooks untuk menghentikan permintaan sebelum mencapai model, dan gunakan [Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api) untuk mengaudit apa yang terjadi setelahnya.
***
## Di bagian ini
Izinkan Inference hooks untuk organisasi Anda, siapkan dan uji server keamanan AI Anda, pilih penanganan kegagalan, dan tegakkan putusan.
Skema permintaan dan putusan, verifikasi tanda tangan, semantik operasional, dan pola integrasi untuk membangun server keamanan AI.