Skip to main content
在自己开发 agent 而不是使用现成的运行时?AIsa 从两个层面接入:OpenAI 兼容(以及 Anthropic 兼容)的模型 endpoint 用于推理,加一份指令文件让你的 agent 掌握完整的 AIsa capability layer。 AIsa endpoint:

前置条件

开始前,请确认你已经具备:
  • AIsa API key(console.aisa.one/api-keys
  • 一个 agent 代码库——任何能调用 OpenAI 或 Anthropic API 的语言或框架

1. 把 Agent 的 LLM 调用指向 AIsa

把 key 放在环境变量中:
同一个 key 可以调用模型目录中的所有模型——换一个 model 字符串就能切换厂商,不需要新的 SDK 或 key。Agent 框架(LangChain、Vercel AI SDK、LlamaIndex 等)同理:把 OpenAI 兼容 base URL 设为 https://api.aisa.one/v1 即可。

2. 让 Agent 掌握 AIsa 能力层

AIsa 把面向 agent 的说明——endpoints、Skills 和使用规则——发布为一个 markdown 文件:
两种用法:
  • 写入 System prompt:启动时抓取该文件,放进 agent 的 system prompt 或工具上下文,让它知道如何调用 AIsa 的搜索、数据和媒体 API。
  • 按需读取:如果你的 agent 能浏览或抓取 URL,直接给它标准设置 prompt:
端到端试一下:

快速参考

故障排查

相关页面

Agent 快速开始

本教程所基于的面向 agent 的指令文件。

认证

API key 创建、轮换和存储最佳实践。

模型目录

你的 agent 可调用的所有模型 ID、上下文窗口和 endpoint。