Suchergebnisse
Ermöglichen Sie natürliche Zitate für RAG-Anwendungen durch die Bereitstellung von Suchergebnissen mit Quellenangabe
Suchergebnis-Inhaltsblöcke befinden sich derzeit in der Beta-Phase. Verwenden Sie den search-results-2025-06-09
Beta-Header, um diese Funktion zu aktivieren.
Suchergebnis-Inhaltsblöcke ermöglichen natürliche Zitate mit ordnungsgemäßer Quellenangabe und bringen Web-Such-Qualitätszitate in Ihre benutzerdefinierten Anwendungen. Diese Funktion ist besonders leistungsstark für RAG (Retrieval-Augmented Generation) Anwendungen, bei denen Claude Quellen genau zitieren muss.
Hauptvorteile
- Natürliche Zitate - Erreichen Sie die gleiche Zitatqualität wie bei der Websuche für jeden Inhalt
- Flexible Integration - Verwenden Sie in Tool-Rückgaben für dynamisches RAG oder als Top-Level-Inhalt für vorab abgerufene Daten
- Ordnungsgemäße Quellenangabe - Jedes Ergebnis enthält Quellen- und Titelinformationen für klare Zuordnung
- Keine Dokument-Workarounds erforderlich - Eliminiert die Notwendigkeit für dokumentbasierte Workarounds
- Konsistentes Zitatformat - Entspricht der Zitatqualität und dem Format von Claudes Websuchfunktionalität
Wie es funktioniert
Suchergebnisse können auf zwei Arten bereitgestellt werden:
- Aus Tool-Aufrufen - Ihre benutzerdefinierten Tools geben Suchergebnisse zurück und ermöglichen dynamische RAG-Anwendungen
- Als Top-Level-Inhalt - Sie stellen Suchergebnisse direkt in Benutzernachrichten für vorab abgerufene oder zwischengespeicherte Inhalte bereit
In beiden Fällen kann Claude automatisch Informationen aus den Suchergebnissen mit ordnungsgemäßer Quellenangabe zitieren.
Suchergebnis-Schema
Suchergebnisse verwenden die folgende Struktur:
Erforderliche Felder
Feld | Typ | Beschreibung |
---|---|---|
type | string | Muss "search_result" sein |
source | string | Die Quell-URL oder der Identifikator für den Inhalt |
title | string | Ein beschreibender Titel für das Suchergebnis |
content | array | Ein Array von Textblöcken mit dem tatsächlichen Inhalt |
Optionale Felder
Feld | Typ | Beschreibung |
---|---|---|
citations | object | Zitierkonfiguration mit enabled Boolean-Feld |
cache_control | object | Cache-Kontrolleinstellungen (z.B. {"type": "ephemeral"} ) |
Jedes Element im content
-Array muss ein Textblock mit folgenden Eigenschaften sein:
type
: Muss"text"
seintext
: Der tatsächliche Textinhalt (nicht-leere Zeichenkette)
Methode 1: Suchergebnisse aus Tool-Aufrufen
Der leistungsstärkste Anwendungsfall ist die Rückgabe von Suchergebnissen aus Ihren benutzerdefinierten Tools. Dies ermöglicht dynamische RAG-Anwendungen, bei denen Tools relevante Inhalte mit automatischen Zitaten abrufen und zurückgeben.
Beispiel: Wissensdatenbank-Tool
Methode 2: Suchergebnisse als Top-Level-Inhalt
Sie können auch Suchergebnisse direkt in Benutzernachrichten bereitstellen. Dies ist nützlich für:
- Vorab abgerufene Inhalte aus Ihrer Suchinfrastruktur
- Zwischengespeicherte Suchergebnisse aus vorherigen Anfragen
- Inhalte von externen Suchdiensten
- Tests und Entwicklung
Beispiel: Direkte Suchergebnisse
Claudes Antwort mit Zitaten
Unabhängig davon, wie Suchergebnisse bereitgestellt werden, fügt Claude automatisch Zitate hinzu, wenn Informationen aus ihnen verwendet werden:
Zitatfelder
Jedes Zitat enthält:
Feld | Typ | Beschreibung |
---|---|---|
type | string | Immer "search_result_location" für Suchergebnis-Zitate |
source | string | Die Quelle aus dem ursprünglichen Suchergebnis |
title | string oder null | Der Titel aus dem ursprünglichen Suchergebnis |
cited_text | string | Der exakte Text, der zitiert wird |
search_result_index | integer | Index des Suchergebnisses (0-basiert) |
start_block_index | integer | Startposition im content-Array |
end_block_index | integer | Endposition im content-Array |
Hinweis: Der search_result_index
bezieht sich auf den Index des Suchergebnis-Inhaltsblocks (0-basiert), unabhängig davon, wie die Suchergebnisse bereitgestellt wurden (Tool-Aufruf oder Top-Level-Inhalt).
Mehrere Inhaltsblöcke
Suchergebnisse können mehrere Textblöcke im content
-Array enthalten:
Claude kann spezifische Blöcke mit den Feldern start_block_index
und end_block_index
zitieren.
Erweiterte Nutzung
Kombination beider Methoden
Sie können sowohl tool-basierte als auch Top-Level-Suchergebnisse in derselben Unterhaltung verwenden:
Kombination mit anderen Inhaltstypen
Beide Methoden unterstützen das Mischen von Suchergebnissen mit anderen Inhalten:
Cache-Kontrolle
Fügen Sie Cache-Kontrolle für bessere Leistung hinzu:
Zitierkontrolle
Standardmäßig sind Zitate für Suchergebnisse deaktiviert. Sie können Zitate aktivieren, indem Sie explizit die citations
-Konfiguration setzen:
Wenn citations.enabled
auf true
gesetzt ist, wird Claude Zitatreferenzen einschließen, wenn Informationen aus dem Suchergebnis verwendet werden. Dies ermöglicht:
- Natürliche Zitate für Ihre benutzerdefinierten RAG-Anwendungen
- Quellenangabe bei der Schnittstelle mit proprietären Wissensdatenbanken
- Web-Such-Qualitätszitate für jedes benutzerdefinierte Tool, das Suchergebnisse zurückgibt
Wenn das citations
-Feld weggelassen wird, sind Zitate standardmäßig deaktiviert.
Zitate sind alles-oder-nichts: Entweder müssen alle Suchergebnisse in einer Anfrage Zitate aktiviert haben, oder alle müssen sie deaktiviert haben. Das Mischen von Suchergebnissen mit unterschiedlichen Zitateinstellungen führt zu einem Fehler. Wenn Sie Zitate für einige Quellen deaktivieren müssen, müssen Sie sie für alle Suchergebnisse in dieser Anfrage deaktivieren.
Best Practices
Für tool-basierte Suche (Methode 1)
- Dynamischer Inhalt: Verwenden Sie für Echtzeitsuchen und dynamische RAG-Anwendungen
- Fehlerbehandlung: Geben Sie angemessene Nachrichten zurück, wenn Suchen fehlschlagen
- Ergebnislimits: Geben Sie nur die relevantesten Ergebnisse zurück, um Kontextüberlauf zu vermeiden
Für Top-Level-Suche (Methode 2)
- Vorab abgerufener Inhalt: Verwenden Sie, wenn Sie bereits Suchergebnisse haben
- Stapelverarbeitung: Ideal für die Verarbeitung mehrerer Suchergebnisse auf einmal
- Tests: Großartig zum Testen des Zitierverhaltens mit bekannten Inhalten
Allgemeine Best Practices
-
Strukturieren Sie Ergebnisse effektiv
- Verwenden Sie klare, permanente Quell-URLs
- Stellen Sie beschreibende Titel bereit
- Teilen Sie lange Inhalte in logische Textblöcke auf
-
Konsistenz beibehalten
- Verwenden Sie konsistente Quellformate in Ihrer Anwendung
- Stellen Sie sicher, dass Titel den Inhalt genau widerspiegeln
- Halten Sie die Formatierung konsistent
-
Fehler elegant behandeln
Einschränkungen
- Suchergebnis-Inhaltsblöcke sind nur mit dem Beta-Header verfügbar
- Nur Textinhalt wird innerhalb von Suchergebnissen unterstützt (keine Bilder oder andere Medien)
- Das
content
-Array muss mindestens einen Textblock enthalten