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

Combinarea instrumentelor MCP cu cele native

Lecția 10 din 12 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Două familii de instrumente, un singur catalog
  2. Combinarea lor: nimic nou de învățat
  3. Orhestrarea are loc automat
  4. Două compoziții tipice
  5. Costul ascuns al abundenței
  6. Puncte cheie

Două familii de instrumente, un singur catalog

MCP nu este singura modalitate de a oferi capacități modelului Grok. API-ul xAI include instrumente native, numite „instrumente integrate“ (built-in tools), pe care modelul le poate apela fără a implica niciun server extern. Nu trebuie să alegeți între cele două familii: le declarați în același loc și le combinați liber într-o singură configurație.

Patru instrumente native acoperă majoritatea nevoilor.

  • Căutare web: căutare în timp real pe internet
  • Execuție de cod: rularea codului Python într-un mediu izolat (sandbox)
  • Analiză de imagine: analiză și descriere a imaginilor
  • Parcurgere de fișiere: citirea și extragerea conținutului fișierelor

Le declarați în tabloul tools doar prin tipul lor, fără URL sau etichetă – ceea ce este logic, deoarece nu există un server la distanță de desemnat.

Combinarea lor: nimic nou de învățat

Sintaxa nu necesită nicio construcție specială. Plasați obiectele MCP și obiectele native alăturate, în același tablou.

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=[
        # Instrument MCP la distanță
        mcp(
            server_url="https://mcp.deepwiki.com/mcp",
            server_label="deepwiki",
            server_description="Documentation for GitHub projects"
        ),
        # Instrument nativ: căutare web
        {"type": "web_search"},
    ],
)

API-ul Responses, în format OpenAI, urmează aceeași logică, instrumentul MCP luând pur și simplu forma sa de dicționar tipizat.

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

Orhestrarea are loc automat

Din perspectiva modelului, instrumentele MCP și cele native formează un singur catalog. Grok nu face distincție între un instrument care traversează rețeaua către un server terț și unul executat de infrastructura xAI: el vede capacități, cu nume și descrieri, și îl selectează pe cel care avansează răspunsul la fiecare pas.

Luați interogarea „compară configurarea rutării în Next.js cu cele mai bune practici actuale“. Grok apelează mai întâi deepwiki__search pentru a citi documentația despre rutare din repository-ul Next.js, apoi web_search pentru a găsi articole recente despre practici curente și, în final, sintetizează ambele surse într-un răspuns coerent. În niciun moment nu ați specificat această ordine, nici măcar faptul că aceste două instrumente trebuie utilizate împreună. Modelul decide singur secvența, iar dumneavoastră nu aveți nicio logică de orchestrare de scris.

Două compoziții tipice

Un agent de cercetare tehnică valorifică documentația de referință, accesul la web și capacitățile de verificare a codului.

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"},
]

Acest trio vă permite să consultați documentația proiectului, să căutați informații suplimentare online și apoi să executați cod pentru a valida o soluție înainte de a o propune. Al treilea instrument schimbă natura răspunsului: în loc să afirme că un fragment de cod funcționează, agentul îl verifică.

Un asistent tehnic intern urmează o logică diferită, unde două servere private dețin cunoștințele companiei, iar web-ul servește doar ca rezervă.

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"},
]

Asistentul caută în baza de cunoștințe, consultă tichetele Jira aferente și completează cu o căutare pe web dacă informațiile lipsesc intern. Observați restricția privind Jira, limitată la accesul read-only: fără aceasta, o instrucțiune malițioasă strecurată în corpul unui tichet ar putea împinge modelul către o operație de scriere.

Costul ascuns al abundenței

Fiecare instrument adăugat, fie el MCP sau nativ, ocupă spațiu în fereastra de context pentru a stoca definiția sa. O configurație generoasă vă costă, prin urmare, spațiu disponibil pentru conversație, timp de procesare și precizia selecției.

Trei obiceiuri sunt suficiente pentru a menține acest lucru sub control. Limitați numărul total de instrumente și rezistați tentației de a conecta cinci servere cu cincizeci de instrumente atunci când cazul dumneavoastră de utilizare necesită zece. Aplicați allowed_tool_names pe fiecare server MCP pentru a păstra doar instrumentele relevante. Și nu adăugați un instrument nativ „doar în caz de nevoie“: dacă agentul dumneavoastră nu are niciun motiv să execute cod, code_interpreter nu este o opțiune gratuită; consumă context și reprezintă o oportunitate suplimentară de a alege instrumentul greșit.

Puncte cheie

  • Instrumentele MCP și cele native (căutare web, execuție de cod) coexistă în același tablou tools
  • Grok orchestrează automat apelurile între instrumentele MCP și cele native în funcție de interogare
  • Combinația vă permite să creați agenți puternici care valorifică atât sursele interne (MCP), cât și pe cele externe (căutare web)
  • Limitați numărul total de instrumente pentru a prezerva contextul și acuratețea modelului
  • Utilizați allowed_tool_names pentru fiecare server MCP pentru a reduce zgomotul