Skip to content

Latest commit

 

History

History

lke-agent

README.md

ADP 函数型 Agent 模板

本模板提供了 ADP (原: LKE) 腾讯云智能体开发平台函数型 Agent 的实现，部署后提供以下 Agent 相关接口：

POST   /v1/aibot/bots/:botId/send-message        发送消息
GET    /v1/aibot/bots/:botId/records             获取聊天记录

本模板使用了 @cloudbase/aiagent-framework，只需要实现该库定义的 IBot 接口 即可完成接入，详见 src/index.ts。

调用链路:

调用链路

获取 APP KEY

前往 ADP 腾讯云智能体开发平台，选择想要接入的应用，在右侧点击调用，即可在弹窗中获取 APP KEY。

环境变量

本仓库提供了环境变量模板 .env.template，可将其重命名为 .env 后再进行编辑。

  • 需要将APP KEY 配置到 LKE_APP_KEY 环境变量

本地调试指引

首先，请编辑 .env 文件配置好环境变量：

  1. LKE_APP_KEY: 填入腾讯云智能体开发平台应用的 APP KEY

配置完环境变量后，安装依赖：

npm i

即可启动本地调试：

npm run dev

现在可以通过 http://127.0.0.1:3000 访问本地 Agent 服务了。

cURL 访问本地服务

直接访问 http://127.0.0.1:3000 即可，例如 POST v1/aibot/bots/:botId/send-message 发送消息 接口：

curl 'http://127.0.0.1:3000/v1/aibot/bots/ibot-myBot-botTag/send-message' \
  -H 'Accept: text/event-stream' \
  -H 'Content-Type: application/json' \
  --data-raw '{"msg":"hi"}'

Web 访问本地服务

使用 Web 页面访问本地服务，可以直接编写网络请求代码，也可以使用 @cloudbase/js-sdk 提供的 Agent SDK。

若使用 @cloudbase/js-sdk，则需要配置一定的代理服务。以 whistle 举例，按照如下配置：

/.*.api.tcloudbasegateway.com/([^S]*)/ http://localhost:3000/$1

即可使用 @cloudbase/js-sdk 用以下代码访问到本地服务：

const res = await ai.bot.sendMessage({
  botId: "ibot-myBot-botTag",
  msg: "hi",
  history: [],
});

for await (let x of res.textStream) {
  console.log(x);
}

部署

安装依赖：

npm i

构建代码：

npm run build

部署到函数型云托管：

npm run deploy

根据输出提示填入云开发环境 id、服务名即可。

可前往 云开发平台 | 云托管 查看对应服务的部署情况。

参考文档