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

Dea-chleachtais Táirgthe

Ceacht 17 as 22 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Dea-chleachtais Táirgthe
  2. 1. Ailtireacht an Chliaint
  3. 2. Bainistíocht Leideanna (Prompts)
  4. 3. Teorainneacha Ama agus Teorainneacha Eile
  5. 4. Cúlú Samhla (Model Fallback)
  6. 5. Próiseáil Bhaisc
  7. 6. Tástáil agus Bailíochtú
  8. 7. Seicliosta Imlonaithe Táirgthe
  9. 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 (reasoning effort) de none, ach dé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.

Dea-chleachtais Táirgthe

Clúdaíonn an ceacht seo na dea-chleachtais riachtanacha chun feidhmchlár bunaithe ar API OpenAI a imlonnú go táirgeadh. Smaoinigh air seo mar do sheicliosta réamh-sheoladh. Thug na ceachtaí roimhe seo na bloic thógála duit – láimhseáil earráidí, teorainneacha ráta, athléimneacht, inbhreathnaitheacht, agus costais. Anois, tá sé in am iad a chur le chéile ina fheidhmchlár is féidir le comhghleacaí a ghlacadh thar láimh agus a rith gan tú.

1. Ailtireacht an Chliaint

Singleton le Cumraíocht Láraithe

Is dramhaíl é cliant OpenAI a chruthú ar gach glao ar an nasc HTTP bunúsach, agus níos measa fós, scaipeann sé do chumraíocht. Críochnaíonn tú le teorainn ama 30 soicind anseo agus an réamhshocrú ansin, gan aon bhealach chun a fháil amach cé acu ceann atá i bhfeidhm sa táirgeadh. Ráthaíonn an t-ornáid lru_cache sampla amháin, cumraithe in áit amháin.

from openai import OpenAI
from functools import lru_cache

@lru_cache(maxsize=1)
def get_client() -> OpenAI:
    """Cliant singleton le cumraíocht táirgthe."""
    return OpenAI(
        max_retries=3,
        timeout=30.0,
    )

# I ngach áit i do chód:
client = get_client()

Athróga Timpeallachta

Baineann an prionsabal céanna le socruithe a athraíonn idir timpeallachtaí. Seiceáil na hathróga riachtanacha ag am tosaithe: is fearr go mór go diúltódh seirbhís tosú le teachtaireacht shoiléir ná tosú agus teipthe ar an gcéad ghlao ó úsáideoir. Déanann sé seo an tsamhail, an teorainn token, agus an teocht inchoigeartaithe gan ath-imlonnú.

import os

# RIACHTANACH: ná crua-chódaigh eochracha riamh
REQUIRED_ENV = ["OPENAI_API_KEY"]

for var in REQUIRED_ENV:
    if not os.environ.get(var):
        raise RuntimeError(f"Athróg ar iarraidh {var}")

# Cumraíocht sonrach don timpeallacht
MODEL = os.environ.get("OPENAI_MODEL", "gpt-5.6-terra")
MAX_TOKENS = int(os.environ.get("OPENAI_MAX_TOKENS", "4096"))
TEMPERATURE = float(os.environ.get("OPENAI_TEMPERATURE", "0.7"))

2. Bainistíocht Leideanna (Prompts)

Leideanna a Scaradh ón gCód

Is sócmhainn gnó é leid, díreach cosúil le riail gnó. Má dhéanann tú é a chur i bhfolach i sreang-f i bhfeidhm, déanann sé dodhéanta do dhuine a bhfuil eolas ar an ngnó aige ach nach bhfuil eolas ar Python é a athbhreithniú. Aonraigh é mar theimpléad paraiméadraithe: ansin laghdaítear an fheidhm go formáidiú agus glao, agus déanann teocht 0.0 an aicmiú in-atáirgthe.

# prompts/classification.txt
PROMPT_CLASSIFICATION = """Is aicmitheoir téacs tú.
Aicmigh an téacs seo a leanas i gceann de na catagóirí seo:
{categories}

Téacs: {texte}

Freagair leis an ainm catagóire amháin."""

def classifier(texte: str, categories: list[str]) -> str:
    prompt = PROMPT_CLASSIFICATION.format(
        categories=", ".join(categories),
        texte=texte
    )
    response = get_client().responses.create(
        model=MODEL,
        reasoning={"effort": "none"},  # éilíonn temperature effort none
        input=prompt,
        temperature=0.0
    )
    return response.output_text.strip()

Leaganú do chuid Leideanna

Athraíonn leid iompraíocht an chórais chomh cinnte agus a athraíonn cód, ach gan aon tástáil aonaid é a bhrath. Coinnigh leaganacha leantacha agus roghnaigh an ceann gníomhach trí chumraíocht. Ligeann sé seo duit dhá fhoirmliú a chur i gcomparáid ar thrácht fíor agus filleadh ar an gceann roimhe seo le hathróg timpeallachta má dhéanann an ceann nua dochar do na torthaí.

PROMPTS = {
    "classification_v1": "Aicmigh: {texte}",
    "classification_v2": "Déan anailís agus aicmigh go beacht: {texte}",
}

# Sa táirgeadh, úsáid leagan sonrach
ACTIVE_PROMPT = os.environ.get("PROMPT_VERSION", "classification_v2")

3. Teorainneacha Ama agus Teorainneacha Eile

Ceangail gach ionchur ón taobh amuigh sula sroicheann sé an API. Ní mór nach mbeadh úsáideoir a ghreamaíonn PDF 200 leathanach isteach i do réimse ionchuir in ann glao il-dollar a spreagadh nó fáil ar an iarratas teipthe mar gheall ar shárú comhthéacs. Déanann gearradh coisctheach, in éineacht leis an gcapaill aschuir agus an teocht ón gcumraíocht, costas agus moill gach glao intuartha.

def appel_avec_garde_fous(prompt: str) -> str:
    """Glao API le gach cosaint."""
    # Teorainn méid an leide
    MAX_PROMPT_CHARS = 50000
    if len(prompt) > MAX_PROMPT_CHARS:
        prompt = prompt[:MAX_PROMPT_CHARS]
        print(f"Leid gearrtha go {MAX_PROMPT_CHARS} carachtar")

    response = get_client().responses.create(
        model=MODEL,
        reasoning={"effort": "none"},  # éilíonn temperature effort none
        input=prompt,
        max_output_tokens=MAX_TOKENS,
        temperature=TEMPERATURE,
    )

    return response.output_text

4. Cúlú Samhla (Model Fallback)

Nuair a bhíonn samhail sáithithe nó ar fáil go sealadach, ní hé earráid a thabhairt ar ais an t-aon rogha atá agat. Athrú go samhail thánaisteach laghdaíonn cáilíocht ach coinníonn sé an tseirbhís ar siúl – idirbheart is minic a fhearr do chúntóir tacaíochta, cé nach bhfuil sé chomh maith sin d’anailís conarthaí. Déanann an lúb athrá ar shamhlacha in ord tosaíochta agus ardaíonn sí eisceacht ach amháin má theipeann ar gach ceann acu.

from openai import RateLimitError, InternalServerError

def appel_avec_fallback(prompt: str) -> str:
    """Bain triail as Terra ansin fill ar Luna ar earráid."""
    modeles = ["gpt-5.6-terra", "gpt-5.6-luna"]

    for modele in modeles:
        try:
            response = get_client().responses.create(
                model=modele,
                input=prompt
            )
            return response.output_text
        except (RateLimitError, InternalServerError) as e:
            print(f"{modele} ar fáil: {e}")
            continue

    raise RuntimeError("Tá gach samhail ar fáil")

5. Próiseáil Bhaisc

Chun míle doiciméad a phróiseáil, tá glaonna seicheamhacha ró-mhall agus pléascann glaonna comhuaineacha do theorainneacha ráta. Buaileann seimeafar an chothromaíocht cheart. Déanann dhá mhionsonraí an cur chun feidhme seo láidir: coscaíonn return_exceptions=True teipthe aonair an baisc iomlán a chealú, agus athshocraíonn sórtáil de réir innéacs an t-ord bunaidh, rud nach ráthaíonn asyncio.gather in am feidhmithe.

import asyncio
from openai import AsyncOpenAI

async def traiter_batch(prompts: list[str], max_concurrent: int = 5) -> list:
    """Próiseálann sé baisc leideanna le comhthreomhaireacht theoranta."""
    client = AsyncOpenAI()
    semaphore = asyncio.Semaphore(max_concurrent)
    resultats = []

    async def traiter_un(index: int, prompt: str):
        async with semaphore:
            response = await client.responses.create(
                model="gpt-5.6-terra",
                input=prompt
            )
            return index, response.output_text

    tasks = [traiter_un(i, p) for i, p in enumerate(prompts)]
    results = await asyncio.gather(*tasks, return_exceptions=True)

    # Sórtáil de réir innéacs chun an t-ord a choinneáil
    sorted_results = sorted(
        [(idx, res) for idx, res in results if not isinstance(res, Exception)],
        key=lambda x: x[0]
    )
    return [res for _, res in sorted_results]

# prompts = ["Ceist 1", "Ceist 2", "Ceist 3"]
# résultats = asyncio.run(traiter_batch(prompts))

6. Tástáil agus Bailíochtú

Tá dhá chineál tástála ag teastáil uait. Seiceálann an chéad cheann an píobaireacht – oibríonn an eochair, téann an líonra tríd, freagraíonn an tsamhail – agus oireann sé go maith i seiceáil sláinte tosaithe. Tástálann an dara ceann, atá níos bunúsaí, cáilíocht an leide féin: cuireann tú cás isteach ina bhfuil an freagra ceart ar eolas agat agus fíoraíonn tú go dtagann sé chun cinn. Is iad na dearbhuithe seo do líon sábháilteachta i gcoinne cúluithe nuair a athfhoirmlíonn tú teimpléad.

def test_api_disponible():
    """Fíoraíonn sé go bhfuil an API inrochtana."""
    try:
        response = get_client().responses.create(
            model="gpt-5.6-terra",
            input="tástáil",
            max_output_tokens=5
        )
        assert response.output_text is not None
        print("API OK")
        return True
    except Exception as e:
        print(f"API KO: {e}")
        return False

def test_prompt_quality(prompt: str, attendu: str) -> bool:
    """Fíoraíonn sé go dtugann leid toradh comhsheasmhach."""
    response = get_client().responses.create(
        model="gpt-5.6-terra",
        reasoning={"effort": "none"},  # éilíonn temperature effort none
        input=prompt,
        temperature=0.0
    )
    resultat = response.output_text.lower()
    return attendu.lower() in resultat

# Tástálacha cúlaithe leide
assert test_prompt_quality(
    "Aicmigh 'táirge den scoth': dearfach nó diúltach?",
    "dearfach"
)

Tóg dúsán cás tástála mar seo, atá ionadaíoch do do chásanna úsáide fíor, agus rith iad gach uair a mhodhnaíonn tú leid. Sábhálfaidh sraith tástála deich nóiméad seachtainí amhras duit faoi cháilíocht mheasta.

7. Seicliosta Imlonaithe Táirgthe

Sula ndéanann tú imlonnú, fíoraigh gach pointe:

Bonneagar

  • Athróga timpeallachta cumraithe (OPENAI_API_KEY, srl.)
  • Teorainneacha ama agus max_retries cumraithe
  • Logáil struchtúrtha i bhfeidhm
  • Monatóireacht costais cumasaithe

Athléimneacht

  • Láimhseáil iomlán earráidí (gach cód HTTP)
  • Cúlú easpónantúil le haghaidh athiarrachtaí
  • Briseadh ciorcaid le haghaidh easnamh fadtréimhseach
  • Cúlú go samhail mhalartach

Slándáil

  • Eochair API nach nochtar riamh i gcód ná i logaí
  • Bailíochtú ionchuir úsáideora
  • Teorainniú ráta taobh an chliaint
  • Gan aon sonraí íogair i leideanna

Feidhmíocht

  • Sruthú cumasaithe do chomhéadain úsáideora
  • Próiseáil bhaisc do thascanna toirte arda
  • Caiséáil d’iarratais athfhillteacha
  • Roghnú samhla oiriúnaithe do gach tasc

Costais

  • Buiséad laethúil sainithe
  • Foláirimh cumraithe
  • max_output_tokens socraithe nuair is féidir
  • An tsamhail is cost-éifeachtaí roghnaithe in aghaidh an tasc

Príomhphointí

  • Láraitigh cumraíocht an chliaint le singleton
  • Scar agus déan leaganú do do chuid leideanna lasmuigh den chód
  • Cuir cúlú samhla i bhfeidhm le haghaidh ard-infhaighteachta
  • Úsáid próiseáil bhaisc le comhthreomhaireacht theoranta le haghaidh toirte
  • Tástáil do chuid leideanna le dearbhuithe cáilíochta
  • Lean an seicliosta iomlán roimh gach imlonnú táirgthe