recipe_run

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

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

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

macOS

Назначение

Выполняет рецепт от начала до конца: связывает параметры, последовательно запускает инструмент каждого шага через реестр, сохраняет запуск (см. recipe_runs) и возвращает результат каждого шага вместе с markers_path, если он есть. Рецепты с шагами, изменяющими состояние (запись/отправка/удаление), сначала показывают PREVIEW — для выполнения вызовите снова с confirm:true; рецепты только для чтения запускаются сразу. Ошибка на любом шаге останавливает запуск и включается в отчет.

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

name

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "confirm": {
      "description": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
      "type": "boolean"
    },
    "name": {
      "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

Назначение

Выполняет сохраненный рецепт от начала до конца: связывает параметры, последовательно запускает инструмент каждого шага, записывает запуск (см. recipe_runs) и возвращает результат каждого шага. Шлюз подтверждения: без confirm:true возвращает DRY-RUN PREVIEW упорядоченных шагов со связанными аргументами; для выполнения вызовите снова с confirm:true. Ошибка на любом шаге останавливает запуск и включается в отчет.

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

name

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

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

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