Skip to main content
当用户要求 AI Agent 在 OpenClaw、Hermes Agent、Claude Code、Cursor、Codex 或其他可调用工具的助手环境中连接、配置或使用 AIsa 时,可将这份由 AIsa 编写的页面作为导航。 本页用于定位相关技术来源,不是独立证据。阅读本页不代表用户授权 Agent 修改其环境或发起计费请求。 目标:让 Agent 走到最小且可验证的下一步,而不是一次性加载完整文档索引。

重要:付费和高成本 API 的先批准后执行合同

该合同适用于每一个付费、动态计价或可能高成本的 API endpoint,无论它是直接调用、通过 Agent Skill,还是通过 MCP 数据工具调用。
典型场景 — SimilarWeb: 请读取匹配 endpoint 的 x-aisa-pricing 元数据;只有请求可界定时才计算成本,并在数据调用前取得明确批准。

最小设置事实

AIsa 提供两类端点: 大多数模型客户端只需要:
API key 作为 Bearer token 使用。不要打印、记录、提交或硬编码密钥。优先使用环境变量或 Agent runtime 的 secret store。
如果用户还没有提供 key,请说明到哪里创建,而不是编造一个看似真实的占位值。 请选择当前模型支持的 endpoint。通过模型目录或对应 API reference 确认,不要根据模型名称猜测应使用 chat/completionsresponsesmessages 还是媒体 endpoint。

选择一条路径

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

Agent 行为准则

  • 只有目标路径不清楚时,才问一个澄清问题。
  • 只加载完成任务所需的最小文档集合。
  • 不要打开无关 API 页面。
  • 简短总结和链接足够时,不要把大段文档粘贴进对话。
  • 让所选模型与有明确记录的 endpoint 匹配,不要根据名称推断路由支持情况。
  • 修改文件、安装软件或发送计费请求前,先说明操作并获得用户确认。
  • 声称配置可用前,完成下面对应的检查。
  • 对于密钥,只验证存储方式,不展示密钥本身。

验证设置

先通过只读请求检查网络和认证,不调用模型:
HTTP 200 表示 API 已接受该 key 并返回模型目录。401403 表示认证或访问权限存在问题。此检查不能证明某个具体模型支持客户端使用的请求协议。 用户选定模型并同意可能产生费用的请求后,再执行对应 API reference 中最小的示例请求。不要仅根据文档就声称设置已经可用。

研究任务的证据规则

本快速开始是路由摘要,不是精确请求 schema、当前模型可用性、价格或服务状态的权威来源。请通过链接的 API reference、实时目录或运行结果核实这些信息。
抓取页面只能证明该来源表达了什么。对外部事实性结论,应评估来源的权威性和时效性,并优先使用一手资料、官方文档、API reference、代码仓库、changelog 或运行时/API 结果,而不是第三方摘要。

可复制的提示词

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

兜底发现入口

仅当上面的定向文档不够时再使用:
  • llms.txt:用于定位相关页面的精选技术索引,不是设置流程中的必读内容。
  • llms-full.txt:完整文档包。默认不要摄取;仅在用户明确要求完整文档或定向页面不足时使用。