跳到主要内容

CUGA

捆绑包 (Bundles) 包含支持 Langflow 与特定第三方集成的自定义组件。

模型提供商限制

CUGA 组件仅支持 OpenAI 和 watsonx 模型。要使用其他模型提供商，请改用核心 代理 (Agent) 组件。

CUGA (ConfigUrable Generalist Agent，可配置通用代理) 组件是一种高级 AI 代理，它使用工具、可选的浏览器自动化和结构化输出生成来执行复杂任务。

CUGA 组件可以替代流中的 代理 (Agent) 组件。 与核心 代理 (Agent) 组件类似，CUGA 组件可以使用连接到其 Tools 端口的工具，并且其自身也可以作为工具使用。 它还包含一些额外的特性：

  • 使用 Playwright 进行网页抓取的浏览器自动化。 要启用网页抓取，请将组件的 browser_enabled 参数设置为 true，并在 web_apps 参数中以 https://example.com 的格式指定单个 URL。
  • 加载供代理执行的自定义指令。 要使用此功能，请使用组件的 Instructions 输入来附加包含代理指令的 markdown 文件。

有关更多信息，请参阅 CUGA 项目仓库。

在流中使用 CUGA 组件​

出于演示目的，以下示例修改了一个模板流以使用 CUGA 组件。

一个基本的代理聊天流，包含聊天输入、CUGA 和聊天输出组件，以及各种工具和文件输入。

  1. 基于 简单代理 (Simple Agent) 模板创建一个流，然后将 代理 (Agent) 组件替换为 CUGA 组件。

  2. 将 MCP 工具 (MCP Tools) 组件 和 计算器 (Calculator) 组件 连接到 CUGA 组件的 Tools 端口，然后将 MCP 工具 组件连接到任何 MCP 服务器。 本示例连接到一个包含业务组织销售数据的服务器。

  3. 添加一个 读取文件 (Read File) 组件，然后将其连接到 CUGA 组件的 Instructions 端口。 或者，点击 编辑文本 (Edit text) 打开 编辑文本内容 (Edit text content) 窗格，直接在 CUGA 组件中输入您的指令。

  4. 在您的计算机上创建一个名为 instructions.md 的 Markdown 文件，然后插入以下内容。 清晰地使用 ## Plan 和 ## Answer 格式化文档对于代理理解您的指令非常重要。


    _13
    ## Plan
    _13
    _13
    - 将复杂的查询分解为子任务
    _13
    - 在执行前优先收集信息
    _13
    - 考虑操作之间的依赖关系
    _13
    - 在继续之前验证中间结果
    _13
    _13
    ## Answer
    _13
    _13
    - 提供包含关键发现的简洁摘要
    _13
    - 包含相关数据点和指标
    _13
    - 在使用 MCP 工具结果时引用来源
    _13
    - 使用清晰的结构和格式以提高可读性

  5. 在 读取文件 (Read File) 组件中，点击 添加文件 (Add File)，然后附上您的 instructions.md 文件。

  6. 打开 游乐场 (Playground)，然后向代理询问一个可以使用连接的 MCP 服务器的问题。 本示例询问了关于 MCP 服务器提供的销售数据，例如 Which accounts are available?。 代理会描述其进行的工具调用，然后根据指令返回答案。 例如，可用账户列表非常大，但 CUGA 组件按策略要求返回了简洁的摘要。


    _14
    根据可用数据，以下是账户信息：
    _14
    _14
    Summit Solutions (NY) - 收入: $1,200,000
    _14
    Pacific Ventures (CA) - 收入: $9,500,000
    _14
    Lone Star Corp (TX) - 收入: $4,500,000
    _14
    Mountain Peak Systems (CO) - 收入: $2,100,000
    _14
    Digital Dynamics (CA) - 收入: $5,500,000
    _14
    Cascade Computing (WA) - 收入: $4,300,000
    _14
    Data Flow Systems (CA) - 收入: $8,900,000
    _14
    Rocky Mountain Enterprises (CO) - 收入: $3,200,000
    _14
    Blue Sky Partners (TX) - 收入: $500,000
    _14
    Liberty Manufacturing (PA) - 收入: $3,400,000
    _14
    _14
    这是一个部分列表；还有更多可用账户。所有账户的总收入为 $210,200,000。

CUGA 参数​

Some parameters are hidden by default in the visual editor. You can modify all parameters through the Controls in the component's header menu.

名称类型描述
agent_llmDropdown代理的模型提供商。
instructionsMultiline String定义代理规划和回答的自定义指令。可以直接提供，也可以通过 Markdown 文件提供。格式对于代理理解指令非常重要。请参阅 在流中使用 CUGA 组件。
n_messagesInteger要检索的聊天历史消息数量。对于由 session_id 标识的正在进行的对话中保持上下文非常有用。默认值：100。
format_instructionsMultiline String结构化输出的模板。
output_schemaTable当提供 output_schema 时，结构化响应将针对动态构建的 schema 进行验证。无效项目将连同验证错误一起返回。字段：name、description、type (str, int, float, bool, dict)、multiple (作为列表)。
add_current_date_toolBoolean如果为 true，则添加一个返回当前日期的工具。默认值：true。
lite_modeBoolean设置为 true 以启用 CugaLite 模式，在使用较少数量的工具时实现更快执行。默认值：true。
lite_mode_tool_thresholdInteger自动启用 CugaLite 的阈值。如果连接到 CUGA 组件的工具少于此阈值，则激活 CugaLite。默认值：25。
decomposition_strategyDropdown任务分解策略。flexible 允许每个应用有多个子任务。exact 强制每个应用一个子任务。默认值：flexible。
browser_enabledBoolean启用内置浏览器进行网页抓取和搜索。允许代理在响应中使用通用网络搜索。禁用 (false) 以限制代理仅使用流中提供的上下文。默认值：false。
web_appsMultiline String当 browser_enabled 为 true 时，指定代理可以使用内置浏览器打开的单个 URL，例如 https://example.com。CUGA 组件可以访问公共和私人互联网资源。CUGA 组件中没有内置机制来限制仅访问公共互联网资源。
Search