Перейти к содержимому

Магические переменные

Обзор

Магические переменные — объявленные поля ввода, которые запускают поведение помимо обычного сохранения в контекст. Ниже показаны фрагменты полей: полному 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:

  1. Значение сохраняется в контексте как обычно
  2. Поле note записи execution обновляется в базе данных
  3. Заметка видна в списках 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 - Валидация входных данных магических переменных
  • Шаблоны - Синтаксис шаблонов