본문으로 건너뛰기
모든 도구

recipe_run

스킬 및 레시피 · macOS · Windows

효과: 실행. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

레시피를 처음부터 끝까지 실행합니다. 매개변수를 바인딩하고, 레지스트리를 통해 각 단계의 도구를 순서대로 실행하며, 실행 기록을 저장하고(recipe_runs 참조) 각 단계의 결과와 markers_path가 있으면 함께 반환합니다. 상태를 변경하는 단계(쓰기/보내기/삭제)가 있는 레시피는 먼저 미리보기를 반환하며, 실행하려면 confirm:true로 다시 호출하세요. 읽기 전용 레시피는 즉시 실행됩니다. 이 확인은 실행을 시작할 뿐 다른 것은 하지 않으며, 단계는 스스로 확인할 수 없습니다. 단계 args의 `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

목적

저장된 레시피를 처음부터 끝까지 실행합니다. 매개변수를 바인딩하고, 각 단계의 도구를 순서대로 실행하며, 실행을 기록하고(recipe_runs 참조) 각 단계의 결과를 반환합니다. 확인 게이트: confirm:true가 없으면 바인딩된 args와 함께 순서대로 나열된 단계의 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"
}