Azure AI Search

Connect Azure AI Search to Odeus to run semantic vector searches over your indexed documents

Overview

Azure AI Search is Microsoft's AI-powered information retrieval platform. Once connected, you can perform semantic vector searches across your indexed documents directly from Odeus conversations.

Authentication: API Key Category: Vector Database Availability: All workspace plans

Prerequisites

Before setting up the integration, make sure you have:

• An Azure subscription with access to Azure AI Search
• An Azure AI Search service instance with at least one index
• An admin API key for your Azure AI Search service
• Documents uploaded to your index with vector embeddings

If you are new to Azure AI Search, see Microsoft's Vector Search documentation to set up your first index with vector search support.

Setup

In Odeus, go to [Integrations](https://app.odeus.ai/integrations) and find **Azure AI Search** in the integrations list.



Fill in the required configuration fields (see the [table below](#configuration-parameters)).



Save the integration — Odeus will validate that your index exists and is accessible.



Tag the integration with `@` in any agent or add the **Search documents** action to your agent to search your indexed documents.

Configuration Parameters

Required Fields

Field	Description	Example
Name	A name for this connection	Company Knowledge Base
API Key	Azure Portal → Settings → Keys → Generate a primary admin key	Your admin key
Index Name	The exact name of your Azure AI Search index	odeus-prod-company
URL	Your Azure AI Search service endpoint	https://my-service.search.windows.net
Search Field	The vector field name in your index schema	contentVector
Top K	Number of search results to retrieve	5

Optional Fields

Field	Description	Default
Embedding Model	Model used for embeddings (display only)	Ada v2
Select	Comma-separated fields to return	All fields
Filter	OData filter expression to narrow results	None

Where to find your credentials:

• Service URL: See Manage your Azure AI Search service — your endpoint is listed on the Overview page
• API Key: See Connect using API keys — Azure Portal → Settings → Keys → generate a primary admin key

Common Use Cases

• Enterprise Knowledge Search — Search across internal documentation, policies, and knowledge bases using natural language

• Research & Analysis — Find relevant research papers, reports, and data from large document collections

• Customer Support — Quickly retrieve product information, FAQs, and support articles to answer customer queries

• Content Discovery — Surface relevant content from archives, wikis, or document repositories

Troubleshooting

Issue	Cause	Solution
Index not found	Index name mismatch or doesn't exist	Verify the exact index name in Azure Portal matches your configuration (case-sensitive)
No search results	Vector field name incorrect or filter preventing output	Verify the vector field name matches your index schema, and check that any OData filter expression is not excluding all results
Low search scores	Embedding model mismatch	Ensure all documents use the same embedding model (e.g., text-embedding-ada-002)
Authentication failed	Invalid or expired API key	Copy a fresh admin key from Azure Portal → Keys

Validation checklist

• Service URL format: https://[service-name].search.windows.net
• Index name matches exactly (case-sensitive)
• Search field matches your vector field name (e.g., contentVector)
• Documents contain vector embeddings