...
Eroare Aplicații AI cu LLM · Parametri și mesaje respinse de API

anthropic.BadRequestError: Error code: 400 - messages: first message must use the "user" role

Pe scurt

Lista `messages` începe cu un mesaj `assistant`, iar API-ul Claude cere ca primul mesaj să fie de la `user`. Apare des după ce tai istoricul conversației și rămâne în față un răspuns al asistentului: taie în perechi sau scoate mesajele `assistant` de la început.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O conversație trimisă la Claude trebuie să înceapă cu utilizatorul și să alterneze, în principiu, user și assistant. Mesajul îți spune că primul element din messages are rolul assistant.

Cazul clasic e chatbotul care păstrează doar ultimele N mesaje ca să nu depășească fereastra de context. Dacă N e impar sau tăierea nu ține cont de perechi, lista rămasă poate începe cu un răspuns al asistentului. Alt caz frecvent: un mesaj de bun venit („Bună! Cu ce te ajut?”) afișat în interfață și salvat în istoric ca primul mesaj assistant.

Reparația: după orice tăiere, elimină mesajele de la început până dai de unul user; mesajele de bun venit le ții doar în interfață sau le transformi în instrucțiuni în system.

De ce apare: cauzele frecvente

1Istoric tăiat la un număr impar de mesaje

Greșit
PYTHON
ultimele = istoric[-3:]   # poate începe cu "assistant"
client.messages.create(model=MODEL, max_tokens=300, messages=ultimele)
Corect
PYTHON
ultimele = istoric[-3:]
while ultimele and ultimele[0]["role"] != "user":
    ultimele = ultimele[1:]
client.messages.create(model=MODEL, max_tokens=300, messages=ultimele)

După tăiere, elimini mesajele de la început până când primul e de la utilizator.

2Mesajul de bun venit salvat în istoric

Greșit
PYTHON
istoric = [{"role": "assistant", "content": "Bună! Cu ce te pot ajuta?"}]
istoric.append({"role": "user", "content": mesaj})
Corect
PYTHON
istoric = []   # salutul e doar în interfață
istoric.append({"role": "user", "content": mesaj})

Salutul nu e un răspuns la o întrebare a utilizatorului, deci nu are ce căuta la începutul conversației trimise la API.

Repară tu

Repară eroarea, direct în pagină

Chatbotul de mai jos păstrează doar ultimele 4 mesaje din istoric și primește o eroare 400 (first message must use the "user" role). Repară funcția ultimele_mesaje(istoric, n): după tăiere, scoate mesajele de la început până când primul este de la user. Programul afișează rolul primului mesaj trimis și răspunsul.

Codul care dă eroarea
PYTHON
import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()

istoric = [
    {"role": "user", "content": "Bună, am comandat o canapea."},
    {"role": "assistant", "content": "Bună! Spune-mi numărul comenzii, te rog."},
    {"role": "user", "content": "Comanda 5521."},
    {"role": "assistant", "content": "Comanda 5521 este în depozit și pleacă mâine."},
    {"role": "user", "content": "Când ajunge la Cluj?"},
]


def ultimele_mesaje(istoric, n):
    return istoric[-n:]


mesaje = ultimele_mesaje(istoric, 4)
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=mesaje)
print("primul rol:", mesaje[0]["role"])
print(raspuns.content[0].text)
După reparație, programul afișează
primul rol: user
Comanda 5521 ajunge la Cluj în 2 zile lucrătoare de la plecarea din depozit.
Indiciu

Un while care scoate primul element cât timp rolul lui nu e user.

Alte forme ale mesajului

  • anthropic.BadRequestError: Error code: 400 - invalid_request_error: messages: first message must use the "user" role

Cum o eviți pe viitor

  • Când limitezi istoricul, taie în perechi (întrebare + răspuns), nu la un număr oarecare de mesaje.
  • Scrie o funcție pregateste_istoric(...) care taie, verifică primul rol și o folosește la fiecare apel.
  • Mesajele de interfață (salut, sugestii) nu intră în messages; ce trebuie să știe modelul pui în system.

Întrebări frecvente

De ce contează cine vorbește primul?

Pentru că Messages API modelează o conversație în care asistentul răspunde utilizatorului. Un răspuns fără o întrebare înainte nu are sens în acest format, deci API-ul îl respinge.

OpenAI acceptă istoric care începe cu assistant?

Formatul OpenAI e mai permisiv, dar ideea de a tăia istoricul în perechi rămâne bună practică la ambii furnizori: modelul înțelege mai bine conversația.

Erori înrudite

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție

Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.