diff --git a/src/docs.json b/src/docs.json index f46eec4ed4..eeb7979b8b 100644 --- a/src/docs.json +++ b/src/docs.json @@ -1301,6 +1301,7 @@ "pages": [ "langsmith/agent-builder-essentials", "langsmith/agent-builder-templates", + "langsmith/agent-builder-quickstart", "langsmith/agent-builder-setup", "langsmith/agent-builder-workspace-vs-private" ] diff --git a/src/langsmith/agent-builder-essentials.mdx b/src/langsmith/agent-builder-essentials.mdx index bcdb4adc30..b89f240723 100644 --- a/src/langsmith/agent-builder-essentials.mdx +++ b/src/langsmith/agent-builder-essentials.mdx @@ -30,7 +30,7 @@ Here are some popular ways to trigger your agent: ## Memory and updates -Your agents get smarter over time. They remember important information from previous conversations and can update themselves to work better. +Agents remember important information from previous conversations and can update themselves to work better. - Memory: Agents remember relevant details from past interactions, so they can make better decisions in future conversations. - Self-updates: Agents can add new tools, remove ones they don't need, or adjust their instructions to improve how they work. diff --git a/src/langsmith/agent-builder-quickstart.mdx b/src/langsmith/agent-builder-quickstart.mdx new file mode 100644 index 0000000000..bd35c5693f --- /dev/null +++ b/src/langsmith/agent-builder-quickstart.mdx @@ -0,0 +1,187 @@ +--- +title: Build an agent from a template +sidebarTitle: Template quickstart +--- + +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. + +Feel free to follow along with this example or you can: + +- Customize the instructions and tools for your own agent needs. +- Select a different template. + + +You'll interact with your agent through chat, just like texting a helpful assistant. + + +## Before you start + +You'll need: +- A LangSmith account ([sign up here](https://smith.langchain.com)). +- A Gmail account. +- A Google calendar. +- An OpenAI or Anthropic API key (Step 1 will show you how to get one). + +## Step 1. Get your API key + +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. + + + + 1. Go to [platform.openai.com/api-keys](https://platform.openai.com/api-keys). + 1. Click **Create new secret key**. + 1. Give it a name like "Agent Builder". + 1. Copy the key (it starts with `sk-`). + 1. Save it somewhere safe, you'll need it in Step 2. + + + + 1. Go to [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys). + 2. Click **Create Key**. + 3. Give it a name like "Agent Builder". + 4. Copy the key (it starts with `sk-ant-`). + 5. Save it somewhere safe, you'll need it in Step 2. + + + + +**Cost:** Both services charge based on use. + + +## Step 2. Add your API key to LangSmith + +Now you'll add your API key to LangSmith so your agents can use it: + + + + 1. Go to [smith.langchain.com](https://smith.langchain.com). + 2. Click the **Settings** icon in the bottom left. + + + + Click the **Secrets** tab at the top. + + + + 1. Click **Add secret**. + 2. For **Key**, enter: + - `OPENAI_API_KEY` (if using OpenAI) + - `ANTHROPIC_API_KEY` (if using Anthropic) + 3. For **Value**, paste the API key you copied in Step 1. + 4. Click **Save secret**. + + + + +Your agent now has access to an AI model to understand and respond to your requests. Next, you'll create your agent. + + +## Step 3. Create your agent + + + + 1. In the [LangSmith UI](https://smith.langchain.com), click **Switch to Agent Builder** at the top of the left-hand navigation. + + + + 1. Select **Templates** in the left-hand navigation. + 1. Select **Email Assistant** template. + 1. Click **Use this template**. + + + If you don't want to start with a template, you have two other options. From the **+ New Agent** page: + - Use the chat interface to describe your agent, and it will help you create it step-by-step. + - Select **Create manually instead** to build your agent without any pre-filled responses on the configuration page. + + + + + Your agent will ask you to connect your Google accounts: + + 1. Click **Connect**. + 2. Sign in with your Google account. + 3. Review permissions and click **Allow**. + 4. You'll be redirected back to LangSmith where your agent will be created. + + + + + +Your agent only accesses your accounts when working on tasks you give it. You can revoke access anytime in your Google account settings. + + +## Step 4. View the agent template + + + + + + At this point, you can review the template instructions for the email assistant. If needed, you can make adjustments to the instructions. + + If you made any changes, click **Save changes**. + + + + 1. In the right-hand panel of the configuration page, select the **Test Chat** tab. + 2. Try out the email assistant in the chat interface, for example: + + > _Apply a "Review" label to emails that I receive, which require some kind of review from me_ + + + + Your agent will start work and provide a **Continue** option for each step that requires your approval. + + Test chat output view with response including approvals for Gmail tool. + + Test chat output view with response including approvals for Gmail tool. + + 3. As you test out the agent, you can make edits to the instructions, or add tools that you may need. Click **Save changes** when you're happy with the results. + + + + + +## Edit your agent + +You may want to update your agent's instructions or include more tools. You can directly chat with your agent to ask for updates, or you can: + +1. From **My Agents** in the left-hand navigation, select the agent you want to edit. +1. Select **Edit Agent**. + +From the agent's edit page, you can: + +- Add tools with **+ Add tool** to connect more apps and services like Slack, GitHub, or Linear. +- Add further helpers with **+ Add sub-agent** to break complex tasks into specialized sub-tasks. +- Request pauses for reviews on existing tools. +- Modify existing tools. +- Explore features that can trigger your agent to start a task. + +## Next steps + +Now that you've created your first agent, here's what to explore: + + + + Explore pre-built agents for common tasks + + + + Run your agent automatically with triggers (Slack, email, schedules) + + + + Add Slack, GitHub, Linear, and more + + + + Use sub-agents to break down big tasks + + diff --git a/src/langsmith/agent-builder-templates.mdx b/src/langsmith/agent-builder-templates.mdx index 758771586f..eb0d481f4d 100644 --- a/src/langsmith/agent-builder-templates.mdx +++ b/src/langsmith/agent-builder-templates.mdx @@ -5,19 +5,23 @@ sidebarTitle: Templates mode: wide --- -Agent Builder includes starter templates to help you create agents quickly. Templates include predefined system prompts, tools, and triggers (if applicable) for common use cases. You can use templates as-is, or as a baseline to customize. +Agent Builder includes starter templates to help you create agents quickly. Templates include predefined instructions, [tools](/langsmith/agent-builder-tools), and triggers (if applicable) for common use cases. You can use templates as-is, or as a baseline to customize. + + +New to Agent Builder? Start with the step-by-step [template quickstart](/langsmith/agent-builder-quickstart) to build your first agent using a template. + ## How to use templates - + In Agent Builder, choose a template that matches your use case (e.g., Gmail assistant, Linear Slack bot, etc.). - 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). + Each template comes with instructions (also called a 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). - 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. + 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. If a template includes a trigger, you'll be prompted to: diff --git a/src/langsmith/images/agent-builder-edit-page-dark.png b/src/langsmith/images/agent-builder-edit-page-dark.png new file mode 100644 index 0000000000..e9475a9c99 Binary files /dev/null and b/src/langsmith/images/agent-builder-edit-page-dark.png differ diff --git a/src/langsmith/images/agent-builder-edit-page.png b/src/langsmith/images/agent-builder-edit-page.png new file mode 100644 index 0000000000..bf55999c6a Binary files /dev/null and b/src/langsmith/images/agent-builder-edit-page.png differ diff --git a/src/langsmith/images/agent-builder-response-dark.png b/src/langsmith/images/agent-builder-response-dark.png new file mode 100644 index 0000000000..2038badd5f Binary files /dev/null and b/src/langsmith/images/agent-builder-response-dark.png differ diff --git a/src/langsmith/images/agent-builder-response.png b/src/langsmith/images/agent-builder-response.png new file mode 100644 index 0000000000..a82633c955 Binary files /dev/null and b/src/langsmith/images/agent-builder-response.png differ