← 返回教程目录

讯飞星辰

一句话简介:科大讯飞开源(Apache 2.0)。

主流功能:语音多模态 Agent、教育/医疗/政务/客服垂直场景

可用性:国内可直接使用——云服务官网可直接注册免费体验;开源版 GitHub 仓库国内可正常访问,按 README 用 Docker 本地部署。

适用人群:想零代码/低代码搭建智能体的个人与业务人员;企业 IT 与开发者;教育、医疗、政务等垂直行业的信息化团队

前置条件:

  • 云服务路线:手机号注册讯飞账号即可
  • 开源部署路线:一台服务器(Linux 推荐)、已安装 Docker 与 Docker Compose
  • 费用:云服务提供免费体验额度

分步骤教程

路线 A:云服务——1 分钟创建第一个智能体(零代码)

步骤 1:注册登录

  1. 浏览器打开 https://agent.xfyun.cn
  2. 用手机号注册/登录讯飞账号,进入「个人空间」

步骤 2:选择创建方式

点击左上角「创建」,两种模式二选一:

  • 提示词创建:对话式生成,适合新手与简单对话/文字处理场景
  • 工作流创建:拖拽节点编排复杂业务流程,适合流程固定、逻辑复杂的场景

新手建议先用「提示词创建」练手。

步骤 3:写提示词并生成

  1. 用自然语言描述智能体的角色、技能和语气,例如:「你是公众号爆款标题打造助手,请根据用户发送的内容,起 5 个爆款标题,并给出每个标题的推荐值和理由(满分 100 分)。创作经验:1. 情感强烈,制造冲突和悬念;2. 突出"新""快""独家"……」
  2. 点击「立即创建」,平台会自动填写智能体基本信息并优化提示词
  3. 不满意可手动修改图标、提示词,或用 AI 优化

步骤 4:高阶配置

  1. 能力开关:按需开启/关闭 AI 画图、代码生成等能力
  2. 知识库:如需私有数据问答,先创建知识库并上传文档,再绑定到智能体
  3. 对话增强:设置开场白、输入示例、角色声音、多轮对话、背景图等
  4. 左下角可切换底层大模型

步骤 5:调试预览

在右侧「调试预览」框发送测试内容,检查回答是否符合预期,不符合就回头调整提示词或配置。

步骤 6:发布上线

调试通过后可选择发布方式:

  • 发布到讯飞星火 / 讯飞星辰 Agent 平台(审核通过后他人可体验)
  • 发布为 API,供自己的应用调用
  • 发布为飞书机器人,在飞书中使用

路线 B:开源版本地部署(Docker Compose,官方推荐)

步骤 1:克隆仓库

git clone https://github.com/iflytek/astron-agent.git
cd astron-agent/docker/astronAgent

步骤 2:配置环境变量

cp .env.example .env
vim .env   # 按仓库 docs/DEPLOYMENT_GUIDE_WITH_AUTH_zh.md 填写关键配置

步骤 3:启动服务

docker compose -f docker-compose-with-auth.yaml up -d

步骤 4:访问平台

步骤 5:添加大模型

  1. 登录后点击左侧「模型管理」→ 右上角「新建模型」
  2. 平台支持任何兼容 OpenAI 接口的模型;如用讯飞星火大模型,先去讯飞星辰 MaaS 平台申请免费额度,再把 API 地址与 Key 填入对话框提交

步骤 6:用工作流搭建应用(零代码示例)

  1. 点击左上角「创建」→ 选择「工作流创建」→ 进入工作流编排界面
  2. 按业务逻辑拖拽节点并连线,如「分支器」「文本处理」「OCR 工具」「大模型」等(以「AI 简历优化大师」为例:PDF 上传 → OCR 解析 → 大模型打分/分析 → 输出优化建议)
  3. 点击编排面板右上角「调试」,上传测试文件验证效果
  4. 也支持「导入工作流」直接复用他人编排好的流程文件

企业 Kubernetes 环境可改用 Helm 部署:cd astron-agent/helm/astron-agent,编辑 values.yaml(镜像版本、域名、Ingress),执行 helm install astron-agent . -n astron-agent --create-namespace。详见仓库 helm/README.md。

常见问题

  1. 模型添加后调用失败? 检查 API Base URL、Key 是否正确,网络能否连通模型服务;讯飞星火模型需先在星辰 MaaS 平台申请额度并完成实名。
  2. Docker 启动后打不开页面? 用 docker compose ps 检查容器状态,查看日志定位端口冲突或环境变量缺失;确认 .env 已按部署指南填写。
  3. Helm 部署注意事项? 需提前准备 K8s 集群、ingress-nginx 与 Helm 3,并在 values.yaml 中把 hostBaseAddress 与 Ingress 域名改为自己的真实域名。
  4. 智能体回答不准? 优先优化提示词(角色、约束、示例越具体越好);知识问答场景务必绑定知识库并检查文档切分质量。
  5. 发布为 API/飞书机器人后怎么调用? 在「我的智能体」详情页查看 API 文档与凭证,按接口说明在业务系统中调用;飞书机器人需在飞书开放平台完成应用配置后绑定。