Validering af værktøjsoutput (Pydantic)
Parse hvert værktøjsoutput gennem en Pydantic-model — slå tydeligt fejl ved et forkert formateret svar.
Validering af værktøjsoutput (Pydantic) er en gratis AI-agenter-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i AI-agenter, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. AI-agenter-kurset indeholder 4 lektioner i alt.
Dele af denne lektion er endnu ikke oversat og vises på engelsk.
Stol på, men kontrollér
Værktøjsresultater kommer fra verden udenfor — API'er, websider og modeller. Et forkert udformet eller uventet resultat kan få din agent til at gå ned eller, endnu værre, ubemærket give LLM'en dårlige data.
Validér hvert værktøjsresultat mod et skema.
Pydantic-modeller
Definér de forventede strukturer:
from pydantic import BaseModel, HttpUrl
class SearchResult(BaseModel):
title: str
url: HttpUrl
snippet: str
score: float = 0.0Validate at the Boundary
from pydantic import ValidationError
def search(query):
raw = requests.post('https://api.tavily.com/search', json={'query': query}).json()
results = []
for r in raw.get('results', []):
try:
results.append(SearchResult.model_validate(r))
except ValidationError as e:
log.warning('Bad search result skipped: %s', e)
return resultsLister med modelvalidering
Validér hele svaret:
from pydantic import BaseModel
class SearchResponse(BaseModel):
results: list[SearchResult]
response = SearchResponse.model_validate(raw)Feltvalidatorer
Tilpassede kontroller inde i felter:
from pydantic import field_validator
class SearchResult(BaseModel):
score: float
@field_validator('score')
@classmethod
def score_in_range(cls, v):
if not 0 <= v <= 1:
raise ValueError('score out of [0,1]')
return vStreng kontra lempelig
Som standard tvinger Pydantic typer til at passe (string -> int, når det er muligt). Brug strenge kontroller:
from pydantic import StrictInt
class User(BaseModel):
age: StrictInt # rejects '25' (string)Default Values for Missing Fields
class Tool(BaseModel):
name: str
description: str = 'No description provided' # fallbackValidér strukturerede LLM-resultater
Tving modellen til at returnere JSON, der passer til et Pydantic-skema — se lektionen om strukturerede resultater. Validér igen ved grænsen som et ekstra forsvarslag.
Validér værktøjsargumenter
Validér modellens tool_call.arguments, før du udfører kaldet:
class SearchArgs(BaseModel):
query: str
k: int = 5
args = SearchArgs.model_validate_json(tool_call.function.arguments)
results = search(args.query, args.k)Valideringsfejl som værktøjsresultater
Hvis valideringen fejler, skal du returnere fejlen til modellen, så den kan forsøge igen med korrigerede argumenter:
try:
args = SearchArgs.model_validate_json(...)
except ValidationError as e:
return {'error': f'Invalid arguments: {e}'}Versionsstyring af skemaer
Når skemaet for et værktøjsresultat ændres, skal du versionsstyre det:
class SearchResultV2(BaseModel):
title: str
url: HttpUrl
relevance: float # was 'score' in v1Generér JSON Schema fra Pydantic
Afled værktøjsskemaer fra din Pydantic-klasse:
schema = SearchArgs.model_json_schema()
# Use directly as the 'parameters' for an OpenAI tool definition.Målet med validering
Hvorfor bruge Pydantic på alle værktøjsresultater?
Opsummering
Pydantic ved alle grænser: værktøjsargumenter på vej ind, værktøjsresultater på vej ud og strukturerede LLM-resultater. Tydelige fejl er bedre end ubemærket datakorruption.
Lær AI-agenter med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 60
- Lektioner
- 239
Ofte stillede spørgsmål
Er lektionen “Validering af værktøjsoutput (Pydantic)” gratis?
Ja — hele teksten til “Validering af værktøjsoutput (Pydantic)” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af AI-agenter-kurset, skal du opgradere til CoddyKit PRO. AI-agenter-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Validering af værktøjsoutput (Pydantic)”?
Parse hvert værktøjsoutput gennem en Pydantic-model — slå tydeligt fejl ved et forkert formateret svar. Du øver dig i AI-agenter med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på AI-agenter?
Der kræves ingen tidligere erfaring. AI-agenter på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.
Hvor lang tid tager lektionen “Validering af værktøjsoutput (Pydantic)”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne AI-agenter-lektion?
Ja. Alle AI-agenter-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Idempotente værktøjer og sideeffekter
- Retries med eksponentiel backoff
- Timeouts og circuit breakers
- Validering af værktøjsoutput (Pydantic)