Deklarér parametre med type hints
Brug Python-typeangivelser til at forme værktøjets skema.
Deklarér parametre med type hints er en gratis MCP Academy-lektion på CoddyKit. Dette er lektion 2 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i MCP Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. MCP Academy-kurset indeholder 4 lektioner i alt.
Parametre bliver til et skema
Hvert argument i din værktøjsfunktion bliver en del af et input-skema, som modellen skal følge, når den kalder dit værktøj. 🧩
Typeangivelserne gør arbejdet
FastMCP læser dine Python-typeangivelser og opbygger JSON-skemaet for dig, så du sjældent behøver at skrive et skema manuelt.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
De grundlæggende typer mappes enkelt: str bliver til string, int og float bliver til number, og bool bliver til boolean i skemaet.
Uden type er det uklart
Hvis du udelader typeangivelsen, ser modellen kun en løs værdi uden regler, hvilket indbyder til forkert eller ugyldigt input.
def add(a, b):
return a + bPåkrævet som standard
En parameter uden en standardværdi behandles som påkrævet, så modellen skal altid angive den, når værktøjet kaldes.
Standardværdier gør det valgfrit
Giv en parameter en standardværdi, så bliver den valgfri. Modellen kan udelade den, og din funktion bruger reserveværdien.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Lister og ordbøger
Du kan også angive samlingstyper. Et list-argument mappes til et JSON-array, og en dict mappes til et objekt, som modellen kan udfylde.
def tag(items: list[str]) -> int:
return len(items)Valgfrie værdier
Brug Optional, når et argument kan være en værdi eller None. Det signalerer, at modellen med vilje kan lade det stå tomt.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Navngiv parametre tydeligt
Modellen ser navnet på hver parameter i skemaet, så city er bedre end c, og start_date er bedre end arg2. Tydelige navne fører til bedre kald.
Angivelser styrker valideringen
Fordi angivelserne definerer skemaet, kan MCP afvise kald med den forkerte type, før din kode kører, så fejl opdages tidligt.
Hold signaturen lille
Færre, veltypede parametre er nemmere for modellen at udfylde korrekt end en lang liste med løst relaterede argumenter.
Hurtigt tjek
Hvad gør en værktøjsparameter valgfri i FastMCP?
Opsamling
Dine typeangivelser opbygger værktøjets skema: Grundlæggende typer mappes direkte, standardværdier betyder valgfri, og tydelige navne vejleder modellen. ✅
Lær Python 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
- 30
- Lektioner
- 120
Ofte stillede spørgsmål
Er lektionen “Deklarér parametre med type hints” gratis?
Ja — alle 3 lektioner i læringssporet MCP Academy, inklusive “Deklarér parametre med type hints”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. MCP Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Deklarér parametre med type hints”?
Brug Python-typeangivelser til at forme værktøjets skema. Du øver dig i MCP Academy 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å MCP Academy?
Der kræves ingen tidligere erfaring. MCP Academy 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 2 af 4.
Hvor lang tid tager lektionen “Deklarér parametre med type hints”?
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 MCP Academy-lektion?
Ja. Alle MCP Academy-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
- Navngiv og beskriv et værktøj godt
- Deklarér parametre med type hints
- Returnér nyttige resultater
- Et beregnerværktøj fra start til slut