input_file и attachment_search в Responses API
На тази страница
Два пътя към един и същ блок
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: всяко извикване повторно изтегля файла, така че един документ, заявен петдесет пъти на ден, преминава през мрежата петдесет пъти.
Какво прави attachment_search
Веднага щом в заявката Ви се появи input_file, Grok задейства attachment_search без никаква конфигурация от Ваша страна. Обработката протича в четири стъпки:
- Извличане на съдържание от файла: текст, таблици, структура
- Временно индексиране на това съдържание за продължителността на заявката
- Търсене на релевантни пасажи въз основа на Вашия въпрос
- Инжектиране на откъси в контекста на модела
Обърнете внимание на прилагателното „временно“ във втората стъпка, защото то обяснява разлика в разходите, която мнозина откриват твърде късно: индексът се изгражда наново при всяко извикване и след това изчезва. Това е точно проблемът, който колекциите решават чрез персистентно индексиране. Отбележете също, че моделът цитира пасажи, които действително е използвал в отговора си, позволявайки Ви да проверите работата му, вместо да приемате думите му на доверие.
Комбиниране на множество документи
Нищо не Ви принуждава да се ограничавате до един файл на заявка. Чрез натрупване на множество блокове 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_id | file_url |
|---|---|---|
| Предварително качване | Да | Не |
| Поверителен файл | Препоръчително | Не се препоръчва |
| Многократни заявки | Висока производителност (1 качване) | Бавно (повторно изтегляне) |
| Публичен файл | Възможно | Идеално |
| Управление на жизнения цикъл | Вие контролирате | Зависи от хоста |
Ключови изводи
input_fileсfile_idреферира качен файл, аfile_url– публичен документ- Инструментът
attachment_searchсе активира автоматично, за да извлече релевантно съдържание - Можете да комбинирате множество файлове в една заявка
- Предпочитайте
file_idза поверителни или често заявявани файлове - Предпочитайте
file_urlза публични документи или бързи тестове