Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodod integrati: tfittxija fuq il-web, X, u kollezzjonijiet

Lezzjoni 14 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-għodod nattivi tal-Aġent Vuwkali
  2. web_search: ifittex fuq il-web
  3. x_search: ifittex fuq X (Twitter)
  4. file_search: ifittex fil-kollezzjonijiet RAG
  5. Għaqqad diversi għodod
  6. Punti Ewlenin

L-għodod nattivi tal-Aġent Vuwkali

Barra s-sejħa ta’ funzjonijiet personalizzati u s-servers MCP, l-API tal-Aġent Vuwkali tipprovdi diversi għodod integrati li l-aġent jista’ juża waħdu matul il-konversazzjoni. Dawn l-għodod ma jeħtiġu l-ebda loġika ta’ eżekuzzjoni min-naħa tiegħek: is-servers ta’ xAI jittrattawhom kompletament.

web_search: ifittex fuq il-web

Din l-għodda tippermetti lill-aġent ifittex informazzjoni fuq il-web f’ħin reali matul il-konversazzjoni:

{
  "type": "session.update",
  "session": {
    "tools": [
      {"type": "web_search"}
    ]
  }
}

Meta l-utent jagħmel mistoqsija fattwali (“X’inhu t-temp f’Pariġi?”, “Min rebaħ il-logħba ilbieraħ?”), l-aġent iwettaq tfittxija fuq il-web awtomatikament u juża r-riżultati biex jifformola t-tweġiba verbali tiegħu.

L-ebda avveniment speċifiku ma jintbagħat lill-klijent għall-għodod integrati: l-aġent juża r-riżultati internament u jinkorporahom fir-rispons awdjo tiegħu.

x_search: ifittex fuq X (Twitter)

Din l-għodda tippermetti lill-aġent ifittex posts fuq il-pjattaforma X:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "x_search",
        "allowed_x_handles": ["xai", "gaborcselle"]
      }
    ]
  }
}

Il-parametru allowed_x_handles huwa fakultattiv. Meta jiġi stabbilit, it-tiftix ikun limitat għal posts minn dawk il-kontijiet speċifiċi. Mingħajru, l-aġent ifittex fuq X kollu kemm hu.

  • Monitoraġġ kompetittiv: “X’ippostja [kompetitur] din il-ġimgħa?”
  • Appoġġ lill-klijenti: “Hemm xi lmenti riċenti dwar il-prodott tagħna fuq X?”
  • Aħbarijiet: “X’inhu l-aħħar dwar [suġġett]?”
  • Xejriet: “Dwar xiex qed jitkellmu n-nies bħalissa fis-settur [industrija]?“

file_search: ifittex fil-kollezzjonijiet RAG

L-għodda file_search tippermetti lill-aġent vokali jistaqsi kollezzjonijiet ta’ dokumenti vettorizzati (RAG). Hija l-għodda ideali għal aġenti li jeħtieġu aċċess għal bażi ta’ għarfien interna:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123", "vs_def456"],
        "max_num_results": 10
      }
    ]
  }
}

Parametri

  • vector_store_ids: l-IDs tal-kollezzjonijiet vettorjali li trid tistaqsi. Tista’ telenka diversi biex tgħaqqad sorsi differenti ta’ għarfien.
  • max_num_results: in-numru massimu ta’ riżultati li għandhom jintbagħtu (10 b’mod predefinit).

Xenarji ta’ użu

  • FAQ vokali: l-aġent iwieġeb mistoqsijiet tal-klijenti abbażi tad-dokumentazzjoni tiegħek.
  • Appoġġ tekniku: tfittxija f’manwali u gwidi għas-soluzzjoni ta’ problemi.
  • Taħriġ: l-aġent ikollu aċċess għall-kontenut tal-kors biex iwieġeb mistoqsijiet tal-apprendisti.
  • Assistenza legali: tfittxija f’kuntratti u dokumenti legali.

Għaqqad diversi għodod

Tista’ tattivaw diversi għodod fl-istess ħin. L-aġent jagħżel l-aktar waħda rilevanti abbażi tal-kuntest tal-konversazzjoni:

{
  "type": "session.update",
  "session": {
    "tools": [
      {"type": "web_search"},
      {"type": "x_search"},
      {
        "type": "file_search",
        "vector_store_ids": ["vs_documentation"]
      },
      {
        "type": "function",
        "name": "create_ticket",
        "description": "Creates a support ticket",
        "parameters": {
          "type": "object",
          "properties": {
            "subject": {"type": "string"},
            "priority": {"type": "string", "enum": ["low", "medium", "high"]}
          },
          "required": ["subject"]
        }
      },
      {
        "type": "mcp",
        "server_url": "https://mcp.exemple.com/sse",
        "server_label": "CRM"
      }
    ]
  }
}

F’dan l-eżempju, l-aġent jista’:

  • Ifittex fuq il-web għal mistoqsijiet ġenerali
  • Jiċċekkja X għal xejriet u opinjonijiet
  • Jfittex fid-dokumentazzjoni interna għal mistoqsijiet tekniċi
  • Joħloq tikketta permezz tas-sejħa ta’ funzjoni
  • Jaċċessa s-CRM permezz ta’ MCP

Punti Ewlenin

  • Hemm ħames tipi ta’ għodod disponibbli: web_search, x_search, file_search, function, u mcp.
  • L-għodod integrati (web_search, x_search, file_search) jaħdmu fuq is-server mingħajr ebda kodiċi min-naħa tiegħek.
  • file_search tistaqsi kollezzjonijiet vettorjali għal RAG.
  • x_search tista’ tiġi limitata għal kontijiet speċifiċi bl-użu ta’ allowed_x_handles.
  • Tista’ tgħaqqad kull tip ta’ għodda fl-istess sessjoni.