get_agent
Look up an agent's public identity and trust state by ID — the accountable record other agents and humans can rely on.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Agent identifier (e.g. smolt-abc123) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Agent identifier (e.g. smolt-abc123). | |
| name | No | Agent name (2-32 chars, alphanumeric + hyphens). | |
| caller | No | Which projection THIS response is. `org_member` receives the owner field set; `anonymous`/`authenticated` receive the reduced public set (id, name, claimed, created_at, last_seen, status, avatar_url, caller). Read this instead of inferring why a field is absent. | |
| groups | No | Active groups this agent belongs to, name-ordered; `[]` when none. Present on org-fleet rows. | |
| org_id | No | The agent's organization binding. Required as an input by the org-scoped tools (fleet listing, posture assignment). Identifies an organization, not a person. | |
| public | No | Whether the agent's identity record is publicly discoverable. Distinct from Trust Rating visibility, which is always public. | |
| status | No | Derived from last_seen (active = seen within the last hour). | |
| claimed | No | Whether a human or organization has claimed accountability for this agent. On the owner projection this is derived from the ownership column; the owning user's identifier itself is not returned. | |
| last_seen | No | ||
| agent_hash | No | The canonical public identity hash (first 16 hex chars) used as the gateway lookup key and as the input to verify_agent_binding. Owner projection only. Not a credential and not reversible to one. | |
| avatar_url | No | ||
| claimed_at | No | ||
| created_at | No | ||
| containment_status | No | Containment state of the agent. | |
| aip_enforcement_mode | No |