API процессов
Транспорт
AgentBox exposes this service through the Connect protocol over HTTP. The AgentBox SDK supplies the routing and authorization headers automatically.
- Базовый URL:
https://sandbox.agentbox-runtime.ru - Полное имя сервиса:
process.Process - Шаблон URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/{RPC}
Заголовки запроса
Agentbox-Sandbox-Id· обязательно — Sandbox identifier.Agentbox-Sandbox-Port· обязательно — Envd port routed by the sandbox proxy. По умолчанию:49983.X-Access-Token· при наличии — Sandbox-scoped envd access token, when one was issued.
List
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/List - Запрос:
ListRequest - Ответ:
ListResponse
Connect
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/Connect - Запрос:
ConnectRequest - Ответ:
stream ConnectResponse
Start
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/Start - Запрос:
StartRequest - Ответ:
stream StartResponse
Update
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/Update - Запрос:
UpdateRequest - Ответ:
UpdateResponse
StreamInput
Client input stream ensures ordering of messages
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/StreamInput - Запрос:
stream StreamInputRequest - Ответ:
StreamInputResponse
SendInput
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/SendInput - Запрос:
SendInputRequest - Ответ:
SendInputResponse
SendSignal
Public RPC exposed by envd.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/SendSignal - Запрос:
SendSignalRequest - Ответ:
SendSignalResponse
CloseStdin
Close stdin to signal EOF to the process. Only works for non-PTY processes. For PTY, send Ctrl+D (0x04) instead.
- URL RPC:
POST https://sandbox.agentbox-runtime.ru/process.Process/CloseStdin - Запрос:
CloseStdinRequest - Ответ:
CloseStdinResponse
Типы сообщений
PTY
| Поле | Тип | Номер | Описание |
|---|---|---|---|
size | Size | 1 |
PTY.Size
| Поле | Тип | Номер | Описание |
|---|---|---|---|
cols | uint32 | 1 | |
rows | uint32 | 2 |
ProcessConfig
| Поле | Тип | Номер | Описание |
|---|---|---|---|
cmd | string | 1 | |
args | repeated string | 2 | |
envs | map<string, string> | 3 | |
cwd | optional string | 4 |
ListRequest
ProcessInfo
| Поле | Тип | Номер | Описание |
|---|---|---|---|
config | ProcessConfig | 1 | |
pid | uint32 | 2 | |
tag | optional string | 3 |
ListResponse
| Поле | Тип | Номер | Описание |
|---|---|---|---|
processes | repeated ProcessInfo | 1 |
StartRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessConfig | 1 | |
pty | optional PTY | 2 | |
tag | optional string | 3 | |
stdin | optional bool | 4 | This is optional for backwards compatibility. We default to true. New SDK versions will set this to false by default. |
UpdateRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 | |
pty | optional PTY | 2 |
UpdateResponse
ProcessEvent
| Поле | Тип | Номер | Oneof | Описание |
|---|---|---|---|---|
start | StartEvent | 1 | event | |
data | DataEvent | 2 | event | |
end | EndEvent | 3 | event | |
keepalive | KeepAlive | 4 | event |
ProcessEvent.StartEvent
| Поле | Тип | Номер | Описание |
|---|---|---|---|
pid | uint32 | 1 |
ProcessEvent.DataEvent
| Поле | Тип | Номер | Oneof | Описание |
|---|---|---|---|---|
stdout | bytes | 1 | output | |
stderr | bytes | 2 | output | |
pty | bytes | 3 | output |
ProcessEvent.EndEvent
| Поле | Тип | Номер | Описание |
|---|---|---|---|
exit_code | sint32 | 1 | |
exited | bool | 2 | |
status | string | 3 | |
error | optional string | 4 |
ProcessEvent.KeepAlive
StartResponse
| Поле | Тип | Номер | Описание |
|---|---|---|---|
event | ProcessEvent | 1 |
ConnectResponse
| Поле | Тип | Номер | Описание |
|---|---|---|---|
event | ProcessEvent | 1 |
SendInputRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 | |
input | ProcessInput | 2 |
SendInputResponse
ProcessInput
| Поле | Тип | Номер | Oneof | Описание |
|---|---|---|---|---|
stdin | bytes | 1 | input | |
pty | bytes | 2 | input |
StreamInputRequest
| Поле | Тип | Номер | Oneof | Описание |
|---|---|---|---|---|
start | StartEvent | 1 | event | |
data | DataEvent | 2 | event | |
keepalive | KeepAlive | 3 | event |
StreamInputRequest.StartEvent
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 |
StreamInputRequest.DataEvent
| Поле | Тип | Номер | Описание |
|---|---|---|---|
input | ProcessInput | 2 |
StreamInputRequest.KeepAlive
StreamInputResponse
SendSignalRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 | |
signal | Signal | 2 |
SendSignalResponse
CloseStdinRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 |
CloseStdinResponse
ConnectRequest
| Поле | Тип | Номер | Описание |
|---|---|---|---|
process | ProcessSelector | 1 |
ProcessSelector
| Поле | Тип | Номер | Oneof | Описание |
|---|---|---|---|---|
pid | uint32 | 1 | selector | |
tag | string | 2 | selector |
Типы перечислений
Signal
| Значение | Номер | Описание |
|---|---|---|
SIGNAL_UNSPECIFIED | 0 | |
SIGNAL_SIGTERM | 15 | |
SIGNAL_SIGKILL | 9 |