← Обзор / ai-search / concepts

Пространства имён

Каждый экземпляр AI Search относится к пространство имён. Пространство имён представляет собой логическую группировку экземпляров в рамках вашего аккаунта.

Типичные причины использования пространств имён:

• Разделение доменов: Разделяйте экземпляры по областям продукта, например blog, support, а также docs.
• Изоляция тенантов: Назначьте каждому тенанту собственное пространство имён, чтобы имена экземпляров не пересекались между тенантами.
• Изоляция агента: Выделяйте каждому агенту собственное пространство имён для независимого управления контекстом.

Пошаговое руководство по изоляции поиска для каждого тенанта см. в Мультитенантность.

Для привязки пространства имён требуются следующие минимальные версии пакетов для типов TypeScript и поддержки локальной разработки.

Когда вы добавляете ai_search_namespaces привязку в конфигурацию Wrangler вы указываете, к какому пространству имён у неё есть доступ. Привязка предоставляет полный доступ ко всем экземплярам в этом пространстве имён. Во время выполнения вы можете получать, перечислять, создавать и удалять экземпляры.

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "ai_search_namespaces": [
    {
      "binding": "AI_SEARCH",
      "namespace": "my-namespace"
    }
  ]
}

[[ai_search_namespaces]]
binding = "AI_SEARCH"
namespace = "my-namespace"

Во время выполнения, env.AI_SEARCH это хендл пространства имён. Используйте env.AI_SEARCH.get("my-instance") и получить доступ к конкретному инстансу:

const instance = env.AI_SEARCH.get("my-instance");
const results = await instance.search({
	messages: [{ role: "user", content: "How does caching work?" }],
});

get() метод синхронный и не выполняет сетевой вызов. Экземпляр разрешается лениво, когда вы вызываете такой метод, как search() или chatCompletions().

A default пространство имён автоматически создаётся для каждого аккаунта. Если вам не нужно несколько пространств имён, используйте default для всех ваших экземпляров.

Вы также можете привязываться напрямую к конкретным экземплярам в пространстве имён по умолчанию с помощью ai_search привязка. Она привязывает каждую запись к одному уже существующему экземпляру без необходимости вызывать get().

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "ai_search": [
    {
      "binding": "PROD_SEARCH",
      "instance_name": "production"
    },
    {
      "binding": "STAGING_SEARCH",
      "instance_name": "staging"
    }
  ]
}

[[ai_search]]
binding = "PROD_SEARCH"
instance_name = "production"

[[ai_search]]
binding = "STAGING_SEARCH"
instance_name = "staging"

ai_search привязка предоставляет те же методы экземпляра (search(), chatCompletions(), info(), stats(), items) но не поддерживает операции на уровне пространства имён, такие как list(), create(), или delete().

Вы можете объявить несколько привязок пространства имён в одном Worker. Каждая привязка сопоставляется с отдельным пространством имён и обеспечивает изолированный доступ к его экземплярам.

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "ai_search_namespaces": [
    {
      "binding": "BLOG_SEARCH",
      "namespace": "blog"
    },
    {
      "binding": "SUPPORT_SEARCH",
      "namespace": "support"
    }
  ]
}

[[ai_search_namespaces]]
binding = "BLOG_SEARCH"
namespace = "blog"

[[ai_search_namespaces]]
binding = "SUPPORT_SEARCH"
namespace = "support"

Пространство имён может предоставлять собственную публичную /search, /chat/completions, а также /mcp эндпойнты. Один URL выполняет поиск сразу по выбранным вами экземплярам в этом пространстве имён и объединяет результаты.

См. Публичные конечные точки пространства имён.

Имя экземпляра должно быть уникальным в пределах пространства имён. Это значит, что у вас может быть экземпляр с именем docs как в blog и support пространств имён без конфликтов.