Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Välised tööriistad ja toetatud SDK-d

Õppetund 3 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Kolm sissepääsu samasse mehhanismi
  2. Native xAI SDK
  3. Responses API, OpenAI-ga ühilduv
  4. Voice Agent API
  5. Mis liideste lõikes ei muutu
  6. Peamised punktid

Kolm sissepääsu samasse mehhanismi

xAI pakub kaug-MCP-d kolme liidese kaudu. Need on suunatud erinevatele arendajatele: üks uutele projektidele, teine ümberkolitud projektidele ja kolmas konkreetsetele kasutuskontekstidele. MCP käitumine on kõigil kolmel juhul täpselt sama; muutuvad vaid konfiguratsiooni süntaks ja abivahendid. Sinu valik sõltub seega olemasolevast tehnoloogiarivist, mitte protokolli võimekusest.

Native xAI SDK

See on meetod, mida xAI soovitab. See pakub abifunktsiooni mcp(), mis koondab konfiguratsiooni üheks funktsioonikutsuks.

from xai_sdk import Client
from xai_sdk.tools import mcp

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[
        mcp(server_url="https://mcp.deepwiki.com/mcp")
    ],
    include=["verbose_streaming"],
)

Abifunktsioon mcp() aktsepteerib kõiki MCP konfiguratsiooni parameetreid – URL-i, silti, kirjeldust, lubatud tööriistu, autentimist – ja vormindab need API jaoks õigesti. See on kõige lühem süntaks ja mis veelgi olulisem, viis, kus sul on kõige väiksem tõenäosus vigu teha, kuna võtmenimed ja pesastamine hooldatakse sinu eest. Vali see tee uue projekti jaoks, millel pole ühilduvuspiiranguid, kiireks prototüüpimiseks ja alati, kui kasutad xAI-spetsiifilisi funktsioone, nagu ülal nähtav üksikasjalik voogedastus (verbose streaming).

Responses API, OpenAI-ga ühilduv

See liides aktsepteerib täpselt OpenAI API vormingut. See eksisteerib kindlal põhjusel: et meeskond, kes on juba kirjutanud oma rakenduse selles vormingus, ei peaks kõike ümber kirjutama, et proovida Grok-i. Muudatus piirdub API võtme ja baas-URL-iga.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{"role": "user", "content": "Explain the React project"}],
    tools=[{
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki",
    }],
)

Siin deklareeritakse MCP server kui element massiivis tools, tüübiga "mcp" ja parameetritega võtme-väärtuse paaridena samas objektis. Abifunktsiooni pole: kirjutad sõnastiku käsitsi, mis jätab rohkem ruumi trükiveale võtmenimes.

Sellel ühilduvusel on hind ja sa peaksid seda teadma enne, kui sellele midagi rajad. Kaks parameetrit, mis on saadaval natives SDK-s, pole siin kättesaadavad: require_approval, mis võimaldab nõuda inimlikku kinnitust enne MCP tööriista käivitamist, ja connector_id, mis haldab OpenAI ühendusi. Kui sinu agent tegeleb tundlike toimingutega ja lootsid käsitsi kinnitamisele, on see piirang takistuseks ja peaks suunama sind tagasi native xAI SDK juurde. Responses API jääb õigeks valikuks migratsiooniks OpenAI-lt ilma ümberkirjutamiseta, mitme pakkujaga projektide jaoks, kus vahetad Grok-i ja teiste mudelite vahel, ning meeskondadele, kes on selle vorminguga juba tuttavad.

Voice Agent API

Kolmas liides on loodud häälagentide jaoks. Tüüpiline stsenaarium on telefonikõne assistent, kes peab vestluse käigus konsulteerima teadmiste baasiga, kontrollima tellimuse staatust või pärima välissüsteemi – ilma et helistaja kogeks seletamatut vaikust.

MCP konfiguratsioon järgib sama vormingut nagu teistes SDK-des, samade parameetritega server_url, server_label ja teised. Erinevus seisneb selles, mis juhtub pärast tööriista kutsumist: tulemus integreeritakse häälesünteesi voogu, mitte ei renderdata tekstina. See kujundab viisi, kuidas kirjutad oma tööriistade kirjeldusi ja raamistad nende vastuseid, kuna kasutaja ei näe kunagi tabelit ega nimekirja – ta ainult kuuleb neid.

Mis liideste lõikes ei muutu

Sõltumata SDK-st on jada sama. Grok avastab MCP serveri poolt avaldatud tööriistad, valib päringule vastava, formuleerib kutse õigete parameetritega ja integreerib tulemuse oma vastusesse. Ükski kolmest liidesest ei tee mudelit tööriista valimisel osavamaks ega saamatumaks.

Seega peituvad erinevused mujal: süntaksi lühiduses, saadaolevates lisafunktsioonides – üksikasjalik voogedastus xAI SDK-s, vormingu ühilduvus Responses API-s, häälesüntees Voice Agentis – ja kahes OpenAI vormingust puuduvas parameetris. Otsusta nende kriteeriumide põhjal ja sa ei eksita.

Peamised punktid

  • Native xAI SDK koos mcp()-ga on kõige lihtsam ja täielikum meetod
  • Responses API (OpenAI vorming) hõlbustab migratsiooni, kuid ei toeta require_approval ega connector_id
  • Voice Agent API ühendab häälagendid MCP tööriistadega
  • MCP käitumine on kõigil kolmel juhul identne; muutub vaid süntaks
  • Tee valik oma olemasoleva tehnoloogiarivi ja konkreetsete vajaduste põhjal