Derinkite MCP ir integruotus įrankius
Šiame puslapyje
Dvi įrankių šeimos, vienas katalogas
MCP nėra vienintelis būdas suteikti Grok naujų galimybių. xAI API turi savų, integruotų įrankių, kuriuos modelis gali iškviesti nenaudodamas jokių išorinių serverių. Tau nereikia rinktis tarp šių dviejų šeimų: jas deklaruoji toje pačioje vietoje ir laisvai derini vienoje konfigūracijoje.
Keturi integruoti įrankiai padengia daugumą poreikių.
- Web search: paieška internete realiuoju laiku
- Code execution: Python kodo vykdymas izoliuotoje („smėlio dėžės“) aplinkoje
- Image analysis: vaizdų analizė ir aprašymas
- File parsing: failų turinio skaitymas ir duomenų išgavimas
Juos deklaruoji masyve tools nurodydamas tik tipą, be URL ar etiketės – tai logiška, nes nėra nuotolinio serverio, kurį reikėtų nurodyti.
Maišymas: nieko naujo mokytis nereikia
Sintaksė nereikalauja jokių specialių konstrukcijų. MCP objektus ir integruotus objektus tiesiog dedame greta tame pačiame masyve.
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=[
# Nuotolinis MCP įrankis
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentation for GitHub projects"
),
# Integruotas įrankis: paieška internete
{"type": "web_search"},
],
)
„Responses“ API, naudojantis OpenAI formatu, veikia pagal tą pačią logiką, tik MCP įrankis įgauna tipizuoto žodyno formą.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{"role": "user", "content": "Compare React and Vue based on the official docs and current trends"}],
tools=[
{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki"
},
{"type": "web_search"},
],
)
Orkestracija vyksta automatiškai
Modelio požiūriu, MCP ir integruoti įrankiai sudaro vieną bendrą katalogą. Grok nedaro skirtumo tarp įrankio, kuris siunčia užklausą per tinklą į trečiosios šalies serverį, ir to, kurį vykdo xAI infrastruktūra: jis mato tik galimybes, jų pavadinimus ir aprašymus, bei pasirenka tą, kuri kiekviename žingsnyje geriausiai padeda suformuluoti atsakymą.
Paimkime užklausą „palygink maršrutizavimo konfigūraciją Next.js su dabartinėmis geriausiomis praktikomis“. Grok pirmiausia iškviečia deepwiki__search, kad perskaitytų maršrutizavimo dokumentaciją Next.js saugykloje, tada web_search, kad rastų naujausius straipsnius apie dabartines praktikas, ir galiausiai apibendrina abu šaltinius į nuoseklų atsakymą. Tu niekada nenurodei šios eiliškumo tvarkos ar net to, kad šie du įrankiai turėtų būti naudojami kartu. Modelis pats nusprendžia seką, tau nereikia rašyti jokios orkestracijos logikos.
Dvi tipinės kompozicijos
Techninių tyrimų agentas naudoja etaloninę dokumentaciją, prieigą prie interneto ir kodo tikrinimo galimybes.
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentation and source code for GitHub projects"
),
{"type": "web_search"},
{"type": "code_interpreter"},
]
Šis trejetas leidžia konsultuotis su projekto dokumentacija, ieškoti papildomos informacijos internete ir tada vykdyti kodą sprendimui patikrinti prieš jį siūlant. Trečiasis įrankis keičia atsakymo pobūdį: vietoj to, kad tvirtintų, jog kodas veikia, agentas tai patikrina.
Vidinis techninis asistentas veikia pagal kitą logiką, kur du privatūs serveriai saugo įmonės žinias, o internetas tarnauja tik kaip atsarginis variantas.
tools = [
mcp(
server_url="https://kb.monentreprise.com/mcp",
server_label="kb",
server_description="Internal knowledge base",
authorization=f"Bearer {os.getenv('KB_TOKEN')}"
),
mcp(
server_url="https://jira.monentreprise.com/mcp",
server_label="jira",
server_description="Jira tickets and projects",
authorization=f"Bearer {os.getenv('JIRA_TOKEN')}",
allowed_tool_names=["search_issues", "get_issue"]
),
{"type": "web_search"},
]
Asistentas ieško žinių bazėje, konsultuojasi su susijusiais „Jira“ bilietais ir papildo informaciją paieška internete, jei viduje jos trūksta. Atkreipk dėmesį į „Jira“ apribojimą – tik skaitymo teisės: be jo, kenkėjiška instrukcija, įterpta į bilieto turinį, galėtų pastūmėti modelį atlikti rašymo operaciją.
Paslėpta gausos kaina
Kiekvienas pridėtas įrankis, nesvarbu, MCP ar integruotas, užima vietos konteksto lange savo apibrėžimui saugoti. Todėl dosni konfigūracija kainuoja tau laisvos vietos pokalbiui, apdorojimo laiko ir pasirinkimo tikslumo.
Užtenka trijų įpročių, kad tai suvaldytum. Apribok bendrą įrankių skaičių ir nepasiduok pagundai prijungti penkis serverius su penkiasdešimčia įrankių, kai tavo naudojimui užtenka dešimties. Kiekviename MCP serveryje taikyk allowed_tool_names, kad paliktum tik reikalingus įrankius. Ir nepridėk integruoto įrankio „tik tuo atveju“: jei tavo agentui nėra priežasties vykdyti kodo, code_interpreter nėra nemokama opcija – tai suvartotas kontekstas ir papildoma galimybė pasirinkti netinkamą įrankį.
Svarbiausi punktai
- MCP įrankiai ir integruoti įrankiai (paieška internete, kodo vykdymas) egzistuoja kartu tame pačiame masyve
tools - Grok automatiškai orkestruoja kvietimus tarp MCP ir integruotų įrankių pagal užklausą
- Derinys leidžia kurti galingus agentus, kurie naudoja tiek vidinius šaltinius (MCP), tiek išorinius šaltinius (paieška internete)
- Apribok bendrą įrankių skaičių, kad išsaugotum kontekstą ir modelio tikslumą
- Naudok
allowed_tool_nameskiekvienam MCP serveriui, kad sumažintum triukšmą