オールインワン スリップボックスエージェント

オールインワン スリップボックスエージェントの作成

オールインワン スリップボックスエージェントの作成

オールインワン スリップボックスエージェントの作成

オールインワン スリップボックスエージェントの作成

スリップボックスは、実は人が直接ブラウズするよりも、エージェントが読んで実行することを前提に設計された機能です。このチュートリアルでは、スリップボックスを扱うノード11個すべてをエージェントループ(Agent Loop)ノードのツール(Tool)として接続し、ユーザーの自然言語リクエスト一つで、検索・照会・作成・編集・連結・整理までをすべて処理する「オールインワン スリップボックスエージェント」を作成します。

スリップ検索(Slip Query)、スリップキーワード検索、スリップ読み取り、スリップ作成、スリップフィールド更新、スリップテキスト置換、スリップ本文追加、スリップ関係照会、スリップ関係作成、スリップカテゴリ分割、スリップカテゴリ統合まで、11個のスリップボックスノードをエージェントループノードにツールとして接続します。各ノードの詳細な使い方はすでに個別のチュートリアルで扱っているため、このチュートリアルでは「複数のツールを一度にエージェントへ接続し、自律的に組み合わせて使わせる方法」に焦点を当てます。完成すると、ユーザーが「こういうドキュメントある?」「この内容を修正して」のように自然言語でリクエストするだけで、エージェントが状況に応じたツールを自ら選択・組み合わせて実行します。

事前準備

このチュートリアルを始める前に、プロジェクトでエージェント(Agent)を作成し、キャンバス(Canvas)に進入している必要があります。キャンバス進入方法は🔗3ステップ コアガイドを参照してください。

また、このチュートリアルではスリップボックスを扱うツールを接続するため、プロジェクトにスリップボックスがあらかじめ構築されている必要があります。スリップボックスの構成方法は🔗スリップボックスガイドを参照してください。

このチュートリアルを完了すると、以下のことができるようになります。

  1. エージェントループノードにスリップボックス関連ノード11個を一度にツールとして接続できます。

  2. ペルソナと指示(Instructions)で、エージェントが正しい順序でツールを選択するよう誘導できます。

  3. 各ツールノードの入力値を一つずつバインドしなくても、エージェントが状況に応じた値を自ら埋めて呼び出すようにできます。

  4. チャットテストとデバッガーで、エージェントが実際にどのツールを何回、どの順序で呼び出したかを確認できます。

このチュートリアルでツールとして接続するノードは次のとおりです。各ノードのフィールドと単体での使い方は、以下のドキュメントを参照してください。

ワークフロー概要




各ノードは次のような役割を持ちます。

  • エージェントループノード: ユーザーのリクエストを分析し、今必要なツールを自ら選択・組み合わせて実行する、このワークフローの中核ノードです。

  • スリップボックスツールノード11個: それぞれスリップボックスを検索・照会・作成・編集・連結・整理する専用ツールです。詳細な使い方は上の「事前準備」のリンクを参照してください。

  • LLMノード: エージェントループノードとスリップ検索ノードが内部的に使用するモデルを指定します。スリップ検索ノードは関連スリップを探す過程で独自にLLMを使用するため、エージェントループノードとは別にLLMノードの接続が必要です。詳細は🔗LLMノードドキュメントを参照してください。

複数のツールを接続する際に知っておくべきこと

エージェントループノード自体の全オプション(最大ステップ数、最大実行時間など)はすでに🔗エージェントループノードドキュメントで扱っているため、ここでは複数のツールを接続する際に特に重要な設定のみを取り上げます。

オプション

このチュートリアルでの役割

エージェントペルソナ

エージェントに「自分は何を管理する誰なのか」というアイデンティティを与えます。ここでは「Slipbox Master スリップボックス専門管理エージェント」として設定します。

エージェント指示

11個のツールのうち、状況別にどのツールを使うべきか、どの順序で呼び出すべきかを表とルールで明示します。ツールの説明だけに判断を任せるのではなく、明確な選択基準を自分で書き込むほど、エージェントは一貫して動作します。

プロンプト内最大ツール数

プロンプトに一度に含めるツール数のデフォルト値は10です。このワークフローはツールがちょうど11個なので、この値を11に増やし、すべてのツールが遅延読み込みなしに一度にプロンプトへ含まれるようにします。

もう一つの重要な違いは入力値のバインド方式です。これまでの「コアノード1個」チュートリアルでは、ノードのすべての入力を開始ノードの変数にドラッグ&ドロップで直接接続していました。しかし、ツールとして接続されたノードは異なります — スリップ公開UUIDのように呼び出すたびに値が変わる入力は、バインドせずに空欄のままにします。 空欄は画面上でParameterというバッジとともに表示され、これは「エージェントが呼び出し時にこの値を自分で埋める」という意味です。逆に対象 スリップボックスのように実行のたびに変わらない値は、これまでと同様に設計時にあらかじめ選択しておきます。

空欄のままにする入力フィールド

ステップ1: エージェントの作成

新しいエージェントを作成します。名前にオールインワン スリップボックスエージェント、説明にスリップボックスを検索・照会・作成・編集・管理するエージェントと入力します。

ステップ2: エージェント入力(Agent Input)ノードの確認

Agent Inputノードをダブルクリックしてノードエディターを開きます。input_message、input_files、metadata、session_idの4つの入力変数が固定されています。このチュートリアルでは、ユーザーがチャットで入力したメッセージが入るinput_messageをそのまま使用します。

ステップ3: エージェントループノードの追加とペルソナ・指示の作成

+ノード追加(Add Node)でエージェントループノードをキャンバスに配置します。ノードエディターでユーザー入力にinput_messageをドラッグ&ドロップでバインドします。

変数を追加ボタンでエージェントペルソナとエージェント指示の入力を追加します。エージェントペルソナには次のようにエージェントのアイデンティティを記述します。

あなたは**Slipbox Master**

あなたは**Slipbox Master**

あなたは**Slipbox Master**

エージェント指示には、ツールの選択基準と作業順序のルールを記述します。




最後にプロンプト内最大ツール数を11に変更します(デフォルト値10 → 11、接続するツールがちょうど11個のため)。

ステップ4: LLMノードの追加と接続

+ノード追加でLLMノードをキャンバスに配置し、LLMモデルでAnthropic-claude-4.6-sonnetを選択します。このLLMノードをエージェントループノードのLLM Model接続ポイントに接続します。

スリップ検索ノードは関連スリップを探す過程で内部的にLLMを使用するため、同じ方法でLLMノードをもう一つ追加し、スリップ検索ノードのLLM Model接続ポイントにも接続します(同じLLMノードを再利用しても、新しく追加してもかまいません — このチュートリアルでは同じモデルの別のLLMノードをもう一つ用意します)。Fallback LLM Modelはこのチュートリアルでは接続しません。

ステップ5: スリップボックスツールノード11個の追加と接続

11個のツールノードはすべて同じパターンに従います。

  1. +ノード追加でスリップボックス(Slipbox)カテゴリからノードをキャンバスに配置します。

  2. ノードエディターで対象 スリップボックスを選択します — このチュートリアルでは例としてSlipbox Masterを選択します。この値だけは、すべてのツールノードであらかじめ選択しておく必要があります。

  3. 残りの入力(検索語、スリップUUID、本文など)はバインドせず空欄のままにします。エージェントが呼び出し時に自動で埋めます。

  4. エージェントループノード下部のTools接続ポイントから、このノードのインピン(In-Pin)へエッジを接続します。

このパターンを以下の11ノードに繰り返します。

ノード

役割

スリップ検索

自然言語の質問に最も合うスリップを検索し、内容を返します。

スリップキーワード検索

ブールキーワード式でスリップボックスを全文検索し、候補一覧を返します。

スリップ読み取り

特定のスリップUUIDの全体内容を読み取って返します。

スリップ作成

タイトル・本文・要約を指定して新しいスリップを作成します。

スリップフィールド更新

スリップのタイトル・本文・要約・タイプを更新します。

スリップテキスト置換

スリップ本文内の特定テキストを正確に探し、別のテキストに置換します。

スリップ本文追加

既存の内容を保持したまま、スリップ本文の末尾に新しいセクションを追加します。

スリップ関係照会

スリップの関係(リンク)を方向別・タイプ別に探索し、連結されたスリップ一覧を返します。

スリップ関係作成

スリップ間にタイプが指定された関係(リンク)を作成します。

スリップカテゴリ分割

過度に広いカテゴリを複数の下位カテゴリに分割します。

スリップカテゴリ統合

1つのカテゴリの子を別のカテゴリへ移動し、元のカテゴリを削除します。

✅ ここまでの確認: キャンバスにツールノード11個すべてが配置されており、各ノードの対象 スリップボックスが空欄になっておらず、すべてのノードがエージェントループノードのToolsに接続されているか確認してください。対象 スリップボックスが1つでも空欄になっていると、そのツールの呼び出し時に失敗します。

ステップ6: エージェント出力(Agent Output)ノードの設定

Agent Outputノードをダブルクリックしてノードエディターを開きます。output_messageに、エージェントループノードのfinal_answerをドラッグ&ドロップでバインドします。

ステップ7: チャットテストでワークフロー全体を実行

チャットテスト(CHAT TEST)ボタンをクリックし、チャット入力欄に次のような照会系の質問を入力して実行します。

エージェントが自らキーワード検索 → スリップ検索 → スリップ読み取りの3つのツールを順に呼び出してスリップボックスの構造を把握し、回答を生成すれば正常に動作しています。

続けて、複数のツールを同時に使う必要がある複合リクエストも入力してみます。

この1つのリクエストで、エージェントはスリップ作成、スリップ本文追加、スリップ連結の3つのツールを状況に応じて組み合わせて呼び出します。すべての作業が終わると、「✅ 作業完了サマリー」とともに、作成されたスリップID、追加されたセクション、連結された関係が表にまとめられて返ってきます。

ステップ8: デバッガーで実行過程を確認

右側のデバッガーパネルで、エージェントが呼び出したツールを順番に確認できます。各思考ステップの後に実行 - [ツール名]という項目が表示されますが、同じステップに複数の項目が並んでいる場合は、それらのツールが同じターン内で同時に(並列で)呼び出されたことを意味します。例えば上記の複合リクエストでは、スリップ本文追加とスリップ連結が同じターンで一緒に呼び出されます。

ツール呼び出しが失敗するケースも、デバッガーでそのまま確認できます。例えば、ユーザーが日本語のラベルで関係を作成するよう依頼すると、スリップ連結ノードはerror_code: INVALID_INPUT、error_message: "invalid label '...'. must be lowercase snake_case..."を返して失敗します。デバッガーでこの失敗を確認したエージェントは、次のターンでラベルを英語の小文字snake_case(例: reference)に変更して自ら再試行し、何をしたかを最終回答でユーザーに説明します。

次のステップ

🎉 おめでとうございます! Agentriaを使って「オールインワン スリップボックスエージェント」ワークフローを完成させました。

スリップボックスノードに加えてWeb検索や他のアビリティもツールとして一緒に接続すれば、1つのエージェントがスリップボックス管理を超えて、より幅広い業務を状況に応じて自ら処理するよう拡張できます。

Agentriaはアイデアを現実に変える可能性の空間です。

あなたの創造力次第で、ワークフローは無限に広がります。

  • より多くのノード活用例が気になる方は🔗ノードの使い方ページをご確認ください。

よくある質問

複数のツールを接続する方式はいつ使うべきですか?

1つのデータソース(この場合はスリップボックス)に対して、検索・作成・編集のように性質の異なる作業を、ユーザーが自然言語で自由にリクエストすることが見込まれる場合に適しています。リクエストごとにどのノードをどの順序で実行するかをあらかじめ決めておけない対話型のシナリオでは、固定のワークフローの代わりに、エージエントに毎回状況に応じたツールを選ばせることができます。

ツールとして接続する方式は、アビリティでノードを直接バインドする方式とどう違いますか?

アビリティでは、各ノードのすべての入力をあらかじめ開始ノードの変数にドラッグ&ドロップで接続する必要があります。一方、エージェントループノードのツールとして接続すると、スリップ公開UUIDのように呼び出すたびに変わる入力はバインドせず空欄のままにでき、エージェントが呼び出し時に自分で埋めます。対象 スリップボックスのように実行のたびに変わらない値だけを設計時にあらかじめ選択しておけばよいため、設定する項目がはるかに少なくなります。

エージェントは複数のツールをどのような順序で呼び出しますか?

エージェントループノードは、ユーザーのリクエストを分析して必要なツールを判断し、実行結果を観察した後、さらに必要なツールがあれば再度呼び出すという過程を繰り返します(思考 → 実行 → 観察の繰り返し)。複数のツールを同じターンで同時に呼び出すこともできます — 実際に「セクションを追加して新しいスリップを作成し連結して」のような複合的なリクエストでは、スリップ本文追加とスリップ連結が同じターンで一緒に呼び出されることがデバッガーで確認できます。

ツール呼び出しが失敗するとどうなりますか?

ツールがerror_codeとともに失敗を返すと、エージェントは次のターンでこの情報を参考に入力値を自ら修正し、再試行します。例えばスリップ連結ノードに日本語のラベルを渡してINVALID_INPUTエラーが出た場合、エージェントはラベルを英語の小文字snake_caseに変更して再度呼び出し、成功させた上で、この経緯を最終回答でユーザーに説明します。