API - Messages

Message 类

import { Message } from 'kagent-ts'

// 工厂方法
Message.user(content: string): Message
Message.system(content: string): Message
Message.assistant(content: string, toolCalls?: ToolCall[]): Message
Message.tool(toolCallId: string, name: string, content: string): Message

// 转换
message.toDict(): MessageData
Message.fromDict(data: MessageData): Message

---

Role 枚举

import { Role } from 'kagent-ts'

enum Role {
  System = "system",
  User = "user",
  Assistant = "assistant",
  Tool = "tool",
}

---

MessageData

interface MessageData {
  role: Role
  content: string
  toolCallId?: string
  toolCalls?: ToolCall[]
  name?: string
}

---

ToolCall

interface ToolCall {
  id: string
  type: "function"
  function: {
    name: string
    arguments: string  // JSON string
  }
}

---

使用示例

import { Message, Role } from 'kagent-ts'

// 创建消息
const systemMsg = Message.system('你是一个有用的 AI 助手。')
const userMsg = Message.user('请帮我分析代码。')
const assistantMsg = Message.assistant('我来帮你分析代码。', [
  { id: 'call_1', type: 'function', function: { name: 'read_file', arguments: '{"path":"src/index.ts"}' } },
])
const toolMsg = Message.tool('call_1', 'read_file', '文件内容...')

// 转换为 API 格式
const messages = [systemMsg, userMsg, assistantMsg, toolMsg]
const apiMessages = messages.map(m => m.toDict())

下一步

• API - Session — Session API
• API - Context — Context & Compression API
• API - Agent — Agent 类 API