Coze智能体搭建

这种工具提供全栈式的 AI 编程体验——简单的对话就能开发全代码的 AI 智能体项目，从创意构思到产品落地全包，让开发者专注核心创意和价值设计。

功能概述

智能体是基于对话的 AI 项目，它通过对话方式接收用户的输入，由大模型自动加载技能，执行用户指定的业务流程，并生成最终的回复。智能体的典型场景包括智能客服、虚拟伴侣、个人助理、英语外教等。

这个平台是 Web 版的 AI 编程开发环境，只需要用自然语言描述智能体创意，AI 助手会自动完成智能体的开发、测试、迭代和发布，让你高效实现从创意到产品。

💡 说明：:::tip 说明

费用说明

开发、测试、部署、线上跑智能体时，下面这些操作都要扣你的扣子积分。

• 编程任务：跟 AI 助手的每轮对话。

• 内置集成：调用大语言模型、联网搜索、图像生成等内置集成服务。

• 服务托管费用：部署为线上服务，将产生服务托管费。

配额与限制

开发智能体时，存在可创建的项目数量、可回滚版本数、可部署的次数等配额限制，详细说明，请参考配额与限制。

开发智能体

参考以下流程，通过自然语言开发智能体。

第一步：把需求说给 AI 听

1. 在扣子编程首页，单击智能体选项卡。
2. 在输入框里写你的提示词。

尽量把智能体功能、业务逻辑、约束都说清楚。下面是个提示词例子：

   帮我开发一个全平台爆款种草文案策划的Agent，核心功能是基于用户输入的产品名称，自动生成符合“小红书”或“抖音”平台调性的高质量种草文案。Agent需要具备极强的“网感”，能够熟练使用Emoji表情，并提供不同营销角度的文案方案。
   核心工作逻辑
   接收输入数据：包括产品名称。
   风格迁移与润色：
   若为小红书：采用“集美/姐妹”口吻，标题必须包含吸引眼球的关键词（如“绝绝子”、“按头安利”、“无限回购”），正文大量使用Emoji（✨💖🔥），注重分段和视觉舒适度，文末包含相关话题标签。
   若为抖音：采用短视频脚本格式，注重开头的“黄金3秒”完播率设计，语言犀利、节奏快，突出反转或强情绪引导。
   多方案生成：针对同一个产品，必须输出3套不同侧重点的文案（例如：痛点直击型、情感共鸣型、性价比分析型），供用户选择。

   约束
   拒绝AI味：生成的文案严禁出现“综上所述”、“总而言之”、“这款产品具有...”等生硬的机器翻译腔调，必须口语化、生活化。
   Emoji浓度：小红书风格文案中，Emoji的占比需适中，每段话至少包含1-2个表情符号。
   长度限制：小红书正文控制在200-400字之间；抖音脚本时长控制在45秒口播以内。

2. （可选）进阶配置：传附件、选协作模式、加技能、换模型，让生成的结果更准、更合你要的。

【① 上传附件】

酌情传点图片或文件给 AI 看。比如上传你想参考的实现方案，让 AI 更懂你。

【② 选择协作模式】

默认是 Agent 模式。需求没想清楚？先切到问答模式聊方案，确认后再切回 Agent 模式让 AI 助手去执行开发任务。怎么选看协作模式文档。

【③ 调用技能】

系统支持加载编程技能（Skill），执行任务时按需加载，让 AI 助手有对应领域的专业知识。比如前端设计技能能让它做 UI 时更懂排版、配色、动效、背景处理，生成的页面少点 AI 味。

AI 编程项目里能用的技能分两类：

官方技能：平台自带的集成服务，一键集成图片生成、视频生成这类能力。

我的技能：你自己上传的。可以是平台提供的技能包，也可以是外部开源的。怎么做、怎么传看开发技能、使用技能文档。

【④ 选择编程模型】

工具接了豆包、GLM、Kimi、DeepSeek 这些主流编程模型。系统会按场景自动选，你也可以看官方介绍自己挑。

1. 单击提交按钮。

扣子 AI 会根据你输入的提示词来开始设计智能体、创建项目，并自动为项目设置智能体名称。过程预计需要几分钟，请耐心等待。

你可以在左侧实时查看 AI 助手开发智能体的步骤和详细进展。智能体开发完毕后，可以看 开发完成总结，查看智能体的主要功能、项目文件路径等信息。

第二步：预览与测试

智能体生成完毕后，系统会自动写测试用例跑一轮单元测试。测试通过后会提供预览页面，右侧 预览 窗口跟智能体对话，就能测试表现是否符合预期。

改改还能更好

测试修复完之后，智能体还能继续优化——通过自然语言跟 AI 助手迭代就行。

需求要调整

之前对话里说得不准？直接在对话记录里找到那条历史消息，改完敲回车，AI 助手会根据新描述调整和优化智能体。版本记录里也会另起一个分支记这次的变更——比回滚版本再重新生成效率高。

你可以在对话记录中找到该历史消息，对其进行修改后敲击回车，扣子 AI 会根据新的描述对应用进行调整和优化。

怎么改智能体

跟 AI 助手一起持续优化，直到达到预期效果。可以这样改：

【自然语言】

在智能体开发页面左侧的对话框里，描述你要优化的方面和期望达到的效果，AI 助手会自动迭代。

示例指令：

智能体的输出文案需要为纯净的JSON格式，不包含多余的解释性文字。
输出格式
JSON
{
 "product_name": "{{product_name}}",
 "platform": "{{platform}}",
 "plans": [
 {
 "angle": "<文案切入角度，如：痛点直击型>",
 "title": "<生成的爆款标题，含表情>",
 "content": "<生成的正文内容，含表情和排版>",
 "tags": ["<话题标签1>", "<话题标签2>"]
 },
 {
 "angle": "<文案切入角度，如：情感共鸣型>",
 "title": "<生成的爆款标题，含表情>",
 "content": "<生成的正文内容，含表情和排版>",
 "tags": ["<话题标签1>", "<话题标签2>"]
 },
 {
 "angle": "<文案切入角度，如：干货测评型>",
 "title": "<生成的爆款标题，含表情>",
 "content": "<生成的正文内容，含表情和排版>",
 "tags": ["<话题标签1>", "<话题标签2>"]
 }
 ]
}

【修改系统提示词】

你可以通过修改智能体的系统提示词精准调整其行为。

1. 编辑提示词。在智能体搭建页面的预览窗口，单击模型名称，在右侧弹出的窗口中，在系统 Prompt 文本框中，你可以查看智能体当前的提示词，并根据需要修改提示词。

1. 验证修改效果。修改提示词后，重新在预览窗口与智能体对话，可以验证修改后的提示词是否使智能体的回复符合预期，若仍不符合可再次调整提示词。

选择模型并设置模型参数

可以为智能体选择不同的大模型，并对其进行精细化参数设置（生成随机性、Top P、最大回复长度等）。各模型支持调整的参数不同，具体以界面为准。

💡 说明：模型默认不开启前缀缓存，你可以通过对话方式让扣子 AI 开启此功能（如为智能体开启前缀缓存），以加快模型响应速度并降低使用成本。计费详情请参考内置集成费用，操作步骤请参考开启缓存。

1. 在智能体开发页面的预览窗口，单击智能体当前使用的模型。
2. 在右侧弹出的 Agent 节点窗口中，选择要切换的模型。

1. 单击设置图标，设置模型参数，详细参数说明可参考配置大语言模型参数。

改坏了？回滚一下

AI 写代码偶尔会跑偏，反复修也修不好——生成了不符合预期的代码，或者反复修复失败。这时用回滚版本功能，把智能体恢复到之前正常的版本。

在智能体开发页面单击版本历史图标，在目标版本右侧单击回滚图标，就能把智能体回滚到那个版本。回滚后系统会自动生成一个新的部署版本，原始历史记录不会被改或删。

集成能力

平台把常用的集成能力接口用"技能"打包好了——数据库、存储、AI 这些都能快速接入，让智能体满足更多业务需求。

在跟 AI 助手说"加这个能力"之前，先在对话区点 技能，确认它已经加上了。

存数据：对象存储和数据库

平台提供了结构化、非结构化数据托管方案。要持久化存储、查询、更新用户记录或业务数据、历史交互结果的，集成数据库；要存图片、文档、音频、视频文件的，集成对象存储。详细看集成数据库能力和集成对象存储能力文档。

比如开发一个英语单词学习智能体，给它加一个数据库存已学单词、学习时间、掌握状态、错误记录，让智能体能根据历史数据生成个性化复习计划。开发中系统按提示词加载数据库技能来接入数据库集成服务。

── 第 1 部分 ──

── 第 2 部分 ──

飞书消息、外部服务也能接

平台提供了丰富的外部集成服务：飞书消息、飞书多维表格、微信、火山方舟都支持。使用前需要由空间管理员在工作空间中配置外部集成。配置完成后开发智能体时，系统会基于当前的开发场景与功能需求，自动识别并加载对应的技能来接入外部集成服务。

例如，你需要实现将智能体生成的内容发送飞书消息，实现方法如下：

1. 在平台的 集成服务 中配置相应的外部集成，比如集成飞书消息。具体操作看发送飞书机器人消息文档。
2. 在对话框中，通过自然语言描述需要接入的外部集成，例如：

   智能体完成任务后，自动向指定飞书群推送结果通知

开发过程中 AI 助手会加载飞书消息技能来给智能体接入飞书消息集成服务。

后续操作

部署上线

把平台上开发的智能体快速部署成可访问的 API 服务，后续通过 OpenAPI 把智能体的 AI 功能集成到你的应用里。详细看部署智能体文档。

分享给别人

在智能体开发页面右上角点 分享，就能把部署成功的项目分享给别人。

查线上日志

看已发布的智能体后端运行日志，出问题好排查分析。详细看查看日志和 Trace 文档。

常踩的坑

• 工作空间中的成员为什么无法编辑项目？
• 如何查看智能体使用的模型？
• 如何切换大语言模型？