Get Model Connection

GET

/v1/deployments/{deployment_id}/model-connection

curl --request GET \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/model-connection \
  --header 'Authorization: Bearer <token>'

• Прод

Чьей моделью думает агент: нашей или своей моделью владельца (п. 24 ТЗ).

Только чтение. Меняется подключение там, где заведено, — в подключениях владельца (/v1/integrations), потому что тем же ключом работают чат, разбор сканов и расшифровка. Второе место для одного ключа породило бы вопрос «почему в вебе моя модель, а у агента чужая», на который нет хорошего ответа.

Зачем маршрут нужен, если подключение и так видно в настройках. Затем, что «своя модель» обещана на карточке агента, а проверить её на странице агента было нельзя: настройки отвечают «ключ задан», но не отвечают «им думает вот эта машина». Перед запуском это и есть тот самый предпусковой пункт из п. 29 ТЗ — status='error' здесь означает, что агент поднимется и будет получать отказ модели на каждый запрос.

Authorizations

• bearerAuth

Parameters

Path Parameters

deployment_id

required

Deployment Id

string format: uuid

Responses

200

Successful Response

Media typeapplication/json

ModelConnectionOut

Чьей моделью думает агент этого развёртывания (п. 24 ТЗ: режимы подключения модели).

Только чтение, и это не урезание контракта, а его честная форма. ТЗ рисует подключение модели свойством установки (PUT /installations/{id}/model-connection), но у нас своё подключение живёт на ВЛАДЕЛЬЦЕ — тем же ключом работают чат, разбор сканов и расшифровка. Завести второе, отдельное для машины, значило бы два места для одного ключа и вопрос «почему в вебе моя модель, а у агента чужая», на который нет хорошего ответа. Поэтому развёртывание о своей модели сообщает, а меняется она там же, где заведена, — в подключениях владельца.

Ключа здесь нет и не будет (п. 27 ТЗ): наружу идут признак «задан», хвост для узнавания и хост эндпойнта. Хост — не секрет и нужен: «своя модель» без указания, куда именно уходят запросы, не отличимо от нашей на глаз.

object

checked_at

Any of:

string

string format: date-time

null

null

deployment_id

required

Deployment Id

string format: uuid

endpoint_host

Endpoint Host

string

""

key_hint

Key Hint

string

""

last_error

Last Error

string

""

mode

required

Mode

string

model

required

Model

string

status

Status

string

default: ok

Example

{
  "endpoint_host": "",
  "key_hint": "",
  "last_error": "",
  "status": "ok"
}

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