Skip to content

docs: agent refactor#8524

Merged
mendonk merged 15 commits into
mainfrom
docs-agent-refactor
Jun 20, 2025
Merged

docs: agent refactor#8524
mendonk merged 15 commits into
mainfrom
docs-agent-refactor

Conversation

@mendonk
Copy link
Copy Markdown
Collaborator

@mendonk mendonk commented Jun 12, 2025

Refresh agent documentation content. Preview build

  1. Move bundled agent components to "Bundles" page (to keep in line with the changes for 1.5).
  2. Combine the overview and agent quickstart page into one page.
  3. Test the Agent quickstart and update as needed.
  4. Update screenshots.
  5. Remove the "Tool Calling Agent" language, as even though it's what the component is called, its display name is Agent and it's less confusing this way.

Summary by CodeRabbit

  • Documentation
    • Consolidated and updated agent-related documentation, introducing a comprehensive guide for building and customizing agents with tools and multi-agent flows.
    • Expanded documentation for bundled agent components, adding detailed descriptions and parameter tables for various agent types.
    • Updated references and links throughout the documentation to reflect the new agent guide and streamline navigation.
    • Removed legacy and redundant documentation pages and outdated component descriptions to improve clarity and relevance.

@mendonk mendonk self-assigned this Jun 12, 2025
@dosubot dosubot Bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Jun 12, 2025
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 12, 2025

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

This update restructures and consolidates the documentation for agent components. It removes outdated or redundant agent documentation, introduces a new comprehensive guide for agents, updates links throughout related documents, and reorganizes detailed agent component descriptions under the "Bundles" section. Sidebar navigation is also updated to reflect these changes.

Changes

File(s) Change Summary
docs/docs/Agents/agent-tool-calling-agent-component.md, docs/docs/Agents/agents-overview.md Deleted legacy documentation pages for the tool-calling agent and agents overview.
docs/docs/Agents/agents.md Added new, consolidated guide for agents, covering agent usage, tool integration, multi-agent flows, custom tools, and example interactions.
docs/docs/Components/components-agents.md Updated references and links to point to the new agents documentation; removed detailed descriptions of legacy/bundled agent components.
docs/docs/Components/components-bundles.md Added extensive documentation for bundled agent components, including descriptions and parameter tables for each agent type (CrewAI, Hierarchical Crew, CSV Agent, OpenAI Tools Agent, OpenAPI Agent, Sequential Crew, Sequential task agent, SQL Agent, Tool Calling Agent, XML Agent).
docs/docs/Components/components-tools.md, docs/docs/Sample-Flows/sequential-agent.md, docs/docs/Starter-Projects/starter-projects-simple-agent.md, docs/docs/Get-Started/get-started-quickstart.md Updated documentation links to reference the new agents guide instead of removed or renamed pages.
docs/sidebars.js Simplified sidebar navigation by consolidating agent documentation entries into a single "Agents/agents" entry.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Docs
    participant Sidebar

    User->>Docs: Accesses agent documentation
    Docs-->>User: Serves new consolidated agents guide (agents.md)
    User->>Sidebar: Navigates via sidebar
    Sidebar-->>User: Shows single "Agents" entry
    User->>Docs: Follows updated internal links
    Docs-->>User: Serves relevant, updated or expanded documentation sections
Loading

Suggested labels

documentation, size:L, lgtm, refactor

✨ Finishing Touches
🧪 Generate Unit Tests
  • Create PR with Unit Tests
  • Post Copyable Unit Tests in Comment
  • Commit Unit Tests in branch docs-agent-refactor

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai auto-generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@dosubot dosubot Bot added the documentation Improvements or additions to documentation label Jun 12, 2025
@github-actions github-actions Bot removed the documentation Improvements or additions to documentation label Jun 12, 2025
Comment thread docs/docs/Agents/agents.md Outdated

If the component you want to use as a tool doesn't have a **Tool Mode** button, add `tool_mode=True` to one of the component's inputs, and connect the new **Toolset** output to the agent's **Tools** input.

Langflow supports **Tool Mode** for the following data types:
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@edwinjosechittilappilly Confirm this please

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 12, 2025
Comment thread docs/docs/Agents/agents.md Outdated

7. The new agent's actions can be edited to help the agent understand how to use it.
Click <Icon name="SlidersHorizontal" aria-hidden="true"/> **Edit Tools** to modify its `name`, `description`, or `enabled` metadata.
For example, the default tool name is `Agent`. Edit the name to `Agent-gpt-41`, and edit the description to `Use the gpt-4.1 model for complex problem solving`. The connected agent will understand that this is the `gpt-4.1` agent, and will use it for tasks requiring a larger context window.
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@edwinjosechittilappilly This is the bug that I reported, where the connected agent as tool displays potentially incorrect information.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 12, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 12, 2025
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (6)
docs/docs/Sample-Flows/sequential-agent.md (1)

54-54: Hyphenate “problem-solving” and confirm link update.

Change “problem solving” to “problem-solving” and ensure the link accurately points to /agents.

🧰 Tools
🪛 LanguageTool

[grammar] ~54-~54: This noun or verb “problem-solving” is spelled with a hyphen.
Context: ...our own multi-agent flow, see Create a problem solving agent.

(PROBLEM_SOLVE_HYPHEN)

docs/docs/Components/components-agents.md (1)

23-24: Suggestion: Add comma for clarity.

Consider adding a comma after the image to improve readability:

- ![Simple agent starter flow](/img/starter-flow-simple-agent.png)
- For a multi-agent example see [Create a flow with an agent](/agents).
+ ![Simple agent starter flow](/img/starter-flow-simple-agent.png),
+ For a multi-agent example, see [Create a flow with an agent](/agents).
🧰 Tools
🪛 LanguageTool

[uncategorized] ~24-~24: Possible missing comma found.
Context: ...ow-simple-agent.png) For a multi-agent example see [Create a flow with an agent](/agen...

(AI_HYDRA_LEO_MISSING_COMMA)

docs/docs/Agents/agents.md (2)

96-98: Consistency: Hyphenate “problem-solving.”

The term “problem solving” should use a hyphen to match noun usage:

- description to `Use the gpt-4.1 model for complex problem solving`.
+ description to `Use the gpt-4.1 model for complex problem-solving`.
🧰 Tools
🪛 LanguageTool

[grammar] ~97-~97: This noun or verb “problem-solving” is spelled with a hyphen.
Context: ...nt-gpt-41, and edit the description to Use the gpt-4.1 model for complex problem solving`. The connected agent will understand t...

(PROBLEM_SOLVE_HYPHEN)


200-202: Suggestion: Add comma before “so.”

Insert a comma before “so” to correctly separate clauses:

- pane. this code so the custom component can be used as a tool.
+ pane. this code, so the custom component can be used as a tool.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~201-~201: Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...de=Trueto theMessageTextInput` input so the custom component can be used as a t...

(COMMA_COMPOUND_SENTENCE_2)

docs/docs/Components/components-bundles.md (2)

18-18: Grammar: Add missing comma.

Insert a comma after “CrewAI” to separate clauses:

- This component represents an Agent of CrewAI allowing for the creation of specialized AI agents...
+ This component represents an Agent of CrewAI, allowing for the creation of specialized AI agents...
🧰 Tools
🪛 LanguageTool

[uncategorized] ~18-~18: Possible missing comma found.
Context: ... This component represents an Agent of CrewAI allowing for the creation of specialize...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~18-~18: A comma might be missing here.
Context: ...n of specialized AI agents with defined roles goals and capabilities within a crew. ...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)


188-188: Grammar: Insert comma after “Agent.”

Separate the clause for clarity:

- Task and its associated Agent allowing for the definition of sequential tasks...
+ Task and its associated Agent, allowing for the definition of sequential tasks...
🧰 Tools
🪛 LanguageTool

[uncategorized] ~188-~188: A comma might be missing here.
Context: ...reates a CrewAI Task and its associated Agent allowing for the definition of sequenti...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1710c56 and 4cb9e07.

⛔ Files ignored due to path filters (8)
  • docs/static/img/agent-component.png is excluded by !**/*.png
  • docs/static/img/agent-example-add-chat.png is excluded by !**/*.png
  • docs/static/img/agent-example-add-tools.png is excluded by !**/*.png
  • docs/static/img/agent-example-agent-as-tool.png is excluded by !**/*.png
  • docs/static/img/agent-example-run-flow-as-tool.png is excluded by !**/*.png
  • docs/static/img/tool-calling-agent-add-chat.png is excluded by !**/*.png
  • docs/static/img/tool-calling-agent-as-tool.png is excluded by !**/*.png
  • docs/static/img/tool-calling-agent-component.png is excluded by !**/*.png
📒 Files selected for processing (10)
  • docs/docs/Agents/agent-tool-calling-agent-component.md (0 hunks)
  • docs/docs/Agents/agents-overview.md (0 hunks)
  • docs/docs/Agents/agents.md (1 hunks)
  • docs/docs/Components/components-agents.md (2 hunks)
  • docs/docs/Components/components-bundles.md (1 hunks)
  • docs/docs/Components/components-tools.md (1 hunks)
  • docs/docs/Get-Started/get-started-quickstart.md (1 hunks)
  • docs/docs/Sample-Flows/sequential-agent.md (1 hunks)
  • docs/docs/Starter-Projects/starter-projects-simple-agent.md (1 hunks)
  • docs/sidebars.js (1 hunks)
💤 Files with no reviewable changes (2)
  • docs/docs/Agents/agents-overview.md
  • docs/docs/Agents/agent-tool-calling-agent-component.md
🧰 Additional context used
🪛 LanguageTool
docs/docs/Sample-Flows/sequential-agent.md

[grammar] ~54-~54: This noun or verb “problem-solving” is spelled with a hyphen.
Context: ...our own multi-agent flow, see Create a problem solving agent.

(PROBLEM_SOLVE_HYPHEN)

docs/docs/Get-Started/get-started-quickstart.md

[grammar] ~187-~187: Make sure that ‘use to’ is correct. For habitual actions in the past or to mean ‘accustomed to’, use “used to”.
Context: ...tabase the brain that Agents use to make decisions. Publish this flow as a...

(USE_TO_VERB)

docs/docs/Components/components-agents.md

[uncategorized] ~24-~24: Possible missing comma found.
Context: ...ow-simple-agent.png) For a multi-agent example see [Create a flow with an agent](/agen...

(AI_HYDRA_LEO_MISSING_COMMA)

docs/docs/Agents/agents.md

[grammar] ~97-~97: This noun or verb “problem-solving” is spelled with a hyphen.
Context: ...nt-gpt-41, and edit the description to Use the gpt-4.1 model for complex problem solving`. The connected agent will understand t...

(PROBLEM_SOLVE_HYPHEN)


[uncategorized] ~201-~201: Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...de=Trueto theMessageTextInput` input so the custom component can be used as a t...

(COMMA_COMPOUND_SENTENCE_2)

docs/docs/Components/components-bundles.md

[uncategorized] ~18-~18: Possible missing comma found.
Context: ... This component represents an Agent of CrewAI allowing for the creation of specialize...

(AI_HYDRA_LEO_MISSING_COMMA)


[uncategorized] ~18-~18: A comma might be missing here.
Context: ...n of specialized AI agents with defined roles goals and capabilities within a crew. ...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)


[uncategorized] ~188-~188: A comma might be missing here.
Context: ...reates a CrewAI Task and its associated Agent allowing for the definition of sequenti...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)

⏰ Context from checks skipped due to timeout of 90000ms (1)
  • GitHub Check: build-and-deploy
🔇 Additional comments (8)
docs/docs/Get-Started/get-started-quickstart.md (1)

187-187: Update Agents link to consolidated documentation.

The reference now points to /agents instead of the old overview page, aligning with the new structure.

🧰 Tools
🪛 LanguageTool

[grammar] ~187-~187: Make sure that ‘use to’ is correct. For habitual actions in the past or to mean ‘accustomed to’, use “used to”.
Context: ...tabase the brain that Agents use to make decisions. Publish this flow as a...

(USE_TO_VERB)

docs/docs/Components/components-tools.md (1)

28-28: Update example link to new Agents guide.

The example now correctly references the consolidated Agents page anchor /agents#make-any-component-a-tool.

docs/sidebars.js (1)

73-73: Consolidate Agents sidebar entries.

Replaced separate overview and tool-calling entries with a single "Agents/agents" item to match the new documentation file.

docs/docs/Starter-Projects/starter-projects-simple-agent.md (1)

6-6: Simplify reference to Agent component.

Updated terminology and link to use the unified [Agent](/agents) component instead of the old tool-calling agent.

docs/docs/Components/components-agents.md (3)

24-24: Approve updated multi-agent link.

The updated link correctly points to the consolidated Agents documentation at /agents.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~24-~24: Possible missing comma found.
Context: ...ow-simple-agent.png) For a multi-agent example see [Create a flow with an agent](/agen...

(AI_HYDRA_LEO_MISSING_COMMA)


32-32: Approve updated Agent documentation link.

This link now accurately directs users to the new unified Agents guide at /agents.


43-43: Approve clarification of optional tools input.

Adding “This field is optional and can be empty” clearly conveys that the tools list may be omitted.

docs/docs/Agents/agents.md (1)

8-15: LGTM: Clear introduction and component overview.

The new Agents guide concisely explains the purpose and capabilities of the Agent component.

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 12, 2025
Copy link
Copy Markdown
Collaborator

@aimurphy aimurphy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some ideas for you to consider about how the content is organized.

Comment thread docs/docs/Agents/agents.md Outdated
Comment thread docs/docs/Agents/agents.md Outdated
Comment thread docs/docs/Agents/agents.md Outdated
Comment thread docs/docs/Agents/agents.md Outdated
Comment thread docs/docs/Agents/agents.md Outdated
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 18, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 18, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 18, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 18, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

@github-actions github-actions Bot removed the documentation Improvements or additions to documentation label Jun 18, 2025
@github-actions

This comment was marked as outdated.

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

Comment thread docs/docs/Agents/agents.md Outdated
Copy link
Copy Markdown
Collaborator

@edwinjosechittilappilly edwinjosechittilappilly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving with a small change.

Comment thread docs/docs/Agents/agents.md Outdated
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

Build successful! ✅
Deploying docs draft.
Deploy successful! View draft

@mendonk mendonk added this pull request to the merge queue Jun 20, 2025
Merged via the queue into main with commit 15f4451 Jun 20, 2025
13 checks passed
@mendonk mendonk deleted the docs-agent-refactor branch June 20, 2025 22:16
ogabrielluiz pushed a commit to bkatya2001/langflow that referenced this pull request Jun 24, 2025
* changes-from-1.5

* initial-content

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

* breakout-tools-config

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

* docs-review

* fix-broken-links

* Apply suggestions from code review

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
Khurdhula-Harshavardhan pushed a commit to JigsawStack/langflow that referenced this pull request Jul 1, 2025
* changes-from-1.5

* initial-content

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

* breakout-tools-config

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

* docs-review

* fix-broken-links

* Apply suggestions from code review

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
@coderabbitai coderabbitai Bot mentioned this pull request Jul 1, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation lgtm This PR has been approved by a maintainer size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants