¶ 接入自定义智能体
¶ 前言
本示例以接入医疗智能体为案例，演示如何通过 Vibe Coding 完成一项自定义链路开发任务。
本文重点主要介绍一套可复用的Vibe Coding协作思路：
明确目标与边界 → 审核实施计划 → 安全补充信息 → 根据问题现象持续迭代 → 建立自动化测试闭环 → 完成人工验收
¶ 一、准备工作
- 参考文档 《快速开始》，完成设备接入自建应用。
- 参考文档 《火山方舟 Managed Agents 控制台快速入门》，在火山引擎官网创建医疗智能体、搭建智能体运行环境，并获取火山 API Key。
¶ 二、自定义链路开发
¶ 1. 需求阶段
使用 Vibe Coding 开发功能时，首先需要向 Agent 说明业务目标、能力边界、技术约束和安全要求，避免 Agent 只关注新增功能，而忽略原有能力和系统限制。
-
打开 AI 编程助手，输入以下提示词：
请使用 ling Skill，在 LSPlatform 自建应用中开发、部署并验证自定义 Agent 测试链。 需求： 1. 医疗问题路由到火山方舟 Managed Agent： - Agent ID：agent-xxxxxx-xxxx - Environment ID：env-xxxxxx-xxxx - API Base URL：https://ark.cn-beijing.volces.com/api/v3 2. 普通对话和设备控制继续使用 LSPlatform 官方模型，保证设备工具可用。 3. API Key 只从本地安全配置读取，不要回显或写入源码。 如果需求有不明确的地方，请向我确认，并给出实施计划。如下图所示：
Vibe Coding 技巧：提出需求时，应尽可能说明业务目标、能力边界和安全要求。例如，本示例不仅要求新增医疗问答能力，还要求保留普通对话和设备控制能力。
- 发出需求后，等待 Agent 完成需求分析。确认其实施计划已经覆盖问题路由、原有能力回归和 API Key 安全配置等要求后，即可进入开发阶段。
¶ 2. 开发阶段
在开发过程中，Agent 可能会要求补充项目配置或运行环境等信息。此时，应根据实际情况提供必要信息，同时继续遵守前期约定的安全边界。
- 检查 Agent 给出的实施计划，确认其对需求的理解是否准确；如有偏差，应先补充或修正，再开始开发。
- 按照 Agent 的指引，将 API Key 写入本地安全配置。不要在对话中直接发送 API Key，也不要将其写入源码。
- 按照提示继续操作，直至 Agent 完成初步开发、构建和部署，随后进入真机验证阶段。
¶ 3. 问题排查与迭代验证
尽管前期已经进行了详细的需求沟通，但对于较为复杂的需求，通常难以通过一次迭代直接完成交付。
此时，需要与 Agent 进行多轮沟通，根据实际现象分析问题原因，并通过持续测试和调整，使最终结果逐步符合预期。
¶ 从问题反馈到测试闭环
如果验收结果不符合预期，可以先向 Agent 反馈可观察到的问题现象，让其完成分析和修复；当测试项逐渐增多时，则应进一步明确测试与验收标准，让 Agent 建立自动化测试闭环。
- 通过真机测试，我们发现设备没有响应。此时，可以将实际观察到的问题现象反馈给 Agent，让其继续分析并解决。
- Agent 完成一轮分析后，定位到问题原因为响应时间超过会话时长，并完成了相应处理。
- 如果后续每发现一个问题，都单独反馈给 Agent 进行修复，沟通和验证的效率会比较低。因此，可以将功能目标转化为明确的测试用例和验收标准，让 Agent 自动完成测试、定位、修复和回归验证。
请继续使用 ling Skill，自动生成当前项目的测试用例，并生成相应音频，模拟设备上报音频，完成端云交互联调和回归测试。 1. 验证类似“什么是糖尿病”的医疗问题咨询。 2. 回归测试普通对话和设备控制。 3. 测试失败时，自动定位、修复、构建并部署到测试链，然后重新测试，直至通过。 4. 最后输出测试报告，包含测试用例、预期结果、实际结果、通过状态、SID、trace 和部署版本。
- 自动化测试通过后，检查测试报告中的用例、结果和链路追踪信息。确认测试结果基本符合预期后，即可进入最终的人工验收。
¶ 三、功能验收
自动化测试可以提高迭代效率，但不能替代最终验收。完成开发后，仍需通过真机体验和第三方日志，分别验证新增能力、调用链路和原有能力。
- 唤醒设备后，说“糖尿病是什么？”，设备能够正常回答糖尿病相关内容。
- 在第三方智能体的日志中，可以查询到设备成功调用第三方智能体的问答记录。下图以火山引擎官网为例：
- 与设备交互，控制屏幕亮度和设备音量，确认原有设备控制能力仍能正常使用。
至此，我们完成了从需求描述、计划审核、开发迭代、自动化测试到人工验收的完整 Vibe Coding 流程。这套协作思路也可以应用于其他自定义能力的开发。