开发者工具链：API、SDK、CLI 与 MCP

读、写、聚合、订阅，都可以从四个入口做：REST API、语义 SDK、aidc 命令行，以及留给智能体的那一扇（Agent Key 与 MCP）。这门课按入口逐个讲：v2 响应与 v1 信封、分页和错误怎么读，SDK 的对象集怎么写，命令行的退出码怎么用，智能体能做什么、不能做什么。最后讲怎样订阅变化，怎样把本体写成文件、试跑并放进持续集成。每一节都在示例工厂上动手。

6 节课 约 48 分钟 18 道小测 进阶
开始学习 →

学完你将能够

  • 读懂本体（Ontology）的 v2 与兼容 v1 路径、响应、分页和错误，写出一个完整读请求
  • 用语义 SDK 写出对象集查询和聚合，并用先校验再执行的方式调用 Action
  • 用 aidc 命令行读、查、改，并按退出码写出可以放心重试的脚本
  • 为智能体设计入口：用「权限 ∩ 限制」算出它能做什么，并说清 AIDC 今天开放了什么
  • 用订阅做实时视图，把本体写成文件、试跑，并放进持续集成

课程安排

  1. 第 1 课·约 8 分钟REST API：形状、分页与错误区分 v2 原生响应与兼容 v1 信封，用 pageToken 翻页，按错误版本判断下一步。
  2. 第 2 课·约 7 分钟语义 SDK：读、写、聚合对象集是链式的描述，最后才取数据；聚合的结果有固定形状；Action 先只校验，再执行。
  3. 第 3 课·约 8 分钟aidc CLI读、查、改、建都有命令；输出是干净的 JSON，进度在 stderr，退出码告诉脚本下一步该做什么。
  4. 第 4 课·约 8 分钟给智能体的入口：Agent Key 与 MCP智能体能做的事 = 它代表的人或服务的权限 ∩ 这把 Key 的限制；AIDC 今天开放了什么，目前还没有什么。
  5. 第 5 课·约 8 分钟实时订阅先查后订，靠序号续传，不丢不重；连接是要占计算分钟的，所以只给有人在看的界面。
  6. 第 6 课·约 9 分钟Ontology 即代码与测试定义写成目录里的文件；在文件、分支、合并后三个层次各试一次；把检查放进流水线。

完成徽章

读完全部课时并标记完成，你的徽章会出现在这里。