Websuche

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

Beispiel: Erkläre, warum der Mars rot aussieht

Sende diesen JSON-Body an POST /v1/agents/sessions, um eine Sitzung zu erstellen und die Antwort zu streamen. Er aktiviert die Websuche im Modus live:

12345678910{
  "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 streamte diese Antwort:

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.

Dies ist ein aufgezeichnetes Beispiel. Deine Antwort kann davon abweichen.

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

Suchmodus

• live (Standard): Erlaubt der Suche, direkt auf das Internet zuzugreifen. Wird verwendet, wenn du web_search angibst, aber mode weglässt.
• cached: Durchsucht gespeicherte Webinhalte, ohne direkt auf das Internet zuzugreifen.
• disabled: Deaktiviert die integrierte Websuche, genau wie das Weglassen des Werkzeugs.

Optionale Einstellungen

Füge diese Felder demselben web_search-Eintrag hinzu: