Вградени инструменти: уеб търсене, X и колекции
На тази страница
Нативни инструменти на гласовия агент
В допълнение към извикването на персонализирани функции и сървърите MCP, API на гласовия агент предоставя няколко вградени инструмента, които агентът може да използва самостоятелно по време на разговора. Тези инструменти не изискват никаква логика за изпълнение от Ваша страна: сървърите на xAI се грижат за тях изцяло.
web_search: търсене в уеб
Този инструмент позволява на агента да търси информация в уеб в реално време по време на разговора:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Когато потребителят зададе фактологичен въпрос („Какво е времето в Париж?“, „Кой спечели мача снощи?“), агентът автоматично извършва уеб търсене и използва резултатите, за да състави своя гласов отговор.
За вградените инструменти не се изпраща конкретно събитие към клиента: агентът използва резултатите вътрешно и ги интегрира в своя аудио отговор.
x_search: търсене в X (Twitter)
Този инструмент позволява на агента да търси публикации в платформата X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Параметърът allowed_x_handles е незадължителен. Когато е зададен, търсенето се ограничава до публикации от тези конкретни акаунти. Без него агентът търси в цялото пространство на X.
Сценарии за използване на x_search
- Мониторинг на конкуренцията: „Какво публикува [конкурентът] тази седмица?“
- Поддръжка на клиенти: „Има ли скорошни оплаквания за нашия продукт в X?“
- Новини: „Какво е най-новото по темата [тема]?“
- Тенденции: „За какво говорят хората в момента в [индустрия]?“
file_search: търсене в RAG колекции
Инструментът file_search позволява на гласовия агент да прави заявки към колекции от векторизирани документи (RAG). Това е идеалният инструмент за агенти, които се нуждаят от достъп до вътрешна база знания:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Параметри
vector_store_ids: идентификаторите на векторните колекции, към които да се направи заявка. Можете да изброите няколко, за да комбинирате различни източници на знания.max_num_results: максималният брой резултати за връщане (по подразбиране 10).
Сценарии за употреба
- Гласови ЧЗВ: агентът отговаря на въпроси на клиенти въз основа на Вашата документация.
- Техническа поддръжка: търсене в ръководства и упътвания за отстраняване на неизправности.
- Обучение: агентът има достъп до съдържанието на курса, за да отговаря на въпроси на обучаващите се.
- Правна помощ: търсене в договори и правни документи.
Комбиниране на няколко инструмента
Можете да активирате няколко инструмента едновременно. Агентът избира най-подходящия въз основа на контекста на разговора:
{
"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"
}
]
}
}
В този пример агентът може:
- Да търси в уеб за общи въпроси
- Да проверява X за тенденции и мнения
- Да навлиза във вътрешната документация за технически въпроси
- Да създаде тикет чрез извикване на функция
- Да получи достъп до CRM чрез MCP
Ключови изводи
- Налични са пет типа инструменти:
web_search,x_search,file_search,functionиmcp - Вградените инструменти (
web_search,x_search,file_search) се изпълняват на сървъра без никакъв код от Ваша страна file_searchправи заявки към векторни колекции за RAGx_searchможе да бъде ограничен до конкретни акаунти чрезallowed_x_handles- Можете да комбинирате всеки тип инструмент в рамките на една и съща сесия