# 智能体接入

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

## 1. 读文档

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

## 2. 拿凭证

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

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

## 3. 调模型：OpenAI 兼容

```python
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：

```yaml
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 应用的标准循环：

```bash
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](cli.md)）；发布是幂等的，出错直接重试。

## 规划中

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