Премини към основното съдържание
Български— Изберете език
Меню

input_file и attachment_search в Responses API

Урок 4 от 16 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Два пътя към един и същ блок
  2. Пътят с file_id
  3. Пътят с file_url
  4. Какво прави attachment_search
  5. Комбиниране на множество документи
  6. Избор между двете
  7. Ключови изводи

Два пътя към един и същ блок

Responses API на Grok приема документ по два начина: чрез file_id, което означава файл, който сте качили предварително, или чрез file_url – публичен адрес, който xAI извлича в момента на заявката. Блокът носи едно и също име и в двата случая – input_file, а обработката надолу по веригата е идентична: Grok активира инструмента attachment_search и извлича пасажи, които отговарят на въпроса Ви. Променя се жизненият цикъл на документа, неговата поверителност и цената на всяко повторно извикване.

Пътят с file_id

След като изпратите файла чрез POST /v1/files, го реферирате по неговия идентификатор, заедно с въпроса си в обикновен текст:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_abc123"
    },
    {
      "type": "input_text",
      "text": "What are the main risks mentioned in this report?"
    }
  ]
}

Този подход има смисъл в три ситуации. Първата е при многократни заявки: ако юридическият Ви екип зададе петнадесет последователни въпроса относно един и същ договор, едно качване, последвано от петнадесет референции, е по-ефективно от петнадесет трансфера на един и същ PDF. Втората е поверителността, когато документът не трябва да бъде изложен зад URL, достъпен за всеки, притежаващ линка. Третата е архитектурата на Вашето приложение: ако файловете се качват предварително по време на нощното ingest, Вашите заявки обработват само идентификатори.

Пътят с file_url

Когато документът вече е публикуван някъде, качването става излишна стъпка и можете да посочите директно адреса:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_url": "https://exemple.com/specifications-api.pdf"
    },
    {
      "type": "input_text",
      "text": "Summarize the endpoints described in this documentation."
    }
  ]
}

Типични случаи на употреба включват отворена документация, която нямате причина да съхранявате, файл, хостван на Вашата инфраструктура зад временен URL, или бърз тест, при който искате да проверите хипотеза, без да настройвате цял конвейер за качване.

С това удобство идват три ограничения и всички те Ви струват скъпо в продукционна среда. URL адресът трябва да бъде наистина публичен, без автентикация: адрес, защитен с токен или бисквитка, връща страница с грешка на xAI, която моделът старателно ще анализира вместо Вашия документ. Изтеглянето добавя време към обработката на заявката, правейки големите PDF файлове значително по-бавни в сравнение с file_id. Накрая, няма кеш от страна на xAI: всяко извикване повторно изтегля файла, така че един документ, заявен петдесет пъти на ден, преминава през мрежата петдесет пъти.

Веднага щом в заявката Ви се появи input_file, Grok задейства attachment_search без никаква конфигурация от Ваша страна. Обработката протича в четири стъпки:

  1. Извличане на съдържание от файла: текст, таблици, структура
  2. Временно индексиране на това съдържание за продължителността на заявката
  3. Търсене на релевантни пасажи въз основа на Вашия въпрос
  4. Инжектиране на откъси в контекста на модела

Обърнете внимание на прилагателното „временно“ във втората стъпка, защото то обяснява разлика в разходите, която мнозина откриват твърде късно: индексът се изгражда наново при всяко извикване и след това изчезва. Това е точно проблемът, който колекциите решават чрез персистентно индексиране. Отбележете също, че моделът цитира пасажи, които действително е използвал в отговора си, позволявайки Ви да проверите работата му, вместо да приемате думите му на доверие.

Комбиниране на множество документи

Нищо не Ви принуждава да се ограничавате до един файл на заявка. Чрез натрупване на множество блокове input_file, Вие карате модела да разсъждава върху целия набор:

{
  "model": "grok-4.5",
  "input": [
    {
      "type": "input_file",
      "file_id": "file_rapport_q1"
    },
    {
      "type": "input_file",
      "file_id": "file_rapport_q2"
    },
    {
      "type": "input_text",
      "text": "Compare the Q1 and Q2 results."
    }
  ]
}

Grok анализира и двата документа и кръстосва информацията, за да отговори, което отваря вратата за тримесечни сравнения, прегледи на последователни версии на договори или съпоставки между спецификация и нейната реализация.

Избор между двете

Критерийfile_idfile_url
Предварително качванеДаНе
Поверителен файлПрепоръчителноНе се препоръчва
Многократни заявкиВисока производителност (1 качване)Бавно (повторно изтегляне)
Публичен файлВъзможноИдеално
Управление на жизнения цикълВие контролиратеЗависи от хоста

Ключови изводи

  • input_file с file_id реферира качен файл, а file_url – публичен документ
  • Инструментът attachment_search се активира автоматично, за да извлече релевантно съдържание
  • Можете да комбинирате множество файлове в една заявка
  • Предпочитайте file_id за поверителни или често заявявани файлове
  • Предпочитайте file_url за публични документи или бързи тестове