Използване на цитати в резултатите
На тази страница
Проследими отговори с цитати
Когато потребителят зададе на Вашето приложение въпрос, касаещ факти, той иска да може да провери предоставената информация. Цитатите в API на Grok отговарят точно на тази нужда: всеки факт, извлечен чрез уеб търсене, идва със своя източник. Това Ви позволява да изградите интерфейси, в които всяко твърдение е кликаемо и проверимо.

API предлага два допълващи се механизма за цитиране: глобални цитати и вградени цитати. Разбирането на тяхното функциониране Ви позволява да създадете професионални и прозрачни потребителски преживявания.
Глобални цитати: Пълният списък с източници
Глобалните цитати се връщат по подразбиране в атрибута citations на отговора. Те съдържат списък с всички URL адреси, консултирани от модела, дори тези, които не са директно споменати в текста на отговора.
response = client.responses.create(
model="grok-4.5",
input="What are the latest AI regulations in Europe?",
tools=[{"type": "web_search"}]
)
# Access global citations
for citation in response.citations:
print(f"Source: {citation.url}")
Не се изисква допълнителна конфигурация. Това е собственото поведение на API.
Вградени цитати: Препратки в текста
Вградените цитати вмъкват Markdown връзки директно в текста на отговора, използвайки формата [[N]](url), където N е пореден номер, започващ от 1. Ако един и същ източник се цитира няколко пъти, оригиналният номер се използва повторно.
Поведението по подразбиране зависи от използвания SDK:
- Direct Responses API: вградените цитати са активирани по подразбиране
- xAI SDK: вградените цитати са деактивирани по подразбиране (изисква се изрично включване)
Активиране на вградени цитати с xAI SDK
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Деактивиране на вградени цитати в Responses API
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Структурирана схема за анотации
Всеки вграден цитат генерира обект за анотация с точни метаданни. Тази структура позволява разширена програмна обработка:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Полетата start_index и end_index следват конвенцията за срезове (slice) в Python. Можете да ги използвате, за да извлечете точно цитирания текст или да създадете персонализиран HTML рендъринг:
text = response.output_text
for annotation in response.annotations:
cited_text = text[annotation.start_index:annotation.end_index]
print(f"Cited text: {cited_text}")
print(f"Source: {annotation.url}")
Поведение при стрийминг
Когато използвате стрийминг, вградените цитати се появяват прогресивно в текстовите части (chunks). Въпреки това, пълните анотации са налични само в крайния отговор. Планирайте двуетапна обработка, ако Вашият интерфейс показва източниците в реално време.
Изграждане на интерфейс с източници
Ето пример за трансформиране на цитати в структуриран HTML:
def format_response_with_sources(response):
text = response.output_text
sources = []
# Collect unique sources
seen_urls = set()
for citation in response.citations:
if citation.url not in seen_urls:
sources.append(citation.url)
seen_urls.add(citation.url)
# Build the render
html = f"<div class='response'>{text}</div>"
html += "<div class='sources'><h4>Sources</h4><ul>"
for i, url in enumerate(sources, 1):
html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
html += "</ul></div>"
return html
Цитати от колекции
Ако използвате инструмента collections_search заедно с web_search, цитатите от Вашите качени документи използват специфичен URI формат: collections://collection_id/files/file_id. Разграничавайте ги от стандартните уеб цитати, за да адаптирате рендъринга на фронтенда.
Практическо упражнение
Създайте приложение, което показва резултатите от търсенето на Grok със система за бележки под линия. Всеки факт трябва да води обратно към оригиналния си източник. Тествайте с въпроси относно текущи събития и ръчно проверете дали връзките са валидни и релевантни.
Ключови изводи
- Глобалните цитати (списък с URL адреси) се връщат по подразбиране, без конфигурация
- Вградените цитати (връзки в текста) се активират чрез параметъра
include - Поведението по подразбиране за вградени цитати варира според SDK
- Всяка анотация съдържа URL адреса, индексите на позицията и номера на цитата
- При стрийминг пълните анотации са налични само в крайния отговор
- Цитатите от колекции използват различен URI формат (
collections://)