docs/file_search

How it works
The file_search tool implements several retrieval best practices out of the box to help you extract the right data from your files and augment the model’s responses. The file_search tool:

Rewrites user queries to optimize them for search.
Breaks down complex user queries into multiple searches it can run in parallel.
Runs both keyword and semantic searches across both assistant and thread vector stores.
Reranks search results to pick the most relevant ones before generating the final response.
By default, the file_search tool uses the following settings but these can be configured to suit your needs:

Chunk size: 800 tokens
Chunk overlap: 400 tokens
Embedding model: text-embedding-3-large at 256 dimensions
Maximum number of chunks added to context: 20 (could be fewer)
Ranker: auto (OpenAI will choose which ranker to use)
Score threshold: 0 minimum ranking score
Known Limitations

We have a few known limitations we're working on adding support for in the coming months:

Support for deterministic pre-search filtering using custom metadata.
Support for parsing images within documents (including images of charts, graphs, tables etc.)
Support for retrievals over structured file formats (like csv or jsonl).
Better support for summarization — the tool today is optimized for search queries.












RETRIEVAL
https://platform.openai.com/docs/guides/retrieval?attributes-filter-example=filename&vector-store-operations=create&vector-store-batch-operations=update


Attributes
Each vector_store.file can have associated attributes, a dictionary of values that can be referenced when performing semantic search with attribute filtering.
The dictionary can have at most 16 keys, with a limit of 256 characters each.

Create vector store file with attributes
client.vector_stores.files.create(
    vector_store_id="vs_123",
    file_id="file_123",
    attributes={
        "region": "US",
        "category": "Marketing",
        "date": 1672531200      # Jan 1, 2023
    }
)




Chunking
By default, max_chunk_size_tokens is set to 800 and chunk_overlap_tokens is set to 400, meaning every file is indexed by being split up into 800-token chunks,
with 400-token overlap between consecutive chunks.

You can adjust this by setting chunking_strategy when adding files to the vector store. There are certain limitations to chunking_strategy:

max_chunk_size_tokens must be between 100 and 4096 inclusive.
chunk_overlap_tokens must be non-negative and should not exceed max_chunk_size_tokens / 2.




############ Vector store operations
CREATE
client.vector_stores.create(
    name="Support FAQ",
    file_ids=["file_123"]
)

UPDATE
client.vector_stores.update(
    vector_store_id="vs_123",
    name="Support FAQ Updated"
)


############ Vector store file operations
CREATE
client.vector_stores.files.create_and_poll(
    vector_store_id="vs_123",
    file_id="file_123"
)


BATCH CREATE
client.vector_stores.file_batches.create_and_poll(
    vector_store_id="vs_123",
    file_ids=["file_123", "file_456"]
)

UPDATE
client.vector_stores.files.update(
    vector_store_id="vs_123",
    file_id="file_123",
    attributes={"key": "value"}
)
LIST
client.vector_stores.files.list(
    vector_store_id="vs_123"
)

############# ATTRIBUTES
Each vector_store.file can have associated attributes, a dictionary of values that can be referenced when performing semantic search with attribute filtering.
The dictionary can have at most 16 keys, with a limit of 256 characters each.

CREATE VS FILE WITH ATTRIBUTES
client.vector_stores.files.create(
    vector_store_id="vs_123",
    file_id="file_123",
    attributes={
        "region": "US",
        "category": "Marketing",
        "date": 1672531200      # Jan 1, 2023
    }
)

SEARCH QUERY
user_query = "What is the return policy?"

results = client.vector_stores.search(
    vector_store_id=vector_store.id,
    query=user_query,
)


FILE SEARCH TOOL
from openai import OpenAI
client = OpenAI()

response = client.responses.create(
    model="gpt-4o-mini",
    input="What is deep research by OpenAI?",
    tools=[{
        "type": "file_search",
        "vector_store_ids": ["<vector_store_id>"]
    }]
)
print(response)

RESPONSE
{
  "output": [
    {
      "type": "file_search_call",
      "id": "fs_67c09ccea8c48191ade9367e3ba71515",
      "status": "completed",
      "queries": ["What is deep research?"],
      "search_results": null
    },
    {
      "id": "msg_67c09cd3091c819185af2be5d13d87de",
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Deep research is a sophisticated capability that allows for extensive inquiry and synthesis of information across various domains. It is designed to conduct multi-step research tasks, gather data from multiple online sources, and provide comprehensive reports similar to what a research analyst would produce. This functionality is particularly useful in fields requiring detailed and accurate information...",
          "annotations": [
            {
              "type": "file_citation",
              "index": 992,
              "file_id": "file-2dtbBZdjtDKS8eqWxqbgDi",
              "filename": "deep_research_blog.pdf"
            },
            {
              "type": "file_citation",
              "index": 992,
              "file_id": "file-2dtbBZdjtDKS8eqWxqbgDi",
              "filename": "deep_research_blog.pdf"
            },
            {
              "type": "file_citation",
              "index": 1176,
              "file_id": "file-2dtbBZdjtDKS8eqWxqbgDi",
              "filename": "deep_research_blog.pdf"
            },
            {
              "type": "file_citation",
              "index": 1176,
              "file_id": "file-2dtbBZdjtDKS8eqWxqbgDi",
              "filename": "deep_research_blog.pdf"
            }
          ]
        }
      ]
    }
  ]
}


LIMIT RESULTS
        "max_num_results": 2
INCLUDE SEARCH RESULTS
    include=["file_search_call.results"]


METADATA FILTERING

        "filters": {
            "type": "eq",
            "key": "type",
            "value": "blog"
        }








#### RESPONSE gpt-4o-mini

Response(id='resp_67f6d96ee8408192a8849670feda558e0faa975217e529bc',
created_at=1744230766.0, error=None, incomplete_details=None, instructions=None,
metadata={}, model='gpt-4o-mini-2024-07-18', object='response', output=[ResponseFileSearchToolCall(id='fs_67f6d97084588192afdf4ebf9b3121cc0faa975217e529bc',
queries=['упражнения для автоматизации звука Р', 'упражнения для звука Р', 'автоматизация звука Р'], status='completed', type='file_search_call', results=None),
 ResponseOutputMessage(id='msg_67f6d97428f0819299ea4a771e639b3f0faa975217e529bc',
 content=[ResponseOutputText(annotations=[AnnotationFileCitation(file_id='file-PiEcinbLiZwssqrka7N2P3',
 index=315, type='file_citation', filename='Komarova_avtomatizatsia_zvuka_R.pdf'),
 AnnotationFileCitation(file_id='file-QX2xWtyQLiCrU9rcMa9SAH', index=475, type='file_citation',
 filename='Komarova_avtomatizatsia_zvuka_R-_1_.pdf'), AnnotationFileCitation(file_id='file-QX2xWtyQLiCrU9rcMa9SAH',
  index=664, type='file_citation', filename='Komarova_avtomatizatsia_zvuka_R-_1_.pdf'),
  AnnotationFileCitation(file_id='file-PiEcinbLiZwssqrka7N2P3', index=828, type='file_citation',
   filename='Komarova_avtomatizatsia_zvuka_R.pdf'), AnnotationFileCitation(file_id='file-PiEcinbLiZwssqrka7N2P3',
    index=828, type='file_citation', filename='Komarova_avtomatizatsia_zvuka_R.pdf'),
    AnnotationFileCitation(file_id='file-JGY4tskUsk4fpd9vJN7dxr', index=1030, type='file_citation',
    filename='Avtomatizatsia_zvuki_M_M_N_N.doc')], text='Вот несколько упражнений для автоматизации звука «Р»,
    которые можно использовать с детьми в возрасте 4-7 лет:\n\n1. Лабиринт:\n   - Ребенок произносит звук «Р»,
    называя картинки на странице, перемещая игрушку по лабиринту. Если слово произнесено неправильно, следующий ход
    задерживается до правильного произношения.\n\n2. Лабиринт с проговариванием:\n   - При движении ребенку нужно не
    только называть картинки, но и указывать направление хода (например, "пряники — вверх").\n\n3. Игры с игрушками:\n
    - Используйте объемные или плоские игрушки, названия которых содержат звук «Р». Это помогает удерживать внимание
    ребенка и делает занятия более увлекательными.\n\n4. Упражнения на слоги и слова:\n   - Включите слова и слоги,
    содержащие звук «Р», в игру, где ребенок будет составлять слова из первых букв названий картинок.\n\n5. Чистоговорки
    и скороговорки:\n   - Занимайтесь скороговорками, начиная с медленного произношения, затем постепенно увеличивайте
    скорость, акцентируя внимание на правильном артикулировании звука.\n\nЭти упражнения помогут не только в автоматизации
    звука «Р», но и в развитии мелкой моторики, фонематического слуха и навыков чтения.', type='output_text')], role='assistant',
    status='completed', type='message')], parallel_tool_calls=True, temperature=1.0, tool_choice='auto',
    tools=[FileSearchTool(type='file_search', vector_store_ids=['vs_67f69730803481918fb5049813e0bf7f'],
    filters=None, max_num_results=20, ranking_options=RankingOptions(ranker='auto', score_threshold=0.0))],
    top_p=1.0, max_output_tokens=None, previous_response_id=None, reasoning=Reasoning(effort=None, generate_summary=None),
    status='completed', text=ResponseTextConfig(format=ResponseFormatText(type='text')), truncation='disabled',
    usage=ResponseUsage(input_tokens=12398, input_tokens_details=InputTokensDetails(cached_tokens=0), output_tokens=389,
    output_tokens_details=OutputTokensDetails(reasoning_tokens=0), total_tokens=12787), user=None, store=True)


### RESPONSE o3-mini

[ResponseReasoningItem(id='rs_67fd816017dc8192ab769352f055b54006a12d83193396c5', summary=[], type='reasoning', status=None),
ResponseFileSearchToolCall(id='fs_67fd8161652c8192a6583ed6c33b7c8e06a12d83193396c5', queries=['логопедические упражнения звук
Ц дислалия для детей 5 лет источник', 'логопедические упражнения автоматизация звука Ц для детей 5 лет', 'упражнения для
коррекции дислалии звук Ц возраст 5 ссылки'], status='completed', type='file_search_call', results=[Result(attributes={},
file_id='file-NinbkUHtjmjon5KJ1fMbz2', filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.7096, text='К63 \n\n \n\nРекомендовано
Ученым Советом Педагогического общества России Издание \n\nразвивающего обучения \n\n \n\nКомарова, Л.А. \n\nК63
 Автоматизация звука Ц в игровых упражнениях. Альбом дошкольника / Л.А. Комарова. — М.: \n\nИздательство ГНОМ и Д, 2008. -
  32 с. \n\n \n\nISBN 978-5-296-00802-2 \n\n \n\nВ пособии предлагается система упражнений по автоматизации звука «Ц» у дошкольников 4-7 лет,
   \n\nкоторая превращает однообразную и монотонную работу по закреплению произношения звука в \n\nинтересную игру.
   Вместе с его автоматизацией у ребенка совершенствуется навык чтения,'), Result(attributes={}, file_id='file-NinbkUHtjmjon5KJ1fMbz2',
   filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.6957, text='ISBN 978-5-296-00802-2 \n\n \n\nВ
   пособии предлагается система упражнений по автоматизации звука «Ц» у дошкольников 4-7 лет, \n\nкоторая превращает однообразную и
   монотонную работу по закреплению произношения звука в \n\nинтересную игру. Вместе с его автоматизацией у ребенка совершенствуется
   навык чтения, \n\nразвивается мелкая моторика, творческое воображение. \n\nАвтоматизация звука «Ц» проводится по традиционной в логопедии схеме.
   Эффективность кор-\n\nрекционной работы обеспечивается использованием ряда вспомогательных приемов (работа с объ-\n\nемными и плоскими игрушками,
   счетными палочками, создание на занятии игровых ситуаций).'), Result(attributes={}, file_id='file-2LLgPCPMm7WepQ1Lebszuy',
   filename='Komarova_avtomatizatsia_zvuka_S.pdf', score=0.6759, text='Рекомендовано Ученым Советом Педагогического общества
   России \n\nКомарова Л.А. К63        Автоматизация звука С в игровых упражнениях. Альбом дошкольника / Л.А. \n\nКомарова.
   -М.: Издательство ГНОМ и Д, 2007. - 32 с. \n\n15ВМ 978-5-296-00784-1 \n\nВ пособии предлагается система упражнений
   по автоматизации звука «С» у дошкольников 4—7 лет, \n\nкоторая превращает однообразную и монотонную работу по закреплению
   произношения звука «С» в \n\nинтересную игру. Вместе с его автоматизацией у ребенка совершенствуется навык чтения,
   развивается \n\nмелкая моторика, творческое воображение.'), Result(attributes={}, file_id='file-KfDSESB5npo9kaaq1DbdgC',
   filename='Komarova_avtomatizatsia_zvuka_R-_1_.pdf', score=0.664, text='В пособии предлагается система упражнений по
    автоматизации звука Рь у дошкольников \n\n4—7 лет, которая превращает однообразную и монотонную работу по закреплению
    произношения звука \n\nв интересную игру. Вместе с его автоматизацией у ребенка совершенствуется навык чтения, развивается
     \n\nмелкая моторика, творческое воображение. \n\nАвтоматизация звука Рь проводится по традиционной в логопедии схеме.
     Эффективность коррекционной работы \n\nобеспечивается использованием ряда вспомогательных приемов (работа с объемными и
      плоскими игрушками, \n\nсчетными палочками, создание на занятии игровых ситуаций).'), Result(attributes={}, file_id='file-MATBwhoC3m2jpb6PTDk5Yw',
      filename='Komarova_avtomatizatsia_zvuka_Sh.pdf', score=0.6608, text='Будьте терпеливы и доброжелательны.
      Тогда результаты \n\nзанятий с ребёнком вас обязательно порадуют. \n\nВашему вниманию предлагается комплект
      пособий по \n\nавтоматизации звуков, поставленных логопедом. Он состоит из \n\nдесяти альбомов: \n\n(1)
      Автоматизация звука С в игровых упражнениях \n\n(2) Автоматизация звука 3 в игровых упражнениях \n\n()^
      Автоматизация звука Ц в игровых упражнениях \n\n(4) Автоматизация звука Ш в игровых упражнениях \n\n(5)
      Автоматизация звука Ж в игровых упражнениях \n\n(б) Автоматизация звуков Ч, Щ в игровых упражнениях'),
      Result(attributes={}, file_id='file-4Z8cAS3iEYffPidugXdcGi', filename='Avtomatizatsia_Zvuki_Sh_Zh_Ch_Sch.doc',
      score=0.6574, text='Спивак Е\n\nСпивак Е.Н.Звуки Ш, Ж, Ч, Щ... Речевой материал для автоматизации и дифференциации звуков у детей 5-7 лет -
      М.: Издательство ГНОМ, 2007. - 88 с. \n\nЕ.Н. Спивак\nЗВУКИ\nШ, Ж, Ч, Щ\nРечевой материал\nдля автоматизации и дифференциации\nзвуков у детей
      5-7 лет\n\n\n\n\n\nМосква 2007\nАвтоматизация звука III\n\n5\nАВТОМАТИЗАЦИЯ ШИПЯЩИХ'),
      Result(attributes={}, file_id='file-8ddqri8qhAgozXtqkcTaXk', filename='Avtomatizatsia_ZVUKI_L_L_R_R.doc',
       score=0.6573, text='Спивак Е\n\nСпивак Е.Н. Звуки Л, Ль, Р, Рь. Речевой материал для автоматизации
       и дифференциации звуков у детей 5-7 лет - М.: Издательство ГНОМ, 2007. - 88 с. \n\nЕ.Н.
       Спивак\nЗВУКИ\nЛ, Ль, Р, Рь\nРечевой материал\nдля автоматизации и дифференциации\nзвуков
       у детей 5-7 лет\n\n\n\n\nМосква 2007\nАвтоматизация звука Л\n\n5\nАВТОМАТИЗАЦИЯ СОНОРНЫХ
       ЗВУКОВ\nАВТОМАТИЗАЦИЯ ЗВУКА Л\n1. Спой «песенку самолета»: произноси звук л длительно
       на одном выдохе: л-л-л...\n2.'), Result(attributes={}, file_id='file-SEsuLcygB49r1eWoRYXri4',
       filename='Avtomatizatsia_ZVUKI_T_T_D_D.doc', score=0.6571, text='Егорова О\n\nЕгорова О.В.
       Звуки Т, ТЬ, Д, ДЬ. Речевой материал и игры по автоматизации и дифференциации звуков у детей 5-7 лет.
       — М. «Издательство «Гном и Д», 2005. — 32 с.\nДанное пособие адресовано логопедам, воспитателям
       логопедических групп, родителям. Его главная задача - помочь ребёнку усвоить правильное произношение звуков
       Т, ТЬ, Д, ДЬ.\n\nВ пособии предлагается практический материал по постановке, автоматизации и дифференциации
       данных звуков. Пособие содержит разнообразный лексический материал, описание игр и отдельных упражнений.\n\nВведение'),
       Result(attributes={}, file_id='file-2LLgPCPMm7WepQ1Lebszuy', filename='Komarova_avtomatizatsia_zvuka_S.pdf', score=0.5552,
        text='которая превращает однообразную и монотонную работу по закреплению произношения звука «С» в \n\nинтересную игру. В
        месте с его автоматизацией у ребенка совершенствуется навык чтения, развивается \n\nмелкая моторика, творческое воображение.
         \n\nАвтоматизация звука «С» проводится по традиционной в логопедии схеме. Эффективность кор-\n\nрекционной работы обеспечивается
          использованием ряда вспомогательных приемов (работа с \n\nобъемными и плоскими игрушками, счетными палочками, создание на занятии
           игровых ситуаций). \n\nПособие предназначено для проведения индивидуальной работы с ребенком и адресовано'), Result(attributes={},
            file_id='file-NinbkUHtjmjon5KJ1fMbz2', filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.5415, text='своевременной
            профилактикой дисграфии и дислексии. В зависимости от сложности речевого дефекта \n\nребенка и этапа коррекционной работы игры
            и задания могут использоваться логопедом комбинированно. \n\nАвтоматизация звука «Ц» проводится по традиционной в логопедии схеме.
            Сначала проводится \n\nкомплекс упражнений артикуляционной гимнастики. Затем предлагаются упражнения на автоматизацию \n\nзвука
            «Ц» изолированно, на материале слогов, слов, предложений, стихотворных и прозаических текстов. \n\nДля того чтобы сделать процесс
             автоматизации звука в словах более увлекательным и эффективным,'), Result(attributes={}, file_id='file-KfDSESB5npo9kaaq1DbdgC',
              filename='Komarova_avtomatizatsia_zvuka_R-_1_.pdf', score=0.5364, text='линии и склеить. У моряка, принца, тигренка \n\nпредварительно
              необходимо отогнуть в \n\nстороны белые клапаны-подставки \n\n(для придания игрушкам устойчивости). \n\n\n\nВВЕДЕНИЕ \n\nВашему в
              ниманию предлагается комплект пособий \n\nпо автоматизации звуков, поставленных логопедом. \n\nОн состоит из десяти альбомов: \n\n(1)
              Автоматизация звука С в игровых упражнениях \n\n(2) Автоматизация звука 3 в игровых упражнениях \n\n(3) Автоматизация звука Ц в и
              гровых упражнениях \n\n(4) Автоматизация звука Ш в игровых упражнениях \n\n(5) Автоматизация звука Ж в игровых упражнениях'), R
              esult(attributes={}, file_id='file-NinbkUHtjmjon5KJ1fMbz2', filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.5346,
              text='грамматического строя речи, закреплению знаний об автоматизируемом звуке и соответствующей букве, \n\nформированию навыка
              звукобуквенного анализа слогов и слов. Одновременно с этим происходит развитие \n\nмелкой моторики пальцев рук; активизация памят
              и, внимания, мышления. Все это является, в свою очередь, \n\nсвоевременной профилактикой дисграфии и дислексии. В зависимости от
               сложности речевого дефекта \n\nребенка и этапа коррекционной работы игры и задания могут использоваться логопедом комбинированно.
                \n\nАвтоматизация звука «Ц» проводится по традиционной в логопедии схеме. Сначала проводится'), Result(attributes={}, file_id='fi
                le-Y7EABqy5wtm3TPp7Y1FL7k', filename='Komarova_avtomatizatsia_zvukov_Ch_Sch.pdf', score=0.5314, text='� \n\n\n\n \n\n  \n\nВВЕДЕН
                ИЕ \n\nВашему вниманию предлагается комплект пособий по \n\nавтоматизации звуков, поставленных логопедом. Он состоит \n\nиз
                 альбомов: \n\n Автоматизация звука С в игровых упражнениях \n\nАвтоматизация звука 3 в игровых упражнениях \n\nАвтоматизация зву
                 ка Ц в игровых упражнениях \n\nАвтоматизация звука Ш в игровых упражнениях \n\nАвтоматизация звука Ж в игровых упражнениях \n\n
                  Автоматизация звуков Ч, Щ в игровых упражнениях \n\nАвтоматизация звука Л в игровых упражнениях'), Result(attributes={}, file_i
                  d='file-NinbkUHtjmjon5KJ1fMbz2', filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.5239, text='Прежде чем начать играть,
                  картинки необхо-\n\nдимо вырезать по контуру, сложить по пунк-\n\nтирной линии и склеить. У цыпленка, индей-\n\nца и царицы пред
                  варительно необходимо \n\nотогнуть в стороны белые клапаны-подстав-\n\nки (для придания игрушкам устойчивости). \n\n \n\n \n\n \n\
                  n \n\n\n\n \n\nВВЕДЕНИЕ \n\nВниманию логопедов предлагается система упражнений по автоматизации звука «Ц». Материал, \n\nпредставле
                  нный в данном пособии, превращает однообразную и монотонную работу по закреплению \n\nпроизношения звука в интересную игру. Одновре
                  менно с автоматизацией звука у ребенка совершенс-'), Result(attributes={}, file_id='file-6tZ9sP65Uho5hsSmohac79', filename='L_-_Zhi
                  khareva-Norkina_Yu_B_-_Dom_tetrad_dlya_l.pdf', score=0.5165, text='7. Домашняя тетрадь для закрепления звуков ш, ж. \n\n8. Домашняя
                   тетрадь для закрепления звуков ч, щ. \n\n9. Домашняя тетрадь для закрепления звуков т, ть, д, дь. \n\nВ этих тетрадях представлен
                   большой речевой материал для \n\nавтоматизации звуков, который подобран по дидактическим принципам \n\nдоступности, последовательн
                   ости и наглядности. Он может быть \n\nиспользован в работе с детьми в возрасте от 4,5 до 7—8 лет, как \n\nобученными грамоте, так
                   и не умеющими читать, с различными \n\nречевыми нарушениями и задержкой психического развития. \n\nСюда же вошли упражнения для ра
                   звития органов артикуляционного'), Result(attributes={}, file_id='file-K1UDDG4T3FVAuY8JSYmd6k', filename='Komarova_avtomatizatsia_
                   zvuka_R.pdf', score=0.5085, text='своевременной профилактикой дисграфии и дислексии. В зависимости от сложности речевого дефекта \
                   n\nребенка и этапа коррекционной работы игры и задания могут использоваться логопедом комбинированно. \n\nАвтоматизация звука «Р»
                    по традиционной в логопедии схеме. Сначала проводится \n\nкомплекс упражнений артикуляционной гимнастики. Затем предлагаются упраж
                    нения на автоматизацию \n\nзвука «Р» изолированно, на материале слогов, слов, предложений, стихотворных и прозаических текстов. \n
                    \nДля того чтобы сделать процесс автоматизации звука в словах более увлекательным и эффективным,'), Result(attributes={}, file_id=
                    'file-NinbkUHtjmjon5KJ1fMbz2', filename='Komarova_avtomatizatsia_zvuka_Ts.pdf', score=0.5072, text='развивается мелкая моторика, т
                    ворческое воображение. \n\nАвтоматизация звука «Ц» проводится по традиционной в логопедии схеме. Эффективность кор-\n\nрекционной
                    работы обеспечивается использованием ряда вспомогательных приемов (работа с объ-\n\nемными и плоскими игрушками, счетными палочкам
                    и, создание на занятии игровых ситуаций). \n\nПособие предназначено для проведения индивидуальной работы с ребенком и адресовано л
                    ого-\n\nпедам, воспитателям логопедических групп и родителям детей с нарушениями речи. \n\n \n\nББК 74.3 \n\n \n\nИздатель — А. П.
                     Казаков Редактор — Н.Е. \nИльякова Иллюстрации — Д. Р. Кудряков, Н.В.'), Result(attributes={}, file_id='file-KfDSESB5npo9kaaq1Dbd
                     gC', filename='Komarova_avtomatizatsia_zvuka_R-_1_.pdf', score=0.5052, text='(1) Автоматизация звука С в игровых упражнениях \n\n
                     (2) Автоматизация звука 3 в игровых упражнениях \n\n(3) Автоматизация звука Ц в игровых упражнениях \n\n(4) Автоматизация звука Ш
                      в игровых упражнениях \n\n(5) Автоматизация звука Ж в игровых упражнениях \n\n(6) Автоматизация звуков Ч, Щ в игровых упражне- \
                      n\nниях \n\n(7) Автоматизация звука Л в игровых упражнениях \n\n(8) Автоматизация звука Ль в игровых упражнениях \n\n(9) Автомат
                      изация звука Р в игровых упражнениях \n\n(10) Автоматизация звука Рь в игровых упражнениях'), Result(attributes={}, file_id='fil
                      e-3wNCXCeDxZMcK5pnS75Fc3', filename='Filicheva_T_B__Chirkina_G_V_Podgotovka_k_shkole_detey_s_ONR_Ch1.pdf', score=0.5038, text='к
                      о, пропускаются, заменяются звуками т, д, ф, в; аффрикаты ч, щ заменяются на ть, ц, сь; звуки \n\nр, л, могут пропускаться или з
                      аменяться на ль. \n\nВ 4—5


##СТРУКТУРА REASONING
[
    ResponseReasoningItem(...),  # Без аннотаций
    ResponseFileSearchToolCall(...),  # Без аннотаций
    ResponseOutputMessage(  # Единственный элемент с аннотациями
        role="assistant",
        content=[
            ResponseOutputText(  # Только ОДИН блок — текст с аннотациями
                annotations=[...],
                text="Предлагаю следующие три индивидуальных упражнения..."
            )
        ]
    )
]


{
  "id": "resp_67ccf4c55fc48190b71bd0463ad3306d09504fb6872380d7",
  "object": "response",
  "created_at": 1741485253,
  "status": "completed",
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "max_output_tokens": null,
  "model": "gpt-4o-2024-08-06",
  "output": [
    {
      "type": "file_search_call",
      "id": "fs_67ccf4c63cd08190887ef6464ba5681609504fb6872380d7",
      "status": "completed",
      "queries": [
        "attributes of an ancient brown dragon"
      ],
      "results": null
    },
    {
      "type": "message",
      "id": "msg_67ccf4c93e5c81909d595b369351a9d309504fb6872380d7",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "The attributes of an ancient brown dragon include...",
          "annotations": [
            {
              "type": "file_citation",
              "index": 320,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 576,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 815,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 815,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 1030,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 1030,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 1156,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            },
            {
              "type": "file_citation",
              "index": 1225,
              "file_id": "file-4wDz5b167pAf72nx1h9eiN",
              "filename": "dragons.pdf"
            }
          ]
        }
      ]
    }
  ],
  "parallel_tool_calls": true,
  "previous_response_id": null,
  "reasoning": {
    "effort": null,
    "generate_summary": null
  },
  "store": true,
  "temperature": 1.0,
  "text": {
    "format": {
      "type": "text"
    }
  },
  "tool_choice": "auto",
  "tools": [
    {
      "type": "file_search",
      "filters": null,
      "max_num_results": 20,
      "ranking_options": {
        "ranker": "auto",
        "score_threshold": 0.0
      },
      "vector_store_ids": [
        "vs_1234567890"
      ]
    }
  ],
  "top_p": 1.0,
  "truncation": "disabled",
  "usage": {
    "input_tokens": 18307,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 348,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 18655
  },
  "user": null,
  "metadata": {}
}