Idempotente tools met aandacht voor bijwerkingen
Zorg dat herhaalde aanroepen veilig en voorspelbaar zijn.
Idempotente tools met aandacht voor bijwerkingen is een gratis MCP Academy-les op CoddyKit. Dit is les 3 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject MCP Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus MCP Academy bevat in totaal 4 lessen.
Modellen kunnen twee keer aanroepen
Een AI-client kan een tool opnieuw proberen na een time-out of verbroken verbinding. Je tool kan daardoor twee keer worden uitgevoerd terwijl de gebruiker maar één keer iets bedoelde.
Wat idempotent betekent
Een tool is idempotent wanneer opnieuw aanroepen met dezelfde invoer niets extra's verandert. De tweede aanroep is veilig een no-op.
Leesbewerkingen zijn van nature veilig
Pure tools om te lezen, zoals het ophalen van een record, zijn al idempotent. Herhalen levert gewoon hetzelfde antwoord op zonder schade.
@mcp.tool()
def get_user(id: int) -> dict:
return db.find(id)Schrijfbewerkingen vereisen zorg
Een tool die iets aanmaakt of geld afschrijft, is gevaarlijk om te herhalen. Een blinde nieuwe poging kan een dubbele rij toevoegen of een betaling dubbel uitvoeren.
Gebruik een door de client geleverde sleutel
Vraag de aanroeper om een idempotentiesleutel. Als je die sleutel al hebt verwerkt, geef je het opgeslagen resultaat terug in plaats van opnieuw te handelen.
if key in seen:
return seen[key]
seen[key] = do_work()Geef de voorkeur aan upsert boven insert
Een upsert schrijft of werkt bij op basis van een stabiele id, zodat twee keer uitvoeren één rij oplevert in plaats van twee. Herhaalde pogingen worden samengevoegd tot één toestand.
INSERT ... ON CONFLICT (id)
DO UPDATE SET ...Declareer neveneffecten duidelijk
Zeg in de beschrijving van de tool of deze gegevens wijzigt. Het model beslist verstandiger wanneer het weet dat een aanroep destructief is.
Scheid lees- en schrijftools
Houd een querytool en een mutatietool gescheiden in plaats van één tool die soms schrijft. Duidelijke grenzen beperken onbedoelde wijzigingen.
Maak resultaten deterministisch
Geef waar mogelijk dezelfde uitvoer terug voor dezelfde invoer. Voorspelbare resultaten helpen clients om je tool te cachen en te begrijpen.
Controleer voordat je handelt
Controleer vóór een schrijfbewerking de huidige toestand van het doel. Als de wijziging al is toegepast, meld je succes zonder deze opnieuw uit te voeren.
if order.status == "shipped":
return "already shipped"Omhul werk met meerdere stappen in één transactie
Als een tool meerdere rijen aanraakt, voer je dit uit in één transactie. Bij een nieuwe poging wordt alles volledig toegepast of volledig teruggedraaid, nooit half.
Korte controle
Waarom is idempotentie belangrijk voor een MCP-tool die records aanmaakt?
Samenvatting: veilig herhalen
Maak schrijfbewerkingen idempotent met sleutels of upserts, declareer neveneffecten, splits lezen en schrijven op en gebruik transacties. Volgende onderwerp: versiebeheer. ♻️
Leer Python met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 30
- Lessen
- 120
Veelgestelde vragen
Is de les “Idempotente tools met aandacht voor bijwerkingen” gratis?
Ja — je kunt hier op het web alle 3 lessen van het leerpad MCP Academy, waaronder “Idempotente tools met aandacht voor bijwerkingen”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus MCP Academy bevat in totaal 4 lessen.
Wat leer ik in “Idempotente tools met aandacht voor bijwerkingen”?
Zorg dat herhaalde aanroepen veilig en voorspelbaar zijn. Je oefent met MCP Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met MCP Academy te beginnen?
Ervaring vooraf is niet nodig. MCP Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 3 van 4.
Hoe lang duurt de les “Idempotente tools met aandacht voor bijwerkingen”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over MCP Academy?
Ja. Elke les over MCP Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Gelaagde serverarchitectuur
- Configuratie en geheimen via de omgeving
- Idempotente tools met aandacht voor bijwerkingen
- Tools en schema's versiebeheer geven