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

Get Context Grant

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

Чем агенту разрешено пользоваться у владельца.

Чтение ничего не создаёт: строка, появившаяся от взгляда на экран, сделала бы «человек ещё не решал» и «человек решил ничего не давать» неразличимыми.

Authorizations

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

Parameters

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

Path Parameters

Заголовок раздела «Path Parameters»
deployment_id
required
Deployment Id
string format: uuid

Responses

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

200

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

Successful Response

Media typeapplication/json
ContextGrantOut

Что разрешено сейчас.

granted=false — разрешения НЕТ вовсе: человек его не выдавал или отозвал. Это не то же самое, что режим none: во втором случае решение принято и записано, в первом — не принималось. Различать их нужно, чтобы экран не показывал «вы запретили» тому, кого ещё не спрашивали.

object
active
Active
boolean
collection_ids
Collection Ids
Array<string>
expires_at
Any of:
string format: date-time
granted
Granted
boolean
mode
Mode
string
default: none
object_ids
Object Ids
Array<string>
permissions
ContextPermissions

Таблица разрешений п. 12. Все по умолчанию выключены, включая чтение.

В ТЗ у read_files написано «OFF для стороннего / ON только после grant». Трактовать это как «включается вместе с выбором папок» значит выдать доступ, которого человек не давал: выбрать папку и разрешить её читать — разные решения, и второе он принимает отдельно.

object
attachments
Attachments
boolean
external_actions
External Actions
boolean
modify_files
Modify Files
boolean
read_files
Read Files
boolean
save_incoming_files
Save Incoming Files
boolean
search
Search
boolean
use_memory
Use Memory
boolean
web_search
Web Search
boolean
default: true
write_files
Write Files
boolean
updated_at
Any of:
string format: date-time
Example
{
  "active": false,
  "granted": false,
  "mode": "none",
  "permissions": {
    "attachments": false,
    "external_actions": false,
    "modify_files": false,
    "read_files": false,
    "save_incoming_files": false,
    "search": false,
    "use_memory": false,
    "web_search": true,
    "write_files": false
  }
}

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