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

Sainigh Feidhmeanna i bPython

Ceacht 4 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Ón Teoiric go dtí an Cód
  2. Suiteáil an SDK Mistral
  3. Feidhmeanna Python a Chruthú
  4. Sonruithe JSON a Scríobh
  5. Feidhmeanna a Eagrú i bhFoclóir
  6. An Rogha tool_choice
  7. Príomhphointí

Ón Teoiric go dtí an Cód

Tá an próiseas cúig chéime agus struchtúr an Scéama JSON tuigthe agat anois. Is é an t-am é chun fíorchód Python a scríobh. Sa cheacht seo, cruthóidh tú feidhmeanna, dréachtóidh tú a sonruithe, agus ullmhóidh tú gach rud don API Mistral—gach rud a chaithfidh a bheith ann sula ndéanfar an chéad ghlaon líonra.

Suiteáil an SDK Mistral

Tosaigh trí bhíthin an pacáiste oifigiúil a shuiteáil:

pip install mistralai

Ansin, cumraigh do eochair API. Molann dea-chleachtas gan é a chrua-chódú riamh i do chomhaid foinse. Ina ionad sin, léigh ó athróg timpeallachta é ionas gur féidir leat do chód a chur faoi rialú leagan go sábháilte.

export MISTRAL_API_KEY="your-api-key"
import os
from mistralai.client import Mistral

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

Feidhmeanna Python a Chruthú

Breathnaímis ar shampla oibre: córas rianaithe íocaíochta atá bunaithe ar DataFrame Pandas. Is sampla clasaiceach é seo ó dhoiciméadú Mistral, agus léiríonn sé an coincheap go foirfe—anseo, imríonn an DataFrame an ról a bheadh ag bunachar sonraí i dtimpeallacht táirgeachta.

import pandas as pd
import json

# Sonraí íocaíochta
data = {
    "transaction_id": ["T1001", "T1002", "T1003", "T1004", "T1005"],
    "customer_id": ["C001", "C002", "C003", "C002", "C001"],
    "payment_amount": [125.50, 89.99, 350.00, 45.00, 210.75],
    "payment_date": ["2026-03-15", "2026-03-16", "2026-03-17", "2026-03-17", "2026-03-18"],
    "payment_status": ["paid", "paid", "pending", "paid", "failed"]
}
df = pd.DataFrame(data)

Seo anois an cód a dhéanann rochtain ar na sonraí seo i ndáiríre. Is gnáthfheidhmeanna Python iad seo; níl aon rud ina gcur chun feidhme a thugann le fios go dtiomáinfidh LLM iad.

def retrieve_payment_status(df: pd.DataFrame, transaction_id: str) -> str:
    """Faigheann sé stádas íocaíochta de réir a aitheantais."""
    if transaction_id in df["transaction_id"].values:
        status = df[df["transaction_id"] == transaction_id]["payment_status"].values[0]
        return json.dumps({"status": status})
    return json.dumps({"error": f"Transaction {transaction_id} not found"})


def retrieve_payment_date(df: pd.DataFrame, transaction_id: str) -> str:
    """Faigheann sé dáta íocaíochta de réir a aitheantais."""
    if transaction_id in df["transaction_id"].values:
        date = df[df["transaction_id"] == transaction_id]["payment_date"].values[0]
        return json.dumps({"date": date})
    return json.dumps({"error": f"Transaction {transaction_id} not found"})

Tá dhá shonra cur chun feidhme ar chóir duit aird a thabhairt orthu. Ar an gcéad dul síos, filleann na feidhmeanna seo teaghrán JSON i gcónaí, ní réad Python amh riamh. Is é seo an formáid a bhfuil súil ag an tsamhail léi mar thoradh uirlise, mar sin tá json.dumps() éigeantach. Ar an dara dul síos, déileálann siad go sainráite leis an gcás nach bhfuil idirbheart le fáil in ionad eisceacht a ardú. Filleann an earráid seo, atá formáidithe mar JSON, chuig an tsamhail díreach mar aon toradh eile, rud a ligeann di an t-úsáideoir a chur ar an eolas go cúirtéiseach nach bhfuil an t-idirbheart T9999 ann. Feicfidh tú níos déanaí sa chúrsa cén fáth a bhfuil an freagairt seo riachtanach.

Sonruithe JSON a Scríobh

Teastaíonn sonrú ó gach feidhm ionas go dtuigfidh an tsamhail í. Anseo, cuirfidh tú an struchtúr ón gceacht roimhe seo i bhfeidhm ar an dá fheidhm thuas—tabhair faoi deara an comhfhreagras docht idir na réimsí name agus ainmneacha na bhfeidhmeanna Python iarbhír.

tools = [
    {
        "type": "function",
        "function": {
            "name": "retrieve_payment_status",
            "description": "Retrieves the status of a payment (paid, pending, failed) "
                           "based on the transaction ID.",
            "parameters": {
                "type": "object",
                "properties": {
                    "transaction_id": {
                        "type": "string",
                        "description": "Unique transaction identifier (e.g., T1001)"
                    }
                },
                "required": ["transaction_id"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "retrieve_payment_date",
            "description": "Retrieves the date a payment was made "
                           "based on the transaction ID.",
            "parameters": {
                "type": "object",
                "properties": {
                    "transaction_id": {
                        "type": "string",
                        "description": "Unique transaction identifier (e.g., T1001)"
                    }
                },
                "required": ["transaction_id"]
            }
        }
    }
]

Feidhmeanna a Eagrú i bhFoclóir

Filleann an tsamhail ainm feidhme mar theaghrán. Teastaíonn bealach uait chun an teaghrán sin a mhapáil chuig an réad inghlaoite comhfhreagrach gan dul i muinín eval nó sraith if ráitis. Réitíonn foclóir seoladh an fhadhb seo i dtrí líne.

from functools import partial

# Ceangail an DataFrame le gach feidhm
available_functions = {
    "retrieve_payment_status": partial(retrieve_payment_status, df),
    "retrieve_payment_date": partial(retrieve_payment_date, df),
}

Déileálann functools.partial le deacracht shainiúil, fhíorshaol. Braitheann do chuid feidhmeanna ar dhá argóint—an DataFrame agus an tAitheantas—ach ní thugann an tsamhail ach ceann amháin. Níl a fhios ag an tsamhail faoi df, agus níor chóir a bheith. Líonann partial an chéad pharaiméadar sin uair amháin agus go buan. Baineann an mheicníocht chéanna le naisc bhunachair sonraí, cliant HTTP, nó comharthaí fíordheimhniúcháin. Ansin, bíonn an t-aghaidh dinimiciúil simplí go leor.

function_name = "retrieve_payment_status"
function_params = {"transaction_id": "T1001"}

result = available_functions[function_name](**function_params)
# → '{"status": "paid"}'

An Rogha tool_choice

Nuair a sheolann tú na huirlisí seo chuig an API, cinneann an paraiméadar tool_choice cé mhéad saoirse a thugann tú don tsamhail. Tá trí luach indéanta.

# Cinneann an tsamhail an úsáidfidh sí uirlis nó an bhfreagróidh sí go díreach (réamhshocrú)
response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools,
    tool_choice="auto"
)

# Cuir iallach ar an tsamhail uirlis a úsáid
response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools,
    tool_choice="any"
)

# Cosc a chur ar an tsamhail uirlisí a úsáid
response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools,
    tool_choice="none"
)

Is é an mód "auto" an ceann is coitianta i dtimpeallachtaí táirgeachta ar chúis mhaith: ba chóir go mbeadh cúntóir rianaithe íocaíochta in ann “hallo” a rá gan iarratas bunachair sonraí a spreagadh. Freagraíonn an tsamhail go díreach ar cheisteanna ginearálta agus úsáideann sí feidhmeanna ach amháin nuair a bhaineann siad leis an ábhar. Clúdaíonn ceacht iomlán níos déanaí sa chúrsa cásanna úsáide sonracha do any agus none.

Príomhphointí

  • Ní mór do fheidhmeanna teaghráin JSON a fhilleadh—ní réada Python amha riamh
  • Úsáid foclóir seoladh chun ainmneacha feidhmeanna a mhapáil chuig a gcur chun feidhme
  • Is idéalach functools.partial chun paraiméadair cosúil le naisc DB nó DataFrames a líonadh roimh ré
  • Rialaíonn tool_choice an féidir leis an tsamhail feidhmeanna a úsáid nó an gcaithfidh sí iad a úsáid (auto, any, none)
  • Déileáil i gcónaí le cásanna earráide i do chuid feidhmeanna (paraiméadair neamhbhailí, sonraí in easnamh)