Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Fill-In-The-Middle (FIM)

Nodarbība 2 no 14 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Fill-In-The-Middle princips
  2. /v1/fim/completions galapunkts
  3. Konkrēts piemērs: Python klases pabeigšana
  4. FIM pret tērzēšanu: pareizā rīka izvēle
  5. Maksimāla FIM izmantošana
  6. Galvenās atziņas

Fill-In-The-Middle princips

Fill-In-The-Middle jeb FIM ir Codestral izcilākā spēja. Standarta ģenerēšanā modelis turpina tekstu no sākumpunkta, neņemot vērā neko citu. FIM maina situāciju: tas ļauj tev aizpildīt tukšumu koda vidū. Tu nodrošini sākumu, ko sauc par uzdevumu (prompt), un beigas, ko sauc par piedekli (suffix), un Codestral ģenerē starpposma kodu, kas abus loģiski savieno.

Šis mehānisms atrisina ļoti konkrētu IDE automātiskās pabeigšanas problēmu. Rakstot faila vidū, atbilstošs ieteikums ir atkarīgs tikpat daudz no tā, kas seko aiz kursora, cik no tā, kas tam priekšā. Metodei, kas ievietota starp divām citām, ir jāievēro to stils, nosaukumu konvencijas un klases netiešais līgums. Modelis, kas redz tikai iepriekšējo kontekstu, piedāvā ticamu kodu, kas bieži vien dublē to, kas jau eksistē desmit rindiņas tālāk.

Darbība reducējas uz trim elementiem. Uzdevums satur kodu pirms ievietošanas vietas — citiem vārdiem, to, ko jau esi uzrakstījis pirms kursora. Piedeklis satur kodu aiz kursora. Pabeigums ir fragments, ko ģenerē Codestral un kas ievietojas starp abiem. Galīgais rezultāts vienmēr atbilst vienādojumam: uzdevums + pabeigums + piedeklis = pilns kods.

/v1/fim/completions galapunkts

Mistral AI piedāvā FIM, izmantojot specializētu galapunktu. Atšķirībā no standarta tērzēšanas galapunkta, šis pieņem parametrus prompt un suffix, nevis ziņojumu masīvu.

Pieprasījuma struktūra

from mistralai.client import Mistral

client = Mistral(api_key="your_api_key")

response = client.fim.complete(
    model="codestral-latest",
    prompt="def fibonacci(n: int):",
    suffix="n = int(input('Enter a number: '))\nprint(fibonacci(n))",
    temperature=0,
)

print(response.choices[0].message.content)

Šeit Codestral saņem fibonacci funkcijas signatūru kā uzdevumu un izsaukuma kodu kā piedekli. Tā uzdevums ir ģenerēt ķermeni, kas pārvērš šo signatūru darbīgā implementācijā, zinot, ka funkcija tiks izsaukta ar veselu skaitli, kas ievadīts no tastatūras, un tās atgrieztā vērtība tiks izdrukāta tāda, kāda tā ir.

Galvenie parametri

  • model — FIM vienmēr izmanto "codestral-latest"
  • prompt — kods pirms kursora (obligāts)
  • suffix — kods aiz kursora (neobligāts, bet ieteicams)
  • temperature — 0 determinētiem rezultātiem, 0.2-0.7 variācijām
  • max_tokens — ierobežo ģenerētā pabeiguma garumu
  • stop — apturēšanas tokeni (piemēram, ["\n\n"], lai apturētu pēc bloka)

Konkrēts piemērs: Python klases pabeigšana

Aplūkosim biežu scenāriju: raksti servisi un klases vidū trūkst metodes.

prompt = """class UserService:
    def __init__(self, db):
        self.db = db

    def get_user(self, user_id: int):
"""

suffix = """
    def delete_user(self, user_id: int):
        return self.db.execute("DELETE FROM users WHERE id = ?", (user_id,))
"""

response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    temperature=0,
    max_tokens=200,
)

Piedeklis uzņemas visu smago darbu attiecībā uz kontekstu. Redzot delete_user, Codestral uzzina trīs lietas: klase veic vaicājumus datubāzei, izmantojot self.db.execute, tā izmanto parametrizētus vaicājumus ar ? un atgriež rezultātu tieši bez starpslāņa. Tas secina, ka get_user ir jāievēro tieši tāds pats raksts, un ģenerē:

        return self.db.execute("SELECT * FROM users WHERE id = ?", (user_id,))

Mēģini veikt uzdevumu vēlreiz bez piedekļa, un tu redzēsi atšķirību. Bez šī enkura modelis bieži izgudros ORM vai kursoru, kas tavā projektā neeksistē nekur.

FIM pret tērzēšanu: pareizā rīka izvēle

SituācijaGalapunktsKāpēc
Automātiskā pabeigšana IDEFIMPieejams konteksts gan pirms, gan aiz kursora
Pilnas funkcijas ģenerēšanaTērzēšanaPiedeklis nav nepieciešams
Konfigurācijas faila pabeigšanaFIMEsošais formāts un struktūra virza pabeigumu
Koda skaidrošanaTērzēšanaDabiskās valodas uzdevums, nevis pabeigšana
Vienības testu rakstīšanaTērzēšana vai FIMFIM, ja testa fails jau daļēji eksistē

Maksimāla FIM izmantošana

Pabeiguma kvalitāte vispirms ir atkarīga no tā, kādu kontekstu tu nodrošini. Iekļauj uzdevumā importus, vecāklasi un blakus esošās funkcijas. Tie norāda modelim, kuras bibliotēkas ir pieejamas un kādu stilu pieņemt. Piedeklis ir pelnījis īpašu uzmanību, jo bez tā FIM degradējas līdz standarta ģenerēšanai un zaudē savu vērtību.

Attiecībā uz iestatījumiem, IDE automātiskā pabeigšana vislabāk darbojas pie temperature=0, lai vienāda situācija vienmēr radītu vienu un to pašu ieteikumu. Izstrādātājs, kurš redz, ka piedāvājums mainās ar katru taustiņsitieniem, galu galā to atspējos. Uzturi max_tokens zemu, robežās no 50 līdz 200, jo tu pabeidz rindiņu vai bloku, nevis visu moduli. Visbeidzot, apturēšanas tokeni novērš pārpildi: stop=["\n\n"] pārtrauc ģenerēšanu pie pašreizējā bloka beigām, nevis ļauj modelim pārrakstīt pusi faila.

Galvenās atziņas

  • FIM pabeidz kodu starp uzdevumu (pirms) un piedekli (pēc)
  • Specializētais galapunkts ir /v1/fim/completions
  • Rezultāts ir: uzdevums + pabeigums + piedeklis = pilns kods
  • Piedeklis ir būtisks augstas kvalitātes kontekstuālai pabeigšanai
  • IDE automātiskajai pabeigšanai izmanto temperature=0 un tokena ierobežojumus