Agentql Automation via Rube MCP
Composio の Agentql ツールキットを Rube MCP 経由で使用して、Agentql の操作を自動化します。
ツールキットドキュメント: composio.dev/toolkits/agentql
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能であること） - ツールキット
agentqlを使用したRUBE_MANAGE_CONNECTIONSによるアクティブな Agentql 接続 - 常に最初に
RUBE_SEARCH_TOOLSを呼び出して、現在のツールスキーマを取得すること
セットアップ
Rube MCP を取得する: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCP が利用可能であることを確認します。- ツールキット
agentqlを指定してRUBE_MANAGE_CONNECTIONSを呼び出します。 - 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します。
- ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します。
ツールの検出
ワークフローを実行する前に、常に利用可能なツールを検出します：
RUBE_SEARCH_TOOLS
queries: [{use_case: "Agentql 操作", known_fields: ""}]
session: {generate_id: true}
これにより、利用可能なツールスラッグ、入力スキーマ、推奨される実行計画、および既知の落とし穴が返されます。
コアワークフローパターン
ステップ 1: 利用可能なツールを検出する
RUBE_SEARCH_TOOLS
queries: [{use_case: "あなたの具体的な Agentql タスク"}]
session: {id: "existing_session_id"}
ステップ 2: 接続を確認する
RUBE_MANAGE_CONNECTIONS
toolkits: ["agentql"]
session_id: "your_session_id"
ステップ 3: ツールを実行する
RUBE_MULTI_EXECUTE_TOOL
tools: [{
tool_slug: "検索結果からのTOOL_SLUG",
arguments: {/* 検索結果からのスキーマ準拠の引数 */}
}]
memory: {}
session_id: "your_session_id"
既知の落とし穴
- 常に最初に検索する: ツールスキーマは変更される可能性があります。
RUBE_SEARCH_TOOLSを呼び出さずにツールスラッグや引数をハードコードしないでください。 - 接続を確認する: ツールを実行する前に、
RUBE_MANAGE_CONNECTIONSが ACTIVE ステータスを示していることを確認します。 - スキーマに準拠する: 検索結果から正確なフィールド名と型を使用します。
- メモリパラメータ:
RUBE_MULTI_EXECUTE_TOOLの呼び出しには、空（{}）であっても常にmemoryを含めます。 - セッションの再利用: ワークフロー内ではセッション ID を再利用します。新しいワークフローには新しい ID を生成します。
- ページネーション: 応答にページネーショントークンがないか確認し、完了するまでフェッチを続けます。
クイックリファレンス
| 操作 | アプローチ |
|---|---|
| ツールの検索 | RUBE_SEARCH_TOOLS に Agentql 固有のユースケースを指定 |
| 接続 | RUBE_MANAGE_CONNECTIONS にツールキット agentql を指定 |
| 実行 | 検出されたツールスラッグを指定して RUBE_MULTI_EXECUTE_TOOL を実行 |
| 一括操作 | run_composio_tool() を使用した RUBE_REMOTE_WORKBENCH |
| 完全なスキーマ | schemaRef を持つツールに対して RUBE_GET_TOOL_SCHEMAS を実行 |
Powered by Composio