Għodod integrati: tfittxija fuq il-web, X, u kollezzjonijiet
F'din il-paġna
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.
Każijiet ta’ użu ta’ x_search
- 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, umcp. - 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_searchtistaqsi kollezzjonijiet vettorjali għal RAG.x_searchtista’ 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.