Skip to content

Conversation

@kesku
Copy link

@kesku kesku commented Dec 19, 2025

Documentation updates for langchain-perplexity to align with the SDK overhaul introduced in langchain-ai/langchain#34412.

Type of change

Type: Update existing documentation

Related issues/PRs

Checklist

  • I have read the [contributing guidelines](README.md)
  • 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

Changes:

  • Added new documentation pages for PerplexitySearchRetriever
  • Added new documentation pages for PerplexitySearchResults
  • Expanded ChatPerplexity documentation:
    • Updated feature support table (Serializable, native async, image input)
    • Added Pro Search, Search Controls, and Async usage sections
    • Added image input model compatibility note
  • Fixed PerplexitySearchResults instantiation example (removed invalid parameters)
  • Added advanced usage examples for PerplexitySearchResults
  • Updated providers page to link to new retriever and tool documentation
  • Fixed model cards documentation link
  • Updated agent example to use create_react_agent

@kesku kesku requested a review from mdrxy as a code owner December 19, 2025 21:28
@github-actions github-actions bot added langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects external User is not a member of langchain-ai labels Dec 19, 2025
Co-authored-by: Mason Daugherty <github@mdrxy.com>
Copy link
Member

@mdrxy mdrxy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sorry, forgot to press submit for these yesterday:

@kesku kesku requested a review from mdrxy December 27, 2025 16:21

| Class | Package | Local | Serializable | JS support | Downloads | Version |
| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
| [PerplexitySearchResults](https://python.langchain.com/api_reference/perplexity/tools/langchain_perplexity.tools.PerplexitySearchResults.html) | [langchain-perplexity](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| [PerplexitySearchResults](https://python.langchain.com/api_reference/perplexity/tools/langchain_perplexity.tools.PerplexitySearchResults.html) | [langchain-perplexity](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |
| [`PerplexitySearchResults`](https://python.langchain.com/api_reference/perplexity/tools/langchain_perplexity.tools.PerplexitySearchResults.html) | [`langchain-perplexity`](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |

```python
from langchain.chat_models import init_chat_model
from langchain_perplexity import PerplexitySearchResults
from langgraph.prebuilt import create_react_agent
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We've moved away from create_react_agent in favor of create_agent in langchain. Can this example be rewritten?


| Class | Package | Local | Serializable | JS support | Downloads | Version |
| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
| [PerplexitySearchRetriever](https://python.langchain.com/api_reference/perplexity/retrievers/langchain_perplexity.retrievers.PerplexitySearchRetriever.html) | [langchain-perplexity](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| [PerplexitySearchRetriever](https://python.langchain.com/api_reference/perplexity/retrievers/langchain_perplexity.retrievers.PerplexitySearchRetriever.html) | [langchain-perplexity](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |
| [`PerplexitySearchRetriever`](https://python.langchain.com/api_reference/perplexity/retrievers/langchain_perplexity.retrievers.PerplexitySearchRetriever.html) | [`langchain-perplexity`](https://python.langchain.com/api_reference/perplexity/perplexity.html) |||| ![PyPI - Downloads](https://img.shields.io/pypi/dm/langchain-perplexity?style=flat-square&label=%20) | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-perplexity?style=flat-square&label=%20) |

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external User is not a member of langchain-ai langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants