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

L-API Responses u function_call_output

Lezzjoni 10 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-API Responses: l-endpoint il-ġdid
  2. Differenzi minn Chat Completions
  3. Kif tuża l-API Responses mas-SDK ta’ OpenAI
  4. Kif timmaniġġja r-risposta
  5. Il-qasam previous_response_id
  6. Ħażna tal-messaġġi fuq is-server
  7. Meta għandek tuża l-API Responses?
  8. Punti Ewlenin

L-API Responses: l-endpoint il-ġdid

L-API Responses hija l-endpoint primarju l-ġdid ta’ xAI, distint mill-endpoint Chat Completions kompatibbli ma’ OpenAI. Tintroduċi format differenti għas-sejħa tal-funzjonijiet, billi tuża t-tip function_call_output biex tirritorna r-riżultati tal-għodod.

Differenzi minn Chat Completions

L-endpoint Chat Completions (kompatibbli ma’ OpenAI) juża messaġġi bir-rwol tool biex jirritorna r-riżultati. L-API Responses tuża format differenti, strutturat madwar tipi ta’ avvenimenti.

Chat Completions (format antik)

# Irritorna r-riżultat permezz ta' messaġġ bir-rwol "tool"
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

API Responses (format ġdid)

# Irritorna r-riżultat permezz ta' oġġett function_call_output
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Differenzi ewlenin:

  • type: "function_call_output" tissostitwixxi role: "tool"
  • call_id tissostitwixxi tool_call_id
  • output tissostitwixxi content

Kif tuża l-API Responses mas-SDK ta’ OpenAI

Tista’ tuża s-SDK ta’ OpenAI biex issejjaħ l-API Responses ta’ xAI:

from openai import OpenAI

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

# Oħloq risposta b'għodod
response = client.responses.create(
    model="grok-4.5",
    input="What's the weather like in Paris?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get the weather for a city",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"}
            },
            "required": ["city"]
        }
    }]
)

Innota li l-API Responses tuża input minflok messages, u l-istruttura tal-għodod hija kemxejn differenti (l-ebda oġġett function imbejjen).

Kif timmaniġġja r-risposta

Ir-risposta tal-API Responses fiha array output b’avvenimenti:

for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}")
        print(f"Arguments: {item.arguments}")
        print(f"Call ID: {item.call_id}")

        # Eżegwixxi l-funzjoni
        result = get_weather(city="Paris")

        # Kompli l-konversazzjoni bir-riżultat
        follow_up = client.responses.create(
            model="grok-4.5",
            input=[
                {"type": "function_call_output",
                 "call_id": item.call_id,
                 "output": json.dumps(result)}
            ],
            tools=tools,
            previous_response_id=response.id
        )

Il-qasam previous_response_id

L-API Responses tintroduċi mekkaniżmu ta’ katina tal-konversazzjoni permezz ta’ previous_response_id. Minflok tibgħat mill-ġdid l-istorja sħiħa tal-messaġġi, sempliċiment tirreferenzja r-risposta preċedenti:

# L-ewwel talba
response1 = client.responses.create(
    model="grok-4.5",
    input="Look up the weather in Paris"
)

# It-tieni talba (magħquda)
response2 = client.responses.create(
    model="grok-4.5",
    input=[{
        "type": "function_call_output",
        "call_id": response1.output[0].call_id,
        "output": {temp: 22}
    }],
    previous_response_id=response1.id
)

Dan jissimplifika l-ġestjoni tal-kuntest u jnaqqas id-daqs tat-talbiet.

Ħażna tal-messaġġi fuq is-server

B’store_messages=True, xAI taħżen il-messaġġi fuq is-servers tagħhom:

response = client.responses.create(
    model="grok-4.5",
    input="User question",
    tools=tools,
    store_messages=True
)

Meta tingħaqad ma’ previous_response_id, dan jippermettilek iżżomm konversazzjonijiet twal mingħajr ma terġa’ tibgħat l-istorja sħiħa ma’ kull talba.

Meta għandek tuża l-API Responses?

Għal proġett ġdid mibni speċifikament fuq xAI, l-API Responses hija l-għażla default, għal diversi raġunijiet kumulattivi. L-innovazzjonijiet jaslu hawn l-ewwel—karatteristiċi ġodda jiżdiedu mal-API Responses qabel kullimkien ieħor, xi kultant esklussivament. Ċerti għodod tas-server integrati huma disponibbli biss permezz ta’ dan il-kanal. U għal konversazzjonijiet twal, il-katina permezz ta’ previous_response_id hija strutturalment aktar effiċjenti milli terġa’ tibgħat l-istorja sħiħa f’kull dawra: inqas tokens trasferiti, inqas kodiċi ta’ ġestjoni tal-istat fuq in-naħa tiegħek.

Chat Completions iżżomm żewġ każijiet ta’ użu b’saħħithom: kodiċi eżistenti miktub għall-API ta’ OpenAI, li jaħdem kif inhu billi tbiddel l-URL bażi, u proġetti b’ħafna fornituri fejn il-portabbiltà tieħu preċedenza—f’dawn is-sitwazzjonijiet, il-kompatibbiltà tiżen aktar mill-karatteristiċi esklussivi.

Punti Ewlenin

  • L-API Responses tuża function_call_output minflok ir-rwol tool
  • Il-qasam jinbidel: call_id minflok tool_call_id, output minflok content
  • previous_response_id jippermettilek tgħaqqad il-konversazzjonijiet mingħajr ma terġa’ tibgħat l-istorja
  • store_messages=True jippermetti l-ħażna fuq is-server
  • L-API Responses hija l-endpoint rakkomandat għal proġetti ġodda ta’ xAI
  • Chat Completions tibqa’ disponibbli għall-kompatibbiltà lura ma’ OpenAI