Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Primeri uporabe Codestral

Lekcija 4 od 14 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Štirje stebri uporabe Codestral
  2. Samodejno dopolnjevanje v IDE v realnem času
  3. Generiranje celotne kode
  4. Samodejno dokumentiranje
  5. Generiranje enotskih testov
  6. Povzetek primerov uporabe
  7. Ključne ugotovitve

Štirje stebri uporabe Codestral

Če Codestral zreduciraš na preprosto orodje za samodejno dopolnjevanje, spregledaš polovico njegove vrednosti. Njegove zmogljivosti zajemajo štiri ključna področja razvoja programske opreme: dopolnjevanje v IDE, generiranje kode, samodejno dokumentiranje in izdelavo testov. Vsako področje zahteva specifične nastavitve. Jasno razlikovanje med njimi preprečuje razočarane rezultate, ki nastanejo ob uporabi „istega poziva za vse”.

Samodejno dopolnjevanje v IDE v realnem času

To je najbolj naravna uporaba modela in tista, ki najbolje izkorišča tehniko Fill-in-the-Middle (FIM). Scenarij je vedno enak: tipkaš v VS Code ali JetBrains IDE, razširitev, kot sta Continue.dev ali Tabnine, zazna premor v tipkanju, pošlje zahtevo FIM z vsebino datoteke, prejme predlog v manj kot 500 ms in ga sprejmeš s tipko Tab ali zavrneš z Esc. Celoten izziv je v tem proračunu 500 ms: če ga presežeš, predlog prispe potem, ko si vrstico že ročno vtipkal, kar pomoč spremeni v nadlogo.

Glavni vzvod je velikost poslanega konteksta. Več kot ga podaš, boljša je ustreznost, a počasnejši je odziv.

# 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 "],
)

V praksi 2000 znakov za poziv in 500 za sufiks ponuja odlično razmerje med kakovostjo in hitrostjo. Opazi asimetrijo: ohraniš zadnje znake pred kazalcem in prve za njim, saj ustreznost pada, ko se oddaljuješ od točke vstavljanja.

Generiranje celotne kode

Ko potrebuješ celotno funkcijo, razred ali modul, je končna točka klepeta (chat) bolj primerna. Kakovost rezultata je nato neposredno odvisna od natančnosti tvoje zahteve: eksplicitna specifikacija z naštetimi tehničnimi omejitvami proizvede uporabno kodo; nejasna zahteva proizvede ogrodje, ki ga boš moral popolnoma 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,
)

Ta delovni tok blesti v štirih scenarijih: začetek nove datoteke ali praznega modula, implementacija kompleksnega algoritma, opisanega v naravnem jeziku, hitro prototipiranje API-ja ali storitve za preverjanje njegove strukture ter pretvorba psevdokode v funkcionalno kodo. Skupni imenovalec je odsotnost obstoječe kode, ki bi jo bilo treba upoštevati. Takoj ko je vključena obstoječa koda, postane FIM ponovno prednostna izbira.

Samodejno dokumentiranje

Dokumentiranje je naloga, ki jo ekipe prelagajo na jutri, vendar jo Codestral opravi v nekaj sekundah. Vzemi nedokumentirano funkcijo s štirimi parametri in pogojnim vedenjem v glavi:

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,
)

Ustvarjeni docstring opiše vsak parameter, njegovo privzeto vrednost in vrnjeno strukturo. Isti mehanizem z drugačnim navodilom doda komentarje vrsticam, ki si jih zaslužijo – tukaj vejici else, ki ustvari umetna imena stolpcev, kar bi lahko presenetilo naslednjega bralca.

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,
)

Za obe nalogi ohrani temperature=0: dokumentiraš tisto, kar obstaja, ne izmišljaš si ničesar.

Generiranje enotskih testov

Codestral generira teste iz izvorne kode in prav tu pogosto prihrani največ časa, saj so robni primeri ravno tisto, na kar razvijalec v naglici pozabi.

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,
)

Nastala pokritost spada v štiri družine. Nominalni primeri preverjajo veljavne naslove. Robni primeri potisnejo format do meja z dolgimi domenami ali dovoljenimi posebnimi znaki. Primeri napak pokrivajo neveljavne formate, prazne nize in None. Nazadnje regresijski testi ponovno obdelajo tisto, kar se je pokvarilo drugje: poddomene in nedavne domene najvišje ravni (TLD). Te teste vedno pregledaj, preden jih potrdiš – test, generiran iz hroščaste kode, zvesto dokumentira hrošča.

Povzetek primerov uporabe

Primer uporabeKončna točkaTemperaturaNajveč žetonov
Dopolnjevanje v IDEFIM050–100
Generiranje funkcijKlepet (Chat)0,2500–1500
Docstringi / KomentarjiKlepet (Chat)0300–500
Enotski testiKlepet (Chat)0,1800–1500
RefaktoriranjeKlepet (Chat)01000–2000
Pretvorba jezikaKlepet (Chat)01000–2000

Ključne ugotovitve

  • Dopolnjevanje v IDE uporablja FIM s parametri, optimiziranimi za zakasnitev.
  • Generiranje celotne kode uporablja končno točko klepeta s strukturiranim pozivom.
  • Codestral generira docstringe in komentarje profesionalne kakovosti.
  • Generiranje testov samodejno pokrije robne primere in scenarije napak.
  • Vsak primer uporabe ima optimalne nastavitve temperature in števila žetonov.