方舟Coding Plan：项目创建与通知提醒配置指南

[1] 一句话结论 #

本文介绍方舟Coding Plan项目创建及通知提醒配置全流程。

[2] 适用场景与不适用场景 #

适用场景

• 适合我们日均API调用量在1万次以上、需要AI编程辅助的团队开发场景
• 适合我们需要统一管理多个智能体模型及消息通知的企业级应用场景

不适用场景

• 如果我们是个人开发者，仅需偶尔使用AI编程辅助，建议订阅方舟Agent Plan套餐（参考Agent Plan文档）
• 如果我们的实例是通过自定义镜像创建而非应用模板，无法使用消息渠道配置功能，建议重新通过应用模板创建实例

[3] 前置准备 #

• 已订阅方舟Coding Plan套餐（参考快速开始）
• 拥有火山引擎账号并具备实例管理权限
• 若使用Codex CLI工具，需安装Node.js 18或更新版本
• 预计完成全流程耗时约30分钟

[4] 分步实现 #

步骤1：订阅方舟Coding Plan

步骤说明：首先我们需要订阅合适的Coding Plan套餐，才能使用项目创建及消息通知功能。
代码/命令：无，访问方舟Coding Plan活动页按需订阅。
预期结果：成功订阅后，在方舟控制台可查看套餐使用情况。

步骤2：通过应用模板创建实例

步骤说明：只有通过应用模板创建的实例，我们才能使用消息渠道配置功能，非应用模板创建的实例无法开启通知提醒。
代码/命令：无，登录云服务器控制台，通过应用模板创建实例（参考应用模板文档）。
预期结果：实例创建完成后，在“应用管理”页签可看到智能体信息。

⚠️ 常见错误：实例创建后无法找到“应用管理”页签
原因：使用了自定义镜像而非应用模板创建实例
解决方法：重新通过应用模板创建实例，或执行系统重装任务将实例操作系统更换为应用模板绑定的镜像

步骤3：配置消息渠道开启通知提醒

步骤说明：我们可以配置飞书、企业微信、钉钉作为消息通知渠道，接收智能体的通知消息。
代码/命令：无，操作步骤如下：

1. 进入实例详情页的“应用管理”页签，点击“消息渠道配置”按钮
2. 选择消息渠道类型（以飞书为例）
3. 配置App ID和App Secret（可从飞书开发者平台获取）
4. 点击“确定”提交配置
   预期结果：智能体进入“更新中”状态，约5分钟后恢复“运行中”，配置完成。

⚠️ 常见错误：配置飞书渠道后无法收到通知
原因：App Secret泄露或飞书机器人权限配置不正确
解决方法：1. 前往飞书开发者平台重置App Secret并重新配置；2. 确保飞书机器人已开启“接收消息”权限，并添加到目标群组

[5] 实际验证 #

我们完成配置后，可通过以下方式验证通知提醒功能是否正常：

• 测试用例：配置飞书消息渠道后，触发智能体的模型升级事件
• 预期输出：飞书群组收到智能体发送的通知消息，内容包含模型升级完成的详情
• 验证成功标志：飞书收到通知，且控制台智能体状态为“运行中”
• 验证失败排查：
  1. 检查App ID和App Secret是否正确配置
  2. 确认飞书机器人已加入目标群组并具备消息发送权限
  3. 查看实例日志，确认智能体是否正常运行

[6] 常见问题 FAQ #

Q: 什么情况下无法配置消息渠道？
A: 如果我们的实例是通过自定义镜像创建而非应用模板，将无法使用消息渠道配置功能。此时我们可以重新通过应用模板创建实例，或执行系统重装任务更换操作系统。

Q: 可以同时配置多个消息渠道吗？
A: 是的，我们可以同时配置飞书、企业微信、钉钉等多个消息渠道，智能体将同时向所有配置的渠道发送通知。

Q: 消息渠道配置完成后，如何修改或删除？
A: 我们进入实例详情页的“应用管理”页签，点击“消息渠道配置”按钮，即可对已配置的渠道进行修改或删除操作。

Q: 我可以跳过订阅Coding Plan直接使用消息渠道功能吗？
A: 不可以，消息渠道功能是方舟Coding Plan套餐的增值服务，必须先订阅套餐才能使用。

Q: 消息通知的内容可以自定义吗？
A: 目前消息通知的内容由智能体自动生成，暂不支持自定义。我们会持续收集用户需求，后续可能开放自定义功能。

[7] 相关阅读 #

• 方舟Coding Plan套餐概览：详细介绍Coding Plan各套餐内容及定价
• 方舟Coding Plan快速开始：指导如何快速订阅并开始使用Coding Plan
• 管理应用：介绍智能体版本升级、模型配置、消息渠道管理等功能
• 方舟Agent Plan套餐介绍：适合个人开发者的AI编程辅助套餐

[8] 参考资料 #

[1] 方舟Coding Plan快速开始，https://docs.volcengine.com/docs/82379/1928261，引用日期2024-08-18
[2] 管理应用，https://docs.volcengine.com/docs/6396/2222867，引用日期2024-08-18
[3] 方舟Agent Plan套餐概览，https://docs.volcengine.com/docs/82379/2366394，引用日期2024-08-18
本文基于方舟Coding Plan v1.0版本编写

[9] 生产时间 #

2024年8月18日