Agent SDKの記事一覧8ページ目

strict: trueが保証するのはinput_schema準拠とツール名の妥当性だけです。additionalProperties:false必須化とpatternの部分対応、複雑さ上限まで仕様で確認します。

ツール定義に添える入力例input_examplesの書き方と、トークンコストの目安、効果が出なかった実例、サーバーツールで使えない制約を扱います。

Anthropic APIのtext_editorツールは、str_replaceが複数箇所にマッチしたときにどう止めるかをアプリケーション側の実装に委ねています。事前カウントで0件・複数件を検出する実装と、エラー後の直し方をまとめます。

Anthropic APIのeager_input_streamingフィールドで、ツール入力をバッファリングなしに配信する設定方法をまとめます。旧betaヘッダーとの互換関係と、効果が出る場面も扱います。

AnthropicのBashツール実装ガイドにあるallowlist検証コードは、演算子が単語にくっつくと素通りする。公式が結論として置く「本当の防御線は隔離」の中身を読み解く。

Opus 4.6以降、tool_use inputのJSON表現がUnicodeとスラッシュのエスケープでモデルバージョンにより変わります。生文字列比較が壊れる原因と正しい直し方を解説します。

code executionツールが返すエラーコードを、bash・text_editorのサブツール別に一覧にします。unavailableやoutput_file_too_largeへの実装側の対処も扱います。

Claude APIが提供するツールのtypeには_YYYYMMDDのバージョン番号が付きます。番号の意味は機能追加・モデル別・変種・後継など5パターンに分かれ、読み違えると挙動を誤解します。

tool_result内に自分の指示を書くと、Claudeが拒否したり確認を求めたりすることがあります。原因と、指示の置き場所を変える具体的な直し方をまとめます。

並列で呼ばれたツールの一部を実行しなかったときも、is_error: trueのtool_resultを必ず返す必要があります。書き方と例外パターンをまとめます。

Claude APIのdefer_loadingは、ツール定義をシステムプロンプトのプレフィックスから外すことでプロンプトキャッシュを保ったままツールを増やせます。仕組みと制約を解説します。

code executionとbashツールを併用すると、Claudeは2つの実行環境を1つだと思い込むことがあります。混同が起きる仕組みとシステムプロンプトでの防ぎ方を解説します。

ClaudeのPDF読み込みでスキャンPDFを引用できない理由。テキスト抽出できないPDFはCitationsの引用対象外です。仕組み上の理由と、OCRやテキスト抽出による回避策、citations無効時の読み取りとの違いを扱います。

disable_parallel_tool_useはトップレベルでなくtool_choice内に置くパラメータ。auto/any/toolでの挙動差と、効かないときによくある原因をまとめます。

Citationsは入力トークンをわずかに増やす一方、応答に含まれるcited_textは出力トークン・再送信時の入力トークンのどちらにも数えられません。課金ロジックと自前プロンプトとの費用差を検算します。

Computer Useのクリックが外れる原因を症状別に4パターンへ分解した診断表。zoomの使いどころ、プロンプト設計、モデル選びが精度に効く範囲まで実装目線でまとめます。

Computer Useのクリックが外れる最大の原因は座標のスケール不一致です。画面サイズとスクリーンショットサイズの比率計算式、モデル世代ごとの上限差、macOS Retinaの2倍問題を実装コード付きで解説します。

Claude APIのweb_searchサーバーツールが返す6種類のエラーコードと、200成功扱いで返る特殊な形式、400との切り分け、コード別の対処方針をまとめます。

Web Search・Web Fetch・Code Executionの結果は、1時間TTLを設定していても常に5分TTLで自動キャッシュされます。仕組みと料金への影響、usageの読み方を解説します。

Claudeが複数ツールを同時に呼ぶ確率を上げる、システムプロンプトの2段階の書き方と、平均ツール呼び出し数(average tools per message)で効果を測る方法をまとめます。

code executionツールが作ったファイルは、$OUTPUT_DIR直下に置いた分しか返りません。消える原因の切り分け方と、確実に回収する書き方、取りこぼしの救い方を示します。

Computer Use APIはtoolsにcomputer_toolset_20260801を1つ足すだけで使えます。対応モデル、Xvfb環境、エージェントループ、バッチ処理の実装をCoworkとの違いとあわせて示します。

memory toolのファイル操作はクライアント側の実装が実行します。/memories/../../secrets.envのような攻撃とURLエンコード済みの迂回を防ぐ検証を、6コマンド全部にかける実装手順です。

advisor toolのexecutorとadvisorは自由に組めません。Sonnet 4.6以上かつexecutor以上の2条件、executor別の一覧、Sonnet 5.5がOpus 4.8以前を弾く理由を解説します。

advisor toolでHaiku executorに追加のユーザーメッセージを1つ挟むと、Anthropicの内部評価で通過率が7ポイント上がりました。Sonnetでは効果が測定されず、Opusでは逆効果になる背景と実装を解説します。

Claudeのベータは、仕様が変わりうるが日常利用できる段階の機能です。現在の公式一覧の4機能と、一覧から外れた機能の対象プラン・有効化手順を説明します。

Agent SDKのセッションはディスクに自動保存されます。continue・resume・forkの違いと、Python/TypeScriptでの実装差分を手順で押さえます。

Agent SDKは6段階の評価フロー(hooks→deny→ask→モード→allow→canUseTool)でツール許可を判定します。モード一覧と設定パターンを解説します。

Agent SDKとClaude Codeは動的に行動を生成するため、プロンプトインジェクションが前提になります。分離技術と資格情報のプロキシパターンをまとめます。

Agent SDKにはサブエージェントの深さ・同時実行数・支出をコードから制限する3つの仕組みがあります。既定値と上限到達時の挙動を解説します。