跳到主要内容

数字员工与 AGENT 集成

SkillFlaw 当前的产品方向并不止于工作流编辑。 它正在走向一个受治理的平台：把可复用的业务能力沉淀为 Skill，再由数字员工与外部 AGENT 系统消费这些 Skill。

在这个模型里：

  • 管理层负责租户、权限与运行边界
  • 资源层提供模型、组件、知识库、MCP 服务、插件与变量等可复用资源
  • 业务层装配项目与工作流，形成可执行业务能力
  • 技能层把这些业务能力封装为可发现、可读取、可交付、可执行的受治理 Skill

SkillFlaw 业务架构

为什么需要 skillflaw-cli​

skillflaw-cli 是当前仓库中已经落地的命令行入口，用于在产品 UI 之外访问受治理的 Skill 与 Workflow 能力。

它聚焦四类结果：

  1. 在 My Skills 树中发现正确节点
  2. 获取某个业务能力对应的 Skill 内容
  3. 在需要时保存 markdown 与附件型交付物
  4. 使用显式 JSON payload 执行在线 Workflow

因此，它正好位于 SkillFlaw 技能层与外部运行时之间，适合连接：

  • 企业数字员工
  • 外部 AGENT 框架
  • 编排服务
  • 自动化 Worker 与集成流水线

当前 CLI 支持什么​

基于当前实现，CLI 提供以下命令组：

命令组作用典型用途
config初始化、更新、查看 CLI 配置设置 base URL、API key 与语言
skilltree遍历 My Skills 层级树找到准确的租户、业务域、项目、Skill 或 Workflow 节点
fetch_skill直接展示 Skill markdown 或保存本地交付物把业务 Skill 引入 AGENT，或导出附件型交付物
run_flow执行项目内绑定的在线 Workflow从数字员工或 AGENT 触发业务流程
cache仅有占位骨架当前不是实际缓存失效能力

配置​

CLI 的本地配置文件位于 ~/.skillflaw/my-skills-cli.json。 根据当前实现，可以确认它具备这些默认行为：

  • 默认 base URL：http://127.0.0.1:7860
  • 请求语言由 skillLang 决定
  • API-key 模式通过 x-api-key 发送密钥

常用配置命令如下：


_10
skillflaw-cli config show
_10
skillflaw-cli config init --base-url <baseUrl> --api-key <apiKey> --skill-lang zh --lang zh-CN
_10
skillflaw-cli config set --api-key <apiKey>
_10
skillflaw-cli config set --base-url <baseUrl>

标准集成流程​

1. 先发现业务节点​

Skill 与 Workflow 都挂在真实项目对象之下。 如果当前没有可信标识符，必须先从树开始：


_10
skillflaw-cli skilltree root
_10
skillflaw-cli skilltree children --node <node>

这一步用于定位具体的租户、业务域、项目、Workflow 或 Skill 节点。

2. 获取 Skill 作为业务契约​

当数字员工或 AGENT 需要受治理的业务指令时，优先直接获取 Skill markdown；如果需要文件，再保存到本地：


_10
skillflaw-cli fetch_skill --node <node>
_10
skillflaw-cli fetch_skill --node <node> --output ./artifacts/business-skill.md

这是把 SkillFlaw 中的业务 Skill 带入外部运行时的最直接方式。 读取出的 markdown 可以作为：

  • AGENT 的业务操作说明
  • 已审阅的业务提示词或制度文本
  • 平台团队与自动化团队之间的可审计交接物

3. 需要文件交付物时再保存​

如果下游系统需要文件而不是内联 markdown，可以通过 fetch_skill 保存交付物：


_10
skillflaw-cli fetch_skill --node <node> --output ./artifacts/business-skill.md

如果目标是附件型项目 Skill，CLI 会同时保存 markdown 文件，以及一个同 basename 的 .zip 交付包。

4. 执行受治理 Workflow​

当业务节点已确认、输入 payload 已准备好后，再执行流程：


_10
skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --payload '{"ticket_id":"T-1001"}'
_10
skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --file ./payload.json

这样，数字员工或 AGENT 就可以调用受治理的业务流程，而不是绕开 SkillFlaw 的封装与交付模型。

数字员工与 AGENT 如何通过 Skill 对接​

结合当前仓库语义，推荐以下三种对接方式：

模式 A：把 Skill 读取为受治理的操作契约​

当外部 AGENT 在推理或规划前需要获取最新业务规则时，使用 fetch_skill。

适用场景包括：

  • 人事数字员工
  • 报销助手
  • 采购或审批 AGENT
  • 客服编排 Worker

模式 B：把 Skill 保存或下载到消费侧运行时​

当下游系统需要本地文件交付物时，使用 fetch_skill --output ...，适合：

  • 打包交付
  • 人工审核
  • 离线处理
  • 同步到其他自动化环境或代码仓库

模式 C：发现后直接执行 Workflow​

当外部系统不仅要读取指令，还要直接触发业务过程时，使用 run_flow。

适用场景包括：

  • 提交审批
  • 合同审核流程触发
  • 报销校验
  • 项目级业务自动化

推荐操作顺序​

除非当前已经拿到全部可信标识符与配置值，否则建议按以下顺序执行：

  1. 使用 config show 查看当前 CLI 状态
  2. 如果目标能力需要 API-key，先通过 config init 或 config set 写入配置
  3. 通过 skilltree root 与 skilltree children 发现目标节点
  4. 使用 fetch_skill 获取 Skill 内容
  5. 只有在需要文件交付物时才使用 fetch_skill --output ... 保存本地文件
  6. 在目标节点或 flow 已确认后，再用 run_flow 执行流程

随 CLI 分发的 Skill 模板规则​

CLI 随附了一份 Skill 模板，用来约束真实企业业务任务的调用方式。 其中最关键的规则是：

  • 禁止猜测 nodeId、projectId、skillId、flowId
  • 禁止绕过 CLI，自己拼接 HTTP 请求
  • 必须先发现节点，再读取、保存、下载或执行
  • 缺少 apiKey、baseUrl、标识符或合法 JSON payload 时，必须停止并报缺
  • cache clear 目前只能视为占位命令，不能当作真实缓存失效能力
查看模板关键摘录

当任务属于真实企业业务任务，并且需要访问既有 SkillFlaw Skill 或 Workflow 时，集成必须通过 skillflaw-cli 完成发现与执行。

集成必须先通过树定位目标节点，再继续执行 fetch_skill 或 run_flow。

禁止猜测标识符，禁止绕过 CLI 直接调用后端接口，禁止在前提缺失时继续执行。

示例：数字员工接入一个业务 Skill​

一个典型的端到端流程如下：


_10
skillflaw-cli config show
_10
skillflaw-cli config set --api-key <apiKey>
_10
skillflaw-cli skilltree root
_10
skillflaw-cli skilltree children --node <tenantNodeId>
_10
skillflaw-cli skilltree children --node <businessNodeId>
_10
skillflaw-cli skilltree children --node <projectNodeId>
_10
skillflaw-cli fetch_skill --node <skillNodeId>
_10
skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --payload '{"employee_id":"E1001","action":"submit"}'

在这个序列里，数字员工会：

  • 先完成 SkillFlaw 认证
  • 再发现受治理的业务上下文
  • 然后读取业务 Skill 作为操作契约
  • 最后携带显式输入执行受治理 Workflow

相关页面​