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

Обзор

Магические переменные — это специальные поля ввода, которые запускают автоматическое поведение помимо обычного сохранения в контекст.

execution_note

Обновляет поле заметки execution для целей отслеживания.

Использование

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "execution_note": {
        "type": "string",
        "description": "Note to identify this execution"
      }
    }
  }
}

Поведение

Когда агент предоставляет execution_note:

Значение сохраняется в контексте как обычно
Поле note записи execution обновляется в базе данных
Заметка видна в списках execution и запросах session

Варианты использования

Отслеживание текущей работы:

{
  "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" }
    }
  }
}

Запрос заметок

Заметки отображаются в запросах session:

mcp__moira__session({ action: "executions" });
// Возвращает executions с заполненным полем note

Системные переменные

Эти переменные автоматически доступны в контексте:

executionId

ID текущего процесса выполнения.

{{executionId}}

workflowId

Идентификатор текущего workflow.

{{workflowId}}

Пример использования

{
  "directive": "Process ID: {{executionId}}\nWorkflow: {{workflowId}}\n\nDocument this for reference."
}

Переменные выражений

Переменные, изменяемые узлами expression:

Переменные-счётчики

Устанавливаются в initialData:

{
  "initialData": {
    "current_step_index": 1,
    "current_iteration": 1
  }
}

Изменяются выражением:

{
  "type": "expression",
  "expressions": ["current_step_index = current_step_index + 1", "current_iteration = 1"]
}

Обработка шаблонов

Все магические и контекстные переменные работают с шаблонами:

Простой доступ

{{variable_name}}

Вложенный доступ

{{user.profile.name}}

Доступ к массиву

{{items[0]}}
{{items[0].field}}

Условные шаблоны

{{#if execution_note}}Note: {{execution_note}}{{/if}}

Смотрите также

Input Schema - Валидация входных данных магических переменных
Шаблоны - Синтаксис шаблонов