Referenzen rendern
Referenzen sind die Quellen, die der Assistent mit einer Antwort angibt. Sie kommen in jedem Ergebnis als result.payload.references an – ein Array, das Sie im Antwort-Template durchlaufen und dabei pro Quelle eine Karte (das Template highlighted) rendern.
Was eine Referenz enthält
| Feld | Bedeutung |
|---|---|
id | Die eindeutige ID der Referenz. |
title | Ihre Überschrift. |
url | Ein Link zur Quelle. |
dataset | Der Datensatz bzw. die Quelle, aus der sie stammt. |
summary | Eine KI-generierte Zusammenfassung (sofern verfügbar). |
body | Der vollständige Text (kann leer sein). |
status, owner, parent, foundTime, key | Metadaten zum Element. |
type | Der Inhaltstyp – bestimmt, welche Karte ihn rendert (siehe nächstes Thema). |
metaOgImageURL | Ein Vorschaubild, sofern die Quelle eines hat. |
pages | Seitenindizes für ein mehrseitiges Dokument, zum Öffnen der Vorschau. |
reaction | Die Reaktion des Besuchers auf die Antwort, sofern gesetzt. |
Durchlaufen und anzeigen
{% for reference in result.payload.references %}
<article class="skdwn-ref">
<h4>{{ reference.title }}</h4>
{% if reference.metaOgImageURL %}
<img src="{{ reference.metaOgImageURL }}" alt="{{ reference.title }}"/>
{% endif %}
{% if reference.summary %}
<p>{{ reference.summary | ellipsis: 160 }}</p>
{% endif %}
<a href="{{ reference.url }}" target="_blank">Open</a>
</article>
{% endfor %}{{ }} gibt einen Wert aus; {% %} ist Logik. Der Filter ellipsis kürzt langen Text – einer von vielen integrierten Filtern.