Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
query() には 2 つのモデル選択モードがあります：
- 固定モデル（デフォルト）：セッション全体で 1 つのモデルを使用します。
- 動的選択：LLM リクエストごとにコールバック関数を呼び出してモデルを返します。用途（メイン会話、サブエージェント、コンテキスト圧縮など）に応じて異なるモデルにルーティングしたり、BYOK 認証情報を返して自分の API キーを使うことができます。
2 つのモードは排他的です。コールバックを渡すと動的選択モードに切り替わり、固定モデル設定は無視されます。
固定モデル
モデルオプションで指定します。省略するとアカウントのデフォルトが使われます：
from qoder_agent_sdk import query, QoderAgentOptions
options = QoderAgentOptions(model="performance")
async for msg in query(prompt="Analyze this code", options=options):
print(msg)
動的選択
LLM リクエストごとに呼び出されるコールバック関数を提供します：
from qoder_agent_sdk import query, QoderAgentOptions
from qoder_agent_sdk.types import ModelPolicyContext, ModelPolicyResult, ModelPolicyProvider
resolve_model: ModelPolicyProvider = lambda context: {"model": "performance"}
options = QoderAgentOptions(resolve_model=resolve_model)
async for msg in query(prompt="Analyze this code", options=options):
print(msg)
用途別のルーティング
用途ごとに異なるモデルを使用します：
def resolve_model(context: ModelPolicyContext) -> ModelPolicyResult:
match context.get("purpose"):
case "main": return {"model": "performance"}
case "subagent": return {"model": "efficient"}
case "compact": return {"model": "lite"}
case _: return {"model": "auto"}
タイムアウト
コールバックにはデフォルトのタイムアウト（ミリ秒単位）があります。コールバック内でリモート呼び出しを行う場合は緩和できます：
options = QoderAgentOptions(
resolve_model=resolve_model,
resolve_model_timeout_ms=800,
)
BYOK：自分の API キーを使用
コールバックは BYOK 認証情報オブジェクトを返すこともできます——このリクエストはサードパーティのプロバイダーにルーティングされます：
import os
def resolve_model(context: ModelPolicyContext) -> ModelPolicyResult:
return {
"model": {
"provider": "bailian",
"model": "qwen3.5-plus-cp",
"api_key": os.environ["MY_API_KEY"],
},
}
ランタイム操作
セッション実行中にアカウントで現在利用可能なモデルリストを取得できます：
from qoder_agent_sdk import query, QoderAgentOptions
options = QoderAgentOptions(...)
async with QoderSDKClient(options=options) as client:
models = await client.get_available_models()
for m in models:
print(f"{m['value']}\t{m['displayName']}\t{m.get('isEnabled', True)}")
エラー処理
動的選択モードには自動フォールバックがありません——コールバックのタイムアウト、例外の発生、空モデルの返却はすべてクエリを失敗させます。コールバック内部で自前にフォールバックすることを推奨します：
async def resolve_model(context: ModelPolicyContext) -> ModelPolicyResult:
try:
policy = await fetch_remote_policy(context)
return {"model": policy["model"]}
except Exception:
return {"model": "auto"} # fallback, must be non-empty
