Deprecated API

Contents

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

Terminally Deprecated Elements

Element	Description
akka.javasdk.agent.Guardrail.Result	Use Decision from ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail.
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.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.ModelProvider.VertexAi(String, String, String, String, String, String, double, double, int, int, Duration, Duration, int, List<HttpHeader>)	Use constructor with thinkingLevel, or the static factory method and with methods.
akka.javasdk.agent.SimilarityGuard	SimilarityGuard is deprecated for every use-for value. For model-request and mcp-tool-response, use ModelCallSimilarityGuard. The SDK has no built-in replacement for model-response or mcp-tool-request.
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.
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.TextGuardrail	Implement ToolCallGuardrail, ModelCallGuardrail or AgentResponseGuardrail instead. The new interfaces return a Decision (Allow / Deny / Fail) and receive a per-call context.
akka.javasdk.Sanitizer	Use SanitizerClient, which masks with one configured sanitizer by name.

Deprecated Classes

Class	Description
akka.javasdk.agent.SimilarityGuard	SimilarityGuard is deprecated for every use-for value. For model-request and mcp-tool-response, use ModelCallSimilarityGuard. The SDK has no built-in replacement for model-response or mcp-tool-request.

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.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.PdfMessageContent.fromUrl(String)	Use MessageContent.PdfMessageContent.fromUri(String) instead.
akka.javasdk.agent.MessageContent.PdfMessageContent.fromUrl(URL)	Use MessageContent.PdfMessageContent.fromUri(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.ModelProvider.VertexAi(String, String, String, String, String, String, double, double, int, int, Duration, Duration, int, List<HttpHeader>)	Use constructor with thinkingLevel, or the static factory method and with methods.