Премини към основното съдържание
Български— Изберете език
Меню

Вградени инструменти: уеб търсене, X и колекции

Урок 14 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Нативни инструменти на гласовия агент
  2. web_search: търсене в уеб
  3. x_search: търсене в X (Twitter)
  4. file_search: търсене в RAG колекции
  5. Комбиниране на няколко инструмента
  6. Ключови изводи

Нативни инструменти на гласовия агент

В допълнение към извикването на персонализирани функции и сървърите 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?“
  • Новини: „Какво е най-новото по темата [тема]?“
  • Тенденции: „За какво говорят хората в момента в [индустрия]?“

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 прави заявки към векторни колекции за RAG
  • x_search може да бъде ограничен до конкретни акаунти чрез allowed_x_handles
  • Можете да комбинирате всеки тип инструмент в рамките на една и съща сесия