Nodes 节点 ¶

Wordware节点是构建智能AI应用的基础构件，就像乐高积木一样，你可以将它们组合在一起创建各种复杂的功能。本指南将详细介绍Wordware平台上所有可用的节点类型，帮助你理解它们的作用以及如何有效地使用它们。

1. Generation（生成）节点 ¶

作用是什么？ ¶

生成节点是Wordware的核心功能，它允许你利用AI的强大能力来创建内容。想象一下，生成节点就像是你的私人创意助手，可以帮你写作、设计、甚至编程。你可以使用它生成文本、分析图像等多种内容。几乎每个WordApp都至少需要一个生成节点，而且使用得越多，你的应用就越强大。

如何使用？ ¶

1. 在编辑器中输入/generation并按Enter
2. 配置生成节点的属性，包括名称和要使用的AI模型
3. 当你运行WordApp时，AI会读取生成节点上方的所有内容，并据此生成新内容
4. 你可以通过@[生成节点名称]引用生成的内容

选项详解 ¶

名称 ¶

为生成节点指定一个名称，以便后续引用。你可以在右侧属性编辑器中修改名称，也可以直接在左侧编辑器中修改。

AI模型 ¶

选择你想使用的AI模型。不同的模型有各自的优势和劣势。Wordware提供了一些精选模型，你也可以点击底部按钮浏览完整的模型列表。

创造力 ¶

设置生成的创造力水平。更高的创造力水平会产生更多变化和有趣的结果，但可能导致意外输出。

一般来说，如果输出过于一致或无聊，可以提高创造力；如果输出过于混乱或无意义，则降低创造力。诗歌或小说等创意作品通常适合更高的创造力，而代码或报告等逻辑性或技术性作品则适合较低的创造力。

2. Structured Generation（结构化生成）节点 ¶

作用是什么？ ¶

结构化生成是Wordware最强大的功能之一，它解决了AI只能生成文本块的传统问题。想象一下，普通生成节点就像是给你一张白纸让你自由创作，而结构化生成则像是给你一个表格，要求你在特定的格子里填写特定的内容，这样输出就更有条理和规范。

结构化生成特别适合需要传递给其他系统（如数据库或API）的数据。例如，一个食谱应用可能生成包含材料和步骤字段的对象，而产品描述可能生成包含价格和库存字段的对象。

如何使用？ ¶

1. 在编辑器中输入/structure并按Enter
2. 设置结构化生成的属性，如名称和要使用的模型
3. 定义输出的结构，包括字段名称、描述和类型
4. 运行时，AI会根据你定义的结构生成内容

塑造输出 ¶

结构化生成的核心是输出数据的形状。这个形状就是你想要AI生成的字段集合，每个字段都有一个名称和一个值。名称总是文本，而值可以是文本、数字、布尔值（真/假）、列表，甚至是另一个对象。

例如，你可以创建一个电影数据库，结构如下：

{
    "movies": [
        {
            "title": "功夫熊猫",
            "release_year": 2008,
            "director": "马克·奥斯本",
            "actors": ["杰克·布莱克", "成龙", "安吉丽娜·朱莉"],
        },
        // 更多电影...
    ]
}

类型 ¶

每个字段在输出形状中都有一个名称、描述和类型。你可以点击节点底部的三个按钮之一添加新组件：

1. 添加值字段：可以选择Text（文本）、Number（数字）或True/False（真/假）类型
2. 添加对象字段：创建一个包含多个其他字段的对象
3. 添加列表字段：创建一个包含多个相同类型值的列表

记住，结构是有层次的：对象和列表都可以包含其他类型，所以你通常会得到嵌套几层的结构。添加或修改字段时，要注意它所在的层级以及其父级，这在编辑器中通过缩进显示。

3. Mention（引用）节点 ¶

作用是什么？ ¶

引用节点让你可以在流程中包含先前生成的内容、输入、其他流程的输出，甚至是代码执行中使用的代码。这就像是在写作时引用他人的观点或数据，使你的内容更加丰富和有依据。引用节点可以用于创建复杂的交互，几乎每个WordApp在某个时候都会使用引用。

如何使用？ ¶

1. 在编辑器中输入@
2. 这将显示所有可用的引用列表
3. 输入内容可以筛选到你想要的引用
4. 按Enter选择它

在运行时，引用将被替换为它引用的内容。任何出现在引用之后的生成节点都能看到该内容作为其提示的一部分。

4. Triggers（触发器）节点 ¶

作用是什么？ ¶

触发器允许你自动启动WordApp以响应外部事件，将你的流程转变为强大的自动化工作流。这就像是给你的应用装上了一个自动开关，当特定条件满足时，它会自动启动工作。

不必每次手动运行WordApp，触发器让你可以定义特定事件来启动流程，无论是收到电子邮件、在Slack中收到消息、每天定时运行，还是其他数千种可能的触发事件。

如何使用？ ¶

1. 点击编辑器中输入栏中的Add a Trigger（位于流程开始上方）
2. 在属性编辑器中选择你想要的触发器
3. 点击Select Trigger访问各种可以运行流程的触发器
4. 触发器按产品分类，右侧的箭头提供更细致的选项

例如，点击Slack触发器的下拉菜单可以访问各种不同的触发事件。有数千种触发操作可以自动运行你的WordApp，而无需你点击按钮！

5. Actions（操作）节点 ¶

作用是什么？ ¶

操作节点允许你将WordApp与2000多个第三方应用程序和服务无缝连接。就像是给你的AI应用增加了一双手，让它不仅能够思考和交流，还能够在真实世界中执行操作，比如发送邮件、在日历上创建事件或者在项目管理工具中添加任务。

这个强大的功能弥合了AI生成内容与现实世界行动之间的差距，使你能够在不离开Wordware生态系统的情况下自动化整个工作流程。

如何使用？ ¶

1. 在编辑器中按/并开始输入'actions'，然后按Enter
2. 在属性编辑器中选择你想要的操作
3. 点击Select action访问可以添加到流程中的各种操作
4. 操作按产品分类，右侧的箭头提供更细致的选项

例如，点击Slack的下拉菜单可以访问各种不同的操作。有数千种不同的操作可以集成到你的WordApp中，让你的AI应用与现实生活无缝衔接！

6. Ask a Human（询问人类）节点 ¶

作用是什么？ ¶

询问人类节点允许你在WordApp执行过程中请求人类输入。就像是在导航时遇到岔路口，需要问路人该往哪个方向走一样，这个节点让你可以暂停流程，等待人类提供决策、信息或偏好。

如何使用？ ¶

1. 在编辑器中输入/human并按Enter
2. 设置一个请求，让人类回应
3. 当你运行WordApp时，人类会被提示填写请求，执行会暂停直到人类回应
4. 人类的回应将可用于后续步骤

选项 ¶

名称 ¶

询问人类节点的名称，用于后续引用。你可以在属性编辑器或主编辑器中修改名称。

输出 ¶

response ¶

人类的回应，即人类针对提供的请求所提供的文本。

7. Input（输入）节点 ¶

作用是什么？ ¶

输入节点让你可以向WordApp传递数据。这就像是给机器设定初始参数，告诉它要以什么为基础开始工作。你可以使用输入为AI模型提供上下文，或给它们提供处理内容。

当你运行WordApp时，系统会要求你为该特定运行提供输入值。如果通过API访问WordApp，则需要在请求中提供这些值。

如何使用？ ¶

输入节点位于编辑器中流程开始上方的输入栏中。添加输入的方法有：

1. 点击输入栏中的+ New Input按钮
2. 在编辑器中输入/input并按Enter
3. 在编辑器中输入@和新输入的名称，然后点击+

选项 ¶

标签 ¶

输入的名称，用于在流程中引用输入。

描述 ¶

输入的描述，对于记录每个输入的用途很有用，但不是必需的。它对生成节点中的AI模型也不可见。

输入类型 ¶

该输入允许的值类型，可以选择：

• 文本：短单词或短语
• 数字：数值
• 真/假：真/假语句
• 图像：适用于具有视觉能力的AI模型
• 音频：上传歌曲或录音
• PDF/文档文件：选择文档或原始文件子类型
• CSV/文本文件：电子表格类型文件
• 列表：上述任一类型的列表，包括其他列表
• 对象：其他类型的分组集合
• 选择：允许用户从你提供的特定选项集中选择

8. Loop（循环）节点 ¶

作用是什么？ ¶

循环节点允许你有条件地重复WordApp的部分内容。这就像是在烹饪时，重复搅拌直到面糊变得光滑均匀，或者反复调味直到达到完美口感一样，循环让你可以创建复杂的交互。

例如，你可以循环询问用户输入直到他们给出正确答案，或者生成内容直到满足特定标准。循环是创建动态、交互式WordApp的强大工具，它们让你构建复杂的逻辑，创造更吸引人和有用的体验。

如何使用？ ¶

循环有两部分：条件和动作。条件决定重复动作的时长，动作是你想要重复的内容。

1. 在编辑器中输入/loop并按Enter
2. 系统会提示你填写循环的名称、条件和动作

选项 ¶

标签 ¶

循环的名称，用于后续引用循环的输出。

循环类型 ¶

有三种条件可以用来决定何时停止循环：

1. 计数：在固定次数的迭代后停止
2. 列表：对列表中的每个元素循环一次，每次给动作提供一个元素
3. 表达式：选择循环何时应停止重复的条件，例如@user_input = "done"

输出 ¶

循环产生列表类型的输出，包含循环动作产生的所有输出。

9. Code execution（代码执行）节点 ¶

作用是什么？ ¶

代码执行节点让你可以在WordApp中运行自定义JavaScript或Python代码。就像是在一座美丽的城市里安装了高速电梯，代码执行节点让你能够快速实现标准节点无法轻易完成的复杂功能。你可以使用代码执行来操作数据、调用API，甚至调用我们不支持的AI模型。

代码执行是一个强大的工具，但也属于较高级的功能。如果你不熟悉编程，可能需要查看社区的一些示例或在Discord服务器上寻求帮助。

如何使用？ ¶

1. 在编辑器中输入/code并按Enter
2. 在节点内容中编写代码（JavaScript或Python）
3. 代码将在WordApp执行期间运行
4. 你可以在代码中引用流程中的任何变量，就像在流程的其余部分一样
5. 任何记录到控制台或从代码返回的内容都将可用于流程的其余部分

选项 ¶

名称 ¶

代码执行的名称，用于后续引用其输出。

语言 ¶

你想要编写代码的语言，可以选择JavaScript或Python。

在提示中包含输出 ¶

代码执行的输出是否应包含在提示中。如果你在后续节点中使用代码执行的输出，应保持选中此项。

出错时继续 ¶

如果代码执行抛出错误，WordApp是否应继续运行。默认情况下，如果代码执行抛出错误，WordApp将停止运行，但你可以选中此框以保持WordApp运行。

输出 ¶

代码 ¶

你在代码执行中编写的代码，这是将在WordApp中执行的代码。

错误 ¶

如果代码执行过程中发生错误，你可以在这里访问该错误。

日志 ¶

你在代码中记录到控制台的任何输出都将在这里可用。

输出 ¶

你从代码中返回的任何内容都将在这里可用，这是将数据从代码执行传递到流程其余部分的主要方式。

10. If-Else（条件）节点 ¶

作用是什么？ ¶

If-Else节点让你可以在WordApp中创建条件逻辑。这就像是在路口设置交通信号灯，根据不同的条件引导流量走不同的方向。条件节点使你的WordApp能够基于已生成的内容或收到的输入做出不同的事情。

If-Else节点赋予WordApp决策能力，是AI提供智能的核心。使用Wordware，你可以轻松地在软件和AI之间来回传递数据，充分利用每种形式的智能来处理工作流程的各个环节。

如何使用？ ¶

If-Else节点由一系列条件组成，每个条件都有相应的动作。节点运行时，它会依次检查每个条件，运行条件为真的第一个部分中的节点。

1. 在编辑器中输入/if并按Enter
2. 系统会提示你在属性编辑器中填写节点的详细信息，如名称、条件和要包含的动作

条件 ¶

条件在属性编辑器的Expressions部分设置，每个条件（IF）有两个输入槽和三种比较方式：

1. Match：检查两个值是否相等
2. Text：检查第一个值是否包含第二个值
3. Number：比较两个数值输入，有子选项用于比较运算符（例如 >、<）

你可以通过条件下方的+ Add If按钮添加任意数量的条件。还有一个ELSE条件，当其他条件都不为真时运行。

动作 ¶

动作在相应条件下的编辑器中设置，允许根据满足哪个条件来运行生成、引用和任何其他节点类型。

11. Flow（流程）节点 ¶

作用是什么？ ¶

流程节点让你可以从你自己的流程内部调用另一个流程。这就像是模块化编程，将大型应用分解成更小、可重用的组件。流程节点对于将WordApp拆分为更小、可组合的部分或在多个WordApp中重用常见模式很有用。

流程节点还给你提供了对上下文窗口的更深入控制，因为子流程中间步骤产生的内容对父流程的AI模型不可见。

如何使用？ ¶

1. 在编辑器中输入/flow并按Enter
2. 系统会提示你从现有流程中选择要调用的流程，然后提供该流程的输入

选项 ¶

流程 ¶

你想要调用的流程，可以从当前项目中的任何流程中选择。

输入 ¶

你想要传递给流程的输入，可以是当前流程中可用的任何输入或来自当前流程的引用。

输出 ¶

流程输出流程生成的所有变量。这些可以在父流程中使用引用引用，引用的名称是流程的名称，后跟一个点和变量的名称。

12. Comment（注释）节点 ¶

作用是什么？ ¶

有时你想给自己留下小笔记，记住你是如何完美地调整提示的，或者明天的待办事项是什么。这就是注释的用途。注释是你可以在流程中任何位置留下的笔记，AI会忽略这些内容，它们也不会出现在运行的WordApp中。

如何使用？ ¶

1. 在编辑器中输入/comment并按Enter
2. 对于程序员，你也可以输入//或按CTRL + /（Mac上是CMD + /）
3. 内容中的文本可以是任何你喜欢的内容，AI会忽略它

你也可以在注释中使用格式化，如**粗体**或*斜体*。这对于使注释突出或跟踪不同类型的笔记很有用。

13. Tool（工具）节点 ¶

作用是什么？ ¶

工具节点允许你将外部功能集成到WordApp中，扩展其功能超出文本生成的范围。想象一下，这些工具就像是给你的AI应用装上了各种专用设备和传感器，让它能与外部世界互动。它们使你能够执行各种任务，如网络搜索、图像生成、文本转语音转换、PDF解析等。

通过集成工具，你可以创建更动态和交互式的WordApp，能够访问和处理现实世界的数据，生成多媒体内容，并执行复杂操作。这使你的WordApp更加多功能，能够处理广泛的任务和场景。

可用工具 ¶

Wordware提供了多种工具，包括：

1. Actions：与2000多种集成连接Wordware
2. Web Search with Exa：从互联网查询高质量信息
3. Website Similarity Search：查找与给定URL相似的网站
4. Webscrape：从URL抓取数据
5. Image Generation：使用AI模型生成图像
6. Text-to-Speech with ElevenLabs：将文本转换为语音
7. Speech-to-Text with Deepgram：将语音转换为文本
8. File Content Extractor：从各种文件格式提取文本
9. URL Converter：将URL转换为可在工具或提示中使用的格式

每个工具都有特定的输入和输出，可以根据你的需求选择合适的工具。

最佳实践 ¶

1. 为任务选择合适的工具，确保最佳结果
2. 提供清晰具体的输入，获得更准确的输出
3. 使用引用引用工具输出在WordApp的其他部分
4. 将工具与循环或条件等其他节点结合，创建更复杂的工作流

14. Formatting（格式化） ¶

如何访问 ¶

你可以按/并向下滚动到格式化以访问不同的格式化类型。或者，你可以使用下面概述的文本快捷方式。

标题 ¶

输入##然后按Enter在编辑器中获取标题2文本。最适合用于章节标题。

副标题 ¶

输入###然后按Enter在编辑器中获取标题3文本。最适合用于小节标题。

文本格式化 ¶

Wordware支持大多数Markdown格式化。只需在文本周围添加**、_或~即可格式化它。

你可以组合这些样式。例如，写**_粗体和斜体_**得到粗体和斜体文本。

列表 ¶

要创建无序列表，在每个项目前添加*或-：

- 项目1
- 项目2
- 项目3

要创建有序列表，在每个项目前添加数字和句点：

1. 项目1
2. 项目2
3. 项目3

引用块 ¶

要创建引用块，在段落前添加>：

> 这是一段引用文本，显示为特殊格式。

实用示例：构建一个智能营销助手 ¶

让我们通过一个实际例子，看看如何结合多种节点类型创建一个有用的应用。我们将构建一个智能营销助手，它可以：

1. 接收用户的产品信息
2. 生成适合不同平台的营销文案
3. 分析文案的情感和目标受众
4. 根据反馈进行优化

步骤1：设置输入 ¶

首先，我们添加几个输入节点：

• 产品名称（文本类型）
• 产品描述（文本类型）
• 目标受众（文本类型）
• 营销平台（选择类型，选项包括"Facebook"、"Twitter"、"LinkedIn"、"Instagram"）

步骤2：生成营销文案 ¶

接下来，添加一个生成节点，提示如下：

请根据以下产品信息为@营销平台平台创建引人注目的营销文案：

产品名称: @产品名称
产品描述: @产品描述
目标受众: @目标受众

文案应简洁有力，符合@营销平台的风格，并包含吸引目标受众的卖点。

步骤3：分析文案 ¶

添加一个结构化生成节点来分析文案：

分析上面生成的营销文案 @营销文案，提供以下信息：

结构定义：

• 情感分析（文本类型）：文案传达的主要情感
• 受众匹配度（数字类型，1-10）：文案与目标受众的匹配程度
• 改进建议（文本类型）：如何进一步优化文案的建议
• 关键词（列表类型，文本）：文案中的关键词

步骤4：添加条件逻辑 ¶

添加一个If-Else节点：

• 如果 @分析.受众匹配度 > 7，则显示成功消息并提供最终文案
• 否则，使用循环节点尝试重新生成更好的文案，直到匹配度达到标准或达到最大尝试次数

步骤5：集成外部工具 ¶

最后，添加一个工具节点（例如Web Search），根据产品类别搜索最新的营销趋势，并将这些信息融入到最终的文案优化中。

通过这个例子，我们看到了如何组合各种节点类型来创建一个复杂而有用的应用，它不仅能生成内容，还能分析、优化并与外部世界互动。

总结 ¶

Wordware的节点系统为创建强大的AI应用提供了一套全面的工具。通过理解并熟练使用这些节点，你可以构建从简单的聊天机器人到复杂的多功能AI应用的各种解决方案。

记住，最好的学习方法是实践。开始创建简单的应用，然后逐步添加更复杂的功能，探索不同节点的组合方式。随着你的技能提升，你将能够构建真正智能且有用的AI应用，为你的业务或创意项目增添价值。