Agenti API

Webhooky

Webhook je adresa, na kterou může jiná aplikace poslat požadavek a agent tím spustí úkol. Hodí se to pro e-shop (nová objednávka), formulář, monitoring, n8n nebo Make.

Vytvoření

V nastavení agenta otevřete kartu Crony a webhooky a vytvořte webhook. Dostanete adresu:

https://multibrains.eu/api/hooks/<token>

Adresa se zobrazí jen jednou — uložte si ji. V databázi je z ní jen otisk, takže ji nikdo (ani my) nemůže znovu vypsat.

Volání

curl -X POST https://multibrains.eu/api/hooks/<token> \
  -H 'content-type: application/json' \
  -d '{"objednavka": 1234, "castka": 2490}'

Agent dostane tělo požadavku jako součást úkolu — výchozí text je *Zpracuj tento požadavek: …*. Odpověď obsahuje, co agent udělal.

Bezpečnost

Adresa je veřejná, ale nedá se uhodnout (náhodný token). Kdo ji zná, může agenta spustit — proto ji nikde nezveřejňujte.
Když ji vyzradíte, webhook v kartě smažte a vytvořte nový.
Webhook lze kdykoli vypnout (smazáním) a v kartě vidíte, kolikrát se volal a kdy naposledy.

Co zatím není

Opačný směr — tedy že agent pošle váš server, když dokončí úlohu — zatím v provozu není. Do té doby lze stav zjišťovat v dashboardu nebo přes API (GET /api/v1/agents/{id}).

← Chat a streaming Terminál →