Chat

POST

/v1/chat

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "attachment_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "history": [ { "content": "example", "role": "example" } ], "inline_attachments": [ { "filename": "", "text": "example" } ], "model": "example", "query": "example", "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "use_memory": true, "web_search": true }'

• Прод

Разговор с ассистентом, у которого есть доступ к вашим файлам.

Отличие от /ask в том, что здесь ассистент отвечает всегда. /ask — строгий RAG: нет подходящих документов — нет ответа. Здесь контекст из файлов (явно приложенных через attachment_ids и подобранных поиском) лишь дополняет обычного помощника, а без контекста он отвечает как обычный помощник.

Инструментов у этого маршрута нет: он ничего не конвертирует, не создаёт и не удаляет. Это /agent/chat.

session_id продолжает разговор и общий с /ask: оба маршрута пишут в одну историю чатов. Пустой query возвращает пустой ответ, а не ошибку.

Authorizations

• bearerAuth

Parameters

Header Parameters

x-hidden-token

Any of:

string

string

null

null

Request Body^required

Media typeapplication/json

ChatRequest

object

attachment_ids

Attachment Ids

Array<string>

history

History

Array<object>

ChatTurnIn

object

content

required

Content

string

role

required

Role

string

inline_attachments

Inline Attachments

Array<object>

<= 5 items

InlineAttachmentIn

Разовое вложение: имя файла + УЖЕ извлечённый текст. Файла в облаке нет и не будет — это контекст, который живёт только в запросе (и в истории чата как имя).

object

filename

Filename

string

"" <= 255 characters

text

required

Text

string

>= 1 characters <= 50000 characters

model

Any of:

string

string

null

null

query

required

Query

string

>= 1 characters <= 4000 characters

session_id

Any of:

string

string format: uuid

null

null

use_memory

Use Memory

boolean

default: true

web_search

Web Search

boolean

default: true

Responses

200

Successful Response

Media typeapplication/json

ChatResponse

object

answer

required

Answer

string

cost_rub

Cost Rub

number

0

session_id

Any of:

string

string format: uuid

null

null

Example

{
  "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"
    }
  ]
}