Salt la conținutul principal
Română— Alege o limbă
Meniu

Instrumente de server și apelarea funcțiilor

Lecția 10 din 12 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Îmbogățirea loturilor cu instrumente
  2. Instrumente lato parte de server
  3. Apelarea funcțiilor lato parte de client
  4. Combinarea instrumentelor
  5. Limitările instrumentelor în lot
  6. Puncte cheie

Curs actualizat la 2 noiembrie 2026 pe baza documentației xAI: reducerea pentru loturi este de 20% la modelele de text eligibile (nu 50%), exemplele urmează API-ul REST și SDK-ul oficial xai-sdk (client.batch.*; API-ul Batch de la xAI nu folosește formatul OpenAI, iar SDK-ul OpenAI nu se aplică), iar API-ul Responses are prioritate față de Chat Completions, un endpoint învechit la xAI. Surse: Batch API · Referință REST · Prețuri Batch.

Îmbogățirea loturilor cu instrumente

Cererile în lot nu se limitează la text brut. Instrumentele de server și apelarea funcțiilor funcționează și în mod asincron, cu o distincție esențială: primele rulează în timpul procesării de către xAI, în timp ce cele din urmă vă returnează controlul dumneavoastră.

Instrumente lato parte de server

Instrumentele de server rulează în timpul procesării lotului, exact ca în timp real: Grok apelează instrumentul, primește rezultatul, îl integrează în raționamentul său, iar lotul returnează răspunsul final. Acestea funcționează cu API-ul Responses.

Căutare web

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

În modul lot, căutarea web servește la îmbogățirea datelor: verificarea informațiilor, colectarea faptelor recente, compararea profilurilor cu surse online.

Căutare X

Instrumentul x_search interoghează postările de pe X, fiind util pentru urmărirea sentimentului față de un subiect sau un brand:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Executarea codului

Grok poate scrie și executa cod Python într-un mediu izolat. În API-ul Responses, instrumentul se numește code_interpreter (SDK-ul xAI îl numește code_execution):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

Executarea codului este relevantă pentru calcule exacte, statistici și transformări de date pe care modelul le-ar gestiona mai puțin fiabil din memorie.

Servere MCP la distanță

Instrumentul mcp conectează Grok la un server MCP la distanță, descris chiar în cerere: nu este necesară nicio configurare prealabilă a contului. server_url și server_label sunt obligatorii; allowed_tools restricționează instrumentele expuse, iar authorization transmite un token către server. Sunt acceptate doar transporturile Streamable HTTP și SSE.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Fără allowed_tools, toate definițiile de instrumente de la server sunt injectate în contextul modelului și facturate ca tokeni de intrare la fiecare cerere din lot: la 50.000 de cereri, restricționarea listei devine rapid rentabilă.

Apelarea funcțiilor lato parte de client

Apelarea funcțiilor este un instrument lato parte de client: Grok produce un apel de funcție structurat, dar codul dumneavoastră îl execută. În lot, modelul returnează aceste apeluri în rezultatele sale, pentru procesare offline.

Definirea funcțiilor

În API-ul Responses, declarați funcția la nivel superior, cu name, description și parameters. tool_choice: "required" forțează modelul să apeleze cel puțin un instrument, ceea ce se potrivește extragerii:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Procesarea rezultatelor

Cu SDK-ul, citiți apelurile de funcții din tool_calls ale fiecărui rezultat reușit:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

Apelarea funcțiilor în lot este ideală pentru extragerea structurată: definiți schema datelor, Grok citește documentele și produce apelurile, apoi le procesați în bloc.

Combinarea instrumentelor

Puteți combina mai multe instrumente de server într-o singură cerere:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

Grok utilizează instrumentele în ordinea pe care o consideră relevantă: aici, căutarea web pentru a obține datele, apoi executarea codului pentru calcul.

Limitările instrumentelor în lot

  • Instrumentele de server extind timpul de procesare al fiecărei cereri și, prin urmare, al lotului
  • Cererile cu căutare depind de ceea ce publică sursele la momentul procesării, nu la momentul trimiterii
  • Apelarea funcțiilor face doar o singură dus-întors per cerere: pentru a continua, trimiteți o nouă cerere în lot care să conțină conversația și rezultatele funcției dumneavoastră
  • Definițiile de instrumente MCP nefiltrate umflă fiecare cerere

Puncte cheie

  • Instrumentele de server (web, X, cod, MCP) rulează prin xAI în timpul procesării, prin API-ul Responses
  • Descrieți un server MCP în cerere (server_url, server_label), fără configurare prealabilă
  • Apelarea funcțiilor returnează apeluri structurate pe care le executați lato parte de client
  • Un schimb multi-tur necesită o nouă cerere în lot per tur
  • Restricționați instrumentele expuse pentru a evita plata definițiilor lor la fiecare cerere