Skip to content

Commit fe2b0b6

Browse files
lnhsinghlnhsingh
authored
Move Agent Builder (langchain-ai#2201)
https://langchain.slack.com/archives/C04GWPE38LV/p1768263785171729
1 parent c57a4f1 commit fe2b0b6

10 files changed

Lines changed: 140 additions & 119 deletions

‎src/docs.json‎

Lines changed: 45 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1354,49 +1354,6 @@
13541354
}
13551355
]
13561356
},
1357-
{
1358-
"tab": "Agent Builder",
1359-
"pages": [
1360-
"langsmith/agent-builder",
1361-
{
1362-
"group": "Get started",
1363-
"pages": [
1364-
"langsmith/agent-builder-essentials",
1365-
{
1366-
"group": "Templates",
1367-
"pages": [
1368-
"langsmith/agent-builder-templates",
1369-
"langsmith/agent-builder-quickstart"
1370-
]
1371-
},
1372-
"langsmith/agent-builder-setup",
1373-
"langsmith/agent-builder-workspace-vs-private"
1374-
]
1375-
},
1376-
{
1377-
"group": "Tools and integrations",
1378-
"pages": [
1379-
"langsmith/agent-builder-tools",
1380-
"langsmith/agent-builder-remote-mcp-servers",
1381-
"langsmith/agent-builder-slack-app"
1382-
]
1383-
},
1384-
{
1385-
"group": "Advanced",
1386-
"pages": [
1387-
"langsmith/agent-builder-auth-format",
1388-
"langsmith/agent-builder-code",
1389-
"langsmith/agent-builder-mcp-framework"
1390-
]
1391-
},
1392-
{
1393-
"group": "Additional resources",
1394-
"pages": [
1395-
"langsmith/agent-builder-pricing-faq"
1396-
]
1397-
}
1398-
]
1399-
},
14001357
{
14011358
"tab": "Platform setup",
14021359
"groups": [
@@ -1552,9 +1509,49 @@
15521509
]
15531510
}
15541511
]
1512+
},
1513+
{
1514+
"product": "Agent Builder",
1515+
"icon": "wand-magic-sparkles",
1516+
"description": "Create helpful AI agents without code",
1517+
"pages": [
1518+
"langsmith/agent-builder",
1519+
{
1520+
"group": "Get started",
1521+
"pages": [
1522+
"langsmith/agent-builder-quickstart",
1523+
"langsmith/agent-builder-essentials",
1524+
"langsmith/agent-builder-templates",
1525+
"langsmith/agent-builder-setup",
1526+
"langsmith/agent-builder-visibility"
1527+
]
1528+
},
1529+
{
1530+
"group": "Tools and integrations",
1531+
"pages": [
1532+
"langsmith/agent-builder-tools",
1533+
"langsmith/agent-builder-remote-mcp-servers",
1534+
"langsmith/agent-builder-slack-app"
1535+
]
1536+
},
1537+
{
1538+
"group": "Advanced",
1539+
"pages": [
1540+
"langsmith/agent-builder-auth-format",
1541+
"langsmith/agent-builder-code",
1542+
"langsmith/agent-builder-mcp-framework"
1543+
]
1544+
},
1545+
{
1546+
"group": "Additional resources",
1547+
"pages": [
1548+
"langsmith/agent-builder-pricing-faq"
1549+
]
1550+
}
1551+
]
15551552
}
15561553
]
1557-
},
1554+
},
15581555
"interaction": {
15591556
"drilldown": true
15601557
},
@@ -1566,6 +1563,10 @@
15661563
}
15671564
},
15681565
"redirects": [
1566+
{
1567+
"source": "langsmith/agent-builder-workspace-vs-private",
1568+
"destination": "/langsmith/agent-builder-visibility"
1569+
},
15691570
{
15701571
"source": "/labs/swe/:path*",
15711572
"destination": "https://github.com/langchain-ai/open-swe/tree/main/apps/docs"

‎src/index.mdx‎

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ mode: "custom"
7676

7777
[**LangSmith**](/langsmith/home) is a platform that helps AI teams use live production data for continuous testing and improvement. LangSmith provides:
7878

79-
<CardGroup cols={3}>
79+
<CardGroup cols={4}>
8080
<Card
8181
title="Observability"
8282
href="/langsmith/observability"
@@ -109,20 +109,22 @@ mode: "custom"
109109
>
110110
Ship your agent in one click, using scalable infrastructure built for long-running tasks.
111111
</Card>
112-
<Card
113-
title="Agent Builder (Beta)"
114-
href="/langsmith/agent-builder"
115-
icon="wand-magic-sparkles"
116-
cta="Learn more"
117-
>
118-
Turn natural-language ideas into production agents with persistent memory and self-updating capabilities.
119-
</Card>
120112
</CardGroup>
121113

122114
<Callout icon="lock" color="#DFC5FE" iconType="regular">
123115
LangSmith meets the highest standards of data security and privacy with HIPAA, SOC 2 Type 2, and GDPR compliance. For more information, see the [Trust Center](https://trust.langchain.com/).
124116
</Callout>
125117

118+
<h2 class="flex whitespace-pre-wrap group font-semibold">LangSmith Agent Builder</h2>
119+
<Card
120+
title="Agent Builder"
121+
href="/langsmith/agent-builder"
122+
icon="wand-magic-sparkles"
123+
cta="Learn more"
124+
>
125+
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.
126+
</Card>
127+
126128
<h2 class="flex whitespace-pre-wrap group font-semibold">Get started</h2>
127129

128130
<CardGroup cols={4}>

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

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
---
22
title: Essentials
3-
description: Tools, triggers, memory, sub-agents, and approvals—everything you need in one place.
4-
sidebarTitle: Essentials
3+
description: Agent Builder's core features
54
---
65

6+
Agent Builder essentials are the core features that make up the foundation of your agents. They include tools, triggers, memory, sub-agents, and approvals.
7+
78
## Tools
89

910
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.
@@ -66,7 +67,7 @@ Here are some ways you might use sub-agents:
6667
- Specialized tools: Give different agents access to different tools based on what they need to do.
6768
- Independent work: Let sub-agents work on their own, then bring their results back to the main agent.
6869

69-
## Human in the loop
70+
## Human-in-the-loop
7071

7172
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.
7273

@@ -104,6 +105,6 @@ When your agent stops to ask for approval, you have three options:
104105

105106
- [Set up your workspace](/langsmith/agent-builder-setup)
106107
- [Connect apps and services](/langsmith/agent-builder-tools)
107-
- [Use remote connections](/langsmith/agent-builder-mcp-framework)
108+
- [Use remote servers for tools](/langsmith/agent-builder-remote-mcp-servers)
108109
- [Choose between workspace and private agents](/langsmith/agent-builder-workspace-vs-private)
109110
- [Call agents from your app](/langsmith/agent-builder-code)

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

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,9 @@
11
---
2-
title: Build an agent from a template
3-
sidebarTitle: Quickstart
2+
title: Quickstart
3+
description: Build an agent from a template
44
---
55

6-
Create your first AI agent step-by-step. No coding required. In this quickstart, you'll use the pre-defined **Email Assistant** [template](/langsmith/agent-builder-templates) that organizes and manages your inbox for you.
7-
8-
Feel free to follow along with this example or you can:
9-
10-
- Customize the instructions and tools for your own agent needs.
6+
In this quickstart, you'll use the pre-defined **Email Assistant** [template](/langsmith/agent-builder-templates) that organizes and manages your inbox for you.
117
- Select a different template.
128

139
<Callout icon="comment" color="#8B5CF6" iconType="regular">
@@ -22,7 +18,7 @@ You'll need:
2218
- A Google calendar.
2319
- An OpenAI or Anthropic API key (Step 1 will show you how to get one).
2420

25-
## 1. Get your API key
21+
## 1. Get your model API key
2622

2723
Your agent needs an API key to connect to an AI model. The AI model is what allows your agent to understand and respond to your requests.
2824

@@ -44,9 +40,9 @@ Your agent needs an API key to connect to an AI model. The AI model is what allo
4440
</Tab>
4541
</Tabs>
4642

47-
<Info>
48-
**Cost:** Both services charge based on use.
49-
</Info>
43+
<Warning>
44+
Both services charge based on usage.
45+
</Warning>
5046

5147
## 2. Add your API key to LangSmith
5248

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

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
11
---
2-
title: Agent Builder setup
2+
title: Workspace setup
33
description: Add required workspace secrets for models and tools used by Agent Builder.
4-
sidebarTitle: Setup
54
---
65

76
This page lists the workspace secrets you need to add before using Agent Builder. Add these in your LangSmith workspace settings under Secrets. Keep values scoped to your workspace and avoid placing credentials in prompts or code.
87

9-
## How to add workspace secrets
8+
## Add workspace secrets
109

1110
In the [LangSmith UI](https://smith.langchain.com), ensure that you have an LLM API key set as a [workspace secret](/langsmith/administration-overview#workspace-secrets) (either Anthropic or OpenAI API key).
1211

@@ -16,30 +15,32 @@ In the [LangSmith UI](https://smith.langchain.com), ensure that you have an LLM
1615

1716
<Note> When adding workspace secrets in the LangSmith UI, make sure the secret keys match the environment variable names expected by your model provider.</Note>
1817

19-
## Required model key
18+
## Secret types
19+
20+
### Required model key
2021

2122
For Agent Builder to make API calls to LLMs, you need to set an OpenAI or Anthropic API key as a workspace secret. The agent graphs load this key from workspace secrets for inference.
2223

2324
<Note icon="wand-magic-sparkles" iconType="regular">
2425
Agent Builder supports custom models per agent. See [Custom models](/langsmith/agent-builder-essentials#custom-models) for more information.
2526
</Note>
2627

27-
## Agent builder specific secrets
28+
### Agent builder specific secrets
2829

2930
Secrets prefixed with `AGENT_BUILDER_` are prioritized over workspace secrets within Agent Builder. This way, you can better track the usage of Agent Builder vs other parts of LangSmith which use the same secrets.
3031

3132
If you have both `OPENAI_API_KEY` and `AGENT_BUILDER_OPENAI_API_KEY`, the `AGENT_BUILDER_OPENAI_API_KEY` secret will be used.
3233

33-
## Optional tool keys
34+
### Optional tool keys
3435

3536
Add keys for any tools you enable. These are read from workspace secrets at runtime.
3637

3738
- `EXA_API_KEY`: Required for Exa search tools (general web and LinkedIn profile search).
3839
- `TAVILY_API_KEY`: Required for Tavily web search.
39-
- `TWITTER_API_KEY` and `TWITTER_API_KEY_SECRET`: Required for Twitter/X read operations (app‑only bearer). Posting/media upload is not enabled.
40+
- `TWITTER_API_KEY` and `TWITTER_API_KEY_SECRET`: Required for Twitter/X read operations (app-only bearer). Posting/media upload is not enabled.
4041

41-
## MCP server configuration
42+
### MCP server configuration
4243

4344
Agent Builder can pull tools from one or more remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers. Configure MCP servers and headers in your [workspace](/langsmith/administration-overview#workspaces) settings. Agent Builder automatically discovers tools and applies the configured headers when calling them.
4445

45-
For more details on using the remote MCP servers, refer to the the [MCP Framework](/langsmith/agent-builder-mcp-framework#using-remote-mcp-servers) page.
46+
For more information, refer to the [Remote MCP servers](/langsmith/agent-builder-remote-mcp-servers) page.

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

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,13 @@
11
---
22
title: Templates
33
description: Start faster with curated Agent Builder templates and customize tools, prompts, and triggers.
4-
sidebarTitle: Overview
5-
mode: wide
64
---
75

8-
Agent Builder includes starter templates to help you create agents quickly. Templates include predefined instructions, [_tools_](/langsmith/agent-builder-tools), and [_triggers_](/langsmith/agent-builder-essentials#triggers) (if applicable) for common use cases. You can use templates as-is, or as a baseline to customize.
6+
Agent Builder includes [starter templates]() to help you create agents quickly. Templates include predefined instructions, [_tools_](/langsmith/agent-builder-tools), and [_triggers_](/langsmith/agent-builder-essentials#triggers) (if applicable) for common use cases. You can use templates as-is, or as a baseline to customize.
97

10-
<Callout icon="rocket" color="#4F46E5" iconType="regular">
11-
If you're new to Agent Builder, start with the step-by-step [template quickstart](/langsmith/agent-builder-quickstart) to build your first agent using a template.
12-
</Callout>
8+
<Tip>
9+
If you're new to Agent Builder, start with the step-by-step [quickstart](/langsmith/agent-builder-quickstart) to build your first agent using a template.
10+
</Tip>
1311

1412
## Features
1513

@@ -30,3 +28,24 @@ Some templates include [triggers](/langsmith/agent-builder-essentials#triggers)
3028
### Cloning and customization
3129

3230
Templates serve as starting points that you clone to create your own agent. When you clone a template, you create an independent copy that you can customize without affecting the original. You can modify prompts, add or remove tools, attach different triggers, and switch models to tailor the agent to your requirements.
31+
32+
## Available templates
33+
34+
<CardGroup cols={2}>
35+
<Card title="Daily calendar brief" icon="calendar">
36+
A daily agent that scans your calendar and delivers a concise briefing with meeting details and important context.
37+
</Card>
38+
<Card title="Email assistant" icon="envelope">
39+
Automate email triage with an agent that flags important emails, drafts and sends replies, and schedules meetings.
40+
</Card>
41+
<Card title="LinkedIn recruiter" icon="users">
42+
Automate recruiting with an agent that digests candidate requirements, adapts to feedback, and outputs a candidate list.
43+
</Card>
44+
<Card title="Social media AI monitor" icon="newspaper">
45+
An agent that tracks top AI discussions from X lists and Hacker News, and delivers a daily Slack message with important updates.
46+
</Card>
47+
</CardGroup>
48+
49+
<Info>
50+
For more information, see [Templates](https://www.langchain.com/templates).
51+
</Info>

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -137,9 +137,9 @@ You can access a variety of tools in Agent Builder. Use built-in tools to give y
137137
You can also connect to remote MCP servers to give your agents access to additional tools. See [Remote MCP servers](/langsmith/agent-builder-remote-mcp-servers) for more information.
138138
</Tip>
139139

140-
## Disconnect an integration
140+
## Disconnect a tool
141141

142-
To disconnect a connected app (for example, Slack, Gmail, or GitHub):
142+
To remove a tool from your agent:
143143

144144
<Steps>
145145
<Step title="Open Agent settings">
@@ -151,4 +151,4 @@ To disconnect a connected app (for example, Slack, Gmail, or GitHub):
151151
<Step title="Disconnect">
152152
Click **Disconnect** for that integration.
153153
</Step>
154-
</Steps>
154+
</Steps>

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

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Agent visibility
3+
description: Understand the differences between private and workspace agents in Agent Builder.
4+
---
5+
6+
Agent Builder supports two visibility modes for agents:
7+
8+
- **Private agents**: Private to the creator. Useful for personal workflows and experiments.
9+
- **Workspace agents**: Shared within the workspace. Good for team workflows or for agents you want to share with others.
10+
11+
## Differences
12+
13+
| Feature | Private agents | Workspace agents |
14+
| --- | --- | --- |
15+
| **Ownership and access** | Only visible to you | Visible to anyone within the same LangSmith workspace |
16+
| **OAuth authentication** | OAuth credentials are scoped to you | OAuth credentials are scoped to each user; new users cloning workspace agents must re-authenticate with selected tools |
17+
| **Secrets** | Uses workspace-scoped LangSmith secrets | Uses workspace-scoped LangSmith secrets (same as private agents) |
18+
19+
## Workspace-scoped agent details
20+
21+
While workspace-scoped agents are shared, some details are public, while others are private.
22+
23+
### Threads/chat history
24+
25+
Threads are always user-scoped, so even if an agent is workspace-scoped, the chat history created within that agent will always be private and only accessible to the specific user who created them.
26+
27+
### System prompt, tools, sub-agents
28+
29+
The system prompt, selected tools, and sub-agents will be public on workspace-scoped agents. Users will not be able to modify these fields on the original workspace-scoped agent, but can make changes once they've cloned the agent.
30+
31+
### Triggers
32+
33+
The trigger type on workspace-scoped agents is public (for example, Slack message received), but the specific connection with the trigger (for example, the Slack channel, or Gmail address) is not shared. This way, users know what trigger to use when cloning an agent, but can't gain unauthorized access to any connections the original user has set up.

0 commit comments

Comments
 (0)