Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Websuche

Finde Informationen mit der integrierten Websuche von OpenAI.

Nutze die Websuche, wenn dein Agent Informationen recherchieren muss, um eine Frage zu beantworten oder eine Aufgabe zu erledigen.

Beispiel: Erklären, warum der Mars rot erscheint

Sende diesen JSON-Body an POST /v1/agents/sessions, um eine Sitzung zu erstellen und die Antwort als Stream zu empfangen. Damit aktivierst du die Websuche im Modus live:

{
  "agent": {
    "model": "gpt-6-astra",
    "reasoning": { "effort": "low" },
    "tools": [{ "type": "web_search", "mode": "live" }]
  },
  "environment": { "type": "none" },
  "input": "Search NASA's website for why Mars looks red. Explain it in two sentences and include a source link.",
  "stream": true
}

Ergebnis

Bei einem Testlauf am 10. September 2026 durchsuchte der Agent die Website der NASA und gab diese Antwort als Stream aus:

Mars looks red because iron minerals in its soil oxidize, or rust, giving the surface a reddish color. This rusty appearance is why it’s called the “Red Planet,” according to NASA’s Mars Facts.

Dieses Beispiel stammt aus einem aufgezeichneten Testlauf. Die Antwort, die du erhältst, kann davon abweichen.

Wenn du web_search in agent.tools weglässt, ist die integrierte Websuche deaktiviert. Eine Aufforderung zur Suche im Prompt aktiviert sie nicht.

Suchmodus

  • live (Standard): Die Suche darf direkt auf das Internet zugreifen. Dieser Modus gilt, wenn du web_search angibst und mode weglässt.
  • cached: Durchsucht gespeicherte Webinhalte, ohne auf das Internet zuzugreifen.
  • disabled: Deaktiviert die integrierte Websuche. Das hat denselben Effekt, wie wenn du das Tool weglässt.

Optionale Einstellungen

Füge diese Felder zum selben web_search-Eintrag hinzu:

Einstellung Funktion Wenn du das Feld weglässt
context_size Legt fest, wie viele Informationen das Modell aus der Suche erhält: low, medium oder high. Es gilt medium.
allowed_domains Legt fest, welche Websites die Suche berücksichtigen darf. Gib bis zu 100 Domainnamen an, zum Beispiel ["python.org", "docs.python.org"]. Die Suche verwendet keinen Domainfilter.
location Hilft dabei, die Ergebnisse auf einen Standort abzustimmen. Unterstützt country, region, city und timezone. Die Suche erhält keine Standortangaben. Fehlen Standortangaben, kann die Suche bei lokalen Anfragen weniger relevante Ergebnisse oder gar keine brauchbaren Treffer liefern.