[PR #3870] [CLOSED] docs: fix broken create_agent reference link in LangGraph v1 migratio… #3887

Closed
opened 2026-06-05 18:53:28 -04:00 by yindo · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3870
Author: @monikagotnochills
Created: 5/5/2026
Status: Closed

Base: mainHead: fix/3630-create-agent-link


📝 Commits (2)

  • 266fdc3 docs: fix broken create_agent reference link in LangGraph v1 migration guide
  • 3095a05 Merge branch 'main' into fix/3630-create-agent-link

📊 Changes

1 file changed (+1 additions, -1 deletions)

View changed files

📝 src/oss/python/migrate/langgraph-v1.mdx (+1 -1)

📄 Description

docs: fix broken create_agent reference link in LangGraph v1 migration guide

The deprecation table used @[langchain.agents.create_agent][create_agent] as the display text, which points users to a 'Symbol Not Found' page at /python/langchain/agents/create_agent. Replaced with the @[create_agent] shorthand to match the rest of the file and resolve correctly via link_map.py to /python/langchain/agents/factory/create_agent. Fixes #3630

Overview

The LangGraph v1 migration guide has a broken reference in the deprecation table. The entry for create_react_agent links to create_agent using the full display text langchain.agents.create_agent, but this path doesn't exist on the reference site — it returns a "Symbol Not Found" error. The actual symbol lives under langchain.agents.factory.create_agent.

Swapped it to use the @[create_agent] shorthand (same pattern already used on lines 21, 37, 38, and 42 of the same file), which resolves correctly through link_map.py.

Type of change

Type: Fix typo/bug/link/formatting

Related issues/PRs

  • GitHub issue: closes #3630

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Additional notes

Verified both URLs manually:

  • /python/langchain/agents/create_agent → "Symbol Not Found" page
  • /python/langchain/agents/factory/create_agent → correct API reference page

Single-line change; no other files affected.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/3870 **Author:** [@monikagotnochills](https://github.com/monikagotnochills) **Created:** 5/5/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `fix/3630-create-agent-link` --- ### 📝 Commits (2) - [`266fdc3`](https://github.com/langchain-ai/docs/commit/266fdc369474f9d64baf7b6cbc274992657afaa1) docs: fix broken create_agent reference link in LangGraph v1 migration guide - [`3095a05`](https://github.com/langchain-ai/docs/commit/3095a0574e9c7ea70f7bbc81189aa6b7fc1aba0c) Merge branch 'main' into fix/3630-create-agent-link ### 📊 Changes **1 file changed** (+1 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/python/migrate/langgraph-v1.mdx` (+1 -1) </details> ### 📄 Description docs: fix broken create_agent reference link in LangGraph v1 migration guide The deprecation table used @[langchain.agents.create_agent][create_agent] as the display text, which points users to a 'Symbol Not Found' page at /python/langchain/agents/create_agent. Replaced with the @[create_agent] shorthand to match the rest of the file and resolve correctly via link_map.py to /python/langchain/agents/factory/create_agent. Fixes #3630 ## Overview The LangGraph v1 migration guide has a broken reference in the deprecation table. The entry for `create_react_agent` links to `create_agent` using the full display text `langchain.agents.create_agent`, but this path doesn't exist on the reference site — it returns a "Symbol Not Found" error. The actual symbol lives under `langchain.agents.factory.create_agent`. Swapped it to use the `@[create_agent]` shorthand (same pattern already used on lines 21, 37, 38, and 42 of the same file), which resolves correctly through `link_map.py`. ## Type of change **Type:** Fix typo/bug/link/formatting ## Related issues/PRs - GitHub issue: closes #3630 ## Checklist - [x] I have read the [contributing guidelines](README.md), including the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy) - [ ] 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 - [ ] I have updated navigation in `src/docs.json` if needed ## Additional notes Verified both URLs manually: - `/python/langchain/agents/create_agent` → "Symbol Not Found" page - `/python/langchain/agents/factory/create_agent` → correct API reference page Single-line change; no other files affected. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 18:53:28 -04:00
yindo closed this issue 2026-06-05 18:53:28 -04:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#3887