[PR #3798] [MERGED] docs(integrations): surface Perplexity Search retriever and tool #3817

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

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/3798
Author: @jliounis
Created: 4/29/2026
Status: Merged
Merged: 4/29/2026
Merged by: @mdrxy

Base: mainHead: docs/perplexity-search-integration


📝 Commits (3)

  • 1fb452a docs(integrations): surface Perplexity Search retriever and tool
  • ac0a74f docs(perplexity): address review feedback - migrate to create_agent, update model names
  • c0d2cf7 Merge branch 'main' into docs/perplexity-search-integration

📊 Changes

5 files changed (+309 additions, -1 deletions)

View changed files

📝 src/oss/python/integrations/providers/perplexity.mdx (+33 -1)
📝 src/oss/python/integrations/retrievers/index.mdx (+2 -0)
src/oss/python/integrations/retrievers/perplexity_search.mdx (+136 -0)
📝 src/oss/python/integrations/tools/index.mdx (+1 -0)
src/oss/python/integrations/tools/perplexity_search.mdx (+137 -0)

📄 Description

Overview

Surface the Perplexity Search API integration in LangChain's Python docs by documenting PerplexitySearchRetriever and PerplexitySearchResults (both already exist in langchain-perplexity) alongside the existing ChatPerplexity page.

  • Updates src/oss/python/integrations/providers/perplexity.mdx to add Retriever and Tools sections plus a components reference table.
  • Adds src/oss/python/integrations/tools/perplexity_search.mdx (mirrors the structure of tools/exa_search.mdx): standalone tool.invoke("query") example, advanced filter walkthrough, and a create_react_agent example.
  • Adds src/oss/python/integrations/retrievers/perplexity_search.mdx (mirrors the structure of retrievers/tavily.mdx): instantiation, filtered usage, and a simple RAG chain.
  • Adds discovery entries in tools/index.mdx (Search table) and retrievers/index.mdx (External index table + All retrievers card grid).

All constructor and call-time arguments are taken directly from langchain_perplexity.tools.PerplexitySearchResults and langchain_perplexity.retrievers.PerplexitySearchRetriever — no invented APIs.

Type of change

Type: New documentation page

Related issues/PRs

  • GitHub issue:
  • Feature PR:
  • Linear issue:
  • Slack thread:

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

(Internal team members only / optional): Create a preview deployment as necessary using the Create Preview Branch workflow

Additional notes

  • The src/docs.json integrations tab only enumerates per-component index pages and a curated "Popular Providers" list — it does not list every individual provider/tool/retriever page, so no docs.json change is needed for these new pages to appear at their canonical paths.
  • Pages link to the canonical Perplexity Search API docs (quickstart, API reference, domain filter, date/time filter) and to the Perplexity API key dashboard.
  • make check-cross-refs (the repo's cross-reference validator) and the unit test suite both pass on this branch.

🔄 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/3798 **Author:** [@jliounis](https://github.com/jliounis) **Created:** 4/29/2026 **Status:** ✅ Merged **Merged:** 4/29/2026 **Merged by:** [@mdrxy](https://github.com/mdrxy) **Base:** `main` ← **Head:** `docs/perplexity-search-integration` --- ### 📝 Commits (3) - [`1fb452a`](https://github.com/langchain-ai/docs/commit/1fb452aecd8c30b6bc4f6f7cb93ca62638051e93) docs(integrations): surface Perplexity Search retriever and tool - [`ac0a74f`](https://github.com/langchain-ai/docs/commit/ac0a74fa553dd5d2cc3a737cdaba758369c63d1d) docs(perplexity): address review feedback - migrate to create_agent, update model names - [`c0d2cf7`](https://github.com/langchain-ai/docs/commit/c0d2cf7a1c006d4cf54c9455190258fc88b2b41f) Merge branch 'main' into docs/perplexity-search-integration ### 📊 Changes **5 files changed** (+309 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `src/oss/python/integrations/providers/perplexity.mdx` (+33 -1) 📝 `src/oss/python/integrations/retrievers/index.mdx` (+2 -0) ➕ `src/oss/python/integrations/retrievers/perplexity_search.mdx` (+136 -0) 📝 `src/oss/python/integrations/tools/index.mdx` (+1 -0) ➕ `src/oss/python/integrations/tools/perplexity_search.mdx` (+137 -0) </details> ### 📄 Description ## Overview Surface the Perplexity Search API integration in LangChain's Python docs by documenting `PerplexitySearchRetriever` and `PerplexitySearchResults` (both already exist in `langchain-perplexity`) alongside the existing `ChatPerplexity` page. - Updates `src/oss/python/integrations/providers/perplexity.mdx` to add Retriever and Tools sections plus a components reference table. - Adds `src/oss/python/integrations/tools/perplexity_search.mdx` (mirrors the structure of `tools/exa_search.mdx`): standalone `tool.invoke("query")` example, advanced filter walkthrough, and a `create_react_agent` example. - Adds `src/oss/python/integrations/retrievers/perplexity_search.mdx` (mirrors the structure of `retrievers/tavily.mdx`): instantiation, filtered usage, and a simple RAG chain. - Adds discovery entries in `tools/index.mdx` (Search table) and `retrievers/index.mdx` (External index table + All retrievers card grid). All constructor and call-time arguments are taken directly from `langchain_perplexity.tools.PerplexitySearchResults` and `langchain_perplexity.retrievers.PerplexitySearchRetriever` — no invented APIs. ## Type of change **Type:** New documentation page ## Related issues/PRs - GitHub issue: - Feature PR: <!-- For LangChain employees, if applicable: --> - Linear issue: - Slack thread: ## Checklist - [x] I have read the [contributing guidelines](README.md), including the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy) - [x] 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 - [x] I have updated navigation in `src/docs.json` if needed (Internal team members only / optional): Create a preview deployment as necessary using the [Create Preview Branch workflow](https://github.com/langchain-ai/docs/actions/workflows/create-preview-branch.yml) ## Additional notes - The `src/docs.json` integrations tab only enumerates per-component `index` pages and a curated "Popular Providers" list — it does not list every individual provider/tool/retriever page, so no `docs.json` change is needed for these new pages to appear at their canonical paths. - Pages link to the canonical Perplexity Search API docs (quickstart, API reference, domain filter, date/time filter) and to the Perplexity API key dashboard. - `make check-cross-refs` (the repo's cross-reference validator) and the unit test suite both pass on this branch. --- <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:14 -04:00
yindo closed this issue 2026-06-05 18:53:14 -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#3817