智能体接入

AIDC Developer 为智能体（Claude Code、Codex、AIDH / Hermes、LangChain 或任何自研框架）准备的接入方式——全部是行业已有的标准，不需要安装 AIDC 专用插件。

1. 读文档

文件	用途
`/developer/llms.txt`	文档索引（llms.txt 约定）
`/developer/docs/<页>.md`	每页的 Markdown 原文，`curl` 即可读
`/developer/skills/aidc-sdk/SKILL.md`	Agent Skills 格式的操作手册，放进智能体的 skills 目录即可
`/developer/openapi.json`	Developer 与模型 API 的 OpenAPI 3.1 契约
`/developer/schemas/aidc.app.schema.json`	应用清单 JSON Schema

2. 拿凭证

aidc login --no-wait --json      # 输出授权链接，交给人在浏览器里批准
aidc login --continue --json     # 批准后完成登录

无人值守：设置环境变量 AIDC_API_KEY=aidc-dk-…。开发者 Key 代表一家公司，用量记在这家公司。

3. 调模型：OpenAI 兼容

from openai import OpenAI
client = OpenAI(base_url="https://www.ai-dc.ai/api/v1/models", api_key=os.environ["AIDC_API_KEY"])

在 Hermes / AIDH 的配置里，同样只需一个 OpenAI 兼容的 provider：

model:
  provider: custom
  base_url: https://www.ai-dc.ai/api/v1/models
  default: deepseek-flash

4. 调智能体：OpenAI 兼容 Agent API

https://api.ai-dc.ai/v1/chat/completions，Authorization: Bearer aidc-sk-…（Agent Key），model 是智能体；用 session_id 续接会话。这是 AIDC 智能体对外的唯一执行接口，Adis 用的也是它。

5. 做应用：CLI

智能体开发 Nexus 应用的标准循环：

aidc app init my-app --template camera --json
# …编辑文件…
aidc app check my-app --json          # 本地校验（与服务端同一份契约）
aidc app deploy my-app --json         # → test 通道，返回 Developer 预览地址
aidc app publish my-app --json        # → production，返回 Nexus 地址

所有命令非交互、JSON 输出、退出码稳定（见 CLI）；发布是幂等的，出错直接重试。

规划中

MCP：把 OpenAPI 投影成 MCP 工具。
A2A Agent Card：等身份层定稿。

本页由 developer/docs/agents.md 生成 · Markdown 原文 · llms.txt