Model

配置 Anthropic、OpenAI-compatible 或自定义模型服务。

​

配置模型

SDK 内建 Anthropic Messages 与 OpenAI Completions 两类 Provider，apiType 默认自动检测，可根据模型名判断常见 OpenAI-compatible 模型。

​

OpenAI-compatible 模型

适用于 OpenAI、DeepSeek、Qwen、Mistral 或任何 OpenAI-compatible 端点：

export ZERONE_AGENT_API_TYPE=openai-completions
export ZERONE_AGENT_API_KEY=sk-...
export ZERONE_AGENT_BASE_URL=https://api.openai.com/v1
export ZERONE_AGENT_MODEL=gpt-4o

​

第三方 Anthropic-compatible 服务

export ZERONE_AGENT_BASE_URL=https://openrouter.ai/api
export ZERONE_AGENT_API_KEY=sk-or-...
export ZERONE_AGENT_MODEL=anthropic/claude-sonnet-4

​

代码选项

也可以在 createAgent() 中传入 apiType、apiKey、baseURL 和 model。代码选项优先适合单实例配置；环境变量适合部署注入。

选项	类型	默认值	说明
apiType	string	自动检测	'anthropic-messages' 或 'openai-completions'
model	string	claude-sonnet-4-6	LLM 模型 ID
apiKey	string	ZERONE_AGENT_API_KEY 环境变量	API key
baseURL	string	—	自定义 API 端点

​

环境变量

变量	说明
ZERONE_AGENT_API_KEY	API key（首选）
ZERONE_AGENT_AUTH_TOKEN	备选认证 token
ZERONE_AGENT_API_TYPE	anthropic-messages（默认）或 openai-completions
ZERONE_AGENT_MODEL	默认模型覆盖
ZERONE_AGENT_BASE_URL	自定义 API 端点
ZERONE_AGENT_MCP_GRACE_MS	MCP server 关闭宽限期（毫秒，默认 30000）

​

自定义 Provider

自定义 Provider 需要实现 LLMProvider 接口；也可以用 createProvider(apiType, opts) 直接创建 Provider 实例。代理、企业网关或兼容端点上线前，应验证流式事件、Tool call、错误码和 token 用量字段，而不仅是普通文本响应。