Skip to main content

​
Overview

Azure AI Search is Microsoft’s AI-powered information retrieval platform. Through Langdock’s integration, you can perform semantic vector searches across your indexed documents directly from 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’re new to Azure AI Search, check out Microsoft’s Vector Search documentation to set up your first index with vector search support.

​
Setup

1

Navigate to Integrations

In Langdock, go to Integrations and find Azure AI Search in the integrations list.
2

Enter your credentials

Fill in the required configuration fields (see table below).
3

Test the connection

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

Start searching

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

​
Configuration Parameters

​
Required Fields

FieldDescriptionExample
API KeyAdmin key from Azure Portal → KeysYour admin key
Index nameThe exact name of your Azure AI Search indexcompany-knowledge
URLYour Azure AI Search service endpointhttps://my-service.search.windows.net
Search fieldThe vector field name in your index schemacontentVector
Top KNumber of search results to retrieve5
Embedding modelThe embedding model to use for vector searchAda v2

​
Optional Fields

FieldDescriptionDefault
Embedding dimensionDimension of your vector embeddings1536
SelectComma-separated list of fields to return from resultsAll fields
FilterOData filter expression to narrow results (e.g., Rating eq 3 and Category eq 'Motel')None
Where to find your credentials:
  • Service URL: Azure Portal → Your Search service → Overview → copy the Url field
  • API Key: Azure Portal → Your Search service → Keys → copy an admin key

​
Available Actions

​
Search documents

azure_ai_search.search_documents
Searches the database for the most relevant information based on the query provided Requires Confirmation: No Parameters:
  • query (VECTOR, Required)
Output: Returns the operation result

​
Troubleshooting

IssueCauseSolution
Index not foundIndex name mismatchVerify the exact index name in Azure Portal matches your configuration (case-sensitive)
No search resultsNo documents or invalid embeddingsConfirm documents are uploaded with valid embeddings in your vector field
Authentication failedInvalid or expired API keyCopy a fresh admin key from Azure Portal → Keys
Quick checklist:
  • Service URL format: https://[service-name].search.windows.net
  • Index name matches exactly (case-sensitive)
  • Search field matches your vector field name
  • Documents contain valid vector embeddings