Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex AI Studio
    • About Yandex AI Studio
      • Overview of AI agents
      • Voice agents
        • AI assistants
        • Source files
        • AI Assistant API search indexes
          • Overview
          • Retrieval
          • WebSearch
          • Rephrasing queries
    • Yandex Workflows
    • Quotas and limits
    • Terms and definitions
  • Compatibility with OpenAI
  • Access management
  • Pricing policy
  • Audit Trails events
  • Public materials
  • Release notes
  1. Concepts
  2. Agent Atelier
  3. AI Assistant API
  4. Tools
  5. Rephrasing queries

Rephrasing queries

Written by
Yandex Cloud
Updated at November 6, 2025

Note

We do not recommend using AI Assistant API in new projects. To create AI agents, use the Responses API.

AI Assistant API offers a model fine-tuned to correct typos and rephrase a query based on your chat history with the assistant. This is helpful when extensive search index data is used to generate responses in highly context-aware interactions.

You can connect the model as an additional tool for your assistant. For each new query, the paraphrase model will use the conversation context to decide whether the user's query has to be modified in any way before running a search on the connected search index and querying the main model. This means you do not need to edit your prompt to the assistant or give additional instructions to the paraphrase model.

Model URI Context
Paraphrasing gpt://<folder_ID>/rephraser/latest 32,000

To use paraphrasing, add the rephraser tool to your assistant's list of tools. Requests to the paraphrase model are charged as per the YandexGPT Lite pricing policy.

SDK
cURL
...
rephraser = sdk.tools.rephraser('rephraser', model_version='latest')
sdk.tools.search_index(search_index, rephraser=True)
...
{
  "folderId": "<folder_ID>",
  "name": "<assistant_name>",
  },
  "labels": "object",
  "modelUri": "<assistant_model_URI>",
  "instruction": "<instruction>",
  ...
  "tools": [
    {
      "searchIndex": {
        "searchIndexIds": [
          "<search_index_ID>"
        ],
        "rephraserOptions": {
          "rephraserUri": "gpt://<folder_ID>/rephraser/latest"
        }
      }
    }
  ]
}

To test the paraphrase model, you can access it directly.

Usage exampleUsage example

Creating a RAG assistant with query rephrasing

Was the article helpful?

Previous
WebSearch
Next
Vector Store search indexes
© 2025 Direct Cursus Technology L.L.C.