面向 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_...

专用 Product-to-Product 接口

MIA Platform Key 只用于明确列出的 /api/v1/mia/dashboard/* Account 拉取接口和 GEO 自身出站调用，不能访问普通客户资源 API。发起人 ID 仅是可选审计字段，不产生人类资源 owner 权限。

Authorization: Bearer mia_pk_...
MIA-Account-Id: <immutable Platform Account ID>
MIA-Initiated-By-User-Id: <optional immutable initiating User ID>

普通 Agent 与客户资源 API 使用 Account-bound PAT；浏览器使用 OIDC session。Retired static Skill credentials 不再接受。

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；mia_pk 不能访问这些 human-owned routes。报告可读取版本化 JSON，也可在线查看与 PDF 同模板的 HTML，并导出 PPTX / PDF / XLSX。只有 OIDC 登录/回调与 /app 页面本身是浏览器流程。Admin API 仍要求真实 admin 角色并显式带 X-MIA-Admin-Mode: 1。