n8n
Shanoneのn8n連携は、セルフホストまたはn8n Cloud上のインスタンスでワークフローとその実行を管理する15個のツールをエージェントに提供します。はじめに
1
n8n APIキーを発行する
n8nインスタンスでSettings > n8n APIに移動し、APIキーを作成します。
2
ShanoneにキーとベースURLを追加する
ShanoneダッシュボードのIntegrations > n8nで、APIキーとインスタンスのベースURL(例:
https://your-instance.app.n8n.cloud)の両方を入力します。3
リクエストを再実行する
保存が完了すると、
n8n_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。利用可能なツール
Shanoneはn8n向けに15個のツールを、以下のカテゴリに整理して提供しています。ワークフロー
ワークフロー
n8n_list_workflows, n8n_get_workflow, n8n_activate_workflow, n8n_deactivate_workflow, n8n_delete_workflow実行
実行
n8n_list_executions, n8n_get_execution, n8n_retry_execution, n8n_delete_executionタグ & 変数
タグ & 変数
n8n_list_tags, n8n_create_tag, n8n_delete_tag, n8n_list_variables, n8n_create_variable, n8n_delete_variableよくあるユースケース
失敗のトリアージ
直近の失敗した実行を一覧表示し、一時的なエラーによるものをリトライする
ワークフロー展開の制御
段階的なロールアウトの一環としてワークフローを有効化/無効化する
環境設定
n8nのUIを開かずに、ワークフロー間で共有される変数を管理する
ワークフローの整理
チームや用途ごとにワークフローにタグを付け、絞り込みやすくする
トラブルシューティング
n8n_retry_executionがすぐに失敗する
n8n_retry_executionがすぐに失敗する
リトライできるのは失敗した実行のみで、かつ元の実行以降にワークフローが変更されていない場合に限られます——まず
n8n_get_executionでステータスを確認してください。ツールが接続エラーを返す
ツールが接続エラーを返す
Shanoneに設定したベースURLが、n8nインスタンスのAPIルート(エディタUIのURLではない)を指しているか、セルフホストの場合はインターネットから到達可能かを確認してください。
n8n_delete_variableが権限エラーで失敗する
n8n_delete_variableが権限エラーで失敗する
特定のn8nプロジェクトに紐づく変数には、そのプロジェクトへのアクセス権を持つキーが必要です。
n8n_list_variablesでその変数がどのプロジェクトに属しているかを確認してください。