...
← Curs Aplicații AI cu Claude și OpenAI: toate lecțiile
Lecția 1 · Cum funcționează LLM-urile

Prima ta aplicație AI în câteva linii

Chatboții, asistenții de suport și rezumatele automate pe care le folosești zilnic au în spate același lucru: un program care trimite text unui model AI printr-un API și primește un răspuns. În această lecție scrii primul tău astfel de program, în Python, în mai puțin de 10 linii.

Ce construiești în acest curs

Un model de limbaj (LLM, de la Large Language Model) precum Claude sau GPT primește text și scrie text. Singur, e doar o conversație într-o fereastră de chat. Puterea apare când aplicația ta vorbește cu el: îi dă datele firmei, îi cere răspunsuri în format JSON, îl lasă să apeleze funcțiile tale și îi verifică rezultatul.

În acest curs înveți exact asta: să construiești aplicații reale peste modele AI, cu API-urile Claude (Anthropic) și OpenAI. La final vei avea un chatbot pentru un site, un asistent de suport care răspunde din documentele unei firme și un agent care automatizează un flux de lucru.

Ce este și ce nu este acest curs

Construiești aplicații care folosesc modele AI existente (Claude, GPT) prin API-urile lor: prompturi, răspunsuri JSON, tool use, RAG, agenți. Nu antrenezi modele și nu ai nevoie de matematică; dacă vrei să înveți cum se antrenează un model, acela e cursul de Machine Learning. Ce îți trebuie: bazele Python (variabile, liste, dicționare, funcții, bucle). Dacă nu le ai încă, începe cu cursul de Python și revino aici.

MagazinAsistent pentru clienți

Răspunde la întrebări despre produse, livrare și retur, din informațiile magazinului.

BirouRezumate și extragere de date

Transformă emailuri, facturi și contracte în date structurate pe care aplicația le salvează.

FirmăAgenți care lucrează

Verifică o comandă, creează un tichet și trimite răspunsul, pas cu pas, cu reguli clare.

Cum vorbește aplicația ta cu un model

Modelul nu rulează pe calculatorul tău. Rulează pe serverele furnizorului (Anthropic pentru Claude, OpenAI pentru GPT). Programul tău îi trimite o cerere HTTP cu mesajul și câteva setări, iar serverul întoarce răspunsul. Biblioteca anthropic (SDK-ul oficial pentru Python) face pentru tine partea de HTTP: tu doar apelezi o funcție.

Aplicația tamain.pymessages.create()APIapi.anthropic.comverifică cheia, limiteleModelulclaude-haiku-5-5generează răspunsulcerererăspunsÎn lecții, API-ul și modelul sunt simulate în browser: același cod, fără cheie și fără cost.
Drumul unui mesaj: aplicația ta trimite o cerere API-ului, modelul generează răspunsul, iar aplicația îl primește înapoi.
În lecții, API-ul este simulat

Ca să poți exersa oricât, fără cont, fără cheie și fără cost, în editorul din dreapta modulele anthropic și openai sunt simulate: au aceeași interfață ca bibliotecile oficiale, dar răspunsurile sunt pregătite pentru fiecare lecție. Așa poate fi verificat automat fiecare exercițiu (un model real răspunde puțin diferit la fiecare rulare). Codul pe care îl scrii aici rulează la fel în proiectele tale, după pip install anthropic. În lecțiile cheie din modulele plătite găsești și casete marcate model real: acolo răspunde Claude Haiku 5.5, prin serverul Academiei, cu un număr limitat de cereri. Diferențele dintre simulator și modelul real le vezi pe larg în lecția 26.

Primul apel, linie cu linie

import anthropic

MODEL = "claude-haiku-5-5"

client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=300,
    messages=[{"role": "user", "content": "Ce este un API? Explică într-o frază."}],
)

print(raspuns.content[0].text)
Un API este o interfață prin care un program cere servicii altui program, după reguli clare: trimiți o cerere, primești un răspuns.
1
import anthropic încarcă biblioteca oficială a API-ului Claude.
2
MODEL = "claude-haiku-5-5" ține numele modelului într-un singur loc. Haiku 5.5 este modelul rapid și ieftin al familiei Claude; îl folosim implicit în curs.
3
anthropic.Anthropic() creează clientul. În proiectele tale, el citește cheia API din variabila de mediu ANTHROPIC_API_KEY (vei vedea cum în modulul 3).
4
client.messages.create(...) trimite cererea: model, max_tokens (câți tokeni poate avea cel mult răspunsul, obligatoriu) și messages, lista conversației.
5
raspuns.content[0].text este textul răspunsului: content e o listă de blocuri, iar primul bloc conține textul.
Un mesaj = un dicționar

Fiecare mesaj are un role (cine vorbește: "user" pentru om, "assistant" pentru model) și un content (textul). Chiar și pentru o singură întrebare trimiți o listă cu un mesaj.

Ce mai conține răspunsul

Obiectul primit are mai multe informații utile pentru o aplicație reală: de ce s-a oprit modelul și câți tokeni (bucăți de text) a consumat cererea. Tokenii sunt unitatea după care plătești, de aceea aplicațiile serioase îi urmăresc la fiecare apel.

import anthropic

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

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=300,
    messages=[{"role": "user", "content": "Scrie un slogan pentru o cafenea de cartier."}],
)

print("Text:", raspuns.content[0].text)
print("Motivul opririi:", raspuns.stop_reason)
print("Tokeni intrare:", raspuns.usage.input_tokens)
print("Tokeni ieșire:", raspuns.usage.output_tokens)
Text: Cafeaua ta de dimineață, prăjită cu grijă la colțul străzii.
Motivul opririi: end_turn
Tokeni intrare: 22
Tokeni ieșire: 20
CâmpCe înseamnă
contentlista blocurilor răspunsului (text, apeluri de tool-uri)
stop_reasonend_turn = modelul a terminat singur; max_tokens = s-a atins limita și răspunsul e tăiat
usage.input_tokenstokenii trimiși (mesajele tale)
usage.output_tokenstokenii scriși de model (costă de 5 ori mai mult la Haiku 5.5)

Greșeli frecvente la primul apel

  • Uiți max_tokens: biblioteca oprește programul cu TypeError: Missing required arguments, pentru că limita răspunsului e obligatorie la Claude.
  • Scrii greșit numele modelului (de exemplu claude-haiku): API-ul răspunde cu eroarea 404 not_found_error: model. Copiază numele exact din documentație.
  • Trimiți content ca număr sau listă goală: primești 400 content cannot be empty. Mesajul trebuie să fie un text.
  • Afișezi raspuns direct în loc de raspuns.content[0].text: vezi tot obiectul, nu doar textul.
Bine de știut

Răspunsurile unui model real diferă puțin de la o rulare la alta, chiar pentru aceeași întrebare. În simulator sunt mereu aceleași, ca exercițiile să poată fi verificate automat.

Exercițiul tău

Scrie primul tău program care vorbește cu un model AI. Trimite modelului întrebarea Dă-mi 3 idei de aplicații AI pentru o firmă mică. și afișează textul răspunsului, apoi pe o linie separată Oprire: urmat de stop_reason.

  • Creează clientul cu anthropic.Anthropic().
  • Apelează client.messages.create cu model=MODEL, max_tokens=400 și un mesaj cu rolul user care conține exact întrebarea din enunț.
  • Afișează raspuns.content[0].text.
  • Afișează Oprire: + raspuns.stop_reason.
Mesajul este un dicționar: {"role": "user", "content": "..."}, pus într-o listă la parametrul messages.

Soluția exercițiului

import anthropic

MODEL = "claude-haiku-5-5"

client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=400,
    messages=[{"role": "user", "content": "Dă-mi 3 idei de aplicații AI pentru o firmă mică."}],
)

print(raspuns.content[0].text)
print("Oprire:", raspuns.stop_reason)
Excelent! Continuă cu lecția următoare →
main.pyPython
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Cum funcționează LLM-urile Lecția 1 · Prima ta aplicație AI în câteva linii
Progres 0% 0 din 10
Lecția curentă 1 / 8 Cum funcționează llm-urile