34 lines
975 B
Go
34 lines
975 B
Go
// Package ai 定义 AI 聊天 Provider 抽象与工厂：
|
||
// 上层只依赖 Provider 接口，通过 New 按设置创建讯飞星火 Lite 或 DeepSeek 实例。
|
||
package ai
|
||
|
||
import "context"
|
||
|
||
// Message 是一条对话消息（role: system | user | assistant）。
|
||
type Message struct {
|
||
Role string `json:"role"`
|
||
Content string `json:"content"`
|
||
}
|
||
|
||
// Chunk 是流式返回的一段增量内容；Err 非空表示流异常中止。
|
||
// Usage 在流结束时可选附带 token 用量（若服务商提供）。
|
||
type Chunk struct {
|
||
Content string
|
||
Err error
|
||
Usage *Usage
|
||
}
|
||
|
||
// Usage 一次调用的 token 用量。
|
||
type Usage struct {
|
||
PromptTokens int64
|
||
CompletionTokens int64
|
||
Estimated bool
|
||
}
|
||
|
||
// Provider 是 AI 服务商的统一抽象。
|
||
type Provider interface {
|
||
Name() string
|
||
// ChatStream 发起流式对话，返回增量内容通道；通道关闭即流结束。
|
||
ChatStream(ctx context.Context, messages []Message) (<-chan Chunk, error)
|
||
}
|