Package akka.javasdk.agent

Interface AgentResponseGuardrail

All Superinterfaces:

Guardrail

public non-sealed interface AgentResponseGuardrail
extends Guardrail

A guardrail that decides whether an agent reply may be returned. The runtime evaluates it on the final reply, once per agent interaction. On an autonomous agent, the runtime also evaluates it on the message of each broadcast, direct, and submit_turn tool call.

An implementation has a public constructor, optionally taking a GuardrailContext parameter, which gives access to the guardrail's configured name and config section. The per-call data is delivered to decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext) via AgentResponseGuardrail.CallContext.

The runtime shares one instance across concurrent calls from different sessions and agents. An implementation must be thread safe.

To bind this guardrail to an agent that returns Agent.StreamEffect, set report-only = true on the entry. Otherwise, the service fails to start.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	AgentResponseGuardrail.CallContext	Per-call context passed to an AgentResponseGuardrail during decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext).

Nested classes/interfaces inherited from interface akka.javasdk.agent.Guardrail

Guardrail.GuardrailException, Guardrail.Message, Guardrail.Result

Method Summary

Modifier and Type	Method	Description
Decision	decide(AgentResponseGuardrail.CallContext ctx)	Decides whether the reply described by ctx may be returned.
default CompletionStage<Decision>	decideAsync(AgentResponseGuardrail.CallContext ctx)	Async variant of decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext), for implementations that prefer composing futures.

Method Details

decide

Decision decide(AgentResponseGuardrail.CallContext ctx)

Decides whether the reply described by ctx may be returned.

Use Decision.Deny to refuse the reply. Returning Decision.Fail and throwing are equivalent: both mean the guardrail reached no verdict, which is distinct from refusing the reply.

This is the method to implement. It may block: guardrails are always evaluated on virtual threads.

Returns:

the decision

decideAsync

default CompletionStage<Decision> decideAsync(AgentResponseGuardrail.CallContext ctx)

Async variant of decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext), for implementations that prefer composing futures.

The default implementation delegates to decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext). When this method is overridden, decide(akka.javasdk.agent.AgentResponseGuardrail.CallContext) is no longer used, and it is then safe to have it throw UnsupportedOperationException or return null.

Completing with Decision.Fail, failing the returned stage, and throwing are equivalent: all three mean the guardrail reached no verdict, which is distinct from refusing the reply.

Returns:

a CompletionStage with the decision