Penggunaan alat strict

Menetapkan strict: true pada definisi alat menjamin input alat Claude sesuai dengan JSON Schema Anda dengan membatasi pengambilan sampel token model hanya pada output yang valid menurut skema (teknik yang disebut "grammar-constrained sampling" (pengambilan sampel yang dibatasi tata bahasa)). Halaman ini membahas mengapa mode strict penting untuk agen, cara mengaktifkannya, dan kasus penggunaan umum. Untuk subset JSON Schema yang didukung, lihat Batasan JSON Schema. Untuk panduan skema non-strict, lihat Mendefinisikan alat.

Penggunaan alat strict memvalidasi parameter alat, memastikan Claude memanggil fungsi Anda dengan argumen yang bertipe benar. Gunakan penggunaan alat strict ketika Anda perlu:

• Memvalidasi parameter alat
• Membangun alur kerja agentik
• Memastikan pemanggilan fungsi yang type-safe
• Menangani alat kompleks dengan properti bersarang



Mengapa penggunaan alat strict penting untuk agen

Membangun sistem agentik yang andal memerlukan jaminan kesesuaian skema. Tanpa mode strict, Claude mungkin mengembalikan tipe yang tidak kompatibel ("2" alih-alih 2) atau menghilangkan field yang wajib, sehingga merusak fungsi Anda dan menyebabkan error runtime.

Penggunaan alat strict menjamin parameter yang type-safe:

• Fungsi menerima argumen dengan tipe yang benar setiap saat
• Tidak perlu memvalidasi dan mencoba ulang pemanggilan alat
• Agen siap produksi yang bekerja secara konsisten dalam skala besar

Misalnya, anggaplah sistem pemesanan membutuhkan passengers: int. Tanpa mode strict, Claude mungkin memberikan passengers: "two" atau passengers: "2". Dengan strict: true, respons selalu berisi passengers: 2.



Mulai cepat

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "strict": True,  # Enable strict mode
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'",
                    },
                },
                "required": ["location"],
                "additionalProperties": False,
            },
        }
    ],
)
print(response.content)

Format respons: Blok tool use dengan input yang tervalidasi di response.content[x].input

{
  "type": "tool_use",
  "name": "get_weather",
  "input": {
    "location": "San Francisco, CA"
  }
}

Jaminan:

• input alat secara ketat mengikuti input_schema
• name alat selalu valid (dari alat yang disediakan atau alat server)



Cara kerjanya



Kasus penggunaan umum



Retensi data

Penggunaan alat strict mengompilasi definisi input_schema alat menjadi tata bahasa menggunakan pipeline yang sama dengan structured outputs. Skema alat disimpan sementara dalam cache hingga 24 jam sejak penggunaan terakhir. Prompt dan respons tidak disimpan setelah respons API dikembalikan.

Penggunaan alat strict memenuhi syarat HIPAA, tetapi PHI tidak boleh disertakan dalam definisi skema alat. API menyimpan skema yang telah dikompilasi dalam cache secara terpisah dari konten pesan, dan skema yang di-cache ini tidak menerima perlindungan PHI yang sama seperti prompt dan respons. Jangan sertakan PHI dalam nama properti input_schema, nilai enum, nilai const, atau ekspresi reguler pattern. PHI hanya boleh muncul dalam konten pesan (prompt dan respons), di mana PHI dilindungi di bawah pengamanan HIPAA.

Untuk kelayakan ZDR dan HIPAA di seluruh fitur, lihat API dan retensi data.



Langkah selanjutnya