Codestralin käyttötapaukset
Tällä sivulla
Codestralin käytön neljä peruspilaria
Codestralin pelkistäminen yksinkertaiseksi automaattiseksi täydennystyökaluksi jättää huomiotta puolet sen arvosta. Sen kyvyt kattavat neljä ohjelmistokehityksen keskeistä aluetta: IDE:n automaattinen täydennys, koodin generointi, automaattinen dokumentointi ja testien tuottaminen. Jokainen alue vaatii omat asetuksensa. Näiden välinen selkeä erottelu estää pettymyksiltä, joita aiheuttaa “saman kehotteen käyttäminen kaikkeen”.
Reaaliaikainen IDE-automaattitäydennys
Tämä on mallin luontevin käyttötapaus ja se, joka hyödyntää parhaiten Fill-in-the-Middle (FIM) -tekniikkaa. Skenaario on aina sama: kirjoitat VS Codessa tai JetBrainsin IDE:ssä, laajennus kuten Continue.dev tai Tabnine havaitsee tauon kirjoittamisessasi, lähettää FIM-pyynnön, joka sisältää tiedoston kontekstin, vastaanottaa ehdotuksen alle 500 ms:ssä, ja hyväksyt sen Tab-näppäimellä tai hylkäät Esc-näppäimellä. Koko haaste piilee tuossa 500 ms:n budjetissa: sen ylittyessä ehdotus saapuu sen jälkeen, kun olet jo kirjoittanut rivin itse, jolloin avusta tulee haitta.
Ensisijainen vipu on lähetetyn kontekstin koko. Mitä enemmän tarjoat, sitä parempi on osuvuus, mutta sitä hitaampi on vaste.
# 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 "],
)
Käytännössä 2 000 merkkiä kehotteelle ja 500 merkkiä suffiksille tarjoavat erinomaisen laatu-nopeus-suhteen. Huomaa epäsymmetria: säilytämme viimeiset merkit ennen kursoria ja ensimmäiset merkit sen jälkeen, koska osuvuus heikkenee siirryttäessä kauemmaksi lisäyskohdasta.
Koko koodin generointi
Kun tarvitset kokonaisen funktion, luokan tai moduulin, chat-päätepisteestä tulee sopivampi. Tuloksen laatu riippuu tällöin suoraan pyyntösi tarkkuudesta: eksplisiittinen määrittely, jossa on lueteltu tekniset rajoitukset, tuottaa käyttökelpoista koodia; epämääräinen pyyntö tuottaa rungon, joka on kirjoitettava kokonaan uudelleen.
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,
)
Tämä työnkulku loistaa neljässä skenaariossa: uuden tiedoston tai tyhjän moduulin aloittaminen, luonnollisella kielellä kuvatun monimutkaisen algoritmin toteuttaminen, API:n tai palvelun nopea prototyyppaus sen rakenteen testaamiseksi sekä pseudokoodin muuntaminen toimivaksi koodiksi. Yhteinen nimittäjä on olemassa olevan koodin puuttuminen, jota pitäisi noudattaa. Heti kun kyseessä on olemassa oleva koodi, FIM muuttuu jälleen edullisemmaksi vaihtoehdoksi.
Automaattinen dokumentointi
Dokumentointi on tehtävä, jonka tiimit lykkäävät huomiselle, mutta Codestral hoitaa sen sekunneissa. Ota esimerkiksi dokumentoimaton funktio, jossa on neljä parametria ja ehdollista käyttäytymistä otsikossa:
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,
)
Generoitu docstring kuvaa jokaisen parametrin, sen oletusarvon ja palautetun rakenteen. Sama mekanismi, eri ohjeella, lisää kommentteja riveille, jotka niitä ansaitsevat – tässä tapauksessa else-haaraan, joka luo keinotekoisia sarakkeiden nimiä, mikä saattaa yllättää seuraavan lukijan.
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,
)
Pidä temperature=0 molemmissa tehtävissä: dokumentoit olemassa olevaa, et keksi mitään uutta.
Yksikkötestien generointi
Codestral generoi testejä lähdekoodista, ja usein juuri tässä se säästää eniten aikaa, koska reunatapaukset ovat juuri niitä, jotka kiireinen kehittäjä unohtaa.
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,
)
Saatu kattavuus jakautuu neljään perheeseen. Nimitapaukset varmistavat kelvolliset osoitteet. Reunatapaukset venyttävät muotoilua äärirajoille pitkillä verkkotunnuksilla tai sallituilla erikoismerkeillä. Virhetapaukset kattavat virheelliset muodot, tyhjät merkkijonot ja None:n. Lopuksi regressiotapaukset palaavat siihen, mikä on rikki muualla: aliverkkotunnuksiin ja uusiin yläpäätetunnuksiin. Tarkista nämä testit aina ennen niiden commitoimista – bugisesta koodista generoitu testi dokumentoi virheen uskollisesti.
Käyttötapausten yhteenveto
| Käyttötapaus | Päätepiste | Lämpötila | Max Tokenit |
|---|---|---|---|
| IDE-automaattitäydennys | FIM | 0 | 50–100 |
| Funktion generointi | Chat | 0.2 | 500–1500 |
| Docstringit / Kommentit | Chat | 0 | 300–500 |
| Yksikkötestit | Chat | 0.1 | 800–1500 |
| Refaktorointi | Chat | 0 | 1000–2000 |
| Kielen muunnos | Chat | 0 | 1000–2000 |
Keskeiset asiat
- IDE-automaattitäydennys käyttää FIM:ää parametreilla, jotka on optimoitu viiveelle
- Koko koodin generointi käyttää chat-päätepistettä jäsennellyllä kehotteella
- Codestral generoi ammattimaisia docstringejä ja kommentteja
- Testien generointi kattaa automaattisesti reunatapaukset ja virheskenaariot
- Jokaisella käyttötapauksella on optimaaliset lämpötila- ja tokeniasetukset