# Agent接入

Agent，或称为 AI Agent，是以大模型为基础，通过特定指令或指引，能够完成特定任务。Agent 利用 AI 大模型，具有强大的语言理解和生成能力，可以在各种领域执行复杂任务。

小程序基础库需要在 3.7.1 及以上版本，具备 wx.cloud.extend.AI 对象，开发者可以直接通过小程序中的 wx.cloud.extend.AI 调用。

# 初始化

在小程序代码中，通过以下代码进行云开发环境初始化：

wx.cloud.init({
    env: "<云开发环境ID>",
});

const ai = wx.cloud.extend.AI;

# AI.bot.get()

获取某个 Agent 的信息。

# 使用示例

await ai.bot.get({ botId: "botId-xxx" });

# AI.bot.list()

批量获取多个 Agent 的信息。

# 使用示例

await ai.bot.list({
  pageNumber: 1,
  pageSize: 10,
  name: "",
  enable: true,
  information: "",
  introduction: "",
});

# AI.bot.sendMessage()

与 Agent 进行对话。

# 使用示例

const res = await ai.bot.sendMessage({
  data: {
    botId: 'xxx-bot-id',
    msg: "你是谁"
  }
})
for await (let x of res.textStream) {
  console.log(x)
}

# AI.bot.getChatRecords()

获取聊天记录。

# 使用示例

await ai.bot.getChatRecords({
  botId: "botId-xxx",
  pageNumber: 1,
  pageSize: 10,
  sort: "asc",
});

# AI.bot.sendFeedback()

发送对某条聊天记录的反馈信息。

# 使用示例

const res = await ai.bot.sendFeedback({
  userFeedback: {
    botId: "botId-xxx",
    recordId: "recordId-xxx",
    comment: "非常棒",
    rating: 5,
    tags: ["优美"],
    aiAnswer: "落英缤纷",
    input: "来个成语",
    type: "upvote",
  },
});

# AI.bot.getFeedBack()

获取已存在的反馈信息。

# 使用示例

const res = await ai.bot.getFeedBack({
  botId: "botId-xxx",
  from: 0,
  to: 0,
  maxRating: 4,
  minRating: 3,
  pageNumber: 1,
  pageSize: 10,
  sender: "user-a",
  senderFilter: "include",
  type: "upvote",
});

# AI.bot.getRecommendQuestions()

获取推荐的问题。

# 使用示例

const res = await ai.bot.getRecommendQuestions({
  data: {
    botId: "xxx-bot-id",
    msg: "你是谁"
  }
})
for await (let x of res.textStream) {
  console.log(x)
}

# AI.bot.uploadFiles()

将云存储中的文件上传至 Agent，用于进行文档聊天。

# 使用示例

await ai.bot.uploadFiles({
  botId: 'bot-xx',
  fileList: [{
      fileId: 'cloud://xxx.pdf', 
      fileName: 'xxx.pdf', 
      type: 'file'
  }]
})

# 相关文档

AI SDK 文档