ข้ามไปยังเนื้อหา
เอกสาร V1
การกำหนดค่า

นโยบาย

นโยบายควบคุมว่า OpenCode สามารถดำเนินการกับทรัพยากรที่ระบุชื่อได้หรือไม่ ฟีเจอร์นี้ของ OpenCode 2 ยังอยู่ในขั้นทดลอง และกำหนดค่าผ่านอาร์เรย์ experimental.policies ใน opencode.json

นโยบายแยกจาก สิทธิ์ สิทธิ์ควบคุมว่าเครื่องมือทำอะไรได้บ้างระหว่างเซสชัน ส่วนนโยบายควบคุมว่า OpenCode สามารถใช้ทรัพยากร เช่น ผู้ให้บริการ LLM ได้หรือไม่


คำสั่งนโยบายแต่ละรายการมีสามฟิลด์:

  • effect - เป็น "allow" หรือ "deny"
  • action - การดำเนินการที่ถูกควบคุม
  • resource - ID ของทรัพยากรหรือรูปแบบไวด์การ์ดที่คำสั่งนี้มีผล

ตัวอย่างเช่น ปฏิเสธการใช้ผู้ให้บริการ openai:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "openai"
      }
    ]
  }
}

ผู้ให้บริการที่ถูกปฏิเสธโดยนโยบายจะไม่สามารถใช้เลือกโมเดลหรือใช้งานโมเดลได้ แม้จะมีข้อมูลประจำตัวหรือกำหนดค่าอื่นๆ ไว้อย่างถูกต้องแล้วก็ตาม


ปัจจุบัน OpenCode รองรับการดำเนินการของนโยบายหนึ่งรายการ:

การดำเนินการทรัพยากรคำอธิบาย
provider.useID ผู้ให้บริการ เช่น openaiอนุญาตหรือปฏิเสธการใช้ผู้ให้บริการ LLM

อาจมีการเพิ่มการดำเนินการของนโยบายอื่นๆ ในอนาคต


ฟิลด์ resource รองรับการจับคู่ไวด์การ์ด ใช้ * เพื่อจับคู่อักขระตั้งแต่ศูนย์ตัวขึ้นไป และใช้ ? เพื่อจับคู่อักขระหนึ่งตัว

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "company-*"
      }
    ]
  }
}

ตัวอย่างนี้ปฏิเสธผู้ให้บริการอย่าง company-us และ company-eu


เมื่อมีหลายคำสั่งที่ตรงกัน คำสั่งสุดท้ายที่ตรงกันจะมีผล ให้ใส่กฎแบบกว้างไว้ก่อน แล้วจึงใส่ข้อยกเว้นที่เฉพาะเจาะจงกว่าไว้หลังจากนั้น

ตัวอย่างเช่น อนุญาตเฉพาะ Anthropic:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "experimental": {
    "policies": [
      {
        "effect": "deny",
        "action": "provider.use",
        "resource": "*"
      },
      {
        "effect": "allow",
        "action": "provider.use",
        "resource": "anthropic"
      }
    ]
  }
}

หากไม่มีนโยบายใดตรงกับผู้ให้บริการ ค่าเริ่มต้นคืออนุญาตให้ใช้ผู้ให้บริการนั้น

คุณสามารถตั้งนโยบายได้ทั้งในการกำหนดค่าส่วนกลางและการกำหนดค่าโครงการ หากนโยบายจากทั้งสองแห่งตรงกับผู้ให้บริการเดียวกัน นโยบายส่วนกลางของคุณจะมีลำดับความสำคัญเหนือนโยบายของโครงการ วิธีนี้ป้องกันไม่ให้ที่เก็บโค้ดเปิดใช้ผู้ให้บริการที่คุณปฏิเสธไว้ในระดับส่วนกลางขึ้นมาใหม่


ใน OpenCode 2 ให้ใช้นโยบายแทนการตั้งค่า disabled_providers และ enabled_providers แบบเดิมเมื่อควบคุมการเข้าถึงผู้ให้บริการ ใน OpenCode 1 ให้ใช้รายการผู้ให้บริการเหล่านั้นต่อไป

เพื่อแทนที่ disabled_providers:

opencode.json
{
  "experimental": {
    "policies": [
      { "effect": "deny", "action": "provider.use", "resource": "openai" },
      { "effect": "deny", "action": "provider.use", "resource": "google" }
    ]
  }
}

เพื่อแทนที่ enabled_providers ให้ปฏิเสธผู้ให้บริการทั้งหมดก่อน แล้วจึงอนุญาตผู้ให้บริการที่เลือกไว้หลังจากนั้น:

opencode.json
{
  "experimental": {
    "policies": [
      { "effect": "deny", "action": "provider.use", "resource": "*" },
      { "effect": "allow", "action": "provider.use", "resource": "anthropic" },
      { "effect": "allow", "action": "provider.use", "resource": "openai" }
    ]
  }
}