n8n ai エージェント ツールループ9種 — グラフ・ガード
エージェントは一発で答えない — 再利用ペナルティで再選択確率がe^-Δ/Tへ落ち、ガードが5回目の反復で失敗経路へ分岐する。ツールループ全体をLLMなしで再現する9種だ。n8n ai エージェントのキャンバスを開くと、最初に目に入るのはこの道具の循環です。
01 graph-connector-view
02 system-prompt-focus
03 data-before-after
04 tool-select-score
05 tool-reuse-penalty
06 memory-window-decay
07 loop-cycle-rounds
08 guard-threshold-break
09 final-artifact-clear
- 01 AIエージェントノードとツール・メモリサブノードの接続グラフ
- 02 システムプロンプト設定パネルのフォーカス巡回
- 03 ツール呼び出し前後のJSON差分
- 04 ツール選択 — キーワード類似度スコアの計算
- 05 重複排除 — 同一ツール再選択ペナルティ
- 06 メモリウィンドウ — ターンごとに減衰するコンテキスト予算
- 07 ツールループサイクル — 呼び出し・結果・部分思考の一周
- 08 ループガード — 反復しきい値を超えて失敗経路へ分岐
- 09 最終成果物 — ループ終了後に確定する回答カード
ツールループ9種 — グラフ・設定・before/after・ツール選択・重複排除・ガード・分岐・成果物
一つのエンジン層が九つの場面を回す
九つの場面はそれぞれ別々に描かず、共有の core エンジン一層の上に載ります — 2秒24フレーム周期の WAAPI 時計、再生のたびに同じ値を返すシード固定乱数 seedHash、一時停止・巻き戻し・プリセット切替の分岐がその本体で、その上にこの編の主役計算が四つ載ります。クエリとツール説明の重なりでスコアを出す toolSim、温度 T で確率を正規化する softmaxT、直前のツールを削る penalized、コンテキスト予算を守る memDecay です。ツール選択・重複排除・メモリ減衰・ガードがすべてこの規則計算から出るので、外部の LLM 呼び出しは一度もありません。
// ── 532 主役計算 — ツール選択スコア・ソフトマックス・再利用ペナルティ・メモリ減衰・ループガード
// TOOL_SIM — クエリトークンとツール説明トークンのジャッカード重なり(積集合/和集合) + シード加重
function toolSim(qtok, desc, seed) {
const dt = tokens(desc);
let hit = 0;
for (let i = 0; i < qtok.length; i += 1) {
if (dt.indexOf(qtok[i]) >= 0) { hit += 1; }
}
const uni = qtok.length + dt.length - hit;
return uni > 0 ? (hit / uni) * (0.82 + 0.36 * seedHash(qtok.length, seed)) : 0.04 * seedHash(1, seed);
}
// SOFTMAX_T — スコア配列を温度 T で正規化する。T が低いと最高峰が独占する
function softmaxT(scores, T) {
let mx = -Infinity;
for (let i = 0; i < scores.length; i += 1) { if (scores[i] > mx) { mx = scores[i]; } }
const ex = scores.map(function (s) { return Math.exp((s - mx) / T); });
let sm = 0;
for (let i = 0; i < ex.length; i += 1) { sm += ex[i]; }
return ex.map(function (e) { return e / sm; });
}
penalized は直前に使ったツールのスコアに (1 − 0.2) を掛けてソフトマックスに再び通し、memDecay はターン高さの合計が予算を超えると古い順に alpha のべきを掛けます — この二つの計算は 05・06 の節でそれぞれ検算して確かめます。
// PENALTY_P — 直前使用ツールに REUSE_PENALTY を掛けてスコアを削る。
// 確率は e^(-delta/T) へ落ちる — 05の主役計算
const REUSE_PENALTY = 0.2;
function penalized(scores, lastIdx, T) {
const s2 = scores.slice();
if (lastIdx >= 0) {
s2[lastIdx] = s2[lastIdx] * (1 - REUSE_PENALTY);
}
return softmaxT(s2, T);
}
このデモは n8n 実行ではなく規則近似です
はじめに境界をはっきりさせておきます — このデモのツール選択・ループ進行は n8n を実際に実行した実測ではなく、n8n 公式ドキュメントに書かれたエージェントの動作を教育用の規則計算で再現した注入デモです。n8n の AI Agent ノードがプロンプトを受け取ってツールを繰り返し呼びながら回答を作ること、その繰り返しが「ツールループ」であること、そしてこの先で使うノード名 AI Agent · Window Buffer Memory · Calculator · HTTP Request · Vector Store が実在するノードであることは n8n 公式ドキュメントに基づきます。一方、デモが選択を下すジャッカード類似度とソフトマックスは n8n の内部実装ではありません — 実際の n8n エージェントのツール選択は接続したチャットモデルがプロンプトコンテキストで決めるので、このデモはその決定過程を目で見られる規則に置き換えたものであり、値が実際と異なり得ることを前提に読み進めてください。
モデル値と実測値の境界
数値の引用はモデル値と実測値を分けて書きます — 温度 T 0.25 · 再利用ペナルティ 0.2 · メモリ予算 360 · 減衰 alpha 0.72 · 09 の確定時刻 1,140ms(3ターン × 380ms の検算)のようにソースの定数から計算・検算した値がモデル値で、面積・強度・フレームはレンダラーが2秒のサイクルを24枚のスナップショットとして残し、隣り合う2枚の差23個で測った実測値です。累積面積はサイクル窓の中で最初のスナップショットから一度でも変わったピクセルが占めた割合、強度は変化ピクセルの明るさ・色差の平均値(0~255 尺度)で、レンダのゆらぎで ±0.0 前後ぶれます。
測定の正答表
注入デモのサイクルで九つの場面を回して残した数値が下の表です — シーン背景を進行値が左から右へ巡回する背景 sweep が面積の主な確保源で、どの場面も止まった区間なく窓の間じゅう動きました。
| 場面 | 累積面積 | 動いたフレーム | 強度平均 |
|---|---|---|---|
| 01 グラフコネクタビュー | 34.8% | 23/23 | 96.8 |
| 02 設定パネルフォーカス | 36.0% | 23/23 | 101.5 |
| 03 データ before/after | 34.5% | 23/23 | 117.1 |
| 04 ツール選択スコア | 35.8% | 23/23 | 89.0 |
| 05 再利用ペナルティ | 36.2% | 23/23 | 95.6 |
| 06 メモリウィンドウ減衰 | 35.7% | 23/23 | 107.3 |
| 07 ループサイクル | 36.4% | 23/23 | 102.0 |
| 08 ガードしきい値分岐 | 35.8% | 23/23 | 118.8 |
| 09 最終成果物 | 36.1% | 23/23 | 108.5 |
面積が最も広いのは 07 の 36.4% で、最も狭い 03 の 34.5% との差は 1.9 ポイントに収まります — 背景 sweep がキャンバスの大部分のピクセルを毎フレーム閾値以上動かす値伝播方式の結果です。強度は 08 の 118.8 が最も高く、ガードが分岐するフレームにループボックス全体の状態色が変わる一枚が重なるためで、04 の 89.0 が最も低いのは峰の高さの変化が緩やかな軸だからです。瞬間最大面積(要素自体の動きだけを測った値)は 09 の 12.4% · 02 の 10.6% · 07 の 10.3% の順で、はみ出し · 320px 幅のはみ出し · ロケールのはみ出しは全シーン 0 件、react 版は TypeScript コンパイル9ファイル・SCSS 単独コンパイル9ファイルがすべて通りました。
九つの場面がこの順番である理由
この順番は n8n ai エージェント ノードを扱う流れをそのままたどったものです — キャンバスを開くとまずグラフが見え(01)、ノードを押して設定を直し(02)、ツールが何を変えるかデータで確かめ(03)、どうやって一つが選ばれるかを追い(04)、同じツールばかり回る問題(05)とメモリが満ちていく問題(06)に出会い、一周の構造(07)と無限ループを断つガード(08)を経て最終成果物(09)で終わります。自動化ワークフローの9種が受け取って・回して・統合して・分けるデータの流れだったなら、今回の編はその流れの上を回るエージェントの内部を同じノードグラフの文法で開いたものです。
01AIエージェントノードとサブノードはどう繋がるか — グラフビューアで見る接続
キャンバス中央の AI Agent ノードにツール3つ(Calculator · HTTP Request · Vector Store)とメモリ(Window Buffer Memory)がコネクタでぶら下がり、走る点がこのターンで使われるサブノードの線を流れてそのノードを点灯します — 実際の n8n キャンバスでエージェントの下に垂れるコネクタがそのまま構造そのものである点を写した場面で、線ごとに位相のずれた波形が流れるので、どの線が生きているかが色ではなく流れで見えます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ツールとメモリのサブノードがAIエージェントノードに繋がり、走る点がこのターンのサブノードを照らす場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 306줄 — 아래 「전체 코드」에서 원문 전체)// GraphConnectorView - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./GraphConnectorView.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 339줄 — 아래 「전체 코드」에서 원문 전체)01 · AIエージェントノードとツール・メモリサブノードの接続グラフ — 計測 累積面積 34.845% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コネクタは角度まで計算に入れる
コネクタは SVG stroke ではなく div の回転バーで描きました。座標計算を本文の計算と同じ層に置くための選択です。コピーして使うときはサブノード配列 TOOLS01 とラベルを自分のツール名に差し替えるだけで、グラフがすぐ自分のワークフローと同じ姿になります。
const pos = [[10, 10], [10, 61], [10, 112]];
const roles = ['tool', 'tool', 'mem'];
const subs = ['calculator', 'http request', 'window buffer'];
for (let k = 0; k < 3; k += 1) {
const nd = make('div', 'nd nd--' + roles[k], scWrap);
nd.innerHTML = '<i class="' + cx('nd__t') + '">' + TOOLS01[k] + '</i><i class="' + cx('nd__s') + '">' + subs[k] + '</i>';
put(nd, pos[k][0], pos[k][1], 108, 34);
nodes01.push(nd);
const ln = make('i', 'cn', scWrap);
put(ln, 118, pos[k][1] + 16, 0, 0);
ln.style.width = '72px';
ln.style.transform = 'rotate(' + (Math.atan2(72, 60 + 17 - (pos[k][1] + 17)) * 180 / Math.PI) + 'deg)';
トリガーからノードをつなぐ通常のフロー設計が知りたければ n8n ノーコード自動化のキャンバスの節が同じ文法をデータフローで使っています。
02設定パネルは何を固定するか — システムプロンプト・最大反復・ツール権限
設定パネルの4項目 System Prompt · Tools · Memory · Max Iterations の円形ゲージが満ちていき、フォーカスリングが項目の間を巡回します。プロンプト欄のゲージは文字列を分割し、埋め込みなしの文字数比(len/384)で計算して満たします — 設定は好みではなくループが使える予算の定義なので、プロンプトが長くなるほどツール説明が読まれる枠がその分狭くなる、という視点がこの場面の主張です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="設定4項目のゲージが文字比で満ち、フォーカスリングが項目間を巡回する場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 305줄 — 아래 「전체 코드」에서 원문 전체)// SystemPromptFocus - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SystemPromptFocus.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 338줄 — 아래 「전체 코드」에서 원문 전체)02 · システムプロンプト設定パネルのフォーカス巡回 — 計測 累積面積 36.029% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
ゲージとフォーカスは一つの時計から出る
ゲージの充填率は項目ごとに決めた目標値へ収束し、フォーカスは周期の位相を4つに割って決まります。実際の n8n ai エージェント ノードの設定パネルにもこの4つがあり、うち Max Iterations は実在する反復上限の設定で、08 のガードしきい値と正確に対応します。
function frame(t) {
const ph = demoT(t) / 2000;
const focus = Math.floor(ph * 4) % 4;
const ratios = [0.48, 0.75, 0.6, 0.2];
for (let k = 0; k < 4; k += 1) {
rows02[k].classList.toggle(cx('srow--on'), k === focus);
const target = ratios[k];
const v = clamp((ph * 4 - k) , 0, 1) * target;
fills02[k].style.background = 'conic-gradient(#0a4fe8 0turn ' + f0(v * 360) + 'deg, #d5daea ' + f0(v * 360) + 'deg 360deg)';
nums02[k].textContent = f0(v * 100) + '%';
}
03ツール呼び出し前後のJSON差分 — データは何に変わるか
左の before JSON と右の after JSON が縦に流れ、2つのオブジェクトを浅く比較して変わった行だけが diffOn で光ります。cost: 0 が cost: 3 になり、status: 'pending' が 'done' へ移る場所だけが明るくなり、そのままの行は薄くなります — ツール呼び出しの効果がテキストの説明ではなくデータの差として見える場面で、方向キーで回せる3つのプリセットは正常完了 · 一部変更 · status: 'error'(timeout 30s)の失敗ケースをそれぞれ示します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ツール呼び出し前後のJSONが流れ、変わった行だけが光る場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 316줄 — 아래 「전체 코드」에서 원문 전체)// DataBeforeAfter - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./DataBeforeAfter.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 349줄 — 아래 「전체 코드」에서 원문 전체)03 · ツール呼び出し前後のJSON差分 — 計測 累積面積 34.46% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
変更行の判定は一行です
変更行の判定はキーごとの JSON 直列化比較の一行です。コピーして使うときは BEFORE03·AFTER03 の2定数を自分のツールの実際の入出力に置き換えます。入れ子のオブジェクトまで比較したい場合は、この浅い比較を再帰一層で包めば足ります。
const BEFORE03 = { query: 'rss feed', items: 20, cost: 0, status: 'pending' };
const AFTER03 = { query: 'rss feed', items: 20, cost: 3, status: 'done', tool: 'HTTP Request' };
for (let k = 0; k < keys.length; k += 1) {
const key = keys[k];
const ln = make('i', 'jl', col);
const val = objs[c][key] === undefined ? '—' : JSON.stringify(objs[c][key]);
const inB = key in objs[0];
const inA = key in objs[1];
const changed = !inB || !inA || JSON.stringify(objs[0][key]) !== JSON.stringify(objs[1][key]);
if (c === 1 && changed) { diffset03.push(k); }
ln.textContent = ' ' + key + ': ' + val + (k < keys.length - 1 ? ',' : '}');
if (c === 1 && changed) { ln.className = cx('jl') + ' ' + cx('jl--diff'); }
04ツールはどう選ばれるか — キーワード類似度スコアとソフトマックス近似
自然言語のクエリをトークン化し、各ツール説明とのジャッカード重なり(積集合 ÷ 和集合)でスコアを出すと、3つのツールの峰がスコアに比例して立ち上がり、温度 T 0.25 のソフトマックスで正規化された時点で選択矢印が最高峰へ折れます — 埋め込みなしのキーワード重なりだけでどのツールが呼ばれるかが計算され、スコアが接近すると確率が揺れて選択が毎回変わる性質まで規則で再現されます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="クエリとツール説明の重複スコアが棒になって立ち、ソフトマックス正規化のあと矢印が最高峰へ折れる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)// ToolSelectScore - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ToolSelectScore.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 346줄 — 아래 「전체 코드」에서 원문 전체)04 · ツール選択 — キーワード類似度スコアの計算 — 計測 累積面積 35.798% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
検算 — ジャッカードから矢印まで
クエリ「コストを計算して calculate cost」のトークン [コスト, 計算, calculate, cost] と Calculator の説明 [math, calculate, sum, cost, numbers] の積集合は {calculate, cost} の2個・和集合は7個なので、ジャッカードは 2/7 ≈ 0.286 にシード加重(約1.0)を掛けて約 0.29 です。HTTP Request は積集合が0なので基本値 0.04 · seedHash だけが残り、ソフトマックス T 0.25 で Calculator の確率は約 60~70% になります — 画面の選択矢印が指す値がこの計算そのものです。実戦でも n8n ai エージェント ツールの説明欄に同義語を入れておくとモデルの選択精度が上がる原理が、この重なりと同じ方向に働きます。
const TOOLS04 = [
['Calculator', 'math calculate sum cost numbers'],
['HTTP Request', 'fetch http page url request api'],
['Vector Store', 'memory search recall past conversation']
];
function frame(t) {
const ph = clamp(demoT(t) / 1500, 0, 1);
const T = 0.25;
const probs = softmaxT(scores04, T);
let mx = 0;
for (let k = 1; k < 3; k += 1) { if (probs[k] > probs[mx]) { mx = k; } }
for (let k = 0; k < 3; k += 1) {
const h = clamp(ph * probs[k] * 200, 0, 92);
bars04[k].style.height = h + 'px';
05部分思考はなぜ重複呼び出しを生むか — 同一ツール再選択ペナルティ
直前に使ったツールのスコアに REUSE_PENALTY 0.2 を課して再選択確率を削る様子を、8ターンのシミュレーションを縦ヒストグラムに積んで示します。ペナルティが有効なプリセットでは選択の分布が広がり、無効のプリセットでは一つのツールが8ターン中4回を占めます — 実際のエージェントが同じツールを繰り返し呼びながらターン予算を燃やすパターンと同じ形を、対比で示します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ペナルティありではヒストグラムが広がり、なしでは1ツールがループを占領する対比の場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 309줄 — 아래 「전체 코드」에서 원문 전체)// ToolReusePenalty - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./ToolReusePenalty.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 342줄 — 아래 「전체 코드」에서 원문 전체)05 · 重複排除 — 同一ツール再選択ペナルティ — 計測 累積面積 36.226% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
検算 — 確率は e^(-Δ/T) へ落ちる
ペナルティはスコアの減衰 Δ = 0.2·s を作り、ソフトマックスを再度通すと再選択確率の減少比は e^(−Δ/T) です。s = 0.4 · T = 0.25 なら Δ = 0.08 なので e^(−0.32) ≈ 0.73、つまり約27%の減少です。ペナルティを 0.45 に上げると e^(−0.72) ≈ 0.49 まで落ち、半減に近づきます。
function build(i) {
const useP = i !== 2; // プリセット3はペナルティなし(対比)
turns05 = [];
let last = -1;
for (let s = 0; s < 8; s += 1) {
const sc = [0.3 + 0.2 * seedHash(s, 11), 0.28 + 0.2 * seedHash(s, 22), 0.25 + 0.2 * seedHash(s, 33)];
const p = useP ? penalized(sc, last, 0.2) : softmaxT(sc, 0.2);
let r = seedHash(s, 44);
let pick = 0;
let acc = 0;
for (let k = 0; k < 3; k += 1) { acc += p[k]; if (r < acc) { pick = k; break; } }
turns05.push(pick);
last = pick;
}
06メモリウィンドウはどう縮むか — ターンごとに減衰するコンテキスト予算
各ターンのトークン数が縦棒に積まれ、合計の高さが予算 360 を超えた瞬間に古いターンから alpha 0.72 の指数減衰で低くなります。忘れられたターンは残りの高さを失い、点線の輪郭だけが残ります — 減衰後の合計は毎ターン再計算されて予算を超えず、実際の n8n の Window Buffer Memory ノードが直近 N ターンの会話を保つのがこのウィンドウ概念の原型です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ターンのトークンが積まれ、予算を超えると古いターンから指数減衰で食べられる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 319줄 — 아래 「전체 코드」에서 원문 전체)// MemoryWindowDecay - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./MemoryWindowDecay.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 352줄 — 아래 「전체 코드」에서 원문 전체)06 · メモリウィンドウ — ターンごとに減衰するコンテキスト予算 — 計測 累積面積 35.669% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
検算 — 古い2ターンが削られる
ターンの高さ [50, 40, 60, 55, 70, 60, 45] の合計 380 が予算 360 を超えると、最初のターン 50 は 50 × 0.72 = 36 になって合計 366、まだ超過するので2番目のターン40が × 0.72² = 20.7 と削られ、合計 346.7 ≤ 360 で止まります。k 回目の減衰は alpha^k で進むので、十分に古いターンは事実上 0 に収束します。コピーするときは BUDGET06 を自分のモデルのコンテキスト窓に合わせればよく、ALPHA06 を 1 に近づけるほど忘れ方が緩やかになります。
// MEM_DECAY — 予算超過時に古いターンの高さを alpha^k で減衰 (06の主役計算)
function memDecay(heights, budget, alpha) {
let total = 0;
for (let i = 0; i < heights.length; i += 1) { total += heights[i]; }
const out = heights.slice();
let k = 0;
let idx = 0;
while (total > budget && idx < out.length) {
out[idx] = heights[idx] * Math.pow(alpha, k + 1);
total = 0;
for (let i = 0; i < out.length; i += 1) { total += out[i]; }
k += 1;
idx += 1;
}
return out;
}
07ツールループサイクルは一周が3局面か — 呼び出し・結果・部分思考
1.9秒のフレームを3局面 — ツール呼び出し(call)33% · 結果の読み込み(load result)33% · 部分思考(partial think)34% — に分け、角の丸い正方形のペタルのパスの上を点が巡航します。到達した局面のペタルがその局面色で満ち、思考の局面には進捗率カウンターが付きます — 局面の境界は rAF で位相を実測して決めるので、視覚の累積誤差が局面を飛び越えることがありません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ループ一周が3局面に分かれ、点がペタルを巡航し、局面の進捗がカウンターで読める場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 310줄 — 아래 「전체 코드」에서 원문 전체)// LoopCycleRounds - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./LoopCycleRounds.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 343줄 — 아래 「전체 코드」에서 원문 전체)07 · ツールループサイクル — 呼び出し・結果・部分思考の一周 — 計測 累積面積 36.444% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
3局面は実際のターンの構造のままです
n8n 公式ドキュメントが説明するツールループは、プロンプト → ツール呼び出し → 結果の受信 → 次の判断の反復です。思考の局面が 34% を占める配分が示すとおり、1ターンの3分の2がツールを呼んで・待って・読む時間なので、遅いワークフローを直すにはモデルの速度より先にツールの応答速度を見るのが順序です。
const PHASES07 = [['call tool', 0.33], ['load result', 0.33], ['partial think', 0.34]];
const ph = (t % 1900) / 1900;
let acc = 0;
let cur = 0;
for (let k = 0; k < 3; k += 1) {
acc += PHASES07[k][1];
if (ph < acc) { cur = k; break; }
cur = k;
}
for (let k = 0; k < 3; k += 1) {
petals07[k].classList.toggle(cx('phasepet--on'), k === cur);
}
08無限ループはどこで切れるか — 反復しきい値と失敗経路の分岐
左のツールループが反復するたびにしきい値曲線(threshold)が 12px ずつ上へ狭まり、5回目の反復でループの印が曲線に触れると、そのフレームでループボックスが失敗状態にロックされ、右側の失敗経路の Notify ノードが浮かび上がります — 発生時刻は区間 340ms × 5 = 1,700ms と計算されて毎サイクル同じフレームで起こり、実際の AI Agent ノードの Max Iterations 設定が無限ループを断つ役割と正確に対応するガードです。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="反復が重なるたびにしきい値曲線が狭まり、5回目でループが止まり失敗経路が点く場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 309줄 — 아래 「전체 코드」에서 원문 전체)// GuardThresholdBreak - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./GuardThresholdBreak.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 342줄 — 아래 「전체 코드」에서 원문 전체)08 · ループガード — 反復しきい値を超えて失敗経路へ分岐 — 計測 累積面積 35.812% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
ガードは確率ではなく算術です
反復インデックスが上限に達したかを毎フレーム判定し、達した瞬間に状態を分岐一回で変える、それがすべてです。コピーするとき MAX_ITER08 を 3 に下げると 340 × 3 = 1,020ms の3回目の反復でただちに失敗経路へ分かれ、失敗経路が画面の主役になります。
// 08 ガード — 反復ごとにしきい値曲線(thresholdCurve)が狭まり、5回目でループが
// 曲線に触れると(loopGuard)失敗経路(failBranch: 通知ノード)へ分岐する。
const MAX_ITER08 = 5;
function frame(t) {
const seg = 340;
const it = clamp(Math.floor(demoT(t) / seg), 0, 5);
const maxIter = lpsegs08.length;
const broke = it >= maxIter;
for (let k = 0; k < maxIter; k += 1) {
const on = k < it;
lpsegs08[k].style.opacity = on ? '1' : '0.25';
thsegs08[k].style.opacity = '1';
}
loopbox08.classList.toggle(cx('nd--on'), !broke);
loopbox08.classList.toggle(cx('nd--fail'), broke);
notify08.style.opacity = broke ? '1' : '0';
09最終成果物はいつ確定するか — ループ終了後の回答カード
ループが終わると、それまで上がってきたツールカードの束がスタックへ折りたたまれて下がり、最終回答カードが浮かび上がります。確定時刻はターン数 3 × TURN_MS 380 = 1,140ms と計算され、回答カードの信頼度バーはツールスコアの合計を Σscore / max(Σscore, 1) で正規化した値で、used 3 tools バッジがループが実際に3ターン回った痕跡を残します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="ループが終わるとツールカードがスタックへ畳まれ、信頼度バーの付いた回答カードが確定する場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 532 공통 — n8n AI 에이전트 도구 루프 (529 base.scss 계승: 채팅 버블 대신 노드 그래프·설정 패널 요소로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: #6d675f; // mix(cream,ink,45%)#7f7a76 은 크림 위 3.98:1 로 미달 — 한 단계 내려 5.25:1
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 518줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 532 공통 엔진 — 529 run() 시계 계승 (WAAPI 시계읽기·pause·rebuild·reduced 분기)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 322줄 — 아래 「전체 코드」에서 원문 전체)// FinalArtifactClear - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./FinalArtifactClear.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): (() => void) | undefined {
const rootEl: HTMLElement | null = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
… (총 355줄 — 아래 「전체 코드」에서 원문 전체)09 · 最終成果物 — ループ終了後に確定する回答カード — 計測 累積面積 36.059% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
settle の判定も算術です
時刻がターン数 × TURN_MS を過ぎたかを一度比較し、過ぎたときだけカードの状態を変えるのが判定のすべてです。信頼度バーの正規化は 1 を超えないようクランプするので、ツールを追加してもバーが溢れることはありません。
// 09 成果物 — ループ終了(ターン数 × TURN_MS 計算)後にツールカードがスタックへ折りたたまれ
// 回答カード(artifactCard)が浮かぶ。信頼度バーはスコア合計の正規化(scoreNormalize)。
const TURN_MS09 = 380;
function frame(t) {
const settle = 3 * TURN_MS09;
const done = demoT(t) >= settle;
const shown = clamp(Math.floor(demoT(t) / TURN_MS09), 0, 3);
for (let k = 0; k < 3; k += 1) {
const c = cards09[k];
if (k < shown && !done) {
c.style.opacity = '1';
c.style.transform = 'translateY(0)';
}
else if (done) {
c.style.opacity = '1';
c.style.transform = 'translateY(' + (k % 2 === 0 ? 44 : 58) + 'px)';
ツールループのデモが壊れる瞬間 — 瞬間完成・ガードなし分岐・メモリ無限増加
瞬間完成はエージェントではありません
ループの痕跡なしに回答カードだけが先に見えると、何が答えを作ったのか分からなくなります — 09 は確定時刻(3 × 380ms)を計算してツールカードが折りたたまれる瞬間と回答カードが浮かぶ瞬間を同一フレームに合わせ、used 3 tools バッジでターン数を残します。UI を作るときこの原則をそのまま移すと、完成前のローディングと完成後の答えが同じ場所で状態として分かれます。生成を待つ間の表示を集めた AIスケルトン・プレースホルダーがこのローディング軸の仲間です。
ガードなしの分岐は「なぜ止まったか」を消す
08 でしきい値曲線なしに5回目でいきなり分岐すると、失敗が事件ではなく事故になります — しきい値が反復ごとに 12px ずつ狭まる計算があって初めて失敗時刻(340 × 5 = 1,700ms)が予測可能になり、実戦の Max Iterations も同じ理由で既定値のまま有効にしておきます。失敗経路に実際につなぐノードは通知が定番で、n8n スケジュール自動化の失敗通知の節が同じ分岐をスケジュール軸で扱っています。
メモリの無限増加はコストの暴騰として戻ってくる
06 で減衰なしにターンを積み続けると、コンテキストが予算を超え、コストと遅延が暴走します — ウィンドウ減衰が実際のシステムの第一の防御線で、n8n の Window Buffer Memory が直近 N ターンだけを保つのも同じ防御です。減衰の代わりに直近 N ターンを丸ごと捨てるハードカットを使いたい場合は、memDecay の while 文をスライス一行に置き換えるだけで済みます。
重複呼び出しは探索を殺します
05 のペナルティなしプリセットでは一つのツールが8ターン中4回を占めます — 同じツールの反復呼び出しはターン予算を燃やすだけで、新しい情報を何も運びません。この zip を開くときのパスワードは fgsdq75n で、展開すると九つの場面の index.html · style.scss · style.css と react 版がすべてそのまま入っています。n8n のノードには再選択ペナルティに相当する規則設定がないので、実戦の第一の対応はシステムプロンプトに「すでに得た結果を再び要求しない」という指示を入れることです。REUSE_PENALTY の値は 0.45 に上げると重複排除が強まる一方で、やり直しの再呼び出しまで抑えてしまうことがあるので 0.2~0.45 の間で調整します。このデモが n8n の実測ではなく教育用の規則近似であるという境界をもう一度書いておきます — ノード名とループ構造は公式ドキュメントに基づきますが、ジャッカード・ソフトマックス・減衰の値はこのデモの計算です。
値を3つだけ変えるとループの性格はどう変わるか
ここでは計算に手を付けず、変数を一行ずつだけ動かした組み合わせ3つを比べます — 時間軸・ペナルティ・しきい値のどれか一つだけを動かす形です。
| 名前 | 変える値 | 感じ |
|---|---|---|
| ループ速度を上げる | s07 局面周期 1900 → 950(t % 1900 リテラル) | 局面の一周が半分に縮み、ループが2倍速く回る — スコア・ガードの計算は不変なので、流れの形を保ったまま時間軸だけが縮む |
| 重複ペナルティを強く | core REUSE_PENALTY 0.2 → 0.45 | 再選択確率の減少が e^(−0.32) ≈ 0.73 から e^(−0.72) ≈ 0.49 へ半減に近づく — 05 の分布で直近ツールの峰がくっきり低くなり、探索が広がる |
| ガードしきい値を下げる | s08 MAX_ITER 5 → 3 | 3回目の反復(340 × 3 = 1,020ms)でただちに失敗経路へ分岐する — しきい値曲線が左へ引き寄せられ、ガードが介入する地点が目に見えて早くなる |
一つ目の値はループの時間軸、二つ目は選択の分布、三つ目は失敗の時点をそれぞれ支配します — 三つを同時に動かすと、どの変化が何から来たのか分からなくなるので、原因を見るときは一か所ずつ変えます。どの行を書き換えるかは、ソース内のコメントがすぐ上に示してくれます。
画面読み上げと動きの抑制 — ツールループのアクセシビリティ
ループの状態は色だけで伝えません — 進行中の局面と失敗分岐はラベルと形(ペタルの充填 · ループボックスの境界線 · Notify ノードの出現)でも区別でき、ツール名が読み上げに不要な繰り返しを起こさないよう状態行の aria-live は切って、ステップ完了の文だけを role="status" で知らせます。一時停止は本物の <button> なのでキーボードで操作でき、Space·R·方向キーのプリセット切替も実際に動きます。
@media (prefers-reduced-motion: reduce) {
.ez * { animation: none !important; transition: none !important; }
.ez__pause { transition: none !important; }
}
この減速設定ではループを止めて完了状態の一枚だけを残します — 回答カードと used 3 tools バッジが静止画にそのまま残るので、情報は減りません。prefers-reduced-motion は Chrome がバージョン 74 から、Firefox が 63 から、Safari が 10.1 から対応しており、更新の届くブラウザならすべて受け入れます。このデモのトーンはクリーム背景にパステルのパレットで、軸ラベルまでの対比実測29行すべてが通常テキストのしきい値 4.5:1 を超えました — 最低の軸ラベルでも 5.35:1 です。
ツールループのデモを受け取る前に よくある質問
n8n ai エージェントの MCP サーバーをこのデモに接続できますか?
このデモは外部呼び出しのない注入デモなので、MCP サーバーを直接呼びません — 01 のツール名を MCP ツールに置き換え、03 の before/after を MCP の応答ログで埋めれば、図の構造はそのまま生きます。実際の接続は n8n のキャンバスで AI Agent ノードに MCP ツールをサブノードとして付けることで、デモはその接続がループでどう見えるかを先に確認する用途です。
この zip のコードを n8n ワークフローにそのまま貼り付けていいですか?
いいえ — このアーカイブの中身は HTML·SCSS のシーンと react 版で、n8n に読み込ませるワークフロー JSON は含まれていません。n8n に持っていく JSON が必要ならワークフロー自動化の9種の zip を使い、この編はエージェントのループを理解し可視化する資料として隣に置くとちょうどいいです。
デモの確率計算とペナルティ・ガードは実際の n8n と同じですか?
違います — 実際の n8n エージェントのツール選択は接続したチャットモデルがプロンプトコンテキストで決めます。このデモのジャッカード類似度・ソフトマックスはその決定を規則で再現した教育用の近似です。ただし温度が低いほど選択が独占され、ペナルティが再選択を削る性質は実際のシステムでも同じ方向に働き、ガードに当たる Max Iterations 設定は実在するので、有効にしておくだけで無限ループが断たれます。
ai エージェント軸の次の編は AIプロンプト入力の補完とAIスケルトン・プレースホルダーへ続き、エージェントを実際に回すデータ側はワークフロー自動化の9種から始めればいいです。









