Автоматични цитати и източници
На тази страница
Проследимост на информацията
Едно от ключовите предимства на функцията за уеб търсене пред обикновеното генериране на текст е проследимостта. Когато моделът използва информация от уеб търсене, API автоматично връща цитати с URL адресите на консултираните източници. Това Ви позволява да проверите информацията и да я представите с препратки във Вашето приложение.
Как функционират цитатите
API генерира цитатите автоматично, без да е необходима каквато и да е конфигурация от Ваша страна. Щом функцията за уеб търсене е активирана и моделът използва резултати от търсенето в своя отговор, източниците се включват в обекта на отговора.
Достъпвайте цитатите чрез полето citations в отговора. Всеки цитат съдържа URL адреса на източника и контекста, в който е използван.
Използване на цитати във Вашето приложение
Показване на източниците
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in quantum computing?",
tools=[{"type": "web_search"}]
)
# Display the response
print(response.output_text)
# Display the citations
if hasattr(response, 'citations') and response.citations:
print("\nSources:")
for citation in response.citations:
print(f" - {citation.url}")
Интегриране на източниците в потребителски интерфейс
В уеб приложение можете да превърнете цитатите в кликабельни връзки. Това засилва доверието във Вашето приложение и позволява на крайния потребител да провери информацията.
def format_response_with_sources(response):
output = response.output_text
if hasattr(response, 'citations') and response.citations:
output += "\n\n---\n**Sources:**\n"
for i, citation in enumerate(response.citations, 1):
output += f"{i}. [{citation.url}]({citation.url})\n"
return output
Варианти на употреба за цитати
Корпоративни чатботове
За AI асистент, създаден за Вашите клиенти, цитатите добавят прозрачност. Потребителят може да провери дали информацията идва от надежден източник, което изгражда доверие в отговорите.
Приложения за мониторинг
В автоматизиран инструмент за мониторинг цитатите са от съществено значение за проследяване произхода на информацията. Те Ви позволяват да свържете всяко прозрение с неговия източник и улесняват задълбочения анализ.
Генериране на отчети
Ако използвате API за генериране на автоматизирани отчети, цитатите служат като библиография. Те документират използваните източници и добавят стриктност към отчета.
Комбиниране на цитати и филтриране по домейн
Чрез комбинирането на allowed_domains с цитати получавате контролирана и проследима система за търсене:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Current state of AI regulation in Europe",
tools=[{
"type": "web_search",
"allowed_domains": [
"ec.europa.eu",
"eur-lex.europa.eu",
"legifrance.gouv.fr"
]
}]
)
Цитатите ще потвърдят, че информацията идва единствено от разрешени източници.
Ограничения, които трябва да знаете
- Цитатите не винаги присъстват: ако моделът отговори, без да използва резултати от търсене, не се генерират цитати.
- Точният формат на цитатите може да варира в зависимост от използвания SDK.
- Цитатите правят препратка към консултираните страници, а не непременно към точните използвани пасажи.
- Броят на цитатите зависи от броя на източниците, които моделът действително е използвал.
Ключови изводи
- Цитатите са автоматични: не се изисква конфигурация.
- Те са достъпни чрез полето
citationsв отговора. - Цитатите носят проследимост и достоверност на Вашето приложение.
- Те се комбинират с филтриране по домейн за пълен контрол.
- Интегрирайте ги във Вашия интерфейс, за да позволите проверка на източниците.