NeboAI
NeboAI
Malite

App Sidecar

Sidecar bụ binary na-agba n'akụkụ ngwa. Ọ na-enye API ibe ahụ, na-edobe data ngwa ahụ, ma na-enye onye ọrụ ngwa ahụ ngwaọrụ. Nebo na-amalite ya, na-ezigara ya arịrịọ site na socket dị na kọmputa, ma na-amalitegharị ya mgbe ọ dara.

Nkwekọrịta ahụ

Sidecar bụ sava gRPC na socket Unix. Gee ntị n'ụzọ dị na NEBO_APP_SOCK ma mejuputa apps.v0.UIService. Nebo na-akpọ HandleRequest maka arịrịọ ọ bụla; HealthCheck na Configure bụ akụkụ nke ọrụ ahụ mana a naghị akpọ ha taa. Socket ahụ ga-apụta n'ime startup_timeout nke manifest, nke ndabara ya bụ sekọnd 10 ma nwee ike ịbụ kacha 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;
}

Sidecar na-agba na macOS na Linux.

Ebe Nebo na-achọta binary

Na folda ngwa ahụ, Nebo na-eji nke mbụ dị n'ime ndị a:

  1. Faịlụ aha ya bụ binary
  2. Faịlụ aha ya bụ app
  3. Faịlụ mbụ dị na tmp/
  4. Faịlụ mbụ dị na bin/
  5. Mmemme mbụ dị na sidecar/target/release/, maka mmepe na kọmputa gị

Binary ahụ ga-abụrịrị faịlụ nkịtị nwere ike ịgba, ọ bụghị symbolic link, ma bụrụ kacha 500 MB. Ngwa e bipụtara na-ebu ya na bin/<name>. Mgbe faịlụ ahụ gbanwere na diski, Nebo na-amalitegharị sidecar ahụ.

Gburugburu

Sidecar na-amalite na gburugburu efu na mgbanwe ndị a:

MgbanweUru
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSIONNjirimara ngwa ahụ.
NEBO_APP_DIRFolda ngwa ahụ.
NEBO_APP_SOCKSocket a ga-ege ntị na ya, <app folder>/<id>.sock. Nebo na-esetịpụ ọnọdụ ya na 0600.
NEBO_DATA_DIRFolda data ngwa ahụ, <data>/appdata/agents/<id>/. Ọ bụkwa ndekọ ọrụ.
NEBO_API_URLAPI bot ahụ dị na kọmputa, http://127.0.0.1:<port>.
NEBO_APP_TOKENToken maka ịkpọ API ngwa nke bot ahụ.
PATH, HOME, TMPDIR, LANG, LC_ALL, TZA na-agafe ya.

Mmepụta nkịtị na njehie nkịtị na-aga na sidecar.log na folda data. Ntinye nkịtị bụ pipe; ngwụcha faịlụ pụtara na Nebo apụọla, sidecar ahụ kwesịkwara ịpụ. Sidecar ahụ na-agba n'otu usoro nke ya.

Arịrịọ sitere n'ibe ahụ

Arịrịọ gaa na /apps/<id>/api/<path>, nke ibe ahụ na-eme site na neboFetch na ụzọ dabere na ya, na-eru HandleRequest ebe path setịpụrụ na <path>. A na-ajụ ụzọ ndị malitere na _. Oke ahụ arịrịọ bụ 10 MB, nke azịza bụ 32 MB.

Ngwaọrụ maka onye ọrụ ahụ

Kwupụta ngwaọrụ na agent.json nke ngwa ahụ. Nke ọ bụla na-aghọ ngwaọrụ aha ya bụ app__<app>__<name>, a na-ebudata ya mgbe onye ọrụ ahụ chọrọ ya. Oku na-aghọ arịrịọ gaa na sidecar na method na path.

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

Ịkpọ Nebo

Sidecar nwere ike iji otu ọrụ ndị ahụ ibe na-eji site n'ịkpọ $NEBO_API_URL/api/v1/apps/$NEBO_APP_ID/... ya na header Authorization: Bearer $NEBO_APP_TOKEN.

ỤzọNa-eme
GET /storage, GET|PUT|DELETE /storage/<key>Ebe nchekwa igodo na uru nke ngwa ahụ.
POST /agents/invoke, POST /agents/streamNa-ajụ onye ọrụ: {message, agent, data}. Azịza iyi bụ server-sent events.
POST /janus/complete, POST /janus/streamOku ụdị AI ozugbo: {messages, model, temperature, max_tokens, system}.
POST /http/proxyArịrịọ gaa n'èzí, {url, method, headers, body}, nke ikike network: nke ngwa ahụ kwere.
GET /identityOnye ọrụ ngwa ahụ.

Ogologo ndụ

  • Nebo na-enyocha socket ahụ sekọnd atọ ọ bụla.
  • Sidecar dara na-amalitegharị mgbe otu sekọnd gasịrị, na-amụba okpukpu abụọ ruo kacha sekọnd 60. Mgbe ọdịda ise n'usoro gasịrị, a na-aka ya akara dị ka nke dara. Sidecar nọgidere na-arụ ọrụ ruo sekọnd 60 adịghachi mma ọzọ.
  • Arịrịọ gaa na sidecar kwụsịrị na-amalite ya ma na-eche ruo sekọnd 15. A na-anwaghachi arịrịọ GET na HEAD.
  • Iji kwụsị sidecar, Nebo na-ezigara otu usoro ya SIGTERM, wee gbuo ya mgbe sekọnd abụọ gasịrị.