应用:给智能体用,也给人用

第 4 课 · 共 7 课 约 7 分钟

一组 Skills 加一组 APIs,界面可选:复制一句话给智能体就能用。

本课目标

读完这一课,你将能够

  • 说出应用由什么组成:Skills、APIs,界面可选
  • 按「谁来用、人要不要看」选出应用的形态
  • 说出智能体怎样用起一个应用,以及应用从 Developer 到 Nexus 的路

应用是什么

应用是发布在 Nexus 上、智能体和人都能用的一组能力:一组 Skills 加一组 APIs,界面可选。 这个定义照的是 OpenAI 对插件(Plugin)的定义:装上一个插件,智能体就多会一件事;发布一个应用,公司的智能体和同事就多了一样能用的工具。

SKILLS

Skills

写给智能体的做法:什么时候用、按什么步骤、调哪些 API、输出什么、哪些事不能做。一条 Skill 就是一份 SKILL.md。

APIS

APIs

应用对外提供的查询、读取、动作与工作流运行。智能体、程序和命令行走同一个入口。

UI · OPTIONAL

界面(可选)

给人看、比较、确认的页面。它只调同一套 API:界面能做的,智能体也能做。

应用的三条老规矩没变:不用安装、不存数据、不自己干活。 智能体读一份说明就会用;数据在公司的语义层,删掉应用,数据还在;没有人、也没有智能体来用它的时候,它什么都不做——自己反复做事的是 Loop。

四种形态,先做最小的

Skills、APIs、界面不必样样都有。按谁来用、人要不要看,选最小的形态;以后再加 API 或界面,应用的用途不变。

什么时候用例子
只有 Skills做法加上现成的 AIDC 能力,就能把事做完瑕疵检测:教智能体用视觉能力检查照片
只有 APIsAPI 自己说得清,不需要额外的流程设计部门对外提供初始材料清单
Skills + APIsSkill 带智能体走一套流程,用本应用的 API报价:先预演,给人看过再确认
APIs + 界面人要看、比较、编辑、确认生产看板、审批台

复制一句话,智能体就会用

每个应用都有一张平台生成的应用页:调用方法、介绍(输入输出、执行什么任务)、Skills & APIs、Information。右上角的「复制给智能体」,复制的是一句话加一个地址:

帮我用 AIDC 应用「报价工作流」:https://www.ai-dc.ai/nexus/cell-aidc/apps/quote-workflow/about.md
  1. 01贴给智能体Adis、Claude Code 或 Codex
  2. 02读说明APIs、Skills 全文、示例说法与规矩
  3. 03先预演写入先预演,把结果给你看
  4. 04确认执行执行动作、留痕,记下是谁调的

智能体调 API 时,身份是「这个应用 × 你的角色」:你不能做的事,它替你也做不了。程序也能直接调:命令行用 aidc app call,也可以走 HTTP;公司的每个应用还自带一个 MCP 服务器,工具就是它的 APIs。

从 Developer 到 Nexus

应用在 Developer 里做和测,在 Nexus 上用。同一个版本包先进 test 通道:打开它的应用页,复制给智能体试一试;确认之后原样发布到 Nexus,出现在公司的应用目录里,同事打开应用页、复制给自己的智能体就能用。发布不重新打包,线上出了问题,可以退回上一个测过的版本。

aidc app init site-check --template skills
aidc app deploy site-check
aidc app publish site-check

看完之后,还要不要人去别的系统手工处理?

找下一个该做的应用,就问这一句。要的话,这件事就该有一个能写入的应用:智能体照 Skill 替人办,人也能在界面上直接改。最后一课,我们动手做一个。

要点

  • 应用是发布在 Nexus 上、智能体和人都能用的一组能力:Skills 加 APIs,界面可选。
  • 应用不用安装、不存数据、不自己干活;只读的看板也是应用。
  • 先做最小的形态:只有 Skills、只有 APIs、Skills + APIs、APIs + 界面。
  • 复制一句话给智能体就能用;写入先预演,身份是「应用 × 你的角色」。
  • 在 Developer 里做和测,测过的版本原样发布到 Nexus。

练一练

找出下一个应用

从看完还要手工处理的报告里找。

列出三份看完还要去别的系统手工处理的报告,写下每次要花多久。

小测

选一个答案,马上看解析。

Q1按 AIDC 的标准,一个应用由什么组成?

Q2一个应用只有一条 Skill:教智能体用现成的视觉能力检查现场照片。它算不算应用?

Q3同事把应用页复制的那句话贴给智能体,让它给一张询价单报价。智能体第一次写入时应该怎么做?

延伸阅读