表示
超・人工知能研究所 Super AI Research Lab トップへ超・人工知能研究所AI Research Lab / ぱそ太郎工事中

since
平成38年9月29日

← 検索結果に戻る

書式の異なるAPI文書から呼び出し可能なツールを作るToolFactory

ToolFactory

保存した記事を見るこのブラウザに保存します。無料会員で端末間の同期・フォルダ整理
原論文の図

ToolFactoryの原論文から掲載した図です。細部はクリックして拡大できます。

原論文の図の説明を読む

Figure 2: TooFactory: Automated pipeline for generating AI-usable tools from API documentations. The API documentations in free-text are processed by APILlama to extract structured information, which is used to build tools that interact with the corresponding APIs.

出典:ToolFactory / arXiv ↗

概要

  • 書式の異なるREST API文書から呼び出し項目を抽出し、ツールを生成・検証する。
  • 著者らのテストでは、APILlamaのJSON構造の妥当率は0.97、生成ツールの検証通過数は26件だった。
  • 誤った入力値が失敗の主因と報告され、検証済みツールから値の候補を探す方法が提案された。
補足:編集した模式図で仕組みを確認する

VISUAL EXPLAINER

図でつかむ、ToolFactoryの仕組み

左から右へ読む
  1. 01API文書
  2. 02呼出項目を抽出
  3. 03ツールを生成
  4. 04API応答を検証

原論文の説明をもとにした模式図です。処理の細部は省略しています。

研究の背景

ToolFactoryは、自然文で書かれたREST API文書から、AIエージェントが呼び出せるツールを作る。REST APIは、URLと入力項目を指定して外部サービスに情報や処理を求める仕組みである。

研究分野のAPI文書には、書式がそろわず、呼び出しに必要な説明が欠けるものもある。開発者は文書からURLや入力項目を読み取り、実際に動くか確かめる必要があり、AIからサービスを使えるようにする際の負担になる。

手法

API文書をAPILlamaに入力し、基点URL、呼び出し先の経路、必須・任意の入力項目、説明をJSONにまとめる。JSONは項目名と値を一定の形で記録する形式である。APILlamaはLLaMA3を土台とし、指示と項目定義を、学習可能な20個の仮想トークンで表す。トークンはモデルが文章を扱う単位を指す。

抽出した項目から、APIを呼ぶPython関数などを生成する。例えば糖鎖データベースの文書にある検索経路とID欄を、関数の呼び出し先と入力に対応させる。例の値で実行し、状態コード200に加え、応答が空でもエラー表示でもないことを確認する。値が不明なら、検証済みツールから項目名や説明が似た候補を探して試す。

新規性

ToolFactoryは、書式がそろわないAPI文書から必要項目を抽出し、ツール生成と実際の呼び出しによる検証までを一連の処理にした。文書に記載されないことがある応答形式は、抽出項目に含めない。

さらに著者らは、検証済みツールの入力項目と応答から値の候補を集める方法を提案した。項目名と説明が似た候補を探し、呼び出しに成功した値を再利用する。

従来手法との違い

著者らは、元のLLaMA3、入出力例を一つ添えたLLaMA3とGPT-3.5、指定形式で出力するGPT-3.5を比較対象とした。APILlamaは、毎回渡す約572トークンの指示と項目定義を、学習する20個の仮想トークンで表す。

テストでは、指定形式で出力するGPT-3.5が84件、APILlamaが66件のエンドポイントを抽出した。生成ツールの検証通過数はそれぞれ25件と26件で、抽出件数と呼び出しの成否は別の結果である。

実験結果

著者らは167文書・744エンドポイントのAPI Extraction Benchmarkを作り、文書を80%の学習用と20%のテスト用に分けた。テスト用は34文書・117エンドポイントで、対象APIは認証を要しない。抽出はJSONの構造、説明の類似度、入力項目の適合率・再現率などで評価した。

著者らの表では、APILlamaのJSON構造の妥当率は0.97。呼び出し検証を通ったツールは、正解JSONから生成したものが50件、APILlamaから生成したものが26件だった。糖鎖研究の事例では92件が検証を通ったが、この件数は利用者の質問への回答精度を示さない。

応用の可能性

編集上の応用案 · 論文が実証した用途とは区別しています。

編集上の応用案:研究者が糖鎖のIDを入力し、対象のデータベースから名称や構造表現を取得する窓口を試す。出力は取得結果、参照先、実際に渡したIDを並べた確認用の記録とし、研究者が原データと照合する。

入力元には対象APIの文書と、人が正しいと確認したID例が要る。適用時には項目名とID形式の対応を人が確認し、必要なら設定を直す。追加学習する場合は文書と正しいJSON項目を対応付けたラベルが必要で、センサー入力は使わない。

応用先の候補からNauhに相談できます。

導入時の検証

導入時の検証案 · 対象データでの再評価が必要です。

導入時の検証案:糖鎖APIを少数選び、文書と正しいURL・入力項目、呼び出しに使えるID例を人手で記録する。これを正解ラベルとし、抽出結果を照合する。追加学習には文書とラベルの組が必要で、センサーは使わない。

手作業で作った呼び出し関数を比較基準に、同じID例で生成ツールを実行する。項目の一致件数、検証通過件数、返されたIDと原データの一致を測る。経路やID形式が文書と合わない場合は、人が対応付けを修正して再実行する。

限界と課題

著者らは、APILlamaが指定形式で出力するGPT-3.5より抽出したエンドポイントが少なく、生成ツールの失敗では誤ったパラメータ値が主因だったと報告した。ベンチマークには認証不要のAPIを選んでおり、認証が必要なAPIでの結果は示されていない。

編集上の検証事項は、文書や経路の更新への対応、誤ったIDでも正常な応答が返る場合の検出、取得内容の意味の正しさである。状態コード200と空でない応答を確認するだけでは、研究用途の回答精度は判断できない。

応用先の候補
研究内容と応用案に基づく分類です。業界での導入実績を示すものではありません。

出典

元のタイトル・要旨を確認する(英語)

ToolFactory: Automating Tool Generation by Leveraging LLM to Understand REST API Documentations

LLM-based tool agents offer natural language interfaces, enabling users to seamlessly interact with computing services. While REST APIs are valuable resources for building such agents, they must first be transformed into AI-compatible tools. Automatically generating AI-compatible tools from REST API documents can greatly streamline tool agent development and minimize user learning curves. However, API documentation often suffers from a lack of standardization, inconsistent schemas, and incomplete information. To address these issues, we developed \textbf{ToolFactory}, an open-source pipeline for automating tool generation from unstructured API documents. To enhance the reliability of the developed tools, we implemented an evaluation method to diagnose errors. Furthermore, we built a knowledge base of verified tools, which we leveraged to infer missing information from poorly documented APIs. We developed the API Extraction Benchmark, comprising 167 API documents and 744 endpoints in various formats, and designed a JSON schema to annotate them. This annotated dataset was utilized to train and validate ToolFactory. The experimental results highlight the effectiveness of ToolFactory. We also demonstrated ToolFactory by creating a domain-specific AI agent for glycomaterials research. ToolFactory exhibits significant potential for facilitating the seamless integration of scientific REST APIs into AI workflows.

論文本体の取得範囲に基づく解説。AIが作成した未校閲の記事です。性能の数値は著者の評価条件に依存します。応用例と検証計画は編集上の提案です。解説更新:2026-10-01