Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Slučajevi upotrebe Codestrala

Lekcija 4 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Četiri stupa korištenja Codestrala
  2. Automatsko dovršavanje u IDE-u u stvarnom vremenu
  3. Generiranje potpunog koda
  4. Automatska dokumentacija
  5. Generiranje jediničnih testova
  6. Sažetak slučajeva upotrebe
  7. Ključne točke

Četiri stupa korištenja Codestrala

Svođenje Codestrala na običan alat za automatsko dovršavanje propušta polovicu njegove vrijednosti. Njegove mogućnosti obuhvaćaju četiri ključna područja razvoja softvera: automatsko dovršavanje u IDE-u, generiranje koda, automatsku dokumentaciju i izradu testova. Svako područje zahtijeva specifične postavke. Jasno razlikovanje između njih sprječava razočaravajuće rezultate korištenja „istog prompta za sve“.

Automatsko dovršavanje u IDE-u u stvarnom vremenu

Ovo je najprirodniji slučaj upotrebe modela i onaj koji najbolje iskorištava Fill-in-the-Middle (FIM). Scenarij je uvijek isti: tipkaš u VS Codeu ili JetBrains IDE-u, proširenje poput Continue.dev ili Tabnine detektira pauzu u tipkanju, šalje FIM zahtjev koji sadrži kontekst datoteke, prima prijedlog u manje od 500 ms, a ti ga prihvaćaš s Tab ili odbijaš s Esc. Cijeli izazov leži u tom proračunu od 500 ms: nakon toga, prijedlog stiže nakon što si već ručno otipkao redak, pretvarajući pomoć u smetnju.

Primarna poluga je veličina poslanog konteksta. Što više pružiš, to je relevantnost veća, ali je odgovor sporiji.

# Optimized configuration for autocomplete
response = client.fim.complete(
    model="codestral-latest",
    prompt=context_before_cursor[-2000:],   # Limit context
    suffix=context_after_cursor[:500],      # Short suffix
    temperature=0,
    max_tokens=80,                            # Short completions
    stop=["\n\n", "\ndef ", "\nclass "],
)

U praksi, 2000 znakova za prompt i 500 za sufiks nude izvrstan omjer kvalitete i brzine. Primijeti asimetriju: zadržavamo zadnje znakove prije kursora i prve nakon njega jer relevantnost opada kako se udaljavaš od točke umetanja.

Generiranje potpunog koda

Kada ti treba cijela funkcija, klasa ili modul, krajnja točka chata postaje prikladnija. Kvaliteta rezultata tada izravno ovisi o preciznosti tvog zahtjeva: eksplicitna specifikacija s navedenim tehničkim ograničenjima proizvodi upotrebljiv kod; nejasan zahtjev proizvodi kostur koji ćeš morati u potpunosti prepisati.

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "system",
            "content": "Python expert. Clean, typed code with error handling."
        },
        {
            "role": "user",
            "content": """Create a Python `CacheManager` class with:
            - An in-memory LRU cache with configurable TTL
            - get, set, delete, and clear methods
            - A @cached decorator for functions
            - Thread safety using threading.Lock"""
        }
    ],
    temperature=0.2,
    max_tokens=1500,
)

Ovaj radni tijek sjaji u četiri scenarija: pokretanje nove datoteke ili praznog modula, implementacija složenog algoritma opisanog prirodnim jezikom, brzo prototipiranje API-ja ili usluge za testiranje njegove strukture te pretvaranje pseudokoda u funkcionalni kod. Zajednički nazivnik je odsutnost postojećeg koda kojeg se treba pridržavati. Čim je uključen postojeći kod, FIM ponovno postaje poželjniji.

Automatska dokumentacija

Dokumentacija je zadatak koji timovi odgađaju za sutra, no Codestral to rješava u sekundama. Uzmi nedokumentiranu funkciju s četiri parametra i uvjetnim ponašanjem u zaglavlju:

code = """
def parse_csv_to_dict(filepath, delimiter=',', encoding='utf-8', skip_header=False):
    results = []
    with open(filepath, 'r', encoding=encoding) as f:
        reader = csv.reader(f, delimiter=delimiter)
        if skip_header:
            headers = next(reader)
        else:
            headers = [f'col_{i}' for i in range(len(next(reader)))]
        for row in reader:
            results.append(dict(zip(headers, row)))
    return results
"""

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "user",
            "content": f"Add a complete Google-style docstring to this function:\n\n{code}"
        }
    ],
    temperature=0,
)

Generirani docstring opisuje svaki parametar, njegovu zadanu vrijednost i vraćenu strukturu. Isti mehanizam, s drugačijom instrukcijom, dodaje komentare redcima koji ih zaslužuju – ovdje granu else koja izrađuje umjetna imena stupaca, što bi moglo iznenaditi sljedećeg čitatelja.

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "user",
            "content": f"Add explanatory comments to the complex lines in this code:\n\n{code}"
        }
    ],
    temperature=0,
)

Zadrži temperature=0 za oba zadatka: dokumentiraš ono što postoji, ne izmišljaš ništa.

Generiranje jediničnih testova

Codestral generira testove iz izvornog koda, a ovo je često područje gdje štedi najviše vremena jer su rubni slučajevi upravo ono što žurni programer zaboravi.

function_to_test = """
def validate_email(email: str) -> bool:
    import re
    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
    return bool(re.match(pattern, email))
"""

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "system",
            "content": "Generate comprehensive pytest tests. Include edge cases and error cases."
        },
        {
            "role": "user",
            "content": f"Generate tests for this function:\n\n{function_to_test}"
        }
    ],
    temperature=0.1,
    max_tokens=1000,
)

Dobivena pokrivenost spada u četiri obitelji. Nominalni slučajevi provjeravaju valjane adrese. Rubni slučajevi guraju format do granica s dugim domenama ili dopuštenim posebnim znakovima. Slučajevi pogrešaka pokrivaju nevažeće formate, prazne nizove i None. Konačno, regresijski slučajevi ponovno obrađuju ono što se negdje drugdje pokvarilo: poddomene i nedavne TLD-ove. Uvijek pregledaj ove testove prije commitanja – test generiran iz buggy koda vjerno dokumentira bug.

Sažetak slučajeva upotrebe

Slučaj upotrebeKrajnja točka (Endpoint)TemperaturaMaksimalan broj tokena
Automatsko dovršavanje u IDE-uFIM050-100
Generiranje funkcijaChat0.2500-1500
Docstringovi / KomentariChat0300-500
Jedinični testoviChat0.1800-1500
RefaktoriranjeChat01000-2000
Konverzija jezikaChat01000-2000

Ključne točke

  • Automatsko dovršavanje u IDE-u koristi FIM s parametrima optimiziranima za kašnjenje
  • Generiranje potpunog koda koristi krajnju točku chata sa strukturiranim promptom
  • Codestral generira docstringove i komentare profesionalne kvalitete
  • Generiranje testova automatski pokriva rubne slučajeve i scenarije pogrešaka
  • Svaki slučaj upotrebe ima optimalne postavke temperature i tokena