动手：做一个会执行的 Action

前面的课讲清了 Action 是什么，这一门带你真做一个。在你自己的公司里，用 Semantic SDK 一步步做出「座位申请」：先登记客户，再让申请经过提交、批准、拒绝，提交条件逐条把关，批准时在一个事务里改两个对象；然后从命令行、SDK 和 REST 调它，做成 Nexus 应用给人点、给智能体用，最后交给自动化，50 座以内的申请自己批准。每一步都对照 Demo Company 里做好的成品，随时可以点过去看。

7 节课 约 53 分钟 21 道小测 进阶
开始学习 →

学完你将能够

  • 写出带参数、规则、提交条件和日志的 Action 定义，用 define 和 publish 放进你公司的 Semantic
  • 用「只校验」和「执行」两步跑它，读懂逐项结果、改动清单和操作编号
  • 用提交条件、角色和参数限制把该拦的拦在入口，让一个 Action 在一个事务里改两个对象
  • 从命令行、SDK 和 REST 调同一个 Action，按状态码处理出错
  • 把它做成 Nexus 应用（界面加 Skills）和自动化，说清 writeback webhook 什么时候用

配套材料

DEMO座位申请台Demo Company 里做好的应用：提交、批准、拒绝，先校验再执行，实时更新。DEMOAction：批准座位申请在 /semantic 里看它的定义：参数、两条规则、四条提交条件、谁能执行。DEMO对象：座位申请Object Explorer 里的座位申请：每个属性、每次修改，还能沿链接走到公司。DOCS文档：语义 SDKAction 的定义、提交条件、writeback webhook 和 REST 路径的完整写法。DOCS文档：aidc 命令行define、publish、apply、app deploy 每条命令的参数和退出码。SOURCE样板应用与源码本课用到的定义、灌数脚本和两个应用在哪个目录、怎么灌进你的公司。

课程安排

  1. 第 1 课·约 8 分钟先看成品：什么叫「会执行」一次点击，平台做哪五件事；我们要做的座位申请长什么样；先去 Demo Company 看成品，再把命令行准备好。
  2. 第 2 课·约 7 分钟打地基：让 Action 有东西可改写两个 Value Type 和两个对象类型、一条链接，dry-run 检查、define 落库、publish 出版本；拼错的字段会被当场拒收。
  3. 第 3 课·约 6 分钟第一个 Action：新建一个对象参数、规则、日志三样东西；先只校验、再执行；读懂逐项结果和改动清单；到 Action Log 和编辑历史里找到这一次。
  4. 第 4 课·约 8 分钟让它守规矩：提交条件与一个事务提交、批准、拒绝三个 Action：提交条件逐条把关，批准时在一个事务里改两个对象，角色决定谁能做。
  5. 第 5 课·约 6 分钟从代码里调它：命令行、SDK、REST同一个 Action 的三种调法；校验不通过时抛什么、状态码怎么读；批量一个事务；把结果读回来。
  6. 第 6 课·约 8 分钟做成应用：界面给人点，Skills 给智能体用用 Nexus 应用把 Action 接给人和智能体：清单登记、先校验后执行的界面、谁能点、发布、复制给智能体。
  7. 第 7 课·约 10 分钟让它自己动，再伸向外面自动化在数据一变时执行 Action，策略写在提交条件里；要真的改外部系统，就给 Action 配 writeback webhook；上线前的检查单。

完成徽章

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