1570 Support a configurable Ollama base URL in the AI Providers catalog

Ollama chat and embedding models built from the AI Providers catalog only
received an API key, so a custom Ollama server URL was ignored and the client
always hit the localhost default.

- ApplicationProperties: add bytechef.ai.provider.ollama.url as the config-level
  fallback for both chat and embedding.
- AiProviderFacade: store an optional url alongside the api key in the per-
  environment property map; resolve it (catalog -> config fallback); expose it on
  AiProviderDTO and AiDefaultModelWithApiKeyDTO; new getUrl / resolveUrl /
  getConfigUrl. Ollama needs no API key, so resolveWithApiKey no longer rejects a
  blank key for it.
- Catalog factories: createChatModel/createEmbeddingModel now thread a url into
  the connection parameters (OllamaConstants.URL) when present; callers and their
  delegate cache keys include the url.
- OllamaChatAction.CHAT_MODEL: read the response format optionally instead of
  requiring it, so the model can be built outside the ask action (e.g. the
  catalog) without a NullPointerException.
- REST: add url to the UpdateAiProviderRequest and AiProvider OpenAPI schemas
  (response url is not obfuscated) and regenerate.

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

Author: ivicac

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/main/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatClientResolverImpl.java

@@ -57,11 +57,14 @@ public CatalogChatClientResolverImpl(
 
         String apiKey = aiProviderFacade.getApiKey(provider.getKey(), environment);
 
-        if (apiKey == null || apiKey.isBlank()) {
+        // Ollama runs locally and needs no API key, so a blank key is valid for it; all other providers require one.
+        if ((apiKey == null || apiKey.isBlank()) && provider != Provider.OLLAMA) {
             return null;
         }
 
-        ChatModel chatModel = catalogChatModelFactory.createChatModel(provider, model, apiKey);
+        String url = aiProviderFacade.getUrl(provider.getKey(), environment);
+
+        ChatModel chatModel = catalogChatModelFactory.createChatModel(provider, model, apiKey, url);
 
         if (chatModel == null) {
             return null;

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/main/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatModel.java

@@ -79,9 +79,11 @@ private ChatModel resolveDelegate() {
         Provider provider = defaultModel.provider();
         String model = defaultModel.model();
         String apiKey = defaultModel.apiKey();
+        String url = defaultModel.url();
 
-        String cacheKey = ordinal + ":" + provider.getKey() + ":" + model + ":" + apiKey;
+        String cacheKey = ordinal + ":" + provider.getKey() + ":" + model + ":" + apiKey + ":" + url;
 
-        return delegateCache.get(cacheKey, key -> catalogChatModelFactory.createChatModel(provider, model, apiKey));
+        return delegateCache.get(cacheKey,
+            key -> catalogChatModelFactory.createChatModel(provider, model, apiKey, url));
     }
 }

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/main/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatModelFactory.java

@@ -8,6 +8,7 @@
 package com.bytechef.ee.platform.ai.agent.catalog;
 
 import static com.bytechef.component.ai.llm.constant.LLMConstants.MODEL;
+import static com.bytechef.component.ai.llm.ollama.constant.OllamaConstants.URL;
 import static com.bytechef.component.definition.Authorization.TOKEN;
 
 import com.bytechef.component.ai.llm.anthropic.action.AnthropicChatAction;
@@ -23,6 +24,7 @@
 import com.bytechef.platform.ai.llm.Provider;
 import com.bytechef.platform.annotation.ConditionalOnEEVersion;
 import com.bytechef.platform.component.definition.ParametersFactory;
+import java.util.HashMap;
 import java.util.Map;
 import org.jspecify.annotations.Nullable;
 import org.springframework.ai.chat.model.ChatModel;
@@ -40,19 +42,35 @@
 @ConditionalOnEEVersion
 public class CatalogChatModelFactory {
 
-    public @Nullable ChatModel createChatModel(Provider provider, String model, String apiKey) {
+    public @Nullable ChatModel createChatModel(
+        Provider provider, String model, @Nullable String apiKey, @Nullable String url) {
+
         com.bytechef.component.ai.llm.ChatModel chatModelFactory = resolveFactory(provider);
 
         if (chatModelFactory == null) {
             return null;
         }
 
         Parameters inputParameters = ParametersFactory.create(Map.of(MODEL, model));
-        Parameters connectionParameters = ParametersFactory.create(Map.of(TOKEN, apiKey));
+        Parameters connectionParameters = ParametersFactory.create(createConnectionParameters(apiKey, url));
 
         return chatModelFactory.createChatModel(inputParameters, connectionParameters, false);
     }
 
+    private static Map<String, Object> createConnectionParameters(@Nullable String apiKey, @Nullable String url) {
+        Map<String, Object> connectionParameters = new HashMap<>();
+
+        if (apiKey != null) {
+            connectionParameters.put(TOKEN, apiKey);
+        }
+
+        if (url != null && !url.isBlank()) {
+            connectionParameters.put(URL, url);
+        }
+
+        return connectionParameters;
+    }
+
     private static com.bytechef.component.ai.llm.@Nullable ChatModel resolveFactory(Provider provider) {
         return switch (provider) {
             case ANTHROPIC -> AnthropicChatAction.CHAT_MODEL;

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/main/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogEmbeddingModel.java

@@ -112,9 +112,10 @@ private EmbeddingModel resolveDelegate() {
         Provider provider = defaultModel.provider();
         String model = defaultModel.model();
         String apiKey = defaultModel.apiKey();
+        String url = defaultModel.url();
 
         return delegateCache.get(
-            ordinal + ":" + provider.getKey() + ":" + model + ":" + apiKey,
-            ignoredKey -> catalogEmbeddingModelFactory.createEmbeddingModel(provider, model, apiKey));
+            ordinal + ":" + provider.getKey() + ":" + model + ":" + apiKey + ":" + url,
+            ignoredKey -> catalogEmbeddingModelFactory.createEmbeddingModel(provider, model, apiKey, url));
     }
 }

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/main/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogEmbeddingModelFactory.java

@@ -8,6 +8,7 @@
 package com.bytechef.ee.platform.ai.agent.catalog;
 
 import static com.bytechef.component.ai.llm.constant.LLMConstants.MODEL;
+import static com.bytechef.component.ai.llm.ollama.constant.OllamaConstants.URL;
 import static com.bytechef.component.definition.Authorization.TOKEN;
 
 import com.bytechef.component.ai.llm.ollama.cluster.OllamaEmbedding;
@@ -17,6 +18,7 @@
 import com.bytechef.platform.annotation.ConditionalOnEEVersion;
 import com.bytechef.platform.component.definition.ParametersFactory;
 import com.bytechef.platform.component.definition.ai.vectorstore.EmbeddingFunction;
+import java.util.HashMap;
 import java.util.Map;
 import org.jspecify.annotations.Nullable;
 import org.springframework.ai.embedding.EmbeddingModel;
@@ -35,19 +37,35 @@
 @ConditionalOnEEVersion
 public class CatalogEmbeddingModelFactory {
 
-    public @Nullable EmbeddingModel createEmbeddingModel(Provider provider, String model, String apiKey) {
+    public @Nullable EmbeddingModel createEmbeddingModel(
+        Provider provider, String model, @Nullable String apiKey, @Nullable String url) {
+
         EmbeddingFunction embeddingFunction = resolveFactory(provider);
 
         if (embeddingFunction == null) {
             return null;
         }
 
         Parameters inputParameters = ParametersFactory.create(Map.of(MODEL, model));
-        Parameters connectionParameters = ParametersFactory.create(Map.of(TOKEN, apiKey));
+        Parameters connectionParameters = ParametersFactory.create(createConnectionParameters(apiKey, url));
 
         return embeddingFunction.apply(inputParameters, connectionParameters);
     }
 
+    private static Map<String, Object> createConnectionParameters(@Nullable String apiKey, @Nullable String url) {
+        Map<String, Object> connectionParameters = new HashMap<>();
+
+        if (apiKey != null) {
+            connectionParameters.put(TOKEN, apiKey);
+        }
+
+        if (url != null && !url.isBlank()) {
+            connectionParameters.put(URL, url);
+        }
+
+        return connectionParameters;
+    }
+
     private static @Nullable EmbeddingFunction resolveFactory(Provider provider) {
         return switch (provider) {
             case OLLAMA -> OllamaEmbedding.EMBEDDING_MODEL;

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/test/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatClientResolverTest.java

@@ -52,7 +52,7 @@ void testResolveReturnsNullWhenNoApiKey() {
     @Test
     void testResolveBuildsClientWhenApiKeyResolves() {
         when(aiProviderFacade.getApiKey(OPEN_AI_KEY, 1)).thenReturn("sk-test");
-        when(catalogChatModelFactory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-test"))
+        when(catalogChatModelFactory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-test", null))
             .thenReturn(mock(org.springframework.ai.chat.model.ChatModel.class));
 
         assertThat(resolver.resolve(OPEN_AI_KEY, "gpt-4o", 1)).isNotNull();
@@ -61,7 +61,7 @@ void testResolveBuildsClientWhenApiKeyResolves() {
     @Test
     void testResolveBuildsClientWhenApiKeyIsConfigFallback() {
         when(aiProviderFacade.getApiKey(OPEN_AI_KEY, 1)).thenReturn("sk-config");
-        when(catalogChatModelFactory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-config"))
+        when(catalogChatModelFactory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-config", null))
             .thenReturn(mock(org.springframework.ai.chat.model.ChatModel.class));
 
         assertThat(resolver.resolve(OPEN_AI_KEY, "gpt-4o", 1)).isNotNull();

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/test/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatModelFactoryTest.java

@@ -27,7 +27,7 @@ class CatalogChatModelFactoryTest {
     @Test
     void testCreateChatModelForOpenAiReturnsModel() {
         org.springframework.ai.chat.model.ChatModel chatModel =
-            factory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-test-key");
+            factory.createChatModel(Provider.OPEN_AI, "gpt-4o", "sk-test-key", null);
 
         assertThat(chatModel).isNotNull();
     }
@@ -36,8 +36,17 @@ void testCreateChatModelForOpenAiReturnsModel() {
     void testCreateChatModelForCatalogOnlyConnectionProviderReturnsNull() {
         // Azure needs a deployment endpoint the catalog doesn't store; v1 returns null -> caller falls back.
         org.springframework.ai.chat.model.ChatModel chatModel =
-            factory.createChatModel(Provider.AZURE_OPEN_AI, "gpt-4o", "sk-test-key");
+            factory.createChatModel(Provider.AZURE_OPEN_AI, "gpt-4o", "sk-test-key", null);
 
         assertThat(chatModel).isNull();
     }
+
+    @Test
+    void testCreateChatModelForOllamaWithCustomUrlReturnsModel() {
+        // Ollama needs no API key and accepts a custom base URL threaded through the connection parameters.
+        org.springframework.ai.chat.model.ChatModel chatModel =
+            factory.createChatModel(Provider.OLLAMA, "llama3", null, "http://remote-host:11434");
+
+        assertThat(chatModel).isNotNull();
+    }
 }

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/test/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogChatModelTest.java

@@ -34,7 +34,7 @@ class CatalogChatModelTest {
 
     private static final String ANTHROPIC_MODEL = "claude-sonnet-4-5";
     private static final AiDefaultModelWithApiKeyDTO ANTHROPIC_DEFAULT_MODEL =
-        new AiDefaultModelWithApiKeyDTO(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic");
+        new AiDefaultModelWithApiKeyDTO(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic", null);
 
     private final AiProviderFacade aiProviderFacade = mock(AiProviderFacade.class);
     private final CatalogChatModelFactory catalogChatModelFactory = mock(CatalogChatModelFactory.class);
@@ -56,7 +56,7 @@ void testDelegatesCallToDefaultProviderWhenModelResolved() {
         when(delegate.call(prompt)).thenReturn(response);
         when(aiProviderFacade.getAiDefaultChatModelApiKey(Environment.PRODUCTION.ordinal()))
             .thenReturn(ANTHROPIC_DEFAULT_MODEL);
-        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic"))
+        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic", null))
             .thenReturn(delegate);
 
         assertThat(catalogChatModel.call(prompt)).isSameAs(response);
@@ -84,7 +84,7 @@ void testReadsEnvironmentFromContext() {
         when(delegate.call(prompt)).thenReturn(mock(ChatResponse.class));
         when(aiProviderFacade.getAiDefaultChatModelApiKey(Environment.STAGING.ordinal()))
             .thenReturn(ANTHROPIC_DEFAULT_MODEL);
-        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic"))
+        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic", null))
             .thenReturn(delegate);
 
         catalogChatModel.call(prompt);
@@ -100,13 +100,13 @@ void testCachesDelegatePerEnvironmentAndKey() {
             .thenReturn(mock(ChatResponse.class));
         when(aiProviderFacade.getAiDefaultChatModelApiKey(Environment.PRODUCTION.ordinal()))
             .thenReturn(ANTHROPIC_DEFAULT_MODEL);
-        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic"))
+        when(catalogChatModelFactory.createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic", null))
             .thenReturn(delegate);
 
         catalogChatModel.call(new Prompt("a"));
         catalogChatModel.call(new Prompt("b"));
 
         verify(catalogChatModelFactory, times(1))
-            .createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic");
+            .createChatModel(Provider.ANTHROPIC, ANTHROPIC_MODEL, "sk-anthropic", null);
     }
 }

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/test/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogEmbeddingModelFactoryTest.java

@@ -28,21 +28,30 @@ class CatalogEmbeddingModelFactoryTest {
     @Test
     void testBuildsOpenAiEmbeddingModel() {
         EmbeddingModel embeddingModel = factory.createEmbeddingModel(
-            Provider.OPEN_AI, "text-embedding-3-small", "sk-test");
+            Provider.OPEN_AI, "text-embedding-3-small", "sk-test", null);
 
         assertThat(embeddingModel).isNotNull();
     }
 
     @Test
     void testReturnsNullForProviderWithoutEmbeddingSupport() {
-        assertThat(factory.createEmbeddingModel(Provider.ANTHROPIC, "irrelevant", "sk-test")).isNull();
+        assertThat(factory.createEmbeddingModel(Provider.ANTHROPIC, "irrelevant", "sk-test", null)).isNull();
+    }
+
+    @Test
+    void testBuildsOllamaEmbeddingModelWithCustomUrl() {
+        // Ollama needs no API key and accepts a custom base URL threaded through the connection parameters.
+        EmbeddingModel embeddingModel = factory.createEmbeddingModel(
+            Provider.OLLAMA, "nomic-embed-text", null, "http://remote-host:11434");
+
+        assertThat(embeddingModel).isNotNull();
     }
 
     @Test
     void testEmbeddingSupportMatchesProviderCapability() {
         for (Provider provider : Provider.values()) {
             EmbeddingModel embeddingModel = factory.createEmbeddingModel(
-                provider, "text-embedding-3-small", "sk-test");
+                provider, "text-embedding-3-small", "sk-test", null);
 
             assertThat(embeddingModel != null)
                 .as("Provider %s: factory builds an embedding model iff Provider.isEmbeddingSupported()", provider)

server/ee/libs/platform/platform-ai/platform-ai-agent/platform-ai-agent-service/src/test/java/com/bytechef/ee/platform/ai/agent/catalog/CatalogEmbeddingModelTest.java

@@ -32,7 +32,7 @@
 class CatalogEmbeddingModelTest {
 
     private static final AiDefaultModelWithApiKeyDTO OPEN_AI_DEFAULT_MODEL =
-        new AiDefaultModelWithApiKeyDTO(Provider.OPEN_AI, "text-embedding-3-small", "sk-test");
+        new AiDefaultModelWithApiKeyDTO(Provider.OPEN_AI, "text-embedding-3-small", "sk-test", null);
 
     private final AiProviderFacade aiProviderFacade = mock(AiProviderFacade.class);
     private final CatalogEmbeddingModelFactory catalogEmbeddingModelFactory =
@@ -56,8 +56,9 @@ void testDelegatesEmbedWhenModelResolved() {
         });
         when(aiProviderFacade.getAiDefaultEmbeddingModelApiKey(Environment.PRODUCTION.ordinal()))
             .thenReturn(OPEN_AI_DEFAULT_MODEL);
-        when(catalogEmbeddingModelFactory.createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test"))
-            .thenReturn(delegate);
+        when(catalogEmbeddingModelFactory.createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test",
+            null))
+                .thenReturn(delegate);
 
         float[] result = catalogEmbeddingModel.embed(document);
 
@@ -89,7 +90,7 @@ void testReadsEnvironmentFromContext() {
         when(aiProviderFacade.getAiDefaultEmbeddingModelApiKey(Environment.STAGING.ordinal()))
             .thenReturn(OPEN_AI_DEFAULT_MODEL);
         when(catalogEmbeddingModelFactory.createEmbeddingModel(
-            Provider.OPEN_AI, "text-embedding-3-small", "sk-test"))
+            Provider.OPEN_AI, "text-embedding-3-small", "sk-test", null))
                 .thenReturn(delegate);
 
         catalogEmbeddingModel.embed(document);
@@ -106,13 +107,14 @@ void testCachesDelegatePerEnvironmentAndKey() {
         });
         when(aiProviderFacade.getAiDefaultEmbeddingModelApiKey(Environment.PRODUCTION.ordinal()))
             .thenReturn(OPEN_AI_DEFAULT_MODEL);
-        when(catalogEmbeddingModelFactory.createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test"))
-            .thenReturn(delegate);
+        when(catalogEmbeddingModelFactory.createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test",
+            null))
+                .thenReturn(delegate);
 
         catalogEmbeddingModel.embed(new Document("a"));
         catalogEmbeddingModel.embed(new Document("b"));
 
         verify(catalogEmbeddingModelFactory, times(1))
-            .createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test");
+            .createEmbeddingModel(Provider.OPEN_AI, "text-embedding-3-small", "sk-test", null);
     }
 }