Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Codestrali kasutusjuhtumid

Õppetund 4 / 14 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Codestrali kasutamise neli sammast
  2. Reaalajas IDE automaattäitmine
  3. Täielik koodi genereerimine
  4. Automaatne dokumenteerimine
  5. Ühiktestide genereerimine
  6. Kasutusjuhtumite kokkuvõte
  7. Peamised punktid

Codestrali kasutamise neli sammast

Codestrali taandamine lihtsaks automaattäitmise tööriistaks jätab kasutamata pool selle väärtusest. Selle võimed hõlmavad nelja tarkvaraarenduse põhivaldkonda: IDE automaattäitmine, koodi genereerimine, automaatne dokumenteerimine ja testide loomine. Iga valdkond nõuab spetsiifilisi seadeid. Nende selge eristamine hoiab ära pettumust valmistavad tulemused, mis tekivad „ühe ja sama vihje kasutamisel kõige jaoks“.

Reaalajas IDE automaattäitmine

See on mudeli loomulikuim kasutusjuhtum ja see, mis kasutab kõige paremini ära Fill-in-the-Middle (FIM) meetodit. Stsenaarium on alati sama: kirjutad VS Code’is või JetBrainsi IDE-s, laiendus nagu Continue.dev või Tabnine tuvastab trükkimises pausi, saadab FIM-päringu, mis sisaldab faili konteksti, saab vastuse alla 500 ms ja sa kinnitad ettepaneku klahviga Tab või lükkad selle tagasi klahviga Esc. Kogu väljakutse peitub selles 500 ms eelarves: kui see ületatakse, saabub ettepanek alles siis, kui oled rea juba käsitsi tippinud, muutes abi tüütuseks.

Peamine hoob on saadetava konteksti suurus. Mida rohkem sa annad, seda parem on asjakohasus, kuid seda aeglasem on vastus.

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

Praktikas pakuvad 2000 märki vihje jaoks ja 500 märki sufiksi jaoks suurepärast kvaliteedi ja kiiruse suhet. Pane tähele asümmeetriat: hoiame alles viimased märgid enne kursorit ja esimesed märgid pärast seda, sest asjakohasus väheneb, kui eemaldud sisestuspunktist.

Täielik koodi genereerimine

Kui vajad tervet funktsiooni, klassi või moodulit, sobib vestluse lõpppunkt (chat endpoint) paremini. Tulemuse kvaliteet sõltub siis otseselt sinu päringu täpsusest: selge spetsifikatsioon loetletud tehniliste piirangutega toodab kasutatavat koodi; ebamäärane päring toodab skeleti, mille pead täielikult ümber kirjutama.

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

See töövoog hiilgab neljas stsenaariumis: uue faili või tühja mooduli alustamine, loomulikus keeles kirjeldatud keeruka algoritmi rakendamine, API või teenuse kiire prototüüpimine selle kuju testimiseks ja pseudokoodi teisendamine funktsionaalseks koodiks. Ühine nimetaja on olemasoleva koodi puudumine, mida austada. Niipea kui mängu tuleb olemasolev kood, muutub FIM uuesti eelistatuks.

Automaatne dokumenteerimine

Dokumenteerimine on ülesanne, mille meeskonnad lükkavad homseks, ometi saab Codestral sellega hakkama sekunditega. Võta dokumenteerimata funktsioon nelja parameetri ja tingimusliku käitumisega päises:

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

Genereeritud docstring kirjeldab iga parameetrit, selle vaikeväärtust ja tagastatud struktuuri. Sama mehhanism lisab erineva juhendiga kommentaare ridadele, mis seda väärivad – siin else haru, mis loob kunstlikud veergude nimed, mis võib järgmist lugejat üllatada.

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

Hoid mõlema ülesande puhul temperature=0: sa dokumenteerid seda, mis on olemas, mitte ei leiuta midagi uut.

Ühiktestide genereerimine

Codestral genereerib teste lähtekoodi põhjal ja just siin säästab see sageli kõige rohkem aega, sest äärijuhtumid on täpselt need, mida kiirustav arendaja unustab.

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

Saadud katvus jaguneb nelja perekonda. Nominaalsed juhtumid kontrollivad kehtivaid aadresse. Äärijuhtumid viivad vormingu piirideni pikkade domeenide või lubatud erimärkidega. Veajuhtumid katavad vigased vormingud, tühjad stringid ja None. Lõpuks taaskasutavad regressioonijuhtumid seda, mis on mujal katki läinud: alamdomeenid ja hiljutised üladomeenid (TLD). Vaata need testid alati enne kinnitamist üle – vigasest koodist genereeritud test dokumenteerib vea ustavalt.

Kasutusjuhtumite kokkuvõte

KasutusjuhtumLõpppunktTemperatuurMax Tokens
IDE automaattäitmineFIM050-100
Funktsiooni genereerimineChat0.2500-1500
Docstringid / KommentaaridChat0300-500
ÜhiktestidChat0.1800-1500
RefaktoreerimineChat01000-2000
Keele teisendamineChat01000-2000

Peamised punktid

  • IDE automaattäitmine kasutab FIM-i parameetritega, mis on optimeeritud latentsuse jaoks
  • Täielik koodi genereerimine kasutab vestluse lõpppunkti struktureeritud vihjega
  • Codestral genereerib professionaalse kvaliteediga docstringe ja kommentaare
  • Testide genereerimine katab automaatselt äärijuhtumid ja veastsenaariumid
  • Igal kasutusjuhtumil on optimaalsed temperatuuri ja tokenite seaded