Usage By Agent

GET

/v1/usage/agents

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

• Прод

Расход в разрезе ролей ассистента: какая роль сколько потратила.

Вопрос, который задают, поставив роль из каталога: во что она обходится. Общей суммой он не разрешается — там всё вперемешку с загрузкой и обработкой файлов.

Строка с пустым slug — как раз «не про роль»: загрузка, обогащение, поиск и всё, записанное до появления этого учёта. Без неё разбивка не сошлась бы с GET /usage. Удалённая роль из выдачи не пропадает (deleted=true) — потраченное ею остаётся в истории.

Authorizations

• bearerAuth

Parameters

Query Parameters

days

Days

integer

0 <= 365

Responses

200

Successful Response

Media typeapplication/json

AgentUsageList

object

days

Any of:

integer

integer

null

null

items

Items

Array<object>

default:

AgentUsage

Расход одной роли ассистента.

slug="" — строка-остаток: загрузка файлов, обогащение, поиск и всё, записанное до появления этого учёта. Это не «неизвестная роль», а «не про роль»: без этой строки разбивка не сошлась бы с общим расходом.

object

calls

Calls

integer

0

cost_rub

Cost Rub

number

0

deleted

Deleted

boolean

name

Name

string

""

slug

Slug

string

""

source

Source

string

""

total_cost_rub

Total Cost Rub

number

0

Example

{
  "items": [],
  "total_cost_rub": 0
}

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

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}