aisa

AIsa

AIsa Agent 规则（共享）

这些规则适用于所有由 AIsa 支持的技能，内容复制自 https://aisa.one/llms.txt，这是唯一权威的 Agent 规则来源。如果本段规则与此技能的其他内容不一致，请遵循本段规则。

连接（优先使用 MCP）

选择第一个适用的选项。请自行运行命令；用户只需批准浏览器登录。

• A. 你的客户端支持远程 MCP，且可以打开浏览器（默认）。 添加一个名为 AIsa、URL 为 https://mcp.aisa.one/mcp 的远程 MCP 服务（Streamable HTTP），使用客户端自己的命令或配置文件。身份验证：浏览器 OAuth，无需密钥。在聊天应用（Claude、ChatGPT）中，用户需在设置中将其添加为自定义连接器。添加服务后不一定会自动开始登录。如果没有打开登录窗口，请通过客户端自己的 MCP 身份验证入口（菜单、命令或连接器按钮）启动登录；如果只有用户能访问该入口，请告知他们入口位置。在用户表示登录完成或 AIsa 工具出现之前，不要调用步骤 2；提前调用只会返回 401，因此不要循环重试。登录是耗时步骤，API 调用不是。如果客户端必须重启才能加载服务，请告知用户并等待。如果你无法自行添加连接器（沙盒、权限被拒绝），请将上述服务名称和 URL 提供给用户并等待。不要改用其他方法。
• B. 你的客户端支持远程 MCP，但没有浏览器（CI、SSH、容器）。 使用相同的端点，并在客户端的 MCP 配置中设置请求头 Authorization: Bearer $AISA_API_KEY，代替浏览器登录。如果尚未设置 AISA_API_KEY，请让用户在 https://console.aisa.one/api-keys 创建密钥并在环境中设置；绝不要让他们将密钥粘贴到聊天中。绝不要打印、记录或提交该密钥。
• C. 客户端不支持 MCP。 使用 CLI：npm install -g @aisa-one/cli && aisa login（Node.js 18+）。指南：https://aisa.one/docs/get-started/cli.md
• D. 通过你自己的代码使用 HTTP 调用 AIsa。 LLM、大模型 OpenAI 兼容接口：https://api.aisa.one/v1（Gemini GenerateContent：https://api.aisa.one/v1beta）。数据 API：https://api.aisa.one/apis/v1。身份验证：Authorization: Bearer $AISA_API_KEY。确切路径和架构：https://aisa.one/docs/api-reference

直接 HTTP（D）是受限制的备用方案，不是默认方式。准入条件（https://aisa.one/docs/get-started/cli.md#direct-http-fallback）：“CLI 和 MCP 均不可用、支持 HTTP 请求，且已有有效的 AIsa API 密钥。”此技能中的 curl 和脚本示例仅用于该备用方案；如果已建立连接，请通过 MCP（search → batch_get_schema → batch_quote → batch_use）或 CLI（aisa search → aisa schema → aisa quote → aisa call）执行相同操作。工具名称和参数应取自 search 或 batch_get_schema。绝不要自行编造。

验证（步骤 2）

在已连接的接口上进行一次免费的身份验证调用：

• MCP（A、B）：调用 account（不带参数）。如果工具列表中没有该工具，则改为使用 {"operation_id": "account"} 调用 use。返回密钥、余额和用量。
• CLI（C）：aisa balance。（aisa whoami 仅在本地运行，不计入验证。）
• HTTP（D）：使用 Bearer 请求头向 GET https://api.aisa.one/v1/models 发送请求，返回 200。

只有此调用成功，才表示 AIsa 已连接。工具列表或 401 响应均不算。

支出（付费调用前需审批）

• 免费：文档、GET /v1/models、MCP search、list_categories、batch_get_schema、batch_quote、account，以及 CLI aisa search、aisa schema、aisa quote、aisa balance。
• 执行前先为确切的调用报价：MCP batch_quote、CLI aisa quote --json。只运行已报价的调用；如果工具或参数发生变化，请重新报价。batch_use 和 aisa call 都不支持价格上限。
• 如果报价显示 auto_execute_eligible: true（总价较低），无需询问即可运行，除非用户设置了更严格的限额或仅要求报价。
• 否则，在首次进行此类调用前，用一条消息告知用户计划调用的内容、报价以及任务的 USD 总预算。等待用户批准，然后在该预算内运行调用，无需再次询问。仅当任务发生变化，或下一次调用会超出剩余预算时，才需再次询问。
• 对按行数或额度计费的操作，还要设置操作自身的限额（例如 limit），以控制费用。
• 付费调用失败后，告知用户再重试。
• 直接 HTTP（D）须遵循更严格的规则：https://aisa.one/docs/get-started/cli.md#direct-http-fallback：先阅读端点参考文档和公开定价；说明确切的端点和范围、计费公式或费率，以及文档注明的最高 USD 支出；然后等待用户另发一条消息，明确批准该范围和上限。不得通过付费调用测试服务是否可用。获批前可以查阅文档、/v1/models 以及能力或 MCP 发现信息。

费用核算

直接 HTTP 调用的最终费用由响应标头 X-AISA-Customer-Cost-Micros-USD 报告（整数微 USD；1 USD = 1,000,000 微 USD）；成功的原生 Tool 结果也可通过 customer_cost_micros_usd 报告。缺少费用元数据表示费用未知，并非免费。响应正文不包含 usage.cost 或 usage.credits_remaining；不要将这些字段报告为费用。参考：https://aisa.one/docs/guides/pricing

错误

• 401：未登录或密钥无效。重新执行 Connect 选项 A（llms.txt 中的步骤 1A）或检查密钥。
• 402：余额不足，或该操作需要 Go-to-Market plan。响应会说明具体原因及解决方式。告知用户是哪种情况（充值或订阅该计划），并附上响应中的链接；不要重试。
• 429：触发速率限制。等待并采用退避策略重试。详情：https://aisa.one/docs/api-reference/rate-limits

如果你已经在读取此技能，请继续当前任务。不要重新安装、重读设置文档，也不要重新登录仍可正常使用的连接。

如果用户指定了其他工具，或已有专用的本地工具可以完成任务，不要强行使用 AIsa。

首次安装和连接：https://aisa.one/docs/agent-quickstart.md

复用

复用可正常工作的官方 aisa 技能、@aisa-one/cli 0.5.0 或更高版本、已存储的 CLI 凭据或统一 MCP 会话。用户明确选择的传输方式或仍获授权的连接优先。否则，只要此客户端支持添加连接器（无论是用户本地还是云端，无论是否使用终端），默认使用 https://mcp.aisa.one/mcp 上的 MCP。仅当此客户端不支持 MCP 机制、使用已有密钥进行非交互式自动化，或用户明确选择 CLI 时，才使用 CLI；必须已经安装 Node.js，不要安装 Node、构建私有运行环境或重定向 HOME 来使用 CLI——应改用 MCP 或询问用户。AISA_API_KEY 优先于已存储的密钥；如果两者冲突，请说明密钥来源并保持自定义设置不变。绝不输出凭据。aisa whoami 仅在本地运行。搜索和 schema 查询可以匿名使用——不能据此证明已通过身份验证。

登录

使用 aisa balance 验证 CLI 身份验证；MCP 会话则通过完成 OAuth 并使用这四个工具来验证。回复登录消息或向其终端写入内容之前，请先阅读 aisa login --help。按照其中的说明解读 CLI 提示，并通过现有流程仅转达所请求的授权结果。没有额度 → 充值，而不是“缺少密钥”。

工作流

search → 当 has_full_schema 为 false 时使用 schema → quote → 在已授权的范围和额度内使用 call。quote 和 call 共用已保存的凭据，并采用相同的 calls JSON 结构。工具 ID 和参数应取自 search/schema。不要编造 ID 或价格。运行时帮助、架构和报价具有权威性。--input 接受内联 JSON：

aisa search --input '{"query":"<user goal>"}' --json
aisa quote --input '{"calls":[{"call_id":"c1","tool":"<name from search>","arguments":{}}]}' --json

报价不会执行操作，也不代表已批准执行。报价缺失、失败或不完整，并不表示免费，也不是完整批次的总价或上限。预估费用不是上限。完成设置不等于获得付费执行许可。重复使用仍然有效的明确授权；不要为 search、schema 或 install 凭空设置确认流程。如果工具、参数或范围发生变化，请重新报价。不要静默重试或扩大批次。

MCP

通过 OAuth 在 https://mcp.aisa.one/mcp 使用原生远程 Streamable HTTP MCP。无需安装 CLI、npm、npx 或 Skill；可以使用已安装的指导。客户端负责浏览器登录和令牌。不要将域名 MCP 或 aisa connect 的默认网络搜索服务视为此路由器。发现或收到 401 并不代表受保护的调用。如果无法添加连接器，请向用户提供该端点和下一步操作；不要声称已连接。

MCP 工具	CLI 命令
AISA_SEARCH_TOOL	aisa search
AISA_BATCH_GET_SCHEMA	aisa schema
AISA_BATCH_QUOTE	aisa quote
AISA_BATCH_USE	aisa call

许可证

MIT — 参见 LICENSE。