Agent Commands
Commands for managing AI agents in Maitento.
Authentication Required: Yes (all commands)
Common Options: All agent commands support the -ns (namespace) option.
Command Summary
| Command | Description |
|---|---|
agent-list | List all agents |
agent-get | Get agent details |
agent-create | Create a new agent |
agent-update | Update an existing agent |
agent-list
List all agents, optionally filtered by namespace.
Usage
mt agent-list [OPTIONS]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
-ns, --namespace | string | No | Config default | Filter by namespace |
Examples
List all agents in tenant:
$ mt agent-list
| Id | Name | DateCreated | DateUpdated |
|---|---|---|---|
| a1b2c3d4-e5f6-7890-abcd-ef12... | support-agent | 2026-01-01 10:30 | 2026-01-05 14:30 |
| b2c3d4e5-f6a7-8901-bcde-f234... | data-analyzer | 2026-01-02 09:15 | 2026-01-02 09:15 |
| c3d4e5f6-a7b8-9012-cdef-3456... | test-agent | 2026-01-03 16:45 | 2026-01-04 11:20 |
No agents found:
$ mt agent-list -ns empty-namespace
No agents found in namespace 'empty-namespace'
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| -1 | Authentication required |
agent-get
Get details of a specific agent by name.
Usage
mt agent-get <NAME> [OPTIONS]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the agent to retrieve |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
-ns, --namespace | string | No | Config default | The namespace containing the agent |
Examples
Get agent details:
$ mt agent-get support-agent -ns production
| id | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| name | support-agent |
| namespaceId | n1234567-89ab-cdef-0123-456789abcdef |
| tenantId | t1234567-89ab-cdef-0123-456789abcdef |
| userCreatedById | u1234567-89ab-cdef-0123-456789abcdef |
| dateCreated | 2026-01-01 10:30:00 |
| dateUpdated | 2026-01-05 14:30:00 |
| versions | (1 item) |
Agent not found:
$ mt agent-get nonexistent -ns production
Agent 'nonexistent' not found in namespace 'production'
Missing namespace:
$ mt agent-get support-agent
No namespace specified and no default namespace configured
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| -1 | Agent not found, missing namespace, or authentication required |
agent-create
Create a new agent.
Usage
mt agent-create <NAME> [OPTIONS]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the agent |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--ai-model-id | Guid | Yes | - | ID of the AI model to use |
--system-prompt | string | Yes | - | System prompt for the agent |
--summary | string | Yes | - | Summary for other agents |
-ns, --namespace | string | No | Config default | Namespace to create in |
Examples
Create a new agent:
$ mt agent-create support-agent \
--ai-model-id "m1234567-89ab-cdef-0123-456789abcdef" \
--system-prompt "You are a helpful customer support agent." \
--summary "Handles customer inquiries" \
-ns production
Agent 'support-agent' created (a1b2c3d4-e5f6-7890-abcd-ef1234567890)
| id | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| name | support-agent |
| namespaceId | n1234567-89ab-cdef-0123-456789abcdef |
| dateCreated | 2026-01-05 15:30:00 |
| versions | (1 item) |
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| -1 | Missing required options, missing namespace, or authentication required |
agent-update
Update an existing agent’s configuration.
Usage
mt agent-update <NAME> [OPTIONS]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the agent to update |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--new-name | string | No | - | New name for the agent |
--ai-model-id | Guid | No | - | New AI model ID |
--system-prompt | string | No | - | New system prompt |
--summary | string | No | - | New summary |
-ns, --namespace | string | No | Config default | Namespace containing the agent |
All update options are optional. Unspecified values are preserved.
Examples
Update system prompt:
$ mt agent-update support-agent \
--system-prompt "You are an expert support agent." \
-ns production
Agent 'support-agent' updated (a1b2c3d4-e5f6-7890-abcd-ef1234567890)
| id | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| name | support-agent |
| dateUpdated | 2026-01-05 16:00:00 |
Rename agent:
$ mt agent-update old-name --new-name "new-name" -ns production
Error - Agent not found:
$ mt agent-update nonexistent -ns production
Agent 'nonexistent' not found in namespace 'production'
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| -1 | Agent not found, no versions, missing namespace, or authentication required |
Output Format
The shell uses table-formatted output by default:
- Collections (e.g.,
agent-list): Horizontal table with columns - Single objects (e.g.,
agent-get): Vertical key-value table
In non-interactive mode (piped output), ASCII characters are used instead of Unicode box-drawing characters for compatibility.
Related Commands
ai-model-list- List available AI modelsinteraction-start- Start an interaction with agentsnamespace-list- List available namespaces
See Also
- Agents & Interactions Guide - Conceptual overview
- Agents API Reference - REST API documentation