Перейти к содержимому
Agentum Cloud для разработчиков

List Agents

GET
/v1/agents
curl --request GET \
  --url https://api.cloud.agentums.ru/v1/agents \
  --header 'Authorization: Bearer <token>'

Каталог ролей: что есть, что закрыто тарифом, кто сейчас активен.

active отдаём из resolve, а не из сырых настроек: если оплаченный когда-то профиль закрылся после истечения тарифа, клиент обязан увидеть тот, с которым РЕАЛЬНО пойдёт ран, иначе экран будет показывать «Секретарь», а отвечать будет обычный ассистент.

Authorizations

Заголовок раздела «Authorizations»

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Successful Response

Media typeapplication/json
AgentCatalogOut
object
active
required
Active
string
can_create_custom
Can Create Custom
boolean
default: true
custom_limit
Custom Limit
integer
0
icons
Icons
Array<string>
items
required
Items
Array<object>
AgentProfileOut

Карточка роли для экрана «Главная».

object
description
required
Description
string
icon
required
Icon
string
is_active
required
Is Active
boolean
locked
Locked
boolean
name
required
Name
string
persona
Persona
string
""
plan_min
Any of:
string
slug
required
Slug
string
source
required
Source
string
toolsets
Toolsets
Array<string>
presets
Presets
Array<object>
PresetOut

Пресет-шаблон роли для формы «+ Своя роль»: заготовка с готовой персоной и scoped-набором инструментов (min-privilege под роль). Клиент подставляет в форму, человек правит.

object
description
required
Description
string
icon
required
Icon
string
key
required
Key
string
name
required
Name
string
persona
required
Persona
string
toolsets
required
Toolsets
Array<string>
toolsets
Toolsets
Array<object>
ToolsetOut

Группа инструментов для конструктора: что человек отмечает галочкой.

object
description
required
Description
string
key
required
Key
string
name
required
Name
string
tools
required
Tools
integer
Example
{
  "can_create_custom": true,
  "custom_limit": 0,
  "items": [
    {
      "locked": false,
      "persona": ""
    }
  ]
}

422

Заголовок раздела «422»

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}