相关方案
      社区内容

        # FAQ

        # 1. 平台咨询

        1.套餐费用咨询：星辰 Agent 开发平台怎么升级以及如何收费？

        答：点击平台主页左下角个人昵称头像旁【升级】按钮，在弹出的页面中可以查看不同套餐的收费标准。

        2.发布审核咨询：智能体发布后，一般多长时间完成审核？

        答：一般一个工作日内完成审核，如果紧急情况可在【讯飞星辰交流群】内@管理员优先审核

        3.智能体调用咨询：星辰 Agent 智能体能否像星火大模型一样直接调用？

        答：可以，智能体发布成 API 后可直接调用。

        4.账号咨询：一个账号最多支持创建多少个智能体？

        答：100 个。

        5.星辰 Agent 开发平台支持本地化部署吗？

        答：支持，可以联系平台人员了解详情。

        6.如何查看自己的智能体还剩多少 Tokens？

        答：点击平台主页左下角个人昵称头像旁符号，选择【订单管理】，可查看剩余 Tokens。

        7.星辰 Agent 平台支持多智能体协同吗？

        答：目前工作流智能体中支持嵌套另外一个工作流智能体，使用【工作流节点】。

        8.讯飞星辰 Agent 开发平台智能体可以快速通过 js 嵌入集成到小程序或者其他系统中么？

        答：可以，当前平台支持发布成 API，通过 API 集成调用。除此之外，智能体还支持发布渠道：发布至讯飞星火、讯飞星辰 Agent 平台，发布平台配置微信公众号(服务号)，发布为 MCP Server。

        9.本文档中未涉及的问题应该反馈给谁？

        答：可扫描下方二维码加入问题交流群反馈，群内有技术人员实时解答。

        # 2. 工作流智能体常见问题

        # 2.1 模板常见问题

        1.平台是否有相关工作流模板，比如客服场景？

        答：有的，除此之外平台还提供其他丰富的工作流场景模板，具体进入页面：平台主页-->我的智能体-->新建智能体-->工作流创建-->多个模板供选择。

        2.工作流模板是否有接口可直接调用？

        答：使用模板建同款，可自行发布成 API，通过 API 可调用。

        3.以 API 接入其他平台的智能体使用量会计入智能体热度值吗？

        答：不会。

        # 2.2 大模型节点常见问题

        1.大模型节点输出结果不符合预期怎么办？或者如何让大模型以特定的模板和格式输出？

        答：这类问题主要是提示词的问题，可以优化提示词，比如在提示词里给他一个输出样例，让大模型严格按照样例输出结果。

        2.模型会记得上下文对话吗？在调试界面该如何让对话历史工作？

        答：大模型节点中勾选对话历史即可，可设置对话轮数。

        3.大模型节点里勾选对话历史，但实际未生效，运行结果中输入没有带 chat history 字段是怎么回事？

        答：这类情况，很大可能是模型参数限制了输入字符，并且轮数设置太多和内容太多都有可能出现这种情况。通常可以把模型的最大回复长度调大，并且把对话轮数调小一点。

        4.智能体发布成 API 后调用时，如何关联历史会话？

        答：请参考文档https://www.xfyun.cn/doc/spark/Agent04-API%E6%8E%A5%E5%85%A5.html#_4-3-%E8%AF%B7%E6%B1%82 4.3 节设置.

        5.大模型的系统提示词跟用户提示词有什么区别？

        答：系统提示词是预设的全局指令，用于定义模型的行为框架、角色身份、能力边界和输出风格。

        用户提示词是一版指具体提出的任务，有明确的场景。

        6.大模型节点的模型是否支持联网检索？

        答：不支持，如果想联网搜索可以加一个工具节点选择【联网搜索】工具。

        7.模型选择中，如何添加更多模型？

        答：选择更多模型时会跳转到星辰 maas 微调平台，需要在该平台选择合适模型，发布成功后即可在星辰 Agent 平台中的相关模型节点选择自己的模型。

        8.目前 WorkFlow 上提供的这些大模型，哪些是支持微调的？

        答：目前仅 Spark Max、xgemma29b、qwen2.5-7b、 spark liteinstruct、spark lite、spark lite instruct、qwen2.5-3b 这几个模型支持微调。

        # 2.3 Agent 决策节点常见问题

        1.Agent 智能决策节点如何调用插件？

        答：

        • 首先要保证智能决策节点添加了相关插件，决策节点可以根据用户诉求，自主思考规划去调用添加的插件。

        • 用户也可明确在提示词里告诉 Agent 决策节点在什么条件下去调用某个插件。

          2.当 Agent 智能决策节点运行报超时错误怎么办？

        答：当前网关超过 2 分钟没有返回就会断开链接，报超时错误，可以尝试用消息节点去把思考过程流式输出解决，注意需要打开【流式输出】开关。

        3.Agent 决策节点失败（模型返回的推理内容格式不正确，无效的插件参数）怎么办？

        答：用户请检查大模型输出的内容是否合理正确（比如 json 内容有异常字符），并确定 Agent 决策节点是否添加了相关的插件。

        4.Agent 节点执行失败（模型返回的推理内容格式不正确，无效的推理格式，缺少必要的标识字段...怎么办？

        答：模型效果问题，或者提示词写的不对。建议：换个模型，或者优化下提示词。

        # 2.4 工作流节点常见问题

        1.工作流的每个节点是否可以添加说明，方便他人理解用户意图？

        答：每个节点都可以支持重命名，可起到说明作用，节点最上方可修改。

        2.工作流调试结束节点报异常：“节点校验失败，请检查是否有空值或不满足命名规则”怎么办？

        答：检查画布，是否有相关参数缺失或不正确。

        # 2.5 代码节点常见问题

        1.代码节点报错 500 是什么问题？

        答：代码节点中 main 的输入、输出要和节点对应的输入、输出配置对应上，需要自检一下。

        2.代码节点请求网络无输出结果怎么办？想要请求网络怎么办？

        答：代码节点不支持网络请求，想要请求网络可以去【首页-资源管理-新建插件】去访问。

        # 2.6 迭代节点常见问题

        1.为什么工作流没有报错，且都正常运行了，但是某一个节点没有正常输出？比如迭代节点没有正确输出？

        答：可检查运行结果，查看该节点的输入是否有问题，保证正确的输入才能又相关的输出。

        # 2.7 问答节点常见问题

        1.问答节点在 API 调用时，可以对对话进行超时限制嘛，比如需要在一定时间内回答，否则就会失效？

        答：有，可在【问答节点】中回答模式设置，对话超时设置。

        # 2.8 变量存储器节点常见问题

        1.如何设置全局变量？变量存储器怎么获取变量？

        答：可以通过变量存储器节点，【设置变量值】，用于长期保存数据。想用该变量时，需再次添加变量存储器节点选择【获取变量值】，可参考本手册中"开发指南-工作流智能体开发-节点介绍-转换节点-变量存储器"章节中变量存储器的使用方法。

        # 3. 提示词智能体常见问题

        1.智能体在编辑提示词中，“助手参数过长”指的是什么？

        答：当前支持的提示词字数上限为 2000，您可以适当精简提示词字数。

        2.提示词智能体能发布成 API 调用吗？

        答：可以，进入发布管理，选择对应的智能体点击发布，弹框后可发布成 API。

        # 4. 插件、知识库常见问题

        # 4.1 插件相关资讯

        1.托管 MCP 本地和云端有什么区别？

        答：本地只是作信息展示，不会把服务跑起来，要在本地安装才能使用。云端就是服务器在云端，可以直接使用。

        2.自定义插件接口调试时报 IP 地址在黑名单内怎么办？

        答：检查 IP 是不是内网地址，目前仅支持公网地址。

        3.星辰 Agent 智能支持 mcp 吗，如何添加？

        答：支持，进入工作流智能体编排页面，左侧选择【Agent 智能决策】节点，可选择添加插件

        4.讯飞 Agent 平台的 OCR 工具单词上限能读几页？响应时间为什么超时？

        答：单独调用工具时，大概 45 页左右，超时主要和页数过多有关，以及跟每一页的内容复杂度也有关。

        # 4.2 知识库相关咨询

        1.知识库构建成功后，多长时间可以调用里面的相关内容？

        答：即刻生效。

        2.在个人空间上传的知识库文件，怎么在智能体中采集相关信息？

        答：点击【我的智能体】-【新建智能体】，工作流智能体中可以添加【知识库节点】选择想要引用的知识库文件即可采集调用。

        # 5. 发布管理常见问题

        # 5.1 管理咨询

        1.如何查 trace 日志对话记录，入口在哪？

        答：登陆星辰 Agent 开发平台-->左侧菜单栏:【发布管理】-->选择自己的工作流智能体:【详情】-->单击【Trace 日志】，即可查看相关日志数据情况。

        2.星辰 Agent 个人专业版，能保留所有用户对话吗，在不发布的情况下通过链接分享，也能保留 15 天对话吗？

        答：可以。

        3.在哪里查看发布在平台内的智能体的使用情况？

        答：在首页点击侧边栏【发布管理】，选自己发布成功后的智能体，点击【查看】按钮。

        4.为什么智能体上架后搜索不到？

        答：请在发布管理中，检查该智能体的上架状态。一般情况下，如果上架后搜不到，原因为要么审核失败，要么没有成功上架。

        # 5.2 发布 API 咨询

        1.星辰 Agent 智能体有 Java 的 SDK 吗？

        答：支持 api 调用，有 Java 的 demo 参考。

        2.API 调用时，报错【授权错误，并发超过授权路数限制】怎么办？

        答：首先检查自己的 API 调用时的 appid 是否跟智能体发布绑定的 appid 一致，如果不一致，需保持一致；如果一致还提示报错，去订单管理检查免费资源是否足够。如果不够，需要申请授权，增加并发，可以按需升级套餐。

        3.如何查看 APPID 的密钥信息？

        答:智能体发布成 API 时，需要绑定对应的 APPID，此时可以查看密钥信息。

        或进入开放平台控制台直接查看：https://console.xfyun.cn/services/sparkapiCenter

        4.API 调用时如何获取图片上传的地址？

        答：参考 API 接入-文件上传：https://www.xfyun.cn/doc/spark/Agent04-API%E6%8E%A5%E5%85%A5.html#_4-3-%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0

        5.为什么在开始节点增加了一个输入参数，在使用 API 调用时报输入参数不存在？

        答：

        • 请检查 API 调用时传入的 flowid，apikey 和 apisecret 是否正确。
        • 请检查修改后的工作流是否更新发布，如果不发布，则线上的协议依旧是老协议。
        • 请检查请求协议中的输入参数是否写在 parameters 参数下，格式是否和"{"AGENT_USER_INPUT": question,'xxxx':'yyyy'}"相同
        • 如果以上均无问题，则请联系技术支持人员协助处理。
        在这篇文章中：
        在线咨询
        体验中心