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

Uirlisí Freastalaí agus Cliant a Chomhcheangal

Ceacht 12 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Sreabhair Oibre Hibrideacha
  2. Uirlisí Freastalaí agus Feidhmeanna a Chomhcheangal
  3. An Sreabha Forghníomhaithe Hibrideach
  4. Patrúin Chomhcheangail Choitianta
  5. max_turns agus Uirlisí Hibrideacha
  6. Comhthéacs Il-rothlaithe le Stóráil
  7. Príomhphointí

Sreabhair Oibre Hibrideacha

Tagann fíorchumhacht an API Freagraí chun cinn nuair a chomhcheanglaíonn tú uirlisí freastalaí (a fhorghníomhaíonn xAI go huathoibríoch) agus uirlisí cliant (do fheidhmeanna saincheaptha) in aon iarratas amháin. Déanann an tsamhail na huirlisí seo a stiúradh go huathrialach, ag cruthú sreabhair oibre casta i gcúpla líne cóid.

Uirlisí Freastalaí agus Feidhmeanna a Chomhcheangal

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
    tools=[
        {"type": "web_search"},
        {
            "type": "function",
            "name": "send_team_message",
            "description": "Sends a message to the team via Slack",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {"type": "string"},
                    "message": {"type": "string"}
                },
                "required": ["channel", "message"]
            }
        }
    ]
)

Sa chás seo, déanann an tsamhail an méid seo a leanas:

  1. Tosaíonn sí web_search go huathoibríoch (taobh an fhreastalaí) chun na torthaí a aimsiú
  2. Cuireann sí na sonraí isteach in achoimre
  3. Glaoann sí ar send_team_message (taobh an chliaint) ionas go seolann do chód an teachtaireacht Slack

An Sreabha Forghníomhaithe Hibrideach

Athraíonn an sreabha ag brath ar chineál na huirlise:

Uirlisí Freastalaí Amháin

Request → [model → web_search → result → model] → Final response

Tarlaíonn gach rud ar thaobh xAI. Faigheann tú an freagra deiridh go díreach leis na torthaí comhtháite.

Uirlisí Cliant Amháin

Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Stopann an tsamhail, forghníomhaíonn do chód an fheidhm, agus ansin seolann tú an toradh ar ais.

Sreabha Hibrideach

Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Úsáideann an tsamhail uirlisí freastalaí ar dtús (go huathoibríoch), agus ansin glaonn sí ar do fheidhm nuair a theastaíonn do bhonneagar uaithi.

Patrúin Chomhcheangail Choitianta

Cuardach + Gníomh

Comhcheangail web_search nó x_search le feidhm gníomhaíochta:

tools = [
    {"type": "web_search"},
    {"type": "x_search"},
    {
        "type": "function",
        "name": "create_report",
        "description": "Creates a report in the CRM",
        "parameters": {
            "type": "object",
            "properties": {
                "title": {"type": "string"},
                "content": {"type": "string"},
                "tags": {"type": "array", "items": {"type": "string"}}
            },
            "required": ["title", "content"]
        }
    }
]

Ríomhaireacht + Fógra

Comhcheangail code_interpreter le feidhm fógra:

tools = [
    {"type": "code_interpreter"},
    {
        "type": "function",
        "name": "send_alert",
        "description": "Sends an alert if a threshold is exceeded",
        "parameters": {
            "type": "object",
            "properties": {
                "metric": {"type": "string"},
                "value": {"type": "number"},
                "threshold": {"type": "number"}
            },
            "required": ["metric", "value"]
        }
    }
]

max_turns agus Uirlisí Hibrideacha

Tá tábhacht le hiompar max_turns i gcomhthéacs hibrideach:

  • Cuireann max_turns teorainn le rothluithe taobh an fhreastalaí laistigh d’aon iarratas amháin
  • Nuair a ghlaonn an tsamhail ar fheidhm chliaint agus nuair a thugann do chód an toradh ar ais, tosaíonn leithdháileadh nua de max_turns

Go praiticiúil, ciallaíonn sé seo nach gcuireann glaotha cliant do bhuiséad rothlaithe freastalaí in ídiú. Is féidir leis an tsamhail 3 chuardach gréasáin a dhéanamh, do fheidhm a ghlaow, agus ansin 3 chuardach bhreise a dhéanamh tar éis an toraidh a fháil.

Comhthéacs Il-rothlaithe le Stóráil

Chun sreabhair oibre casta a shíneann thar idirghníomhaíochtaí iolracha, comhcheangail stóráil agus slabhrú:

# Turn 1: initial search
r1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze AI market trends.",
    tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
    store=True,
    max_turns=5
)

# Turn 2: deepen with your internal data
r2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Compare with our internal data.",
    tools=[{
        "type": "function",
        "name": "query_internal_db",
        "description": "Queries the internal database",
        "parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
    }],
    previous_response_id=r1.id,
    store=True
)

Príomhphointí

  • Comhcheangail uirlisí freastalaí agus feidhmeanna cliant in aon iarratas amháin le haghaidh sreabhair oibre hibrideacha
  • Forghníomhaítear uirlisí freastalaí go huathoibríoch; stopann feidhmeanna cliant an ghiniúint
  • Athshocraíonn max_turns tar éis gach turais chliaint
  • Patrúin choitianta: cuardach + gníomh, ríomhaireacht + fógra, comhiomlánú ilfhoinse
  • Úsáid store: true agus previous_response_id le haghaidh sreabhair oibre il-rothlaithe