İçeriğe geç
Tüm araçlar

recipe_run

Beceriler ve tarifler · macOS · Windows

Etki: çalıştırma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Bir tarifi (recipe) baştan sona yürütür: parametreleri bağlar, her adımın aracını kayıt defteri üzerinden sırayla çalıştırır, çalıştırmayı saklar (bkz. recipe_runs) ve her adımın sonucunu ve varsa markers_path değerini döndürür. Durum değiştiren adımları (yazma/gönderme/silme) olan tarifler önce ÖNİZLENİR: çalıştırmak için confirm:true ile tekrar çağırın; salt okunur tarifler hemen çalışır. Bu onay yalnızca çalıştırmayı başlatır, başka bir şey yapmaz: bir adım kendi kendini onaylayamaz. Bir adımın args içindeki `confirm` yok sayılır (önizleme ve çalıştırma raporu o adımı confirm_ignored olarak işaretler), bu yüzden aracı kendi onayını isteyen bir adım önizlemesiyle yanıt verir ve YÜRÜTÜLMEZ (çalıştırma raporu onu previewed olarak işaretler ve previewed_steps içinde listeler); bunu yapmak için o aracı doğrudan çalıştırın. Hata veren bir adım (yanıtında bir hata veya bir ret) çalıştırmayı durdurur ve bildirilir (adımın error_key değeriyle stopped_at); aracı tools/list içinde bu Mac'in sunmadığı bir adım reddedilir (tool_not_advertised). İkisi de, adım "optional": true olarak işaretlenmedikçe çalıştırmayı durdurur; işaretliyse hata sonucunda ve skipped_optional içinde kaydedilir ve çalıştırma sürer.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

recipe_run için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

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

Windows

Amaç

Kayıtlı bir tarifi baştan sona yürütür: parametreleri bağlar, her adımın aracını sırayla çalıştırır, çalıştırmayı kaydeder (bkz. recipe_runs) ve her adımın sonucunu döndürür. Onay kapısı: confirm:true olmadan, sıralı adımların bağlı bağımsız değişkenleriyle birlikte bir DRY-RUN ÖNİZLEMESİ döndürür; yürütmek için confirm:true ile tekrar çağırın. Hata veren bir adım çalıştırmayı durdurur ve bildirilir (stopped_at); adım "optional": true olarak işaretlenmişse hata sonucunda ve skipped_optional içinde kaydedilir ve çalıştırma sürer. Bir adım kendi kendini onaylayamaz: bir adımın bağımsız değişkenlerindeki confirm yok sayılır (adım confirm_ignored der), bu yüzden aracı onay isteyen bir adım (göndermek, silmek, bir dosyayı değiştirmek, bir komut çalıştırmak için) o aracın önizlemesini döndürür ve hiçbir şeyi değiştirmez; değişikliği yapmak için kullanıcı onayladıktan sonra o aracı doğrudan çağırın.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

recipe_run için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

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