ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Flue四大操作类型详解:prompt、skill、task与shell的区别

Flue四大操作类型详解:prompt、skill、task与shell的区别 Flue四大操作类型详解prompt、skill、task与shell的区别【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flueFlue是一个开源的 Agent 框架sandbox agent framework让你用 TypeScript 构建真正自主的智能体。在 Flue 的运行时中驱动 Agent 干活的有四大操作类型prompt、skill、task 和 shell。搞不清它们各自负责什么是新手最容易踩坑的地方。本文用 5 分钟带你彻底搞懂它们的区别与适用场景。一张表看懂四大操作类型速览先上结论四个操作各有分工操作一句话定位会记录到对话历史吗典型场景prompt(text)用文字指令直接驱动模型对话✅ 会日常问答、总结、推理skill(name)加载预置技能包执行专业流程✅ 会复用的标准化专业流程task(text)把工作委派给子会话子 Agent✅ 保留子会话历史长任务、专业角色分工shell(cmd)在沙箱里直接执行命令✅ 记录命令交互构建、测试、跑脚本它们在运行时的定义见 session.ts类型声明见 types.ts。1️⃣ prompt最直接的对话驱动prompt(text)是四个操作里最基础的一个把一段文字指令发给模型让它基于当前会话上下文回答或推理。它的两个亮点支持结构化输出通过options.result传入校验 schema要求模型返回经过验证的结构化数据而不是自由文本会话是连续的同一会话里连续调用prompt后一次能看到前一次建立的内容上下文不会丢。官方文档在 agent-api.md 中对它的描述是Run a model operation with a text instruction.适合一问一答式的交互、需要模型想清楚再回答的场景。2️⃣ skill把专业能力装进技能包skill()执行的不是一句指令而是一个预定义好的技能包。技能通常是一个SKILL.md文件含 frontmatter 元数据 Markdown 正文在 Agent 定义阶段用useSkill()挂载运行时需要时通过session.skill(技能名)激活技能正文才会在激活时载入上下文。它的核心价值是复用与封装把如何退款如何排障这类专业流程写成技能包任何 Agent 都能挂载使用而不必把长指令塞进每次对话。技能的编写方式详见 skills.md。适合团队沉淀的标准流程、跨多个 Agent 共享的专业知识。3️⃣ task把工作委派给子 Agenttask(text)是四个操作中最高级的一个它会把工作委派给一个独立的子会话detached child session。通过options.agent可以指定具名的子 Agentsubagent每个子 Agent 拥有自己的角色与工具集子会话的历史会被持久化并保留在父会话的对话拓扑中随时可查——这保证了委派不是黑盒。打个比方prompt是你自己干task是派给下属干干完汇报。这种能力特别适合长任务拆解——比如复现 Bug → 诊断根因 → 写报告流水线每一步都可以委派给不同角色的子 Agent。子 Agent 机制详见 subagents.md。4️⃣ shell在沙箱里直接跑命令shell(command)会在 Agent 的沙箱环境中执行一条 shell 命令并把这次命令交互记录进对话状态——模型因此知道自己刚才执行了什么、输出是什么。两点补充沙箱是 Flue 的核心设计它给 Agent 提供了一个安全的环境去修改文件、运行真实工作详见 sandboxes.md注意区分session.fs文件读写 API它不会被记录到对话记录中而shell()会。需要让模型看到命令过程时用shell()只是程序化读写文件时用fs。适合构建、测试、跑脚本等确定性操作省去让模型推理命令输出的开销。共同点所有操作都返回可取消的 CallHandle四个操作返回的都是CallHandleT——一个可 await 的 Promise 句柄定义见 types.ts它带来三个统一行为可取消调用handle.abort()会以标准AbortError中断prompt()中断时还会拆掉正在执行的 bash 工具命令可合并外部信号通过options.signal传入例如AbortSignal.timeout(5000)实现超时控制事件统一每次操作都会发出operation_start/operation_end事件operationKind字段取值为prompt | skill | task | shell外加compact方便你用 OpenTelemetry、Sentry 等做可观测性事件协议见 events.md。⚠️ 一个容易踩的坑一个会话同一时刻只能执行一个操作。在有操作进行中时再发起新的prompt/skill/task/shell调用会直接抛错需要并行分支请开多个会话。怎么选30 秒决策指南按场景对号入座你的需求选它让模型回答问题、做推理prompt执行一段沉淀好的专业流程skill长任务拆解、委派专业角色task在沙箱里跑一条命令shell只是程序化读写文件不想留痕session.fs不算四大操作一句话总结prompt 说话、skill 加载专业剧本、task 委派子 Agent、shell 动手跑命令。理解了这个分工你就能在 Flue 中把自主性和确定性恰到好处地组合起来。更多 API 细节可参阅官方参考 reference/agent-api.md。【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表