Panel /noe/agent_fleet zarządza agentami AI (np. Claude Code na różnych komputerach), które co
przebieg czytają runbook - instrukcję złożoną ze stron Markdown + Liquid, zaczynając od main.
Przypisanie łączy runbook z agentem (N:M) i nadaje rolę worker albo lead. Pauzę i stop da się
ustawić na flocie, runbooku, agencie i przypisaniu - obowiązuje najbardziej restrykcyjny.
Autoryzacja: Authorization: Bearer TOKEN (uprawnienie noe/agent_fleet)
Content-Type: application/json; charset=utf-8
Jak zmieniać runbook
Agent co przebieg czyta stronę main, a pozostałe strony tylko wtedy, gdy pasuje ich opis „kiedy
czytać” (when_to_read). Do main system dokleja protokół floty (raporty, claimy, werdykty).
Id runbooka, strony albo agenta jest w adresie strony, na której jest użytkownik.
- Pobierz runbook i jego strony:
GET /noe/agent_fleet/runbooks/:id.jsoniGET /noe/agent_fleet/runbooks/:id/pages.json. - Zmieniaj strony przez
PATCH /noe/agent_fleet/runbooks/:id/pages/:page_id.json, nowe przezPOST .../pages.json. Każdy zapis tworzy wersję strony - poprzednią da się przywrócić w panelu. - Po zmianie sprawdź podgląd:
GET /noe/agent_fleet/runbooks/:id/preview.json?page_code=main&role=worker- polewarningsmusi być puste (błąd Liquid, link do nieistniejącej strony, strona niewidoczna dla roli).
Zasady:
- Zmieniaj tylko to, o co prosi użytkownik - reszta treści strony zostaje słowo w słowo.
- Strona
mainma być krótka: cel, kolejne kroki i odnośniki{{ page_urls.<kod> }}do stron z detalami. Agent czyta ją przy każdym przebiegu - każde zdanie kosztuje tokeny. - Nie wpisuj w treść tokenów, haseł ani kluczy - adres podstawia system (
{{ host }}). - Nie zmieniaj stanu całej floty (pauza / stop) bez wyraźnej prośby.
- Gdy strony każą agentowi wołać API innych modułów (zadania, alarmy, czat), sprawdź, czy
agent_privilegesrunbooka ma potrzebne uprawnienia (tasks,chat, alarmy:automation_incidents, zmiany reguł SLA:automation/escalation, …). Brakujące zaproponuj użytkownikowi, nie dopisuj bez pytania - to dostęp agenta do danych konta.
API Endpoints
| Metoda | Ścieżka | Opis |
|---|---|---|
| PATCH | /noe/agent_fleet/status.json |
Stan całej floty: status = active / paused / stopped
|
| GET | /noe/agent_fleet/runbooks.json |
Lista runbooków |
| GET | /noe/agent_fleet/runbooks/:id.json |
Runbook |
| POST | /noe/agent_fleet/runbooks.json |
Nowy runbook (od razu ze stroną main) |
| PATCH | /noe/agent_fleet/runbooks/:id.json |
Zmiana runbooka |
| DELETE | /noe/agent_fleet/runbooks/:id.json |
Usunięcie runbooka |
| GET | /noe/agent_fleet/library.json?kind=system\|account&q= |
Biblioteka szablonów: systemowe i runbooki konta udostępnione jako szablon |
| GET | /noe/agent_fleet/library/:key.json |
Szablon z ustawieniami i stronami (key = kod systemowy albo runbook-<id>) |
| GET | /noe/agent_fleet/library/:key.md?page_code=main |
Surowy markdown jednej strony szablonu |
| GET | /noe/agent_fleet/runbooks/:id/template_changes.json |
Zmiany szablonu, z którego powstał runbook (per strona: status, safe) |
| POST | /noe/agent_fleet/runbooks/:id/apply_template_changes.json |
Wprowadza zmiany bezpieczne (strony niezmieniane w runbooku) |
| POST | /noe/agent_fleet/runbooks/:id/resolve_template_change.json |
Konflikt strony: page_code, choice = theirs (wersja szablonu) / mine (zostaw) |
| POST | /noe/agent_fleet/runbooks/:id/wake.json |
Przebieg przy najbliższym checkinie (role opcjonalnie) |
| GET | /noe/agent_fleet/runbooks/:id/preview.json?page_code=main&role=worker |
Strona tak, jak zobaczy ją agent, z listą warnings
|
| GET | /noe/agent_fleet/runbooks/:id/preview.md?page_code=main&role=worker |
To samo jako surowy markdown (text/markdown), bez warnings
|
| GET | /noe/agent_fleet/runbooks/:id/pages/:page_id/revisions.json |
Historia wersji strony |
| GET | /noe/agent_fleet/runbooks/:id/pages/:page_id/revisions/:revision_id.md |
Treść jednej wersji jako surowy markdown |
| GET | /noe/agent_fleet/runbooks/:id/pages.json |
Strony runbooka |
| GET | /noe/agent_fleet/runbooks/:id/pages/:page_id.json |
Strona |
| POST | /noe/agent_fleet/runbooks/:id/pages.json |
Nowa strona |
| PATCH | /noe/agent_fleet/runbooks/:id/pages/:page_id.json |
Zmiana strony (zapisuje wersję) |
| DELETE | /noe/agent_fleet/runbooks/:id/pages/:page_id.json |
Usunięcie strony (nie dotyczy main) |
| GET | /noe/agent_fleet/agents.json |
Agenci |
| GET | /noe/agent_fleet/agents/:id.json |
Agent |
| PATCH | /noe/agent_fleet/agents/:id.json |
Zmiana nazwy / stanu agenta |
| GET | /noe/agent_fleet/assignments.json?runbook_id=&agent_id= |
Przypisania |
| POST | /noe/agent_fleet/assignments.json |
Nowe przypisanie |
| PATCH | /noe/agent_fleet/assignments/:id.json |
Zmiana roli / stanu / interwału / priorytetu |
| DELETE | /noe/agent_fleet/assignments/:id.json |
Usunięcie przypisania |
| GET | /noe/agent_fleet/runs.json |
Przebiegi agentów |
| GET | /noe/agent_fleet/runs/:id.json |
Przebieg ze zdarzeniami |
| GET | /noe/agent_fleet/work_items.json |
Sprawy oceniane przez kilku agentów (głosowanie) |
| POST | /noe/agent_fleet/work_items/:id/reopen.json |
Ponowne otwarcie rozstrzygniętej sprawy |
| GET | /noe/agent_fleet/prompts.json |
Prompty floty (protocol, start_loop) |
| GET | /noe/agent_fleet/prompts/:code/edit.md |
Bieżąca treść promptu jako markdown (?version=default - domyślna z Intum) |
| PATCH | /noe/agent_fleet/prompts/:code.json |
Nadpisanie promptu (prompt[content], pusta = domyślna) |
Zakładania agentów i obracania tokenów nie rób przez API - klucz startowy tokenu (ważny 10 minut)
pokazuje się tylko raz, w panelu, administratorowi. Token agenta jest w sejfie tokenów: agent pracuje
na krótkich JWT i sam je odświeża; rejestr wydań i blokada są na stronie tokenu w /account/api_tokens.
Każda zmiana runbooka, strony, agenta, przypisania, promptu i stanu floty (także przez API)
zapisuje się w aktywnościach konta: kto, kiedy i które pola zmienił (treść strony nie - jej
wersje są w historii strony). Historia: GET /account/activities.json?module=noe, dla obiektu
?agent_fleet_runbook_id=ID albo ?agent_fleet_agent_id=ID. Tokenów tam nie ma.
Runbook (runbook[...])
runbook[...])| Pole | Opis |
|---|---|
name |
Nazwa |
code |
Kod w adresie stron dla agenta (/noe/agent_fleet/r/<code>/main.md), małe litery, cyfry, - i _
|
description |
Opis dla ludzi |
status |
active / paused / stopped
|
interval_minutes |
Co ile minut przebieg (1-1440) |
run_as_user_id |
Użytkownik, w imieniu którego agent działa w API (puste = właściciel agenta) |
claim_mode |
single (sprawę bierze jeden agent) albo quorum (ocenia kilku) |
claim_quorum |
Ilu agentów ocenia sprawę w trybie quorum (1-10) |
claim_ttl_minutes |
Po ilu minutach niezamknięty claim wygasa |
decision_by |
verdict (średnia ocen) albo lead (decyduje lider) |
enroll_enabled |
Agenci mogą dołączać sami komendą z tokenem dołączenia |
shared_as_template |
Runbook widoczny w bibliotece jako szablon dla innych w koncie (domyślnie true) |
agent_privileges |
Tablica uprawnień Intum dla tokenów agentów runbooka (runbook[agent_privileges][]=tasks), np. tasks, users, automation, automation_incidents (obsługa alarmów), chat. Pusta = tylko API floty. Agent przypisany do kilku runbooków dostaje sumę, nigdy więcej niż ma jego user. Można dodać tylko uprawnienie, które ma zapisujący (inaczej 422). Zmiana działa od razu, bez nowego tokena |
Runbook z szablonu: parametr template obok runbook[...] w POST /noe/agent_fleet/runbooks.json dodaje
strony szablonu (ustawienia claim_mode, interval_minutes, agent_privileges itd. podaj sam
w runbook[...] - podpowiada je settings z GET /noe/agent_fleet/library/<kod>.json). Kody:
template |
Do czego |
|---|---|
task_executor |
Gotowy: agent bierze zadania Organize w ustalonej kolejności, wykonuje i przekazuje osobie (comment_and_assign) |
task_handoff |
Gotowy, 2 agentów (decision_by: lead): lider zleca zadanie z instrukcją, wykonawca realizuje, lider oddaje wynik |
inalarm_handler |
Gotowy: obsługa alarmów inAlarm - sprawdzenie, informacja na czat, niegroźny alarm acknowledge (stop eskalacji), post mortem w wątku |
secret_number |
Gra do wypróbowania floty (decision_by: lead, quorum 2): lider koduje liczbę 1-100 w zadaniach ze słowem „zgadywanka” w tytule, dwóch wykonawców zgaduje, lider ujawnia liczbę i zamyka zadanie. Potrzebuje 1 agenta z rolą lider i 2 wykonawców |
single, queue, voting, lead_workers, inalert
|
Szkielety do wypełnienia: jeden agent, kolejka, głosowanie (quorum), lider i wykonawcy, ocena alarmów przez 3 agentów |
Zamiast kodu systemowego template może być runbook-<id> - kopia stron runbooka z konta
udostępnionego jako szablon (lista: GET /noe/agent_fleet/library.json). Runbook pamięta źródło
(source_template / source_runbook_id). Gdy źródło się zmieni, nic nie zmienia się samo:
sprawdź template_changes.json, zmiany safe: true wprowadź apply_template_changes, a przy
status: conflict zapytaj użytkownika, którą wersję zostawić (resolve_template_change).
Synchronizowane są tylko strony, nie ustawienia.
W gotowych szablonach strona config (albo notify przy alarmach) ma miejsca ... do uzupełnienia:
źródło zadań, kolejność, limit, user_id odbiorcy, id pokoju czatu.
Strona (runbook_page[...])
runbook_page[...])| Pole | Opis |
|---|---|
code |
Kod strony (main jest stała) |
title |
Tytuł |
when_to_read |
Kiedy agent ma czytać stronę - jedno zdanie, trafia do spisu stron w main
|
audience |
all, worker albo lead - kto widzi stronę |
content |
Treść Markdown + Liquid (przy kind = file: treść pliku, bez Liquid) |
position |
Kolejność w spisie |
kind |
prompt (domyślnie, instrukcja dla agenta) albo file - plik na dysk agenta (skrypt, konfiguracja) |
file_name |
Przy kind = file: nazwa pliku (A-Za-z0-9._-, bez katalogów), unikalna w runbooku |
Zmienne Liquid w treści: host, api_token, agent_name, agent_role, runbook_code,
runbook_name, runbook_version, run_id, claim_mode, claim_quorum, claim_ttl_minutes,
decision_by, page_urls.<kod> (adres innej strony), file_urls.<nazwa pliku>, files_url
(manifest plików), files_dir (katalog plików u agenta), install_url (instalator runnera).
Pliki (kind = file) agent instaluje komendą intum-fleet files <kod runbooka> - runner sprawdza
sumy sha256 i każdą zmianę pokazuje człowiekowi do akceptacji. Kod strony files jest zarezerwowany.
api_token to bieżące krótkie JWT agenta - trafia wtedy do kontekstu modelu. W przykładach curl
lepiej pisać „z nagłówkiem autoryzacji z protokołu” (-H @<plik z nagłówkiem>), bez tej zmiennej.
Przypisanie (assignment[...])
assignment[...])| Pole | Opis |
|---|---|
runbook_id, agent_id
|
Tylko przy tworzeniu |
role |
worker albo lead (lider grupy: rozstrzyga, gdy decision_by = lead) |
status |
active / paused
|
interval_minutes |
Własny interwał (puste = z runbooka) |
priority |
Kolejność, gdy agent ma kilka runbooków (większy = ważniejszy) |