ModelProviderErrorCode
SUPPORT · type · 类型合同
Stable failure classification reported by the compatible provider adapter.
导入
ts
import type { ModelProviderErrorCode } from '@jangts/agent-core/support';js
/** @typedef {import('@jangts/agent-core/support').ModelProviderErrorCode} ModelProviderErrorCode */其他公开入口：@jangts/agent-core、@jangts/agent-core/types、@jangts/agent-core/structs、@jangts/agent-core/support、@jangts/agent-core/support/model。
定义
ts
type ModelProviderErrorCode = | 'MODEL_NOT_CONFIGURED'
/** Upstream rejected the credentials (HTTP 401/403). */
| 'MODEL_AUTH'
/** Upstream reported exhausted balance or quota (HTTP 402). */
| 'MODEL_BALANCE'
/** Upstream is rate limiting or overloaded (HTTP 429). */
| 'MODEL_BUSY'
/** The request itself is invalid (HTTP 400/404 or configuration validation). */
| 'MODEL_CONFIG'
/** Unclassified upstream failure. */
| 'MODEL_UPSTREAM'
/** Response body could not be parsed as the expected wire format. */
| 'MODEL_FORMAT'
/** The stream violated the protocol, for example data after the finish marker. */
| 'MODEL_PROTOCOL'
/** The provider stopped because the output token limit was reached. */
| 'MODEL_OUTPUT_LIMIT'
/** The stream ended without a usable payload. */
| 'MODEL_INCOMPLETE';索引结构
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
[key: number] | string | 必需 | 只读。索引项。 |
联合分支结构
使用示例
- 兼容 Provider 与自定义 Provider：Support 负责常见 Chat Completions HTTP/SSE 生命周期；App 可替换为自己的 ChatProvider。
真实服务端配置接入常见协议
入门 · Node.js
运行此例需要提供可用模型服务的连接配置。
ts
import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
baseUrl: process.env.MODEL_BASE_URL!, apiKey: process.env.MODEL_API_KEY!, model: process.env.MODEL_NAME!,
} });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);js
import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
baseUrl: process.env.MODEL_BASE_URL, apiKey: process.env.MODEL_API_KEY, model: process.env.MODEL_NAME,
} });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);直连工具线程的声明字段与 wire 映射
配置 · Node.js
只演示消息转换，无网络请求或工具执行。原始 tool_calls、tool_call_id 和宿主附加数据不透传。
ts
import { Support } from '@jangts/agent-core';
const messages: Support.ProviderMessage[] = [
{ role: 'user', content: '查询资料' },
{ role: 'assistant', content: '', toolCalls: [
{ id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
] },
{ role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));js
import { Support } from '@jangts/agent-core';
const messages = [
{ role: 'user', content: '查询资料' },
{ role: 'assistant', content: '', toolCalls: [
{ id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
] },
{ role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));