SRVO Script

Az SRVO Script rövid, csak olvasó JavaScriptet futtat egy elkülönített környezetben. A szkript megkapja az args értéket, az srvo.* segítségével a jogosult SRVO-adatokat olvashatja, majd JSON-értéket ad vissza. A jelenlegi hozzáféréseddel fut, csak olvasó műveletekre korlátozva.

Az SRVO Script fokozatosan válik elérhetővé. Jelenleg csak a szerver engedélyezési listáján szereplő munkaterületeken működik. Ha nincs bekapcsolva, a futtatás NOT_AVAILABLE hibát ad.

Első szkript

Ez a szkript a bemeneti adat message értékét adja vissza. Az adatkezelő függvény második paramétere az args.

export default (srvo, args) => {
  return args.message;
};

Az args értékeként például ezt a JSON-t adhatod át: {"message":"Hello"}. A szkript használhat támogatott olvasásokat is, például srvo.records.query(...) vagy srvo.users.me(). A metódusokat, bemeneteket és jogosultságokat az SRVO Script SDK-referencia tartalmazza.

Korlátok

Minden futásra ezek a korlátok érvényesek:

  • 200 ms futásidejű CPU-keret.
  • 80 MiB WebAssembly memória.
  • 10 másodperc teljes futásidő, az SDK-hívásokkal együtt.
  • 20 SDK-hívás.
  • 256 KiB kimenet.

Ha a szkript túllépi a CPU-keretet, a futtató LIMIT_CPU hibát ad. Memóriatúllépésnél a kód LIMIT_MEMORY. A többi korlátnak is saját hibakódja van az eredményben.

Szkript futtatása

A szkriptet CLI-ből, REST API-n vagy MCP-n keresztül indíthatod:

  • CLI: futtasd ezt: srvo core scripts run --source 'export default (srvo, args) => args.message' --args '{"message":"Hello"}'. Az eredményt a srvo core scripts get --run-id <run-id> paranccsal olvashatod be.
  • REST API: küldj POST /api/v1/scripts/runs kérést source és opcionális args mezővel. Kérdezd le a GET /api/v1/scripts/runs/{runId} útvonalat, amíg a futás be nem fejeződik.
  • MCP: hívd meg a runScript műveletet source és opcionális args mezővel, majd hívd meg a getScriptRun műveletet a visszakapott runId értékkel.

Az első válasz runId értéket és running állapotot ad. Az eredmény tartalmazza a kimenetet vagy hibát, valamint a használati adatokat. A futások csak olvasnak. A teljes bemeneti és kimeneti formátumot az API, MCP és CLI referenciája írja le.