1. 创建钉钉应用
首先需要在钉钉开放平台创建应用并获取凭证:
登录[钉钉开发者后台],进入应用开发页面,点击创建应用。
填写应用名称、描述等信息,选择应用类型为"企业内部应用"或"第三方企业应用"。
创建完成后,在应用详情页面获取Client ID和Client Secret。
2. 配置机器人能力
在应用能力中添加机器人功能,填写机器人名称和描述。
重要:必须选择Stream模式作为消息接收模式。
为应用申请必要的权限,包括企业内机器人发送消息权限、互动卡片实例写权限和AI卡片流式更新权限。
3. 阿里云侧配置
有两种主要配置方式:
方式一:使用APPflow服务
登录阿里云APPflow控制台,创建连接流。
在账户授权配置中填入钉钉的Client ID和Client Secret。
在执行动作配置中填写应用ID和模板ID。
配置完成后获取Webhook URL并发布连接流。
方式二:通过ECS部署
创建ECS实例并配置安全组。
开通阿里云百炼平台的LLM调用服务,获取API-KEY。
编写钉钉机器人post程序部署在ECS上,设置消息接收端口。
4. 发布与测试
在钉钉开放平台发布应用。
重要:发布需要两次操作,缺一不可。
设置可见范围后,可以通过机器人名称搜索测试。
5. 高级功能配置(可选)
绑定知识库:将知识库ID绑定到机器人,实现自动调用知识库回答问题。
流式接口:使用SSE流式调用会话接口,实现大模型流式输出。
注意事项:
1. 安全设置必须选择"自定义关键词"并添加关键词"EMAS"(如用于告警)。
2. Webhook地址格式为:`
3. API-KEY需要妥善保管,生成后立即复制。