AiHummer
Кыргызча▾
Кирүү
v1.0.x▾
v1.0.xstable
{ }Swagger
Коопсуздук/Бекитүү дарбазалары

Бекитүү дарбазалары

v1.0.x · жаңыланды 2026-06-26

Кээ бир курал чакыруулары адам “ооба” дебей туруп болбошу керек — почта жөнөтүү, каналга жазуу, чыныгы дүйнөгө таасир тийгизген өзгөртүүлөрдү жасоо. AiHummer’дин бекитүү дарбазалары мындай куралдар иштээрден мурда процесске адамды коёт жана идемпотенттик каптал таасирлер менен бирге иштейт, ошондуктан калыбына келтирилген кадамды бекитүү бир эле аракетти эки жолу жибербейт.

Дарбаза кантип иштейт

Кайсы куралдар бекитүүнү талап кылаарын сиз AIHUMMER_APPROVAL_TOOLS жөндөөсү менен жарыялайсыз — бул куралдардын аттарынын тизмеси. Агент ушул куралдардын бирин чакырууну чечкенде, аткаруу токтотулуп, адам карап чыгуусу үчүн бекитүү суроо-талабы көтөрүлөт.

# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_request

Күтүлүп жаткан суроо-талап admin UI’де жана admin API’де (/v1/admin/approvals) пайда болот, ал жерде карап чыгуучу куралды, анын аргументтерин жана контекстти көрөт, андан кийин аны бекитет же четке кагат.

Бекитүү — иштет дегени, четке кагуу — иштебейт дегени

Дарбаза эки маанилүү эмес:

  • Бекитүү — курал так карап чыгылган аргументтер менен аткарылат.
  • Четке кагуу — курал аткарылбайт. Жарым-жартылай же кийинкиге калтырылган аткаруу жок; четке кагылган чакыруу жөн гана болбойт жана кадам ал каптал таасирсиз улантылат.

[!NOTE] Четке кагуу ошол конкреттүү чакыруу үчүн катуу токтотуу болуп саналат. Агент карап чыгуучунун артынан жашыруун түрдө четке кагылган аракетти кайра аткарбайт.

Эмне үчүн бул калыбына келтирүүдө коопсуз

Бекитүү дарбазалары AiHummer’дин идемпотенттик каптал таасирлери менен бирге иштейт. Кадам үзгүлтүккө учурашы (кайра иштетүү, кыйроо) жана андан кийин калыбына келтирилиши мүмкүн. Коргоосуз болсо, калыбына келтирилген кадам мурда болуп өткөн аракетти кайра чыгарышы мүмкүн — ошол эле почтаны эки жолу жөнөтүү, ошол эле кабарды кайра жазуу.

AiHummer муну калыбына келтирүүдө туруктуу журнал ачкычы жана каптал таасир тосмосу аркылуу алдын алат: ар бир каптал таасир туруктуу ачкыч астында жазылат, ал эми тосмо журналда мурдатан аткарылган деп көрсөтүлгөн таасирди кайра иштетүүдөн баш тартат.

[!TIP] Практикалык пайдасы: калыбына келтирилген кадамды бекитүү почтаны же канал-жөнөтүүнү эки жолу иштетпейт. Тосмо кадам калыбына келтирилгенби же жокпу, таасир так бир жолу болушун камсыздайт.

Журналдын жана каптал таасир тосмосунун толук механикасы үчүн Көп ижарачылык жана идемпотенттик бөлүмүн караңыз.

Кайсы куралдарды дарбаза менен коргоону тандоо

Таасири сырттан көрүнгөн же артка кайтаруу кыйын болгон куралдарды дарбаза менен коргоңуз. Жакшы талапкерлер:

  • mail — чыгуучу почта.
  • Канал-жөнөтүү / кардарларга же кызматкерлерге чыгуучу жеткирүү.
  • http_request жана тышкы системаларды өзгөртө алган башка куралдар.
  • ортоктош хосттордогу code_exec (ал жерде да демейки боюнча өчүрүлгөн).

Окуу гана куралдар (издөө, билимди издөө, убакыт) адатта дарбазаны талап кылбайт. Коомдук интернетке жеткен куралдар үчүн бекитүү дарбазаларын аба-боштугу режими жана чыгуу көзөмөлдөрү менен айкалыштырыңыз.

Кийинки кайда