Skip to main content

​
Composio

ShanoneのComposio連携は、Composio自体を扱う60個のツールをエージェントに提供します。Composioは、GitHub・Gmail・Slackなど1000以上の外部サービスに対するツールを、管理されたOAuth/APIキー接続を通じて発見・実行するメタレイヤーです。

​
はじめに

1

Composio APIキーを取得する

app.composio.devにサインインし、SettingsからAPIキーをコピーします。
2

Shanoneに登録する

Shanoneダッシュボードの連携を開き、Composioを選択してAPIキーを貼り付けます。
3

リクエストを再実行する

保存が完了すると、composio_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはComposio向けに60個のツールを、以下のカテゴリに整理して提供しています。
composio_create_router_session, composio_get_router_session, composio_update_router_session, composio_attach_to_session, composio_search_session_tools, composio_list_session_tools, composio_execute_session_tool, composio_execute_session_meta_tool, composio_create_session_link, composio_list_session_toolkits, composio_get_session_config_history, composio_execute_session_proxy
composio_list_active_triggers, composio_upsert_trigger, composio_delete_trigger, composio_enable_trigger, composio_disable_trigger, composio_list_trigger_types, composio_get_trigger_type, composio_list_trigger_type_enums, composio_search_trigger_types, composio_get_trigger_status
composio_list_connected_accounts, composio_get_connected_account, composio_create_connected_account, composio_update_connected_account, composio_delete_connected_account, composio_refresh_connected_account, composio_revoke_connected_account, composio_enable_connected_account, composio_disable_connected_account
composio_list_toolkits, composio_get_toolkit, composio_list_toolkit_categories, composio_get_multiple_toolkits, composio_get_toolkit_changelog, composio_search_toolkits, composio_list_toolkit_tools, composio_get_toolkit_auth_methods
composio_list_auth_configs, composio_get_auth_config, composio_create_auth_config, composio_update_auth_config, composio_delete_auth_config, composio_enable_auth_config, composio_disable_auth_config, composio_get_session_info
composio_list_tools, composio_get_tool, composio_execute_tool, composio_execute_tool_with_text, composio_generate_tool_input, composio_execute_proxy, composio_get_required_scopes
composio_search_tools, composio_get_tools_enum, composio_find_tool_for_task

​
よくあるユースケース

メタオーケストレーション

Shanoneがまだネイティブに連携していないサービスを呼び出す橋渡しとしてComposioを使う

動的なツール発見

1000以上のツールキットを実行時に検索し、タスクに最も合ったツールを実行する

サードパーティ向けの管理OAuth

認証リンクを発行し、エンドユーザーが外部アカウントを接続するのを待ってから実行する

イベント駆動の自動化

外部サービスにトリガーを設定し、発火時に対応する

​
トラブルシューティング

対象のツールキットにはまず専用の接続済みアカウントが必要です。composio_create_auth_linkで認証URLを取得し、エンドユーザーに完了してもらい、実行前にcomposio_wait_for_connectionでポーリングしてください。
toolkit_slugフィルタでクエリを絞り込むか、自然言語のタスク記述に対して最も適した1件を返すよう調整されているcomposio_find_tool_for_taskを代わりに使用してください。
ルーターセッション(composio_create_router_session)には有効期限があります。composio_get_router_sessionで期限を確認し、期限切れの場合はcomposio_update_router_sessionを呼ぶか新しいセッションを作成してください。