跳转至

第 5 课：打造专业摄影协同团队 (Lesson 5: Build a Photography Team)

欢迎来到 Griptape Nodes 新手入门系列教程的第五课，也是最后一课！在本篇指南中，我们将把此前学到的提示词工程理念推向全新高度，并引入一系列能提供更强控制精度与结构化编排能力的高阶算子。我们将深入解剖一个精密复杂的多智能体协同系统：让多位专家智能体像现实中的摄制团队一样各司其职、通力合作，最终打磨出一份极具视觉震撼力的生图 Prompt，并在全流程中掌握若干重要的新算子。

本节学习要点

在本篇教程中，我们将：

  • 深入理解规则集 (RuleSets) 的概念与工作机制；
  • 学习工具 (Tools) 扩展智能体能力的机理；
  • 掌握列表参数 (List Parameters) 的聚合与连线交互方式；
  • 领悟将智能体封装转化为工具 (Agents as Tools) 的工业级范式；
  • 通过单一主编排智能体 (Orchestrator) 统筹协调多个作为工具的专家智能体；
  • 依靠专家团队协同创作，生成大师级的生图 Prompt 并完成高质量成图。

返回首页

点击编辑器左上角的 Griptape Nodes 标志返回欢迎首页。

打开专业摄影团队示例模板

在欢迎首页中，找到并点击 "Build a Photography Team"（打造摄影协同团队） 卡片，载入该高阶范例工作流。

Build a Photography Team 示例模板

工作流全局架构概览

模板载入后，你会立刻发现这是我们迄今为止接触到的最具架构规模的工作流：

摄影团队协同工作流全景概览

该工作流由以下几大核心模块精密组合而成：

  • 多个垂直领域的专家智能体 (Specialized Agents)：
    • Cinematographer（电影摄影指导）
    • Color Theorist（色彩理论专家）
    • Detail Enthusiast（细节刻画大师）
    • Image Generation Specialist（生图提示词终审专家）
  • 为各专家配套的专属规则集：RuleSet
  • 汇聚规则集的列表容器：RuleSetList
  • 智能体转工具适配器：AgentToTool
  • 工具集合容器：ToolList
  • 负责总控调度的中央编排智能体：Orchestrator Agent
  • 最终负责成像渲染的视觉生成节点：GenerateImage

请注意：在 ToolList 上游，完全相同的拓扑结构被整整重复了四次。每一组上游流水线在逻辑与结构上 100% 相同，唯一的差异仅仅在于各自绑定的专业规则数据。因此，我们只需要深入剖析其中一条完整的支线，就能彻底掌握全部四个分支的架构精髓：

RuleSet ➔ RuleSetList ➔ Agent ➔ AgentToTool

规则集到智能体再到工具转换的完整拓扑链路

规则集 (RuleSets)

RuleSet 节点用于为智能体立规矩、定规范，精确界定它们在处理任务时必须遵循的行为边界、思考风格与专业准则。

在每个 RuleSet 内部，你可以编排多条规则。每条规则通过显式的物理换行（回车）隔开。无需担心自动换行（Word Wrap）——只要文本是自然排版流动到下一行，它依然被视作同一条规则的一部分。

每个 RuleSet 都需要赋予一个唯一的标识名称，智能体在底层正是通过该名称在多个规则集之间进行检索与区分。当在一个工程中编排多套规则时，赋予语义清晰、独一无二的名称至关重要。

命名最佳实践

虽然在本工作流中每个智能体仅被赋予了一套专属 RuleSet，理论上发生命名冲突的概率为零，但始终保持良好的命名习惯依然是工业级开发的优秀素养。

电影摄影指导规则集

如上图所示，电影摄影指导 (Cinematographer) 的规则集中包含了极其详尽的专业指引，覆盖镜头画幅、光影纵深、构图法（三分法则、对称构图）以及视觉叙事技巧。这些规则在推理时会作为强约束注入提示词上下文，从而规范智能体的专业表现。

为了使输出具有高可预测性，务必确保同一个规则集内部的各项指令逻辑自洽。若给出了自相矛盾或相互冲突的规则，智能体在试图兼顾对立诉求时可能会产生摇摆不定的平庸结果。

规则集列表容器 (RuleSetLists)

RuleSetList 节点扮演着“聚合收集器”的角色（稍后我们将介绍的 ToolList 也是完全相同的容器原理）。它的核心使命十分纯粹：将分散在画布中的多个独立 RuleSet 汇聚打包为一个统一的集合 (Collection)，从而连入智能体上那些专门接收复数列表的参数端口。

在本模板中引入 RuleSetList 主要是为了让你直观理解列表容器类算子的概念。

RuleSetList 节点示意

可选实操小实验：绕过 RuleSetList 直接连线

如果你想亲自验证容器节点的机理并尝试安全地绕过它：

  1. 在 Agent 节点卡片上展开 Advanced Options（高级选项）；
  2. 断开原先从 RuleSetList 连接到该 Agent 的 rulesets 端口的连线；
  3. 断开后 Agent 界面会发生微调，在 rulesets 参数下方会出现 "add item to rulesets"（向规则集添加一项） 的微型按钮。点击它，你会发现长出了一个新的子端口，专门用于接收单一的 RuleSet；
  4. 此时直接将独立 RuleSet 的 ruleset 端口连入这个新出现的子端口即可。

直接连入动态列表端口示意

深入理解 Griptape Nodes 中的工具 (Tools)

工具 (Tools) 是让智能体打破模型自身参数知识局限、与外部真实世界发生交互的桥梁。当面临超出其内置知识库的任务时（例如实时检索互联网行情、执行数学精确计算、调用云端数据库等），工具就提供了强大的扩展通道。

智能体会基于上下文自主推理判断何时该调用工具、自动组装入参请求，并解析工具执行后返回的原始结果。这使得智能体从单纯的静态文本生成器跃迁为能够查库、跑代码、改文件且全程具备逻辑反思能力的真正 AI 智能体。

每个工具在本质上包含两个不可分割的核心要素：

  1. 底层执行代码 (Underlying code)：负责干实事的代码体，既可以是基础算术，也可以是复杂的外部微服务通信；
  2. 工具功能描述 (Description)：这是向大语言模型解释该工具“是干什么的、在什么场景下应该使用它”的自然语言契约。智能体正是完全根据该描述来精准决策是否翻牌调用它。

除了 Calculator 计算器与 DateTime 日期时间等基础工具算子之外，Griptape Nodes 还提供了一个极具颠覆性的工程设计：将智能体自身直接转化为工具 (Agents as Tools)。

工具运作机制概念图

核心进阶：将智能体转化为工具 (AgentToTool)

Griptape Nodes 允许你将一个完整的智能体直接降维封装为一个工具！这意味着一个总控智能体可以将特定的垂直子任务委派给各个专精领域的小模型或特定专家，构建起层级分明的分布式智能体架构。

让每个智能体各安其位、专注深耕其擅长的垂直领域（“专业的人做专业的事”），系统的稳定性和输出质量远比让单一全功能大模型同时兼顾几十种相互冲突的职责要高得多。

这一极其强悍的工程模式由 AgentToTool 转换算子实现：

AgentToTool 转换算子

普通的内建工具通常在代码底层硬编码了功能描述，而将智能体转化为工具时，你需要亲笔编写该工具的 Description 描述。你在此处编写的语义边界与期望说明，将直接指导主编排器理解在何种情境下触发并召集这位专家出场。

工具列表容器 (ToolList)

ToolList 的机制与前文提到的 RuleSetList 完全异曲同工，只是它收集的对象是工具 (Tools)。它负责将多个被 AgentToTool 转换封装完成的专家工具打包为一个工具组，统一注入主编排智能体的 tools 端口。

这种设计是 Griptape Nodes 框架的一贯设计哲学——“List”类节点充当拓扑汇聚中继站，将离散的同质对象聚沙成塔。

ToolList 节点示意

舞台正中：中央主编排智能体 (Orchestrator)

整个流水线的指挥大脑是中央编排智能体 (Orchestrator)：

  1. 定位到该 Orchestrator Agent 节点；

  2. 观察它所绑定的专属规则集：

    You are creating a prompt for an image generation engine.
You have access to topic experts in their respective fields.
Work with the experts to get the results you need.
You facilitate communication between them.
If they ask for feedback, you can provide it.
Ask the image generation specialist for the final prompt.
Output only the image generation prompt. Do not wrap it in markdown context.
    (你正在为生图引擎打造顶级 Prompt。你可以随时差遣各个领域的顶尖专家。统筹协调他们以获得所需细节。最后务必向生图终审专家索取最终格式化的单一 Prompt，且不要包裹任何 Markdown 标记。)

  3. 观察该主编排器的初始任务需求，其实非常朴实：

    "Use all the tools at your disposal to create a spectacular image generation prompt about a skateboarding lion."
    (充分调用你所拥有的一切专家工具，为一只踩着滑板的雄狮打造一个惊艳全场的生图提示词。)

主编排智能体配置细节

系统运行与协同推演全过程

当按下运行按钮时，整个多智能体集群将按如下步骤有条不紊地展开协同：

  1. 主编排器接收到用户的极简需求（“踩滑板的狮子”）；
  2. 主编排器在内部审视其工具库，发现自己配备了四位顶尖专家；
  3. 主编排器依次发起工具调用：
    • 召集 Cinematographer，推敲画幅比例、广角鱼眼镜头畸变与低角度动态追踪构图；
    • 召集 Color Theorist，确立黄昏斜阳金芒与水泥街头冷暖对撞的高对比色板；
    • 召集 Detail Enthusiast，雕琢雄狮鬃毛飞扬的毛流感、滑板砂纸磨损痕迹与地面扬起的尘埃微粒；
    • 召集 Image Generation Specialist，将前述所有专家的严谨意见融合并清洗提纯为生图模型最易理解的终极短语 Prompt；
  4. 终极 Prompt 输出后，直通末端的 GenerateImage 节点进行物理渲染成图。

运行工作流并见证奇迹

让我们点击全局运行，观赏这支 AI 摄影梦之队的现场协同作业：

  1. 点击 Run Workflow 运行工作流；
  2. 仔细观察中央编排智能体的运行过程，以及上游四个工具节点被依次激活高亮的动画动效；
  3. 检查最终汇聚产出的顶级长 Prompt；
  4. 鉴赏生图节点最终渲染出的成图细节！

摄影团队协同生图最终成果

课程总结

在本篇教程中，我们系统性地攻克了多项高阶架构概念：

  • 理解了规则集 (RuleSets) 如何作为软性契约约束智能体的思考偏好；
  • 领会了工具 (Tools) 赋予智能体行动能力的本质；
  • 掌握了将完整的 AI 智能体封装转化为可调用工具 (AgentToTool) 的工业级解耦思想；
  • 见证了由分工垂直的专家集群组成的 AI“团队”如何协作；
  • 掌握了通过中央总控编排器调度多工具完成复杂长程任务的工程闭环。

这些高阶架构能力淋漓尽致地展现了 Griptape Nodes 在构建现代多智能体协同生产流水线时的强大威力。

恭喜你圆满完成全部新手演练教程！我们无比期待见证你借助这些先进理念创造出的惊艳成果。