ឧបករណ៍សរសេរកូដ CLI

ឧបករណ៍សរសេរកូដត្រូវការការកំណត់បីដើម្បីដំណើរការជាមួយ Shannon៖ base URL របស់ API, API key របស់អ្នក និង Shannon model id។ ទំព័រនេះផ្តល់ការកំណត់ពិតប្រាកដសម្រាប់ Claude Code និង Codex CLI ពន្យល់ពីរបៀបដែលម៉ូដែល coding shannon-coder-1 ត្រូវបានរាប់ ហើយរាយកំហុសដែល tool ទាំងនេះជួប។

endpoint ណាដែល tool នីមួយៗប្រើ

endpoint ទាំងបីទទួល API key ដូចគ្នា ជា Authorization: Bearer ឬជា x-api-key។ header anthropic-version, anthropic-beta និង openai-beta ដែល tool ទាំងនេះផ្ញើ ត្រូវបានទទួលយក។

ជ្រើសរើស Shannon model

រាល់ request ត្រូវតែដាក់ឈ្មោះ model id ដែល Shannon ផ្សព្វផ្សាយ។ ឧបករណ៍សរសេរកូដផ្ញើឈ្មោះម៉ូដែលលំនាំដើមរបស់ខ្លួន លុះត្រាតែអ្នកប្រាប់ឱ្យធ្វើផ្សេង ហើយឈ្មោះដែល Shannon មិនផ្សព្វផ្សាយត្រូវបានឆ្លើយដោយ 400 និងសារ unknown model: <name>។ គ្មានឈ្មោះផ្សេងត្រូវបានផ្គូផ្គងទៅម៉ូដែល Shannon ទេ ដូច្នេះសូមកំណត់ម៉ូដែលក្នុង tool មុន request ដំបូង។

GET /v1/models រាយគ្រប់ id ជាមួយ context window របស់វា។ វាមិនត្រូវការ key ទេ។ ម៉ូដែល និងតម្លៃ

ឧបករណ៍សរសេរកូដដឹកនាំម៉ូដែលដោយ system prompt វែង។ system prompt ត្រូវបានអនុវត្តដោយ shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro និងម៉ូដែល open-weight ដែលបង្ហោះ ដូច្នេះសូមជ្រើសមួយក្នុងចំណោមទាំងនេះសម្រាប់ឧបករណ៍សរសេរកូដ។

Claude Code

Claude Code អានការតភ្ជាប់របស់វាពី environment variable។ កំណត់ពួកវានៅក្នុង shell ដែលចាប់ផ្តើមវា ឬក្នុង block env នៃ ~/.claude/settings.json ដើម្បីរក្សាទុកសម្រាប់គ្រប់ session។

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Where to send requests, and your Shannon API key
export ANTHROPIC_BASE_URL=https://api.shannon-ai.com
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

# Shannon model ids: the session model, and the model behind each built-in name
export ANTHROPIC_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_OPUS_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_SONNET_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_HAIKU_MODEL=shannon-1.6-lite

# The context window of the session model
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=131072

claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.shannon-ai.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "shannon-1.6-lite",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "131072"
  }
}

• កំណត់ variable ANTHROPIC_DEFAULT_…_MODEL ទាំងបី។ Subagent និងពាក្យបញ្ជាមួយចំនួនសុំម៉ូដែលតាមឈ្មោះដែលមានស្រាប់ ហើយឈ្មោះនីមួយៗត្រូវបានបកស្រាយទៅជា Shannon id។
• គំរូនេះចង្អុលបង្ហាញ request ផ្ទៃខាងក្រោយទៅ shannon-1.6-lite ដែលត្រូវបានរាប់ជា token។ ចំណងជើង session និង request ស្រដៀងគ្នាមិនប្រើការហៅ Coder ទេ។
• Claude Code សួរ POST /v1/messages/count_tokens អំពីទំហំ context។ endpoint រាប់សម្រាប់ម៉ូដែល open-weight ដែលបង្ហោះ។ ជាមួយ Shannon id វាឆ្លើយ 400; Claude Code ចាត់ទុកការរាប់ token ជាជម្រើស ហើយប៉ាន់ស្មានទំហំដោយខ្លួនឯង។ ការរាប់ token

ដើម្បីពិនិត្យអាសយដ្ឋាន key និង model id មុនចាប់ផ្តើម tool សូមផ្ញើ request មួយដោយដៃ៖

curl https://api.shannon-ai.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "Say OK."}]
  }'

Codex CLI

Codex CLI និយាយជាមួយ Responses API។ ពិពណ៌នា Shannon ជា model provider ក្នុង ~/.codex/config.toml ជ្រើស Shannon model id នៅទីនោះ ហើយដាក់ API key របស់អ្នកក្នុង environment variable ដែល provider ដាក់ឈ្មោះ។

model = "shannon-coder-1"
model_provider = "shannon"
model_context_window = 131072

[model_providers.shannon]
name = "Shannon"
base_url = "https://api.shannon-ai.com/v1"
env_key = "SHANNON_API_KEY"
wire_api = "responses"

# Install Codex CLI
npm install -g @openai/codex

# Your Shannon API key, under the name given as env_key
export SHANNON_API_KEY=YOUR_API_KEY

# Start it; --model selects another Shannon id for one run
codex
codex --model shannon-1.6-pro

• /v1/responses មិនរក្សាការសន្ទនាលើ server ទេ៖ រាល់ request មានការសន្ទនាក្នុង input។ previous_response_id ត្រូវបានទទួលយកដើម្បីភាពត្រូវគ្នា។
• Function tool (type: "function") ត្រូវបានផ្តល់ជូនម៉ូដែលលើ /v1/responses។
• លើ /v1/responses shannon-coder-1 ត្រូវបានរាប់ជា token ពីសមតុល្យរបស់អ្នក មិនមែនជាការហៅ Coder ទេ។

ការពិនិត្យដូចគ្នាសម្រាប់ endpoint Responses៖

curl https://api.shannon-ai.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "input": "Say OK."
  }'

ម៉ូដែល coding និងរបៀបដែលវាត្រូវបានរាប់

shannon-coder-1 គឺជាម៉ូដែល Shannon សម្រាប់ coding agent។ GET /v1/models រាយការណ៍វាដោយមាន context window 131,072 token, ការហៅ tool, reasoning និង text input។ វាត្រូវបានរាប់តាមវិធីមួយក្នុងចំណោមពីរ អាស្រ័យលើ endpoint ដែល tool ប្រើ។

ការហៅមួយគឺ request មួយ ទោះទំហំប៉ុនណា។ វាត្រូវបានរាប់នៅពេល request ត្រូវបានទទួលយក មុនម៉ូដែលឆ្លើយ។ session របស់ agent ផ្ញើ request មួយសម្រាប់រាល់ជំហានដែលវាធ្វើ ដូច្នេះការងារវែងប្រើការហៅច្រើន។ កូតាអាស្រ័យលើគម្រោងរបស់អ្នក ហើយចាប់ផ្តើមឡើងវិញរៀងរាល់ 4 ម៉ោង នៅម៉ោង 00:00, 04:00, 08:00, 12:00, 16:00 និង 20:00 UTC។

ទំព័រគម្រោងបង្ហាញលេខបច្ចុប្បន្ន។ គម្រោង

នៅពេលការហៅក្នុងចន្លោះពេលមួយត្រូវបានប្រើអស់ request ត្រូវបានឆ្លើយដោយ 429។ លើ /v1/messages កំហុសដូចគ្នាមកក្នុងរូបរាង Anthropic។

{
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

context លើស

នៅពេលការសន្ទនាធំជាង context window របស់ម៉ូដែល /v1/chat/completions និង /v1/messages ឆ្លើយដោយ 400 ប្រភេទ invalid_request_error កូដ context_length_exceeded និងសារដែលចាប់ផ្តើមដោយ prompt is too long។ ឧបករណ៍សរសេរកូដអានកំហុសនេះដើម្បីបង្រួម session ហើយផ្ញើ request ម្តងទៀត។ វាត្រូវបានបង្កើតដោយ shannon-coder-1, shannon-1.6-lite និង shannon-1.6-pro។

{
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

សារគឺ prompt is too long: <sent> tokens > <limit> maximum។ នៅពេលមិនស្គាល់លេខទាំងពីរ វាគឺ prompt is too long. Please compact the conversation and try again.

លើ stream ស្ថានភាពគឺ 200 រួចហើយ ដូច្នេះកំហុសមកដល់ជា event ហើយ stream បិទតាមរបៀបធម្មតា៖

data: {"error":{"message":"prompt is too long: 140211 tokens > 131072 maximum","type":"invalid_request_error","code":"context_length_exceeded","param":null}}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","created":…,"model":"shannon-coder-1","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{…}}

data: [DONE]

event: error
data: {"type":"error","error":{"type":"invalid_request_error","message":"prompt is too long: 140211 tokens > 131072 maximum"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{…}}

event: message_stop
data: {"type":"message_stop"}

អ្វីដែល agent loop អាចពឹងផ្អែកបាន

ការដោះស្រាយបញ្ហា

key និងសមតុល្យរបស់អ្នកស្ថិតនៅទំព័រ Keys & usage។ Keys & usage