钉钉需要在这里开发一个搜索卡片我要怎么去添加？

要在钉钉中开发一个搜索卡片并添加到应用中，您可以按照以下步骤操作。这些步骤基于知识库中的相关文档内容，涵盖了从创建应用到配置卡片的完整流程。

1. 创建钉钉应用

在开发搜索卡片之前，您需要先创建一个钉钉应用，并获取必要的凭证信息。

步骤：

1. 访问钉钉开放平台
   登录钉钉开放平台后台，进入应用开发页面。

2. 创建企业内部应用

   • 在左侧导航栏中，点击钉钉应用 > 创建应用。
   • 填写应用名称、应用描述，并上传应用图标。
   • 点击保存完成应用创建。

3. 获取应用凭证

   • 在左侧菜单选择凭证与基础信息。
   • 复制Client ID和Client Secret，用于后续配置连接流。

2. 创建消息卡片模板

钉钉机器人通过卡片消息支持流式返回结果，因此需要创建一个卡片模板供消息发送使用。

步骤：

1. 访问卡片平台
   登录钉钉卡片平台，进入模板管理页面。

2. 新建模板

   • 点击新建模板，填写模板信息。
   • 在关联应用中选择刚刚创建的钉钉应用。

3. 编辑并发布模板

   • 在模拟编辑页面，设计卡片样式（如标题、按钮、输入框等）。
   • 完成后点击保存并发布模板。

4. 复制模板ID

   • 返回模板列表页面，复制模板ID，用于后续创建连接流时使用。

3. 授予应用发送卡片消息权限

为了确保应用能够发送卡片消息，需要为其授予相关权限。

步骤：

1. 进入应用详情页面
   在钉钉应用列表中找到已创建的应用，点击应用名称进入详情页面。

2. 申请权限

   • 在左侧导航栏选择开发配置 > 权限管理。
   • 在搜索框中分别输入Card.Streaming.Write和Card.Instance.Write。
   • 在操作列点击申请权限，完成权限申请。

4. 创建钉钉连接流

通过AppFlow连接流，可以将大模型应用与钉钉集成，实现搜索卡片的功能。

步骤：

1. 使用AppFlow模板创建连接流

   • 访问AppFlow平台，选择预置的钉钉机器人连接流模板，点击立即使用。

2. 账户授权

   • 在账户授权配置向导页，点击添加新凭证。
   • 填入之前获取的钉钉应用的Client ID和Client Secret，设置自定义凭证名称。

3. 配置执行动作

   • 在执行动作配置向导页，填写以下信息：
     • 应用ID：从钉钉开放平台获取。
     • 模板ID：从卡片平台获取。
   • 点击下一步继续。

4. 填写基本信息

   • 在基本信息配置向导页，填写连接流名称和连接流描述（建议保持默认）。
   • 点击下一步完成配置。

5. 获取Webhook地址

   • 配置成功后，复制生成的WebhookUrl，用于后续配置机器人。

5. 配置钉钉机器人

完成上述步骤后，您可以在钉钉应用中配置机器人以支持搜索卡片功能。

步骤：

1. 配置机器人

   • 在钉钉应用的机器人设置中，填入之前获取的WebhookUrl。
   • 设置消息接收模式为Stream模式。

2. 测试卡片功能

   • 登录钉钉客户端，在聊天窗口中@机器人，输入关键词触发搜索卡片。
   • 检查卡片渲染效果是否符合预期。

重要提醒

• 权限申请：确保为应用授予了Card.Streaming.Write和Card.Instance.Write权限，否则无法发送卡片消息。
• 模板设计：卡片模板的设计应尽量简洁直观，避免过多复杂元素影响用户体验。
• 调试验证：在正式发布前，务必通过钉钉客户端进行充分测试，确保卡片功能正常。

通过以上步骤，您可以成功在钉钉中开发并添加一个搜索卡片，提升用户交互体验。