CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/maven-org-springframework-ai--spring-ai-spring-boot-autoconfigure

Spring AI Spring Boot Auto Configuration modules providing automatic setup for AI models, vector stores, MCP, and retry capabilities

Overview
Eval results
Files

configuration-properties.mddocs/reference/

Configuration Properties Reference

Complete reference for all Spring AI Spring Boot Auto Configuration properties.

Common Properties

Retry Configuration

Prefix: spring.ai.retry

PropertyTypeDefaultDescription
max-attemptsint10Maximum retry attempts
backoff.initial-intervalDuration2sInitial backoff interval
backoff.multiplierint5Backoff multiplier
backoff.max-intervalDuration3mMaximum backoff interval
on-client-errorsbooleanfalseRetry on 4xx errors
on-http-codesList<Integer>[]HTTP codes to retry
exclude-on-http-codesList<Integer>[]HTTP codes to never retry

See Detailed Retry Documentation →

MCP Properties

MCP Client

Prefix: spring.ai.mcp.client

PropertyTypeDefaultDescription
enabledbooleantrueEnable MCP client
typeClientTypeSYNCClient type (SYNC/ASYNC)
nameStringspring-ai-mcp-clientClient name
request-timeoutDuration20sRequest timeout
initializedbooleantrueInitialize on startup
root-change-notificationbooleantrueEnable root change notifications
toolcallback.enabledbooleantrueEnable tool callbacks

MCP Server

Prefix: spring.ai.mcp.server

PropertyTypeDefaultDescription
enabledbooleantrueEnable MCP server
typeServerTypeSYNCServer type (SYNC/ASYNC)
transportTransportTypeSTDIOTransport (STDIO/SSE/STREAMABLE_HTTP)
nameStringspring-ai-mcp-serverServer name
change-notification.enabledbooleantrueEnable change notifications

See Detailed MCP Client Documentation →
See Detailed MCP Server Documentation →

Chat Infrastructure Properties

Chat Client

Prefix: spring.ai.chat.client

PropertyTypeDefaultDescription
enabledbooleantrueEnable chat client
log-promptbooleanfalseLog prompt content
log-completionbooleanfalseLog completion content

Chat Memory

Prefix: spring.ai.chat.memory.repository.{type}

RepositoryPropertiesDescription
jdbcinitialize-schema, platform, schemaJDBC-backed memory
mongocreate-indices, ttlMongoDB-backed memory
cassandraUses Spring Boot Cassandra configCassandra-backed memory
cosmosdbendpoint, key, database, containerCosmos DB-backed memory
neo4jUses Spring Boot Neo4j configNeo4j-backed memory

Chat Observations

Prefix: spring.ai.chat.observations

PropertyTypeDefaultDescription
log-promptbooleanfalseLog prompt content
log-completionbooleanfalseLog completion content
include-error-loggingbooleanfalseInclude error logging

See Detailed Chat Infrastructure Documentation →

AI Provider Properties

OpenAI

Prefix: spring.ai.openai

PropertyTypeDefaultDescription
api-keyString-OpenAI API key
base-urlStringhttps://api.openai.comBase URL
organization-idString-Organization ID
chat.options.modelStringgpt-3.5-turboModel name
chat.options.temperatureDouble0.7Temperature (0-2)
chat.options.max-tokensInteger-Max tokens
embedding.options.modelStringtext-embedding-ada-002Embedding model

Anthropic

Prefix: spring.ai.anthropic

PropertyTypeDefaultDescription
api-keyString-Anthropic API key
base-urlStringhttps://api.anthropic.comBase URL
chat.options.modelStringclaude-3-5-sonnet-20241022Model name
chat.options.temperatureDouble0.7Temperature (0-1)
chat.options.max-tokensInteger4096Max tokens

Azure OpenAI

Prefix: spring.ai.azure.openai

PropertyTypeDefaultDescription
api-keyString-Azure OpenAI key
endpointString-Azure endpoint URL
chat.options.deployment-nameString-Deployment name
chat.options.temperatureDouble0.7Temperature (0-2)

See Detailed Provider Documentation →

Vector Store Properties

PGVector

Prefix: spring.ai.vectorstore.pgvector

PropertyTypeDefaultDescription
initialize-schemabooleanfalseInitialize schema
schema-nameStringpublicSchema name
table-nameStringvector_storeTable name
index-typeIndexTypeHNSWIndex type (HNSW/IVF)
distance-typeDistanceTypeCOSINE_DISTANCEDistance metric
dimensionsInteger1536Vector dimensions

Pinecone

Prefix: spring.ai.vectorstore.pinecone

PropertyTypeDefaultDescription
api-keyString-Pinecone API key
environmentString-Environment (e.g., us-east1-gcp)
project-idString-Project ID
index-nameString-Index name
namespaceStringdefaultNamespace

Weaviate

Prefix: spring.ai.vectorstore.weaviate

PropertyTypeDefaultDescription
schemeStringhttpScheme (http/https)
hostStringlocalhost:8080Host and port
api-keyString-API key
object-classStringDocumentObject class name
initialize-schemabooleanfalseInitialize schema

See Detailed Vector Store Documentation →

Observation Properties

Vector Store Observations

Prefix: spring.ai.vectorstore.observations

PropertyTypeDefaultDescription
include-query-contentbooleanfalseInclude query in traces
include-resultsbooleanfalseInclude results in traces

Tool Observations

Prefix: spring.ai.tools.observations

PropertyTypeDefaultDescription
include-contentbooleanfalseInclude tool content

Tool Calling

Prefix: spring.ai.tools

PropertyTypeDefaultDescription
throw-exception-on-errorbooleanfalseThrow on tool errors

Environment Variables

Many properties support environment variable substitution:

spring.ai.openai.api-key=${OPENAI_API_KEY}
spring.ai.anthropic.api-key=${ANTHROPIC_API_KEY}
spring.ai.azure.openai.api-key=${AZURE_OPENAI_API_KEY}
spring.ai.azure.openai.endpoint=${AZURE_OPENAI_ENDPOINT}

Configuration Examples

See Quick Start Guide and Real-World Scenarios for complete configuration examples.

Install with Tessl CLI

npx tessl i tessl/maven-org-springframework-ai--spring-ai-spring-boot-autoconfigure

docs

index.md

tile.json