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

Irkupra r-raġunar ikkrittografat b'include

Lezzjoni 5 / 12 Aġġornat 28 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Aċċessa għar-raġunar intern tal-mudelli ta’ raġunar ta’ xAI
  2. Il-parametru include
  3. Struttura tar-rispons
  4. Mingħajr include: l-ebda raġunar fir-rispons
  5. Meta tuża include
  6. Il-ħżin tar-raġunar ikkrittografat
  7. Punti Ewlenin

Aċċessa għar-raġunar intern tal-mudelli ta’ raġunar ta’ xAI

Il-mudelli riċenti ta’ raġunar ta’ xAI (il-familja grok-4.5, grok-4.20) jiġġeneraw raġunar intern li ma tistax taqrah bħala test sempliċi. Madankollu, xAI jħallik tirrikupra dan ir-raġunar f’forma ikkrittografata billi tuża l-parametru include. Dan il-mekkaniżmu jippermetti użi avvanzati, partikolarment ir-riutilizzazzjoni tar-raġunar f’talbiet sussegwenti.

Il-parametru include

Biex tirrikupra l-kontenut ikkrittografat tar-raġunar, żid "reasoning.encrypted_content" mal-array include fit-talba tiegħek għall-API tar-Risposti:

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort.",
    include=["reasoning.encrypted_content"]
)

Struttura tar-rispons

Ir-rispons fih ir-raġunar ikkrittografat f’format speċifiku. Dan il-kontenut huwa blob ikkodifikat li tista’ taħżen iżda ma tistax tinterpreta. L-istruttura interna tiegħu hija opaqa b’disinn.

# Itera fuq l-elementi tar-rispons
for item in response.output:
    if item.type == "reasoning":
        # Kontenut ikkrittografat tar-raġunar
        encrypted = item.encrypted_content
        print(f"Encrypted reasoning size: {len(encrypted)} characters")
    elif item.type == "message":
        # Rispons finali tal-mudell
        print(f"Response: {item.content[0].text}")

Mingħajr include: l-ebda raġunar fir-rispons

Jekk ma tinkludix "reasoning.encrypted_content" fil-parametru include, ir-rispons ikun fih biss ir-riżultat finali. Ir-raġunar iseħħ fuq is-server, iżda l-ebda traċċa ma tiġi rritornata:

# Mingħajr include - jiġi rritornat biss ir-rispons finali
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output fih biss il-messaġġ, l-ebda raġunar

It-tokens tar-raġunar xorta waħda jiġu kkuntati u ffatturati, anke mingħajr include. Id-differenza hija li ma tirċevix il-kontenut ikkrittografat għal riutilizzazzjoni futura.

Meta tuża include

Ir-rikupru tar-raġunar ikkrittografat ġej b’kost—risponsi akbar, aktar bandwidth—għalhekk uża include għal skop speċifiku, mhux b’mod awtomatiku. Il-każ ta’ użu primarju huwa konversazzjoni b’diversi dawriet: jekk ippjanajt li tkompli l-iskambju, li terġa’ tgħaqqad ir-raġunar mid-dawra ta’ qabel iżomm il-kontinwità tal-ħsieb tal-mudell. Dan jiddistingwi konversazzjoni li qed tipprogressa minn serje ta’ mistoqsijiet indipendenti. Il-cache tal-ħsieb huwa l-estensjoni għall-intrapriża: il-ħżin tar-raġunar minn talba biex terġa’ tużah fuq talbiet simili jevita li l-mudell jerġa’ jikkalkula kollox. Jibqgħu żewġ każijiet ta’ użu ta’ governanza: l-awditjar, meta l-konformità teħtieġ traċċa sħiħa ta’ kull rispons prodott, u d-debugging mas-sostenn ta’ xAI, li se jitlob ir-raġunar sħiħ biex janalizza mġiba mhux mistennija.

Il-ħżin tar-raġunar ikkrittografat

Tista’ taħżen il-kontenut ikkrittografat bħal kwalunkwe string ieħor. F’database, kamp TEXT jew JSONB huwa biżżejjed:

import json

# Estrai u aħżen ir-raġunar ikkrittografat
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Aħżen mar-rispons
record = {
    "question": "Analyze the complexity of merge sort.",
    "response": response.output[-1].content[0].text,
    "encrypted_reasoning": reasoning_data,
    "model": "grok-4.20-0309-reasoning",
    "timestamp": "2026-04-03T10:00:00Z"
}

Punti Ewlenin

  • Il-parametru include=["reasoning.encrypted_content"] jirkupra r-raġunar ikkrittografat mill-mudelli ta’ raġunar ta’ xAI
  • Mingħajr include, ir-raġunar iseħħ iżda ma jiġix irritornat (it-tokens xorta jiġu ffatturati)
  • Il-kontenut ikkrittografat huwa blob opaku li ma tistax taqrah bħala test sempliċi
  • Tista’ taħżen u terġa’ tuża dan il-kontenut f’talbiet sussegwenti (fil-lezzjoni li jmiss)
  • Uża include biss jekk għandek użu speċifiku għar-raġunar ikkrittografat