面向 AI Agent

把 MIA GEO 接入你的 Agent

这里只有接入入口；完整且唯一的接口合同由 /llms.txt 与 /skill.md 同源提供。

1让 Agent 直接读取合同

把下面一句交给 Agent。它会从 canonical 文档了解当前端点、字段、模型、限制、计费与异步轮询规则；模型缺少真实 provider 时会明确标记不可用，不会伪装成 0 分或静默启用 mock。

读取 __BASE__/llms.txt，严格按其中最新合同使用 MIA GEO；执行会产生费用的操作前先向我确认规模。

查看 llms.txt →

2选择身份凭证

个人 Agent：PAT

个人 PAT 以本人身份调用项目 API 与 Skill API，不需要代客请求头。首次请求会根据中台验证的 User 与 Account 自动完成 GEO 后台初始化，不需要先登录 GEO。

Authorization: Bearer mia_pat_...

系统集成：平台密钥

平台密钥必须声明 opaque 终端用户与 Platform Account；服务端经 MIA 中台 introspect 校验，并按该权威身份做资源隔离与计费归因。首次请求会自动完成 GEO 后台初始化；Account 映射冲突绝不迁移或回退。

Authorization: Bearer mia_pk_...
X-On-Behalf-Of-User: <opaque Platform User ID>
X-On-Behalf-Of-Account: <immutable Platform Account ID>

Retired static Skill credentials are no longer accepted by any Agent API. Use an account-bound PAT or delegated Platform Key above. See the canonical contract for exact errors.

3安装为 Skill

/skill.md 是 canonical 文档的运行时派生下载版；部署域名会自动注入，不另维护副本。

mkdir -p ~/.claude/skills/mia-geo
curl -fsS __BASE__/skill.md -o ~/.claude/skills/mia-geo/SKILL.md

↓ 下载 Skill 打开工作台 →

PAT 和平台密钥可调用用户拥有的 GEO 项目 API；报告可读取版本化 JSON，也可在线查看与 PDF 同模板的 HTML，并导出 PPTX / PDF / XLSX。只有 OIDC 登录/回调与 /app 页面本身是浏览器流程。Admin API 仍要求真实 admin 角色并显式带 X-MIA-Admin-Mode: 1。