Веб-интерфейс (Web UI)/Билдирүүлөр, вебхуктар жана расписаниялар
Билдирүүлөр, вебхуктар жана расписаниялар
v1.3.x · жаңыланды 2026-09-15
Бул барак веб UIнин үч экрандарын камтыйт, алар тышкы автоматизацияны жана администратордун эскертүүлөрүн ишке ашырат: Билдирүүлөр, Вебхуктар жана Жоспарлар.
Билдирүүлөр
Бул Билдирүүлөр экранда үч бөлүк бар:
Кирген каттар — категориясы, маанилүүлүгү (маалымат / эскертүү /) боюнча фильтрлери бар окуялар тизмеси
сызык маанилүү) жана «окулбаган гана». Элементке чыкылдоо аны окулган деп белгилейт жана терең шилтеме менен ачат
анын өтмөгү; «Баарын окулган деп белгилөө» бар.
Жеткирүү матрицасы — саптар: иш-чаралар категориялары (кеңейтилиши мүмкүн болгон иш-чаралар менен топтор),
сүрөттөр: каналдар (Веб колдонуучу интерфейси, электрондук почта, Телеграм, push). Ар бир клетка чекбокс; сиз
ар бир топко же ар бир окуяга эрежени коюуга болот. “Маанилүү” топтор дайыма күйгүзүлгөн
Веб UI. Иштебей калган каналдар орнотуу кеңеши менен өчүрүлгөн.
Телеграмга туташуу — байланышкан чатты тизмеси (тамга, бөгөт төшүгү, “Байланышты үз” )
жана бир “Ссылка” терең шилтеме аркылуу баскыч. Электрондук почта каналы даректи талап кылат
текшерүү.
Вебхуктар
Бул Вебхуктар экран — бул чыгуучу HTTP билдирүүлөрү. “+ Create”: URL жана иш-чаранын белгилей турган кутучалары (көп тандоо; бош тандап алуу кабыл алынбайт, turn.completed ал алдын ала текшерилген). Катарлар URL жана жазылган окуяларды көрсөтөт, издөө жана сорттоо менен. Окуянын түрү жиберилет X-AIHummer-Event тектөө.
Бул “Жоспарлар” Экран — бул тапшырма пландаштыруучу: таблица (тапшырма, агент, канал, крон, кийинки иштетүү, абал), анда токтотуу/улантуу, түзөтүү жана өчүрүү. “+ Жаратуу”:
Мээримдүү: repeating (cron өрнөгү, мисалы 0 9 * * *), once (а
күн/убакыт) же reminder.
Максаттуу агент жана сүрөттөө (айтайын деген так эмне жиберилет), маяк канал
(жооп кайда кирет). Адванстагы: чийки JSON маалымат жүктөмүн алмаштыруу.
Бул учурда сиз пландалган аракеттерди мындайча куруйсуз: «ар жумуш күнү саат 9:00дө агент X_PROMPT Zтин натыйжасын канал Yга жиберет».
Кеңейтилген ишке киргизүү параметрлери
repeating, once жана reminder түрлөрүнөн тышкары башкаруу API-си
(/v1/admin/schedules) interval түрүн кабыл алат — anchor_at башталгыч
чекитинен ар interval_ms миллисекунд сайын ишке киргизүү. «Кошумча (JSON
жүгү)» талаасында кадимки prompt-ко аткаруу шарттарын белгилеген
runtime блогун кошсо болот ("version": 1, session_mode жана
"wake_mode": "now" милдеттүү):
session_mode — isolated (ар бир ишке киргизүү жаңы диалогдо) же
conversation_id менен existing (көрсөтүлгөн диалогду улантуу);
timeout_seconds — бир ишке киргизүүнүн мөөнөтү (демейки боюнча 48 саат;
0 таймерди өчүрөт);
thinking — ой жүгүртүү аракети (off … xhigh), light_context —
жеңилдетилген контекст, tools_allow — уруксат берилген куралдардын так
аттары;
failure_alert — after катары менен ийгиликсиз ишке киргизүүдөн кийин
cooldown_ms тыныгуусу менен каналга эскертүү (channel,
target_ref.chat_id);
delete_after_run — ишке киргизгенден кийин аныктаманы өчүрүү (ишке
киргизүү журналы сакталат); best_effort — ырасталбаган жеткирүүнү ката
деп эсептебөө.
Мындай ишке киргизүү максаттуу агентти жана промптту талап кылат. Башка
системадан импорттолгон графиктер тыныгуу абалында түзүлөт жана ээси өзүнчө
күйгүзөт; чечилбеген көз карандылыктары болгончо аларды күйгүзүүгө болбойт.
Кийинки
Каналдар — кайда билдирүүлөр жана эскертүүлөр жөнөтүлөт.
Бул барак веб UIнин үч экрандарын камтыйт, алар тышкы автоматизацияны жана администратордун эскертүүлөрүн ишке ашырат: **Билдирүүлөр**, **Вебхуктар** жана **Жоспарлар**.
## Билдирүүлөр
Бул **Билдирүүлөр** экранда үч бөлүк бар:
- **Кирген каттар** — категориясы, маанилүүлүгү (маалымат / эскертүү /) боюнча фильтрлери бар окуялар тизмеси
сызык маанилүү) жана «окулбаган гана». Элементке чыкылдоо аны окулган деп белгилейт жана терең шилтеме менен ачат
анын өтмөгү; «Баарын окулган деп белгилөө» бар.
- **Жеткирүү матрицасы** — саптар: иш-чаралар категориялары (кеңейтилиши мүмкүн болгон иш-чаралар менен топтор),
сүрөттөр: каналдар (Веб колдонуучу интерфейси, электрондук почта, Телеграм, push). Ар бир клетка чекбокс; сиз
ар бир топко же ар бир окуяга эрежени коюуга болот. "Маанилүү" топтор дайыма күйгүзүлгөн
Веб UI. Иштебей калган каналдар орнотуу кеңеши менен өчүрүлгөн.
- **Телеграмга туташуу** — байланышкан чатты тизмеси (тамга, бөгөт төшүгү, "Байланышты үз" )
жана бир **"Ссылка"** терең шилтеме аркылуу баскыч. Электрондук почта каналы даректи талап кылат
текшерүү.
## Вебхуктар
Бул **Вебхуктар** экран — бул чыгуучу HTTP билдирүүлөрү. "+ Create": URL жана **иш-чаранын белгилей турган кутучалары** (көп тандоо; бош тандап алуу кабыл алынбайт, `turn.completed` ал алдын ала текшерилген). Катарлар URL жана жазылган окуяларды көрсөтөт, издөө жана сорттоо менен. Окуянын түрү жиберилет `X-AIHummer-Event` тектөө.
**20 түрдөгү окуялар** бар:
| Топ | Окуялар |
|---|---|
| Бурмалоолор жана билдирүүлөр | `turn.completed`, `turn.failed`, `message.created`, `conversation.created` |
| Агенттер | `agent.created`, `agent.updated`, `agent.deleted` |
| Плагиндер жана каналдар | `plugin.installed`, `plugin.removed`, `channel.added`, `channel.removed` |
| Иштөө аймактары | `workspace.created` |
| Жоспарлар | `schedule.created`, `schedule.updated`, `schedule.deleted`, `schedule.fired` |
| Макулдашуулар | `approval.requested`, `approval.resolved` |
| Эстутум | `memory.stored`, `memory.captured` |
## Жоспарлар
Бул **"Жоспарлар"** Экран — бул тапшырма пландаштыруучу: таблица (тапшырма, агент, канал, крон, кийинки иштетүү, абал), анда токтотуу/улантуу, түзөтүү жана өчүрүү. "+ Жаратуу":
- **Мээримдүү**: `repeating` (cron өрнөгү, мисалы `0 9 * * *`), `once` (а
күн/убакыт) же `reminder`.
- **Максаттуу агент** жана **сүрөттөө** (айтайын деген так эмне жиберилет), **маяк канал**
(жооп кайда кирет). Адванстагы: чийки JSON маалымат жүктөмүн алмаштыруу.
Бул учурда сиз пландалган аракеттерди мындайча куруйсуз: «ар жумуш күнү саат 9:00дө агент X_PROMPT Zтин натыйжасын канал Yга жиберет».
### Кеңейтилген ишке киргизүү параметрлери
`repeating`, `once` жана `reminder` түрлөрүнөн тышкары башкаруу API-си
(`/v1/admin/schedules`) **`interval`** түрүн кабыл алат — `anchor_at` башталгыч
чекитинен ар `interval_ms` миллисекунд сайын ишке киргизүү. **«Кошумча (JSON
жүгү)»** талаасында кадимки `prompt`-ко аткаруу шарттарын белгилеген
`runtime` блогун кошсо болот (`"version": 1`, `session_mode` жана
`"wake_mode": "now"` милдеттүү):
- `session_mode` — `isolated` (ар бир ишке киргизүү жаңы диалогдо) же
`conversation_id` менен `existing` (көрсөтүлгөн диалогду улантуу);
- `timeout_seconds` — бир ишке киргизүүнүн мөөнөтү (демейки боюнча 48 саат;
`0` таймерди өчүрөт);
- `thinking` — ой жүгүртүү аракети (`off` … `xhigh`), `light_context` —
жеңилдетилген контекст, `tools_allow` — уруксат берилген куралдардын так
аттары;
- `failure_alert` — `after` катары менен ийгиликсиз ишке киргизүүдөн кийин
`cooldown_ms` тыныгуусу менен каналга эскертүү (`channel`,
`target_ref.chat_id`);
- `delete_after_run` — ишке киргизгенден кийин аныктаманы өчүрүү (ишке
киргизүү журналы сакталат); `best_effort` — ырасталбаган жеткирүүнү ката
деп эсептебөө.
Мындай ишке киргизүү максаттуу агентти жана промптту талап кылат. Башка
системадан импорттолгон графиктер тыныгуу абалында түзүлөт жана ээси өзүнчө
күйгүзөт; чечилбеген көз карандылыктары болгончо аларды күйгүзүүгө болбойт.
## Кийинки
- [Каналдар](/ky/v1.0/webui/channels) — кайда билдирүүлөр жана эскертүүлөр жөнөтүлөт.
- [Ичке триггерлер](/ky/v1.0/api/inbound-triggers) — API контекстиндеги вебхуктар.
- [Көзөмөл кылуу жөндөмдүүлүгү](/ky/v1.0/operations/observability) — кайсы окуялар маанилүү.