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

Күтудегі сұрау әкімші интерфейсінде және әкімші API-де (/v1/admin/approvals) көрінеді, онда қараушы құралды, оның аргументтерін және контекстін көреді, содан кейін оны мақұлдайды немесе қабылдамайды.

Мақұлдау — орындау, қабылдамау — орындамау

Қақпа екіұшты емес:

  • Мақұлдау — құрал дәл қаралған аргументтермен орындалады.
  • Қабылдамау — құрал орындалмайды. Жартылай немесе кейінге қалдырылған орындау жоқ; қабылданбаған шақыру жай ғана болмайды, ал кезек сол жанама әсерсіз жалғасады.

[!NOTE] Қабылдамау — сол нақты шақыру үшін қатаң тоқтау. Агент қабылданбаған әрекетті қараушының артынан үнсіз қайталамайды.

Бұл қалпына келтіру кезінде неге қауіпсіз

Мақұлдау қақпалары AiHummer-дің идемпотентті жанама әсерлерімен жұптасады. Кезек үзілуі мүмкін (қайта іске қосу, апат), содан кейін қалпына келтірілуі мүмкін. Қорғаусыз, қалпына келтірілген кезек әлдеқашан болған әрекетті қайта шығаруы мүмкін — сол электрондық хатты екі рет жіберу, сол хабарламаны қайта жариялау.

AiHummer мұны қалпына келтіруге тұрақты тізбе кілті және жанама әсер тосқауылы арқылы болдырмайды: әрбір жанама әсер тұрақты кілт астында тіркеледі, ал тосқауыл тізбеде орындалған деп көрсетілген әсерді қайта іске қосудан бас тартады.

[!TIP] Практикалық пайда: қалпына келтірілген кезекті мақұлдау поштаны немесе арнаға жіберуді екі рет іске қоспайды. Тосқауыл кезек қалпына келтірілгеніне қарамастан, әсердің дәл бір рет болуын қамтамасыз етеді.

Тізбе мен жанама әсер тосқауылының толық механикасы үшін Көпжалгерлік және идемпотенттік бөлімін қараңыз.

Қандай құралдарды қақпалау керектігін таңдау

Әсерлері сырттан көрінетін немесе қайтару қиын құралдарды қақпалаңыз. Жақсы үміткерлер:

  • mail — шығыс электрондық пошта.
  • Арнаға жіберу / клиенттерге немесе қызметкерлерге шығыс жеткізу.
  • http_request және сыртқы жүйелерді өзгерте алатын басқа құралдар.
  • Ортақ хосттардағы code_exec (онда да әдепкі бойынша өшірулі).

Тек оқуға арналған құралдар (іздеу, білім іздеу, уақыт) әдетте қақпаны қажет етпейді. Жария интернетке жететін құралдар үшін мақұлдау қақпаларын air-gapped режим және шығыс басқарулармен біріктіріңіз.

Әрі қарай қайда