LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • MCP Adapters
    • Overview
    • Agents
    • Callbacks
    • Chains
    • Chat models
    • Embeddings
    • Evaluation
    • Globals
    • Hub
    • Memory
    • Output parsers
    • Retrievers
    • Runnables
    • LangSmith
    • Storage
    Standard Tests
    Text Splitters
    ⌘I

    LangChain Assistant

    Ask a question to get started

    Enter to send•Shift+Enter new line

    Menu

    MCP Adapters
    OverviewAgentsCallbacksChainsChat modelsEmbeddingsEvaluationGlobalsHubMemoryOutput parsersRetrieversRunnablesLangSmithStorage
    Standard Tests
    Text Splitters
    Language
    Theme
    Pythonlangchain-classicretrieversdocument_compressorscohere_rerankCohereRerankrerank
    Method●Since v1.0

    rerank

    Returns an ordered list of documents ordered by their relevance to the provided query.

    Copy
    rerank(
      self,
      documents: Sequence[str | Document | dict],
      query: str,
      *,
      model: str | None = None,
      top_n: int | None = 1,
      max_chunks_per_doc: int | None = None
    ) -> list[dict[str, Any]]

    Parameters

    NameTypeDescription
    query*str

    The query to use for reranking.

    documents*Sequence[str | Document | dict]

    A sequence of documents to rerank.

    modelstr | None
    Default:None

    The model to use for re-ranking. Default to self.model.

    top_n *unknown

    The number of results to return. If None returns all results.

    max_chunks_per_doc *unknown

    The maximum number of chunks derived from a document.

    View source on GitHub