NeboAI
NeboAI
Eñepyrũ

App Sidecar

Peteĩ sidecar ha'e peteĩ binario omba'apóva peteĩ aplicación ykére. Ome'ẽ kuatiarogue API, oñongatu aplicación marandu ha ome'ẽ aplicación mba'apohárape tembiporu. Nebo omoñepyrũ, ombohape jerure hese peteĩ socket local rupive ha omoñepyrũ jey ndoikóirõ.

Contrato

Peteĩ sidecar ha'e peteĩ servidor gRPC peteĩ Unix socket-pe. Ehendu rape NEBO_APP_SOCK-pe ha eimplementa apps.v0.UIService. Nebo ohenói HandleRequest opaite jerurépe g̃uarã; HealthCheck ha Configure oĩ servicio-pe ha katu ndojehenóii ko'ag̃agua. Socket ojehechava'erã manifiesto startup_timeout aja, ijypýpe 10 segundo ha ikatu oguereko 120 peve.

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;
}

Sidecar-kuéra omba'apo macOS ha Linux-pe.

Moõpa Nebo ojuhu binario

Aplicación carpeta-pe, Nebo oipuru peteĩha ko'ãvagui oĩva:

  1. Peteĩ archivo héra binary
  2. Peteĩ archivo héra app
  3. Peteĩha archivo tmp/-pe
  4. Peteĩha archivo bin/-pe
  5. Peteĩha ejecutable sidecar/target/release/-pe, desarrollo local-pe g̃uarã

Binario ha'eva'erã peteĩ archivo jepiguáva ha ikatúva oñemboguata, ndaha'éi peteĩ enlace simbólico, ha 500 MB peve. Aplicación oñemoherakuãva ogueraha bin/<name>-pe. Archivo oñemoambue jave disco-pe, Nebo omoñepyrũ jey sidecar.

Tekoha

Sidecar oñepyrũ peteĩ tekoha nandi ha ko'ã variable reheve:

VariableValor
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSIONAplicación jehechakuaa.
NEBO_APP_DIRAplicación carpeta.
NEBO_APP_SOCKSocket ojehendutava, <app folder>/<id>.sock. Nebo omoĩ imodo 0600-pe.
NEBO_DATA_DIRAplicación marandu carpeta, <data>/appdata/agents/<id>/. Ha'e avei tembiapoha directorio.
NEBO_API_URLBot API local, http://127.0.0.1:<port>.
NEBO_APP_TOKENPeteĩ token rehenói hag̃ua bot aplicación API.
PATH, HOME, TMPDIR, LANG, LC_ALL, TZOhasa jeýva.

Salida estándar ha jejavy estándar oho sidecar.log-pe marandu carpeta-pe. Entrada estándar ha'e peteĩ pipe; archivo paha he'ise Nebo oho ha sidecar osẽva'erã. Sidecar omba'apo iproceso aty ae-pe.

Jerure kuatiaroguégui

Peteĩ jerure /apps/<id>/api/<path>-pe, kuatiarogue ojapóva neboFetch ha peteĩ rape relativo reheve, og̃uahẽ HandleRequest-pe path oñemoĩva <path>-pe. Rape oñepyrũva _-pe oñemboyke. Jerure rete oguereko 10 MB peve ha mbohovái 32 MB peve.

Tembiporu mba'apohárape g̃uarã

Emombe'u tembiporu aplicación agent.json-pe. Peteĩteĩ oiko tembiporu héra app__<app>__<name>, ojemyenyhẽva mba'apohára oikotevẽ jave. Peteĩ ñehenói oiko jerure sidecar-pe method ha path-pe.

"tools": [
  {
    "name": "list_deals",
    "description": "List open deals, optionally filtered by stage.",
    "method": "GET",
    "path": "/deals",
    "input_schema": { "type": "object", "properties": { "stage": { "type": "string" } } }
  }
]

Ñehenói Nebo-pe

Sidecar ikatu oipuru umi servicio voi kuatiaroguéicha ohenóivo $NEBO_API_URL/api/v1/apps/$NEBO_APP_ID/... encabezado Authorization: Bearer $NEBO_APP_TOKEN reheve.

RapeOjapo
GET /storage, GET|PUT|DELETE /storage/<key>Aplicación ñeñongatu llave-valor.
POST /agents/invoke, POST /agents/streamOporandu peteĩ mba'apohárape: {message, agent, data}. Stream mbohovái ha'e server-sent events.
POST /janus/complete, POST /janus/streamPeteĩ modelo ñehenói voi: {messages, model, temperature, max_tokens, system}.
POST /http/proxyPeteĩ jerure okayguáva, {url, method, headers, body}, aplicación permiso network: ohejáva.
GET /identityAplicación mba'apohára.

Tekove rape

  • Nebo ohecha socket opa mbohapy segundo.
  • Peteĩ sidecar ndoikóiva oñepyrũ jey peteĩ segundo rire, mokõi jey ohóvo 60 segundo peve. Po jejavy hupigua rire oñemarka ndoikóiva ramo. Peteĩ sidecar opytáva omba'apo 60 segundo oĩ porã jey.
  • Peteĩ jerure sidecar ojejokóvape omoñepyrũ ha oha'arõ 15 segundo peve. Jerure GET ha HEAD oñeha'ã jey.
  • Ojoko hag̃ua peteĩ sidecar, Nebo omondo SIGTERM iproceso atýpe, upéi ojuka mokõi segundo rire.