Skip to content

Commit bd8ce79

Browse files
PalashioPalashio
authored
feat: update agent builder main page to be non-technical friendly (#1699)
## Overview This PR updates the docs for the agent builder overview page to be friendly for non-technical users. ## Type of change **Type:** Update existing documentation ## Related issues/PRs <!-- Link to related issues, feature PRs, or discussions (if applicable) To automatically close an issue when this PR is merged, use closing keywords: - "closes #123" or "fixes #123" or "resolves #123" For regular references without auto-closing, just use: - "#123" or "See issue #123" Examples: - closes #456 (will auto-close issue #456 when PR is merged) - See #789 for context (will reference but not auto-close issue #789) --> - GitHub issue: - Feature PR: <!-- For LangChain employees, if applicable: --> - Linear issue: - Slack thread: ## Checklist <!-- Put an 'x' in all boxes that apply --> - [x] I have read the [contributing guidelines](README.md) - [x] I have tested my changes locally using `docs dev` - [x] All code examples have been tested and work correctly - [x] I have used **root relative** paths for internal links - [x] I have updated navigation in `src/docs.json` if needed (Internal team members only / optional): Create a preview deployment as necessary using the [Create Preview Branch workflow](https://github.com/langchain-ai/docs/actions/workflows/create-preview-branch.yml) ## Additional notes <!-- Any other information that would be helpful for reviewers -->
1 parent edb3aa2 commit bd8ce79

File tree

4 files changed

+130
-72
lines changed

4 files changed

+130
-72
lines changed

‎src/docs.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1340,8 +1340,9 @@
13401340
{
13411341
"group": "Get started",
13421342
"pages": [
1343-
"langsmith/agent-builder-setup",
1343+
"langsmith/agent-builder-essentials",
13441344
"langsmith/agent-builder-templates",
1345+
"langsmith/agent-builder-setup",
13451346
"langsmith/agent-builder-workspace-vs-private"
13461347
]
13471348
},

‎src/langsmith/agent-builder-essentials.mdx‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
title: Essentials
3+
description: Tools, triggers, memory, sub-agents, and approvals—everything you need in one place.
4+
sidebarTitle: Essentials
5+
mode: wide
6+
---
7+
8+
## Tools
9+
10+
Tools let your agents interact with your apps and services. Your agents can send emails, create calendar events, post messages, search the web, and more. Choose from built-in tools for Gmail, Slack, Google Calendar, GitHub, and many others.
11+
12+
See [Supported tools](/langsmith/agent-builder-tools) for a complete list.
13+
14+
## Triggers
15+
16+
Triggers define when your agent should start running. You can connect your agent to external tools or time-based schedules, letting it respond automatically to messages, emails, or recurring events.
17+
18+
Here are some popular ways to trigger your agent:
19+
20+
<CardGroup cols={3}>
21+
<Card title="Slack" icon="slack">
22+
Activate your agent when messages are received in specific Slack channels.
23+
</Card>
24+
<Card title="Gmail" icon="envelope">
25+
Trigger your agent when emails are received.
26+
</Card>
27+
<Card title="Cron schedules" icon="clock">
28+
Run your agent on a time-based schedule for recurring tasks.
29+
</Card>
30+
</CardGroup>
31+
32+
## Memory and updates
33+
34+
Your agents get smarter over time. They remember important information from previous conversations and can update themselves to work better.
35+
36+
- Memory: Agents remember relevant details from past interactions, so they can make better decisions in future conversations.
37+
- Self-updates: Agents can add new tools, remove ones they don't need, or adjust their instructions to improve how they work.
38+
- What stays the same: Agents can't change their name, description, or the triggers that start them.
39+
40+
## Sub-agents
41+
42+
Build complex agents by breaking big tasks into smaller, specialized helpers. Think of sub-agents as a team of specialists—each one handles a specific part of the job while working together with your main agent.
43+
44+
This approach makes it easier to build sophisticated systems. Instead of one agent trying to do everything, you can have specialized helpers that each excel at their part of the task.
45+
46+
Here are some ways you might use sub-agents:
47+
48+
- Split into sub-tasks: Have one agent fetch data, another summarize it, and a third format the results.
49+
- Specialized tools: Give different agents access to different tools based on what they need to do.
50+
- Independent work: Let sub-agents work on their own, then bring their results back to the main agent.
51+
52+
## Human in the loop
53+
54+
Stay in control of important decisions. You can set up your agent to pause and ask for your approval before taking certain actions. This ensures your agent handles most tasks automatically, while you retain oversight.
55+
56+
### Setting up approval steps
57+
58+
<Steps>
59+
<Step title="Select a tool">
60+
When setting up your agent, choose the tool or action you want to review before it runs.
61+
</Step>
62+
<Step title="Turn on approval">
63+
Find the approval option for that tool and switch it on.
64+
</Step>
65+
<Step title="Agent waits for you">
66+
When your agent reaches that step, it will pause and wait for your approval before continuing.
67+
</Step>
68+
</Steps>
69+
70+
### What you can do when your agent pauses
71+
72+
When your agent stops to ask for approval, you have three options:
73+
74+
<CardGroup cols={3}>
75+
<Card title="Accept" icon="check">
76+
Give the green light and let your agent proceed with its plan.
77+
</Card>
78+
<Card title="Edit" icon="pen-to-square">
79+
Modify the agent's message or parameters before allowing it to continue.
80+
</Card>
81+
<Card title="Send feedback" icon="comment">
82+
Share feedback to help your agent learn and improve.
83+
</Card>
84+
</CardGroup>
85+
86+
## Next steps
87+
88+
- [Set up your workspace](/langsmith/agent-builder-setup)
89+
- [Connect apps and services](/langsmith/agent-builder-tools)
90+
- [Use remote connections](/langsmith/agent-builder-mcp-framework)
91+
- [Choose between workspace and private agents](/langsmith/agent-builder-workspace-vs-private)
92+
- [Call agents from your app](/langsmith/agent-builder-code)

‎src/langsmith/agent-builder-templates.mdx‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,22 +10,22 @@ Agent Builder includes starter templates to help you create agents quickly. Temp
1010
## How to use templates
1111

1212
<Steps>
13-
<Step title="Pick a template">
13+
<Step title="Pick a template" icon="squares-plus">
1414
In Agent Builder, choose a template that matches your use case (e.g., Gmail assistant, Linear Slack bot, etc.).
1515
</Step>
16-
<Step title="Review tools and prompts">
16+
<Step title="Review tools and prompts" icon="sliders">
1717
Each template comes with an initial system prompt and a set of tools. Review the tools and prompt to ensure they align with your needs (you can always edit them later, or have the agent edit it for you).
1818
</Step>
19-
<Step title="Clone and authenticate">
19+
<Step title="Clone and authenticate" icon="key">
2020
Click `Clone Template` in the top right to start the cloning process. If you haven't already authenticated with OAuth for the tools in the template, you'll be prompted to do so.
2121
</Step>
22-
<Step title="Add triggers (optional)">
23-
If a template has a [trigger](/langsmith/agent-builder#triggers), you'll be prompted to:
22+
<Step title="Add triggers (optional)" icon="clock">
23+
If a template includes a trigger, you'll be prompted to:
2424
- Authenticate and setup the trigger if you haven't done this before
2525
or
2626
- Select an existing trigger from the dropdown list
2727
</Step>
28-
<Step title="Test and iterate">
28+
<Step title="Test and iterate" icon="rocket">
2929
Run the agent, review outputs, and refine prompts or tools. To edit your cloned agent, either make the changes manually, or ask the agent to make the changes for you!
3030
</Step>
3131
</Steps>

‎src/langsmith/agent-builder.mdx‎

Lines changed: 30 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -1,90 +1,55 @@
11
---
22
title: Agent Builder
3+
description: Create helpful AI agents without code. Start from a template, connect your accounts, and let the agent handle routine work while you stay in control.
34
sidebarTitle: Overview
45
mode: wide
56
---
67

78
<Callout icon="wand-magic-sparkles" color="#2563EB" iconType="regular">
89
Agent Builder is in Beta.
910
</Callout>
11+
## What you can do
1012

11-
Agent Builder lets you turn natural-language ideas into production agents. It's powered by [deep-agents](https://github.com/langchain-ai/deepagents), and is not <Tooltip tip="Predetermined code paths that are designed to operate in a certain order.">workflow based</Tooltip>.
13+
- Automate everyday tasks like drafting emails, summarizing updates, and organizing information.
14+
- Connect your favorite apps to bring context into your agent’s work.
15+
- Use in chat or where you work (e.g., Slack) to get help in the flow.
16+
- Stay in control with simple approvals for important actions.
1217

13-
## Memory and updates
18+
## Start building
1419

15-
Agent Builder includes persistent agent memory and supports self-updates. This lets agents adapt over time and refine how they work without manual edits.
16-
17-
- Persistent memory: Agents retain relevant information across runs to inform future decisions.
18-
- What can be updated: Tools (add, remove, or reconfigure), and instructions/system prompts.
19-
- Agents cannot modify their name, description, and/or triggers attached.
20-
21-
## Triggers
22-
23-
Triggers define when your agent should start running. You can connect your agent to external tools or time-based schedules, letting it respond automatically to messages, emails, or recurring events.
24-
25-
The following examples show some of the apps you can use to trigger your agent:
26-
27-
<CardGroup cols={3}>
28-
<Card title="Slack" icon="slack">
29-
Activate your agent when messages are received in specific Slack channels.
20+
<CardGroup cols={2}>
21+
<Card title="Create with a template" icon="shapes" color="#E9D5FF" iconType="regular" href="/langsmith/agent-builder-templates" cta="Browse templates">
22+
Pick a ready-made starter (e.g., email assistant or team updates) and customize.
3023
</Card>
31-
<Card title="Gmail" icon="envelope">
32-
Trigger your agent when emails are received.
33-
</Card>
34-
<Card title="Cron schedules" icon="clock">
35-
Run your agent on a time-based schedule for recurring tasks.
24+
<Card title="Create with AI" icon="wand-magic-sparkles" color="#4F46E5" iconType="regular">
25+
Describe your goal in plain English and let AI draft your agent's configuration. Review and edit before running.
3626
</Card>
3727
</CardGroup>
3828

39-
## Sub-agents
40-
41-
Agent Builder lets you create sub-agents within a main agent. Sub-agents are smaller, specialized agents that handle specific parts of a larger task. They can operate with their own tools, permissions, or goals while coordinating with the main agent.
42-
43-
Using sub-agents makes it easier to build complex systems by dividing work into focused, reusable components. This modular approach helps keep your agents organized, scalable, and easier to maintain.
44-
45-
Below are a few ways sub-agents can be used in your projects:
46-
47-
- Handle distinct parts of a broader workflow (for example, data retrieval, summarization, or formatting).
48-
- Use different tools or context windows for specialized tasks.
49-
- Run independently but report results back to the main agent.
50-
51-
## Human in the loop
52-
53-
Human-in-the-loop functionality allows you to review and approve agent actions before they execute, giving you control over critical decisions.
54-
55-
### Enabling interrupts
29+
## Get started
5630

5731
<Steps>
58-
<Step title="Select a tool">
59-
When configuring your agent in Agent Builder, select the tool you want to add human oversight to.
32+
<Step title="Create an agent" icon="circle-plus">
33+
Start from a ready-to-use template, or describe your goal and let AI draft your agent's instructions. You can edit details before running. [Browse templates](/langsmith/agent-builder-templates).
6034
</Step>
61-
<Step title="Enable interrupts">
62-
Look for the interrupt option when selecting the tool and toggle it on.
35+
<Step title="Connect your accounts" icon="link">
36+
Securely sign in to the services you want the agent to use.
6337
</Step>
64-
<Step title="Agent pauses for approval">
65-
The agent will pause and wait for human approval before executing that tool.
38+
<Step title="Try it out" icon="rocket">
39+
Run the agent and iterate on its instructions in a few clicks.
6640
</Step>
6741
</Steps>
6842

69-
### Actions on interrupts
70-
71-
When your agent reaches an interrupt point, you can take one of three actions:
72-
73-
<CardGroup cols={3}>
74-
<Card title="Accept" icon="check">
75-
Approve the agent's proposed action and allow it to proceed as planned.
76-
</Card>
77-
<Card title="Edit" icon="pen-to-square">
78-
Modify the agent's message or parameters before allowing it to continue.
79-
</Card>
80-
<Card title="Send feedback" icon="comment">
81-
Provide feedback to the agent.
82-
</Card>
83-
</CardGroup>
43+
## Learn more
8444

85-
## Next steps
45+
- [Essentials: connections, automation, memory, approvals](/langsmith/agent-builder-essentials)
46+
- [Create from a template](/langsmith/agent-builder-templates)
47+
- [Set up your workspace](/langsmith/agent-builder-setup)
48+
- [Connect apps and services](/langsmith/agent-builder-tools) and [use remote connections](/langsmith/agent-builder-mcp-framework)
49+
- [Choose between workspace and private agents](/langsmith/agent-builder-workspace-vs-private)
50+
- [Authorize accounts when prompted](/langsmith/agent-builder-auth-format)
51+
- [Call agents from your app](/langsmith/agent-builder-code)
8652

87-
- [Set up workspace secrets and model keys](/langsmith/agent-builder-setup)
88-
- [Enable built-in and remote tools](/langsmith/agent-builder-tools), [MCP Framework](/langsmith/agent-builder-mcp-framework)
89-
- [Trigger OAuth from tools](/langsmith/agent-builder-auth-format)
90-
- [Call agents from code](/langsmith/agent-builder-code)
53+
<Note>
54+
Agent Builder is free for Plus and Enterprise users during the beta period. It will become a paid product when it reaches general availability.
55+
</Note>

0 commit comments

Comments
 (0)