Class AgentEventsResource

java.lang.Object

dev.getshield.resources.AgentEventsResource

public class AgentEventsResource
extends Object

Agent events resource — record tamper-evident AI agent actions.

ShieldEvent evt = client.agent().logAction("ses_abc", AgentEventRequest.builder()
    .eventType("shield.content.submitted")
    .agentId("agt-unique-id")
    .agentName("gpt-4o")
    .outputHash("9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08")
    .build());

Constructor Summary

Constructors

Constructor	Description
AgentEventsResource(ShieldClient client)

Method Summary

Modifier and Type	Method	Description
ShieldEvent	logAction(String sessionId, AgentEventRequest request)	Record a tamper-evident AI agent action.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AgentEventsResource

public AgentEventsResource(ShieldClient client)

Method Details

logAction

public ShieldEvent logAction(String sessionId,
 AgentEventRequest request)

Record a tamper-evident AI agent action.

Parameters:

sessionId - session to record the event in

request - agent event parameters; at least one of agentId or agentName required

Returns:

created event

Throws:

ShieldException - if validation fails or the API returns an error