Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.langchain.com/llms.txt

Use this file to discover all available pages before exploring further.

The Context Hub gives your team version-controlled, environment-aware management of the instructions and tools your agents use in production. A context is a versioned bundle of agent instructions and tools, either a skill or a full agent, that you manage in LangSmith. Use this guide to create your first context, view its files and history, and promote it to an environment so your agents can pull it.

1. Open the Context Hub

If you don’t see Context in the left-hand navigation, verify that Context Hub is enabled for your workspace and that you have the required permissions.
In the LangSmith UI, select Context in the left-hand navigation. The Context Hub lists every agent and skill in your workspace. The Context Hub home view listing existing Agent and Skill contexts with their commit metadata.

2. Create a context

  1. Click + Create in the top left of the Context Hub.
  2. Choose the context type:
    • Agent: a full agent bundle including an AGENTS.md file and tools.
    • Skill: a reusable capability that agents can use, including a SKILL.md file.
    The Create dropdown showing the Agent and Skill context type options.
  3. Fill in a name and description. For skills, a description is required. You can also enter the initial file contents (SKILL.md for a skill, AGENTS.md for an agent) now, or add them after creation. Click Create Agent or Create Skill. LangSmith creates the repo and opens it for editing.

3. View a context

Click on an agent or skill from the Context Hub to view it. An Agent context with an AGENTS.md file open, showing the environments panel, commit history, and file tree. The middle panel shows the file tree for the current commit and the right panel previews the selected file. Click a file in the middle panel to open it, then edit it in the right panel and save your changes to create a new commit. Each saved change creates a new commit in the Commit History panel on the left, so you can browse, compare, and revert prior versions without losing work.

4. Tag and promote a commit

Once a commit is ready to ship, promote it to an environment so downstream agents can pull it.
Context Hub currently supports two environment tags for promotion: staging and production.
  1. With the target commit selected, click Promote in the top right.
  2. Choose the destination environment:
    • Promote to Production: the commit your production agents pull.
    • Promote to Staging: a pre-production environment for validation.
    The Promote dropdown with options to promote a commit to Production or Staging.
  3. The environment label (for example, Production 7ca95573) moves to the promoted commit. Use the Tag button next to Promote to attach a human-readable label to any commit for easy reference.
Agent runtimes that resolve context by environment tag (for example, :production) now pull this promoted commit.

Next steps