スリップ関係作成ノード
スリップボックスノードの使い方（スリップ関係作成）
スリップ関係作成（Link Slips）ノードは、スリップ1つ(起点)から他の1つ以上のスリップ(対象)へ向かう構造的な関係を作成するノードです。関係には閉じた語彙で定められた関係タイプ(例:分類関係、構成関係など)を指定し、必要であればその上に業務上の関係名を重ねることができます。作成された関係は、各スリップの参考資料エリアで確認できます。
このノードはエージェントにツールとして接続して活用するのにも適していますが、このチュートリアルではまず最も基本的な使い方を確認できるよう、アビリティで扱います。エージェントへの接続方法は、別途公開予定のスリップボックスエージェント統合ガイドで扱います。このチュートリアルではAgentria Docsスリップボックスにテスト用のスリップを2つ作成し、その間に関係を作成するアビリティワークフローを完成させます。
事前準備
このチュートリアルを開始する前に、プロジェクトにスリップボックスが構築されている必要があります。スリップボックスの構築方法は、🔗スリップボックスガイドをご参照ください。このチュートリアルでは、Agentria Docsスリップボックスの中にテスト用のスリップを2つ新しく作成して使用します。
このチュートリアルを完了すると、以下のことができるようになります。
スリップ関係作成ノードでスリップ間に構造的な関係を作成できます。
スリップ関係作成ノードの各入力変数をスタートノードの入力値と接続できます。
関係タイプと業務述語を状況に応じて使い分けられます。
ランテストとデバッグログで関係が正常に作成されたか確認できます。
ワークフロー概要
このチュートリアルの核心はスリップ関係作成ノードです。
スリップ関係作成ノードは、起点スリップをUUIDで指定し、対象スリップのUUID一覧と関係タイプを渡します。ノードが正常に実行されると、起点スリップから各対象スリップへ向かう出ていく関係が作成され、すべての対象は同じタイプ・述語で接続されます。
スリップ関係作成ノード基本情報
スリップ関係作成ノードは以下のオプションを提供します。
オプション | 必須 | 説明 |
|---|---|---|
| 必須 | 関係が出発するスリップのUUIDです。更新対象のため、このスリップへの編集権限が必要です。 |
| 必須 | 構造的な関係タイプです。閉じた語彙13種のうちの1つで、最も狭い型を選びます(分類は |
| 必須 | 関係を張る対象スリップのUUID一覧です。すべて同じタイプ・述語で接続されます。このスリップボックスに実在しないUUIDはスキップされ、結果で通知されます。 |
| 任意 | 構造タイプの上に載せる業務上の関係名です(小文字snake_case、例: |
| 必須 | このノードが操作する スリップボックス です。ビルダーで選択して固定します。 |
このチュートリアルでは5つの項目すべてを使用します。
関係タイプ13種の全一覧
関係タイプに指定できる閉じた語彙13種は以下のとおりです。ゆるく関連しているだけの場合でも、できるだけ意味の狭い具体的なタイプを優先し、関連はどれにも当てはまらないときだけ使います。
関係タイプ | 値（ | 説明 |
|---|---|---|
関連 |
| 2つのスリップが互いに参考になる、緩やかな関係です。 |
同一実体 |
| 表記が異なっても同じ対象を指します。（対称） |
分類 |
| このスリップが対象の事例、または下位分類です。 |
構成 |
| このスリップが対象の一部です。（列→テーブル、条項→契約） |
依存 |
| このスリップが成立するには対象が必要です。 |
使用 |
| このスリップが対象を取り込んで使います。 |
拡張 |
| このスリップが対象を広げる、または付け足します。 |
派生 |
| このスリップは対象から作られました。 |
裏付け |
| このスリップが対象の根拠になります。 |
検証 |
| このスリップが対象によって検証されます。 |
統制 |
| このスリップ（方針）が対象を統制します。 |
代替 |
| このスリップが対象を置き換えます。 |
矛盾 |
| このスリップと対象が互いに食い違います。（対称） |
ノードで作成される関係は、常に起点スリップから対象スリップへ向かう出ていく関係です。作成後に方向を変えたい場合は、スリップボックスUI上で手動で変更できます。スリップの参考資料の該当項目にある方向設定ボタンから、出ていく関係・入ってくる関係・相互関係のいずれかを選び直せます。
ステップ1：アビリティの作成
新しいアビリティを作成します。名前にスリップ関係作成ノード、説明にスリップ間に関係を作成を入力します。このアビリティでは、関係を作成したいスリップをスリップ関係作成ノードに直接接続します。どのスリップを対象にするかは自由に決めて構いません — このチュートリアルではAgentria Docsスリップボックスに作成したテスト用のスリップ2つを対象に進めます。
ステップ2：スタートノードの設定
スタートノード（Start Node）をダブルクリックしてノードエディター（Node Editor）に進入します。以下の4つの変数を追加します。
uuid：起点スリップのUUIDを受け取ります。（String）link_type：関係タイプを受け取ります。（String）to_slip_public_uuids：対象スリップのUUID一覧を受け取ります。（Array）label：業務述語を受け取ります。（String）
to_slip_public_uuidsはString型ではなくArray型で追加してください。
ステップ3：スリップ関係作成ノードの追加
+ノード追加（Add Node） → スリップボックス（Slipbox）カテゴリからスリップ関係作成ノードを追加します。
ステップ4：スリップ関係作成ノードの設定
スリップ関係作成ノードをダブルクリックしてノードエディターに進入します。対象 スリップボックスで使用するスリップボックスを選択します — このチュートリアルでは例としてAgentria Docsを選択します。これを設定しないままだと、ノード実行時にerror_codeがSLIPBOX_NOT_FOUNDとなって失敗するため、必ず確認してください。
残りの項目には、以下のようにスタートノードの入力値をドラッグ＆ドロップでバインドします。
アダプター変数 | バインドする値 |
|---|---|
|
|
|
|
|
|
|
|
ノードが正常に実行されると、linked_count（連結したスリップ数）、skipped_slip_ids（存在せずスキップされたUUIDの配列）、slip_public_uuid（更新された起点スリップのUUID）、error_code、error_messageが出力されます。
ステップ5：エンドノードの設定
エンドノード（End Node）をダブルクリックしてノードエディターに進入します。String型の出力変数resultを追加し、スリップ関係作成ノードのerror_codeをドラッグ＆ドロップでバインドします。これにより、関係が正常に作成されたか失敗したかを出力値で確認できます。
ステップ6：テスト用スリップを2つ準備
Agentria Docsスリップボックスに移動し、スリップ追加ボタンでテスト用のスリップを2つ新しく作成します（例：起点スリップ、対象スリップ）。最後に、右側の情報パネルから2つのスリップそれぞれの公開UUIDをコピーしておきます。これらの値は、ランテストでuuidとto_slip_public_uuidsの入力値として使用します。
ステップ7：ランテストの実行
uuidには起点スリップの公開UUIDを貼り付けます。link_typeにはRELATED_TOを入力します。
labelにtest_relationを入力し、to_slip_public_uuidsには対象スリップの公開UUIDを含むJSON配列を記述します。
テスト実行（RUN TEST）をクリックします。result出力値がSUCCESSであれば成功です。
ステップ8：デバッグログの確認
スリップ関係作成ノードのデバッグログ（Debug Log）を確認すると、error_codeがSUCCESSとして返された詳細と、一緒に返されたlinked_count（1）、skipped_slip_ids（空の配列）、slip_public_uuid（起点スリップのUUID）の値を確認できます。
ステップ9：スリップボックスで結果を確認
Agentria Docsスリップボックスに移動して起点スリップを開くと、参考資料の件数が1に増えていることを確認できます。新しく作成された参考資料の項目には、設定した関係タイプ（RELATED_TO）、ラベルtest_relation、方向は出ていく関係、対象は先ほど作成したテスト用スリップが、それぞれ正しく表示されています。
次のステップ
🎉 おめでとうございます！Agentriaを使って「スリップ間に関係を作成する」ワークフローを完成させました。
このノードをAgent Loopノードにツールとして接続すれば、会話の中でエージェントがスリップ間の構造的な関係を自ら見つけて連結するワークフローへと拡張できます。
Agentriaは、アイデアを現実に変える可能性の空間です。
あなたのアイデア次第で、ワークフローは無限に広がります。
他のノード活用例が気になる方は 🔗ノードの使い方 ページをご確認ください。
よくある質問
スリップ関係作成ノードは何をするノードですか？
スリップ関係作成ノードは、起点スリップ1つから対象スリップ1つ以上へ向かう構造的な関係を作成するノードです。関係タイプは閉じた語彙の中から指定し、必要であれば業務述語を追加できます。作成された関係は起点スリップの参考資料で確認できます。
関係タイプにはどんな値を使えますか？
閉じた語彙13種のうちの1つを使います。全種類は上の「関係タイプ13種の全一覧」表をご参照ください。このうちRELATED_TO（関連）は他のタイプでは表現しにくい場合にのみ使い、より意味が狭く明確なタイプがあればそちらを優先して選ぶことをおすすめします。
関係の方向はあとから変更できますか？
はい。ノードで作成される関係は常に、起点スリップから対象スリップへ向かう出ていく関係であり、ノード自体には方向を指定する入力はありません。ただし、作成後にスリップボックスUI上で手動で変更できます。関係が作成されたスリップを開き、参考資料の該当項目にある方向設定ボタンから、出ていく関係（デフォルト）・入ってくる関係・相互関係のいずれかを選べます。
業務述語は必ず入力する必要がありますか？
いいえ、任意入力です。関係タイプが構造的な意味（分類・構成など）を担うのに対し、業務述語はその上に業務上の文脈を重ねる役割を持ちます。customer_of、approvesのように小文字snake_caseで記述し、構造タイプだけですでに意味が十分な場合は空欄のままで構いません。
対象 スリップ UUID 一覧に存在しないUUIDを含めるとどうなりますか？
ノード全体が失敗するわけではなく、存在しないUUIDだけがスキップされ、skipped_slip_ids出力値で通知されます。残りの有効な対象とは正常に関係が作成されます。