钉钉 Bot
把智能体接入钉钉，在私聊或群聊中直接交代工作。
把智能体接入钉钉后，智能体所在工作区的成员可以私聊 Bot、在群里 @ Bot，或用 /issue 指令直接创建 trackica 任务。对话和执行记录会保存到 trackica 工作区。
钉钉集成由社区维护，不提供官方支持 SLA。遇到问题请提交到 GitHub issues。
连接 Bot
智能体创建者或工作区 owner/admin 可以将智能体接入钉钉，智能体跟钉钉 Bot 是 1:1 的连接关系。
1. 创建 Stream 模式机器人
- 在钉钉开放平台创建一个企业内部应用。
- 开启机器人能力，其中消息接收模式设为 Stream 模式。
2. 给机器人授权
默认已添加“机器人发消息权限”（qyapi_robot_sendmsg）。如需在 trackica 平台显示 Bot 名称，需手动添加“钉群基础信息管理权限”（qyapi_chat_manage）。
3. 获取应用凭证
进入凭证与基础信息页面，复制 Client ID（AppKey） 和 Client Secret（AppSecret）。
4. 把智能体接入钉钉
- 回到 trackica，打开 智能体 → 你的智能体 → 能力 → 集成。
- 点击连接钉钉。
- 填入 AppKey 和 AppSecret 后提交。
5. 关联钉钉账号与 trackica 平台账号
在钉钉上跟 Bot 私聊，或者在群里 @ Bot，触发一次关联请求，你会在 Bot 私聊对话框中收到一个链接（有效期约 15 分钟），点击链接后看到连接成功的提示即大功告成。
在钉钉中给智能体交代工作
私聊
直接给 Bot 发消息即可。智能体处理完任务后，会将结果回复至私聊对话框中。
群聊
把 Bot 加入钉群，再发送 @your-bot <消息>。每次追问都要重新 @，Bot 只处理 @ 它的消息。
发送图片
私聊和群聊都支持图文混排消息，图片支持 PNG、JPEG、GIF、WebP 和 BMP；每条消息最多 4 张，每张不超过 10 MB。暂不支持文件和语音消息。
使用 /issue 创建任务
发送 /issue <标题> 或者 /issue <标题>{换行}<详细描述>，就可以创建一个新 trackica 任务，并自动指派给 Bot 连接着的智能体。同一条消息内的图片也会以附件的形式添加到该任务中。跟普通对话消息不一样的是，/issue 指令不会在 trackica 的“对话”中留下记录。
使用 /new 重新开始
发送 /new，再下一条成功发送的消息就会让智能体在全新的上下文中处理；也可以发送 /new <消息>，智能体会直接在全新的上下文中处理这条消息。
需要注意的是，/new 指令只是让智能体在全新的上下文中处理消息，并不会创建一个全新的 trackica “对话”。
管理连接
- 在智能体 → 你的智能体 → 能力 → 集成页面，智能体创建者、工作区 owner/admin 可以在此连接钉钉，或者断开连接。连接上钉钉后，这里会显示 Bot 名称和已成功处理过消息的钉群，以及 Bot 在钉群内的活跃状态数据，有智能体读权限的工作区成员都能看到这些信息。最近 90 天没有成功处理消息的群会归入长期未活跃，展开时再加载。
- 在设置 → 集成页面，显示当前工作区内所有有读权限且连接了钉钉的智能体列表，以及 Bot 在钉群内的活跃状态数据。工作区 owner/admin 还可以在此直接断开列表中任意智能体的钉钉连接。断开后 Bot 停止接收消息，安装记录仍会保留用于审计。工作区 owner/admin 还可以忘记某个群。忘记只会从列表中移除该群，不会删除对话和消息。如果已关联钉钉账号的工作区成员以后在该群再次 @ Bot，且 trackica 成功接收这条消息，群会重新出现。
自部署配置
私有部署需要先设置一个用于加密钉钉 AppSecret 的密钥：
TRACKICA_DINGTALK_SECRET_KEY=<base64-encoded 32-byte key>可以这样生成：
openssl rand -base64 32重启 API 服务后，再连接钉钉。该密钥需要长期保存：更换或丢失后，已有 token 无法解密，需要重新连接。
账号绑定链接使用 TRACKICA_APP_URL，未设置时回退到 FRONTEND_ORIGIN；它需要指向成员可以访问的 trackica 地址。