扣子智能体开发-准备开发环境

30 阅读6分钟

步骤1:注册账号

访问扣子平台

扣子官网:https://www.coze.cn

这是官方唯一的注册入口,请确保访问正确的地址。

注册流程

注册选项对比

注册方式优点缺点推荐场景
手机号注册验证快捷,后续找回方便需要手机验证国内用户首选
邮箱注册邮箱作为主要联系方式验证流程稍长国外用户或习惯邮箱的用户

账号设置

注册完成后,建议完善以下信息:

yaml

个人信息:
  昵称: 设置一个易记的昵称
  头像: 上传个人头像
  简介: 简短描述你的开发方向

账号安全:
  绑定手机: 增加账号安全性
  绑定邮箱: 用于接收重要通知
  开启二次验证: 保护账号安全

开发配置:
  选择平台: 国内版/国际版
  设置默认语言: 中文/英文
  配置通知偏好: 接收更新和通知

步骤2:熟悉界面

工作台布局

扣子工作台采用现代化的三栏布局设计:

plaintext

┌─────────────────────────────────────────────────────────┐
│                    顶部导航栏                            │
│  ┌───┐  ┌─────┐  ┌─────┐  ┌─────┐  ┌─────┐  ┌──────┐ │
│  │Logo│  │智能体│  │插件  │  │知识库│  │团队  │  │设置 │ │
│  └───┘  └─────┘  └─────┘  └─────┘  └─────┘  └──────┘ │
├────────┬────────────────────────────────────────────────┤
│        │                                                │
│ 左侧   │              主工作区                           │
│ 侧边栏 │                                                │
│        │  ┌────────────────────────────────────────┐   │
│ ┌────┐ │  │                                        │   │
│ │创建 │ │  │          配置编辑区                   │   │
│ ├────┤ │  │                                        │   │
│ │智能体│ │  │  - 人设与提示词                     │   │
│ │  🤖 │ │  │  - 工具与插件                       │   │
│ ├────┤ │  │  - 知识库设置                       │   │
│ │插件  │ │  │  - 工作流编排                       │   │
│ │  🔌 │ │  │  - 记忆配置                         │   │
│ ├────┤ │  │                                        │   │
│ │知识库│ │  └────────────────────────────────────────┘   │
│ │  📚 │ │                                                │
│ ├────┤ │  ┌────────────────────────────────────────┐   │
│ │团队  │ │  │          调试预览区                   │   │
│ │  👥 │ │  │                                        │   │
│ └────┘ │  │  ┌────────────┐  ┌─────────────┐      │   │
│        │  │  │  对话窗口  │  │  日志输出   │      │   │
│        │  │  │            │  │             │      │   │
│        │  │  └────────────┘  └─────────────┘      │   │
│        │  │                                        │   │
│        │  └────────────────────────────────────────┘   │
│        │                                                │
└────────┴────────────────────────────────────────────────┘

主要区域功能说明

顶部导航栏

功能图标作用
Logo🤖返回首页
智能体-查看和管理所有智能体
插件🔌浏览和管理插件库
知识库📚管理文档和知识库
团队👥团队协作和成员管理
设置⚙️账号和应用设置

左侧侧边栏

功能说明
创建快速创建新智能体、插件或知识库
智能体列表显示所有已创建的智能体,支持搜索和筛选
插件列表显示可用的插件和自定义插件
知识库列表管理所有知识库资源
团队空间团队项目和协作空间

主工作区

分为两个主要部分:

配置编辑区

  • 人设与回复逻辑
  • 工具与插件配置
  • 知识库关联
  • 工作流设计
  • 记忆设置

调试预览区

  • 实时对话测试
  • 工具调用日志
  • 性能监控
  • 错误信息显示

界面个性化设置

你可以根据使用习惯调整界面:

yaml

主题设置:
  主题模式: 浅色/深色/自动切换
  强调色: 蓝色/绿色/紫色/橙色

布局调整:
  侧边栏宽度: 可拖动调整
  调试区位置: 右侧/底部
  字体大小: 小/中/大

显示选项:
  显示代码行号: 是/否
  显示工具提示: 是/否
  快捷键提示: 是/否

步骤3:创建工作空间

工作空间概念

工作空间是你的开发环境,包含智能体、插件、知识库等所有资源。一个账号可以创建多个工作空间。

创建智能体

点击"创建"按钮,选择"创建智能体":

基本信息配置表

填写以下信息创建你的第一个智能体:

配置项说明示例必填
名称智能体的显示名称天气助手
描述简要描述智能体的功能为用户提供天气查询服务
图标智能体的图标☀️ 选择或上传
主题色主题颜色#3B82F6 蓝色
分类智能体所属分类生活服务
可见性谁可以访问公开/私密

智能体类型选择

扣子提供了多种智能体模板:

类型适用场景特点
聊天助手日常对话、问答交流灵活对话、多轮交互
内容创作文章生成、文案写作创意输出、风格多样
客服机器人客户服务、问题解答知识库驱动、标准化回复
数据分析数据查询、报表生成数据处理、图表展示
任务助手流程管理、任务分配工作流编排、自动化

完成创建

配置完成后,点击"创建"按钮:

markdown

✅ 创建成功!

你的智能体已创建完成,现在可以:

1. 配置人设和提示词
   - 在"人设与回复逻辑"中输入
   - 定义智能体的性格和能力

2. 添加工具和插件
   - 在"插件"区域搜索和添加
   - 扩展智能体的能力

3. 关联知识库
   - 上传文档资料
   - 增强专业性回答

4. 测试智能体
   - 使用右侧调试窗口
   - 验证功能是否正常

开发环境检查清单

在开始开发前,确保以下准备工作已完成:

账号与环境

  • 扣子账号已注册并登录
  • 账号信息已完善(头像、昵称等)
  • 已熟悉工作台界面布局
  • 已创建工作空间或智能体

浏览器要求

浏览器最低版本推荐版本
Chrome90+最新稳定版
Edge90+最新稳定版
Firefox88+最新稳定版
Safari14+最新稳定版

💡 提示:推荐使用 Chrome 浏览器以获得最佳体验。

网络环境

yaml

网络要求:
  带宽: 建议 10Mbps 以上
  延迟: 建议 < 100ms
  稳定性: 稳定连接

防火墙设置:
  确保可以访问: *.coze.cn
  端口: 443 (HTTPS)

功能权限

确保你的账号具有以下权限:

权限项说明检查方法
创建智能体可以创建新的智能体查看"创建"按钮是否可用
使用插件可以添加和使用插件查看"插件"页面
创建知识库可以上传和管理文档查看"知识库"页面
发布应用可以发布到平台查看"发布"选项

常见问题

Q: 注册后无法登录怎么办?

A: 检查以下几点:

  1. 确认用户名和密码输入正确
  2. 检查键盘大小写锁定
  3. 尝试使用"忘记密码"功能重置
  4. 清除浏览器缓存后重试
  5. 联系客服支持

Q: 界面显示异常怎么办?

A: 尝试以下解决方案:

bash

1. 清除浏览器缓存和Cookie
2. 禁用浏览器插件
3. 尝试使用其他浏览器
4. 检查网络连接
5. 更新浏览器到最新版本

Q: 如何切换语言?

A:

  1. 点击右上角用户头像
  2. 选择"设置"
  3. 在"语言"选项中选择目标语言
  4. 保存设置后刷新页面

Q: 创建的智能体可以修改吗?

A: 可以。智能体的所有配置都可以随时修改:

yaml

可修改内容:
  基本信息: 名称、描述、图标
  人设配置: 提示词、回复风格
  工具配置: 添加/删除插件
  知识库: 上传/删除文档
  工作流: 调整流程节点

注意:
  修改后记得保存
  重要修改建议先测试
  考虑版本管理

Q: 如何删除智能体?

A:

⚠️ 警告:删除操作不可恢复,请谨慎操作。

下一步

开发环境准备完成后,让我们创建你的第一个智能体!

➡️ 继续:1.3 创建你的第一个智能体