无尘阁日记

无尘阁日记

codecubby构建智能体的过程
2025-08-20

你要做的不是“造个会笑的机器人”,而是“搭个能干实事的帮手”。下面我把整个流程讲清楚,一步步照做就能跑起来。

先说明一下:你问到的“codecubby”我理解为腾讯云的 CodeBuddy(不少人会打成 CodeBubby/CodeCubby)。下面以 CodeBuddy 的“Craft 软件开发智能体”和 MCP 能力为例,讲清楚从 0 到 1 构建智能体的实操路径与关键心法;若你说的是另一个平台,告诉我名字我再按那个改写。

一、准备环境:把“人—模—工具—工程”四件事对齐

  1. 安装与登录
    在 VS Code / JetBrains / 微信开发者工具等 IDE 的插件市场安装“腾讯云代码助手 CodeBuddy”,登录你的腾讯云账号即可开始用。官方插件页与官网可确认支持的 IDE 列表与安装入口。(marketplace.visualstudio.comcopilot.tencent.com)

  2. 认识 Craft(软件开发智能体)
    Craft 是 CodeBuddy 的“能干活的 Agent”模式:你用自然语言提需求,它会先做计划,再自动生成/改写多文件代码、给出 diff、可一键接受或拒绝,还能切换底层模型(混元、DeepSeek)。(腾讯云)

  3. 了解 MCP(Model Context Protocol)
    若你要让智能体“会用工具”,比如读外部数据、部署网页、调用企业内服务,就要在 Craft 里配置 MCP servers。CodeBuddy 提供 MCP 配置入口和示例(比如 Time server/EdgeOne Pages 部署)。(腾讯云)

二、开干:在 Craft 里从一句话到可运行工程
下面以 VS Code 为例(JetBrains/微信开发者工具入口相同):

步骤 A:切到 Craft 模式
在对话输入框的模式开关里选择“Craft”,或用快捷键(Windows:Alt+I,macOS:⌘+I)。开启“生成计划(Plan)/自动运行/自动修改文件”三项,能让智能体先澄清需求、自动拆解、自动写改文件。(腾讯云)

步骤 B:喂上下文,减少走弯路
在输入框点“@ Add”,把关键素材加进来:
@File/@Folders(相关源码或空项目骨架)、@Diff(变更)、@Docs(官方/自定义知识库)、@Terminal(最后一条命令)。也可在资源管理器右键“添加到对话”,或圈选代码右键加入。(腾讯云)

步骤 C:讲清需求 → 确认计划 → 让它执行
直接用自然语言描述目标,比如:“用 React + Vite 建一个待办清单,包含新增/勾选/搜索,写单测”。Craft 会先问问题补全细节,随后给出“执行计划”。你确认后,它会批量创建/改写文件,并以 diff 形式展示。(腾讯云)

步骤 D:逐条审阅改动
对每个文件/全部改动做“接受/拒绝”。点击蓝色文件名可跳转定位修改处。必要时回退到历史版本或检查点,继续迭代。(腾讯云)

步骤 E:切换底层模型与复跑
Craft 预置了 hunyuan 与 deepseek-v3,可按工程类型切换;跑完可再次补充需求或优化点,继续迭代。(腾讯云)

三、会用工具:给智能体接上 MCP,打开“手脚”
如果你的 Agent 需要部署、查配置、调内部 API,就要配置 MCP server:

  1. 打开 MCP 配置
    进入 Craft,点“MCP 配置”,新建/编辑 Craft_mcp_settings.json。(腾讯云)

  2. 写一个最小可用的 MCP server 配置
    官方文档给了示例(如 Time MCP Server):在 mcpServers 下写 command/args 等字段。配置后,Craft 就能在会话里调用这个工具。(腾讯云)

  3. 典型用法:一键部署静态站点
    接入 EdgeOne Pages 的 MCP server 后,Craft 生成的 HTML/CSS/JS 可直接部署并返回公网 URL,形成“生成→部署”的闭环。(博客园腾讯云)

四、做自己的 Agent:企业侧“自定义智能体”
如果你是团队/企业用户,需要沉淀专用 Agent(带自家接口、知识、权限):

  1. 在企业管理后台“智能体”里新建,选择“自定义服务接入”,填写名称、描述、可见范围,保存后在本地 IDE 即可使用。(cloud.tencent.com.cn)

  2. 结合“自定义智能体/自定义规则/自定义模型/RAG 知识库”,把通用的 Craft 变成你们的“专用员工”。官方操作指南给出了这些板块的入口。(腾讯云)

五、从流程到心法:把 Agent 真正用起来

  1. 先定边界再放权
    一句话清楚“要什么/不要什么/必须遵守的约束”,比如目录结构、技术栈、编码规范、测试覆盖率阈值;把这些写在首次提示里,Craft 的“计划”会更可控。(腾讯云)

  2. 让上下文“干净、成套、充足”
    该给的文件、数据样例、API 文档、终端输出都加到上下文;不要喂冲突材料,避免 Agent 来回推翻自己。(腾讯云)

  3. 小步快跑、频繁审阅
    每一轮都从 diff 里挑问题,拒绝不合格改动,补充新约束再跑一轮。必要时回退到前一版本,别硬顶。(腾讯云)

  4. 工具即能力:尽早打通 MCP
    只会“写代码”的 Agent 不算“能干活”。把常用动作(部署、数据拉取、扫描、发布)做成 MCP server,日常就能一句话完成流水线。(腾讯云博客园)

  5. 团队化沉淀
    把稳定的提示词、规则、知识库、工具封装成“自定义智能体”,统一到企业管理后台,减少个人“土法炼钢”。(cloud.tencent.com.cn腾讯云)

六、一个从 0 到 1 的最小示例(你可以照抄思路)
目标:做一个“活动介绍页”,并且自动部署预览链接。
A. 在 VS Code 安装 CodeBuddy,切到 Craft,开启“计划/自动运行/自动修改”。(marketplace.visualstudio.com腾讯云)
B. @Add 一个空目录作为上下文,提出需求:“做一个单页 Landing,含导航/亮点/报名表单,适配移动端,给出简单单测”。(腾讯云)
C. Craft 澄清后生成工程与测试,用 diff 审阅并接受需要的改动。(腾讯云)
D. 配置 EdgeOne Pages MCP,在 Craft 里“部署当前构建”。拿到公开 URL。(博客园)
E. 若要团队复用,去企业后台把这套能力封成“活动页生成与部署 Agent”。(cloud.tencent.com.cn)

七、易错点与对策
— 只给“目标”,不说“约束” → 结果常跑偏:在首次提示明确技术栈、目录规范、验收标准。(腾讯云)
— 只跑 Ask,不用 Craft → 只能问答,难以多文件协同:记得切 Craft 才有计划/批量改写/diff 审阅。(腾讯云)
— 生成后直接落盘 → 漏审造成回滚:务必在 diff 里逐条“接受/拒绝”。(腾讯云)
— 忘了工具接入 → “写完还得人手干”:尽早配置 MCP,把部署/取数/扫描串起来。(腾讯云)

八、延伸:官方资源一览
CodeBuddy 官网与产品概述(功能/模型/支持 IDE/文档索引)→ 入门与操作指南、Craft 使用页、MCP Server 指引、自定义智能体文档,均可在腾讯云文档中心找到。(copilot.tencent.com腾讯云)

这样走一遍,你就完成了从“装好插件”到“可部署的智能体工作流”的闭环:Craft 负责“理解—计划—生成—改写—审阅”,MCP 负责“把手伸向真实世界”,企业“自定义智能体”沉淀团队经验,最后你的 Agent 才不止会“写”,更会“做”。

如果你给我具体目标(比如“做个报名小程序”“把旧系统重构为 Spring Boot 3 并补齐测试”),我可以按这条流程,帮你把提示词模板、上下文清单、MCP 清单一起拟出来,直接可用。

合十,如夜话,至此。