論文 · arXiv 2508.16279
AgentScope 1.0: エージェントアプリケーション構築のための開発者中心フレームワーク
AgentScope 1.0: A Developer-Centric Framework for Building Agentic Applications
3行まとめ
- 🎯 LLMエージェントには、単なる試作品ではなく、柔軟・安全・効率的なツールインタラクション、構造化された連携、そして実運用水準のエンジニアリングが不可欠である。
- 🔧 AgentScope 1.0を発表：モジュール式の抽象化（Msg、Model、Memory、Tool）、リアルタイムの介入制御や動的ツールプロビジョニングをサポートするReActループ、特化型の組み込みエージェント、分離されたサンドボックス実行ランタイムを導入。
- 📈 ステートフル/ステートレスなMCPクライアント、Rayによる分散評価、ネイティブなAgent-to-Agent（A2A）プロトコルデプロイをサポートする、産業レベルのオープンソースシステムを提供。
概要
大規模言語モデル（LLM）の急速な進展に伴い、エージェントは内在する知識と動的なツール利用を統合できるようになり、実世界タスクの解決能力が大幅に向上しています。この進化に沿って、AgentScopeの新バージョン（1.0）では大幅な改良が施され、エージェントアプリケーション構築に向けた柔軟かつ効率的なツールベースのエージェント・環境間インタラクションを包括的にサポートします。具体的には、エージェントアプリケーションに不可欠な基本コンポーネントを抽象化し、統一されたインターフェースと拡張可能なモジュールを提供することで、開発者が新しいモデルやMCPなどの最新の進展を容易に活用できるようにしました。さらに、エージェントの振る舞いをReActパラダイムに接地させ、体系的な非同期設計に基づく高度なエージェントレベルのインフラストラクチャを提供します。これにより、実行効率を改善しながら、人間とエージェント、およびエージェント間のインタラクションパターンを豊かにします。この基盤の上に、特定の現実的シナリオ向けに調整された複数の組み込みエージェントを統合しています。また、AgentScopeには開発者に使いやすい体験をもたらす堅牢なエンジニアリングサポートも含まれています。ビジュアルスタジオインターフェースを備えたスケーラブルな評価モジュールを提供し、長い実行軌跡を持つエージェントアプリケーションの開発をより管理しやすく、追跡を容易にします。加えて、エージェントの安全な実行を保証するランタイムサンドボックスを提供し、本番環境への迅速なデプロイを促進します。これらの強化により、AgentScopeはスケーラブルで適応性が高く、効果的なエージェントアプリケーションを構築するための実践的な基盤を提供します。
英語の原文概要
Driven by rapid advancements of Large Language Models (LLMs), agents are empowered to combine intrinsic knowledge with dynamic tool use, greatly enhancing their capacity to address real-world tasks. In line with such an evolution, AgentScope introduces major improvements in a new version (1.0), towards comprehensively supporting flexible and efficient tool-based agent-environment interactions for building agentic applications. Specifically, we abstract foundational components essential for agentic applications and provide unified interfaces and extensible modules, enabling developers to easily leverage the latest progress, such as new models and MCPs. Furthermore, we ground agent behaviors in the ReAct paradigm and offer advanced agent-level infrastructure based on a systematic asynchronous design, which enriches both human-agent and agent-agent interaction patterns while improving execution efficiency. Building on this foundation, we integrate several built-in agents tailored to specific practical scenarios. AgentScope also includes robust engineering support for developer-friendly experiences. We provide a scalable evaluation module with a visual studio interface, making the development of long-trajectory agentic applications more manageable and easier to trace. In addition, AgentScope offers a runtime sandbox to ensure safe agent execution and facilitates rapid deployment in production environments. With these enhancements, AgentScope provides a practical foundation for building scalable, adaptive, and effective agentic applications.
論文解説
問題設定と動機
近年の大規模言語モデル（LLM）は推論や自然言語生成に優れる一方で、実世界での有用性を発揮するにはAPI、データベース、動的ツールを介した外部環境との確実な相互作用（grounded interaction）が必要です。初期のエージェントアーキテクチャは、柔軟性に欠ける順次ツール実行に依存することが多く、堅牢な非同期処理の欠如、ツールの過多（「選択のパラドックス」）への対処難、さらには長大な軌跡のデバッグ、分散評価、安全な実行のための開発者向けインフラの不足といった課題を抱えていました。AgentScope 1.0は、モデルの内在的な推論のみに頼るフレームワークから、ツールの認識と環境インタラクションを中心とした拡張性の高い開発者向けエージェントフレームワークへと移行することで、これらの課題を解決します。
主要なアイデア
AgentScope 1.0は以下の3つの柱で構成されています：
- 基盤コンポーネント:
Msg（マルチモーダルブロック、ツール呼び出し、思考プロセスの記録）、非同期ストリーミングとOpenTelemetryインストルメンテーションを備えた統一Modelインターフェース、階層型Memory（インメモリの短期バッファおよびMem0を介した開発者/エージェント制御の長期メモリ）、拡張可能なToolkitなどの分離された抽象化。 - エージェントレベルのインフラストラクチャ: ReAct（
Reasoning + Acting）パラダイムを中心とし、ノンブロッキングな並列ツール呼び出し、ユーザーの割り込み（リアルタイムの介入制御）、動的ツールプロビジョニング（グループごとの有効化/無効化）、およびStateModuleによる階層的状態永続化をサポート。 - 開発者フレンドリーな体験: 統合評価スイート（逐次的な
GeneralEvaluatorおよび分散型のRayEvaluatorをサポート）、ブートストラップ法による信頼区間算出や軌跡比較が可能なビジュアルStudio、組み込みコパイロット（Friday）、サンドボックスによる分離実行Runtime。
手法（主要な数式を含む）
本システムは、標準化された抽象化に基づいて実行フローを構築します：
- メッセージアーキテクチャ: 情報パケットは
name、role、content（TextBlock、ToolUseBlock、ThinkingBlockなどの型付けされたブロックのリスト）、およびmetadataを含むMsgオブジェクトとして統一されます。プロバイダ固有のフォーマッタ（ChatFormatterおよびMultiAgentFormatter）が、これらのブロックを各API固有のスキーマに変換します。 - ツールの実行とグループ化: ツールはDocstringからJSONスキーマを自動抽出して
Toolkitに登録されます。ツール数が多すぎることによる検索空間の劣化を防ぐため、ツールはグループ ごとに管理されます。update_tool_groupsやエージェント自身が呼び出すreset_equipped_tools(group_names)を用いて、ワークフローステップごとにアクティブなツールの部分集合 が動的に調整されます： - MCP（Model Context Protocol）の統合: ブラウザセッションなど状態の保持が不可欠なツールのために持続的セッションライフサイクルを持つステートフルクライアントと、オーバーヘッドを最小化するために呼び出しごとに一時接続するステートレスクライアントを区別してサポートします。
- 非同期実行と介入制御: 非同期エージェントの実行にはノンブロッキングなジェネレータを使用します。asyncioのキャンセルシグナルを受信した場合、ReActループは安全に中断し、部分的な実行状態を出力した上で、観測可能なイベントとして割り込みトークンをメモリに追加します。
- マルチエージェント協調: 「ツールとしてのエージェント（Agent as a Tool）」呼び出しパターンのほか、
Pipeline構造（順次、分岐、ループ）やMsgHubブロードキャストによる対話型のオーケストレーションをサポートします。
結果（主要な数値）
本論文では、3つの特化型組み込みエージェントを通じて具体的なフレームワークの実装とアーキテクチャの妥当性を検証しています：
- Deep Research Agent: クエリ展開（木構造分解）、Tavily MCPを介したマルチソースWeb検索、低レベルの反省（ツール/パラメータの修正）、高レベルの反省（サブタスクの再計画）を実装。
- Browser-use Agent: ステートフルな標準I/Oクライアント（
StdIOStatefulClient）を介してPlaywright MCPを活用し、視覚的なHTML処理、マルチタブ調整、長大ページのチャンク分割処理を導入。 - Meta Planner Agent:
RoadmapManagerおよびWorkerManagerを介して複雑なワークフローを編成し、単純なタスク向けの基本ReActと、複雑なタスク向けのロードマップ駆動型マルチエージェント実行の2つのモードの切り替えをサポート。 - エンジニアリングインフラ: FastAPIによるデプロイ機能、Arize-PhoenixやLangfuseと互換性のあるOpenTelemetryトレーシング、Rayを用いたチェックポイント永続化付きの並列分散タスク評価をネイティブに統合。
限界と未解決の課題
- 本論文はシステムアーキテクチャの報告を主としており、標準的なベンチマークの精度比較（SWE-benchやGAIAなどの数値）は本文に含まれていません。
- Meta Plannerにおける動的ツールのプロビジョニングやプランニングのオーバーヘッドは、十分なコンテキストウィンドウの容量と、背後にあるLLMの高いツール呼び出し精度に依存します。
- 大規模な並行処理環境下におけるマルチエージェントの協調オーバーヘッドやサンドボックスの分離コストについて、スループットの実測値に基づく詳細なベンチマークは行われていません。
重要用語
- AgentScope 1.0
- スケーラブルかつ適応的で、ツールが統合されたLLMエージェントアプリケーションを構築するために設計された、開発者中心のフレームワーク。
- ReAct Paradigm
- クエリの分解、ツールアクションの実行、結果の観察、計画の修正を閉ループで行うため、推論（Reasoning）と行動（Acting）を組み合わせたエージェントアーキテクチャ。
- Model Context Protocol (MCP)
- LLMが外部サービスやデータソースと接続する方法を標準化するオープンプロトコル。AgentScopeではステートフルおよびステートレスなクライアントを通じてサポートされる。
- Toolkit
- ツールの登録、JSONスキーマの自動生成、グループごとのツール管理、および統一された非同期ジェネレータ実行を提供するAgentScopeのコアモジュール。
- Real-time Steering
- ノンブロッキングなキャンセル処理と割り込みイベントのログ記録により、ユーザーまたはシステムが進行中のエージェントのReActループを中断、誘導、または軌道修正できるようにするメカニズム。
- Dynamic Tool Provisioning
- 実行時にエージェントが自律的に特定のツールサブセットを有効化または無効化し、認知的負荷を軽減してコンテキストを節約できるようにする機能。
- StateModule
- エージェントやメモリに対して、state_dictおよびload_state_dictメソッドを通じて入れ子構造の状態を自動シリアライズおよび復元可能にするベースクラス。
- MsgHub
- 新しいメッセージを全参加者に配信することで、マルチエージェントのグループ会話を円滑にするAgentScopeの一元的なブロードキャストメカニズム。
よくある質問
AgentScopeにおけるステートフルMCPクライアントとステートレスMCPクライアントの違いは何ですか？
ステートフルクライアントは永続的なセッションを維持し（アクション間でブラウザのCookieやコンテキストを保持するなど）、ステートレスクライアントはツール呼び出しごとに一時的な接続を作成して即座に切断することでリソースのオーバーヘッドを最小限に抑えます。
AgentScopeはブラウザ自動化における長いコンテキストの制限をどのように処理しますか？
Browser-use Agentは長いWebページを小さなチャンクに分割し、チャンクごとにコンテンツを観察しながらチャンク間のコンテキストを管理することで、LLMのコンテキスト制限内に収めます。
評価システムはローカルデバッグと大規模テストの両方をどのようにサポートしていますか？
AgentScopeは、ローカル環境で段階的にプロセスを追跡・デバッグするための逐次的なGeneralEvaluatorと、Rayフレームワークを使用して複数ワーカークラスタ全体で並列分散実行するためのRayEvaluatorを実装しています。
AgentScopeは数百ものツールが存在する場合のエージェントの混乱をどのように防ぎますか？
ツールをグループ単位で管理し、開発者またはエージェント自身が「ブラウザツール」などの論理ツールグループを動的に有効化・無効化できるようにすることで、現在のサブタスクに関連するアクティブな検索空間のみに限定します。
このページの解説は AI が論文から作成したもので、誤りを含む場合があります。詳細は原文をご確認ください。