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

Leaganú prasanna agus bainistiú catalóige

Ceacht 14 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Leaganú prasanna agus bainistiú catalóige
  2. Cén fáth leaganú a dhéanamh ar phrasanna
  3. Struchtúr na catalóige
  4. An chatalóg a úsáid i d’iarratas
  5. Leaganú le Git
  6. Dea-chleachtais
  7. An chatalóg a thástáil le fillteach ar ais
  8. Príomhphointí

An ceacht nuashonraithe an 3 Samhain 2026 bunaithe ar dhoiciméadú OpenAI: níl temperature agus top_p inghlactha ach le hiarracht réasúnaíochta de none, cé go ndéanann samhlacha GPT-5.6 réasúnú go huathoibríoch (medium). Caithfidh glaonna a shocraíonn na paraiméadair seo reasoning={"effort": "none"} (API Freagraí) nó reasoning_effort="none" (Críochnú Comhrá) a shonrú dá bhrí sin. Foinse: GPT-6 a úsáid · GPT-5.6 Terra.

Leaganú prasanna agus bainistiú catalóige

Sa táirgeadh, éabhlóideann do phrasanna díreach chomh mór is a dhéanann do chód. Gan leaganú, cailleann tú rian ar athruithe, ní féidir leat filltigh ar ais, agus níl foghlam agat ar an leagan atá ag rith sa táirgeadh. Taispeánann an ceacht seo duit conas prasanna a bhainistiú mar shaothair bhogearraí.

Cén fáth leaganú a dhéanamh ar phrasanna

Is féidir le hathrú pras iompraíocht d’iarratais a athrú go radacach. Murab ionann agus cód, bíonn na hathruithe seo minic fíneálta agus deacair a bhrath gan tástálacha uathoibrithe: athfhrású abairte, focal bogtha, agus tosaíonn an tsamhail mí-aicmiú a dhéanamh ar chás imeallach as gach deich. Ní bhrathfaidh aon tástáil aonaid chaighdeánach an bhearna seo, ach cuirfidh an tacaíocht bratach air trí seachtaine ina dhiaidh sin mar ghearáin doiléir faithicéid mí-stiúrtha.

Freagraíonn an leaganú ar cheithre riachtanas ar leith. Ar an gcéad dul síos, inrianaitheacht: a fhios a bheith agat cé a rinne athrú ar cad agus cathain a thiontaíonn díospóireacht steiriúil foirne ina seiceáil stair shimplí. Ar an dara dul síos, fillteach ar ais: nuair a thagann cúlú chun cinn, ní hé an sprioc láithreach ná tuiscint a fháil ar an gcúis ach an iompraíocht aitheanta a athbhunú. Ar an tríú dul síos, comparáid feidhmíochta: éilíonn sé seo go bhfanann leaganacha níos sine in-executable díreach mar a bhí siad, lena samhail agus a socruithe bunaidh. Faoi dheireadh, iniúchadh: do chórais atá faoi réir an GDPR (An Rialachán Ginearálta maidir le Cosaint Sonraí) nó creatlach comhlíontachta eile, caithfidh tú a léiriú cé na treoracha a bhí i bhfeidhm ar dháta ar leith—ní leor scáileanghabháil.

Struchtúr na catalóige

Comhlíonann an rang PromptCatalog na riachtanais seo le bonneagar íosta: fillteán amháin in aghaidh an phrais, comhad JSON amháin in aghaidh an leagain, uimhrithe go seicheamhach. Cuimsíonn gach comhad téacs an phrais chórais mar aon leis an tsamhail agus an teocht chomhcheangailte—ní rud céanna é pras tiúnta go 0.1 agus an pras céanna ag 0.7, agus coscaíonn iad a ghlasáil le chéile téacs a athbhunú agus a shocruithe a dhéanamh dearmad.

Rianaíonn an réimse status an timthriall saoil. Tosaíonn leagan mar draft, rud a ligeann ullmhúchán agus tástáil gan tionchar a imirt ar thrácht beo. Cuireann glaowadh ar activate é go active agus déanann sé an leagan roimhe sin a íosghrádú go deprecated go huathoibríoch, ag cinntiú nach bhfreastalaíonn ach leagan amháin ar thrácht ag aon am amháin. Déanann an modh seo fillteach ar ais suimiúil: is glaowadh aonair é leagan roimhe sin a athghníomhachtú, ní imlonnú. Glaoíonn d’iarratas ar get_active sa táirgeadh, agus tacaíonn list_versions le hathbhreithnithe agus iniúchtaí.

import json
from datetime import datetime
from pathlib import Path

class PromptCatalog:
    """Bainisteoir catalóige prasanna le leaganú."""

    def __init__(self, catalog_dir: str = "prompts/"):
        self.catalog_dir = Path(catalog_dir)
        self.catalog_dir.mkdir(parents=True, exist_ok=True)

    def save_prompt(self, name: str, system_prompt: str,
                    model: str, temperature: float,
                    metadata: dict = None) -> str:
        """Sábhálann sé leagan nua de phras."""
        prompt_dir = self.catalog_dir / name
        prompt_dir.mkdir(exist_ok=True)

        # Faigh uimhir an leagain
        versions = sorted(prompt_dir.glob("v*.json"))
        version = len(versions) + 1
        version_str = f"v{version:03d}"

        # Sábháil
        prompt_data = {
            "name": name,
            "version": version_str,
            "created_at": datetime.now().isoformat(),
            "model": model,
            "temperature": temperature,
            "system_prompt": system_prompt,
            "metadata": metadata or {},
            "status": "draft"  # draft | active | deprecated
        }

        filepath = prompt_dir / f"{version_str}.json"
        filepath.write_text(json.dumps(prompt_data, indent=2,
                                        ensure_ascii=False))

        return version_str

    def get_prompt(self, name: str,
                   version: str = "latest") -> dict:
        """Faigheann sé pras de réir ainm agus leagain."""
        prompt_dir = self.catalog_dir / name

        if version == "latest":
            versions = sorted(prompt_dir.glob("v*.json"))
            if not versions:
                raise FileNotFoundError(f"Prompt '{name}' not found")
            filepath = versions[-1]
        else:
            filepath = prompt_dir / f"{version}.json"

        return json.loads(filepath.read_text())

    def get_active(self, name: str) -> dict:
        """Faigheann sé an leagan gníomhach de phras."""
        prompt_dir = self.catalog_dir / name
        for filepath in sorted(prompt_dir.glob("v*.json"),
                               reverse=True):
            data = json.loads(filepath.read_text())
            if data["status"] == "active":
                return data
        raise FileNotFoundError(
            f"No active version for '{name}'"
        )

    def activate(self, name: str, version: str):
        """Gníomhachtaíonn sé leagan agus díghníomhachtaíonn sé cinn eile."""
        prompt_dir = self.catalog_dir / name

        for filepath in prompt_dir.glob("v*.json"):
            data = json.loads(filepath.read_text())
            if data["version"] == version:
                data["status"] = "active"
            elif data["status"] == "active":
                data["status"] = "deprecated"
            filepath.write_text(json.dumps(data, indent=2,
                                            ensure_ascii=False))

    def list_versions(self, name: str) -> list[dict]:
        """Liostaíonn sé gach leagan de phras."""
        prompt_dir = self.catalog_dir / name
        versions = []
        for filepath in sorted(prompt_dir.glob("v*.json")):
            data = json.loads(filepath.read_text())
            versions.append({
                "version": data["version"],
                "status": data["status"],
                "created_at": data["created_at"],
                "model": data["model"]
            })
        return versions

An chatalóg a úsáid i d’iarratas

Ar thaobh an ghlaoóra, is simplí an riail: níl aon téacs prais i do chód; iarrann sé an leagan gníomhach ón gcatalóg. Coinníonn sé seo prasanna in-athraithe gan teagmháil a dhéanamh le cód an iarratais, agus coscaíonn sé teaghráin tríocha líne ó bheith curtha i bhfolach i lár feidhme. Níl aon tionchar ag meiteashonraí a shábháiltear le linn stórála—údar, cur síos, loga athruithe—ar fhorghníomhú, ach déanann sé an stair inléite sé mhí ina dhiaidh sin, nuair nach cuimhin le duine ar bith cén fáth ar athraíodh an foclaíocht.

Tá an mionsonraí criticiúil suite ag deireadh classifier_ticket: áirítear prompt_version sa fhreagra a thuirtear. Logáil an réimse seo le gach toradh, agus déantar anailís ar thimpistí féideartha—beidh a fhios agat gur tháinig ticéid mí-aicmithe tráthnóna Dé Máirt go léir ó v004, gan amchlóir imlonnaithe a chros-thagairt.

from openai import OpenAI

client = OpenAI()
catalog = PromptCatalog("prompts/")

# Sábháil pras
catalog.save_prompt(
    name="ticket-classifier",
    system_prompt="""You are a support ticket classifier.
Categorize each ticket as: bug, feature, question, billing.
Respond in JSON with category, priority (1-5), summary.""",
    model="gpt-5.6-terra",
    temperature=0.1,
    metadata={
        "author": "marie.dupont",
        "description": "Automatic classification of Zendesk tickets",
        "changelog": "Initial version"
    }
)

# Sa táirgeadh: úsáid an leagan gníomhach
def classifier_ticket(ticket_text: str) -> dict:
    """Aicmíonn sé ticéad ag baint úsáide as an bpras gníomhach."""
    prompt_config = catalog.get_active("ticket-classifier")

    response = client.responses.create(
        model=prompt_config["model"],
        reasoning={"effort": "none"},  # temperature requires effort none
        instructions=prompt_config["system_prompt"],
        input=ticket_text,
        temperature=prompt_config["temperature"]
    )

    return {
        "result": json.loads(response.output_text),
        "prompt_version": prompt_config["version"]
    }

Leaganú le Git

Do fhoirne, stóráil do phrasanna i stór Git tiomnaithe. Leanann an crann thíos coinbhinsiún simplí: fillteán amháin in aghaidh an phrais, ina bhfuil a shainmhíniú, cásanna tástála, agus loga athruithe. Ní cosmaiceach é tástálacha a choinneáil taobh le taobh an phrais a fhíoraíonn siad—modhnaíonn iarraidh tarraingthe an dá rud le chéile, agus déanann an t-athbhreithnitheoir breithiúnas ar an athrú bunaithe ar fhianaise seachas ar rún dearbhaithe.

prompts/
  ticket-classifier/
    prompt.yaml
    tests/
      test_cases.json
    CHANGELOG.md
  invoice-extractor/
    prompt.yaml
    tests/
      test_cases.json
    CHANGELOG.md

Cuireann YAML in ionad JSON anseo ar chúis shonrach: is téacsanna il-líne iad prasanna, agus taispeánann an chomhréir | iad díreach mar a seoladh iad, gan éalú ná carachtair \n stray. Léann dif Git ar an gcomhad seo cosúil le dif próis—feiceann an t-athbhreithnitheoir go cuireadh abairt leis. Taistealaíonn an scéima aschurtha sa chomhad céanna, mar sin oireann an chumraíocht iomlán do ghlaowadh in aon saothar amháin.

# prompts/ticket-classifier/prompt.yaml
name: ticket-classifier
model: gpt-5.6-terra
temperature: 0.1
max_output_tokens: 500
system_prompt: |
  You are a support ticket classifier.
  Categorize each ticket as: bug, feature, question, billing.
  Respond in JSON with category, priority (1-5), summary.
schema:
  type: object
  properties:
    category:
      type: string
      enum: [bug, feature, question, billing]
    priority:
      type: integer
    summary:
      type: string
  required: [category, priority, summary]
  additionalProperties: false

Dea-chleachtais

Is iad cúpla riail cothabhála a dhealaíonn catalóg bheo ó fhillteán cartlainne. Coinnigh pras amháin in aghaidh an chomhaid: déanann meascadh il-phrasanna i ndoiciméad amháin difríochtaí doléite agus filltigh ar ais dodhéanta a spriocadh. Cuir loga athruithe i bhfeidhm ag doiciméadú ní cad a d’athraigh—taispeánann an dif é sin—ach cén fáth: “treoir curtha leis ar thicéid ilteangacha tar éis aiseolais ón tacaíocht” tá sé níos fiú ná deich líne cur síos teicniúil.

Bain úsáid as sraith tástála go córasach le gach pras; murach sin, is iad na húsáideoirí a chuirfidh in iúl duit nuair a bhriseann modhnú iompraíocht bhunaithe. Cuir athruithe prais tríd an bpróiseas athbhreithnithe cóid céanna leis an gcód féin: cruthaíonn pras a théann go táirgeadh gan athbhreithniú na hiontais chéanna le cód gan athbhreithniú. Fíoraigh go dtógann fillteach ar ais níos lú ná nóiméad, agus déan tástáil air ar lá ciúin seachas le linn timpiste. Faoi dheireadh, marcáil leaganacha imlonnaithe le clibeanna chun iompraíocht bhreathnaithe a nascadh go soiléir le staid shonrach stórais.

An chatalóg a thástáil le fillteach ar ais

Socraigh PromptCatalog do thrí phras fíor ó d’iarratas, ansin taifead dhá nó trí leagan de gach ceann acu trí na treoracha a fhorbairt i gcéimeanna beaga—treoir tóin, catagóir bhreise. Cruthaíonn an leaganú a luach ar na hathruithe mionghrádacha seo, toisc gurb iad sin na cinn nach gcuimhneofar ort a rinne tú. Socraigh gníomhachtú agus díghníomhachtú, agus ceangail sraith tástála le gach pras.

Críochnaigh leis an cleachtadh is oideachasúla: gníomhachtaigh leagan meathlaithe d’aon ghnó, breathnaigh ar an gcúlú trí thástálacha, agus déan an fillteach ar ais agus é a uainiú. Má sháraíonn an oibríocht nóiméad amháin, deisigh an nós imeachta sula gcuireann tú aon phras amháin leis an gcatalóg—ní fillteach ar ais é fillteach mall, is timpiste fadaithe é.

Príomhphointí

  • Is saothair bhogearraí iad prasanna a éilíonn leaganú
  • Is comhad JSON nó YAML le meiteashonraí gach leagan
  • Cumasaíonn stádas (draft, active, deprecated) imlonnú céimneach
  • Stóráil prasanna i Git le tástálacha agus loga athruithe
  • Caithfidh fillteach ar ais a bheith láithreach i gcás cúlaithe