Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Pajpijiet tal-Kodiċi Awtomatizzati

Lezzjoni 12 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Awtomatizzazzjoni tal-Iżvilupp b’Codestral u Mudell għal Skop Ġenerali
  2. Arkitettura ta’ Pajp tal-Kodiċi
  3. Pass 1: Tiftix tal-Kodiċi b’Codestral Embed
  4. Pass 2: Ġenerazzjoni tal-Kodiċi b’Codestral
  5. Pass 3: Reviżjoni tal-Kodiċi b’Mistral Small 4
  6. Pajp Sħiħ: Mit-Ticket sal-PR
  7. Integrazzjoni CI/CD
  8. Varjazzjonijiet Komuni tal-Produzzjoni
  9. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru, 2026. Il-pass tar-reviżjoni qabel kien jiddependi fuq Devstral, li tneħħa mill-API fil-31 ta’ Lulju, 2026. Issa juża Mistral Small 4 (mistral-small-2603). Sors: Mudelli.

Awtomatizzazzjoni tal-Iżvilupp b’Codestral u Mudell għal Skop Ġenerali

S’issa, introduċejna kull għodda ta’ Mistral AI individwalment, topera quddiem utent uman. Il-valur veru tagħhom joħroġ meta tgħaqqadhom flimkien. Codestral Embed, Codestral, u mudell għal skop ġenerali bħal Mistral Small 4 jiffurmaw pajp ta’ żvilupp awtomatizzat kapaċi jfittex, jiġġenera, u jirrevedi l-kodiċi mingħajr intervent manwali f’kull pass.

Arkitettura ta’ Pajp tal-Kodiċi

Pajp sħiħ jinqasam f’tliet stadji, kull wieħed assenjat lill-mudell li jeċċella f’dak il-kompitu speċifiku.

  1. Tiftix tal-Kodiċi — Sib kodiċi rilevanti fil-bażi tal-kodiċi (Codestral Embed)
  2. Ġenerazzjoni tal-Kodiċi — Iġġenera jew immodifika l-kodiċi (Codestral)
  3. Reviżjoni tal-Kodiċi — Ivverifika u vvalida l-bidliet (Mistral Small 4)

Aqra l-fluss tad-data minn fuq għal isfel; kull blokk jikkonsma l-output ta’ dak ta’ qablu.

User Request
    |
[Codestral Embed] -> Relevant Files
    |
[Codestral] -> Generated/Modified Code
    |
[Mistral Small 4] -> Automated Review
    |
Pull Request / Commit

Pass 1: Tiftix tal-Kodiċi b’Codestral Embed

Il-ġenerazzjoni tal-kodiċi mingħajr għarfien tal-bażi tal-kodiċi eżistenti tipproduċi riżultati li ma jixbħu xejn lill-bqija tal-proġett. Għalhekk, l-ewwel pass huwa li ssib il-fajls rilevanti bl-użu tal-indiċi tal-embedding mibni fil-lezzjoni preċedenti. Il-funzjoni hawn taħt tikkonverti d-deskrizzjoni tal-kompitu f’vettur, tqabblu ma’ kull fajl indikat, u tirritorna l-ħames korrispondenzi l-eqreb.

from mistralai.client import Mistral
import numpy as np

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

def search_context(task_description: str, codebase_index: list) -> list:
    """Finds relevant files for a given task."""
    response = client.embeddings.create(
        model="codestral-embed-latest",
        inputs=[task_description],
    )
    vector = np.array(response.data[0].embedding)

    scores = []
    for file in codebase_index:
        file_vec = np.array(file["embedding"])
        score = np.dot(vector, file_vec) / (
            np.linalg.norm(vector) * np.linalg.norm(file_vec)
        )
        scores.append((file, score))

    scores.sort(key=lambda x: x[1], reverse=True)
    return [f for f, s in scores[:5]]

Pass 2: Ġenerazzjoni tal-Kodiċi b’Codestral

Ladarba jkollok il-kuntest, Codestral jista’ jiġġenera l-kodiċi. Il-kwalità tal-output tiddependi fuq kif tippreżenta dak il-kuntest: ikkatenja l-fajls miksuba fil-messaġġ tas-sistema, akkumpanjati minn istruzzjoni espliċita biex tirrispetta l-konvenzjonijiet eżistenti. Is-setting temperature=0.1 iżomm l-output qrib id-determiniżmu, li huwa mixtieq meta l-kodiċi ġġenerat irid jintegra ruħu b’mod seamless fil-proġett minflok ma jissurpriża lill-awtur tiegħu.

def generate_code(task: str, context: list[dict]) -> str:
    """Generates code taking existing context into account."""
    context_files = "\n\n---\n\n".join([
        f"# {f['path']}\n{f['content']}"
        for f in context
    ])

    response = client.chat.complete(
        model="codestral-latest",
        messages=[
            {
                "role": "system",
                "content": f"""You are a senior developer. Here is the existing project code:

{context_files}

Respect existing code conventions (naming, style, patterns)."""
            },
            {
                "role": "user",
                "content": task
            }
        ],
        temperature=0.1,
        max_tokens=2000,
    )

    return response.choices[0].message.content

Pass 3: Reviżjoni tal-Kodiċi b’Mistral Small 4

Il-kontroll jiġi l-aħħar. Mistral Small 4 jirċievi l-istat ta’ qabel, l-istat ta’ wara, u d-deskrizzjoni tal-kompitu, imbagħad jagħti l-verdett tiegħu f’format JSON strett. Din l-għażla hija kritika: reviżjonijiet b’proża libera mhumiex użabbli mill-kodiċi downstream, filwaqt li qasam boolean approved jippermettilek tawtomatizza l-passi li jmiss. Il-kategoriji mitluba jisseparaw deliberatament kwistjonijiet li jimblokkaw, suġġerimenti għat-titjib, u tħassib dwar is-sigurtà, peress li dawn jeħtieġu trattament differenti.

def review_code(original_code: str, modified_code: str, description: str) -> dict:
    """Automated code review."""
    response = client.chat.complete(
        model="mistral-small-2603",
        messages=[
            {
                "role": "system",
                "content": """You are a senior code reviewer. Analyze the diff and return JSON:
{
    "approved": true/false,
    "issues": ["list of found issues"],
    "suggestions": ["list of possible improvements"],
    "security": ["potential security issues"]
}"""
            },
            {
                "role": "user",
                "content": f"Task: {description}\n\nOriginal code:\n{original_code}\n\nModified code:\n{modified_code}"
            }
        ],
        temperature=0,
    )

    return response.choices[0].message.content

Pajp Sħiħ: Mit-Ticket sal-PR

Issa tista’ tgħaqqad dawn it-tliet funzjonijiet f’katina waħda li tibda b’ticket u toħroġ kodiċi rrevedut. Żomm id-dikjarazzjonijiet print interkalati: f’pajp awtomatizzat, ir-reġistrazzjoni (logging) ta’ x’instab, x’inħoloq, u x’ġie rrevedut hija l-unika mod tiegħek biex tifhem aktar tard għaliex riżultat ħallek deluż.

def ticket_to_code_pipeline(ticket: str, codebase_index: list) -> dict:
    """Complete pipeline: ticket -> code -> review."""

    # 1. Contextual search
    relevant_files = search_context(ticket, codebase_index)
    print(f"Files found: {[f['path'] for f in relevant_files]}")

    # 2. Code generation
    generated_code = generate_code(ticket, relevant_files)
    print(f"Generated code: {len(generated_code)} characters")

    # 3. Automated review
    review = review_code(
        original_code=relevant_files[0]["content"],
        modified_code=generated_code,
        description=ticket,
    )
    print(f"Review: {review}")

    return {
        "ticket": ticket,
        "modified_files": relevant_files,
        "code": generated_code,
        "review": review,
    }

Integrazzjoni CI/CD

Dan il-mekkaniżmu jilħaq il-potenzjal sħiħ tiegħu meta jkun konness mal-CI tiegħek. Workflow ta’ GitHub Actions attivat fuq kull pull request miftuħ u aġġornat huwa biżżejjed biex iħaddem ir-reviżjoni fuq kull bidla proposta, mingħajr ebda ħsieb uman meħtieġ.

name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run AI Review
        env:
          MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
        run: |
          python scripts/ai_review.py --pr ${{ github.event.pull_request.number }}

L-iskript imsejjaħ jirkupra d-diff, jgħaddi kull fajl immodifikat lil review_code, u jikkummenta fuq il-PR biss meta r-reviżjoni ma tapprovax. Din il-kundizzjoni hija essenzjali: bot li jikkummenta fuq kollox isir storbju li t-tim jitgħallem jinjora fi żmien jiem.

# scripts/ai_review.py
def review_pull_request(pr_number: int):
    """Automated PR review with Mistral Small 4."""
    # 1. Retrieve PR diff
    diff = get_pr_diff(pr_number)

    # 2. Analyze each modified file
    for file in diff.files:
        review = review_code(
            original_code=file.before,
            modified_code=file.after,
            description=diff.title,
        )

        # 3. Post comment on PR
        if not review["approved"]:
            post_pr_comment(pr_number, file.path, review)

Varjazzjonijiet Komuni tal-Produzzjoni

It-timijiet li jadottaw dan il-mudell jadattawh għal diversi każijiet ta’ użu rikorrenti. L-ewwel, il-ġenerazzjoni awtomatika tat-testijiet: għal kull fajl ġdid, il-pajp jipproduċi testijiet korrispondenti, iċaqlaq il-kompitu nojjuż mingħajr ma jelimina r-reviżjoni. Imbagħad, id-dokumentazzjoni kontinwa, fejn id-docstrings jiġu ġġenerati u aġġornati ma’ kull commit minflok waqt awditu. Sussegwentement, id-detezzjoni tar-regressjoni, fejn il-mudell tar-reviżjoni janalizza d-diffs għal effetti sekondarji probabbli. Fl-aħħar nett, il-migrazzjoni tal-kodiċi, li tawtomatizza l-konverżjoni bejn frameworks jew verżjonijiet—dan huwa fejn il-ħin iffrankat huwa l-aktar sinifikanti, għax it-trasformazzjoni hija ripetittiva u r-riżultat huwa verifikabbli permezz ta’ testijiet eżistenti.

Avviża waħda tapplika għar-raba’ kollha: ir-reviżjoni awtomatizzata ma tissostitwixxix ir-reviżjoni umana. Hija taqbad żbalji mekkaniċi u tħalli l-ġudizzju dwar x’inhu verament importanti lill-iżviluppaturi tiegħek.

Punti Ewlenin

  • Pajp tal-kodiċi bl-AI jgħaqqad it-tiftix (Embed), il-ġenerazzjoni (Codestral), u r-reviżjoni (Mistral Small 4)
  • Codestral Embed isib il-kuntest, Codestral jiġġenera, u mudell għal skop ġenerali jivverifika
  • L-integrazzjoni CI/CD tippermetti reviżjonijiet awtomatizzati u ġenerazzjoni tat-testijiet
  • Il-mudell tiftix -> iġġenera -> irrevedi japplika għal ħafna flussi ta’ ħidma
  • Ir-reviżjoni awtomatizzata ma tissostitwixxix ir-reviżjoni umana; hija tissupplimentaha