Все инструменты

recipe_save

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

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

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

macOS

Назначение

Сохраняет повторно используемый SKILL — именованный рецепт (упорядоченную последовательность вызовов инструментов LMCP с параметрами) — на этом Mac, чтобы пользователь мог в любое время снова запустить его через recipe_run. Пользователь может сохранить его, чтобы превратить регулярно повторяемый многошаговый процесс LMCP (утреннюю сводку, разбор входящих, еженедельный отчет, получение данных) в одну повторно используемую команду. Сохраненными навыками можно делиться с другими через recipe_export. Манифест должен содержать имя и непустой массив шагов. Возвращает {name}.

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

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

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

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Каноническая техническая схема на английском — macOS
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"params\": [{\"name\": string, \"type\": \"string\"|\"int\"|\"bool\", \"default\": any}], \"steps\": [ ... ] (required, non-empty), \"outputs\": [{\"kind\": string}]}. A step is EITHER a tool call {\"tool\": <tool_name>, \"args\": {...}} OR a pause {\"wait\": {\"seconds\": N}} (also {\"wait\": N}). Any arg string may interpolate a declared param with ${name} (e.g. \"limit\": \"${count}\"); an arg that is exactly \"${name}\" keeps the param's type. Steps run in order; a later step can consume an EARLIER step's output with \"${steps[N].result.KEY}\" (0-based; supports .key and [i], e.g. \"account\": \"${steps[0].result.accounts[0].name}\"). On recipe_run a state-changing step previews first unless confirm:true.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

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

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

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}

Windows

Назначение

Сохраняет повторно используемый SKILL — именованный рецепт (упорядоченную последовательность вызовов инструментов LMCP с параметрами) — на этой машине, чтобы пользователь мог в любое время снова запустить его через recipe_run. Пользователь может сохранить его, чтобы превратить регулярно повторяемый многошаговый процесс LMCP (утреннюю сводку, разбор входящих, еженедельный отчет, получение данных) в одну повторно используемую команду. Манифест должен содержать имя и непустой массив шагов. Строковый аргумент может подставлять объявленный параметр через ${name}; аргумент, в точности равный "${name}", сохраняет тип параметра. Более поздний шаг может использовать результат предыдущего через "${steps[N].result.KEY}" (нумерация с 0; поддерживаются .key и [i]). Возвращает {name, step_count}.

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

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

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

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Каноническая техническая схема на английском — Windows
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"schema_version\": int, \"params\": [{\"name\": string, \"type\": string, \"default\": any}], \"steps\": [{\"tool\": string, \"args\": object}] (required, non-empty)}.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

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

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

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}