ข้ามไปยังเนื้อหา
เอกสาร V1
ประเภท

เอเจนต์

เอเจนต์ (Agent) คือผู้ช่วย AI ที่เชี่ยวชาญในงานเฉพาะด้าน คุณสามารถสร้างเอเจนต์ที่มีเครื่องมือ (tools) ที่เหมาะสมกับงานและคำสั่งระบบ (system prompt) ที่ต้องการได้

คุณสามารถสลับเอเจนต์ได้ระหว่างการสนทนาโดยใช้ปุ่ม Tab หรือเรียกใช้โดยระบุ @


OpenCode มีเอเจนต์สองประเภท: Primary Agent (เอเจนต์หลัก) และ Subagent (เอเจนต์ย่อย)


Primary Agent คือผู้ช่วยหลักที่คุณคุยด้วยโดยตรง คุณสามารถวนดูเอเจนต์หลักที่มีอยู่ได้โดยกดปุ่ม Tab หรือปุ่ม switch_agent ที่ตั้งค่าไว้ เอเจนต์เหล่านี้สามารถจัดการงานที่ซับซ้อนและเข้าถึงเครื่องมือที่มีความเสี่ยงสูงได้ เช่น Build ที่มีเครื่องมือทั้งหมด หรือ Plan ที่ถูกจำกัดสิทธิ์

OpenCode มีเอเจนต์หลักในตัวได้แก่ Build และ Plan ดูรายละเอียดด้านล่าง


Subagent คือผู้ช่วยเฉพาะทางที่ Primary Agent สามารถเรียกใช้งานได้ หรือคุณสามารถเรียกใช้โดยตรงโดยพิมพ์ @ ตามด้วยชื่อเอเจนต์ในข้อความของคุณ

OpenCode มี subagent ในตัวได้แก่ General, Explore และ Scout ดูรายละเอียดด้านล่าง


OpenCode มาพร้อมกับเอเจนต์หลัก 2 ตัวและ subagent ในตัว 3 ตัว


Mode: primary

เอเจนต์หลักสำหรับ การพัฒนา มาพร้อมกับเครื่องมือทั้งหมดเพื่อให้มีสิทธิ์การเข้าถึงไฟล์และคำสั่งระบบโดยสมบูรณ์


Mode: primary

เอเจนต์ที่ถูกจำกัดสิทธิ์ เน้นการคิดวิเคราะห์และวางแผน โดยป้องกันการเปลี่ยนแปลงไฟล์โดยไม่ได้ตั้งใจ เครื่องมือต่อไปนี้จะถูกตั้งค่าเป็น ask (ต้องขออนุญาต):

  • file edits: การแก้ไขไฟล์, patch, และการเขียนไฟล์
  • bash: คำสั่ง bash ทั้งหมด

เอเจนต์นี้มีประโยชน์เมื่อต้องการให้ LLM ตรวจสอบโค้ด หรือสร้างแผนงานก่อนที่จะลงมือทำจริง


Mode: subagent

เอเจนต์สำหรับตอบคำถามทั่วไปและการคิดวิเคราะห์หลายขั้นตอน อนุญาตให้เข้าถึงเครื่องมือต่างๆ (ยกเว้นการแก้ไขไฟล์) ใช้สิ่งนี้เมื่อต้องการรันงานที่ไม่ต้องแก้ไขโค้ด


Mode: subagent

เอเจนต์ความเร็วสูงสำหรับอ่านและสำรวจ codebase ใช้สิ่งนี้เมื่อคุณต้องการค้นหาไฟล์อย่างรวดเร็ว, ค้นหาโค้ดด้วยคำสำคัญ, หรือสอบถามเกี่ยวกับโครงสร้าง codebase


Mode: subagent

เอเจนต์แบบอ่านอย่างเดียวสำหรับค้นคว้าเอกสารภายนอกและ dependency ใช้สิ่งนี้เมื่อคุณต้องการ clone repository ของ dependency เข้าไปใน cache ที่ OpenCode จัดการให้, ตรวจสอบ source code ของไลบรารี, หรือเทียบโค้ดในเครื่องกับ implementation จาก upstream โดยไม่แก้ไข workspace ของคุณ


Mode: primary

เอเจนต์ระบบที่มีหน้าที่สรุปประวัติการสนทนาที่ยาวให้สั้นลง โดยยังคงใจความสำคัญไว้


Mode: primary

เอเจนต์ระบบที่มีหน้าที่สร้างชื่อ session ให้สั้นและได้ใจความ ทำงานอัตโนมัติโดยไม่ต้องมี UI


Mode: primary

เอเจนต์ระบบที่มีหน้าที่สร้างสรุปการเปลี่ยนแปลงและงานที่ทำไป ทำงานอัตโนมัติโดยไม่ต้องมี UI


  1. สำหรับ Primary Agent ให้ใช้ปุ่ม Tab เพื่อวนดูเอเจนต์ที่มีอยู่ หรือใช้ keybind switch_agent ที่คุณตั้งค่าไว้

  2. สำหรับ Subagent:

    • เรียกใช้โดย Primary Agent โดยอัตโนมัติตามความเหมาะสม

    • เรียกใช้ด้วยตนเองโดยพิมพ์ @ ตามด้วยชื่อ subagent ในข้อความของคุณ เช่น

      @general help me search for this function
  3. การนำทางระหว่าง Agent: เมื่อ Subagent ทำงานเสร็จและส่งผลลัพธ์กลับมายัง Primary Agent คุณสามารถดูประวัติการทำงานได้:

    • <Leader>+Right (หรือ session_child_cycle keybind) เพื่อวนผ่าน parent → child1 → child2 → … → parent
    • <Leader>+Left (หรือ session_child_cycle_reverse keybind) เพื่อวนย้อนกลับผ่าน parent ← child1 ← child2 ← … ← parent

คุณสามารถปรับแต่งเอเจนต์ที่มีอยู่หรือสร้างเอเจนต์ใหม่ได้สองวิธี:


กำหนดค่าเอเจนต์ในไฟล์ opencode.json ของคุณ:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-5-5",
      "prompt": "{file:./prompts/build.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "plan": {
      "mode": "primary",
      "model": "anthropic/claude-haiku-4-20250514",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    },
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-5-5",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

คุณสามารถกำหนดเอเจนต์ด้วยไฟล์ Markdown ได้ใน:

  • ระดับผู้ใช้ (Global): ~/.config/opencode/agents/
  • ระดับโปรเจ็กต์: .opencode/agents/
~/.config/opencode/agents/review.md
---
description: Reviews code for quality and best practices
mode: subagent
model: anthropic/claude-sonnet-5-5
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
---

You are in code review mode. Focus on:

- Code quality and best practices
- Potential bugs and edge cases
- Performance implications
- Security considerations

Provide constructive feedback without making direct changes.

ชื่อไฟล์ Markdown จะกลายเป็นชื่อเอเจนต์ เช่น review.md สร้างเอเจนต์ review


มาดูรายละเอียดของตัวเลือกต่างๆ


ใช้ฟิลด์ description เพื่ออธิบายว่าเอเจนต์นี้ทำอะไร

opencode.json
{
  "agent": {
    "review": {
      "description": "Reviews code for best practices and potential issues"
    }
  }
}

ฟิลด์นี้ จำเป็น สำหรับ JSON


ควบคุมความสุ่มและความคิดสร้างสรรค์ของการตอบกลับของ LLM ด้วย temperature

ค่าที่ต่ำกว่าจะให้ผลลัพธ์ที่แน่นอนและแม่นยำกว่า ส่วนค่าที่สูงกว่าจะให้ความหลากหลายและความคิดสร้างสรรค์มากกว่า

opencode.json
{
  "agent": {
    "plan": {
      "temperature": 0.1
    },
    "creative": {
      "temperature": 0.8
    }
  }
}

ช่วงอุณหภูมิอยู่ระหว่าง 0.0 ถึง 1.0:

  • 0.0-0.2: แน่นอนและแม่นยำ เหมาะสำหรับการเขียนโค้ดและการวางแผน
  • 0.3-0.5: สมดุล เหมาะสำหรับการพัฒนาทั่วไป
  • 0.6-1.0: สร้างสรรค์ เหมาะสำหรับการระดมสมอง
opencode.json
{
  "agent": {
    "analyze": {
      "temperature": 0.1,
      "prompt": "{file:./prompts/analysis.txt}"
    },
    "build": {
      "temperature": 0.3
    },
    "brainstorm": {
      "temperature": 0.7,
      "prompt": "{file:./prompts/creative.txt}"
    }
  }
}

หมายเหตุ: OpenCode ค่าเริ่มต้นคือ 0 สำหรับโมเดลส่วนใหญ่ และ 0.55 สำหรับโมเดล Qwen


จำกัดจำนวนการวนซ้ำ (iterations) สูงสุดที่เอเจนต์สามารถทำได้ เพื่อควบคุมค่าใช้จ่ายและป้องกันการทำงานไม่รู้จบ

หากไม่ได้ตั้งค่านี้ เอเจนต์จะทำงานต่อไปจนกว่างานจะเสร็จหรือผู้ใช้ขัดจังหวะ

opencode.json
{
  "agent": {
    "quick-thinker": {
      "description": "Fast reasoning with limited iterations",
      "prompt": "You are a quick thinker. Solve problems with minimal steps.",
      "steps": 5
    }
  }
}

เมื่อถึงขีดจำกัด เอเจนต์จะได้รับพรอมต์พิเศษเพื่อสรุปงานและสิ่งที่เหลืออยู่


ตั้งค่าเป็น true เพื่อปิดการใช้งานเอเจนต์

opencode.json
{
  "agent": {
    "review": {
      "disable": true
    }
  }
}

ระบุ System Prompt สำหรับเอเจนต์นี้ด้วย prompt

opencode.json
{
  "agent": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

รองรับเส้นทางสัมพัทธ์ (Relative paths) ซึ่งทำให้ใช้งานได้สะดวกทั้งในระดับ Global และ Project


ใช้ตัวเลือก model เพื่อกำหนดโมเดลเฉพาะสำหรับเอเจนต์นี้ มีประโยชน์เมื่อต้องการใช้โมเดลที่เชี่ยวชาญเฉพาะด้าน หรือโมเดลที่มี Context window ขนาดใหญ่สำหรับการตรวจสอบ codebase

opencode.json
{
  "agent": {
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514"
    }
  }
}

ID ของโมเดลใช้รูปแบบ provider/model-id


กำหนดเครื่องมือที่เอเจนต์สามารถใช้งานได้ด้วย tools คุณสามารถระบุชื่อเครื่องมือ หรือใช้ wildcard

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "tools": {
    "write": true,
    "bash": true
  },
  "agent": {
    "plan": {
      "tools": {
        "write": false,
        "bash": false
      }
    }
  }
}

คุณสามารถใช้ wildcard * เพื่อควบคุมเครื่องมือหลายรายการพร้อมกัน เช่น เครื่องมือจากเซิร์ฟเวอร์ MCP:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "readonly": {
      "tools": {
        "mymcp_*": false,
        "write": false,
        "edit": false
      }
    }
  }
}

เรียนรู้เพิ่มเติมเกี่ยวกับเครื่องมือ


กำหนดสิทธิ์สำหรับเครื่องมือที่มีความละเอียดอ่อน เช่น edit, bash และ webfetch:

  • "ask" — ต้องขออนุมัติจากผู้ใช้ก่อน
  • "allow" — อนุญาตให้ทำงานได้โดยไม่ต้องถาม
  • "deny" — ไม่อนุญาตให้ใช้
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny"
  }
}

คุณสามารถกำหนดสิทธิ์ในระดับเอเจนต์ได้:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny"
  },
  "agent": {
    "build": {
      "permission": {
        "edit": "ask"
      }
    }
  }
}

ใน Markdown agent:

~/.config/opencode/agents/review.md
---
description: Code review without edits
mode: subagent
permission:
  edit: deny
  bash:
    "*": ask
    "git diff": allow
    "git log*": allow
    "grep *": allow
  webfetch: deny
---

Only analyze code and suggest changes.

คุณสามารถกำหนดสิทธิ์สำหรับคำสั่ง bash เฉพาะได้:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git push": "ask",
          "grep *": "allow"
        }
      }
    }
  }
}

รองรับ glob patterns:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git *": "ask"
        }
      }
    }
  }
}

ใช้ * wildcard เพื่อตั้งค่าเริ่มต้นสำหรับคำสั่งอื่นๆ ทั้งหมด กฎที่ตรงกันล่าสุดจะมีผลบังคับใช้ (Last match wins):

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "*": "ask",
          "git status *": "allow"
        }
      }
    }
  }
}

เรียนรู้เพิ่มเติมเกี่ยวกับสิทธิ์


กำหนดโหมดของเอเจนต์ด้วย mode

opencode.json
{
  "agent": {
    "review": {
      "mode": "subagent"
    }
  }
}

mode สามารถเป็น primary, subagent หรือ all หากไม่ระบุ ค่าเริ่มต้นจะเป็น all


ซ่อน subagent จากเมนู autocomplete @ ด้วย hidden: true มีประโยชน์สำหรับ subagent ภายในที่ถูกเรียกใช้โดยเอเจนต์อื่นผ่านเครื่องมือ task เท่านั้น

opencode.json
{
  "agent": {
    "internal-helper": {
      "mode": "subagent",
      "hidden": true
    }
  }
}

กำหนดว่า subagent ใดที่เอเจนต์นี้สามารถเรียกใช้ได้ผ่านเครื่องมือ task ด้วย permission.task

opencode.json
{
  "agent": {
    "orchestrator": {
      "mode": "primary",
      "permission": {
        "task": {
          "*": "deny",
          "orchestrator-*": "allow",
          "code-reviewer": "ask"
        }
      }
    }
  }
}

หากตั้งเป็น deny เอเจนต์จะมองไม่เห็นเครื่องมือ task สำหรับ subagent นั้นๆ


ปรับแต่งสีของเอเจนต์ใน UI ด้วยตัวเลือก color

ใช้รหัสสี hex (เช่น #FF5733) หรือชื่อสีมาตรฐาน: primary, secondary, accent, success, warning, error, info

opencode.json
{
  "agent": {
    "creative": {
      "color": "#ff6b6b"
    },
    "code-reviewer": {
      "color": "accent"
    }
  }
}

ควบคุมความหลากหลายของการตอบกลับด้วยตัวเลือก top_p

opencode.json
{
  "agent": {
    "brainstorm": {
      "top_p": 0.9
    }
  }
}

ช่วงค่า 0.0 ถึง 1.0 ค่าที่ต่ำกว่าจะเน้นไปที่โทเค็นที่มีความน่าจะเป็นสูง


คุณสมบัติอื่นๆ ที่คุณระบุใน object ของเอเจนต์จะถูก ส่งผ่านโดยตรง ไปยัง LLM config

เช่น สำหรับโมเดลที่มีการให้เหตุผลของ OpenAI:

opencode.json
{
  "agent": {
    "deep-thinker": {
      "description": "Agent that uses high reasoning effort for complex problems",
      "model": "openai/gpt-6.1-sol",
      "reasoningEffort": "high",
      "textVerbosity": "low"
    }
  }
}

ตรวจสอบเอกสารของแต่ละโมเดลสำหรับตัวเลือกที่รองรับ


สร้างเอเจนต์ใหม่โดยเพิ่มไฟล์ Markdown ไว้ใน .opencode/agents/ สำหรับโปรเจ็กต์ หรือ ~/.config/opencode/agents/ สำหรับระดับผู้ใช้ (Global) ชื่อไฟล์จะกลายเป็นชื่อเอเจนต์ และ frontmatter ใช้กำหนดคำอธิบาย โหมด โมเดล และสิทธิ์ของเอเจนต์ ดูรูปแบบไฟล์ได้ที่ Markdown ด้านบน

รัน opencode agent list เพื่อแสดงรายการเอเจนต์ที่ OpenCode โหลดไว้


ต่อไปนี้เป็นกรณีการใช้งานทั่วไปสำหรับเอเจนต์ต่างๆ

  • Developer: งานพัฒนาทั่วไป ใช้เครื่องมือทั้งหมด
  • Planner: วิเคราะห์และวางแผนโดยไม่ทำการเปลี่ยนแปลง
  • Reviewer: ตรวจสอบโค้ดแบบอ่านอย่างเดียว (Read-only)
  • Debugger: แก้ไขข้อผิดพลาดโดยเน้นการอ่าน log และทดสอบ
  • Docs Writer: เขียนและปรับปรุงเอกสาร

นี่คือตัวอย่างเอเจนต์ที่คุณอาจพบว่ามีประโยชน์

~/.config/opencode/agents/docs-writer.md
---
description: Writes and maintains project documentation
mode: subagent
tools:
  bash: false
---

You are a technical writer. Create clear, comprehensive documentation.

Focus on:

- Clear explanations
- Proper structure
- Code examples
- User-friendly language

~/.config/opencode/agents/security-auditor.md
---
description: Performs security audits and identifies vulnerabilities
mode: subagent
tools:
  write: false
  edit: false
---

You are a security expert. Focus on identifying potential security issues.

Look for:

- Input validation vulnerabilities
- Authentication and authorization flaws
- Data exposure risks
- Dependency vulnerabilities
- Configuration security issues