Contrato
Sidecarqa Unix socketpi gRPC servidormi. NEBO_APP_SOCKpi ñanta uyariy, apps.v0.UIServicetataq ruway. Neboqa sapa mañakuypaqmi HandleRequestta waqyan; HealthCheck, Configurepas serviciopa partenmi ichaqa kunanqa manam waqyasqachu. Socketqa manifiestopa startup_timeoutnin ukhupim rikhurinan, ñawpaqmantaqa 10 segundokuna, aswantaq 120.
syntax = "proto3";
package apps.v0;
service UIService {
rpc HealthCheck(HealthCheckRequest) returns (HealthCheckResponse);
rpc Configure(SettingsMap) returns (Empty);
rpc HandleRequest(HttpRequest) returns (HttpResponse);
}
message HttpRequest {
string method = 1; // GET, POST, PUT, DELETE, ...
string path = 2; // relative to /apps/{id}/api/
string query = 3; // raw query string
map<string, string> headers = 4;
bytes body = 5;
}
message HttpResponse {
int32 status_code = 1;
map<string, string> headers = 2;
bytes body = 3;
} Sidecarkunaqa macOSpi, Linuxpipas purinku.
Maypim Nebo binariota tarin
Appq carpetanpi, Neboqa kaykunamanta ñawpaq kaqtam llamk'achin:
binarysutiyuq archivoappsutiyuq archivotmp/pi ñawpaq archivobin/pi ñawpaq archivosidecar/target/release/pi ñawpaq ejecutable, kaypi desarrollaypaq
Binarioqa normal, ejecutable archivom kanan, mana symbolic linkchu, aswantaq 500 MB. Uyarichisqa appkunaqa bin/<name>pim apanku. Archivo diskopi tikrakuptinqa, Neboqa sidecartam hukmanta qallarichin.
Entorno
Sidecarqa ch'usaq entornowanmi qallarin, kay variablekunawanpas:
| Variable | Chanin |
|---|---|
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSION | Appq riqsichiynin. |
NEBO_APP_DIR | Appq carpetan. |
NEBO_APP_SOCK | Uyarinapaq socket, <app folder>/<id>.sock. Neboqa modonta 0600man churan. |
NEBO_DATA_DIR | Appq willakuy carpetan, <data>/appdata/agents/<id>/. Llamk'ana directoriopas. |
NEBO_API_URL | Botpa kaypi APIn, http://127.0.0.1:<port>. |
NEBO_APP_TOKEN | Botpa app APInta waqyanapaq token. |
PATH, HOME, TMPDIR, LANG, LC_ALL, TZ | Pasachisqa. |
Estándar lluqsiy, estándar pantaypas data carpetapi sidecar.logmanmi rinku. Estándar yaykuyqa pipe; archivopa tukukuyninqa Nebo ripusqanmi ninan, sidecartaq lluqsinan. Sidecarqa kikinpa proceso huñunpim purin.
Paginamanta mañakuykuna
/apps/<id>/api/<path>man mañakuyqa, pagina neboFetchwan relativo ñanwan ruwasqan, HandleRequestmanmi chayan path <path>man churasqa. _wan qallariq ñankunaqa mana chaskisqam. Mañakuy ukhukunaqa 10 MBkamam, kutichiykunataq 32 MBkama.
Llamk'aqpaq herramientakuna
Herramientakunata appq agent.jsonninpi willay. Sapankam app__<app>__<name> sutiyuq herramientaman tikrakun, llamk'aq necesitaptin cargasqa. Waqyayqa sidecarman method, pathpi mañakuymanmi tikrakun.
"tools": [
{
"name": "list_deals",
"description": "List open deals, optionally filtered by stage.",
"method": "GET",
"path": "/deals",
"input_schema": { "type": "object", "properties": { "stage": { "type": "string" } } }
}
] Nebota waqyay
Sidecarqa paginapa kikin serviciokunatam llamk'achiyta atin $NEBO_API_URL/api/v1/apps/$NEBO_APP_ID/...ta waqyaspa Authorization: Bearer $NEBO_APP_TOKEN headerwan.
| Ñan | Ruwan |
|---|---|
GET /storage, GET|PUT|DELETE /storage/<key> | Appq llave-chanin waqaychanan. |
POST /agents/invoke, POST /agents/stream | Llamk'aqta tapun: {message, agent, data}. Stream kutichiykunaqa server-sent eventokunam. |
POST /janus/complete, POST /janus/stream | Modelota chiqallanta waqyay: {messages, model, temperature, max_tokens, system}. |
POST /http/proxy | Hawa mañakuy, {url, method, headers, body}, appq network: permisonkunawan saqisqa. |
GET /identity | Appq llamk'aqnin. |
Kawsay purikuy
- Neboqa sapa kimsa segundopim socketta pruebaykun.
- Pantasqa sidecarqa huk segundo qhipam hukmanta qallarin, iskay kutiman yapakuspa aswanqa 60 segundokama. Pichqa pantaykuna qatinakuptinqa pantasqa hinam marcasqa. 60 segundo prendesqa kaq sidecarqa hukmantam qhali.
- Sayasqa sidecarman mañakuyqa qallarichinmi, 15 segundokamataq suyan. GET, HEAD mañakuykunaqa yapamanta pruebakunmi.
- Sidecarta sayachinapaqqa, Neboqa proceso huñunman SIGTERMta kachan, chaymanta iskay segundo qhipa wañuchin.