Chat Ask

POST

/v1/deployments/{deployment_id}/chat

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "example" }'

• Прод

Спросить своего агента из веб-интерфейса (п. 9 приёмки протокола 13.09).

202, а не 200. Ответа в этом запросе нет и быть не может: у машины нет входящего порта, и вопрос доедет до агента ближайшим исходящим запросом реле. Отвечать 200 с пустым ответом значило бы обещать синхронность, которой здесь нет; ответ забирается GET-ом того же адреса.

409, пока предыдущий вопрос не закрыт. Агент ведёт одну сессию и отвечает по очереди, а каждый вопрос — это оплаченный вызов модели. Без этого правила нетерпеливый клик заказал бы десяток вызовов, за которые платит владелец.

Authorizations

• bearerAuth

Parameters

Path Parameters

deployment_id

required

Deployment Id

string format: uuid

Request Body^required

Media typeapplication/json

ChatAskIn

Вопрос агенту из веб-интерфейса.

Предел длины не про место в базе: каждый вопрос — это оплаченный вызов модели, и длина прямо переводится в деньги владельца.

object

text

required

Text

string

>= 1 characters <= 4000 characters

Example^generated

{
  "text": "example"
}

Responses

202

Successful Response

Media typeapplication/json

ChatMessageOut

Один обмен: вопрос и то, чем он кончился.

Одна запись вместо двух реплик — потому что вопрос без ответа это не сообщение в переписке, а задание в работе. Интерфейсу нужно показать его именно так: «спросили, агент думает».

object

answer

Answer

string

""

answered_at

Any of:

string

string format: date-time

null

null

created_at

Any of:

string

string format: date-time

null

null

error

Error

string

""

id

required

Id

string format: uuid

question

required

Question

string

status

required

Status

string

Example

{
  "answer": "",
  "error": ""
}

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