Moved agent components into the agent folder (#5496)

### What problem does this PR solve?



### Type of change


- [x] Documentation Update
This commit is contained in:
writinwaters 2025-02-28 19:27:57 +08:00 committed by GitHub
parent 6a71314d70
commit e61da33672
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
15 changed files with 26 additions and 30 deletions

View File

@ -1,6 +1,6 @@
{
"label": "Agent Components",
"position": 3,
"position": 20,
"link": {
"type": "generated-index",
"description": "A complete reference for RAGFlow's agent components."

View File

@ -76,6 +76,15 @@ When writing suggestions, pay attention to whether there are ways to improve the
Where `{source_text}` and `{target_lang}` are global variables defined by the **Begin** component, while `{translation_1}` is the output of another **Generate** component with the component ID **Translate directly**.
:::danger IMPORTANT
A **Generate** component relies on keys (variables) to specify its data inputs. Its immediate upstream component is *not* necessarily its data input, and the arrows in the workflow indicate *only* the processing sequence.
:::
![variable_settings](https://github.com/user-attachments/assets/cb024c9e-264a-43ff-9ee7-8649afd571b0)
Keys in a **Generate** component are used in conjunction with the system prompt to specify data inputs for the LLM. Use a forward slash `/` to show the keys to use.
### Cite
This toggle sets whether to cite the original text as reference.
@ -95,19 +104,6 @@ This feature is used for multi-turn dialogue *only*.
:::
### Key (Variable)
:::danger IMPORTANT
A **Generate** component relies on keys (variables) to specify its data inputs. Its immediate upstream component is *not* necessarily its data input, and the arrows in the workflow indicate *only* the processing sequence.
:::
![variable_settings](https://github.com/user-attachments/assets/cb024c9e-264a-43ff-9ee7-8649afd571b0)
Keys in a **Generate** component are used in conjunction with the system prompt to specify data inputs for the LLM. As shown in the above screenshot, the values are categorized into two groups:
- **Component Output**: The value of the key should be a component ID.
- **Begin Input**: The value of the key should be the name of a global variable defined in the **Begin** component.
## Examples
You can explore our three-step interpreter agent template, where a **Generate** component (component ID: **Reflect**) takes three global variables:

View File

@ -16,7 +16,7 @@ A **Rewrite** component uses a specified LLM to rewrite a user query from the **
A **Rewrite** component is essential when you need to optimize a user query based on the context of previous conversations. It is usually the upstream component of a **Retrieval** component.
:::tip NOTE
See also the [Keyword](https://ragflow.io/docs/dev/keyword_component) component, a similar component used for multi-turn optimization.
See also the [Keyword](./keyword.mdx) component, a similar component used for multi-turn optimization.
:::
## Configurations

View File

@ -13,7 +13,7 @@ A **Switch** component evaluates conditions based on the output of specific comp
## Scenarios
A **Switch** component is essential for condition-based direction of execution flow. While it shares similarities with the [Categorize](https://ragflow.io/docs/dev/categorize_component) component, which is also used in multi-pronged strategies, the key distinction lies in their approach: the evaluation of the **Switch** component is rule-based, whereas the **Categorize** component involves AI and uses an LLM for decision-making.
A **Switch** component is essential for condition-based direction of execution flow. While it shares similarities with the [Categorize](./categorize.mdx) component, which is also used in multi-pronged strategies, the key distinction lies in their approach: the evaluation of the **Switch** component is rule-based, whereas the **Categorize** component involves AI and uses an LLM for decision-making.
## Configurations

View File

@ -15,7 +15,7 @@ Released on February 6, 2025.
- Supports DeepSeek R1 and DeepSeek V3.
- GraphRAG refactor: Knowledge graph is dynamically built on an entire knowledge base (dataset) rather than on an individual file, and automatically updated when a newly uploaded file starts parsing. See [here](https://ragflow.io/docs/dev/construct_knowledge_graph).
- Adds an **Iteration** agent component and a **Research report generator** agent template. See [here](./references/agent_component_reference/iteration.mdx).
- Adds an **Iteration** agent component and a **Research report generator** agent template. See [here](./guides/agent/agent_component_reference/iteration.mdx).
- New UI language: Portuguese.
- Allows setting metadata for a specific file in a knowledge base to enhance AI-powered chats. See [here](./guides/configure_knowledge_base/set_metadata.md).
- Upgrades RAGFlow's document engine [Infinity](https://github.com/infiniflow/infinity) to v0.6.0.dev3.
@ -32,19 +32,19 @@ The **Tag knowledge base** feature is *unavailable* on the [Infinity](https://gi
- [Construct knowledge graph](./guides/configure_knowledge_base/construct_knowledge_graph.md)
- [Set metadata](./guides/configure_knowledge_base/set_metadata.md)
- [Begin component](./references/agent_component_reference/begin.mdx)
- [Generate component](./references/agent_component_reference/generate.mdx)
- [Interact component](./references/agent_component_reference/interact.mdx)
- [Retrieval component](./references/agent_component_reference/retrieval.mdx)
- [Categorize component](./references/agent_component_reference/categorize.mdx)
- [Keyword component](./references/agent_component_reference/keyword.mdx)
- [Message component](./references/agent_component_reference/message.mdx)
- [Rewrite component](./references/agent_component_reference/rewrite.mdx)
- [Switch component](./references/agent_component_reference/switch.mdx)
- [Concentrator component](./references/agent_component_reference/concentrator.mdx)
- [Template component](./references/agent_component_reference/template.mdx)
- [Iteration component](./references/agent_component_reference/iteration.mdx)
- [Note component](./references/agent_component_reference/note.mdx)
- [Begin component](./guides/agent/agent_component_reference/begin.mdx)
- [Generate component](./guides/agent/agent_component_reference/generate.mdx)
- [Interact component](./guides/agent/agent_component_reference/interact.mdx)
- [Retrieval component](./guides/agent/agent_component_reference/retrieval.mdx)
- [Categorize component](./guides/agent/agent_component_reference/categorize.mdx)
- [Keyword component](./guides/agent/agent_component_reference/keyword.mdx)
- [Message component](./guides/agent/agent_component_reference/message.mdx)
- [Rewrite component](./guides/agent/agent_component_reference/rewrite.mdx)
- [Switch component](./guides/agent/agent_component_reference/switch.mdx)
- [Concentrator component](./guides/agent/agent_component_reference/concentrator.mdx)
- [Template component](./guides/agent/agent_component_reference/template.mdx)
- [Iteration component](./guides/agent/agent_component_reference/iteration.mdx)
- [Note component](./guides/agent/agent_component_reference/note.mdx)
## v0.15.1