Communitygithub.com

psrtech/async-agentic-tools

エージェントフレームワークで真の非同期ツール呼び出しを可能にし、即時確認応答とノンブロッキングな結果コールバックによる継続的な対話を実現します。

async-agentic-tools とは?

このスキルは、AIエージェントフレームワークにおいて、ツール呼び出しを真に非同期化するための機能を提供します。従来の同期型ツール呼び出しでは、結果が返ってくるまでエージェントの処理がブロックされていましたが、本スキルを利用することで、ツール呼び出しに対して即座に確認応答(Acknowledgment)を返し、結果が準備できた時点で非同期にコールバックを受け取ることができます。これにより、エージェントはツールの実行中も他のタスクを継続して処理できるため、全体的な対話のスループットと応答性が大幅に向上します。Claude CodeやCursor、Codexなどの主要なエージェントフレームワークで動作するように設計されており、バックグラウンドでのデータ処理、外部APIの呼び出し、長時間実行されるスクリプトなど、さまざまなユースケースで効果を発揮します。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add psrtech/async-agentic-tools

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

async-agentic-tools は何をしますか?

エージェントフレームワークで真の非同期ツール呼び出しを可能にし、即時確認応答とノンブロッキングな結果コールバックによる継続的な対話を実現します。

概要

このスキルは、AIエージェントがツールを非同期的に呼び出し、即座に制御を戻すことを可能にします。ツールの実行が完了すると、結果はコールバックメカニズムを通じて配信され、エージェントはその間も他のタスクを処理し続けることができます。

特徴

  • 即時確認応答: ツール呼び出しはすぐに確認され、エージェントは待機する必要がありません。
  • ノンブロッキング: ツールの実行中もエージェントは対話や他の処理を続行できます。
  • 非同期コールバック: 結果の準備ができたときに呼び出されるコールバック関数を定義します。
  • 汎用性: Claude Code、Cursor、Codexなど、さまざまなエージェントフレームワークと互換性があります。

インストール

npm install psrtech/async-agentic-tools

クイックスタート

import { AsyncAgenticTools } from 'psrtech/async-agentic-tools';

const tools = new AsyncAgenticTools();

// 非同期ツールの登録
tools.registerTool('fetchData', async (params) => {
  const response = await fetch(params.url);
  return response.json();
});

// ツールを非同期に呼び出す
tools.callAsync('fetchData', { url: 'https://api.example.com/data' }, (result) => {
  console.log('結果を受信:', result);
});

// エージェントは即座に他の処理を続行できます
console.log('呼び出しは非同期に行われました');

対応プラットフォーム

プラットフォーム対応状況
Claude Code✅
Cursor✅
Codex✅
その他一部対応

環境変数

  • ASYNC_TOOLS_TIMEOUT: ツール実行のタイムアウト時間(ミリ秒単位、デフォルト: 30000)
  • ASYNC_TOOLS_MAX_RETRIES: コールバック配信の最大再試行回数(デフォルト: 3)

開発者向けドキュメント

詳細なAPIリファレンスと使用例については、公式ドキュメントを参照してください。

関連スキル