Հաստատման փակագծեր
Որոշ գործիքների կանչեր չպետք է տեղի ունենան առանց մարդու հաստատման — նամակ ուղարկելը, ալիք հրապարակումը, իրական աշխարհում հետևանքներ ունեցող փոփոխություններ կատարելը։ 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Սպասվող հարցումը երևում է ադմին UI-ում և ադմին API-ում
(/v1/admin/approvals), որտեղ ստուգողը տեսնում է գործիքը, նրա արգումենտները և
համատեքստը, ապա հաստատում կամ մերժում է այն։
Հաստատելը նշանակում է գործարկել, մերժելը նշանակում է չգործարկել
Փակագիծը միանշանակ է.
- Հաստատել — գործիքը կատարվում է հենց այն արգումենտներով, որոնք ստուգվել են։
- Մերժել — գործիքը չի կատարվում։ Չկա մասնակի կամ հետաձգված կատարում, մերժված կանչը պարզապես չի կատարվում, և հերթը շարունակվում է առանց այդ կողմնակի էֆեկտի։
[!NOTE] Մերժումը այդ կոնկրետ կանչի համար կոշտ կանգառ է։ Գործակալը լուռ ձևով չի վերափորձում մերժված գործողությունը ստուգողի մեջքի հետևում։
Ինչու է սա անվտանգ վերականգնման ժամանակ
Հաստատման փակագծերը զուգակցվում են AiHummer-ի իդեմպոտենտ կողմնակի էֆեկտների հետ։ Հերթը կարող է ընդհատվել (վերագործարկում, խափանում) և ապա վերականգնվել։ Առանց պաշտպանության, վերականգնված հերթը կարող է կրկին թողարկել գործողություն, որն արդեն տեղի է ունեցել — նույն նամակը երկու անգամ ուղարկելը, նույն հաղորդագրությունը կրկին հրապարակելը։
AiHummer-ը կանխում է սա վերականգնմանը կայուն մատյանի բանալիով և կողմնակի էֆեկտի արգելապատնեշով. յուրաքանչյուր կողմնակի էֆեկտ գրանցվում է կայուն բանալու ներքո, և արգելապատնեշը հրաժարվում է վերագործարկել էֆեկտ, որը մատյանը ցույց է տալիս արդեն կատարված որպես։
[!TIP] Գործնական արդյունքը. վերականգնված հերթի հաստատումը չի կրկնակի թողարկում նամակը կամ ալիք-ուղարկումը։ Արգելապատնեշն ապահովում է, որ էֆեկտը տեղի ունենա ճիշտ մեկ անգամ՝ անկախ նրանից՝ հերթը վերականգնվել է, թե ոչ։
Տես Բազմավարձակալություն և իդեմպոտենտություն մատյանի և կողմնակի էֆեկտի արգելապատնեշի ամբողջական մեխանիկայի համար։
Որ գործիքները փակագծել
Փակագծեք այն գործիքները, որոնց էֆեկտներն արտաքնապես տեսանելի են կամ դժվար հետշրջելի։ Լավ թեկնածուներ.
mail— ելքային էլ. նամակ։- Ալիք-ուղարկում / ելքային առաքում հաճախորդներին կամ անձնակազմին։
http_requestև այլ գործիքներ, որոնք կարող են փոփոխել արտաքին համակարգերը։code_execընդհանուր հոսթերի վրա (այնտեղ նաև անջատված է լռությամբ)։
Միայն-կարդալու գործիքները (որոնում, գիտելիքների որոնում, ժամանակ) ընդհանուր առմամբ փակագիծ չեն պահանջում։ Համատեղեք հաստատման փակագծերը օդանջատ ռեժիմի և ելքի վերահսկողության հետ այն գործիքների համար, որոնք հասնում են հանրային ինտերնետին։
Ուր հաջորդ
- Բազմավարձակալություն և իդեմպոտենտություն — ճիշտ-մեկ-անգամ էֆեկտների հետևում գտնվող մատյանը և կողմնակի էֆեկտի արգելապատնեշը։
- Պաշտպանական պատնեշներ և prompt-injection-ից պաշտպանություն — թույլ մի տվեք, որ մոդելը չարամտորեն ուղղորդվի փակագծված գործիք կանչելու։
- Ցանց, աուդիտ և օդանջատ — սահմանափակեք, թե ինչին կարող են հասնել գործիքները։