Provider 配置

支持的 Provider

Provider	type 值	说明
OpenAI	'openai'	官方 OpenAI API
Anthropic	'anthropic'	Claude 系列模型
Azure OpenAI	'azure-openai'	Azure 托管的 OpenAI
Gemini	'gemini'	Google Gemini 系列
DeepSeek	'deepseek'	DeepSeek 模型
OpenAI 兼容	'openai-compatible'	任何兼容 OpenAI API 的服务

ProviderConfig

interface ProviderConfig {
  type: ProviderType;
  apiKey?: string;
  baseUrl?: string;
  headers?: Record<string, string>;
  organization?: string;
  apiVersion?: string;
  projectId?: string;
}

配置示例

OpenAI

{ type: 'openai', apiKey: 'sk-xxx' }

Anthropic

{ type: 'anthropic', apiKey: 'sk-ant-xxx' }

Azure OpenAI

{
  type: 'azure-openai',
  apiKey: 'xxx',
  baseUrl: 'https://my-resource.openai.azure.com',
  apiVersion: '2024-02-15-preview',
}

Gemini

{ type: 'gemini', apiKey: 'xxx' }

DeepSeek

{ type: 'deepseek', apiKey: 'xxx' }

OpenAI 兼容

适用于 Ollama、vLLM、LiteLLM 等兼容 OpenAI API 的服务：

{
  type: 'openai-compatible',
  baseUrl: 'http://localhost:11434/v1',
  apiKey: 'ollama',
}

运行时切换模型

const session = await createSession({
  provider: { type: 'openai', apiKey: process.env.OPENAI_API_KEY! },
  model: 'gpt-4o-mini',
});

// 简单任务用小模型
await session.send('列出 src 目录下的文件');
for await (const event of session.stream()) { /* ... */ }

// 复杂任务切换到大模型
await session.setModel('gpt-4o');
await session.send('重构这些文件的架构');
for await (const event of session.stream()) { /* ... */ }

查看支持的模型

const models = await session.supportedModels();
for (const m of models) {
  console.log(`${m.id}: ${m.name}`);
}

日志

SDK 不内置日志实现，通过 AgentLogger 接口接受外部注入：

import type { AgentLogger, LogEntry } from '@blade-ai/agent-sdk';

const logger: AgentLogger = {
  log(entry: LogEntry) {
    const prefix = `[${entry.timestamp}][${entry.level.toUpperCase()}][${entry.category}]`;
    console.log(`${prefix} ${entry.message}`);
  },
};

const session = await createSession({
  provider: { type: 'openai', apiKey: process.env.OPENAI_API_KEY! },
  model: 'gpt-4o',
  logger,
});

LogEntry

interface LogEntry {
  level: 'debug' | 'info' | 'warn' | 'error';
  category: string;
  message: string;
  timestamp: string;
  sessionId?: string;
  args?: unknown[];
}