关于捆绑包 (Bundles)
捆绑包 (Bundles) 包含支持 Langflow 与特定第三方集成的自定义组件。 您可以将它们添加到流中，并以与 Langflow 核心组件相同的方式配置它们。
要浏览捆绑包，请在可视化编辑器中点击 捆绑包 (Bundles)。
捆绑包维护与文档
许多捆绑组件是由 Langflow 代码库的第三方贡献者开发的。
一些提供商随捆绑包一起提供文档，而另一些提供商则在自己的文档中记录其捆绑包。 有些捆绑包没有文档。
要查找特定捆绑组件的文档，请浏览 Langflow 文档和您的提供商文档。 如果可用，您还可以通过组件本身找到相关文档的链接（例如 API 端点）：
- 点击组件以显示 组件的页眉菜单。
- 点击 更多 (More)。
- 选择 文档 (Docs)。
Langflow 文档侧重于在流中使用捆绑包。 因此，它侧重于捆绑组件的 Langflow 特定配置步骤。 有关提供商特定功能或 API 的信息，请参阅提供商的文档。
组件参数
Some parameters are hidden by default in the visual editor. You can modify all parameters through the Controls in the component's header menu.
核心组件与捆绑包
Langflow 文档并未列出捆绑包中的所有捆绑包或组件。 有关您的 Langflow 版本中最准确且最新的捆绑包和组件列表，请查看可视化编辑器中的 捆绑包 (Bundles)。
如果您找不到在早期版本的 Langflow 中使用的组件，它可能已被删除或标记为 遗留组件。
除了第三方、提供商特定的捆绑包外，Langflow 还提供通用的 核心组件 (Core components)。
如果您正在寻找特定的服务或集成，可以在可视化编辑器中 搜索 组件。
如果一切都失败了，您始终可以创建自己的 自定义组件。
遗留捆绑包 (Legacy bundles)
Legacy components are longer supported and can be removed in a future release. You can continue to use them in existing flows, but it is recommended that you replace them with supported components as soon as possible. Suggested replacements are included in the Legacy banner on components in your flows. They are also given in release notes and Langflow documentation whenever possible.
If you aren't sure how to replace a legacy component, Search for components by provider, service, or component name. The component may have been deprecated in favor of a completely new component, a similar component, or a new version of the same component in a different category.
If there is no obvious replacement, consider whether another component can be adapted to your use case. For example, many Core components provide generic functionality that can support multiple providers and use cases, such as the API Request component.
If neither of these options are viable, you could use the legacy component's code to create your own custom component, or start a discussion about the legacy component.
To discourage use of legacy components in new flows, these components are hidden by default. In the visual editor, you can click Component settings to toggle the Legacy filter.
以下捆绑包仅包含遗留组件。
CrewAI 捆绑包
请使用其他代理组件（如 代理 (Agent) 组件）替换以下遗留的 CrewAI 组件。
CrewAI Agent
此组件代表 CrewAI 代理，允许在团队（crew）内创建具有明确定义的角色、目标和能力的专门 AI 代理。 更多信息请参阅 CrewAI 代理文档。
此组件接受以下参数：
| 名称 | 显示名称 | 信息 |
|---|---|---|
| role | 角色 (Role) | 输入参数。代理的角色。 |
| goal | 目标 (Goal) | 输入参数。代理的目标。 |
| backstory | 背景故事 (Backstory) | 输入参数。代理的背景故事。 |
| tools | 工具 (Tools) | 输入参数。代理可使用的工具。 |
| llm | 语言模型 (Language Model) | 输入参数。运行代理的语言模型。 |
| memory | 记忆 (Memory) | 输入参数。这决定了代理是否应该拥有记忆。 |
| verbose | 详细模式 (Verbose) | 输入参数。启用详细输出。 |
| allow_delegation | 允许委派 (Allow Delegation) | 输入参数。这决定了代理是否被允许将任务委派给其他代理。 |
| allow_code_execution | 允许代码执行 (Allow Code Execution) | 输入参数。这决定了代理是否被允许执行代码。 |
| kwargs | kwargs | 输入参数。代理的其他关键字参数。 |
| output | 代理 (Agent) | 输出参数。构建的 CrewAI Agent 对象。 |
CrewAI Hierarchical Crew, CrewAI Hierarchical Task
CrewAI Hierarchical Crew 组件代表一组代理，管理它们应如何协作以及它们应在分层结构中执行的任务。此组件允许创建一个具有经理监督任务执行的团队。 更多信息请参阅 CrewAI 分层团队文档。
它接受以下参数：
| 名称 | 显示名称 | 信息 |
|---|---|---|
| agents | 代理 (Agents) | 输入参数。代表团队成员的 Agent 对象列表。 |
| tasks | 任务 (Tasks) | 输入参数。代表要执行的任务的 HierarchicalTask 对象列表。 |
| manager_llm | 经理 LLM (Manager LLM) | 输入参数。经理代理的语言模型。 |
| manager_agent | 经理代理 (Manager Agent) | 输入参数。担任经理的特定代理。 |
| verbose | 详细模式 (Verbose) | 输入参数。启用详细日志记录的详细输出。 |
| memory | 记忆 (Memory) | 输入参数。团队的记忆配置。 |
| use_cache | 使用缓存 (Use Cache) | 输入参数。启用结果缓存。 |
| max_rpm | 最大 RPM (Max RPM) | 输入参数。设置每分钟最大请求数。 |
| share_crew | 分享团队 (Share Crew) | 输入参数。决定团队信息是否在代理之间共享。 |
| function_calling_llm | 函数调用 LLM (Function Calling LLM) | 输入参数。用于函数调用的语言模型。 |
| crew | 团队 (Crew) | 输出参数。构建的具有分层任务执行功能的 Crew 对象。 |
CrewAI Sequential Crew, CrewAI Sequential Task
CrewAI Sequential Crew 组件代表一组按顺序执行任务的代理。此组件允许创建一个按特定顺序执行任务的团队。 更多信息请参阅 CrewAI 顺序团队文档。
它接受以下参数：
| 名称 | 显示名称 | 信息 |
|---|---|---|
| tasks | 任务 (Tasks) | 输入参数。代表要执行的任务的 SequentialTask 对象列表。 |
| verbose | 详细模式 (Verbose) | 输入参数。启用详细日志记录的详细输出。 |
| memory | 记忆 (Memory) | 输入参数。团队的记忆配置。 |
| use_cache | 使用缓存 (Use Cache) | 输入参数。启用结果缓存。 |
| max_rpm | 最大 RPM (Max RPM) | 输入参数。设置每分钟最大请求数。 |
| share_crew | 分享团队 (Share Crew) | 输入参数。决定团队信息是否在代理之间共享。 |
| function_calling_llm | 函数调用 LLM (Function Calling LLM) | 输入参数。用于函数调用的语言模型。 |
| crew | 团队 (Crew) | 输出参数。构建的具有顺序任务执行功能的 Crew 对象。 |
CrewAI Sequential Task Agent
此组件创建一个 CrewAI 任务及其关联的代理，允许定义具有特定代理角色和能力的顺序任务。 更多信息请参阅 CrewAI 顺序代理文档。
它接受以下参数：
| 名称 | 显示名称 | 信息 |
|---|---|---|
| role | 角色 (Role) | 输入参数。代理的角色。 |
| goal | 目标 (Goal) | 输入参数。代理的目标。 |
| backstory | 背景故事 (Backstory) | 输入参数。代理的背景故事。 |
| tools | 工具 (Tools) | 输入参数。代理可使用的工具。 |
| llm | 语言模型 (Language Model) | 输入参数。运行代理的语言模型。 |
| memory | 记忆 (Memory) | 输入参数。这决定了代理是否应该拥有记忆。 |
| verbose | 详细模式 (Verbose) | 输入参数。启用详细输出。 |
| allow_delegation | 允许委派 (Allow Delegation) | 输入参数。这决定了代理是否被允许将任务委派给其他代理。 |
| allow_code_execution | 允许代码执行 (Allow Code Execution) | 输入参数。这决定了代理是否被允许执行代码。 |
| agent_kwargs | 代理 kwargs (Agent kwargs) | 输入参数。代理的其他关键字参数。 |
| task_description | 任务描述 (Task Description) | 输入参数。详细说明任务目的和执行的描述性文本。 |
| expected_output | 预期任务输出 (Expected Task Output) | 输入参数。对预期任务结果的明确定义。 |
| async_execution | 异步执行 (Async Execution) | 输入参数。指示异步任务执行的布尔标志。 |
| previous_task | 前一任务 (Previous Task) | 输入参数。链中的前一个任务。 |
| task_output | 顺序任务 (Sequential Task) | 输出参数。代表已创建任务的 SequentialTask 对象列表。 |
Embeddings (嵌入) 捆绑包
- Embedding Similarity (嵌入相似度)：已被向量库组件中内置的相似度搜索功能取代。
- Text Embedder (文本嵌入器)：已被嵌入模型组件取代。
Vector Stores (向量库) 捆绑 包
此捆绑包仅包含遗留的 Local DB 组件。 所有其他向量库组件都可以在其各自提供商特定的捆绑包中找到，例如 DataStax 捆绑包。
Local DB
请使用 Chroma DB 向量库组件（在 Chroma 捆绑包中）或其他向量库组件替换 Local DB 组件。
Local DB 组件读取和写入专门用于 Langflow 的持久化内存中 Chroma DB 实例。 它具有独立的读取和写入模式、自动集合管理功能，并且默认持久化在您的 Langflow 缓存目录中。
设置 模式 (Mode) 参数以反映您希望组件执行的操作，然后相应地配置其他参数。 某些参数仅在一种模式下可用。
- 摄取 (Ingest)
- 检索 (Retrieve)
要创建或写入您的本地 Chroma 向量库，请使用 摄取 (Ingest) 模式。
以下参数在 摄取 (Ingest) 模式下可用：
| 名称 | 类型 | 描述 |
|---|---|---|
命名您的集合 (collection_name) | 字符串 | 输入参数。您的 Chroma 向量库集合名称。默认值：langflow。仅在 摄取 (Ingest) 模式下可用。 |
持久化目录 (persist_directory) | 字符串 | 输入参数。您要创建和持久化向量库的基础目录。如果您在多个流中使用 Local DB 组件或创建多个集合，集合将存储在 $PERSISTENT_DIRECTORY/vector_stores/$COLLECTION_NAME。如果未指定，默认位置是您的 Langflow 配置目录。有关更多信息，请参阅 内存管理选项。 |
嵌入 (embedding) | Embeddings | 输入参数。用于向量库的嵌入函数。 |
允许重复 (allow_duplicates) | 布尔值 | 输入参数。如果为 true（默认值），写入操作不会检查集合中现有的重复项，允许您存储相同内容的多个副本。如果为 false，写入操作将不会添加与集合中已存在文档匹配的文档。如果为 false，它可以通过搜索整个集合来严格执行去重，或仅搜索 limit 中指定的记录数。仅在 摄取 (Ingest) 模式下可用。 |
摄取数据 (ingest_data) | Data 或 DataFrame | 输入参数。要写入集合的记录。记录将被嵌入并编入索引以进行语义搜索。仅在 摄取 (Ingest) 模式下可用。 |
限制 (limit) | 整数 | 输入参数。当 允许重复 为 false 时，限制要比较的记录数。这有助于提高向大型集合写入时的性能，但可能会导致一些重复记录。仅在 摄取 (Ingest) 模式下可用。 |
要从您的本地 Chroma 向量库中读取，请使用 检索 (Retrieve) 模式 。
以下参数在 检索 (Retrieve) 模式下可用：
| 名称 | 类型 | 描述 |
|---|---|---|
持久化目录 (persist_directory) | 字符串 | 输入参数。您要创建和持久化向量库的基础目录。如果您在多个流中使用 Local DB 组件或创建多个集合，集合将存储在 $PERSISTENT_DIRECTORY/vector_stores/$COLLECTION_NAME。如果未指定，默认位置是您的 Langflow 配置目录。有关更多信息，请参阅 内存管理选项。 |
现有集合 (existing_collections) | 字符串 | 输入参数。选择之前创建的集合进行搜索。仅在 检索 (Retrieve) 模式下可用。 |
嵌入 (embedding) | Embeddings | 输入参数。用于向量库的嵌入函数。 |
搜索类型 (search_type) | 字符串 | 输入参数。要执行的搜索类型，为 Similarity (相似度) 或 MMR (最大边际相关性)。仅在 检索 (Retrieve) 模式下可用。 |
搜索查询 (search_query) | 字符串 | 输入参数。输入用于相似度搜索的查询。仅在 检索 (Retrieve) 模式下可用。 |
结果数量 (number_of_results) | 整数 | 输入参数。要返回的搜索结果数量。默认值：10。仅在 检索 (Retrieve) 模式下可用。 |
Zep 捆绑包
Zep Chat Memory
Zep Chat Memory 组件是一个遗留组件。 请使用 消息历史 (Message History) 组件 替换此组件。
此组件创建一个 ZepChatMessageHistory 实例，允许使用 Zep（一种用于 LLM 的记忆服务器）存储和检索聊天消息。
它接受以下参数：
| 名称 | 类型 | 描述 |
|---|---|---|
| url | MessageText | 输入参数。Zep 实例的 URL。必填。 |
| api_key | SecretString | 输入参数。用于 Zep 实例身份验证的 API 密钥。 |
| api_base_path | 下拉列表 (Dropdown) | 输入参数。要使用的 API 版本。选项包括 api/v1 或 api/v2。 |
| session_id | MessageText | 输入参数。聊天会话的唯一标识符。可选。 |
| message_history | BaseChatMessageHistory | 输出参数。该会话的 ZepChatMessageHistory 实例。 |
