星辰超级智能体·桌面版用户操作手册

文档定位：面向日常使用者的操作指南，覆盖90%的办公场景

目标用户：完成快速上手的新用户、日常使用者，及需自定义模型与MCP工具扩展的用户

使用方式：按需查阅，配置前必读，非通读型文档

查看快速上手指南：星辰超级智能体，桌面版AI助手，AI办公助手，智能体安装指南，Windows AI工具，Mac AI应用，企业AI助手-天翼AI开放平台-中国电信

TeleAgent信创版；TeleAgent linux版-天翼AI开放平台-中国电信

查看场景化操作指南：星辰超级智能体桌面版场景化操作指南，智能体使用技巧，任务成功率提升，文件合并，格式调整，内容润色，避坑指南-天翼AI开放平台-中国电信

版本号	更新内容	更新时间
V1.0.0	文档创建	2026.3.23
V1.0.1	文档更新	2026.4.1
V1.1.1	更新技能广场与IM使用	2026.5.7
V2.0.0	文档更新	2026.6.9
V2.0.3	文档更新	2026.7.9
V2.2.0	文档更新	2026.8.5
V2.3.0	文档更新	2026.8.17
V2.4.0	文档更新	2026.8.27
V2.5.0	文档更新	2026.9.3

遇到任何问题，欢迎通过星辰超级智能体客服渠道进行反馈

TeleAgent用户专属支持入口：

https://work.weixin.qq.com/kfid/kfc45246198813a4395

1.核心功能（日常高频使用）

本章说明：核心功能介绍，是理解TeleAgent高效场景和进阶配置的基础。如果您已经熟悉核心功能，可直接跳到【进阶设置】

1.1 工作空间设置

什么是工作空间？

工作空间本质是您指定的文件夹。任何任务都会在某一个工作空间内运行，您可以通过左侧边栏的工作空间索引找到被分组归类的任务。

● TeleAgent可以读取和修改电脑内除核心配置文件以外的文件，除非指定路径，所有任务生成的文件（报告、图表、处理后的数据等）均会保存在工作空间内

● 任务发起后，无法修改工作空间路径

● 工作空间内的重要文件建议提前备份

如何更改工作空间？

1. 点击主界面输入框左下角工作空间按钮，点击【选择文件夹】
2. 在弹出的文件夹选择器中，选择新的工作空间
3. 点击【选择文件夹】即可完成

4. 选择工作空间后，在该空间内进行的任务将统一进入侧边栏的工作空间内进行管理

1.2 输入提示词与查看智能体输出

1.2.1. 文件输入

指定本地文件作为任务处理的输入材料。

使用方法

● 方法1：按钮输入（推荐新手）。点击输入框内的回形针按钮，点击或用键盘回车选中【选择文件】，在文件列表中选择。

● 方法2：键盘输入。在输入框中输入@，点击或用键盘回车选中【选择文件】，在文件列表中选择。

补充说明：

● 支持连续输入多个文件，示例：@文件1.xlsx @文件2.xlsx

● 支持跨文件夹输入文件：展开文件夹选择对应文件即可

● 若在输入时找不到文件，windows用户请检查是否将【选择文件】误点为【选择文件夹】，在【选择文件夹】状态时，无法选中单个文件。

1.2.2. 技能指定

明确指定任务所需的技能，大幅提升技能被正确调用的概率，可输出更好的任务结果。

使用方法

● 方法1：按钮指定。点击输入框内的技能按钮，在技能列表中选择匹配的技能。

● 方法2：键盘指定。在输入框中输入@，通过"↑"、"↓"键选择需要的技能后，点击"回车"键选中对应技能

常用技能：

技能名	适用场景	示例
技能孵化器	手把手引导用户从零创建或迭代 AI 技能，精准应对各类场景。只需描述需求，它将引导您完成技能的创作或优化。	帮我创建一个技能，能根据产品需求文档自动生成 API 接口定义（OpenAPI格式）
AI新闻周报	自动追踪科技、创投、金融领域的热点资讯，智能提炼要点并生成每日/每周简报，一键获取来源、摘要、深度解读。	使用@AI新闻周报，给我每天推送一篇AI圈新闻
合同审核	智能审查合同文件，自动标注关键条款并添加批注。	使用@合同审核技能审核@XX合同，对其中的风险点进行批注
创建网页小应用	快速创建网页小工具，如数据看板、计算器、表单等，支持复杂交互，一键生成即用。	使用@创建网页小应用，把XX信息做成可交互的html数据看板
创意海报设计	快速制作会议海报、宣传展板、汇报封面等办公视觉材料	使用@创意海报设计技能帮我做一份宣传海报，用色大气科技感
文档辅写	高效完成各类文档写作、优化与结构化整理。	使用@文档辅写技能，帮我梳理XX文稿的逻辑，并形成结构化报告
图表绘制	通过自然语言即可生成各类专业图表与结构化图示。例如：流程图、思维导图等	使用@图表绘制技能，帮我以XX文件为基准绘制业务流程图
深度调研	能围绕用户指定主题自动开展深度调研，跨来源收集与分析信息，并输出结构化研究结果。	使用@深度调研技能，调研现有的桌面端智能体。

补充说明

● 支持在一个任务里引用多个技能

● 未明确指定技能时，系统会根据任务描述自动选择技能，但技能匹配结果可能不如手动指定准确

● 若技能调用失败，请检查是否选中了需要的技能，或补充更详细的任务描述

1.2.3. 输入框扩大化

在需要输入长提示词时，可以点击输入框右上角小标签，放大输入框进行长提示词输入，点击相同位置还原

输入query后，支持右键对输入框内容和对话进行剪切、复制、粘贴、全选等操作

输入图片与文件时，可以点击输入标签进行预览

1.2.4. YOLO模式（仅对电信外部员工开放）

TeleAgent对部分用户支持YOLO模式，打开输入框下部按钮，可选择默认权限和全自动执行权限，选择默认权限时，智能体查看文件，进行操作需要用户授权；选择全自动执行权限，默认智能体的操作无需人类确认，可以充分自由执行。

1.3 技能添加与使用

技能广场 ：用于浏览和获取技能，您可以从这里发现并添加需要的技能到"我的技能"中

技能广场入口 ：界面左侧 → 【技能】菜单 → 【技能广场】标签

1.3.1 通过技能广场添加与更新技能

添加技能

在技能广场，可以通过表单快速查看当前飙升技能，实力技能进行选用。

可以通过技能标签分类浏览您所需要的技能。

技能广场浏览时，发现需要的技能后，点击【立即添加】，即可完成技能的添加。也可以通过技能名或作者名搜索技能进行使用。

可在"我的技能"标签页管理已添加的技能，默认为启用状态，可以在任务中@调用

当官方对技能进行更新时，您可以通过点击"立即更新"按钮对此技能进行更新。

--示例： TeleAgent用户支持助手的添加和使用步骤：

“TeleAgent用户支持助手"技能可为您提供TeleAgent常见问题的技术支持，添加后艾特该技能即可自助查询。注意，该技能会不定期更新，使用前请务必前往技能广场搜索该技能名称，若有“更新”按钮请点击后再使用，以保证获取最新内容。

导入步骤：

● 依次点击：技能广场-搜索TeleAgent用户支持助手-添加或更新

● 回到对话界面，在技能列表中选择【TeleAgent用户支持助手】技能，并提出需要技术支持的问题

1.3.2 通过技能导入方式添加技能

点击技能广场右上角-"导入技能"按钮

--文件要求

-支持 .zip、.skill 格式

-根目录下必须包含 SKILL.md 文件

-SKILL.md 头部 frontmatter 需以 YAML 格式编写技能名称和描述

-上传的技能文件不能大于 10MB

--技能导入状态判断

● 导入技能时，系统会自动进行安全审查，若安全审查过程中发现风险，会在弹窗中进行提示，用户确认风险后，仍可继续导入技能

● 通过安全审查的技能会展示在"我的技能"标签页内

--示例： 星辰慧记离线音频转写技能（offline-asr）的导入和使用步骤：

"offline-asr"技能支持以下功能：

● 音频转写：将会议录音内容自动转换为文本

● 会议总结：自动提取会议重点、核心讨论内容和结论

● 纪要生成：输出结构化会议纪要，方便整理和归档

● 多场景适用：适用于会议、访谈、讨论、复盘、培训等音频内容处理

支持的格式：wav、mp3、m4a、pcm

技能文件：offline-asr.zip

导入步骤：

● 依次点击：技能广场-导入技能

● 在导入技能弹窗中上传技能文件

● 回到对话界面，在技能列表中选择【offline-asr】技能，自动插入技能指令到输入框。示例指令：使用

@offline-asr 技能 对（要识别的音频文件）进行识别，输出纪要

1.3.3 通过自然语言创建技能

点击技能广场右上角-【创建技能】按钮

使用自然语言描述您的需求、执行流程和使用场景即可。TeleAgent会基于您输入的需求自动生成技能并将其添加到"我的技能"标签下。

1.3.4 我的技能管理

入口 ：界面左侧 → 【技能】导航项 → 【我的技能】标签

1. 在我的技能标签页，您可以通过来源和状态筛选技能

2. 当技能处于启用状态时，可以通过@引用这个技能；当技能处于停用状态时，技能无法被@引用。同时启用的技能上限为50 个

3. 点击【详情】，发送预置的指令，TeleAgent将会为您详细地介绍此技能的能力是什么

4. 将技能上架到技能广场

● 只有来源是"本地创建"、"本地导入"的技能可以发起上架申请；

● 申请上架时，需要用户填写上架的必备信息：头像、技能名称、技能简介、技能分类信息

● 提交的上架申请后，此技能的状态变为"审核中"，待通过安全审核后，此技能将出现在"技能广场"

● 其他用户在浏览技能广场时，看到此技能时，可通过"立即添加"按钮来添加此技能。若用户要将某个已上架的技能下架，可点击"申请下架"将此技能从技能广场里下架。

1.3.5 技能评分

在技能广场中，可以对已添加的技能进行评分，评分会影响技能在技能广场上的排序，评分较高的技能作者，能够获得TeleAgent官方激励积分。

1.3.6 技能自进化&技能更新

TeleAgent内置技能自进化功能，使用同一个技能>=20次时触发，可以根据您的使用习惯自行进化技能，配合您的使用。



当技能通过自进化形成一定修改时，可以选择更新至广场，使上架的技能更新为技能的最新状态。

当创作者进行了更新之后，用户可在技能广场下载更新后的技能进行使用

1.4. 模型切换

不同模型有不同的能力优势，可根据任务类型快速切换适配模型。

模型备案信息

模型名称	星辰语义大模型
备案单位	中电信人工智能科技（北京）有限公司
备案号	Beijing-XingChen-202404280001
备案公告	国家互联网信息办公室关于发布生成式人工智能服务已备案信息的公告_中央网络安全和信息化委员会办公室

使用方法

主界面快速切换:

补充说明

● 任务执行过程中无法切换模型，切换模型成功后，下次query输入时将使用新模型处理。

1.5. 定时任务

定时任务是一种自动化任务调度功能，允许您提前配置任务内容、执行时间和频率，系统将在指定时间自动执行任务。

1.5.1 表单创建

定时执行：

1. 点击头像浮窗中【设置】标签，点击【定时任务】菜单，进入定时任务管理页面
2. 点击【新增定时任务】按钮（可同时启用10个定时任务，定时任务配置数量没有限制）
3. 在弹出的配置表单中填写任务信息，
4. 选择【仅保存】或【保存并试运行】

1.5.2 自然语言创建

1. 任意时刻，向TeleAgent发送定时任务需求（如"给我新建一个每天7:00搜集机械臂方向招投标的定时任务"）
2. 在智能体对话组件中，澄清确认您的定时任务需求
3. 回复"确认"保存定时任务。

1.5.3 定时任务管理

在定时任务管理页面查看所有已配置的任务，可以编辑并控制定时任务的启用/停用。

补充说明

● 请确保软件在定时任务执行时间处于运行状态，否则任务将被跳过

2. 定时任务执行时，将在左侧边栏形成定时任务组，按照时间显示每一次的定时任务执行纪录。

1.6 即时通讯软件接入

即时通讯功能允许您通过微信、企业微信等IM工具与TeleAgent进行对话，实现跨端任务管理。

通过即时通讯，您可以在即时通讯端感知和控制桌面端的普通任务，实现远程控制任务进度。

入口 ：左侧边栏--【即时通讯】菜单

1.6.1 微信扫码接入流程：

1.打开手机微信，进入设置 - 插件页面，检查是否已安装「微信ClawBot」插件。如未找到该插件，请确认当前的微信版本：IOS用户需更新至8.0.70及以上；安卓用户需更新到8.0.68及以上

2.确认移动端已安装ClawBot插件后，回到TeleAgent,点击微信【立即配置】，扫描二维码，等待微信链接成功

1.6.2 企业微信扫码接入流程：

1. 点击企业微信-【立即配置】

2. 扫描二维码，等待配置成功

3. 如您希望连接已经创建的智能机器人，可以在企业微信的"工作台-智能机器人-管理"中选择已有机器人，通过"详情-编辑获取相应的BotID和Secret，通过TeleAgent的"手动配置"方式进行添加。
4. 通过企微机器人+TeleAgent管理企业微信文档：

首先确认企业微信机器人已获得文档相关权限（每次授权有效期为一周，过期需要重新授权）：

点击截图中的“查看使用方式”，获取JSON Config：

回到TeleAgent，在工具设置中添加MCP服务：

连接成功后即可通过ClawBot管理企微文档：

1.6.3 飞书扫码接入流程：

1. 点击飞书-【快速绑定】

2. 扫描二维码，按照顺序点击对应按钮，完成飞书绑定。

1.6.4 量子密信扫码接入流程：

1. 点击量子密信-【快速绑定】

2. 扫描二维码，按照顺序点击对应按钮，完成量子密信绑定。

1.7 授权机制

当系统需要执行修改类操作时，需要用户明确授权，保障操作安全。

当工具需要授权时，会显示【等待授权】状态，提供三个选项：

选项	含义	适用场景
允许一次	仅授权本次操作	信任此次操作，但不想授权整个任务
一直允许	整个任务的后续操作都自动授权	任务需要多次修改操作，不想重复授权
拒绝	拒绝本次操作	操作不符合预期，不想执行

补充说明：

● 工具执行时间不包含等待决策的时间

● 拒绝授权后，系统会跳过该操作，继续完成其他可执行部分

1.8 预设任务卡片

预设任务提供常见任务的提示词模板，帮您快速搞定规范的任务指令。

使用方法：

1. 在主输入框下方查看预设任务卡片，点击不同分类可以更换预设类型，点击“换一换”可以更换预设任务。
2. 点击需要的预设任务，系统会将任务提示词填入输入框
3. 当输入框已有内容时，系统会弹出提示"当前输入框已有内容，确定要覆盖吗？"
4. 点击【确认】把预设任务提示词填入主输入框

注意预设任务提示词可需要根据实际需求调整。

1.9 任务状态与监控

1.9.1. 任务状态说明

状态	含义	触发条件
运行中	任务正在执行	提交任务后，AI正在处理
已完成	任务执行完成	AI完成所有操作
需介入	需要用户介入	等待授权、需要用户选择等
已暂停	任务暂停	用户手动暂停或系统暂停（如断网）

对历史任务，可以进行任务重命名、置顶与归档。

1.9.2. 任务监控区域查看

对话区会展示任务全流程内容，各模块说明如下：

显示内容	说明
用户消息	用户输入的任务描述
常规输出	系统的回复内容
深度思考	系统的推理过程
操作执行	工具调用过程
任务委派	子智能体任务执行过程

1.9.3 上下文用量查看

在发送任务后，可以在输出底部查看当前任务的任务上下文使用情况。建议为不同内容开启不同的任务，防止不同内容的上下文互相影响。

点击任务上下文详情后，可以选择主动整理任务上下文，为当前任务释放空间

1.9.4 历史对话查看

点击对话右侧，可通过对话大纲快速跳转至对话对应位置，也可通过按钮快速到达历史对话顶端或底端

1.10 消息查看

1.10.1 消息中心查看

TeleAgent积分运营活动，重要更新与软件运行通知，均通过站内消息通知中心进行发送。点击右上角“消息中心”图标，可以查看各类消息。

点击一键已读按钮，可以对您的消息进行一键已读。

2.进阶设置

2.1. 模型设置

● 用途 ：通过API配置第三方模型，扩展AI模型能力，适配更多专属场景。

● 配置通用说明：

● 自定义模型通过Base URL 和 API Key 连接第三方模型服务，需确保API兼容OpenAI格式

2.1.1. 添加其他第三方模型

适用场景：需要使用其他第三方模型的特定能力，支持智谱GLM、DeepSeek、MiniMax、Kimi等主流厂商模型

配置步骤：

1. 点击头像打开头像浮窗，进入【设置】

2. 进入【模型设置】

3. 找到对应厂商，点击【输入API密钥】按钮，输入有效的API Key

 4. 保存并验证。点击【验证并保存】按钮确认，模型自动移动至已配置下方，状态显示为【已配置】

验证方法：

1. 返回主界面，点击右下角模型切换按钮
2. 确认下拉列表中显示【所选择的模型名称】
3. 执行简单任务，验证模型可用
4. 如果模型不再需要，可在模型设置中删除

2.1.2. 模型配置安全与性能建议

安全建议：

● 不要在公共场合分享API Key

● 定期更换API Key

● 为不同的项目使用不同的API Key（如支持）

● 监控API调用次数和费用

性能建议：

● 根据任务类型选择合适的模型，定期检查API调用额度

● 简单任务使用轻量模型，节省费用

● 复杂任务使用高级模型，提升质量

● 定期检查API调用额度

2.2. 工具设置

本节将向您展示如何在日常工作流程中将 MCP工具 与 TeleAgent结合使用。

何时应该使用 MCP工具？

以下情况可使用 MCP工具：

● 已有 MCP 工具，并且您不想让TeleAgent从0构建一个新工具

● 希望TeleAgent通过干净的 RPC 层操作本地或远程系统

● 希望在不修改TeleAgent核心的情况下将TeleAgent连接到内部

API、数据库或公司系统以下情况不建议使用 MCP工具：

● TeleAgent内置工具已能很好地完成任务

● 服务器暴露了大量危险的工具，而您没有做好过滤的准备

● 您只需要一个非常小的集成，原生工具会更简单、更安全

在连接MCP工具前，您应有的核心理解：

● MCP 是一种适配器，TeleAgent是您的代理，MCP 服务器为它提供工具。

● TeleAgent在启动或重新加载时，通过配置文件知道这些工具，在工作中使用它们。

● 良好的 MCP 使用方法并非"连接所有东西"，而是"连接正确的东西，并尽可能减少有效访问范围"。

2.2.1 工具添加

1.通过头像浮窗进入【设置】-【工具设置】-从JSON导入/添加

2.添加一个安全的服务器。

例如：简单的数学运算服务器。

{
  "mcpServers": {
    "math-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

 

MCP 配置文件 (JSON) 标准规范： 配置文件采用标准 JSON格式，根对象必须包含 mcpServers键，其值为一个对象，其中每个键代表一个独立的 MCP 服务。

字段详细定义

字段名	类型	必填	说明	示例
mcpServers	Object	是	所有 MCP 服务的配置入口。	{ “server-id”: { … } }
	Key	是	服务的唯一标识符。建议使用小写字母、数字或连字符。	math-server
command	String	是	启动该服务的主程序路径或可执行命令。	npx, python, node
args	Array	是	传递给 command 的命令行参数列表。	[“-y”, “@mcp/server”]
env	Object	否	注入服务进程的环境变量（如 API Keys）。	{ “API_KEY”: “sk-xxx” }

（如果您想要连接Notion，Figma等应用，它们通常会提供连接MCP的文档，您可以将文档提供给TeleAgent，并输入以下提示词：@您的对应文档，根据这份连接MCP的官方文档，给我写一份连接MCP用的JSON格式代码，只需要生成mcp_servers 内部的对象部分。）

3.验证 MCP 是否已加载

配置完成后，对应MCP出现绿色的"已连接"标识，点击编辑可以修改MCP连接，点击删除可以删除MCP。点击首页的MCP按钮，可以看到正在使用的MCP。

● 连接/断开工具

● 在工具列表中找到目标工具，点击【连接】或【断开】按钮，等待状态更新

● 编辑工具

● 点击工具的【编辑】按钮，在弹出的编辑器中修改配置，点击【保存MCP服务器】验证

注：工具名称修改后，历史任务可能无法正确引用

2.3. 网络代理设置

部分企业因安全管理要求，所有网络访问都必须通过代理转发。此类企业内网用户因为内网代理原因无法登录TeleAgent时，可以通过TeleAgent内的网络代理设置功能来使用TeleAgent。

网络代理支持三种模式，分别是自动，自定义及关闭。

自动：尽力复用用户已有的代理配置（环境变量 + 系统代理），“能走代理就走代理”。适用企业内网、服务器 CI 等已有代理注入的环境。

自定义：TeleAgent所有网络请求均通过配置的代理服务器进行转发。

关闭：强制直连，主动忽略环境变量和系统代理，“能不走代理就不走代理”。适用排查连通性问题、或确认无需代理的环境。“关闭”和“自动”模式在"无任何代理配置"的环境下行为相同（都直连），差异体现在"存在代理配置时是否使用"。

功能入口1：登录页链接

1、 点击登录页右上角“更多”选项，选择代理设置

2、 填写代理设置内容（具体内容需要由相关组织IT部门确定）

功能入口2：登录页链接

1、 打开头像浮窗，点击设置：

2、 选择代理设置，默认设置为自动

3、 选择自定义，可填写所需要的代理信息

3.系统设置

3.1 语言与外观设置

● 语言切换：支持中英文切换。

进入【设置】→【语言设置】，找到【中英文切换】下拉框，选择目标语言

● 外观切换：支持浅色模式、深色模式、跟随系统三种主题。

进入【设置】→【外观设置】，找到【系统外观】下拉框，选择目标主题，应用自动实时生效新主题

3.2 通知设置

进入【设置】→【通知设置】，可配置以下内容：

● 【开启通知】开关：开启/禁用所有系统通知

● 【声音提醒】开关：通知弹出时是否播放提示音（仅全局通知开启时可配置）

● 【开机自启】开关：开启后可以在开机时自动启动TeleAgent

● 【防止休眠】开关：开启后防止TeleAgent运行时休眠

通知类型

通知类型	触发条件
任务完成通知	任务状态从"运行中"变更为"已完成"
任务暂停通知	任务状态从"运行中"变更为"已暂停"
需人工介入通知	任务状态从"运行中"变更为"需介入"

3.3 运行设置

进入【设置】-【运行设置】，可以配置以下内容：

● 开机自启：在开机时可以自动打开TeleAgent

● 防止休眠：打开防休眠按钮，可阻止系统在任务运行时自动休眠，电脑因合盖/断网/低电量等特殊情况而进入睡眠时，任务仍可能中断。

● 安全沙箱：提供系统级AI操作权限保护

3.4 用量明细

自2026年8月3日起，计量模式由原 Token 体系升级为积分体系。积分是 TeleAgent 的统一计量单位，用于衡量资源消耗，可用于完成写文档、做 PPT、分析数据、搭应用、浏览网页等各类 AI 任务。

进入【设置】→【用量明细】，可查看任务积分消耗量信息

3.5 账户信息

退出登录：

进入【设置】→【账户与登录】，下拉至底端，点击【退出登录】，弹窗二次确认后完成退出

修改账户信息：

进入【设置】→【账户与登录】，点击【修改个人信息】，自动打开浏览器，跳转至天翼 AI 开放平台，在网页端完成账户信息修改

4.故障排查与系统维护

4.1 常见问题快速排查

4.1.1 任务执行类问题

问题1：任务卡在"等待授权"状态

● 现象：工具卡片显示"等待授权"，长时间无响应

● 可能原因：用户未及时处理授权请求，或授权请求被遮挡

● 诊断方法：展开对应工具卡片，查看是否有授权选项

解决方法：

找到显示"等待授权"的工具卡片，选择【允许一次】、【一直允许】或【拒绝】

问题2：任务执行失败

● 现象：任务状态显示"已暂停"，或显示"已完成"但结果不正确

● 诊断方法：点击任务查看详情，展开折叠组件（深度思考、操作执行、任务委派），查找错误信息或警告，根据错误类型，对应处理：

错误类型	表现	诊断方法	解决方法
文件操作失败	工具卡片显示文件写入/读取失败	检查文件是否存在、是否有权限工作空间路径是否正确	确保文件在工作空间内，检查文件是否被其他程序占用
技能调用失败	工具卡片显示技能调用失败	检查技能调用日志，确认技能是否被正确识别	使用@符号明确指定技能，如"使用@电子表格处理技能“
工具调用失败	工具卡片显示工具连接失败	检查工具连接状态，查看工具卡片错误信息	重新连接工具，检查工具配置是否正确
模型调用失败	工具卡片显示模型请求失败	检查模型配置，查看API调用日志	检查API Key是否正确，检查API调用额度，检查网络连接
网络搜索失败	工具卡片显示搜索失败	检查网络连接	恢复网络

问题3：任务执行速度慢

● 现象：任务执行时间远超预期，工具调用耗时过长

● 诊断与解决方法：

检查项	说明	正常范围	解决方法
文件大小	检查文件是否过大	建议<100MB	大文件建议拆分处理
任务复杂度	检查任务是否过于复杂	-	复杂任务建议拆解为多个子任务，分步执行
网络延迟	检查网络连接	建议<100ms	检查网络连接质量，切换稳定网络
模型响应	检查模型API响应时间	建议<5s	切换响应更快的模型，如官方基础模型

4.1.2 工具与模型配置类问题

问题1：MCP工具连接失败

● 现象：工具列表显示"已断开"，点击【连接】后仍失败，连接测试不通过

● 诊断与解决方法：

1. 打开工具编辑页面，检查JSON配置是否正确，必填项是否完整填写
2. 检查本地网络连接是否正常，API服务器是否可访问，防火墙是否拦截连接

问题2：API Key 填写错误

● 现象：配置时输入 API Key 错误，保存后提示验证失败或密钥无效

● 诊断与解决方法：

1. 重新进入模型设置页面，找到 API Key 输入项
2. 删除原有错误密钥，重新准确填写正确的 API Key
3. 点击保存，系统将自动重新进行密钥验证

问题3：模型设置验证失败

● 现象：模型设置显示"未配置"或"配置失败"，保存后验证不通过

● 诊断与解决方法：

● 检查 API Key：确认 Key 是否正确、是否过期、账户是否有可用调用额度

● 检查网络连接

问题4：模型切换后未生效

● 现象：切换选择模型后，调用仍使用原模型，设置未生效

● 诊断与解决方法：

● 检查是否在首页完成模型切换

● 确认选择后刷新页面或重新发起任务，使模型设置生效

4.2 日志打包与问题反馈

4.2.1 日志打包

当遇到无法自行解决的问题，需要技术支持排查时，可按以下步骤打包日志：

1. 打开应用，打开头像浮窗，点击【设置】按钮
2. 在左侧菜单中选择【关于】
3. 找到【日志打包】按钮并点击
4. 在弹出的任务列表中，选择运行日志或需要排查的目标任务日志（支持多选）
5. 点击【打包到桌面】，系统自动打包运行日志，生成.zip 格式的日志包
6. 日志包命名格式：logs-[时间戳]-[任务 ID].zip

4.2.2 问题反馈方式

点击软件内【问题反馈】按钮，联系在线客服。

点击产品文档，查看产品文档。

4.3 系统维护

版本更新

● 自动更新机制：系统自动检查新版本，发现新版本时提示您【检测到当前有可更新版本，是否更新？】，您可以自主选择是否更新。

● 手动更新机制：点击右上角检测更新按钮，可以检查当前是否有可更新版本，检测到新版本时，您可以手动进行更新。

● 更新注意事项：

1. 运行中的任务会自动暂停，建议在空闲时执行更新
2. 更新前建议备份工作空间内的重要文件
3. 版本更新内容可查看【设置】→【关于】，点击【版本更新日志】

附录 快速参考

常用技能、快捷键、任务模板的快速查阅表格，方便日常使用时快速查找。

1. 常用任务模板

● 数据分析模板：基于@数据文件，分析[分析维度]，生成包含[图表类型]的分析报告，输出格式参考@模板文件

● 文档撰写模板：基于@参考资料，撰写[文档类型、使用场景]，包含[内容结构]，字数约[数字]字，风格参考@范文

● PPT制作模板：基于@大纲文档，制作[数字]页PPT，内容包括[如：市场分析、功能对比、技术方案对比]，风格参考@模板

● 深度调研模板：调研[调研主题]，搜索[时间范围]的信息，关注[信息类型]，输出[报告类型]

● AI新闻周报模板：@AI新闻周报，结合网页搜索工具对近期AI新闻进行搜索汇总，形成周报

● 合同审核模板：@合同审核技能，对[要审核的合同]进行审核

● 创建网页小应用模板：@创建网页小应用技能，写一个[要开发的主题]系统网页，需要包括[关键模块]

●查看更多任务示例，请参考【场景化操作指南】：星辰超级智能体桌面版场景化操作指南，智能体使用技巧，任务成功率提升，文件合并，格式调整，内容润色，避坑指南-天翼AI开放平台-中国电信

2. 常用操作速查

想做什么	操作	示意图
新建任务	点击左上角【新建任务】
添加文件	输入框内点击【回形针】→ 选择文件
使用技能	输入框内点击【@】→ 选择技能
查看历史	左侧任务栏点击历史任务
更改工作空间	点击主输入框下方按钮更改工作空间