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

# Agent 快速开始 - 在任意 AI Agent 中连接 AIsa

> 面向 Agent 的简短设置指南，用最少上下文安全连接 AIsa 模型、API 和 Skills。

当用户要求 AI Agent 在 OpenClaw、Hermes Agent、Claude Code、Cursor、Codex 或其他可调用工具的助手环境中连接、配置或使用 AIsa 时，请优先阅读本页。

目标：让 Agent 走到**最小、可验证、不会泄露密钥**的下一步，而不是一次性加载完整文档索引。

## 最小设置事实

AIsa 提供两类端点：

| 用途                     | Endpoint                       |
| ---------------------- | ------------------------------ |
| OpenAI 兼容聊天、模型路由、SDK   | `https://api.aisa.one/v1`      |
| AIsa 数据 API 与非聊天能力 API | `https://api.aisa.one/apis/v1` |

大多数模型客户端只需要：

```txt theme={null}
base_url: https://api.aisa.one/v1
api_key:  $AISA_API_KEY
```

API key 作为 Bearer token 使用。不要打印、记录、提交或硬编码密钥。优先使用环境变量或 Agent runtime 的 secret store。

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
```

如果用户还没有提供 key，请说明到哪里创建，而不是编造一个看似真实的占位值。

## 选择一条路径

先判断用户要做什么，然后只读对应文档。

| 用户想做                    | 下一步阅读                                                                                                                                                          |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 基础账号/API key 设置         | [AIsa 入门](/zh/guides/getting-started-with-aisa)、[认证](/zh/guides/authentication)                                                                                |
| 把 AIsa 当作 LLM provider  | [模型](/zh/guides/models)、[Chat Completions API](/api-reference/chat/post_chat-completions)                                                                      |
| 在 Hermes Agent 中使用 AIsa | [在 Hermes Agent 中使用 AIsa](/zh/guides/tutorials/use-aisa-in-hermes-agent)                                                                                       |
| 在 OpenClaw 中使用 AIsa     | [在 OpenClaw 中使用 AIsa](/zh/guides/tutorials/openclaw-quick-setup)                                                                                               |
| 使用 Agent Skills         | [Agent Skills](/zh/agent-skills)、[Agent Skills 快速开始](/zh/agent-skills/quickstart)                                                                              |
| 搜索或研究网页                 | [Tavily Search](/zh/agent-skills/tavily-search)、[Tavily Extract](/zh/agent-skills/tavily-extract)、[Smart Search](/zh/agent-skills/smart-search)                |
| 深度研究                    | [Perplexity Deep Research](/zh/agent-skills/perplexity-research)、[Perplexity Deep Research API](/api-reference/perplexity/post_perplexity-sonar-deep-research) |
| 学术搜索                    | [Scholar Search](/zh/agent-skills/scholar-search)、[Scholar API](/api-reference/scholar/post_scholar-search-scholar)                                            |
| 使用特定 REST API           | [API Reference](/api-reference)，然后只打开需要的具体 endpoint 页                                                                                                          |

## Agent 行为准则

* 只有目标路径不清楚时，才问一个澄清问题。
* 只加载完成任务所需的最小文档集合。
* 不要打开无关 API 页面。
* 简短总结和链接足够时，不要把大段文档粘贴进对话。
* 不要把图像、视频、embedding、Whisper 或 TTS 模型当作主对话模型。
* 声称配置可用前，用一个小而安全的检查验证对应部分。
* 对于密钥，只验证存储方式，不展示密钥本身。

## 研究任务的证据规则

```txt theme={null}
搜索结果是发现线索。
抓取页面是证据。
生成摘要是综合判断。
```

对事实性结论，优先使用官方文档、API reference、README、changelog 或运行时/API 结果，而不是第三方摘要。

## 可复制 Prompt

把下面这段复制到 Agent 环境：

```txt theme={null}
Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.
```

## 兜底发现入口

仅当上面的定向文档不够时再使用：

* [`llms.txt`](https://aisa.one/docs/llms.txt)：用于发现更多 AIsa 页面。
* [`llms-full.txt`](https://aisa.one/docs/llms-full.txt)：完整文档包。除非用户明确要求完整摄取，否则不要读取。