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:
- Faịlụ aha ya bụ
binary - Faịlụ aha ya bụ
app - Faịlụ mbụ dị na
tmp/ - Faịlụ mbụ dị na
bin/ - 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:
| Mgbanwe | Uru |
|---|---|
NEBO_APP_ID, NEBO_APP_NAME, NEBO_APP_VERSION | Njirimara ngwa ahụ. |
NEBO_APP_DIR | Folda ngwa ahụ. |
NEBO_APP_SOCK | Socket a ga-ege ntị na ya, <app folder>/<id>.sock. Nebo na-esetịpụ ọnọdụ ya na 0600. |
NEBO_DATA_DIR | Folda data ngwa ahụ, <data>/appdata/agents/<id>/. Ọ bụkwa ndekọ ọrụ. |
NEBO_API_URL | API bot ahụ dị na kọmputa, http://127.0.0.1:<port>. |
NEBO_APP_TOKEN | Token maka ịkpọ API ngwa nke bot ahụ. |
PATH, HOME, TMPDIR, LANG, LC_ALL, TZ | A 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/stream | Na-ajụ onye ọrụ: {message, agent, data}. Azịza iyi bụ server-sent events. |
POST /janus/complete, POST /janus/stream | Oku ụdị AI ozugbo: {messages, model, temperature, max_tokens, system}. |
POST /http/proxy | Arịrịọ gaa n'èzí, {url, method, headers, body}, nke ikike network: nke ngwa ahụ kwere. |
GET /identity | Onye ọ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ị.