Workspaces and Agents

Create and operate Andy's tenant and advisory Agent resources.

Outcome

Inspect one Workspace, then create and configure an Agent inside its tenant boundary.

Prerequisites

• A ready User session or allowed Workspace API Key.
• The exact Workspace ID or slug.

Copy-paste workflow

andy workspace list --json
andy workspace inspect --workspace <workspace-id> --json
andy workspace entitlements --workspace <workspace-id> --json
andy agent create --workspace <workspace-id> --name "Support Agent" --language en --json
andy agent configure --workspace <workspace-id> --agent <agent-id> --instructions "Answer only from reviewed Knowledge." --json

A Workspace owns membership, roles, Entitlements, Limits, API Keys, Agents, and Usage. An Agent owns reviewed Knowledge, Public Chat, and Widget configuration. Agent deletion is soft and requires its exact ID plus confirmation:

andy agent delete --workspace <workspace-id> --agent <agent-id> --yes --json

Machine-readable verification

andy workspace inspect --workspace <workspace-id> --json
andy agent inspect --workspace <workspace-id> --agent <agent-id> --json

Confirm the returned workspace.id, agent.workspaceId, agent.status, and meta.requestId. All reads and writes recheck identity, role, scope, Entitlement, ownership, and Limits.

Next step

Add reviewed sources through Knowledge.