> 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/features/models.md).

# 3.2 AI 模型与任务默认设置

| 功能 → 作用                      | 使用方法及对应截图                                                                                                                                                                                                                                  | 前提或限制                                   |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------- |
| 添加/编辑/删除模型连接 → 接入服务商         | 「设置 → 模型 → 添加连接」选择服务商及认证方式。[实拍：服务商选择页](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fk5j5QrjAPaYKc7ooDitd%2Fscreenshot-c07bd811800e3cb0.png?alt=media)           | 这是选择页，不是已填写密钥、测试成功或连接详情的截图；这些状态仍待补。     |
| API key/账号授权 → 完成身份验证        | 根据页面选择密钥或账号登录，不要把 key 发到任务消息里。🖼️ 待补实拍                                                                                                                                                                                                     | 不同服务商支持方式不同；密钥可能有额度或权限限制。               |
| 服务地址与模型请求代理 → 指定模型 API 和网络路线 | 在连接配置中按服务商文档填地址；必要时设置「模型请求代理」并测试。🖼️ 待补实拍                                                                                                                                                                                                  | 模型代理和浏览器环境代理是两回事；地址不要随意改。               |
| 测试连接、更新目录、启用模型 → 确认能用哪些模型    | 保存后按页面测试，刷新目录并启用模型。[实拍：已登录连接详情](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FMwisMqhbQ25bgHposRVT%2Fscreenshot-f140847460149aa2.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) | 不可用时先看原因提示；切换模型不改写已生成回答。                |
| 新任务默认值与 Code Mode → 设定新任务起点  | 「设置 → 通用」设置默认模型、权限模式、思考级别及 Code Mode。[实拍：图 07](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FhG0IB7sQUBX4gWrFqpK5%2Fscreenshot-ccab052b847d2c2d.png?alt=media)   | 默认值通常面向新任务；提高权限模式前要了解风险。                |

![实拍：服务商选择页](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fk5j5QrjAPaYKc7ooDitd%2Fscreenshot-c07bd811800e3cb0.png?alt=media)

![实拍：已登录连接详情](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FMwisMqhbQ25bgHposRVT%2Fscreenshot-f140847460149aa2.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)

## 3.2.1 从连接到能对话的完整链路

作用：让任务能够稳定调用模型。操作：「设置 → 模型」先选服务商和该服务支持的认证方式（API key 或账号授权）；核对服务地址、是否需模型请求代理，保存连接；使用“测试连接”；再刷新/更新可用模型目录，启用所需模型；回到任务选择该模型，发送普通测试消息。完成标准：不仅连接测试通过，而且任务实际收到回复。[实拍：模型设置页顶部](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2Fc4upRvct6YLrFZlXPaZ9%2Fscreenshot-780fdf50d5616a9b.png?alt=media)；连接表单/测试结果🖼️待补实拍。

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

失败时按症状处理：401/认证失败先查密钥和账号授权；连接超时先查服务地址、代理和网络；没有可选模型先查目录及启用状态；任务能选模型但发送失败，再查额度、运行组件和健康状态。错误代码以实际页面为准，别把模型代理误配到浏览器环境。

## 3.2.2 默认值与本次任务的区别

「设置 → 通用」的默认模型、权限模式、思考级别和 Code Mode 决定新任务的起点；当前任务输入区的模型/权限选择针对正在处理的任务。改变默认值后，打开一个新任务验证；已有任务里仍应看当前显示值。[实拍：通用设置](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2FhG0IB7sQUBX4gWrFqpK5%2Fscreenshot-ccab052b847d2c2d.png?alt=media)·[实拍：输入区](https://3562115456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkkEVZYvcZcj7SXPvJIS%2Fuploads%2F4wkO3GOIVyXPVdRyJdeo%2Fscreenshot-e1052711a7f681d8.png?alt=media)。权限模式越宽松，允许的工具动作可能越多；不熟悉时先用较谨慎的设置。

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

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


---

# 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/features/models.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.