【集成示例】Lark机器人

效果展示

准备工作

智能对话机器人配置

1. 进入智能对话机器人控制台，选择左侧导航栏的应用管理>机器人>新建机器人。

2. 获取机器人ID，发布机器人（如无发布按钮则跳过）。

   

3. 访问智能对话机器人业务空间，获取业务空间AgentKey。

   

4. 访问RAM控制台，获取阿里云账号的ACCESS_KEY和SECRET_KEY。

Lark应用配置

1. 访问Lark后台，创建企业自建应用。

2. 添加机器人应用能力

3. 获取AppId和AppSecret。

4. 下载示例工程代码，并按照说明填写参数。

5. 选择事件与回调菜单，进行事件配置。

6. 选择权限管理菜单，导入下面的权限配置。

   {
     "scopes": {
       "tenant": [
         "cardkit:card:write",
         "im:message.group_at_msg:readonly",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot"
       ],
       "user": []
     }
   }

7. 选择版本管理与发布菜单，创建版本并发布。注意，在这里可以配置机器人的可见范围。

   

操作步骤

1. 调用ApplyForStreamAccessToken接口。参考文档：ApplyForStreamAccessToken - 获取流式调用的连接信息。

2. ApplyForStreamAccessToken接口，返回的连接签名信息有效期2小时，必须在到期前重新获取。

3. 监听并接收机器人的消息（用户问机器人的消息）。

4. 创建卡片实体：创建卡片；发送AI卡片消息：发送AI卡片。

5. 计算会话接口签名。会话接口签名。

6. SSE流式调用会话接口，监听SSE事件，获取大模型流式输出。参考文档：流式会话接口。

7. 大模型流式接口会多次返回，每次返回都是全量的回复，渲染端应该考虑用新的覆盖旧的。响应参数参考：流式会话接口。

8. 更新AI卡片：AI卡片流式更新。

示例工程代码

源代码下载（JAVA）

feishu-example.zip

示例运行配置

1. 本示例工程的运行环境要求为JDK 8，参考文档：在Windows安装JDK。

2. 根据本文的准备工作，获取示例参数。

3. 打开启动类FeishuRobotChatApp中填写相关参数。

4. 运行com.aliyun.chatbot.channel.FeishuRobotChatApp这个类的主方法。

5. 打开Lark，通过机器人名称搜索并打开对应的机器人，即可进行问答。

示例参数

常见问题

Q：无法收到消息。

A：请检查需要配置的权限。