终极虚拟显示器解决方案：Parsec VDD深度实战指南
2026/7/25 11:26:59
《扣子编程从一句话到产品上线：零门槛AI心流开发》全书案例分享~-CSDN博客
1.3.1 智能体开发
扣子编程平台的核心价值，就是降低智能体的开发门槛。它提供了一个基于 Web 的 AI 编程开发环境，你只需要通过自然语言描述智能体创意，扣子 AI 会自动完成智能体的开发、测试、迭代和发布，帮助开发者聚焦核心创意与价值设计，高效实现从创意构思到产品落地。
登录扣子编程平台https://code.coze.cn/home，如图1-7所示，输入提示词：帮我做一个天气查询的智能体，支持用户输入任意国内城市名称，获取实时天气数据，能够使用多维度数据展示：返回温度、体感温度、天气状况（晴／雨／阴等）、湿度、风力风向、空气质量；具有短期预报功能能展示未来3天天气变化趋势；支持口语化提问，如“北京今天天气怎么样”“上海未来三天会下雨吗”。
图1-7 使用扣子编程开发智能体
点击提交按钮（右下角向上箭头的按钮）后，进入如图1-8所示的交互式开发与预览页面，页面左侧会实时显示AI编程智能体处理用户开发任务的思考过程和编程开发过程。整个过程无需人工干预，只需几分钟时间就能完成。
图1-8 智能体交互式开发与预览界面
开发完成后，右侧预览区域会自动变成Agent效果测试界面，如图1-9所示。从该页面上方可以看到智能体已经接入了两个工具，并且默认使用大模型doubao-seed-2.0-lite。
图1-9 Agent效果测试页面
点击模型名称，右侧会弹出如图1-10所示的“agent”节点配置面板，可以看到工具列表，你可以选择模型，可以修改系统提示词
图1-10 Agent节点
如果不需要修改，就直接在对话框输入提示词，“今天福州的天气如何？”然后智能体会出现回复，如图1-11所示。可以看出天气查询智能体给出预期一致的详细答复。
图1-11 测试天气查询智能体
整个天气查询智能体的开发就完成了，整个开发过程非常便捷，就只需布置任务给扣子编程平台，告诉你想要做什么，它就能自动完成从设计到开发的全部流程。扣子编程就是一个 AI 驱动的应用开发平台，就是让AI去做应用开发，你用聊天的方式指挥它就行。
1.3.2 智能体部署
部署智能体就是将你在扣子编程上开发的智能体，快速部署成为全天候在线的正式服务，以便后续可以将智能体的 AI 功能集成到你的应用中。
根据使用需求分成两种部署方案：做成 API 接口部署、网页交互 Web SDK 部署，如图1-12所示。这里需要单独开启Web SDK 渠道，这个功能不会跟着 API 部署自动打开。API 部署的核心目的是把咱们做好的智能体，打包成一串网络接口地址，别的软件、小程序、后台系统，通过代码发请求就能调用智能体的能力。你在扣子做的智能体藏在平台里面，只有在扣子网页上能聊天；开启 API 部署之后，智能体变成一个“远程功能接口”。不管是自己写的手机 APP、电脑软件、网站后台，只要带上密钥、按照平台给的接口格式发消息，就能远程唤起智能体、收发对话。举个例子：你做了天气智能体，部署 API 后，自己开发的小程序不用再对接天气接口，直接调用扣子 API，用户在小程序查询“查福州天气”，小程序把这句话传给扣子接口，智能体运算完把天气数据原路传回小程序展示。
图1-12 部署渠道
如果不想用代码对接程序，只想把智能体安在自己的官网、静态网页里，让访客点开网页就能和 AI 对话，就要单独开启Web SDK 渠道。WebSDK 就是扣子打包好的一段网页代码，开启渠道后平台生成嵌入代码。你把这段几十行的代码粘贴到自己网站源码里，网页侧边、页面内就会弹出智能体聊天窗口。访客不用跳转扣子平台，在你的网站页面里就能直接提问、和智能体聊天。举例子公司官网右下角悬浮一个天气助手图标，点开弹窗就能查全国天气，就是 WebSDK 部署实现的效果。
点击部署后，会出现“开始部署你的项目吧”对话框，点击“开始部署”按钮，如图1-13所示。扣子编程将自动进行部署相关操作。你可以在部署页面查看部署的进展和部署日志。部署过程可能需要几分钟。
图1-13 开始部署项目
部署成功，如图1-14所示，点击“Web SDK”, 你可以按需选择嵌入方式（如 JavaScript、React 组件或 Iframe），将智能体嵌入到你的网页中，记住你的projectId。
图1-14 Web SDK部署
接入 Web SDK 前，应申请获取访问令牌（Token），支持的 Token 类型有OAuth 访问令牌、个人访问令牌（PAT）和服务访问令牌（ SAT）。快速体验可使用个人访问令牌，个人访问令牌是扣子编程提供的短效令牌，用于 API 请求鉴权，可以在扣子编程中生成。如图1-15所示，在左侧导航栏选择 API & SDK，选择“授权”à个人访问令牌，然后单击右上角的“添加”按钮。
图1-15 添加访问令牌
出现“个人访问令牌”对话框，如图1-16所示，个人访问令牌的有效期时长。令牌过期后将会失效，无法继续用它来调用扣子 API。根据扣子编程的安全策略，个人访问令牌的有效期最长可设置为 30 天，不能设置为永久有效。这一限制是为了增强安全性，确保即使令牌泄露也只能在有限的时间内被滥用。过期后，你需要重新生成新的令牌以继续使用相关 API 功能。
图1-16 个人访问令牌
以下是扣子编程 Web SDK 快速接入示例，帮助你在 Web 页面可视化体验智能体。在本地新建记事本，复制以下完整代码，粘贴后保存为 demo.html，并保存至桌面。注意文件后缀必须为 .html，不可为 .txt。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>我的演示-智能体部署</title>
<style>
* { box-sizing: border-box;}
html { margin: 0; height: 100%; }
body { margin: 0; padding: 8px; height: 100%; }
</style>
</head>
<body>
<h1>天气查询智能体</h1>
<!-- 引入 Coze Web SDK 官方 CDN -->
<script src="https://lf-cdn.coze.cn/obj/unpkg/latest/coze/web-sdk/dist/js-umd/index.min.js"></script>
<script>
// 初始化 Web SDK
cozeWebSDK.init({
projectId: '你的projectId',
// 支持同步和异步刷新 token
refreshToken: () => Promise.resolve('你的Token'),
});
</script>
</body>
</html>
替换鉴权信息，包括你的projectId以及Token，即获取的个人访问令牌。双击打开 demo.html 文件，等待 1~2 秒，如图1-17所示，即可在浏览器中直观体验智能体或工作流能力在网页中的呈现效果。
图1-17 WebSDK接入示例
总之，在扣子 AI 编程开发的智能体，部署为 API 服务或 Web SDK。部署为 API 服务，让你可以通过 API 方式将智能体的 AI 功能灵活集成到应用中。部署为 Web SDK，将提供网页嵌入式聊天窗口，用户可直接在网页中与智能体进行对话。