Uses of Annotation Interface
dev.langchain4j.Experimental

Packages that use Experimental

Package	Description
dev.langchain4j.agent.tool
dev.langchain4j.data.message
dev.langchain4j.experimental.rag.content.retriever.sql
dev.langchain4j.http.client.sse
dev.langchain4j.model.anthropic
dev.langchain4j.model.audio
dev.langchain4j.model.azure
dev.langchain4j.model.chat.response
dev.langchain4j.model.openaiofficial
dev.langchain4j.service
dev.langchain4j.service.tool
dev.langchain4j.store.embedding.filter.builder.sql
dev.langchain4j.store.embedding.filter.parser.sql

Packages with annotations of type Experimental

Package	Description
dev.langchain4j.observability.api
dev.langchain4j.observability.api.event
dev.langchain4j.observability.event
dev.langchain4j.guardrail
dev.langchain4j.service.guardrail
dev.langchain4j.observability.api.listener

Uses of Experimental in dev.langchain4j.agent.tool

Classes in dev.langchain4j.agent.tool with annotations of type Experimental

Modifier and Type	Class	Description
enum	ReturnBehavior	Defines the behavior of a tool's return value when called by a language model.

Uses of Experimental in dev.langchain4j.data.message

Methods in dev.langchain4j.data.message with annotations of type Experimental

Modifier and Type	Method	Description
<T> T	AiMessage.attribute(String key, Class<T> type)	Returns additional attribute by it's key.
<T> T	UserMessage.attribute(String key, Class<T> type)	Returns additional attribute by it's key.
Map<String,Object>	AiMessage.attributes()	Returns additional attributes, typically provider-specific.
AiMessage.Builder	AiMessage.Builder.attributes(Map<String,Object> attributes)
Map<String,Object>	UserMessage.attributes()	Returns additional attributes.
AiMessage.Builder	AiMessage.Builder.thinking(String thinking)
String	AiMessage.thinking()	Get the thinking/reasoning text of the message.

Uses of Experimental in dev.langchain4j.experimental.rag.content.retriever.sql

Classes in dev.langchain4j.experimental.rag.content.retriever.sql with annotations of type Experimental

Modifier and Type	Class	Description
class	SqlDatabaseContentRetriever	WARNING! Although fun and exciting, this class is dangerous to use! Do not ever use this in production! The database user must have very limited READ-ONLY permissions! Although the generated SQL is somewhat validated (to ensure that the SQL is a SELECT statement) using JSqlParser, this class does not guarantee that the SQL will be harmless.

Constructors in dev.langchain4j.experimental.rag.content.retriever.sql with annotations of type Experimental

Modifier	Constructor	Description
	SqlDatabaseContentRetriever(DataSource dataSource, String sqlDialect, String databaseStructure, PromptTemplate promptTemplate, ChatModel chatModel, Integer maxRetries)	Creates an instance of a SqlDatabaseContentRetriever.

Uses of Experimental in dev.langchain4j.http.client.sse

Classes in dev.langchain4j.http.client.sse with annotations of type Experimental

Modifier and Type	Class	Description
class	ServerSentEventContext
interface	ServerSentEventParsingHandle	Handle that can be used to cancel the parsing of server-sent events.

Methods in dev.langchain4j.http.client.sse with annotations of type Experimental

Modifier and Type	Method	Description
default void	ServerSentEventListener.onEvent(ServerSentEvent event, ServerSentEventContext context)	Handles server-sent event.

Uses of Experimental in dev.langchain4j.model.anthropic

Classes in dev.langchain4j.model.anthropic with annotations of type Experimental

Modifier and Type	Class	Description
class	AnthropicTokenCountEstimator

Uses of Experimental in dev.langchain4j.model.audio

Classes in dev.langchain4j.model.audio with annotations of type Experimental

Modifier and Type	Interface	Description
interface	AudioTranscriptionModel	A model that can transcribe audio into text.
class	AudioTranscriptionRequest	Request to transcribe audio.
class	AudioTranscriptionResponse	Response containing the transcription of an audio file.

Uses of Experimental in dev.langchain4j.model.azure

Classes in dev.langchain4j.model.azure with annotations of type Experimental

Modifier and Type	Class	Description
class	AzureOpenAiAudioTranscriptionModel	Represents an Azure OpenAI audio transcription model, such as Whisper.

Uses of Experimental in dev.langchain4j.model.chat.response

Classes in dev.langchain4j.model.chat.response with annotations of type Experimental

Modifier and Type	Class	Description
class	CompleteToolCall	Represents a complete tool call.
class	PartialResponse
class	PartialResponseContext
class	PartialThinking
class	PartialThinkingContext
class	PartialToolCall	Represents a partial tool call.
class	PartialToolCallContext
interface	StreamingHandle	Handle that can be used to cancel the streaming done via StreamingChatResponseHandler.

Methods in dev.langchain4j.model.chat.response with annotations of type Experimental

Modifier and Type	Method	Description
default void	StreamingChatResponseHandler.onCompleteToolCall(CompleteToolCall completeToolCall)	Invoked when the model has finished streaming a single tool call.
default void	StreamingChatResponseHandler.onPartialResponse(PartialResponse partialResponse, PartialResponseContext context)	Invoked each time the model generates a partial textual response, usually a single token.
default void	StreamingChatResponseHandler.onPartialThinking(PartialThinking partialThinking)	Invoked each time the model generates a partial thinking/reasoning text, usually a single token.
default void	StreamingChatResponseHandler.onPartialThinking(PartialThinking partialThinking, PartialThinkingContext context)	Invoked each time the model generates a partial thinking/reasoning text, usually a single token.
default void	StreamingChatResponseHandler.onPartialToolCall(PartialToolCall partialToolCall)	This callback is invoked each time the model generates a partial tool call, which contains a single token of the tool's arguments.
default void	StreamingChatResponseHandler.onPartialToolCall(PartialToolCall partialToolCall, PartialToolCallContext context)	This callback is invoked each time the model generates a partial tool call, which contains a single token of the tool's arguments.

Uses of Experimental in dev.langchain4j.model.openaiofficial

Classes in dev.langchain4j.model.openaiofficial with annotations of type Experimental

Modifier and Type	Class	Description
class	OpenAiOfficialChatRequestParameters
class	OpenAiOfficialChatResponseMetadata

Uses of Experimental in dev.langchain4j.service

Methods in dev.langchain4j.service with annotations of type Experimental

Modifier and Type	Method	Description
default TokenStream	TokenStream.onPartialResponseWithContext(BiConsumer<PartialResponse, PartialResponseContext> handler)	The provided consumer will be invoked every time a new partial textual response (usually a single token) from a language model is available.
default TokenStream	TokenStream.onPartialThinking(Consumer<PartialThinking> partialThinkingHandler)	The provided consumer will be invoked every time a new partial thinking/reasoning text (usually a single token) from a language model is available.
default TokenStream	TokenStream.onPartialThinkingWithContext(BiConsumer<PartialThinking, PartialThinkingContext> handler)	The provided consumer will be invoked every time a new partial thinking/reasoning text (usually a single token) from a language model is available.

Uses of Experimental in dev.langchain4j.service.tool

Classes in dev.langchain4j.service.tool with annotations of type Experimental

Modifier and Type	Class	Description
class	BeforeToolExecution

Uses of Experimental in dev.langchain4j.store.embedding.filter.builder.sql

Classes in dev.langchain4j.store.embedding.filter.builder.sql with annotations of type Experimental

Modifier and Type	Class	Description
class	ColumnDefinition
class	LanguageModelSqlFilterBuilder	Given a natural language Query, this class creates a suitable Filter using a language model.
class	TableDefinition

Uses of Experimental in dev.langchain4j.store.embedding.filter.parser.sql

Classes in dev.langchain4j.store.embedding.filter.parser.sql with annotations of type Experimental

Modifier and Type	Class	Description
class	SqlFilterParser	Parses an SQL "WHERE" clause into a Filter object using JSqlParser.