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 つのモードは排他的です：コールバックを渡すと動的選択モードに切り替わり、固定モデル設定は無視されます。
固定モデル
モデルオプションで指定します。省略するとアカウントのデフォルトが使われます：
import { qodercliAuth, query } from '@qoder-ai/qoder-agent-sdk';
const q = query({
prompt: 'Analyze this code',
options: {
auth: qodercliAuth(),
model: 'performance',
},
});
動的選択
LLM リクエストごとに呼び出されるコールバック関数を提供します：
import { qodercliAuth, query, type ModelPolicyProvider } from '@qoder-ai/qoder-agent-sdk';
const resolveModel: ModelPolicyProvider = (context) => {
return { model: 'performance' };
};
const q = query({
prompt: 'Analyze this code',
options: {
auth: qodercliAuth(),
resolveModel,
},
});
用途別のルーティング
用途ごとに異なるモデルを使用します：
const resolveModel: ModelPolicyProvider = (context) => {
switch (context.purpose) {
case 'main': return { model: 'performance' };
case 'subagent': return { model: 'efficient' };
case 'compact': return { model: 'lite' };
default: return { model: 'auto' };
}
};
タイムアウト
コールバックにはデフォルトのタイムアウト（ミリ秒単位）があります。コールバックがリモート I/O を行う場合は緩和できます：
{ resolveModel, resolveModelTimeoutMs: 800 }
BYOK：自分の API キーを使用
コールバックは BYOK 認証情報オブジェクトを返すこともできます——このリクエストはサードパーティのプロバイダーにルーティングされます：
const resolveModel: ModelPolicyProvider = () => ({
model: {
provider: 'bailian',
model: 'qwen3.5-plus-cp',
api_key: process.env.MY_API_KEY!,
},
});
ランタイム操作
セッション実行中にアカウントで現在利用可能なモデルリストを取得できます：
import { qodercliAuth, query } from '@qoder-ai/qoder-agent-sdk';
const q = query({
prompt: '...',
options: { auth: qodercliAuth() },
});
const models = await q.getAvailableModels();
for (const m of models) {
console.log(`${m.value}\t${m.displayName}\t${m.isEnabled ?? true}`);
}
エラー処理
動的選択モードには自動フォールバックがありません——コールバックのタイムアウト、例外、空モデルの返却はすべてクエリを失敗させます。コールバック内部で自前にフォールバックすることを推奨します：
const resolveModel: ModelPolicyProvider = async (context) => {
try {
const policy = await fetchRemotePolicy(context);
return { model: policy.model };
} catch {
return { model: 'auto' }; // フォールバック、空にしてはいけない
}
};
