常见问题

排查时先确认问题发生在哪个阶段：发现应用、初始化、进入 Assistant，还是执行具体业务任务。同一应用在不同组织中可以有不同的配置与状态。

​

找不到目标应用

确认当前服务与组织是否正确，再检查管理员是否已经安装并加载提供该应用的插件。应用目录根据当前有效范围展示已加载的应用声明；在插件市场看到一个包，并不表示当前服务已加载它。 本栏目的官方应用目录用于查阅产品文档。某篇文档是否已收录，与当前环境能否使用应用分别管理。

​

不能初始化，或提示缺少模型与工具

查看详情页的具体检查结果： 关闭向导后仍可继续使用已经保存的工具配置，具体步骤见发现与启用应用。

​

初始化失败，是否需要重新安装

先刷新当前应用的状态并查看失败原因。修复缺失依赖后，从同一应用入口重试或修复，让平台复用已有安装记录和有效资源。初始化仍在进行时等待状态更新。 “放弃配置”只适用于满足条件的准备阶段资源，不能作为已启用应用的通用重置。插件重新安装也不会自动完成模板升级或业务数据迁移。

​

应用已就绪，但员工无法使用

核对员工是否在正确组织、入口 Assistant 是否已发布，以及员工是否通过用户组或其他有效关系获得使用权。组织初始化不会自动授权全体员工。 如果能进入 Assistant，却无法读取项目或业务记录，继续检查对应资源的权限。只获运行授权的员工看不到私有开发空间属于正常情况。详见权限与应用维护。

​

工作台没有预期视图，或项目不可选

确认应用是否提供该功能、当前页面是否已绑定业务对象，以及 Assistant 和项目是否可访问。项目列表请求失败时先重试；不要将加载失败理解为没有项目。 业务项目应从应用入口创建和管理。固定项目的页面可以限制切换，这是业务上下文的一部分。详见项目与任务协作。

​

任务显示已安排，却没有结果

区分任务计划、进入队列、实际执行和业务验收。查看应用当前状态与具体执行尝试，确认是否在等待依赖、外部服务或人工确认。同步延迟时检查应用记录与任务同步状态；刷新任务视图不会启动业务工作。

​

Assistant 说已完成，但文件或业务状态不对

从应用重新打开实际成果，检查内容、版本、保存位置及业务状态。一次 Agent 执行成功后，可能仍有复核或提交步骤。按应用提供的编辑、重试和确认流程处理，详见工作台与成果交付。 向维护人员反馈时，提供应用名称、发生时间、操作步骤、错误提示和预期结果；按授权范围分享必要的业务对象信息，避免提交账号凭据或无关业务资料。