fix(search,core): Skip vector indexing when no embedding profile is configured

Add HasDefaultProfileAsync to IAIProfileService so callers can check
for a configured default profile without catching exceptions. Refactors
GetDefaultProfileAsync to share resolution logic via TryGetDefaultProfileAsync.

AIVectorIndexer now checks for a default embedding profile before
attempting to index. On a fresh install with no profile configured,
indexing is skipped with a debug log instead of throwing
InvalidOperationException and cascading into SQLite errors.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mattbrailsford

Umbraco.AI.Search/src/Umbraco.AI.Search.Core/Search/AIVectorIndexer.cs

@@ -3,6 +3,8 @@
 using Microsoft.Extensions.Options;
 
 using Umbraco.AI.Core.Embeddings;
+using Umbraco.AI.Core.Models;
+using Umbraco.AI.Core.Profiles;
 using Umbraco.AI.Search.Core.Chunking;
 using Umbraco.AI.Search.Core.Configuration;
 using Umbraco.AI.Search.Core.VectorStore;
@@ -23,19 +25,22 @@ namespace Umbraco.AI.Search.Core.Search;
 public sealed class AIVectorIndexer : IIndexer
 {
     private readonly IAIVectorStore _vectorStore;
+    private readonly IAIProfileService _profileService;
     private readonly IAIEmbeddingService _embeddingService;
     private readonly IAITextChunker _textChunker;
     private readonly IOptions<AIVectorSearchOptions> _options;
     private readonly ILogger<AIVectorIndexer> _logger;
 
     public AIVectorIndexer(
         IAIVectorStore vectorStore,
+        IAIProfileService profileService,
         IAIEmbeddingService embeddingService,
         IAITextChunker textChunker,
         IOptions<AIVectorSearchOptions> options,
         ILogger<AIVectorIndexer> logger)
     {
         _vectorStore = vectorStore;
+        _profileService = profileService;
         _embeddingService = embeddingService;
         _textChunker = textChunker;
         _options = options;
@@ -51,6 +56,14 @@ public async Task AddOrUpdateAsync(
         IEnumerable<IndexField> fields,
         ContentProtection? protection)
     {
+        // On a fresh install, no embedding profile exists yet — skip indexing
+        // until the administrator configures one.
+        if (!await _profileService.HasDefaultProfileAsync(AICapability.Embedding))
+        {
+            _logger.LogDebug("No default embedding profile configured, skipping vector indexing for {IndexAlias}", indexAlias);
+            return;
+        }
+
         var documentId = id.ToString("D");
 
         // Group fields by culture to generate separate embeddings per language variant.

Umbraco.AI.Search/tests/Umbraco.AI.Search.Tests.Unit/Search/AIVectorIndexerTests.cs

@@ -4,6 +4,8 @@
 using Moq;
 using Shouldly;
 using Umbraco.AI.Core.Embeddings;
+using Umbraco.AI.Core.Models;
+using Umbraco.AI.Core.Profiles;
 using Umbraco.AI.Search.Core.Chunking;
 using Umbraco.AI.Search.Core.Configuration;
 using Umbraco.AI.Search.Core.Search;
@@ -19,6 +21,7 @@ public class AIVectorIndexerTests
     private const string IndexAlias = "test-index";
 
     private readonly InMemoryAIVectorStore _store = new();
+    private readonly Mock<IAIProfileService> _profileServiceMock = new();
     private readonly Mock<IAIEmbeddingService> _embeddingServiceMock = new();
     private readonly Mock<IAITextChunker> _chunkerMock = new();
     private readonly AIVectorIndexer _indexer;
@@ -46,8 +49,14 @@ public AIVectorIndexerTests()
                 return new GeneratedEmbeddings<Embedding<float>>(embeddings);
             });
 
+        // Default: embedding profile is configured
+        _profileServiceMock
+            .Setup(p => p.HasDefaultProfileAsync(AICapability.Embedding, It.IsAny<CancellationToken>()))
+            .ReturnsAsync(true);
+
         _indexer = new AIVectorIndexer(
             _store,
+            _profileServiceMock.Object,
             _embeddingServiceMock.Object,
             _chunkerMock.Object,
             options,

Umbraco.AI/src/Umbraco.AI.Core/Profiles/AIProfileService.cs

@@ -60,9 +60,40 @@ public async Task<IEnumerable<AIProfile>> GetProfilesAsync(
         CancellationToken cancellationToken = default)
         => _repository.GetPagedAsync(filter, capability, skip, take, cancellationToken);
 
+    public async Task<bool> HasDefaultProfileAsync(
+        AICapability capability,
+        CancellationToken cancellationToken = default)
+    {
+        var profile = await TryGetDefaultProfileAsync(capability, cancellationToken);
+        return profile is not null;
+    }
+
     public async Task<AIProfile> GetDefaultProfileAsync(
         AICapability capability,
         CancellationToken cancellationToken = default)
+    {
+        var profile = await TryGetDefaultProfileAsync(capability, cancellationToken);
+        if (profile is not null)
+        {
+            return profile;
+        }
+
+        // Produce a specific error message depending on what's missing
+        var alias = capability switch
+        {
+            AICapability.Chat => _options.DefaultChatProfileAlias,
+            AICapability.Embedding => _options.DefaultEmbeddingProfileAlias,
+            _ => null
+        };
+
+        throw alias is not null
+            ? new InvalidOperationException($"Default {capability} profile with alias '{alias}' not found.")
+            : new InvalidOperationException($"Default {capability} profile is not configured.");
+    }
+
+    private async Task<AIProfile?> TryGetDefaultProfileAsync(
+        AICapability capability,
+        CancellationToken cancellationToken)
     {
         // 1. Try database settings first
         var settings = await _settingsService.GetSettingsAsync(cancellationToken);
@@ -92,16 +123,10 @@ public async Task<AIProfile> GetDefaultProfileAsync(
 
         if (defaultProfileAlias is null)
         {
-            throw new InvalidOperationException($"Default {capability} profile is not configured.");
-        }
-
-        var profileByAlias = await _repository.GetByAliasAsync(defaultProfileAlias, cancellationToken);
-        if (profileByAlias is null)
-        {
-            throw new InvalidOperationException($"Default {capability} profile with alias '{defaultProfileAlias}' not found.");
+            return null;
         }
 
-        return profileByAlias;
+        return await _repository.GetByAliasAsync(defaultProfileAlias, cancellationToken);
     }
 
     public async Task<AIProfile> GetClassifierProfileAsync(

Umbraco.AI/src/Umbraco.AI.Core/Profiles/IAIProfileService.cs

@@ -55,6 +55,14 @@ public interface IAIProfileService
         int take = 100,
         CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Checks whether a default profile is configured and exists for the specified capability.
+    /// </summary>
+    /// <param name="capability">The capability.</param>
+    /// <param name="cancellationToken">Cancellation token.</param>
+    /// <returns>True if a default profile is configured and exists, false otherwise.</returns>
+    Task<bool> HasDefaultProfileAsync(AICapability capability, CancellationToken cancellationToken = default);
+
     /// <summary>
     /// Gets the default profile for the specified capability.
     /// </summary>