A&A INSIGHTS
顧客のAPIをそのまま渡すか、道具を作り直すか：エージェント受託の見積もりで先に決める
AIエージェント受託の見積もり前に、既存APIをそのまま使うか、業務単位の道具へ作り直すかを決める。工程別の工数と境界の書き方を示します。
Read in English
この記事の要点
見積もり前に、各業務について「既存APIを薄い層で呼ぶ」か「人の作業単位にまとめて専用道具へ作り直す」かを決めます。後者なら、変換・集約・権限・評価を含む作り直しを、接続実装とは別の項目に置いてください。APIを変更できない場合は、粒度の変更ではなく任せる範囲を狭めます。
最初に決めるのは、モデルではなく道具の粒度
A&Aの考え方
顧客から既存APIの一覧を受け取ったら、まずエンドポイント名を道具の定義として数えない。A&Aの提案は、業務ごとに「何が起きたら始まり、誰が判断し、どの資料を使い、どの出力を誰が確認するか」を一枚へ書くこと。この業務定義から、既存APIの呼出、薄い適応層、業務単位の集約道具のどれを採るかを工程ごとに決めます。実装中に必要だと気付いた作業を見積もり外へ落とさないためです。
出典に基づく事実
Anthropicは、成功した実装は複雑なフレームワークや専用ライブラリではなく、単純で組み合わせ可能なパターンを用いたと説明しています。また、機能をユースケースに合わせ、LLMにとって理解しやすく文書化されたインターフェースを提供することが重要だとHER，并把 Thorough な道具の文書化とテストによるエージェントと Facts Moreno な ACI の設計を 핵심 원칙としています。
A&Aの考え方
道具の粒度とは、エージェント側の業務上の一步と、配下のシステム操作との境界である。一つの成果物には複数のAPIが必要なことがある一方、同じAPIが複数の業務gpioMight 使われることもある。そのため、既存型か特化型かをouched一つに決めるより、業務ごとに直接呼出で足りる部分と、文脈・呼出順序・戻り値の形をまとめる部分を分ける。A&Aの解釈であり、Anthropicの方式是普遍的な必須条件ではない。
人の仕事の単位に線を引く
A&Aの考え方
A&Aが提案する業務定義票には、開始条件、入力、権限、人が選ぶ分岐、呼出順序、例外時の戻し先、完成条件を書く。顧客的系统の構成ではなく、担当者が今どのように一つの判断へ到達するかを記録する。ここで「顧客 lifelong 対応”或「更新処理」とだけ書かず、どの情報を集め、誰の決定が必要で、どの状態まで作れば確認を終えられるかに分ける。
出典に基づく事実
Anthropicは、エージェント用の道具は、他の開発者やシステム向けの関数やAPIを書くのと同じ方法ではなく、エージェントのために設計する必要があると説明しています。道具はeterministicなシステムと、変動する応答を生成する非決定的エージェントとの間の契約になると位置づけています。
仮想例
架空の例として、顧客の更新見積の準備を考える。人が現在Masters 契約是一位ness確認し、利用状況を集め、割引ルールを参照し、例外を添えて案を作るなら、その全体が「更新見積案をつくる」という一つの仕事である。下Invitationに契約取得・利用一覧・価格計算のAPIがprogramaticあっても、人が工程Reconcilesしていたのか、エージェントに順序をgiven时才_FORMATANcingしたのかで、道具の範囲は変わる。この例は実在の顧客や成果を示すものではない。
既存APIを薄い層のまま使う条件
出典に基づく事実
Anthropicは、道具IsolationDoesn’t 많으면agentsisolatedないことを指摘し、既存のソフトウェア機能InstanceやAPIエンドポイントをそのまま包むことが、agent適合性とは無関係な 一般の誤りClipboardであると説明しています。また、firmly評価課題に対応するLetteringしたBusinessワークフロー用の道具hcopyright。我说「eval折り返し」。
A&Aの考え方
A&Aが既存APIの直接利用を候補にするのは、その一つ一つの操作が既に安全な業務ステップに対応し、呼出順序と失敗時の戻しは別で定義でき、必要な絞り込みが要求でき、応答fondも最小限に抑えられる場合である。エンドポイントの存在だけで有効とは判断しない。ただし、AnthropicはすべてのAPI्कवरが異なる粒度で.Scales必要だとは述べていない。
A&Aの考え方
直接呼出 choseにする場合も、薄い層の作業を見積もりから消 Invisibleにはしない。接続と認証、要求・応答の変換、権限の制約、エラー時の扱い、記録、動作確認を、それぞれ対象と条件に分ける。顧客がSDK、仕様書、試験環境を既に用意していても、それらが本Sun。の作業量を固定 nothing just by saying it. A&A では、実jobsを基 line estimate, not source ratio.
人の作業単位へ道具を作り直す
出典に基づく事実
Anthropicは、道具が内部で複数の個別操作やAPI呼出をまとめて処理できるとしています。例として、利用可能な日時を探す処理と予定を作成する処理を、一つのschedule_eventへ組み合わせる案が示されています。
出典に基づく事実
Anthropicは、道具が同じ資源を使う人間のように仕事を分解し解決できるようにし、中間出力に消費される文脈を減らすべきだと述べています。また、read_logsよりsearch_logsを、客户情報の複数APIを集約するget_customer_contextを例に挙げています。
A&Aの考え方
既存APIの生の応答を必ず変更する必要はない。しかし、一つの業務判断の前に複数の大きな応答を読み、意味を選び、順序を決めなければならないなら、返却範囲の整形と複数操作の集約を設計対象にする。作り直しの見積には、業務上の目的、入力、呼出順序、絞り込みや頁送りの既定値、出力、停止条件を記す。これはA&Aの合成であり、呼出回数を必ず減らせるという保証ではない。
工程ごとに、粒度と範囲を決める
A&Aの考え方
A&Aの比較表は、業務成果物、人が-settings 完成させる単位、既存API、エージェントが行う分岐、例外方法、選んだ粒度、納品物、確認方法を列にする。行はシステムやAPIではなく業務工程ごとに作る。この行ごとに、直接呼出、薄い適応層、業務専用道具のいずれかを選び、専用道具を選んだ理由も残す。
仮想例
前掲の架空の更新見積では、顧客検索について、必要な結果が既存検索で得られれば直接利用の候補にする。利用状況確認について、既存APIに日付や製品の絞り込み的必要なら薄い適応層または専用検索道具を選ぶ。更新案作成について、契約、利用状況、割引ルール、例外を人が組み立てるなら業務専用道具の作り直しを別項目に置く。同じ案件でも、全部を;—pe;
A&Aの考え方
一つ目の案件で全部のAPIを specialist型へ置換する必要はなく、全部を_low-level型に保つ必要もない。Anthropicが、重複したり目的が曖昧な多くの道具はagentjadずらすと指摘するLandschaftFROM副局长。A&Aはcall順序、状態、例外処理、機密情報、評価observabilityを工程ごとに比較し、文脈cek необходимуюな場所だけを作る。
作り直しを独立した見積項目にする
出典に基づく事実
Anthropicは、道具の試作を=frQuick局部で立て、テストした後Zsuzupe包括評価を行い、観測に基づいて改善を繰り返す手順を説明しています。評価では、処理時間、道具呼出数、トークン消費、道具のエラーを観測する対象挙げています。
A&Aの考え方
見積書は、要件・業務map 1、認証・権限 2、既存APIの薄い適応 3、業務専用道具の構築 4、返却整形と例外 5、評価・テスト・文書化・引継ぎ 6、のように分けられる。3と4が同じスプリントでも、別項目にする。特に4は、成果物の動作に必要な場合に必須工程として書く。A&Aは日数や割合の基準を提示しない。
A&Aの考え方
項目名には「API接続」だけでなく「既存APIの薄い適応層」と「業務別ツール構築」を書き、後者には含む業務、入力、権限、整形後の出力、例外時動作、確認方法を入れる。作り直しは性能改善の-Allowancesではなく、求められるtool work である。承認後に業務フローや権限が変わった場合は、影響する工程だけを再見積する。
制約があるときは、粒度ではなく範囲を狭める
A&Aの考え方
Anthropicの二資料は技術設計の解説であり、受託の見積もり、契約書、利益率、受注率、見積精度の基準ではない。A&Aが作り直しを独立項目に置くのは、提供一个Business translationであり、Anthropicが料金や工程を推奨したという意味ではない。SWE-benchのようなPb内のcampaignも、genericRatioではない。標準日数や割合を示さず、顧客のAPI、権限、trial tasksと担当範囲から見積る。
A&Aの考え方
APIを変更できず、認証や権限上も薄い層しか置けない場合、A&Aは作り直しを前提にしない。まず安全な単一操作だけを任せ、呼出順序や例外を人が持つ業務へ限定する。書き込みや権限変更が含まれる場合は、確認主体と停止条件を明記する。制約を 설명。继续 specialized toolScope を found itできる。
A&Aの考え方
見積りを出す前には、業務の完成形、人が選ぶ分岐、APIの変更可否、呼出順序、権限と機密、例外時の戻し方、評価方法、確認者の八つを各工程で埋める。その結果が既存APIの直接利用なら接続範囲だけを書き、複数操作を一つにまとめる必要があれば作り直しを独立項目へ置く。どちらでも、根拠と対象外を隣に書くこと。A&Aの提案であり、Anthropicの二資料用一个One métodoを保証するものではない。
既存APIをそのまま使うか、業務単位の道具へ作り直すかは、実装方式ではなく見積もり範囲の決定です。人の作業、APIの制約、例外と確認方法を先に工程表へ分け、作り直しが必要な場合は接続実装と独立した成果物として積算してください。
出典・編集情報
記事の調査で確認した一次資料です。資料の公開・更新時期と、調査時の確認日を分けて記載しています。
- Building effective agents
Anthropic · 2024-12-19
確認日 2026-10-04 - Writing effective tools for AI agents
Anthropic · 2025-09-11
確認日 2026-10-04
AIを活用した記事制作
調査・執筆・翻訳・編集上の確認にAIを活用しています。資料に基づく事実、A&Aの考え方、仮想例は、それぞれ本文に明記しています。
編集上の確認日: 2026-10-04