mirror of
https://github.com/langflow-ai/langflow.git
synced 2026-07-24 00:39:35 +08:00
185 lines
40 KiB
HTML
185 lines
40 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-Agents/agents" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v3.8.1">
|
||
<title data-rh="true">Use Langflow agents | Langflow Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.langflow.org/agents"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Use Langflow agents | Langflow Documentation"><meta data-rh="true" name="description" content="Langflow's Agent component is critical for building agent flows."><meta data-rh="true" property="og:description" content="Langflow's Agent component is critical for building agent flows."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.langflow.org/agents"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/agents" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/agents" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://UZK6BDPCVY-dsn.algolia.net" crossorigin="anonymous"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Use Langflow agents","item":"https://docs.langflow.org/agents"}]}</script><link rel="preconnect" href="https://www.google-analytics.com">
|
||
<link rel="preconnect" href="https://www.googletagmanager.com">
|
||
<script async src="https://www.googletagmanager.com/gtag/js?id=G-SLQFLQ3KPT"></script>
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-SLQFLQ3KPT",{})</script>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml" title="Langflow Documentation" href="/opensearch.xml">
|
||
|
||
|
||
|
||
<script>window._ibmAnalytics={settings:{name:"DataStax",tealiumProfileName:"ibm-subsidiary"},trustarc:{privacyPolicyLink:"https://ibm.com/privacy"},"digitalData.page.services.google.enabled":!0},window.digitalData={page:{pageInfo:{ibm:{siteId:"IBM_"+_ibmAnalytics.settings.name},segment:{enabled:!0,env:"prod",key:"B04fNhD06DqDPuaRfQl5lZ2iQICdxxuh",coremetrics:!1,carbonComponentEvents:!1}},category:{primaryCategory:"PC230"}},commonProperties:{productTitle:"IBM Elite Support for Langflow",productCode:"5900BUB",productCodeType:"WWPC",UT30:"30AS5",instanceId:"docs-site",subscriptionId:"public-access",productPlanName:"Public",productPlanType:"freemium",userId:"IBMid-ANONYMOUS"}}</script>
|
||
<script src="//1.www.s81c.com/common/stats/ibm-common.js" async="true"></script>
|
||
|
||
|
||
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Sora:wght@550;600&display=swap">
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("consent","default",{ad_storage:"denied",ad_user_data:"denied",ad_personalization:"denied",analytics_storage:"denied"})</script>
|
||
<script>!function(){function e(){if(void 0!==window.truste&&window.truste.cma){var e=window.truste.cma.callApi("getConsent",window.location.href)||{},n=1===e[2],t=1===e[3];gtag("consent","update",{ad_storage:n?"granted":"denied",ad_user_data:n?"granted":"denied",ad_personalization:n?"granted":"denied",analytics_storage:t?"granted":"denied"})}}window.addEventListener&&(window.addEventListener("cm_data_subject_consent_changed",e),window.addEventListener("cm_consent_preferences_set",e)),"complete"===document.readyState?e():window.addEventListener("load",e)}()</script><link rel="stylesheet" href="/assets/css/styles.5b49702d.css">
|
||
<script src="/assets/js/runtime~main.cd536c15.js" defer="defer"></script>
|
||
<script src="/assets/js/main.e03e853e.js" defer="defer"></script>
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;"><defs>
|
||
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
|
||
</defs></svg>
|
||
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top navbarHideable_m1mJ"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/lf-docs-light.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/langflow-ai/langflow" target="_blank" class="navbar__item navbar__link header-github-link" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-github" data-namespace="header" data-platform-title="Langflow"></a><a href="https://twitter.com/langflow_ai" target="_blank" class="navbar__item navbar__link header-twitter-link" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-twitter" data-namespace="header" data-platform-title="Langflow"></a><a href="https://discord.gg/EqksyE2EX9" target="_blank" class="navbar__item navbar__link header-discord-link" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-discord" data-namespace="header" data-platform-title="Langflow"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_g3eP systemToggleIcon_QzmC"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search (Command+K)"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd sidebarWithHideableNavbar_wUlq"><a tabindex="-1" class="sidebarLogo_isFc" href="/"><img src="/img/lf-docs-light.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--dark_xIcU"></a><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/">Get started</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-overview">Flows</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" href="/agents">Agents</a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/agents">Use Langflow agents</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/agents-tools">Configure tools for agents</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/mcp-client">Model Context Protocol (MCP)</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/api-keys-and-authentication">Develop</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/deployment-overview">Deploy</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-components">Components reference</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/api-reference-api-examples">API reference</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/contributing-community">Contribute</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/troubleshoot">Support</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-ad">
|
||
<a href="https://www.langflow.org/desktop" target="_blank" class="menu__link">
|
||
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||
<g clip-path="url(#clip0_1645_37)">
|
||
<path d="M12 17H20C21.1046 17 22 16.1046 22 15V13M12 17H4C2.89543 17 2 16.1046 2 15V5C2 3.89543 2.89543 3 4 3H10M12 17V21M8 21H12M12 21H16M11.75 10.2917H13.2083L16.125 7.375H17.5833L20.5 4.45833H21.9583M16.125 11.75H17.5833L20.5 8.83333H21.9583M11.75 5.91667H13.2083L16.125 3H17.5833" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||
</g>
|
||
<defs>
|
||
<clipPath id="clip0_1645_37">
|
||
<rect width="24" height="24" fill="white"/>
|
||
</clipPath>
|
||
</defs>
|
||
</svg>
|
||
<div class="sidebar-ad-text-container">
|
||
<span class="sidebar-ad-text">Get started in minutes</span>
|
||
<span class="sidebar-ad-text sidebar-ad-text-gradient">Download Langflow Desktop</span>
|
||
</div>
|
||
</a>
|
||
</li></ul></nav></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Agents</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Use Langflow agents</span></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Use Langflow agents</h1></header><style>[data-ch-theme="github-dark"] { --ch-t-colorScheme: dark;--ch-t-foreground: #c9d1d9;--ch-t-background: #0d1117;--ch-t-lighter-inlineBackground: #0d1117e6;--ch-t-editor-background: #0d1117;--ch-t-editor-foreground: #c9d1d9;--ch-t-editor-lineHighlightBackground: #6e76811a;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #264F78;--ch-t-focusBorder: #1f6feb;--ch-t-tab-activeBackground: #0d1117;--ch-t-tab-activeForeground: #c9d1d9;--ch-t-tab-inactiveBackground: #010409;--ch-t-tab-inactiveForeground: #8b949e;--ch-t-tab-border: #30363d;--ch-t-tab-activeBorder: #0d1117;--ch-t-editorGroup-border: #30363d;--ch-t-editorGroupHeader-tabsBackground: #010409;--ch-t-editorLineNumber-foreground: #6e7681;--ch-t-input-background: #0d1117;--ch-t-input-foreground: #c9d1d9;--ch-t-input-border: #30363d;--ch-t-icon-foreground: #8b949e;--ch-t-sideBar-background: #010409;--ch-t-sideBar-foreground: #c9d1d9;--ch-t-sideBar-border: #30363d;--ch-t-list-activeSelectionBackground: #6e768166;--ch-t-list-activeSelectionForeground: #c9d1d9;--ch-t-list-hoverBackground: #6e76811a;--ch-t-list-hoverForeground: #c9d1d9; }</style>
|
||
<!-- -->
|
||
<p>Langflow's <a href="/components-agents"><strong>Agent</strong> component</a> is critical for building agent flows.
|
||
This component provides everything you need to create an agent, including multiple Large Language Model (LLM) providers, tool calling, and custom instructions.
|
||
It simplifies agent configuration so you can focus on application development.</p>
|
||
<details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>How do agents work?</summary><div><div class="collapsibleContent_i85q"><p>Agents extend Large Language Models (LLMs) by integrating <em>tools</em>, which are functions that provide additional context and enable autonomous task execution.
|
||
These integrations make agents more specialized and powerful than standalone LLMs.</p><p>Whereas an LLM might generate acceptable, inert responses to general queries and tasks, an agent can leverage the integrated context and tools to provide more relevant responses and even take action.
|
||
For example, you might create an agent that can access your company's documentation, repositories, and other resources to help your team with tasks that require knowledge of your specific products, customers, and code.</p><p>Agents use LLMs as a reasoning engine to process input, determine which actions to take to address the query, and then generate a response.
|
||
The response could be a typical text-based LLM response, or it could involve an action, like editing a file, running a script, or calling an external API.</p><p>In an agentic context, tools are functions that the agent can run to perform tasks or access external resources.
|
||
A function is wrapped as a <code>Tool</code> object with a common interface that the agent understands.
|
||
Agents become aware of tools through tool registration, which is when the agent is provided a list of available tools typically at agent initialization.
|
||
The <code>Tool</code> object's description tells the agent what the tool can do so that it can decide whether the tool is appropriate for a given request.</p></div></div></details>
|
||
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="use-the-agent-component-in-a-flow">Use the Agent component in a flow<a href="#use-the-agent-component-in-a-flow" class="hash-link" aria-label="Direct link to Use the Agent component in a flow" title="Direct link to Use the Agent component in a flow"></a></h2>
|
||
<p>The following steps explain how to create an agent flow in Langflow from a blank flow.
|
||
For a prebuilt example, use the <strong>Simple Agent</strong> template or the <a href="/get-started-quickstart">Langflow quickstart</a>.</p>
|
||
<ol>
|
||
<li>
|
||
<p>Click <strong>New Flow</strong>, and then click <strong>Blank Flow</strong>.</p>
|
||
</li>
|
||
<li>
|
||
<p>Add an <strong>Agent</strong> component to your flow.</p>
|
||
</li>
|
||
<li>
|
||
<p>Select the provider and model that you want to use.
|
||
The default model for the <strong>Agent</strong> component is an OpenAI model.
|
||
If you want to use a different provider, edit the <strong>Model Provider</strong> and <strong>Model Name</strong> fields accordingly.
|
||
If your preferred model isn't listed, type the complete model name into the <strong>Model Name</strong> field, and then select it from the <strong>Model Name</strong> menu.
|
||
Make sure that the model is enabled/verified in your model provider account.
|
||
For more information, see <a href="#agent-component-parameters">Agent component parameters</a>.</p>
|
||
</li>
|
||
<li>
|
||
<p>Enter a valid credential for your selected model provider.
|
||
Make sure that the credential has permission to call the selected model.</p>
|
||
</li>
|
||
<li>
|
||
<p>Add <a href="/chat-input-and-output"><strong>Chat Input</strong> and <strong>Chat Output</strong> components</a> to your flow, and then connect them to the <strong>Agent</strong> component.</p>
|
||
<p>At this point, you have created a basic LLM-based chat flow that you can test in the <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-play" aria-hidden="true"><polygon points="6 3 20 12 6 21 6 3"></polygon></svg> <strong>Playground</strong>.
|
||
However, this flow only chats with the LLM.
|
||
To enhance this flow and make it truly agentic, add some tools, as explained in the next steps.</p>
|
||
<p><img decoding="async" loading="lazy" alt="A basic agent chat flow with Chat Input, Agent, and Chat Output components." src="/assets/images/agent-example-add-chat-319d1ac92915c948711d6b493f0f9742.png" width="2574" height="1868" class="img_ev3q"></p>
|
||
</li>
|
||
<li>
|
||
<p>Add <strong>Web Search</strong>, <strong>URL</strong>, and <strong>Calculator</strong> components to your flow.</p>
|
||
</li>
|
||
<li>
|
||
<p>Enable <strong>Tool Mode</strong> in the <strong>Web Search</strong>, <strong>URL</strong>, and <strong>Calculator</strong> components:</p>
|
||
<ol>
|
||
<li>Click the <strong>Web Search</strong> component to expose the <a href="/concepts-components#component-menus">component's header menu</a>, and then enable <strong>Tool Mode</strong>.</li>
|
||
<li>Repeat for the <strong>URL</strong> and <strong>Calculator</strong> components.</li>
|
||
<li>Connect the <strong>Toolset</strong> port for each tool component to the <strong>Tools</strong> port on the <strong>Agent</strong> component.</li>
|
||
</ol>
|
||
<p><strong>Tool Mode</strong> makes a component into a tool by modifying the component's inputs.
|
||
With <strong>Tool Mode</strong> enabled, a component can accept requests from an <strong>Agent</strong> component to use the component's available actions as tools.</p>
|
||
<p>When in <strong>Tool Mode</strong>, a component has a <strong>Toolset</strong> port that you must connect to an <strong>Agent</strong> component's <strong>Tools</strong> port if you want to allow the agent to use that component's actions as tools.</p>
|
||
<p>For more information, see <a href="/agents-tools">Configure tools for agents</a>.</p>
|
||
<p><img decoding="async" loading="lazy" alt="A more complex agent chat flow where three components are connected to the Agent component as tools" src="/assets/images/agent-example-add-tools-3ffda4b115ea87569e0c92b5b2566c80.png" width="2610" height="1728" class="img_ev3q"></p>
|
||
</li>
|
||
<li>
|
||
<p>Open the <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-play" aria-hidden="true"><polygon points="6 3 20 12 6 21 6 3"></polygon></svg> <strong>Playground</strong>, and then ask the agent, <code>What tools are you using to answer my questions?</code></p>
|
||
<p>The agent should respond with a list of the connected tools.
|
||
It may also include built-in tools.</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>I use a combination of my built-in knowledge (up to June 2024) and a set of external tools to answer your questions. Here are the main types of tools I can use:</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>Web Search & Content Fetching: I can fetch and summarize content from web pages, including crawling links recursively.</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>News Search: I can search for recent news articles using Google News via RSS feeds.</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>Calculator: I can perform arithmetic calculations and evaluate mathematical expressions.</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>Date & Time: I can provide the current date and time in various time zones.</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>These tools help me provide up-to-date information, perform calculations, and retrieve specific data from the internet when needed. If you have a specific question, let me know, and I'll use the most appropriate tool(s) to help!</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li>
|
||
<p>To test a specific tool, ask the agent a question that uses one of the tools, such as <code>Summarize today's tech news</code>.</p>
|
||
<p>To help you debug and test your flows, the <strong>Playground</strong> displays the agent's tool calls, the provided input, and the raw output the agent received before generating the summary.
|
||
With the given example, the agent should call the <strong>Web Search</strong> component with <strong>Search Mode</strong> set to <strong>News</strong>.</p>
|
||
</li>
|
||
</ol>
|
||
<p>You've successfully created a basic agent flow that uses some generic tools.</p>
|
||
<p>To continue building on this tutorial, try connecting other tool components or <a href="/mcp-client">use Langflow as an MCP client</a> to support more complex and specialized tasks.</p>
|
||
<p>For a multi-agent example, see <a href="/agents-tools#use-an-agent-as-a-tool">Use an agent as a tool</a>.</p>
|
||
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="agent-component-parameters">Agent component parameters<a href="#agent-component-parameters" class="hash-link" aria-label="Direct link to Agent component parameters" title="Direct link to Agent component parameters"></a></h2>
|
||
<p>You can configure the <strong>Agent</strong> component to use your preferred provider and model, custom instructions, and tools.</p>
|
||
<p>Some parameters are hidden by default in the visual editor.
|
||
You can modify all parameters through the <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-sliders-horizontal" aria-hidden="true"><line x1="21" x2="14" y1="4" y2="4"></line><line x1="10" x2="3" y1="4" y2="4"></line><line x1="21" x2="12" y1="12" y2="12"></line><line x1="8" x2="3" y1="12" y2="12"></line><line x1="21" x2="16" y1="20" y2="20"></line><line x1="12" x2="3" y1="20" y2="20"></line><line x1="14" x2="14" y1="2" y2="6"></line><line x1="8" x2="8" y1="10" y2="14"></line><line x1="16" x2="16" y1="18" y2="22"></line></svg> <strong>Controls</strong> in the <a href="/concepts-components#component-menus">component's header menu</a>.</p>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="provider-and-model">Provider and model<a href="#provider-and-model" class="hash-link" aria-label="Direct link to Provider and model" title="Direct link to Provider and model"></a></h3>
|
||
<p>Use the <strong>Model Provider</strong> (<code>agent_llm</code>) and <strong>Model Name</strong> (<code>llm_model</code>) settings to select the model provider and LLM that you want the agent to use.</p>
|
||
<p>The <strong>Agent</strong> component includes many models from several popular model providers.
|
||
To access other providers or models, you can do either of the following:</p>
|
||
<ul>
|
||
<li>Set <strong>Model Provider</strong> to <strong>Connect other models</strong>, and then connect any <a href="/components-models">language model component</a>.</li>
|
||
<li>Select your preferred provider, type the complete model name into the <strong>Model Name</strong> field, and then select your custom option from the <strong>Model Name</strong> menu.
|
||
Make sure that the model is enabled/verified in your model provider account.</li>
|
||
</ul>
|
||
<p>If you need to generate embeddings in your flow, use an <a href="/components-embedding-models">embedding model component</a>.</p>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="model-provider-api-key">Model provider API key<a href="#model-provider-api-key" class="hash-link" aria-label="Direct link to Model provider API key" title="Direct link to Model provider API key"></a></h3>
|
||
<p>In the <strong>API Key</strong> field, enter a valid authentication key for your selected model provider, if you are using a built-in provider.
|
||
For example, to use the default OpenAI model, you must provide a valid OpenAI API key for an OpenAI account that has credits and permission to call OpenAI LLMs.</p>
|
||
<p>You can enter the key directly, but it is recommended that you follow industry best practices for storing and referencing API keys.
|
||
For example, you can use a <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-globe" aria-hidden="true"><circle cx="12" cy="12" r="10"></circle><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"></path><path d="M2 12h20"></path></svg> <a href="/configuration-global-variables">global variable</a> or <a href="/environment-variables">environment variables</a>.
|
||
For more information, see <a href="/api-keys-and-authentication#component-api-keys">Add component API keys to Langflow</a>.</p>
|
||
<p>If you select <strong>Connect other models</strong> as the model provider, authentication is handled in the incoming language model component.</p>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="agent-instructions-and-input">Agent instructions and input<a href="#agent-instructions-and-input" class="hash-link" aria-label="Direct link to Agent instructions and input" title="Direct link to Agent instructions and input"></a></h3>
|
||
<p>In the <strong>Agent Instructions</strong> (<code>system_prompt</code>) field, you can provide custom instructions that you want the <strong>Agent</strong> component to use for every conversation.</p>
|
||
<p>These instructions are applied in addition to the <strong>Input</strong> (<code>input_value</code>), which can be entered directly or provided through another component, such as a <strong>Chat Input</strong> component.</p>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="tools">Tools<a href="#tools" class="hash-link" aria-label="Direct link to Tools" title="Direct link to Tools"></a></h3>
|
||
<p>Agents are most useful when they have the appropriate tools available to complete requests.</p>
|
||
<p>An <strong>Agent</strong> component can use any Langflow component as a tool, including other agents and MCP servers.</p>
|
||
<p>To attach a component as a tool, you must enable <strong>Tool Mode</strong> on the component that you want to attach, and then attach it to the <strong>Agent</strong> component's <strong>Tools</strong> port.
|
||
For more information, see <a href="/agents-tools">Configure tools for agents</a>.</p>
|
||
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>tip</div><div class="admonitionContent_BuS1"><p>To allow agents to use tools from MCP servers, use the <a href="/mcp-tools"><strong>MCP Tools</strong> component</a>.</p></div></div>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="agent-memory">Agent memory<a href="#agent-memory" class="hash-link" aria-label="Direct link to Agent memory" title="Direct link to Agent memory"></a></h3>
|
||
<p>Langflow agents have built-in chat memory that is enabled by default.
|
||
This memory allows them to retrieve and reference messages from previous conversations, maintaining a rolling context window for each chat session ID.</p>
|
||
<p>Chat memories are grouped by <a href="/session-id">session ID (<code>session_id</code>)</a>.
|
||
It is recommended to use custom session IDs if you need to segregate chat memory for different users or applications that run the same flow.</p>
|
||
<p>By default, the <strong>Agent</strong> component uses your Langflow installation's storage, and it retrieves a limited number of chat messages, which you can configure with the <strong>Number of Chat History Messages</strong> parameter.</p>
|
||
<p>The <strong>Message History</strong> component isn't required for default chat memory, but it is required if you want to use external chat memory like Mem0.
|
||
Additionally, the <strong>Message History</strong> component provides more options for sorting, filtering, and limiting memories. Although, most of these options are built-in to the <strong>Agent</strong> component with default values.</p>
|
||
<p>For more information, see <a href="/memory#store-chat-memory">Store chat memory</a> and <a href="/message-history"><strong>Message History</strong> component</a>.</p>
|
||
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="additional-parameters">Additional parameters<a href="#additional-parameters" class="hash-link" aria-label="Direct link to Additional parameters" title="Direct link to Additional parameters"></a></h3>
|
||
<p>With the <strong>Agent</strong> component, the available parameters can change depending on the selected provider and model, including support for additional modes, arguments, or features like chat memory and temperature.
|
||
For example:</p>
|
||
<ul>
|
||
<li><strong>Current Date</strong> (<code>add_current_date_tool</code>): When enabled (<code>true</code>), this setting adds a tool to the agent that can retrieve the current date.</li>
|
||
<li><strong>Handle Parse Errors</strong> (<code>handle_parsing_errors</code>): When enabled (<code>true</code>), this setting allows the agent to fix errors, like typos, when analyzing user input.</li>
|
||
<li><strong>Verbose</strong> (<code>verbose</code>): When enabled (<code>true</code>), this setting records detailed logging output for debugging and analysis.</li>
|
||
</ul>
|
||
<p>Some parameters are hidden by default in the visual editor.
|
||
You can modify all parameters through the <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-sliders-horizontal" aria-hidden="true"><line x1="21" x2="14" y1="4" y2="4"></line><line x1="10" x2="3" y1="4" y2="4"></line><line x1="21" x2="12" y1="12" y2="12"></line><line x1="8" x2="3" y1="12" y2="12"></line><line x1="21" x2="16" y1="20" y2="20"></line><line x1="12" x2="3" y1="20" y2="20"></line><line x1="14" x2="14" y1="2" y2="6"></line><line x1="8" x2="8" y1="10" y2="14"></line><line x1="16" x2="16" y1="18" y2="22"></line></svg> <strong>Controls</strong> in the <a href="/concepts-components#component-menus">component's header menu</a>.</p>
|
||
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="agent-component-output">Agent component output<a href="#agent-component-output" class="hash-link" aria-label="Direct link to Agent component output" title="Direct link to Agent component output"></a></h2>
|
||
<p>The <strong>Agent</strong> component outputs a <strong>Response</strong> (<code>response</code>) that is <a href="/data-types#message"><code>Message</code> data</a> containing the agent's raw response to the query.</p>
|
||
<p>Typically, this is passed to a <strong>Chat Output</strong> component to return the response in a human-readable format.
|
||
It can also be passed to other components if you need to process the response further before, or in addition to, returning it to the user.</p>
|
||
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="see-also">See also<a href="#see-also" class="hash-link" aria-label="Direct link to See also" title="Direct link to See also"></a></h2>
|
||
<ul>
|
||
<li><a href="/components-agents"><strong>Agent</strong> and <strong>MCP Tools</strong> components</a></li>
|
||
<li><a href="/agents-tools">Configure tools for agents</a></li>
|
||
</ul></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/concepts-flows-import"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Import and export flows</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/agents-tools"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Configure tools for agents</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#use-the-agent-component-in-a-flow" class="table-of-contents__link toc-highlight">Use the Agent component in a flow</a></li><li><a href="#agent-component-parameters" class="table-of-contents__link toc-highlight">Agent component parameters</a><ul><li><a href="#provider-and-model" class="table-of-contents__link toc-highlight">Provider and model</a></li><li><a href="#model-provider-api-key" class="table-of-contents__link toc-highlight">Model provider API key</a></li><li><a href="#agent-instructions-and-input" class="table-of-contents__link toc-highlight">Agent instructions and input</a></li><li><a href="#tools" class="table-of-contents__link toc-highlight">Tools</a></li><li><a href="#agent-memory" class="table-of-contents__link toc-highlight">Agent memory</a></li><li><a href="#additional-parameters" class="table-of-contents__link toc-highlight">Additional parameters</a></li></ul></li><li><a href="#agent-component-output" class="table-of-contents__link toc-highlight">Agent component output</a></li><li><a href="#see-also" class="table-of-contents__link toc-highlight">See also</a></li></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title"></div><ul class="footer__items clean-list"><li class="footer__item"><div class="footer-links">
|
||
<span>© 2026 Langflow</span>
|
||
<span id="preferenceCenterContainer"> · <a href="#" onclick='return"undefined"!=typeof window&&window.truste&&window.truste.eu&&window.truste.eu.clickListener&&window.truste.eu.clickListener(),!1' style="cursor: pointer;">Manage Privacy Choices</a></span>
|
||
</div></li></ul></div></div></div></footer><div style="position:fixed;right:21px;bottom:21px;z-index:100;display:flex;align-items:center;gap:10px;cursor:pointer"><div style="background-color:#f6f6f6;border-radius:50%;width:48px;height:48px;display:flex;align-items:center;justify-content:center;box-shadow:0 2px 4px rgba(0,0,0,0.1)"><img src="/img/langflow-icon-black-transparent.svg" style="width:40px" alt="Search"></div></div></div>
|
||
</body>
|
||
</html> |