GenKit项目中多轮对话消息格式的正确使用方法

在GenKit项目中，开发者经常需要实现多轮对话功能。然而，许多开发者在尝试使用messages参数时会遇到类型错误，这是因为对消息格式的理解存在偏差。

消息格式的正确结构

GenKit要求消息内容(content)必须采用多部分(multi-part)格式，即使内容只是简单的文本。正确的消息格式应该是一个数组，其中每个元素都是一个包含text属性的对象。

错误示例：

{
  role: "user",
  content: "Hello, can you help me plan a trip?"
}

正确格式：

{
  role: "user",
  content: [{text: "Hello, can you help me plan a trip?"}]
}

完整的多轮对话示例

下面是一个完整的多轮对话实现示例，展示了用户与模型之间的三次交互：

const response = await ai.generate({
  messages: [
    { 
      role: "user", 
      content: [{text: "Hello, can you help me plan a trip?"}] 
    },
    { 
      role: "model", 
      content: [{text: "Of course! I'd be happy to help..."}] 
    },
    {
      role: "user",
      content: [{text: "I want to visit Japan for two weeks in spring."}],
    },
  ],
});

为什么需要这种格式

这种设计允许更灵活的消息内容组合，未来可以支持：

1. 混合文本和媒体内容
2. 结构化数据的嵌入
3. 更丰富的内容元数据
4. 多模态交互支持

常见错误排查

当遇到类型错误时，开发者应检查：

1. content属性是否被包装在数组中
2. 每个内容部分是否包含text属性
3. 角色(role)是否使用正确的值(user/model)

通过遵循这些格式要求，开发者可以充分利用GenKit的多轮对话功能，构建更自然流畅的AI交互体验。