Package akka.javasdk.agent.autonomous

package akka.javasdk.agent.autonomous

AutonomousAgent components — agents that run their own iteration loop against a task queue — with their definition, state, and runtime notifications.

Related Packages

Package	Description
akka.javasdk.agent	Agent components, plus the guardrails and classifiers that govern their model and tool calls.
akka.javasdk.agent.autonomous.capability	Capabilities that an AutonomousAgent declares in its definition: accepting task types (TaskAcceptance), delegating subtasks (Delegation), leading a team (TeamLeadership), and moderating conversations (Moderation).
akka.javasdk.agent.evaluator	Built-in LLM-as-judge agents (ToxicityEvaluator, SummarizationEvaluator, HallucinationEvaluator) that call a model to judge a piece of text or an answer against a reference.
akka.javasdk.agent.task	Typed, durable tasks for autonomous agents: Task and TaskTemplate definitions, the TaskEntity that records each task's lifecycle, TaskRule result validation, and the events and notifications the entity publishes.

Class	Description
AgentDefinition	Defines an autonomous agent's configuration: tools, model provider, guardrails, capabilities, and optional instructions.
AgentSetup	Per-instance configuration applied on top of an agent's static AgentDefinition.
AgentState	Summary of an autonomous agent's current state.
AutonomousAgent	An autonomous AI agent component that operates independently to complete tasks.
AutonomousAgent.TokenUsage	Token usage statistics for an autonomous agent.
Notification	Notifications published by the runtime for an autonomous agent instance.
Notification.Activated	Agent activated — transitioned from idle to processing.
Notification.BacklogAccessGranted	Backlog access: this agent has been granted access to a backlog.
Notification.BacklogAssigned	Backlog management: a backlog has been assigned to this agent.
Notification.BacklogClosed	Backlog management: a backlog has been closed.
Notification.BacklogNotification	Backlog notifications: backlog assignment/access and task claims.
Notification.BacklogTaskClaimed	Backlog access: this agent claimed a task from a backlog.
Notification.ContactAdded	A new contact was introduced to this agent.
Notification.ConversationCreated	Conversation moderator: a new conversation was created with the given participants.
Notification.ConversationEnded	Conversation moderator: a conversation has ended.
Notification.ConversationJoined	Conversation participant: this agent joined a conversation moderated by the given agent.
Notification.ConversationNotification	Conversation notifications: conversation creation, turns, participation.
Notification.ConversationParticipantReady	Conversation moderator: a participant's setup completed and they are ready to take turns.
Notification.ConversationParticipantSetupFailed	Conversation moderator: a participant's setup failed.
Notification.ConversationTurnReceived	Conversation moderator: a turn was received from a participant.
Notification.Deactivated	Agent deactivated — no more work, back to idle.
Notification.DelegationNotification	Delegation notifications: orchestrator-side and worker-side of subtask delegation.
Notification.DelegationResolved	Orchestrator side: aggregate resolution of a delegation batch.
Notification.DelegationStarted	Orchestrator side: a batch of subtasks has been dispatched to workers.
Notification.DependencyResolved	A specific dependency for a task has resolved (success or failure).
Notification.HandoffNotification	Handoff notifications: source-side and target-side of cross-agent handoffs.
Notification.HandoffReceived	Target side: this agent has received a handed-off task from another agent.
Notification.HandoffStarted	Source side: this agent has handed off a task to another agent.
Notification.IterationCompleted	Agent iteration completed successfully.
Notification.IterationFailed	Agent iteration failed.
Notification.IterationStarted	Agent iteration started — LLM call beginning.
Notification.LifecycleNotification	Lifecycle notifications: agent activation, iteration boundaries, pause/resume/stop.
Notification.MessageReceived	A message was received from another agent.
Notification.MessagingNotification	Messaging notifications: contact introductions and message delivery.
Notification.ParticipantTurnSubmitted	Conversation participant: this agent submitted its turn after the given number of iterations.
Notification.RepeatedIterationFailure	Derived signal: N consecutive iteration failures in flows not tied to a specific task (pre-task setup, request-based delegation).
Notification.Resumed	Agent resumed.
Notification.Stopped	Agent stopped.
Notification.StruggleNotification	Struggle signals: derived notifications for repeated failures, stuck deps, approaching limits.
Notification.Suspended	Agent suspended.
Notification.TaskApproachingMaxIterations	Derived signal: a task is at or beyond a configurable fraction (default 80%) of its max iterations.
Notification.TaskAssigned	A task was assigned (queued) — fires before the model loop begins setup for it.
Notification.TaskCancelled	A task was cancelled before execution began — for example because a dependency task failed.
Notification.TaskCompleted	Agent completed a task successfully.
Notification.TaskDependencyStuck	Derived signal: a task waiting on dependencies has been waiting longer than the configured threshold.
Notification.TaskDependencyWait	A task is blocked waiting for one or more dependency tasks to resolve.
Notification.TaskFailed	A task terminated during execution — either the agent's explicit decision to fail it, or the framework terminating it when the iteration limit was reached.
Notification.TaskNotification	Task notifications: assignment, start, completion, failure, cancellation, dependencies.
Notification.TaskResultRejected	Agent's task result was rejected by a validation rule.
Notification.TaskStarted	Agent started working on a task.
Notification.TaskStruggleDetected	Derived signal: a task is struggling — N consecutive iteration failures, M consecutive result rejections, or some other impediment captured in Notification.TaskStruggleDetected.reason().
Notification.TeamCreated	Team lead: a new team was formed with the given members.
Notification.TeamDisbanded	Team lead: a team has been disbanded.
Notification.TeamJoined	Team member: this agent joined a team led by the given agent.
Notification.TeamMemberReady	Team lead: a team member's setup chain completed and the member is now active.
Notification.TeamMemberSetupFailed	Team lead: a team member's setup chain failed.
Notification.TeamMemberStopped	Team lead: a team member has stopped.
Notification.TeamNotification	Team notifications: team formation, member lifecycle, disbanding.
Notification.WorkerTaskCompleted	Worker side: this agent finished its delegated subtask.
Notification.WorkerTaskReceived	Worker side: this agent accepted a delegated subtask from the orchestrator.