Skip to main content

概述

当你需要实现私有 Agent 流式 API 协议对接时，可以通过继承 BaseAgentService 来创建自定义的 Agent 服务类。

什么是 AgentService​

AgentService 是用于处理与 AI 对话服务通信的核心组件，它负责：

  • 发送用户消息到 AI 服务端
  • 接收并处理流式响应数据
  • 管理对话会话状态
  • 处理连接异常和重试逻辑

核心功能​

1. 流式对话处理​

通过 SSE (Server-Sent Events) 或 WebSocket 等方式实现实时对话响应。

2. 会话管理​

自动维护对话会话 ID，确保多轮对话的连续性。

3. 错误处理​

提供完整的错误处理机制，包括网络异常、服务器错误等情况。

4. 扩展性​

支持自定义请求参数、响应处理逻辑和业务特定功能。

使用场景​

  • 接入私有化部署的 AI 对话服务
  • 需要自定义请求/响应格式的场景
  • 实现复杂的业务逻辑处理
  • 添加自定义的监控和埋点

配置说明​

⚠️ 重要提示：当使用自定义 agentService 时，标准的 agentConfig 配置将不可用。所有相关配置需要在自定义服务类中实现。

import {createAaaSPilotKit, BaseAgentService} from '@bdky/aaas-pilot-kit';

// 创建自定义 AgentService
class CustomAgentService extends BaseAgentService {
    // 实现具体逻辑
}

// 在 Kit 初始化时绑定，<CustomAgentService> TS 范型建议传入，用于类型约束
const kit = createAaaSPilotKit<CustomAgentService>({
    // 其他配置...
    agentService: CustomAgentService
});

接下来​

选择适合你项目的 HTTP 客户端实现：