> ## 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 Quickstart - Connect AIsa in Any AI Agent

> A short, agent-readable setup guide for safely connecting AIsa models, APIs, and Skills with minimal context.

Use this page when a user asks an AI agent to connect, configure, or use AIsa inside an agent environment such as OpenClaw, Hermes Agent, Claude Code, Cursor, Codex, or another tool-calling assistant.

Goal: get the agent to the smallest safe next step without loading broad documentation indexes.

## Minimal setup facts

AIsa provides two endpoint families:

| Use case                                    | Endpoint                       |
| ------------------------------------------- | ------------------------------ |
| OpenAI-compatible chat, model routing, SDKs | `https://api.aisa.one/v1`      |
| AIsa data APIs and non-chat capability APIs | `https://api.aisa.one/apis/v1` |

For most model clients:

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

Use the API key as a Bearer token. Do not print, log, commit, or hardcode it. Prefer environment variables or the agent runtime's secret store.

```bash theme={null}
export AISA_API_KEY="<your_aisa_api_key>"
```

If the user has not provided a key, explain where to create one instead of inventing a placeholder value.

## Choose one path

First identify what the user wants, then read only the docs for that path.

| User wants                       | Read next                                                                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Basic AIsa account/API key setup | [Getting Started with AIsa](/guides/getting-started-with-aisa), [Authentication](/guides/authentication)                                                     |
| Use AIsa as an LLM provider      | [Models](/guides/models), [Chat Completions API](/api-reference/chat/createchatcompletion)                                                                   |
| Use AIsa in Hermes Agent         | [Use AIsa in Hermes Agent](/guides/tutorials/use-aisa-in-hermes-agent)                                                                                       |
| Use AIsa in OpenClaw             | [Use AIsa in OpenClaw](/guides/tutorials/openclaw-quick-setup)                                                                                               |
| Use Agent Skills                 | [Agent Skills](/agent-skills), [Agent Skills Quickstart](/agent-skills/quickstart)                                                                           |
| Search or research the web       | [Tavily Search](/agent-skills/tavily-search), [Tavily Extract](/agent-skills/tavily-extract), [Smart Search](/agent-skills/smart-search)                     |
| Deep research                    | [Perplexity Deep Research](/agent-skills/perplexity-research), [Perplexity Deep Research API](/api-reference/perplexity/post_perplexity-sonar-deep-research) |
| Academic search                  | [Scholar Search](/agent-skills/scholar-search), [Scholar API](/api-reference/scholar/searchscholar)                                                          |
| Specific REST API                | [API Reference](/api-reference), then only the exact endpoint page needed                                                                                    |

## Agent behavior

* Ask one clarifying question only if the target path is unclear.
* Load the smallest relevant doc set for the task.
* Do not open unrelated API pages.
* Do not paste large docs into the conversation when a short summary and links are enough.
* Do not choose image, video, embedding, Whisper, or TTS models as the main conversational model.
* Before saying setup works, verify the relevant part with a small safe check.
* For secrets, verify storage without revealing the key.

## Evidence rule for research tasks

```txt theme={null}
Search results are discovery.
Fetched pages are evidence.
Generated summaries are synthesis.
```

For factual claims, prefer official docs, API references, README files, changelogs, or runtime/API results over third-party summaries.

## Copy prompt

Copy this prompt into an agent environment:

```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.
```

## Fallback discovery

Use these only when the targeted docs above are not enough:

* [`llms.txt`](https://aisa.one/docs/llms.txt): docs index for discovering additional AIsa pages.
* [`llms-full.txt`](https://aisa.one/docs/llms-full.txt): full documentation bundle. Do not read it unless the user explicitly asks for full documentation ingestion.