Package akka.javasdk.agent.autonomous
package akka.javasdk.agent.autonomous
-
ClassDescriptionDefines an autonomous agent's configuration: tools, model provider, guardrails, capabilities, and optional instructions.Per-instance configuration applied on top of an agent's static
AgentDefinition.Summary of an autonomous agent's current state.An autonomous AI agent component that operates independently to complete tasks.Token usage statistics for an autonomous agent.Notifications published by the runtime for an autonomous agent instance.Agent activated — transitioned from idle to processing.Backlog access: this agent has been granted access to a backlog.Backlog management: a backlog has been assigned to this agent.Backlog management: a backlog has been closed.Backlog notifications: backlog assignment/access and task claims.Backlog access: this agent claimed a task from a backlog.A new contact was introduced to this agent.Conversation moderator: a new conversation was created with the given participants.Conversation moderator: a conversation has ended.Conversation participant: this agent joined a conversation moderated by the given agent.Conversation notifications: conversation creation, turns, participation.Conversation moderator: a participant's setup completed and they are ready to take turns.Conversation moderator: a participant's setup failed.Conversation moderator: a turn was received from a participant.Agent deactivated — no more work, back to idle.Delegation notifications: orchestrator-side and worker-side of subtask delegation.Orchestrator side: aggregate resolution of a delegation batch.Orchestrator side: a batch of subtasks has been dispatched to workers.A specific dependency for a task has resolved (success or failure).Handoff notifications: source-side and target-side of cross-agent handoffs.Target side: this agent has received a handed-off task from another agent.Source side: this agent has handed off a task to another agent.Agent iteration completed successfully.Agent iteration failed.Agent iteration started — LLM call beginning.Lifecycle notifications: agent activation, iteration boundaries, pause/resume/stop.A message was received from another agent.Messaging notifications: contact introductions and message delivery.Conversation participant: this agent submitted its turn after the given number of iterations.Derived signal: N consecutive iteration failures in flows not tied to a specific task (pre-task setup, request-based delegation).Agent resumed.Agent stopped.Struggle signals: derived notifications for repeated failures, stuck deps, approaching limits.Agent suspended.Derived signal: a task is at or beyond a configurable fraction (default 80%) of its max iterations.A task was assigned (queued) — fires before the model loop begins setup for it.Task was cancelled by the framework — dependency failure, max iterations, orphan cleanup, etc.Agent completed a task successfully.Derived signal: a task waiting on dependencies has been waiting longer than the configured threshold.A task is blocked waiting for one or more dependency tasks to resolve.Agent failed a task via explicit fail_task.Task notifications: assignment, start, completion, failure, cancellation, dependencies.Agent's task result was rejected by a validation rule.Agent started working on a task.Derived signal: a task is struggling — N consecutive iteration failures, M consecutive result rejections, or some other impediment captured inNotification.TaskStruggleDetected.reason().Team lead: a new team was formed with the given members.Team lead: a team has been disbanded.Team member: this agent joined a team led by the given agent.Team lead: a team member's setup chain completed and the member is now active.Team lead: a team member's setup chain failed.Team lead: a team member has stopped.Team notifications: team formation, member lifecycle, disbanding.Worker side: this agent finished its delegated subtask.Worker side: this agent accepted a delegated subtask from the orchestrator.