Resources / AgentAction
AgentAction
One action an agent decided on, with its outcome. Written by the platform only; approve or deny one that waits with an AgentApproval.
Overview
| API | intelligence.etorm.com/v1alpha1 |
| Resource | agentactions (cluster-scoped inside its cluster) |
| Short names | agact |
| Available in | project clusters only |
| Status | written by a controller through /status |
Minimal example
apiVersion: intelligence.etorm.com/v1alpha1
kind: AgentAction
metadata:
name: example
spec:
agentRef:
name: "<name>"
verb: get
resource: "<resource>"
Spec
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
agentRef | object | yes | The agent. | ||
agentRef.name | string | yes | length 1 to 63 | Name of the Agent. | |
step | integer | at least 0 | The agent's step number. | ||
verb | string (one of) | yes | get, list, create, update, patch, delete | The API verb. | |
group | string | up to 253 characters | API group of the target kind (empty for the core group). | ||
resource | string | yes | length 1 to 63 | Plural resource name of the target kind. | |
name | string | up to 63 characters | The target object, when there is one. | ||
risk | string (one of) | low, medium, high | low reads, medium creates or changes, high deletes. | ||
reason | string | up to 1000 characters | The agent's stated reason. Written by the model: data, not a fact. | ||
bodyDigest | string | up to 64 characters | SHA-256 of the request body, hex. |
Status
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
phase | string | AwaitingApproval, Approved, Denied, Expired, Succeeded, Refused or Failed. | |||
code | integer | HTTP status of the call. | |||
message | string | What happened. | |||
approvalRef | object | The decision that let it run or stopped it. | |||
approvalRef.name | string | Name of the AgentApproval. | |||
completedAt | string | When it ended (RFC 3339). | |||
conditions | list of object | Detailed state. | |||
conditions[].type | string | Aspect. | |||
conditions[].status | string | True or False. | |||
conditions[].reason | string | Machine-readable reason. | |||
conditions[].message | string | Human-readable detail. |
Columns in listings
| Column | From |
|---|---|
| Agent | .spec.agentRef.name |
| Verb | .spec.verb |
| Resource | .spec.resource |
| Target | .spec.name |
| Risk | .spec.risk |
| Phase | .status.phase |