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

An API Freagarthaí agus function_call_output

Ceacht 10 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An API Freagarthaí: an t-ionad deireadh nua
  2. Difríochtaí ó Chríochnuithe Comhrá
  3. An API Freagarthaí a úsáid leis an OpenAI SDK
  4. An freagra a láimhseáil
  5. An réimse previous_response_id
  6. Stóráil teachtaireachtaí ar an taobh freastalaí
  7. Cathin a úsáid an API Freagarthaí?
  8. Príomhphointí

An API Freagarthaí: an t-ionad deireadh nua

Is é an API Freagarthaí príomh-ionad deireadh nua xAI, ar leithligh ón ionad deireadh Críochnuithe Comhrá atá comhoiriúnach le OpenAI. Tugann sé formáid dhifriúil isteach le haghaidh glaonna feidhme, ag baint úsáide as an gcineál function_call_output chun torthaí uirlisí a thabhairt ar ais.

Difríochtaí ó Chríochnuithe Comhrá

Úsáideann an t-ionad deireadh Críochnuithe Comhrá (comhoiriúnach le OpenAI) teachtaireachtaí róle tool chun torthaí a thabhairt ar ais. Úsáideann an API Freagarthaí formáid eile, atá struchtúrtha timpeall ar chineálacha imeachtaí.

Críochnuithe Comhrá (formáid sheanbhunaithe)

# Return the result via a "tool" role message
messages.append({
    "role": "tool",
    "tool_call_id": "call_abc123",
    "content": {temp: 22, city: Paris}
})

API Freagarthaí (formáid nua)

# Return the result via a function_call_output object
{
    "type": "function_call_output",
    "call_id": "call_abc123",
    "output": {temp: 22, city: Paris}
}

Príomhdhifríochtaí:

  • Cuireann type: "function_call_output" in ionad role: "tool"
  • Cuireann call_id in ionad tool_call_id
  • Cuireann output in ionad content

An API Freagarthaí a úsáid leis an OpenAI SDK

Is féidir leat an OpenAI SDK a úsáid chun glaoch ar API Freagarthaí xAI:

from openai import OpenAI

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

# Create a response with tools
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"]
        }
    }]
)

Tabhair faoi deara go n-úsáideann an API Freagarthaí input in ionad messages, agus go bhfuil struchtúr na n-uirlisí beagán difriúil (gan oibiacht function neadaithe).

An freagra a láimhseáil

Tá eagair output le himeachtaí i bhfreagra an API Freagarthaí:

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}")

        # Execute the function
        result = get_weather(city="Paris")

        # Continue the conversation with the result
        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
        )

An réimse previous_response_id

Tugann an API Freagarthaí meicníocht slabhraithe comhrá isteach trí previous_response_id. In ionad stair iomlán na dteachtaireachtaí a sheoladh arís, ní dhéanann tú ach tagairt a dhéanamh don fhreagra roimhe seo:

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

# Second request (chained)
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
)

Déanann sé seo bainistiú comhthéacs a shimpliú agus laghdaíonn sé méid na n-iarratas.

Stóráil teachtaireachtaí ar an taobh freastalaí

Le store_messages=True, stórálann xAI teachtaireachtaí ar a bhfreastalaithe:

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

Nuair a chomhcheanglaítear é seo le previous_response_id, ligeann sé duit comhráite fada a choinneáil gan an stair iomlán a athsheoladh le gach iarratas.

Cathin a úsáid an API Freagarthaí?

Do thionscadal nua atá tógtha go sonrach ar xAI, is é an API Freagarthaí an rogha réamhshocraithe, ar chúiseanna éagsúla a fhorbraíonn a chéile. Tagann nuálaíochtaí anseo ar dtús—cuirtear gnéithe nua leis an API Freagarthaí sula gcuirtear in aon áit eile iad, uaireanta go heisiach. Níl roinnt uirlisí freastalaí ionsuite ar fáil ach tríd an gcainéal seo. Agus do chomhráite fada, tá slabhrú trí previous_response_id níos éifeachtúla go struchtúrtha ná an stair iomlán a athsheoladh gach uair: níos lú tokenanna a aistrítear, níos lú cód bainistithe stáit ar do thaobhse.

Coinníonn Críochnuithe Comhrá dhá chás úsáide láidre: cód atá ann cheana féin a scríobhadh don API OpenAI, a oibríonn mar atá sé trí an bun-URL a athrú, agus tionscadail ilsholáthraí ina mbíonn tosaíocht ag iniomparthacht—sna cásanna seo, tá an chomhoiriúnacht níos tábhachtaí ná gnéithe eisiacha.

Príomhphointí

  • Úsáideann an API Freagarthaí function_call_output in ionad an róil tool
  • Athraíonn na réimsí: call_id in ionad tool_call_id, output in ionad content
  • Ligeann previous_response_id duit comhráite a shlabhrú gan an stair a athsheoladh
  • Cumasaíonn store_messages=True stóráil ar an taobh freastalaí
  • Is é an API Freagarthaí an t-ionad deireadh a mholtar do thionscadail nua xAI
  • Fanann Críochnuithe Comhrá ar fáil le haghaidh comhoiriúnachta siar le OpenAI