Skip to main content

​
list_agents

List all agents in your workspace. Parameters:
​
search
string
Search agents by name.
Example request: 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_agents",
    "arguments": {
      "search": "Support"
    }
  },
  "id": 1
}
Example response: 
{
  "agents": [
    {
      "id": "abc-123",
      "name": "Support Bot",
      "isActive": true,
      "type": "chat",
      "publishedAt": "2025-01-15T10:00:00Z",
      "createdAt": "2025-01-10T08:30:00Z"
    }
  ],
  "total": 1
}

​
get_agent

Get detailed information about a specific agent, including its prompt, configuration, tools, and linked knowledge. Parameters:
​
agentId
string
required
The ID of the agent to retrieve.
Example request: 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_agent",
    "arguments": {
      "agentId": "abc-123"
    }
  },
  "id": 2
}
Example response: 
{
  "id": "abc-123",
  "name": "Support Bot",
  "prompt": "You are a helpful support agent for Acme Corp...",
  "isActive": true,
  "type": "chat",
  "config": { ... },
  "tools": [ ... ],
  "knowledgeIds": ["k-1", "k-2"],
  "knowledgeBucketIds": ["kb-1"],
  "publishedAt": "2025-01-15T10:00:00Z",
  "createdAt": "2025-01-10T08:30:00Z",
  "updatedAt": "2025-01-20T14:00:00Z"
}