Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Gníomhairí Cóid sa Chleachtas: API, Vibe Code CLI, agus Vibe Code Web

Ceacht 8 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Trí bhealach chun gníomhaire a chur ag obair
  2. Tríd an Mistral API
  3. Tríd an Vibe Code go logánta: an CLI agus breiseán VS Code
  4. Tríd an Vibe Code Web
  5. Comparáid idir na trí bhealach
  6. Cad a dhéanann an difríocht sa chleachtas
  7. Príomhphointí

An ceacht athscríofa an 2 Samhain, 2026. Ós rud é gur baineadh Devstral den API an 31 Iúil, 2026, úsáideann na samplaí API anseo Mistral Small 4. Léiríonn an chuid Vibe an doiciméadú reatha Vibe Code: suiteáil, an tsamhail ionsuite (Mistral Medium 3.5), agus na trí dhromchla—CLI, breiseán VS Code, agus Vibe Code Web. Foinse: Suiteáil agus socruithe · Roghnaigh CLI, VS Code, nó seisiúin ghréasáin · Cumraíocht.

Trí bhealach chun gníomhaire a chur ag obair

Níl maitheas i samhail ghníomhach ach amháin de réir mar a nascann tú í le fíor-obair. Tairgeann Mistral trí bhealach: an API, áit a dtógann tú do ghníomhaire féin; Vibe Code go logánta, i do theirminéal nó in VS Code; agus Vibe Code Web, a ritheann an gníomhaire i ngaineamhlach cianda i gcoinne stór GitHub. Freagraíonn gach ceann do chuid éagsúla de lá an fhorbróra.

Tríd an Mistral API

Is é an API an comhéadan is solúbtha: ligeann sé duit do shreafaí oibre gníomhacha féin a thógáil le do chuid uirlisí agus loighic rialaithe féin. Tosaigh leis an gcás is simplí, glao comhrá gan uirlisí. Anseo, cuirimid feidhm fíordheimhnithe atá leochaileach faoi bhráid Mistral Small 4 agus iarraimid diagnóis. Níl temperature=0 maisiúil: le haghaidh anailíse slándála, ba mhaith leat torthaí in-atáirgthe, ní athrú ó rith amháin go dtí an chéad cheann eile.

from mistralai.client import Mistral
import os

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

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "system",
            "content": "You are an expert development agent. Analyze the provided code and propose improvements."
        },
        {
            "role": "user",
            "content": """Here is a Python file that handles authentication.
Identify security issues and propose fixes:

def login(username, password):
    query = f"SELECT * FROM users WHERE username='{username}' AND password='{password}'"
    user = db.execute(query).fetchone()
    if user:
        session['user_id'] = user['id']
        return True
    return False
"""
        }
    ],
    temperature=0,
    max_tokens=2000,
)

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

Athraíonn mód gníomhach nádúr an mhalairt. In ionad téacs a fháil, dearann tú uirlisí is féidir leis an tsamhail a iarraidh a ghlaow, agus filleann an tsamhail tool_calls—ainm uirlise agus a hargóintí. Is iad na trí uirlis thíos bunús íosta gníomhaire cóid: comhad a léamh, comhad a scríobh, ordú a rith. Leo seo, déantar an treoir “cuir leideanna cineáil le gach comhad in src/utils/” in-inghníomhaithe, cé go mbeadh sé ina mholadh amháin i mód comhrá.

tools = [
    {
        "type": "function",
        "function": {
            "name": "read_file",
            "description": "Read the contents of a source file",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {
                        "type": "string",
                        "description": "Relative path to the file"
                    }
                },
                "required": ["path"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "write_file",
            "description": "Write content to a file",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {"type": "string"},
                    "content": {"type": "string"}
                },
                "required": ["path", "content"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "run_command",
            "description": "Execute a shell command",
            "parameters": {
                "type": "object",
                "properties": {
                    "command": {"type": "string"}
                },
                "required": ["command"]
            }
        }
    }
]

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "user",
            "content": "Explore the project and add Python type hints to all files in the src/utils/ directory"
        }
    ],
    tools=tools,
    tool_choice="auto",
)

# Process the tool calls returned by the model
for tool_call in response.choices[0].message.tool_calls:
    print(f"Tool: {tool_call.function.name}")
    print(f"Arguments: {tool_call.function.arguments}")

Tabhair faoi deara nach ndéantar aon rud a fhorghníomhú leis féin: tá an lúb—glaoigh an uirlis, fill an t-aschur chuig an tsamhail, iarr an chéad chéim eile—faoi do dhílseacht go hiomlán. Sin praghas na solúbthachta, agus is díreach é sin a láimhseálann an Vibe CLI duit.

Tríd an Vibe Code go logánta: an CLI agus breiseán VS Code

Is é Vibe Code an mód “cóid” de Vibe, gníomhaire Mistral. Go logánta, tagann sé i dhá fhoirm a roinneann an t-inneall, an chumraíocht, agus stair an tseisiúin céanna: an CLI, i do theirminéal, agus an breiseán VS Code, a chuireann comhthéacs an eagarthóra leis (comhad gníomhach, roghnú, difríochtaí). Tógann suiteáil an CLI líne amháin ar macOS agus Linux:

# Official installer (installs uv if needed, then the mistral-vibe package)
curl -LsSf https://mistral.ai/vibe/install.sh | bash

# Or manual installation
uv tool install mistral-vibe

Ansin, téigh chuig do thionscadal agus rith vibe. Ar an gcéad seoladh, spreagann draoi tú chun síniú isteach le do chuntas Mistral (tá Vibe Code san áireamh i bpleananna, le teorainneacha úsáide ag brath ar an bplean) nó chun eochair API a chur isteach. Ansin, labhraíonn tú leis an ngníomhaire mar chomhghleacaí a bhfuil a lámha ar an méarchlár:

Explain this project's architecture.
Add an API route /health that returns the server status, along with its test.
Run the test suite and fix what fails.

Soláthraíonn Vibe na huirlisí féin (léamh/scríobh comhad, orduithe blaoisce) agus an lúb ghníomhach a chaithfeá a scríobh de láimh leis an API. Tagann sé le samhail ionsuite, Mistral Medium 3.5, agus ligeann an t-ordú /model duit ceann eile a roghnú as cinn atá cumraithe (Small 4, Codestral, samhail logánta…). Téann athruithe agus orduithe trí chóras formheasa a chumraíonn tú in aghaidh an ghníomhaire: déan athbhreithniú air sula mbíonn muinín agat as stór tábhachtach. Le haghaidh uathoibriú, ritheann vibe --prompt feidhmiú neamh-idirghníomhach, atá úsáideach in chomhtháthú leanúnach.

Tríd an Vibe Code Web

Is é Vibe Code Web an tríú dromchla: cócaireacht do ghníomhairí cianda. Cruthaíonn tú tionscadal ó stór GitHub amháin nó níos mó faoin úinéir céanna, tosaíonn tú seisiún le treoir bheacht, agus oibríonn an gníomhaire i ngaineamhlach a bhainistítear sa scamall: déanann sé clónáil, pleanáil, modhnú, orduithe agus tástálacha a rith, ansin ullmhaíonn sé brainse nó iarratas tarraingthe duit chun athbhreithniú a dhéanamh air i GitHub. Ní gá cóip logánta, agus is féidir le do mheaisín fanacht dúnta agus an gníomhaire ag obair. Ón CLI, aistríonn an t-ordú /teleport seisiún atá ar siúl go dtí an gréasán.

Roghnaigh an CLI nó an breiseán nuair a bhraitheann an tasc ar chomhaid, seirbhísí, nó rúin atá i láthair ar do mheaisín amháin.

Comparáid idir na trí bhealach

CritéarPython APIVibe Code (CLI, VS Code)Vibe Code Web
Lúb ghníomhachScríobhann tú éIonsuiteIonsuite
Rochtain ar chomhaidTríd do chuid uirlisíCóip oibre logántaGaineamhlach cianda, stór GitHub
SamhailAn ceann a ghlaonn túMedium 3.5 ionsuite, cinn eile roghnachInneall Vibe Code
Mód neamh-idirghníomhachTáTá (vibe --prompt, CLI amháin)Níl
Cás úsáidePíblínte, táirgí saincheapthaForbairt laethúilTascanna fadtréimhseacha ar stór cianda

Ag léamh ó dheas go clé, déanann an tábla seo cur síos ar ghrádán rialaithe: dá mhéad a bhogann tú i dtreo an API, is ea is mó a shocraíonn tú gach rud, lena n-áirítear an rud is féidir a bhriseadh.

Cad a dhéanann an difríocht sa chleachtas

Braitheann cáilíocht na dtorthaí níos lú ar an tsamhail ná ar an gcaoi a gcuireann tú d’iarratas in iúl. Fágann “Cuir bailíochtú leis” an gníomhaire chun an suíomh, an stíl, agus na rialacha a cheapadh; tugann “Cuir bailíochtú ríomhphoist leis in src/auth/validators.py ag baint úsáide as an bpatrún atá ann cheana” an comhad, an coinbhinsiún, agus an teorainn dó. Sa spiorad céanna, luaigh comhaid ábhartha agus srianta tionscadail go sainráite in ionad a bheith ag súil go dtuigfidh sé iad.

Fanann fíorú dodhéanta: is féidir le gníomhaire inniúil cúlú a thabhairt isteach fós, go háirithe agus ilchomhad á dteagmháil ag an am céanna. Déan cleachtas de athbhreithniú a dhéanamh ar an difríocht sula nglacann tú leis, díreach mar a dhéanfá d’iarratas tarraingthe ó fhostaí nua. Agus coinnigh an suíomh deiridh i gcuimhne: an uirlis cheart a roghnú. Úsáid Vibe Code go logánta le haghaidh forbartha laethúil, Vibe Code Web le haghaidh tascanna fadtréimhseacha ar stór cianda, agus an API do do phíblínte féin.

Príomhphointí

  • Tugann an API rialú iomlán: scríobhann tú na huirlisí agus an lúb ghníomhach
  • Suiteáiltear Vibe Code le curl -LsSf https://mistral.ai/vibe/install.sh | bash (nó uv tool install mistral-vibe) agus tagann sé le Mistral Medium 3.5
  • Roinneann an CLI agus breiseán VS Code cumraíocht agus seisiúin; úsáidtear vibe --prompt le haghaidh uathoibriú
  • Ritheann Vibe Code Web an gníomhaire i ngaineamhlach cianda agus táirgeann sé brainse agus iarratais tarraingthe
  • Fanann treoracha cruinne agus athbhreithniú difríochtaí riachtanach