Výstupy so štruktúrou a vyhľadávanie na webe
Na tejto strane
Kombinuj štruktúrované výstupy s vyhľadávaním v reálnom čase
Štruktúrované výstupy nie sú určené len pre statické dáta. Na modeloch Grok 4 a novších – čo znamená celú aktuálnu ponuku – môžeš kombinovať štruktúrované výstupy s vyhľadávaním na webe. Model vyhľadá na webe informácie v reálnom čase a následne výsledky naformátuje podľa tvojej schémy.
Prečo je táto kombinácia taká silná
Bez tejto funkcie si vyžaduje získavanie štruktúrovaných dát z webu tri samostatné kroky:
- Volanie vyhľadávacieho API (Google, Bing atď.)
- Parsovanie surových výsledkov
- Odoslanie výsledkov do LLM na štruktúrovanie
Pri kombinácii štruktúrovaných výstupov a vyhľadávania na webe sa všetko deje v rámci jedného volania. Model vyhľadá, syntetizuje a štruktúruje.
Predpoklady: minimálne Grok 4
Táto funkcia je dostupná na modeloch Grok 4 a novších, čo pokrýva celú aktuálnu ponuku (Grok 4.5, Grok 4.3, varianty grok-4.20). Staršie modely Grok 3 a Grok 3 Mini nepodporovali kombinovanie nástrojov so štruktúrovanými výstupmi.
Príklad: Konkurenčné spravodajstvo
from pydantic import BaseModel
class Concurrent(BaseModel):
nom: str
site_web: str
produit_phare: str
avantage_principal: str
class VeilleConcurrentielle(BaseModel):
secteur: str
date_analyse: str
concurrents: list[Concurrent]
tendances: list[str]
opportunites: list[str]
response, parsed = client.chat.parse(
model="grok-4.20-0309-reasoning",
messages=[{
"role": "user",
"content": "Perform competitive intelligence on the French neobank market in 2026"
}],
response_format=VeilleConcurrentielle,
tools=[{"type": "web_search"}]
)
for c in parsed.concurrents:
print(f"{c.nom} — {c.avantage_principal}")
Model urobí nasledovné:
- Vyhľadá aktuálne francúzske neobanky na webe
- Zozbiera relevantné informácie
- Všetko naštruktúruje podľa schémy
VeilleConcurrentielle
Príklad: Sledovanie správ
class Article(BaseModel):
titre: str
source: str
date: str
resume: str
impact: str
class RevuePresse(BaseModel):
sujet: str
articles: list[Article]
synthese: str
response, parsed = client.chat.parse(
model="grok-4.20-0309-reasoning",
messages=[{
"role": "user",
"content": "What is the latest news on AI regulation in Europe?"
}],
response_format=RevuePresse,
tools=[{"type": "web_search"}]
)
print(parsed.synthese)
for article in parsed.articles:
print(f"[{article.source}] {article.titre}")
Osvedčené postupy
Buď v prompte konkrétny
Vyhľadávanie na webe funguje najlepšie s konkrétnymi dotazmi:
# Príliš všeobecné
"What's new in tech?"
# Presné a použiteľné
"The 5 largest AI funding rounds in France in Q1 2026"
Prispôsob schému dostupným dátam
Nepožaduj dáta, ktoré web nedokáže spoľahlivo poskytnúť:
# Ťažko presne dohľadateľné
class Entreprise(BaseModel):
chiffre_affaires_exact: float # zriedka verejné
# Realistické
class Entreprise(BaseModel):
chiffre_affaires_estime: str # "okolo 50 mil. €"
source_estimation: str
Ošetri chýbajúce dáta
Urob polia voliteľnými, ak nemusí byť ich dostupnosť garantovaná:
class InfoEntreprise(BaseModel):
nom: str
fondateur: str
annee_creation: int
valorisation: str | None # nie vždy dostupné
nombre_employes: str | None
Kľúčové poznatky
- Kombinácia štruktúrovaných výstupov a vyhľadávania na webe vyžaduje minimálne Grok 4 – kompatibilná je celá aktuálna ponuka
- Vyhľadávanie na webe povoľ pomocou
tools=[{"type": "web_search"}] - Jedno volanie API nahradí reťazec vyhľadávanie → parsovanie → štruktúrovanie
- Pre lepšie výsledky buď v promptoch konkrétny
- Ak nie je dostupnosť zaručená, urob polia voliteľnými