> For the complete documentation index, see [llms.txt](https://docs.xunda.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xunda.ai/documentation/xunda-browser-manual/getting-started.md).

# 4. 新手上路

每一步都有从哪里进入 → 做什么 → 完成后看什么。如果你的页面没有所述入口，先看第 1.4 节，不要靠猜测操作。

## 4.1 使用、创建与管理团队

1. 进入：账号入口和「团队资源」。操作：确认已登录、当前团队名称/ID及角色。看到：团队资源页显示属于该团队的栏目。[实拍：图 04](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FLed3bm4FDoOYU538dJzT%2Fscreenshot-e3b76f7d3ae7adcc.png?alt=media)

![实拍：图 04](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FLed3bm4FDoOYU538dJzT%2Fscreenshot-e3b76f7d3ae7adcc.png?alt=media)

2. 进入：账号/团队入口（如提供「创建团队」「加入团队」）。操作：按页面提示创建或接受邀请。看到：当前团队切换为目标团队，并在团队资源页核对名称。🖼️ 创建/加入入口待补实拍。
3. 进入：「团队资源 → 团队成员」。操作：有权限时打开邀请表单，填写前核对对象和角色。看到：实际发送后列表应出现待加入/已加入状态。[实拍：邀请空白表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FUYtZKC9XjnVpleXJRsmT%2Fscreenshot-439f2f16ba945d5c.png?alt=media)。本次未发送。

![实拍：邀请空白表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FUYtZKC9XjnVpleXJRsmT%2Fscreenshot-439f2f16ba945d5c.png?alt=media)

4. 进入：「代理管理」「账号管理」。操作：仅按业务需要添加代理并测试、添加平台账号，再给环境关联。看到：资源出现在当前团队列表；代理测试有明确结果。🖼️ 待补实拍。🔐 不把密码和 2FA 密钥放进任务正文。

## 4.2 接入与管理 AI 模型

1. 进入：「设置 → 模型」。操作：先查已有连接和启用模型。看到：可供任务选择的模型。[实拍：图 08](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fc4upRvct6YLrFZlXPaZ9%2Fscreenshot-780fdf50d5616a9b.png?alt=media)

![实拍：图 08](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fc4upRvct6YLrFZlXPaZ9%2Fscreenshot-780fdf50d5616a9b.png?alt=media)

2. 进入：「添加连接」。操作：按服务商要求选账号授权或 API key，填写必要的服务地址；网络需要时单独设置模型请求代理。看到：连接保存到列表。🖼️ 添加表单待补实拍。
3. 进入：连接详情/测试入口。操作：测试连接、更新模型目录并启用一个聊天模型。看到：测试通过且该模型为可选状态。🖼️ 测试结果待补实拍。
4. 进入：「设置 → 通用」及新任务输入区。操作：设默认模型，再发一条不含敏感信息的测试消息。看到：收到正常回复，而不是只看到“连接成功”。[实拍：图 07](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FhG0IB7sQUBX4gWrFqpK5%2Fscreenshot-ccab052b847d2c2d.png?alt=media)·[实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

![实拍：图 07](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FhG0IB7sQUBX4gWrFqpK5%2Fscreenshot-ccab052b847d2c2d.png?alt=media)

![实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

## 4.3 创建与管理浏览器环境

1. 进入：「浏览器环境」。操作：查看列表、搜索及当前团队环境数。看到：环境卡片或空状态。旧[实拍：图 03](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FnumEP0IKljLJIhu9FPwv%2Fscreenshot-5b363429828d037e.png?alt=media)为当时空状态；本次页面显示 20 个团队环境，名称未收入截图。

![实拍：图 03](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FnumEP0IKljLJIhu9FPwv%2Fscreenshot-5b363429828d037e.png?alt=media)

2. 进入：创建环境入口。操作：选择单个或批量，填写名称、平台、网址；按需选择代理、账号及成员权限。看到：保存后列表出现新环境。[实拍：单个表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F5Cu3P9ofjc2g6ZbqT3m1%2Fscreenshot-3169acd5896b414a.png?alt=media)·[实拍：批量表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FeFlmZf52wRhH4bUuC968%2Fscreenshot-cf1744ea4250b736.png?alt=media)。本次未保存。

![实拍：单个表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F5Cu3P9ofjc2g6ZbqT3m1%2Fscreenshot-3169acd5896b414a.png?alt=media)

![实拍：批量表单](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FeFlmZf52wRhH4bUuC968%2Fscreenshot-cf1744ea4250b736.png?alt=media)

3. 进入：新环境的编辑页。操作：核对地区/时区、语言、指纹与启动页面，保留合理默认值，不随意重置指纹种子。看到：保存后配置仍显示所选值。🖼️ 环境编辑页待补实拍。
4. 进入：环境列表。操作：点击打开，等待内核准备和窗口出现；用显示窗口与会话列表核对。看到：目标网站在对应窗口打开，会话显示运行状态。🖼️ 打开与会话状态待补实拍。
5. 进入：窗口/会话操作。操作：完成后关闭窗口；只有确实要清理时才分别选择「清除同步状态」或「清除本地资料」。看到：会话状态变化；环境本身仍可在列表中找到。🖼️ 待补实拍。⚠️ 清除资料前先备份并准备重新登录。

## 4.4 安装与使用技能

1. 进入：「技能与连接器 → 技能」。操作：搜索、打开详情，读用途、输入材料和限制。看到：确认该技能适合这次任务。[实拍：图 06](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F5rDbcgvCnDpXAmQ8YrhM%2Fscreenshot-89c6e30d3cd9d348.png?alt=media)

![实拍：图 06](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F5rDbcgvCnDpXAmQ8YrhM%2Fscreenshot-89c6e30d3cd9d348.png?alt=media)

2. 进入：页面提供的技能安装/导入入口。操作：从可信来源安装。看到：技能出现在已安装列表。🖼️ 安装入口待补实拍；若没有此入口，请按界面权限提示处理，不以连接器代替技能。
3. 进入：新任务输入区。操作：选择「使用技能」并写清本次目标。看到：任务中的技能选择与回复符合所需流程。🖼️ 快捷入口待补实拍。

## 4.5 执行第一个 AI 浏览器任务

1. 进入：「新任务」。操作：选择可用模型和正确项目；写清目标、资料来源、截止动作与交付形式。看到：输入区显示完整要求。[实拍：图 01](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FrMGZvZnBhGEP00QWS7Fj%2Fscreenshot-6fb5966b2d901ed7.png?alt=media)·[实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

![实拍：图 01](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FrMGZvZnBhGEP00QWS7Fj%2Fscreenshot-6fb5966b2d901ed7.png?alt=media)

![实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

2. 进入：输入区附件、浏览器或技能入口。操作：只添加需要的文件/文件夹和环境/技能。看到：发送前资源选择正确。🖼️ 选择菜单待补实拍。
3. 进入：发送后的任务页面。操作：看状态和权限提示；敏感动作先核对再授权，必要时停止。看到：任务有回复或明确错误，而非仅停留在运行状态。🖼️ 状态/授权待补实拍。
4. 进入：回答、网页及工作栏。操作：打开生成文件、查看实际网站状态和追踪；发现错误就描述差异继续追问、重新生成或分支。看到：内容、文件和网页状态互相一致。🖼️ 工作栏待补实拍。

可直接复制的第一条任务示例：

请在我指定的浏览器环境里查看目标网站的公开帮助页面，整理账号登录常见问题，列出页面链接和更新时间。只做读取与整理，不登录其他账号、不提交表单、不修改设置。最后给我一份简短核对清单。

## 4.6 首次使用常见问题

| 遇到的问题          | 先这样检查                                              |
| -------------- | -------------------------------------------------- |
| 模型无法发送消息       | 「设置 → 模型」确认连接、凭据、已启用模型和额度；测试连接，并看模型网络代理与「设置 → 健康」。 |
| 浏览器环境无法打开      | 核对团队权限、代理测试、浏览器内核准备和环境打开进度；确认不是只创建了任务而没创建环境。       |
| 找不到技能或生成文件     | 技能查「已安装」并确认任务中已选择；文件查同一任务的「生成文件」面板及原项目目录。          |
| 页面提示权限不足/功能不可用 | 确认团队角色、账号状态、版本和 Runtime Host；保存提示内容，请管理员或支持人员核对。   |
| 关闭后网站要求重新登录    | 先检查保留本地资料与同步状态开关，不要立即清除数据；有些网站本身会使登录过期。            |

## 4.7 一次完整演练：只读取、不修改网页

下面是安全练习，不需要真实购买或发布。适合首次检查团队、模型、环境和任务链路。

1. 团队：进入「团队资源」，确认团队名称及自己可使用的环境。应看到：团队资源页面及正确团队。[实拍：图 04](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FLed3bm4FDoOYU538dJzT%2Fscreenshot-e3b76f7d3ae7adcc.png?alt=media)

![实拍：图 04](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FLed3bm4FDoOYU538dJzT%2Fscreenshot-e3b76f7d3ae7adcc.png?alt=media)

2. 模型：在「设置 → 模型」选已启用模型，任务中发送“请回复测试成功”。应看到：实际回复，而非只有测试连接成功。[实拍：图 08](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fc4upRvct6YLrFZlXPaZ9%2Fscreenshot-780fdf50d5616a9b.png?alt=media)

![实拍：图 08](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fc4upRvct6YLrFZlXPaZ9%2Fscreenshot-780fdf50d5616a9b.png?alt=media)

3. 环境：有访问权限时在「浏览器环境」选一个用于公开网页的环境并打开。应看到：目标环境窗口打开；没有环境可先仅做模型测试。[实拍：图 03](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FnumEP0IKljLJIhu9FPwv%2Fscreenshot-5b363429828d037e.png?alt=media)；打开状态🖼️待补实拍。

![实拍：图 03](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FnumEP0IKljLJIhu9FPwv%2Fscreenshot-5b363429828d037e.png?alt=media)

4. 任务：新建任务，要求“只读取指定官网公开帮助页，列出 3 条内容和链接，不登录、不提交、不修改”。应看到：输入区明确显示边界，发送后有任务状态。[实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

![实拍：图 02](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)

5. 核验：打开回答中的链接，比较原网页；检查生成文件（若有）和任务工作栏。应看到：信息与网页一致；否则补充纠错，不直接对外使用。工作栏🖼️待补实拍。

## 4.8 关键操作前的三问 ✅

* 对象对吗？ 团队、环境、网站域名、账号、成员、文件路径是否正确。
* 影响多大？ 是读取、编辑、批量操作，还是删除/发布/付款；同步数据与本地资料是否会受影响。
* 怎么验证？ 操作后到列表、网页、会话、生成文件或执行记录中检查结果；必要时先备份并保留错误提示。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.xunda.ai/documentation/xunda-browser-manual/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.