Přeskočit obsah

LogMan.io REST API (lmio-rest-api)

Skill REST API je obecný most ze sandboxu na živou instanci LogMan.io. Ostatní skills (query, detection engineering) na něm staví.

Název skillu lmio-rest-api
Cesta v Knihovně /AI/Skills/lmio-rest-api/SKILL.md
Share lmio → přihlašovací údaje na /workspace/lmio/{instance}.json

K čemu slouží

  • Autentizované HTTP volání na mikroslužby LogMan.io (přes URL instance / NGINX)
  • Objev tenantů
  • Úkoly „zavolej toto API“, které nepokrývá konkrétnější skill
  • Podpůrné skripty pro lmio-query, detection engineering a provoz

Přihlašovací údaje a soubory instance

Každá instance, kterou agent může volat, je popsána JSON souborem na share lmio:

/workspace/lmio/{instance}.json   # BASE_URL + API_KEY

API klíč jde v hlavičce Authorization. Klíče držte na share; nelepte je do chatu zbytečně.

Dodané skripty

Dokumentace a reference skillu jsou v Knihovně; spouštějte skripty z mountu Knihovny v sandboxu:

/library/AI/Skills/lmio-rest-api/scripts/

Nekopírujte skript přes library_read do /workspace jen kvůli spuštění.

Skript Role
lmio-api-get-tenants.py Seznam tenantů (GET /api/seacat-auth/tenant)
lmio-api.py Obecný autentizovaný CLI (metoda, cesta, tělo, formát výstupu)

Příklad:

python3 /library/AI/Skills/lmio-rest-api/scripts/lmio-api-get-tenants.py mylmio

python3 /library/AI/Skills/lmio-rest-api/scripts/lmio-api.py mylmio \
  GET /api/lmio-chart/mytenant/datasources

Výstup a náklady na kontext

CLI ve výchozím stavu používá výstup ZON (Zero Overhead Notation), aby velké API odpovědi spotřebovaly méně tokenů než pretty JSON. Pretty JSON jen když musí číst člověk; velká těla pište do souborů v /workspace místo dumpu do výsledku nástroje.

Request body

Preferujte JSON těla přes stdin v shell_exec (nebo soubor z write_file) místo obřího JSON v řetězci příkazu. Vyhnete se chybám uvozovek a příkazy zůstanou čitelné.

Reference v Knihovně

Pod /AI/Skills/lmio-rest-api/references/ skill dodává poznámky k endpointům, správě API klíčů a příklady (např. email přes messaging integrace). Aktivujte skill a library_read těchto cest podle potřeby.