# Varför misslyckas verktygsanrop när en kodagent byter modell? > Verktygsanrop slutar ofta fungera efter ett modellbyte eftersom protokoll, schemastruktur, argumentserialisering, strömhändelser eller samtalstillstånd förändras. Behandla bytet som en kontraktsmigrering, inte som ett nytt modellnamn. Ett bra första test är mindre än ett kodbenchmark: be ersättningsmodellen anropa en skrivskyddad funktion med två obligatoriska argument. Om det misslyckas ligger felet under planeringslagret. Om det lyckas lägger du till strömning, flera verktyg, tillstånd och skrivåtgärder ett steg i taget tills den första kontraktsbrytningen syns. Ett modellbyte blottlägger antaganden som den gamla integrationen dolde. En kodagent är inte bara en prompt och en modell, utan en tillståndsmaskin som kopplar modellutdata, strömparser, verktygsregister, exekverare och återkopplingsloop. ## Skilj kapabilitet från protokoll En modell kan vara stark på kod men saknas i protokollet som klienten skickar. En annan kan acceptera begäran men inte erbjuda verktyg på den routen. Kontrollera kapabilitetsmetadata innan modellnamnet ändras. [Atlas Clouds guide till LLM-protokoll](https://www.atlascloud.ai/docs/llm-protocols?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=why-tool-calls-fail-after-switching-coding-agent-models) beskriver OpenAI Chat Completions, Responses, Anthropic Messages, Google Gemini och andra format på samma bas-URL. Alla modeller stöder inte alla protokoll. Använd modellens `supported_apis` och verktygskapabilitet som källa. | Lager | Migreringsfråga | Felsignal | |---|---|---| | Endpoint | Accepterar modellen protokollet? | 400-svar eller ignorerade fält | | Kapabilitet | Erbjuder routen verktyg? | Text i stället för anrop | | Schema | Är namn och JSON Schema giltiga? | Saknade eller felaktiga argument | | Ström | Sätts argumentdelta ihop rätt? | Avhuggen JSON | | Loop | Returneras resultat i rätt roll? | Upprepat anrop eller stoppad tur | ## Minska verktygsschemat till ett kontrakt Börja med en funktion med kort namn, två obligatoriska strängar, inga unioner och ingen valfri nästling. Komplexa scheman blandar modellbeteende med validatorbeteende. ```json { "type": "function", "function": { "name": "read_file", "description": "Read a UTF-8 text file from the workspace.", "parameters": { "type": "object", "properties": { "path": {"type": "string"}, "max_chars": {"type": "integer", "minimum": 1} }, "required": ["path", "max_chars"], "additionalProperties": false } } } ``` Tvinga funktionen om protokollet stöder det. Ett tvingat anrop skiljer oförmåga från ett planeringsbeslut att inte anropa. ## Testa utan strömning först Ett icke-strömmande svar visar hela verktygsobjektet i en payload. Vid strömning kan namn, anrops-ID och JSON-argument komma i separata händelser. Tolka argumenten först efter protokollets slutmarkör. Kör aldrig ett verktyg bara för att en delbuffert råkar vara giltig JSON. En senare delta kan förlänga den. Håll buffertar per anrops-ID, avvisa dubbel slutföring och spara rå händelseordning. | Ströminvariant | Krävt beteende | |---|---| | Stabil anropsidentitet | Alla delta går till samma buffert | | Ordnad sammanfogning | Fragment läggs till i händelseordning | | Tydligt avslut | Exekvering väntar på slutmarkör | | Enkel exekvering | Ett färdigt anrop körs högst en gång | ## Normalisera agentloopen uttryckligen Sprid inte leverantörsspecifika fält i exekveraren. Översätt varje svar till ett internt format som `assistant_text`, `tool_calls`, `usage` och `stop_reason`, och översätt resultat tillbaka genom en protokolladapter. Behandla anrops-ID som ogenomskinliga och bevara dem exakt. Validera argument före körning och returnera strukturerade fel i stället för att tyst reparera felaktig JSON. ## Nollställ tillståndet i första jämförelsen Gamla historikobjekt kan innehålla resonemangsblock, verktygsroller, tillståndshandtag eller assistentmeddelanden som den nya routen avvisar. Börja med en ny konversation och samma systeminstruktioner, och spela sedan upp en kort normaliserad historik. Genvägar för tillstånd är protokollspecifika. Testa uttryckligen om instruktioner består i stället för att anta det. ## Bygg en migreringsstege Kör samma fixtures i denna ordning: * Vanligt textsvar. * Ett tvingat skrivskyddat verktyg utan strömning. * Automatiskt verktygsval utan strömning. * Ett tvingat verktyg med strömning. * Två oberoende verktyg. * Ett verktygsfel och återhämtning. * En kort koduppgift över flera turer. Stanna vid första felet och granska rådata. Hoppa inte direkt från hälsokontroll till autonom repoändring. ## Avgör om en adapter räcker En gemensam adapter fungerar när skillnaderna gäller fält- eller händelsenamn. Separata adaptrar är säkrare när modeller kräver olika protokoll, historikformat eller resultatsemantik. Atlas Cloud förenklar modellexperiment genom att en nyckel och bas-URL ger flera format och en föränderlig [LLM-modellkatalog](https://www.atlascloud.ai/llm-models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=why-tool-calls-fail-after-switching-coding-agent-models). Det ersätter inte kapabilitetskontroller. Registrera modell, protokoll, schemaversion, strömläge och testresultat tillsammans. ## Slutsatsen Verktygsanrop misslyckas efter ett modellbyte när integrationen behandlar en beteende- och protokollmigrering som ett strängbyte. Verifiera routen, förenkla schemat, kör ett tvingat icke-strömmande test, validera strömsammansättningen och lägg till samtalstillstånd sist. Behåll separata adaptrar när meddelande- eller händelsesemantiken verkligen skiljer sig. ## FAQ ### Varför svarar den nya modellen med text i stället för att anropa ett verktyg? Modellen kanske inte stöder verktyg i det valda protokollet, kräver en annan inställning för verktygsval eller tolkar beskrivningen annorlunda. Kontrollera kapabiliteten och testa ett tvingat anrop. ### Kan två OpenAI-kompatibla modeller returnera olika format för verktygsanrop? Ja. Det yttre begärandeformatet kan vara kompatibelt medan strömdelta, anrops-ID, argumentens avslut och stoppskäl skiljer sig. ### Bör jag återanvända den gamla konversationen efter modellbytet? Bara efter att ha verifierat att den nya modellen och protokollet accepterar samma historikobjekt. Börja säkrare med en ny konversation och lägg sedan tillbaka tillstånd medvetet. ### Vilket är det snabbaste diagnostiska testet? Tvinga ett deterministiskt skrivskyddat verktyg med ett litet JSON-schema, kör utan strömning och logga rå begäran och svar innan du testar hela agentloopen. ### Normaliserar Atlas Cloud alla modeller till ett identiskt verktygsgränssnitt? Nej. Atlas Cloud stöder flera protokoll och varje modell publicerar sina API:er och kapabiliteter. Klienten måste välja ett protokoll som modellen stöder. ### När bör två modeller ha separata adaptrar? Behåll separata adaptrar när deras tillståndsobjekt, strömhändelser, verktygsresultat eller felsemantik inte kan uttryckas säkert i ett gemensamt kontrakt.