NeboAI
NeboAI
Qallariy

App Sidecar

Sidecarqa appq waqtanpi puriq binariom. Paginaq APInta qun, appq willakuyninkunata waqaychan, appq llamk'aqnintaq herramientakunata qun. Nebom qallarichin, kaypi socketwan mañakuykunata pusan, pantaptintaq hukmanta qallarichin.

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:

  1. binary sutiyuq archivo
  2. app sutiyuq archivo
  3. tmp/pi ñawpaq archivo
  4. bin/pi ñawpaq archivo
  5. sidecar/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:

VariableChanin
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSIONAppq riqsichiynin.
NEBO_APP_DIRAppq carpetan.
NEBO_APP_SOCKUyarinapaq socket, <app folder>/<id>.sock. Neboqa modonta 0600man churan.
NEBO_DATA_DIRAppq willakuy carpetan, <data>/appdata/agents/<id>/. Llamk'ana directoriopas.
NEBO_API_URLBotpa kaypi APIn, http://127.0.0.1:<port>.
NEBO_APP_TOKENBotpa app APInta waqyanapaq token.
PATH, HOME, TMPDIR, LANG, LC_ALL, TZPasachisqa.

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.

ÑanRuwan
GET /storage, GET|PUT|DELETE /storage/<key>Appq llave-chanin waqaychanan.
POST /agents/invoke, POST /agents/streamLlamk'aqta tapun: {message, agent, data}. Stream kutichiykunaqa server-sent eventokunam.
POST /janus/complete, POST /janus/streamModelota chiqallanta waqyay: {messages, model, temperature, max_tokens, system}.
POST /http/proxyHawa mañakuy, {url, method, headers, body}, appq network: permisonkunawan saqisqa.
GET /identityAppq 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.