AI-agenter · Lektion

Validering af værktøjsoutput (Pydantic)

Parse hvert værktøjsoutput gennem en Pydantic-model — slå tydeligt fejl ved et forkert formateret svar.

Lektion 4 af 414 trin

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.0

Validate 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 results

Lister 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 v

Streng 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'   # fallback

Validé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 v1

Generé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.

Gratis at komme i gang

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

  1. Idempotente værktøjer og sideeffekter
  2. Retries med eksponentiel backoff
  3. Timeouts og circuit breakers
  4. Validering af værktøjsoutput (Pydantic)
← Tilbage til AI-agenter