recipe_install

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

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

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

macOS

Назначение

Устанавливает навык (SKILL) сообщества по id (из recipe_discover) на этот Mac, чтобы recipe_run мог его использовать. Установка только сохраняет навык. Его запуск требует одного подтверждения, если в нём есть шаги, меняющие состояние (отправка/запись/удаление), а шаг не может подтвердить сам себя: `confirm` в аргументах шага здесь удаляется (confirm_removed_steps) и игнорируется при запуске, поэтому шаг, чей инструмент запрашивает подтверждение, отвечает предпросмотром вместо выполнения. Если навык с таким именем уже существует, он сохраняется под неконфликтующим именем. Первый вызов показывает предпросмотр; confirm: true скачивает и сохраняет. Возвращает {name, installed}.

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

id

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

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

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

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

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

{
  "properties": {
    "confirm": {
      "description": "Must be true to download and save the skill. Without it the call returns a preview and contacts nothing.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

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

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

{
  "confirm": false,
  "id": 101
}

Windows

Назначение

Устанавливает навык (SKILL) сообщества по id (из recipe_discover) на этот компьютер, чтобы recipe_run мог его использовать. Безопасно: установка только сохраняет навык; шаг не может подтвердить сам себя, поэтому при последующем запуске шаг, чей инструмент запрашивает подтверждение (отправить, удалить, заменить файл, выполнить команду), возвращает предпросмотр и ничего не меняет. Если навык с таким именем уже существует, он сохраняется под неконфликтующим именем. Первый вызов возвращает предпросмотр с перечнем шагов навыка и ничего не сохраняет; confirm=true сохраняет. Возвращает {name, imported}.

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

id

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

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

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

{
  "properties": {
    "confirm": {
      "description": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

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

{
  "confirm": false,
  "id": 101
}