docs: platforms -> providers (#27285)

langchain-ai · Oct 16, 2024 · a38e903 · a38e903
1 parent fdb7f95
commit a38e903
Show file tree

Hide file tree

Showing 19 changed files with 68 additions and 43 deletions.
diff --git a/README.md b/README.md
@@ -38,7 +38,7 @@ conda install langchain -c conda-forge
 
 For these applications, LangChain simplifies the entire application lifecycle:
 
-- **Open-source libraries**: Build your applications using LangChain's open-source [building blocks](https://python.langchain.com/docs/concepts/#langchain-expression-language-lcel), [components](https://python.langchain.com/docs/concepts/), and [third-party integrations](https://python.langchain.com/docs/integrations/platforms/).
+- **Open-source libraries**: Build your applications using LangChain's open-source [building blocks](https://python.langchain.com/docs/concepts/#langchain-expression-language-lcel), [components](https://python.langchain.com/docs/concepts/), and [third-party integrations](https://python.langchain.com/docs/integrations/providers/).
   Use [LangGraph](https://langchain-ai.github.io/langgraph/) to build stateful agents with first-class streaming and human-in-the-loop support.
 - **Productionization**: Inspect, monitor, and evaluate your apps with [LangSmith](https://docs.smith.langchain.com/) so that you can constantly optimize and deploy with confidence.
 - **Deployment**: Turn your LangGraph applications into production-ready APIs and Assistants with [LangGraph Cloud](https://langchain-ai.github.io/langgraph/cloud/).

diff --git a/docs/Makefile b/docs/Makefile
@@ -18,7 +18,7 @@ for dir; do \
     if find "$$dir" -maxdepth 1 -type f \( -name "pyproject.toml" -o -name "setup.py" \) | grep -q .; then \
         echo "$$dir"; \
     fi \
-done' sh {} + | grep -vE "airbyte|ibm|couchbase|databricks" | tr '\n' ' ')
+done' sh {} + | grep -vE "airbyte|ibm|databricks" | tr '\n' ' ')
 
 PORT ?= 3001
 

diff --git a/docs/api_reference/guide_imports.json b/docs/api_reference/guide_imports.json
diff --git a/docs/docs/how_to/convert_runnable_to_tool.ipynb b/docs/docs/how_to/convert_runnable_to_tool.ipynb
@@ -21,7 +21,7 @@
     "\n",
     "## Dependencies\n",
     "\n",
-    "**Note**: this guide requires `langchain-core` >= 0.2.13. We will also use [OpenAI](/docs/integrations/platforms/openai/) for embeddings, but any LangChain embeddings should suffice. We will use a simple [LangGraph](https://langchain-ai.github.io/langgraph/) agent for demonstration purposes."
+    "**Note**: this guide requires `langchain-core` >= 0.2.13. We will also use [OpenAI](/docs/integrations/providers/openai/) for embeddings, but any LangChain embeddings should suffice. We will use a simple [LangGraph](https://langchain-ai.github.io/langgraph/) agent for demonstration purposes."
    ]
   },
   {

diff --git a/docs/docs/how_to/installation.mdx b/docs/docs/how_to/installation.mdx
@@ -50,7 +50,7 @@ pip install langchain-core
 ### Integration packages
 
 Certain integrations like OpenAI and Anthropic have their own packages.
-Any integrations that require their own package will be documented as such in the [Integration docs](/docs/integrations/platforms/).
+Any integrations that require their own package will be documented as such in the [Integration docs](/docs/integrations/providers/).
 You can see a list of all integration packages in the [API reference](https://api.python.langchain.com) under the "Partner libs" dropdown.
 To install one of these run:
 

diff --git a/...docs/integrations/platforms/anthropic.mdx → ...docs/integrations/providers/anthropic.mdx b/...docs/integrations/platforms/anthropic.mdx → ...docs/integrations/providers/anthropic.mdx
diff --git a/docs/docs/integrations/platforms/aws.mdx → docs/docs/integrations/providers/aws.mdx b/docs/docs/integrations/platforms/aws.mdx → docs/docs/integrations/providers/aws.mdx
diff --git a/docs/docs/integrations/providers/databricks.md b/docs/docs/integrations/providers/databricks.md
@@ -113,7 +113,7 @@ See [Databricks SQL Agent](https://docs.databricks.com/en/large-language-models/
 Open Models
 -----------
 
-To directly integrate Databricks's open models hosted on HuggingFace, you can use the [HuggingFace Integration](/docs/integrations/platforms/huggingface) of LangChain.
+To directly integrate Databricks's open models hosted on HuggingFace, you can use the [HuggingFace Integration](/docs/integrations/providers/huggingface) of LangChain.
 
 ```
 from langchain_huggingface import HuggingFaceEndpoint

diff --git a/docs/docs/integrations/platforms/google.mdx → docs/docs/integrations/providers/google.mdx b/docs/docs/integrations/platforms/google.mdx → docs/docs/integrations/providers/google.mdx
diff --git a/...cs/integrations/platforms/huggingface.mdx → ...cs/integrations/providers/huggingface.mdx b/...cs/integrations/platforms/huggingface.mdx → ...cs/integrations/providers/huggingface.mdx
diff --git a/...docs/integrations/platforms/microsoft.mdx → ...docs/integrations/providers/microsoft.mdx b/...docs/integrations/platforms/microsoft.mdx → ...docs/integrations/providers/microsoft.mdx
diff --git a/docs/docs/integrations/platforms/openai.mdx → docs/docs/integrations/providers/openai.mdx b/docs/docs/integrations/platforms/openai.mdx → docs/docs/integrations/providers/openai.mdx
diff --git a/docs/docs/integrations/text_embedding/google_vertex_ai_palm.ipynb b/docs/docs/integrations/text_embedding/google_vertex_ai_palm.ipynb
@@ -25,7 +25,7 @@
     "\n",
     "| Provider | Package |\n",
     "|:--------:|:-------:|\n",
-    "| [Google](https://python.langchain.com/docs/integrations/platforms/google/) | [langchain-google-vertexai](https://python.langchain.com/api_reference/google_vertexai/embeddings/langchain_google_vertexai.embeddings.VertexAIEmbeddings.html) |\n",
+    "| [Google](https://python.langchain.com/docs/integrations/providers/google/) | [langchain-google-vertexai](https://python.langchain.com/api_reference/google_vertexai/embeddings/langchain_google_vertexai.embeddings.VertexAIEmbeddings.html) |\n",
     "\n",
     "## Setup\n",
     "\n",

diff --git a/docs/docs/introduction.mdx b/docs/docs/introduction.mdx
@@ -8,7 +8,7 @@ sidebar_class_name: hidden
 **LangChain** is a framework for developing applications powered by large language models (LLMs).
 
 LangChain simplifies every stage of the LLM application lifecycle:
-- **Development**: Build your applications using LangChain's open-source [building blocks](/docs/concepts#langchain-expression-language-lcel), [components](/docs/concepts), and [third-party integrations](/docs/integrations/platforms/).
+- **Development**: Build your applications using LangChain's open-source [building blocks](/docs/concepts#langchain-expression-language-lcel), [components](/docs/concepts), and [third-party integrations](/docs/integrations/providers/).
 Use [LangGraph](/docs/concepts/#langgraph) to build stateful agents with first-class streaming and human-in-the-loop support.
 - **Productionization**: Use [LangSmith](https://docs.smith.langchain.com/) to inspect, monitor and evaluate your chains, so that you can continuously optimize and deploy with confidence.
 - **Deployment**: Turn your LangGraph applications into production-ready APIs and Assistants with [LangGraph Cloud](https://langchain-ai.github.io/langgraph/cloud/).

diff --git a/docs/docs/versions/v0_2/overview.mdx b/docs/docs/versions/v0_2/overview.mdx
@@ -17,7 +17,7 @@ The following features have been added during the development of 0.1.x:
 - Include response metadata in `AIMessage` to make it easy to access raw output from the underlying models
 - Tooling to visualize [your runnables](https://python.langchain.com/docs/expression_language/how_to/inspect/) or [your langgraph app](https://github.com/langchain-ai/langgraph/blob/main/examples/visualization.ipynb)
 - Interoperability of chat message histories across most providers
-- [Over 20+ partner packages in python](https://python.langchain.com/docs/integrations/platforms/) for popular integrations
+- [Over 20+ partner packages in python](https://python.langchain.com/docs/integrations/providers/) for popular integrations
 
 
 ## What’s coming to LangChain?

diff --git a/docs/scripts/partner_pkg_table.py b/docs/scripts/partner_pkg_table.py
@@ -8,7 +8,7 @@
 PLATFORMS = {
     path.split("/")[-1][:-4]
     for path in glob.glob(
-        str(DOCS_DIR) + "/docs/integrations/platforms/*.mdx", recursive=True
+        str(DOCS_DIR) + "/docs/integrations/providers/*.mdx", recursive=True
     )
 }
 EXTERNAL_PACKAGES = {
@@ -71,15 +71,15 @@
     "airbyte": "Airbyte",
 }
 CUSTOM_PROVIDER_PAGES = {
-    "azure-dynamic-sessions": "/docs/integrations/platforms/microsoft/",
-    "google-community": "/docs/integrations/platforms/google/",
-    "google-genai": "/docs/integrations/platforms/google/",
-    "google-vertexai": "/docs/integrations/platforms/google/",
+    "azure-dynamic-sessions": "/docs/integrations/providers/microsoft/",
+    "google-community": "/docs/integrations/providers/google/",
+    "google-genai": "/docs/integrations/providers/google/",
+    "google-vertexai": "/docs/integrations/providers/google/",
     "nvidia-ai-endpoints": "/docs/integrations/providers/nvidia/",
     "exa": "/docs/integrations/providers/exa_search/",
     "mongodb": "/docs/integrations/providers/mongodb_atlas/",
 }
-PLATFORM_PAGES = {name: f"/docs/integrations/platforms/{name}/" for name in PLATFORMS}
+PLATFORM_PAGES = {name: f"/docs/integrations/providers/{name}/" for name in PLATFORMS}
 PROVIDER_PAGES = {
     name: f"/docs/integrations/providers/{name}/"
     for name in ALL_PACKAGES
@@ -104,7 +104,7 @@ def package_row(name: str) -> str:
 
 
 def table() -> str:
-    header = """| Provider | Package | Downloads | Latest | [JS](https://js.langchain.com/docs/integrations/platforms/) |
+    header = """| Provider | Package | Downloads | Latest | [JS](https://js.langchain.com/docs/integrations/providers/) |
 | :--- | :---: | :---: | :---: | :---: |
 """
     return header + "\n".join(package_row(name) for name in sorted(ALL_PACKAGES))
@@ -136,12 +136,12 @@ def doc() -> str:
 
 ## All Providers
 
-Click [here](/docs/integrations/providers/) to see all providers.
+Click [here](/docs/integrations/providers/all) to see all providers.
 
 """
 
 
 if __name__ == "__main__":
-    output_dir = Path(sys.argv[1]) / "integrations" / "platforms"
+    output_dir = Path(sys.argv[1]) / "integrations" / "providers"
     with open(output_dir / "index.mdx", "w") as f:
         f.write(doc())
diff --git a/docs/sidebars.js b/docs/sidebars.js
@@ -126,28 +126,49 @@ module.exports = {
       collapsible: false,
       items: [
         {
-          type: "autogenerated",
-          dirName: "integrations/platforms",
+          type: "doc",
+          id: "integrations/providers/anthropic",
+        },
+        {
+          type: "doc",
+          id: "integrations/providers/aws",
+        },
+        {
+          type: "doc",
+          id: "integrations/providers/google",
+        },
+        {
+          type: "doc",
+          id: "integrations/providers/huggingface",
+        },
+        {
+          type: "doc",
+          id: "integrations/providers/microsoft",
+        },
+        {
+          type: "doc",
+          id: "integrations/providers/openai",
         },
         {
           type: "category",
           label: "More",
-          collapsed: true,
+          collapsible: false,
           items: [
             {
               type: "autogenerated",
               dirName: "integrations/providers",
+              className: "hidden",
             },
           ],
           link: {
             type: "generated-index",
-            slug: "integrations/providers",
+            slug: "integrations/providers/all",
           },
         },
       ],
       link: {
         type: "doc",
-        id: "integrations/platforms/index",
+        id: "integrations/providers/index",
       },
     },
     {

diff --git a/docs/src/theme/NotFound/Content/index.js b/docs/src/theme/NotFound/Content/index.js
@@ -2769,8 +2769,8 @@ const suggestedLinks = {
   "/docs/integrations/chat/hunyuan/": {"canonical": "/docs/integrations/chat/tencent_hunyuan/"},
   "/docs/integrations/document_loaders/excel/": {"canonical": "/docs/integrations/document_loaders/microsoft_excel/"},
   "/docs/integrations/document_loaders/onenote/": {"canonical": "/docs/integrations/document_loaders/microsoft_onenote/"},
-  "/docs/integrations/providers/aws_dynamodb/": {"canonical": "/docs/integrations/platforms/aws/"},
-  "/docs/integrations/providers/scann/": {"canonical": "/docs/integrations/platforms/google/"},
+  "/docs/integrations/providers/aws_dynamodb/": {"canonical": "/docs/integrations/providers/aws/"},
+  "/docs/integrations/providers/scann/": {"canonical": "/docs/integrations/providers/google/"},
   "/docs/integrations/toolkits/google_drive/": {"canonical": "/docs/integrations/tools/google_drive/"},
   "/docs/use_cases/question_answering/chat_vector_db/": {"canonical": "/docs/tutorials/rag/", "alternative": ["/v0.1/docs/use_cases/question_answering/"]},
   "/docs/use_cases/question_answering/in_memory_question_answering/": {"canonical": "/docs/tutorials/rag/", "alternative": ["/v0.1/docs/use_cases/question_answering/"]},
@@ -2791,24 +2791,24 @@ const suggestedLinks = {
   "/docs/integrations/": {"canonical": "/docs/integrations/providers/"},
   "/docs/expression_language/cookbook/routing/": {"canonical": "/docs/how_to/routing/", "alternative": ["/v0.1/docs/expression_language/how_to/routing/"]},
   "/docs/guides/expression_language/": {"canonical": "/docs/how_to/#langchain-expression-language-lcel", "alternative": ["/v0.1/docs/expression_language/"]},
-  "/docs/integrations/providers/amazon_api_gateway/": {"canonical": "/docs/integrations/platforms/aws/"},
-  "/docs/integrations/providers/huggingface/": {"canonical": "/docs/integrations/platforms/huggingface/"},
-  "/docs/integrations/providers/azure_blob_storage/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/google_vertexai_matchingengine/": {"canonical": "/docs/integrations/platforms/google/"},
-  "/docs/integrations/providers/aws_s3/": {"canonical": "/docs/integrations/platforms/aws/"},
-  "/docs/integrations/providers/azure_openai/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/azure_cognitive_search_/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/bedrock/": {"canonical": "/docs/integrations/platforms/aws/"},
-  "/docs/integrations/providers/google_bigquery/": {"canonical": "/docs/integrations/platforms/google/"},
-  "/docs/integrations/providers/google_cloud_storage/": {"canonical": "/docs/integrations/platforms/google/"},
-  "/docs/integrations/providers/google_drive/": {"canonical": "/docs/integrations/platforms/google/"},
-  "/docs/integrations/providers/google_search/": {"canonical": "/docs/integrations/platforms/google/"},
-  "/docs/integrations/providers/microsoft_onedrive/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/microsoft_powerpoint/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/microsoft_word/": {"canonical": "/docs/integrations/platforms/microsoft/"},
-  "/docs/integrations/providers/sagemaker_endpoint/": {"canonical": "/docs/integrations/platforms/aws/"},
+  "/docs/integrations/providers/amazon_api_gateway/": {"canonical": "/docs/integrations/providers/aws/"},
+  "/docs/integrations/providers/huggingface/": {"canonical": "/docs/integrations/providers/huggingface/"},
+  "/docs/integrations/providers/azure_blob_storage/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/google_vertexai_matchingengine/": {"canonical": "/docs/integrations/providers/google/"},
+  "/docs/integrations/providers/aws_s3/": {"canonical": "/docs/integrations/providers/aws/"},
+  "/docs/integrations/providers/azure_openai/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/azure_cognitive_search_/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/bedrock/": {"canonical": "/docs/integrations/providers/aws/"},
+  "/docs/integrations/providers/google_bigquery/": {"canonical": "/docs/integrations/providers/google/"},
+  "/docs/integrations/providers/google_cloud_storage/": {"canonical": "/docs/integrations/providers/google/"},
+  "/docs/integrations/providers/google_drive/": {"canonical": "/docs/integrations/providers/google/"},
+  "/docs/integrations/providers/google_search/": {"canonical": "/docs/integrations/providers/google/"},
+  "/docs/integrations/providers/microsoft_onedrive/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/microsoft_powerpoint/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/microsoft_word/": {"canonical": "/docs/integrations/providers/microsoft/"},
+  "/docs/integrations/providers/sagemaker_endpoint/": {"canonical": "/docs/integrations/providers/aws/"},
   "/docs/integrations/providers/sagemaker_tracking/": {"canonical": "/docs/integrations/callbacks/sagemaker_tracking/"},
-  "/docs/integrations/providers/openai/": {"canonical": "/docs/integrations/platforms/openai/"},
+  "/docs/integrations/providers/openai/": {"canonical": "/docs/integrations/providers/openai/"},
   "/docs/integrations/cassandra/": {"canonical": "/docs/integrations/providers/cassandra/"},
   "/docs/integrations/providers/providers/semadb/": {"canonical": "/docs/integrations/providers/semadb/"},
   "/docs/integrations/vectorstores/vectorstores/semadb/": {"canonical": "/docs/integrations/vectorstores/semadb/"},
@@ -2819,7 +2819,7 @@ const suggestedLinks = {
   "/docs/integrations/document_loaders/Etherscan/": {"canonical": "/docs/integrations/document_loaders/etherscan/"},
   "/docs/integrations/document_loaders/merge_doc_loader/": {"canonical": "/docs/integrations/document_loaders/merge_doc/"},
   "/docs/integrations/document_loaders/recursive_url_loader/": {"canonical": "/docs/integrations/document_loaders/recursive_url/"},
-  "/docs/integrations/providers/google_document_ai/": {"canonical": "/docs/integrations/platforms/google/"},
+  "/docs/integrations/providers/google_document_ai/": {"canonical": "/docs/integrations/providers/google/"},
   "/docs/integrations/memory/motorhead_memory_managed/": {"canonical": "/docs/integrations/memory/motorhead_memory/"},
   "/docs/integrations/memory/dynamodb_chat_message_history/": {"canonical": "/docs/integrations/memory/aws_dynamodb/"},
   "/docs/integrations/memory/entity_memory_with_sqlite/": {"canonical": "/docs/integrations/memory/sqlite/"},

diff --git a/docs/vercel.json b/docs/vercel.json
@@ -81,6 +81,10 @@
     {
       "source": "/docs/integrations/providers/mlflow_ai_gateway(/?)",
       "destination": "/docs/integrations/providers/mlflow/"
+    },
+    {
+      "source": "/docs/integrations/platforms/:path((?:anthropic|aws|google|huggingface|microsoft|openai)?/?)*",
+      "destination": "/docs/integrations/providers/:path*"
     }
   ]
 }