MngGetAIAgentsByFilter¶

GET ai/agents

Agent configurations visible to the administrator: those of the brand plus shared ones (brand: "*"). A super administrator sees every brand.

Access Control¶

Allowed: admin.

Request¶

RESTTCPSDK

GET request

GET https://{broker_domain}/ai/agents?limit=100
Authorization: <JWT_TOKEN>

{
  "command": "MngGetAIAgentsByFilter",
  "extID": "1",
  "data": { "limit": 100 }
}

const agents = await platform.MngGetAIAgentsByFilter({ limit: 100 });

Parameters¶

Standard list parameters: limit (default 100, maximum 500), offset, orderBy, groupBy and where filters.

Response Data¶

{
  "rows": [
    {
      "id": 1,
      "brand": "*",
      "name": "Platform consultant",
      "description": "Answers questions about the platform using the knowledge base",
      "enabled": true,
      "modeChat": true,
      "modeClient": false,
      "modeWorkflow": false,
      "model": "anthropic/claude-sonnet-4.5",
      "fallbackModels": [],
      "systemPrompt": "You are an assistant inside the platform…",
      "temperature": 0.2,
      "maxTokens": 0,
      "toolNames": [],
      "knowledgeScopes": [],
      "dailyRequestLimit": 0,
      "dailyTokenLimit": 0,
      "dailyCostLimit": 0,
      "createdAt": "2026-09-10 08:00:00",
      "updatedAt": "2026-09-17 09:41:12"
    }
  ]
}

Rows are objects, and this list has no count: there are a handful of agents, so the page is the whole answer.

toolNames: [] means the agent has no tools — it answers from the knowledge base only. That is the default for a new installation, and turning tools on is a deliberate step: through them customer data reaches the model.

Errors¶

Code	Error	Description
`403`	`AI_ACCESS_DENIED`	The session is not an administrator