Connect Azure AI Search to Gateco

Azure AI Search (formerly Azure Cognitive Search) is a fully managed cloud search service with built-in vector search, semantic ranking, and BM25 full-text search. Gateco connects to Azure AI Search as a Tier 2 connector — supporting vector, keyword, and hybrid search with native Azure RRF fusion — and adds identity-aware retrieval and vector database RBAC on top.

Step 1 — Create an Azure AI Search service

1. In the Azure Portal, search for "AI Search" and click Create.
2. Choose a resource group, region, and service name.
3. Select Basic pricing tier (or above).
4. Click Review + create → Create.
5. Note your service name (e.g. my-search-service) — not the full URL.

Step 2 — Create an index with a vector field

{
  "name": "my-docs",
  "fields": [
    { "name": "id", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "content", "type": "Edm.String", "searchable": true },
    { "name": "category", "type": "Edm.String", "filterable": true },
    {
      "name": "embedding",
      "type": "Collection(Edm.Single)",
      "dimensions": 1536,
      "vectorSearchProfile": "hnsw-profile"
    }
  ],
  "vectorSearch": {
    "profiles": [{ "name": "hnsw-profile", "algorithm": "hnsw-config" }],
    "algorithms": [{ "name": "hnsw-config", "kind": "hnsw" }]
  }
}

Step 3 — Get your service name and API key

1. In your search service → Keys, copy the Primary admin key.
2. Note your service name from the Overview page (not the full URL).

Step 4 — Add the connector in Gateco

1. Navigate to Connectors → Add connector → Azure AI Search.
2. Enter your service name and admin API key.
3. Click Test connection.
4. Click Save.

Troubleshooting