Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Record Classes
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
akka.javasdk.agent.Agent.Effect.Builder.imageLoader(ImageLoader)	use contentLoader
akka.javasdk.agent.Agent.StreamEffect.Builder.imageLoader(ImageLoader)	use contentLoader
akka.javasdk.agent.Guardrail.Result	Use Decision from ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail.
akka.javasdk.agent.ImageLoader	use ContentLoader
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(String)	Use MessageContent.ImageMessageContent.fromUri(String) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL)	Use MessageContent.ImageMessageContent.fromUri(URI) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL, MessageContent.ImageMessageContent.DetailLevel)	Use MessageContent.ImageMessageContent.fromUri(URI, DetailLevel) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL, MessageContent.ImageMessageContent.DetailLevel, String)	Use MessageContent.ImageMessageContent.fromUri(URI, DetailLevel, String) instead.
akka.javasdk.agent.MessageContent.ImageUrlMessageContent(URL, MessageContent.ImageMessageContent.DetailLevel)	Use ImageUrlMessageContent(URI, ImageMessageContent.DetailLevel) instead.
akka.javasdk.agent.MessageContent.ImageUrlMessageContent(URL, MessageContent.ImageMessageContent.DetailLevel, Optional<String>)	Use ImageUrlMessageContent(URI, ImageMessageContent.DetailLevel, Optional) instead.
akka.javasdk.agent.MessageContent.ImageUrlMessageContent.url()	Use MessageContent.ImageUrlMessageContent.uri() instead.
akka.javasdk.agent.MessageContent.PdfMessageContent.fromUrl(String)	Use MessageContent.PdfMessageContent.fromUri(String) instead.
akka.javasdk.agent.MessageContent.PdfMessageContent.fromUrl(URL)	Use MessageContent.PdfMessageContent.fromUri(URI) instead.
akka.javasdk.agent.MessageContent.PdfUrlMessageContent(URL)	Use PdfUrlMessageContent(URI) instead.
akka.javasdk.agent.MessageContent.PdfUrlMessageContent.url()	Use MessageContent.PdfUrlMessageContent.uri() instead.
akka.javasdk.agent.ModelProvider.Anthropic(String, String, String, double, double, int, int, Duration, Duration, int, int, List<HttpHeader>)	Use constructor with prompt caching settings
akka.javasdk.agent.ModelProvider.Bedrock(String, String, boolean, boolean, int, int, Map<String, Object>, String, double, double, int, Duration, int, List<HttpHeader>)	Use constructor with prompt caching settings
akka.javasdk.agent.ModelProvider.GoogleAIGemini(String, String, Double, Double, int, Duration, Duration, int)	Use constructor with baseUrl parameter, or the static factory method and with methods.
akka.javasdk.agent.SimilarityGuard	Using SimilarityGuard for model-request or model-response is deprecated. SimilarityGuard will support only mcp-tool-request and mcp-tool-response. For model-request, use ModelCallSimilarityGuard. The SDK has no replacement for model-response.
akka.javasdk.agent.TextGuardrail	Implement ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail instead. The new interfaces return a Decision (Allow / Deny / Fail) and receive a per-call context. For MCP tool calls, TextGuardrail is still the only guardrail type.
akka.javasdk.Metadata.getBinary(String)	binary not supported, always returns empty. Use Metadata.get(String).
akka.javasdk.Metadata.getBinaryAll(String)	binary not supported, always returns empty. Use Metadata.getAll(String).
akka.javasdk.Sanitizer	Use SanitizerClient, which masks with one configured sanitizer by name.

Deprecated Interfaces

Interface	Description
akka.javasdk.agent.ImageLoader	use ContentLoader
akka.javasdk.agent.TextGuardrail	Implement ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail instead. The new interfaces return a Decision (Allow / Deny / Fail) and receive a per-call context. For MCP tool calls, TextGuardrail is still the only guardrail type.
akka.javasdk.Sanitizer	Use SanitizerClient, which masks with one configured sanitizer by name.

Deprecated Classes

Class	Description
akka.javasdk.agent.SimilarityGuard	Using SimilarityGuard for model-request or model-response is deprecated. SimilarityGuard will support only mcp-tool-request and mcp-tool-response. For model-request, use ModelCallSimilarityGuard. The SDK has no replacement for model-response.

Deprecated Record Classes

Record Class	Description
akka.javasdk.agent.Guardrail.Result	Use Decision from ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail.

Deprecated Methods

Method	Description
akka.javasdk.agent.Agent.Effect.Builder.imageLoader(ImageLoader)	use contentLoader
akka.javasdk.agent.Agent.StreamEffect.Builder.imageLoader(ImageLoader)	use contentLoader
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(String)	Use MessageContent.ImageMessageContent.fromUri(String) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL)	Use MessageContent.ImageMessageContent.fromUri(URI) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL, MessageContent.ImageMessageContent.DetailLevel)	Use MessageContent.ImageMessageContent.fromUri(URI, DetailLevel) instead.
akka.javasdk.agent.MessageContent.ImageMessageContent.fromUrl(URL, MessageContent.ImageMessageContent.DetailLevel, String)	Use MessageContent.ImageMessageContent.fromUri(URI, DetailLevel, String) instead.
akka.javasdk.agent.MessageContent.ImageUrlMessageContent.url()	Use MessageContent.ImageUrlMessageContent.uri() instead.
akka.javasdk.agent.MessageContent.PdfMessageContent.fromUrl(String)	Use MessageContent.PdfMessageContent.fromUri(String) instead.
akka.javasdk.agent.MessageContent.PdfMessageContent.fromUrl(URL)	Use MessageContent.PdfMessageContent.fromUri(URI) instead.
akka.javasdk.agent.MessageContent.PdfUrlMessageContent.url()	Use MessageContent.PdfUrlMessageContent.uri() instead.
akka.javasdk.Metadata.getBinary(String)	binary not supported, always returns empty. Use Metadata.get(String).
akka.javasdk.Metadata.getBinaryAll(String)	binary not supported, always returns empty. Use Metadata.getAll(String).

Deprecated Constructors

Constructor	Description
akka.javasdk.agent.MessageContent.ImageUrlMessageContent(URL, MessageContent.ImageMessageContent.DetailLevel)	Use ImageUrlMessageContent(URI, ImageMessageContent.DetailLevel) instead.
akka.javasdk.agent.MessageContent.ImageUrlMessageContent(URL, MessageContent.ImageMessageContent.DetailLevel, Optional<String>)	Use ImageUrlMessageContent(URI, ImageMessageContent.DetailLevel, Optional) instead.
akka.javasdk.agent.MessageContent.PdfUrlMessageContent(URL)	Use PdfUrlMessageContent(URI) instead.
akka.javasdk.agent.ModelProvider.Anthropic(String, String, String, double, double, int, int, Duration, Duration, int, int, List<HttpHeader>)	Use constructor with prompt caching settings
akka.javasdk.agent.ModelProvider.Bedrock(String, String, boolean, boolean, int, int, Map<String, Object>, String, double, double, int, Duration, int, List<HttpHeader>)	Use constructor with prompt caching settings
akka.javasdk.agent.ModelProvider.GoogleAIGemini(String, String, Double, Double, int, Duration, Duration, int)	Use constructor with baseUrl parameter, or the static factory method and with methods.