createRecordPair

方法概述

基本信息

1. 函数签名
   createRecordPair(params: CreateRecordPairParams): Promise<void>
2. 服务 URI 【不支持外部调用】
3. 返回类型
   Promise<void>
   - 异步方法，无返回值
4. 调用方式 内部方法，由 AgentRuntime 框架提供

功能说明

• 对话记录创建：创建用户输入和智能体输出的对话记录对
• 历史管理：支持多轮对话的历史记录存储
• 上下文维护：为后续对话提供上下文信息
• 数据持久化：将对话数据保存到系统中

参数说明

CreateRecordPairParams 参数数据结构：

参数详细说明

user_input 字段

• 类型：对象
• 结构：
  • content: string
    - 消息内容
  • role: string
    - 角色标识
• 作用：记录用户发送的消息内容

assistant_output 字段

• 类型：对象（可选）
• 结构：
  • content: string
    - 消息内容（可选）
  • role: string
    - 角色标识（可选）
  • reasoning_content: string
    - 推理内容（可选）
  • type: string
    - 消息类型（可选）
• 作用：记录智能体的回复内容

conversation_id 字段

• 类型：字符串
• 作用：唯一标识一个对话会话
• 用途：用于关联同一会话中的多条对话记录

返回值说明

该方法无返回值，成功执行后对话记录将被保存到系统中。

使用示例

基础使用示例

// 创建对话记录
const recordPair = {
    conversation_id: "conv_1234567890",
    user_input: {
        content: "你好，请帮我写一首诗",
        role: "user"
    },
    assistant_output: {
        content: "好的，我来为您写一首诗...",
        role: "assistant",
        type: "text"
    }
};

await agent.createRecordPair(recordPair);

带推理内容的使用示例

// 创建包含推理过程的对话记录
const recordPair = {
    conversation_id: "conv_1234567890",
    user_input: {
        content: "请分析这个数学问题",
        role: "user"
    },
    assistant_output: {
        content: "这个问题的答案是42",
        role: "assistant",
        reasoning_content: "首先分析题目条件，然后应用相关公式...",
        type: "analysis"
    }
};

await agent.createRecordPair(recordPair);

注意事项

⚠️ 重要提醒：

1. 会话ID唯一性：确保 conversation_id 在同一会话中保持一致
2. 数据完整性：建议同时提供 user_input 和 assistant_output 以保持对话记录的完整性
3. 错误处理：建议添加 try-catch 块处理可能的异常
4. 性能考虑：频繁调用可能影响性能，建议合理控制调用频率