如何快速在钉钉群接入私有大模型
利用阿里云计算巢Appflow，通过控制台配置即可顺利将您自己开发或微调的大模型接入钉钉或其他通信软件群聊，帮您解决以下各类场景的模型调用需求：
- 在钉钉群接入自己微调的领域大模型做问答或智能答疑；
- 微调后的大模型在钉钉群或其他群聊中共同测试效果
- ......
仅需简单几步，即可完成配置使用，下面将详细介绍配置方法
当然，前提条件是您的模型推理已经封装了可用的API～
配置方法
一、配置自定义连接器
- 登陆AppFlow首页，选择左侧菜单栏 连接器->自定义连接器，点击“创建连接器”。
- 上传您的连接器图标，填写名称、描述等相关基本信息，点击保存连接器。
- 点击左侧Tab可以依次配置鉴权和执行动作（触发事件如无特殊需求可以跳过）。首先点击“鉴权设置”，选择您需要鉴权类型。目前支持的鉴权类型包括：Basic Auth、Bearer Token、Appcode三种方式。具体如下：
- Basic Auth会在请求header中加入 “Authorization", "Basic [username:password]”
- Bearer Token会在请求header中加入 “Authorization", "Bearer [token]”
- Appcode会在请求header中加入 “Authorization", "Appcode [appcode]”
- 点击左侧执行动作，创建执行动作。填写当执行动作名称，例如“模型推理”，选择Http方法并填写请求接口路径。点击“下一步”。
- 点击“添加参数”，可按照您的API请求格式进行填写，如下图
参数类型支持object、array、string、number、boolean五种常见类型，其中object类型和array类型参数可点击右侧“添加”按钮添加嵌套子结构。
如果您已经有一个请求体JSON格式的示例，也可以使用导入JSON功能并做简单修改即可。
- 点击“下一步”配置响应体格式，将您的响应体安装配置执行动作一样的方法配置即可。请安装您的实际响应格式配置，否则可能导致后续流运行中参数引用报错。配置完成后点击保存草稿或发布。
二、配置连接流
- 点击左侧菜单栏“连接流”，选择“创建连接流”，填写当前连接流的基本信息。
- “选择触发事件”，找到并点击选择“钉钉机器人”，触发事件选择“收到文本消息时”，点击“保存，进入下一步”
- “选择执行动作”，点击“自建连接器”，找到您创建的连接器。选择您创建的“执行动作”并点击“保存，进入下一步”。
- 填写您设置的请求体参数，点击右侧插入变量按钮，可以应用钉钉机器人收到的消息作为参数。例如下图：
表示，当前连接器的“内容”变量应用上一个节点的“请求体-会话消息-消息内容”参数，即之后您在钉钉群@机器人发送的消息内容
- 填写完成后点击“
”配置模型推理后的消息发送回钉钉的执行动作。选择“钉钉机器人”，执行动作选择发送文本消息，点击“保存，进入下一步”进行参数配置。
- Webhook地址点击右侧“插入变量”，选择节点1的“会话回调地址”
“加签”在稍后创建完机器人后获取并填写，这里暂时跳过。
“本文内容”配置您的执行动作中实际代表您模型推理结果的字段，您的实际参数可能会与下图示例有所出入，按实际填写即可。
- 点击保存即可完成配置。回到页面再次点击编辑，进入流编辑页面，点击第一个节点的编辑按钮，可以获取调用webhook地址，请保存改地址后续在钉钉机器人配置中使用。
三、创建钉钉机器人（使用Outgoing功能，更简单）
- 直接在需要加入机器人的群聊中进入机器人管理页面添加自定义机器人，
- 填写机器人基本信息。安全设置选择“加签”，复制签名密钥，回到Appflow,点击左侧菜单栏“连接流”，找到刚创建的连接流并点击详情。进入连接流详情页点击“编辑”。
- 进入流基本信息填写页面，直接点击下一步，进入流配置页面。点击“步骤3：发送文本信息”的编辑按钮，点击“入参配置”，在加签Tab填写钉钉机器人生成的签名，点击保存即可。
- 回到钉钉机器人页面，勾选“开启Outgoing机制”，在POST地址栏填写第一步中的Webhook地址，点击完成即可。
- 在群里中@机器人即可实现对话
三、创建钉钉机器人（使用钉钉开放平台）
- 访问钉钉开放平台，联系您的组织管理员获取开发权限。然后点击创建应用。成为钉钉开发者的步骤可以参考文档https://open.dingtalk.com/document/orgapp/become-a-dingtalk-developer
- 选择左侧“机器人”Tab，然后点击右侧“创建应用”按钮。填写您的“应用名称”和“应用描述”，上传应用图标并点击保存。
- 点击保存后跳转到应用开发页面，下来当前页面到最下方选择“机器人”并点击添加。点击“机器人配置”按钮展开机器人配置信息。
- 填写相关必填信息。消息接收模式请选择“HTTP”模型，页面会出现“消息接收地址”输入框。在这里填写刚刚在AppFlow获取的地址。
- 点击调试按钮。可以钉钉扫码进群调试机器人。确认无误后点击发布。
- 回到应用开发页面，点击刚刚创建的应用名称进入应用详情页面。点击左侧菜单栏最下方的“版本管理与发布”，进入到版本发布与管理，点击右上角“创建新版本”按钮，输入版本相关信息，并选择合适的“应用可见范围”。
- 点击保存将进入权限审批环节，审批结束后应用将自动发布。如果您已经有权限了可以点击直接发布。
- 去您想要添加对话机器人的群里添加机器人。@机器人即可与通义千问机器人进行对话啦！
写在最后
Appflow是阿里云计算巢团队自主研发的一款应用与数据集成平台，目前开发团队已经支持了众多公共连接器，您可以尽情发挥您的想象，使用AppFlow为您免去繁琐的重复接入和开发工作，为你的工作提速提效！
点击页面左侧"连接流"Tab，去创建你自己的Flow吧~
联系我们
有任何疑问或者需求或者合作意向都可以加入我们的官方支持钉钉群（群号 69295006877）～欢迎大家一起加入群聊交流，为工作和Coding提效～
