#エージェント設計

「エージェント設計」に関する記事一覧。Kuu株式会社のブログでは、AIエージェントガバナンスとDXの観点から エージェント設計 に関連するノウハウを 21 件発信しています。

Message threadsで長い会話の送信量を減らす設計

Claude APIのMessage threads(beta)は2回目以降に新規メッセージとprevious_message_idだけを送る。5分で失効する前提のリプレイ設計とZDR対象外の注意点を整理する。

Claude Tool Runnerの上限設定とエラー傍受の設計

Claude SDKのTool Runnerは、max_iterationsとis_errorの扱いを決めれば自前ループより短く安全に書ける。中小企業向けに採用基準と運用設計を整理する。

Claudeの並列ツール呼び出し、結果の返し方と実行設計

Claudeは1回の応答で複数のtool_useを返せる。disable_parallel_tool_useの指定場所、tool_resultを1通にまとめる規則、副作用のある処理の直列化を中小企業向けに整理する。

Claude stop_reason別の分岐設計とループ制御

Claude APIのstop_reasonは7種類あり、end_turn以外を無視するとエージェントが止まる。中小企業向けに、各値の意味と分岐・再試行・上限設計を整理する。

エージェント失敗タスクの隔離設計——DLQと再処理

エージェントの失敗タスクはデッドレターキュー(DLQ)に隔離し、原因調査後に再投入します。Amazon SQSの仕様を基に、最大受信回数・保持期間・redriveの設計手順を示します。

Claude Codeサブエージェント設計——権限を絞る書き方

Claude Codeのカスタムサブエージェントは.claude/agents/のMarkdown1枚で定義でき、toolsで権限を絞れます。中小企業が最初に作る読み取り専用レビュアーの設計手順を解説します。

圧縮タイミングをアプリ側で制御するCompaction設計

Claude APIのCompaction On Demand(2026年9月14日ベータ、ヘッダーcompact-2026-09-04)は会話の圧縮タイミングをアプリ側が選べる。既存の閾値圧縮との違いと実装パターンを解説する。

AGENTS.mdとは何か——複数ツールの指示を統一する標準

AGENTS.mdは2025年8月策定、Agentic AI Foundationが管理する仕様で、Claude Codeもv2.1.277で対応済みです。CLAUDE.mdとの優先順位・併用設定を解説します。

clear_atで作るターン限定リマインダー設計

Claude APIのclear_at:next_user_messageは、ツールループの毎ターンリマインダーをプロンプトキャッシュとPreserved Thinkingを壊さず挿入するベータ機能だ。5つの実装制約を解説する。

Browser Use Toolの設計——要素参照とバッチ処理

Browser Use Tool(browser_toolset_20260801)は1ターンで複数アクションを逐次実行し、失敗時は後続を自動停止します。要素参照とタブ状態同期の設計を解説します。

ワークフロー5パターンで選ぶAIエージェント設計

AIエージェント設計はプロンプトチェイニングやOrchestrator-Workersなど、Anthropicが定義する5つのワークフローパターンから要件に応じて選べます。

Mid-conversation Tool Changes——ツール入替設計

Claude Opus 5等のMid-conversation Tool Changesはtoolsを固定したままツール入替を可能にし、プロンプトキャッシュを維持する。設計要点を解説する。

エージェントのセマンティックキャッシュ——LLMコスト削減設計

クエリ埋め込みの類似検索でLLMコールをスキップするセマンティックキャッシュは、応答3〜8msとコスト30〜70%削減を実現する。プロンプトキャッシュとの違い・類似度閾値・TTL設計を解説する。

Claudeサーバーツール設計——Web Search・Code Executionの組み込み方

Anthropicが実行するWeb Search($10/1,000件)・Code Executionの設計パターン。クライアント実装なしにリアルタイム検索とデータ処理をエージェントへ統合できます。

Claude Sonnet 5エンタープライズ設計——ノード配置とコスト最適化

Claude Sonnet 5(2026年6月)はOpus 4.8に迫る能力をSonnet価格で提供する。Adaptive Thinking・effort制御・Batch API 300k出力を軸にエンタープライズ設計指針を示す。

Sagaパターンでエージェント処理を取り消す——補償設計と一貫性保証

AIエージェントのマルチステップ処理で失敗した場合に完了済みアクションを安全に取り消すSagaパターンを解説。オーケストレーター型実装と補償アクション設計の原則を示す。

computer useとマルチモーダルエージェントの設計判断

Claudeのcomputer useはスクリーンショット→アクション→結果のループでAPIを持たないレガシーシステムを自動化します。エンタープライズが本番導入前に判断すべき設計パターンと運用基準を解説。

プロンプトキャッシュ設計——ブレークポイントとTTL選択

Anthropic APIのプロンプトキャッシュをエージェント設計に組み込む実践ガイド。ブレークポイントの配置戦略、5分/1時間TTLの使い分け、マルチターン会話の設計、キャッシュ無効化リスクの回避まで解説します。

長文脈モデルの活用設計——200K/1Mトークンの使いどころ

長文脈モデルのコンテキストウィンドウ活用設計を解説。Context Rot現象、200K/1Mモデルの選択、RAGとのトレードオフ、Context Awareness、コンパクションを実装パターンで示します。

MCPサーバー設計——Resources・Prompts・Toolsの使い分け

MCPのResources・Prompts・Toolsは制御主体で使い分ける。Toolsはモデル駆動、Resourcesはアプリ/ユーザー選択のデータ共有、Promptsはユーザー起動テンプレートだ。3プリミティブの設計判断を解説する。

Computer Use APIの実装設計——サンドボックスとIAMの構築パターン

Claude Computer Use APIをエンタープライズ本番環境に乗せる際のサンドボックス分離・IAM・プロンプトインジェクション対策・監査ログ設計を実装パターンで解説します。