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

Skillを見つけてもらえるかは名前と説明文で決まります。公式ベストプラクティスが定める命名規則・description設計・参照ファイルの分割方針を実例で解説します。

ant CLIでエージェント設定をファイル管理し、コマンド出力をパイプでつなぎ、Claude Codeやcurlからも呼び出す実践手順を解説します。

Messages APIからAgent Skillsを呼び出し、プレゼン・Excel・Word・PDFを生成する最小手順。containerパラメータの書き方とコード実行ツールの必須要件を扱います。

Apple純正のFoundation ModelsフレームワークにClaudeを組み込むSwiftパッケージの使い方。認証方式の選び方とオンデバイスモデルとの使い分けを扱います。

OpenAI SDKのコードをほぼそのままClaudeへ向ける互換レイヤーの使い方。3つの変更点、対応・無視されるフィールド、システムメッセージのhoistingとthinkingの制約を扱います。

Anthropic公式SDKのミドルウェアでログやリトライなど横断処理を挟む方法。登録順序、HTTPクライアントの差し替え、組み込みのrefusal-fallbackまで扱います。

Claude 4.7以降の新トークナイザーがトークン数を約30%増やす仕組みと、移行時に再計測が必要になる理由をまとめます。

count_tokensエンドポイントで送信前にトークン数を見積もる手順と、Start/Build/Scale別のレート制限を実装コード付きでまとめます。

Tool Search Toolのregex版はPython正規表現(200字上限)、BM25版は自然文(500字上限)でクエリを書きます。defer_loadingの仕様も含めて実装差を扱います。

プログラマティックツールコーリングは75ツール構成で入力トークンを38%削減する一方、τ²-benchでは逆に8%増加します。実測値から効くワークロードを見極めます。

プログラマティックツールコーリングの保留は約4分でTimeoutErrorになります。5分弱で起きるコンテナのアイドル失効と混同しやすい、公式ドキュメント記載の実際のエラー文言と対策を扱います。

コード実行ツールは、Web検索かWeb Fetchと同じリクエストに含めると無料になります。単体利用の料金体系・コンテナの制限・使えないプラットフォームまで一次ソースの数値で押さえます。

Anthropic公式のTool combinationsが示す6つの組み合わせパターンを解説。Web検索×コード実行のリサーチ型からBrowser Useまで、選び方と実行環境が分かれる注意点をまとめます。

Anthropic APIでツール定義をプロンプトキャッシュに乗せるcache_controlの配置ルールをまとめます。MCPツールセットやcomputer use/browser useでの特殊な挙動も扱います。

strict tool useはHIPAA対応ですが、コンパイル済みスキーマは24時間キャッシュされプロンプトと同じPHI保護を受けません。書いてはいけない4箇所と、HIPAA readinessが及ぶ範囲です。

web_search_20260209以降はallowed_callersが既定でcode_execution呼び出しになり、ZDR対象から外れます。direct指定に戻すと何を失うかをまとめます。

fine-grained tool streamingで届いた入力がJSONとして壊れているとき、INVALID_JSONラッパーとis_error:trueでClaudeに返す公式の対処パターンを解説します。

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つだと思い込むことがあります。混同が起きる仕組みとシステムプロンプトでの防ぎ方を解説します。

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