ข้ามไปยังเนื้อหา

SDK

ควบคุม OpenCode จากสคริปต์ งาน CI และเครื่องมือของคุณเอง SDK รัน OpenCode ภายในโปรเซสของคุณด้วยการตั้งค่าและโมเดลของคุณ และไคลเอนต์แบบมีชนิดข้อมูลจะสร้างเซสชัน ส่งพรอมต์ และสตรีมทุกอีเวนต์

ฟีเจอร์

แก้ CI จากโค้ด

สคริปต์สั้นๆ ขอให้ OpenCode แก้เทสต์ที่ล้มเหลว แล้วรันเทสต์อีกครั้ง

ติดตามทุกขั้นตอน

สตรีมอีเวนต์เพื่อดูเครื่องมือแต่ละตัวที่เอเจนต์เรียกใช้ ทันทีที่เกิดขึ้น

สร้างเครื่องมือของคุณ

เชื่อม OpenCode เข้ากับบอต แดชบอร์ด และเวิร์กโฟลว์ด้วยโค้ดไม่กี่บรรทัด

ในโปรเซสของคุณ

รัน OpenCode ภายในโปรเซสของคุณ ด้วยการตั้งค่าและโมเดลของคุณ

  • ไคลเอนต์ TypeScriptคำขอและอีเวนต์แบบมีชนิดข้อมูล ใช้ค่าเดียวกับ @opencode/client
  • เซสชันจากโค้ดสร้างเซสชันและส่งพรอมต์จากสคริปต์ใดก็ได้
  • โมเดลใดก็ได้ใช้โมเดลที่ตั้งค่าไว้ใน OpenCode ของคุณ
  • npm หรือ bunติดตั้งด้วย npm i @opencode/sdk หรือ bun add @opencode/sdk
  • โฮสต์ในโปรเซสรัน OpenCode ในหน่วยความจำ โดยไม่ผ่านเครือข่าย
  • ปลั๊กอินของคุณส่งปลั๊กอินของคุณเข้าไปเมื่อสร้างโฮสต์ในโปรเซส
  • Promise หรือ EffectAPI แบบ Promise และแบบ Effect ที่ให้ค่าเดียวกัน
  • Cloudflare Workersรัน OpenCode ใน Cloudflare Durable Object บน Workers

  • npmnpm i @opencode/sdk
  • bunbun add @opencode/sdk
อ่านเอกสาร SDK

บันทึกการเปลี่ยนแปลง

  1. v2.3.1

    Timed-Out Shell Commands Keep Running

    A shell command still running when its timeout expires now moves to the background instead of being killed, so long builds and test runs finish and report back. A foreground timeout: 0 now means the default 120 seconds.#63699

    Compaction Without the Wait

    As a session nears automatic compaction, the summary is now written in the background, so your next prompt doesn't pause for it. Set compaction.background: false to turn it off; a background summary that ends up unused still costs tokens.#64290

    ดูไฮไลต์ทั้งหมดใน v2.3.1

    การปรับปรุง

    • Core, SDKServer requests that crash now return a 500 with a readable JSON UnknownError body instead of an empty one. Storage problems name the cause (for example "Storage is full" or "Storage is read-only"); other crashes include a ref you can find in the server log.#64022
    • Core, SDKExperimental schedules are now automations, behind the automations flag (the old schedules flag still works). An automation runs on a time, an interval, a cron or a pushed MCP event, and either sends a prompt (to the creating session, another session or a new subagent) or runs a Code Mode program that decides whether to send one. Use /automation or the automation_* tools. Active or paused plain prompt schedules carry over; schedules with a condition or run limit, and finished ones, are dropped.#64160

    การแก้ไข

    • SDKApps embedding the SDK with an in-memory database no longer import the user's legacy auth.json credentials. Only a database file opened by path imports them.#63716
  2. v2.3.0

    Event subscriptions can now receive experimental.mcp.event events from MCP event subscriptions

    ดูไฮไลต์ทั้งหมดใน v2.3.0

    การปรับปรุง

    • SDKModel capability schemas now advertise supported freeform tool-input formats.
    • SDKSession throughput is now measured from the first streamed token.
    • SDKSession creation documentation now clarifies the parentID field.
  3. v2.2.7

    session.generate returns tokens and cost along with text

    ดูไฮไลต์ทั้งหมดใน v2.2.7

    การเปลี่ยนแปลงที่ไม่เข้ากัน

    SDK: fewer endpoints wait for plugins to load

    On a Location that is still loading plugins, agent.list returns the agents loaded so far, and integration.list, usage.limits, vcs.init, rpc.call and artifact.* no longer wait up to 5 seconds. Entries and actions that a plugin provides appear when it finishes loading, so refresh on the matching *.updated event. Model, provider, generate.*, voice.* and websearch.query endpoints still wait.

    #62796#63040

    การปรับปรุง

    • SDKcredential.updated includes the integrationID and credentialID of the login that changed.#62762
    • SDKPredicate questions in client.experimental.generate.decisions accept optional criteria: { true?, false? }.#62819
ดูอัปเดตทั้งหมด