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:
- Peteĩ archivo héra
binary - Peteĩ archivo héra
app - Peteĩha archivo
tmp/-pe - Peteĩha archivo
bin/-pe - 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:
| Variable | Valor |
|---|---|
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSION | Aplicación jehechakuaa. |
NEBO_APP_DIR | Aplicación carpeta. |
NEBO_APP_SOCK | Socket ojehendutava, <app folder>/<id>.sock. Nebo omoĩ imodo 0600-pe. |
NEBO_DATA_DIR | Aplicación marandu carpeta, <data>/appdata/agents/<id>/. Ha'e avei tembiapoha directorio. |
NEBO_API_URL | Bot API local, http://127.0.0.1:<port>. |
NEBO_APP_TOKEN | Peteĩ token rehenói hag̃ua bot aplicación API. |
PATH, HOME, TMPDIR, LANG, LC_ALL, TZ | Ohasa 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.
| Rape | Ojapo |
|---|---|
GET /storage, GET|PUT|DELETE /storage/<key> | Aplicación ñeñongatu llave-valor. |
POST /agents/invoke, POST /agents/stream | Oporandu peteĩ mba'apohárape: {message, agent, data}. Stream mbohovái ha'e server-sent events. |
POST /janus/complete, POST /janus/stream | Peteĩ modelo ñehenói voi: {messages, model, temperature, max_tokens, system}. |
POST /http/proxy | Peteĩ jerure okayguáva, {url, method, headers, body}, aplicación permiso network: ohejáva. |
GET /identity | Aplicació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.