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

recipe_run

Навыки и сценарии · macOS · Windows

Эффект: выполнение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Выполняет рецепт от начала до конца: привязывает params, запускает инструмент каждого шага по порядку через реестр, сохраняет запуск (см. recipe_runs) и возвращает результат каждого шага и markers_path, если он есть. Рецепты с шагами, меняющими состояние (запись/отправка/удаление), сначала показывают ПРЕДПРОСМОТР — вызовите снова с confirm:true, чтобы запустить; рецепты только для чтения запускаются сразу. Это подтверждение только запускает выполнение и ничего больше: шаг не может подтвердить сам себя. `confirm` в аргументах шага игнорируется (предпросмотр и отчёт о запуске помечают такой шаг confirm_ignored), поэтому шаг, чей инструмент запрашивает собственное подтверждение, отвечает предпросмотром и НЕ выполняется (отчёт о запуске помечает его previewed и перечисляет в previewed_steps) — чтобы выполнить его, запустите этот инструмент напрямую. Шаг с ошибкой (ошибка в ответе или отказ) останавливает запуск и попадает в отчёт (stopped_at, с error_key шага); шаг, инструмента которого этот Mac не предлагает в tools/list, отклоняется (tool_not_advertised). Любой из этих случаев останавливает запуск, если шаг не помечен "optional": true — тогда ошибка записывается в его результат и в skipped_optional, а запуск продолжается.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — macOS
{
  "properties": {
    "confirm": {
      "description": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
      "type": "boolean"
    },
    "name": {
      "description": "Name of the saved skill (recipe) to run, exactly as recipe_list reports it.",
      "type": "string"
    },
    "params": {
      "description": "Param overrides (merged over the recipe defaults).",
      "type": "object"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Пример для документации

Пример документации для recipe_run. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "name": "Demo morning brief"
}

Windows

Назначение

Выполняет сохранённый рецепт от начала до конца: привязывает params, запускает инструмент каждого шага по порядку, записывает запуск (см. recipe_runs) и возвращает результат каждого шага. Подтверждение: без confirm:true возвращает DRY-RUN ПРЕДПРОСМОТР с упорядоченными шагами и их привязанными аргументами; вызовите снова с confirm:true, чтобы выполнить. Шаг с ошибкой останавливает запуск и попадает в отчёт (stopped_at), если только шаг не помечен "optional": true — тогда ошибка записывается в его результат и в skipped_optional, а запуск продолжается. Шаг не может подтвердить сам себя: confirm в аргументах шага игнорируется (шаг сообщает confirm_ignored), поэтому шаг, чей инструмент запрашивает подтверждение (отправить, удалить, заменить файл, выполнить команду), возвращает предпросмотр этого инструмента и ничего не меняет; чтобы внести изменение, вызовите этот инструмент напрямую после одобрения пользователя.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — Windows
{
  "properties": {
    "confirm": {
      "description": "Set true to execute; without it a dry-run preview is returned.",
      "type": "boolean"
    },
    "name": {
      "description": "Recipe name (from recipe_list).",
      "type": "string"
    },
    "params": {
      "description": "Param overrides (merged over the recipe defaults).",
      "type": "object"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Пример для документации

Пример документации для recipe_run. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "name": "Demo morning brief"
}