> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 定位应用发现、配置、初始化、访问、项目任务与成果交付中的常见问题。

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

## 找不到目标应用

确认当前服务与组织是否正确，再检查管理员是否已经安装并加载提供该应用的插件。应用目录根据当前有效范围展示已加载的应用声明；在插件市场看到一个包，并不表示当前服务已加载它。

本栏目的[官方应用目录](../catalog)用于查阅产品文档。某篇文档是否已收录，与当前环境能否使用应用分别管理。

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

查看详情页的具体检查结果：

| 提示方向 | 处理方式 |
| - | - |
| 未选择组织或缺少初始化权限 | 切换正确组织，请具备初始化权限的人员操作 |
| 缺少主模型或专用模型 | 在组织中配置所需模型，回到向导选择 |
| 缺少工具提供方 | 由管理员安装并加载对应插件 |
| 缺少工具配置 | 选择可用配置，或通过向导新增配置并完成授权 |

关闭向导后仍可继续使用已经保存的工具配置，具体步骤见[发现与启用应用](./discovery-and-setup)。

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

先刷新当前应用的状态并查看失败原因。修复缺失依赖后，从同一应用入口重试或修复，让平台复用已有安装记录和有效资源。初始化仍在进行时等待状态更新。

“放弃配置”只适用于满足条件的准备阶段资源，不能作为已启用应用的通用重置。插件重新安装也不会自动完成模板升级或业务数据迁移。

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

核对员工是否在正确组织、入口 Assistant 是否已发布，以及员工是否通过用户组或其他有效关系获得使用权。组织初始化不会自动授权全体员工。

如果能进入 Assistant，却无法读取项目或业务记录，继续检查对应资源的权限。只获运行授权的员工看不到私有开发空间属于正常情况。详见[权限与应用维护](./access-and-updates)。

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

确认应用是否提供该功能、当前页面是否已绑定业务对象，以及 Assistant 和项目是否可访问。项目列表请求失败时先重试；不要将加载失败理解为没有项目。

业务项目应从应用入口创建和管理。固定项目的页面可以限制切换，这是业务上下文的一部分。详见[项目与任务协作](./projects-and-tasks)。

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

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

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

从应用重新打开实际成果，检查内容、版本、保存位置及业务状态。一次 Agent 执行成功后，可能仍有复核或提交步骤。按应用提供的编辑、重试和确认流程处理，详见[工作台与成果交付](./workbench-and-delivery)。

向维护人员反馈时，提供应用名称、发生时间、操作步骤、错误提示和预期结果；按授权范围分享必要的业务对象信息，避免提交账号凭据或无关业务资料。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.