CLI ინსტრუმენტები კოდირებისთვის

კოდირების ინსტრუმენტს Shannon-თან სამუშაოდ სამი პარამეტრი სჭირდება: API-ს base URL, თქვენი API გასაღები და Shannon-ის მოდელის id. ეს გვერდი Claude Code-სა და Codex CLI-სთვის ზუსტ პარამეტრებს გვაძლევს, განმარტავს, როგორ ითვლება კოდირების მოდელი shannon-coder-1, და ჩამოთვლის შეცდომებს, რომლებსაც ეს ინსტრუმენტები აწყდებიან.

რომელ endpoint-ს იყენებს თითოეული ინსტრუმენტი

სამივე endpoint ერთსა და იმავე API გასაღებს იღებს, როგორც Authorization: Bearer ან როგორც x-api-key. Header-ები anthropic-version, anthropic-beta და openai-beta, რომლებსაც ეს ინსტრუმენტები აგზავნიან, მიიღება.

აირჩიეთ Shannon-ის მოდელი

ყოველმა მოთხოვნამ უნდა დაასახელოს მოდელის id, რომელსაც Shannon აქვეყნებს. კოდირების ინსტრუმენტი საკუთარი ნაგულისხმევი მოდელის სახელს აგზავნის, თუ სხვაგვარად არ უთხარით, და სახელს, რომელსაც Shannon არ აქვეყნებს, პასუხობს 400 და შეტყობინება unknown model: <name>. სხვა სახელი Shannon-ის მოდელზე არ გადაიყვანება, ამიტომ მოდელი ინსტრუმენტში პირველ მოთხოვნამდე დააყენეთ.

GET /v1/models ყველა id-ს კონტექსტის ფანჯრით ჩამოთვლის. გასაღები არ სჭირდება. მოდელები და ფასები

კოდირების ინსტრუმენტები მოდელს გრძელი system prompt-ით წარმართავენ. system prompt-ს ითვალისწინებენ shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro და hosted open-weight მოდელები, ამიტომ კოდირების ინსტრუმენტისთვის ერთ-ერთი მათგანი აირჩიეთ.

Claude Code

Claude Code კავშირს გარემოს ცვლადებიდან კითხულობს. დააყენეთ ისინი shell-ში, რომელიც მას უშვებს, ან ~/.claude/settings.json-ის env ბლოკში, რომ ყველა სესიისთვის შენარჩუნდეს.

# 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"
  }
}

• დააყენეთ სამივე ცვლადი ANTHROPIC_DEFAULT_…_MODEL. Subagent-ები და ზოგი ბრძანება მოდელს ჩაშენებული სახელით ითხოვს და თითოეული სახელი Shannon-ის id-ზე უნდა გადაიყვანებოდეს.
• ნიმუში ფონურ მოთხოვნებს shannon-1.6-lite-ზე მიმართავს, რომელიც ტოკენებში ითვლება. სესიის სათაურები და მსგავსი მოთხოვნები მაშინ Coder-ის გამოძახებებს არ იყენებენ.
• Claude Code კონტექსტის ზომას POST /v1/messages/count_tokens-ს ეკითხება. endpoint hosted open-weight მოდელებისთვის ითვლის. Shannon-ის id-ზე ის პასუხობს 400-ით; Claude Code ტოკენების დათვლას არასავალდებულოდ თვლის და ზომას თავად აფასებს. ტოკენების დათვლა

მისამართის, გასაღებისა და მოდელის id-ის შესამოწმებლად ინსტრუმენტის გაშვებამდე ხელით გააგზავნეთ ერთი მოთხოვნა:

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 როგორც მოდელის provider ~/.codex/config.toml-ში, იქვე აირჩიეთ Shannon-ის მოდელის id და ჩადეთ თქვენი API გასაღები გარემოს ცვლადში, რომელსაც 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 სერვერზე საუბარს არ ინახავს: ყოველი მოთხოვნა საუბარს input-ში ატარებს. previous_response_id მიიღება თავსებადობისთვის.
• ფუნქციის ინსტრუმენტები (type: "function") მოდელს /v1/responses-ზე ეძლევა.
• /v1/responses-ზე shannon-coder-1 ითვლება თქვენი ბალანსის ტოკენებში და არა Coder-ის გამოძახებებში.

იგივე შემოწმება Responses endpoint-ისთვის:

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."
  }'

კოდირების მოდელი და როგორ ითვლება ის

shannon-coder-1 არის Shannon-ის მოდელი კოდირების აგენტებისთვის. GET /v1/models მას აჩვენებს 131,072-ტოკენიანი კონტექსტის ფანჯრით, ინსტრუმენტების გამოძახებით, მსჯელობითა და ტექსტის შეტანით. ის ორი გზით ითვლება, იმის მიხედვით, რომელ endpoint-ს იყენებს ინსტრუმენტი.

გამოძახება არის ერთი მოთხოვნა, ზომის მიუხედავად. ის ითვლება მოთხოვნის მიღებისას, მოდელის პასუხამდე. აგენტის სესია ყოველი ბიჯისთვის ერთ მოთხოვნას აგზავნის, ამიტომ გრძელი ამოცანა ბევრ გამოძახებას იყენებს. ლიმიტი გეგმაზეა დამოკიდებული და ყოველ 4 საათში თავიდან იწყება, UTC-ით 00:00, 04:00, 08:00, 12:00, 16:00 და 20:00-ზე.

გეგმის გვერდზე მიმდინარე რიცხვებია ნაჩვენები. გეგმები

როცა ფანჯრის გამოძახებები ამოიწურება, მოთხოვნას პასუხობს 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"
  }
}

კონტექსტის გადავსება

როცა საუბარი მოდელის კონტექსტის ფანჯარაზე დიდია, /v1/chat/completions და /v1/messages პასუხობენ 400-ით, ტიპით invalid_request_error, კოდით context_length_exceeded და შეტყობინებით, რომელიც prompt is too long-ით იწყება. კოდირების ინსტრუმენტები ამ შეცდომას კითხულობენ, რათა სესია შეკუმშონ და მოთხოვნა ხელახლა გააგზავნონ. მას აწარმოებენ 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.

სტრიმზე სტატუსი უკვე 200-ია, ამიტომ შეცდომა მოვლენის სახით მოდის და სტრიმი შემდეგ ჩვეულებრივად იხურება:

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"}

რაზე შეიძლება დაეყრდნოს აგენტის ციკლი

პრობლემების გადაჭრა

თქვენი გასაღები და ბალანსი გვერდზე Keys & usage არის. გასაღებები და გამოყენება