AgentResponseGuardrail

All Superinterfaces:: Guardrail

public non-sealed interface AgentResponseGuardrail extends Guardrail

A guardrail that decides whether the agent's final reply may be returned. The runtime evaluates it once per agent interaction.

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