Магические переменные
Обзор
Магические переменные — объявленные поля ввода, которые запускают поведение помимо обычного сохранения в контекст. Ниже показаны фрагменты полей: полному agent-узлу также нужны type, id, directive, completionCondition и connections. Магическое поле не становится автоматически глобалом с коротким именем.
execution_note
Обновляет произвольную заметку execution для отслеживания. Она не задаёт заголовок задачи. Название устанавливается и меняется через метаданные запуска.
Использование
{ "inputSchema": { "type": "object", "properties": { "execution_note": { "type": "string", "description": "Note to identify this execution" } } }}Поведение
Когда агент предоставляет execution_note:
- Значение сохраняется в контексте как обычно
- Поле
noteзаписи execution обновляется в базе данных - Заметка видна в списках execution и запросах session
При показанном объявлении в properties значение остаётся локальным и читается как node-id.execution_note. Для короткого глобального имени объявите его в variableRegistry и записывайте через globalInputs.
Варианты использования
Отслеживание текущей работы:
{ "directive": "Document what you're working on for tracking.", "inputSchema": { "properties": { "execution_note": { "type": "string", "description": "Feature/task being developed" } }, "required": ["execution_note"] }}Обновление заметки при изменении задачи:
{ "directive": "Task requirements changed. Update the execution note.", "inputSchema": { "properties": { "execution_note": { "type": "string" } } }}execution_note проходит через валидацию inputSchema. Включите в массив required, чтобы обязать
агентов передавать заметку по контракту этой ноды; это не требует и не устанавливает название задачи.
Запрос заметок
Заметки отображаются в запросах session:
mcp__moira__execution({ action: "executions" });// Возвращает executions с заполненным полем noteСистемные переменные
Эти переменные автоматически доступны в контексте:
executionId
ID текущего процесса выполнения.
{{executionId}}workflowId
Идентификатор текущего workflow.
{{workflowId}}runUrl
Страница прогона в веб-интерфейсе, собранная из настроенного хоста и базового пути сервера
(<протокол>://<хост>[/<базовый путь>]/executions/<executionId>, где протокол — http для хоста
localhost и https для остальных). Уведомление уже ссылается на неё из
заголовка; используйте переменную, чтобы указать на прогон в любом другом тексте.
{{runUrl}}userId
Пользователь, которому принадлежит исполнение: {{userId}}. Переменная не даёт полномочий выполнять операции за другого пользователя.
Пример использования
{ "directive": "Process ID: {{executionId}}\nWorkflow: {{workflowId}}\n\nDocument this for reference."}Переменные выражений
Переменные, изменяемые узлами expression:
Переменные-счётчики
Объявляются как глобальные в variableRegistry со значением default:
{ "variableRegistry": { "current_step_index": { "type": "number", "description": "Текущий индекс шага", "default": 1 }, "current_iteration": { "type": "number", "description": "Текущая итерация", "default": 1 } }}Изменяются выражением (узлы expression присваивают глобальным переменным по короткому имени):
{ "type": "expression", "expressions": ["current_step_index = current_step_index + 1", "current_iteration = 1"]}Объявляйте переменные-счётчики в variableRegistry со значением default, чтобы они существовали
до обращения из узлов expression.
Обработка шаблонов
Все магические и контекстные переменные работают с шаблонами:
Простой доступ
{{variable_name}}Вложенный доступ
{{user.profile.name}}Доступ к массиву
{{items[0]}}{{items[0].field}}Условные шаблоны
{{#if intake.execution_note}}Note: {{intake.execution_note}}{{/if}}Здесь intake — узел, объявивший и вернувший локальное поле.
Смотрите также
- Input Schema - Валидация входных данных магических переменных
- Шаблоны - Синтаксис шаблонов