Mafunzo ya Agent Autoloop: Wawezeshe mawakala wa mstari wa amri kama Claude Code na Codex kupokea kazi kiotomatiki chinichini na kuendelea kuzifuatilia

Agent Autoloop ni nini?

Agent za mstari wa amri kama Claude Code na Codex kwa kawaida huhitaji mtu kuendelea kuingiliana nazo kwenye terminal: kuingiza kazi, kusubiri utekelezaji, kujibu maswali, kisha kuziruhusu ziendelee. Terminal ikifungwa au mtu akiondoka kwa muda, mchakato mara nyingi hukatizwa.

Agent Autoloop ni mfumo mwepesi wa kiotomatiki unaolenga Agent za mstari wa amri. Unaweka upangaji wa kazi kwenye kiini kisichohitaji utegemezi wa runtime, na hutenganisha vyanzo vya matukio, Agent, njia za arifa na mabomba ya uwasilishaji kuwa programu-jalizi zinazoweza kubadilishwa. Unaweza kuutumia kwenye kompyuta ya ndani ya Mac au Linux bila kununua seva ya wingu wala kufungua mlango wa umma wa mtandao.

Jinsi unavyofanya kazi kwa msingi ni hii: tukio linapoingia, hupewa Agent kulingana na sheria; Agent hutoka baada ya kukamilisha mzunguko mmoja; mfumo huomba uamuzi wako kupitia kadi ya arifa tu unapokutana na operesheni isiyo ya kawaida kama kufuta data, kuanzisha huduma upya, kutumia pesa au kutuma ujumbe kwa watu wengine. Baada ya kujibu, mfumo huendeleza kikao cha awali na kukamilisha kazi iliyosalia.

Sifa kuu

• Uendeshaji wa ndani: Kompyuta moja yenye macOS au Linux inatosha kwa usakinishaji; huhitaji mfumo tofauti wa nyuma wa wingu.
• Kuunganisha Agent kwa urahisi: Zana yoyote ya mstari wa amri inayoweza kupokea prompt na kutoa jibu la mwisho inaweza kuunganishwa kupitia programu-jalizi ya amri ya jumla.
• Hakuna matumizi ya Agent wakati wa kusubiri: Inaposubiri jibu la mtu, mchakato wa Agent hutoka moja kwa moja na hauendelei kutumia Token; hali ya kusubiri huhifadhiwa kwenye hifadhidata.
• Inaendeshwa na sheria: Tumia rules.json kueleza ni tukio gani lipelekwe kwa Agent gani na litekelezwe kwenye saraka gani, bila kuandika msimbo wa kuunganisha.
• Arifa kwa mahitaji: Inasaidia arifa za eneo-kazi, Feishu, pamoja na violezo vya DingTalk, WeCom, Slack na Discord Webhook.
• Kuendeleza kikao: Baada ya mtu kujibu, mazungumzo ya awali yanaweza kuendelea badala ya kuanza kazi upya.
• Ufuatiliaji: Hali huhesabiwa kutoka kwenye kumbukumbu zinazoongezwa tu, hivyo unaweza kuhoji sababu ya kuanzishwa na matokeo ya kila mzunguko wa kazi.
• Muundo wa programu-jalizi: Vyanzo vya matukio, Agent, njia za arifa na mchakato wa uwasilishaji wa CI/CD vinaweza kupanuliwa au kubadilishwa.

Maandalizi kabla ya usakinishaji

Kabla ya kuanza, hakikisha mfumo wako ni macOS au Linux, na zana zifuatazo zimesakinishwa:

• Node 24
• Git
• curl
• Angalau Agent mmoja wa mstari wa amri aliyesakinishwa na kuingia, kama Claude Code au Codex

Huhitaji akaunti ya GitHub kwa usakinishaji na majaribio ya ndani. Agent Autoloop itaita moja kwa moja zana za mstari wa amri zilizopo kwenye kompyuta yako; haisomi wala kuhamisha vitambulisho vya akaunti vya zana hizo.

Hatua ya kwanza: Sakinisha Agent Autoloop

Tekeleza hati rasmi ya usakinishaji kwenye terminal:

curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

Ukitaka kukagua kwanza maelezo ya usakinishaji, soma maelekezo ya usakinishaji ya mradi. README pia inapendekeza kumpa Agent wa ndani maelekezo haya ili akusaidie kukamilisha usakinishaji.

Hatua ya pili: Kamilisha jaribio la kwanza la mwingiliano

Baada ya usakinishaji kukamilika, tekeleza:

agent-autoloop try

Amri hii itatumia Agent wa ndani kuonyesha mchakato mzima: kutuma kazi, Agent kuuliza swali, kutoka na kusubiri, kupokea uamuzi wako, kisha kuendeleza kikao na kukamilisha kazi.

Wakati wa jaribio, utaona matokeo yanayofanana na haya:

Tukio limetumwa, Agent ameanza kufanya kazi…

Agent amemaliza mzunguko huu na kukuuliza swali. Kwa sasa hatumii mchakato wala Token.

【Inasubiri uamuzi wako】#1 Jaribio: chagua rangi
Hili ni jaribio, chaguo lolote ni sawa.
  1. Bluu
  2. Kijani

Kwenye terminal shirikishi, unaweza kuingiza nambari ya chaguo moja kwa moja kisha ubonyeze Enter. Kwenye terminal isiyo shirikishi, unaweza kujibu kadi ya kwanza wazi na kuchagua chaguo la pili:

agent-autoloop answer 1 2

Kisha ulizia hali ya jumla:

agent-autoloop status

Mchakato ukienda vizuri, utaona Agent akiendeleza kikao cha awali na kuthibitisha matokeo ya chaguo. Amri ya hali pia itaonyesha idadi ya mizunguko ya utekelezaji, Token na takwimu za gharama za siku hiyo na siku 7 zilizopita.

Hatua ya tatu: Elewa jinsi kazi zinavyojiendesha

1. Tukio linaingia: Kazi zilizopangwa, GitHub Issue au hitilafu za mfumo wa biashara hubadilishwa kuwa matukio sanifu.
2. Kulinganisha sheria: Kiini huamua kwa kutumia sheria za ndani ni Agent gani atumike na atekeleze kazi kwenye saraka ipi.
3. Tekeleza mzunguko mmoja: Agent hushughulikia kazi, hueleza matokeo katika jibu la mwisho, kisha mchakato hutoka.
4. Omba uamuzi inapohitajika: Ikiwa kuna operesheni inayohitaji uamuzi wa mtu, mfumo hutuma kadi ya arifa na kuhifadhi hali ya kusubiri.
5. Endeleza baada ya jibu: Baada ya kuwasilisha chaguo lako, mfumo hurejesha mazungumzo ya awali na kuendelea kukamilisha kazi.

Kwa kazi zisizohitaji ushiriki wa mtu, Agent anaweza kumaliza moja kwa moja au kupanga ukaguzi wa baadaye. Mfumo pia huunganisha ujumbe mpya kuhusu jambo lilelile unaopokelewa wakati wa kupanga foleni, na kuushughulikia katika mzunguko mmoja wa kazi.

Hatua ya nne: Andika sheria yako ya kwanza ya kiotomatiki

Usanidi wa kila siku unapatikana hapa:

~/.agent-autoloop/rules.json

Kila sheria lazima ieleze angalau inapoanzishwa, inakabidhiwa kwa nani na inafanyiwa kazi kwenye saraka gani. to lazima irejee jina lililopo tayari kwenye agents ya usanidi.

Mfano: Tengeneza taarifa ya asubuhi kila siku saa 9

{
  "name": "Taarifa ya asubuhi",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "Panga madokezo na commits za jana, kisha andika taarifa ya asubuhi ya leo."
}

Sheria hii itakabidhi kazi kila siku saa 9 kwa Agent anayeitwa codex, na kumruhusu kupanga madokezo na commits za Git kwenye saraka ya ~/notes.

Mfano: Shughulikia GitHub Issue mpya

Muundo wa sheria za matukio ya nje unafanana, lakini kwanza unahitaji kusajili chanzo husika cha tukio kwenye sources. Sheria ifuatayo inasikiliza tukio la GitHub la issues.opened:

{
  "name": "Shughulikia issue",
  "when": {
    "source": "github",
    "types": ["issues.opened"]
  },
  "to": "codex",
  "cwd": "~/code/app",
  "skill": "handle-issue",
  "parallel": 3
}

skill hubainisha Skill inayohitajika kushughulikia kazi, na parallel huweka idadi ya kazi zinazoendeshwa kwa wakati mmoja kuwa 3. Usajili wa chanzo cha tukio unapaswa kufanywa kulingana na mwongozo wa usanidi wa mradi.

Baada ya kuhifadhi sheria, itaanza kutumika kiotomatiki ndani ya sekunde chache. Inashauriwa kuendesha ukaguzi mara moja:

agent-autoloop check

Sheria mpya ikiwa na hitilafu, mfumo utaendelea kutumia sheria za zamani na kukuonyesha tatizo mahususi kupitia kadi, hivyo usanidi wenye hitilafu hautakatiza kiotomatiki zilizopo.

Hatua ya tano: Ruhusu Agent kuomba uamuzi wa mtu

Makubaliano makuu ya Agent Autoloop na Agent ni: eleza matokeo katika jibu la mwisho. Kazi ikiwa imekamilika, toa hitimisho kwa kawaida; ikiwa inahitaji chaguo la mtu, ongeza kizuizi cha msimbo cha majibu cha agent-autoloop mwishoni mwa jibu.

Agizo limehakikiwa, na hisa zinatosha.

```agent-autoloop
{
  "ask": [{
    "title": "Jinsi ya kusafirisha?",
    "text": "Njia zote mbili zinaweza kutumwa leo.",
    "options": ["Kurier", "Kujichukulia"],
    "key": "shipping"
  }]
}
```

Hapa, ask itatengeneza kadi ya uamuzi yenye chaguo mbili. Mbali na kuuliza swali, majibu yanaunga mkono vitendo vifuatavyo:

• notice: Tuma arifa.
• resolve: Funga kadi ambayo tayari imetatuliwa.
• later: Panga ukaguzi wa baadaye.
• events: Anzisha matukio mapya.

JSON inayotolewa na Agent ikiwa na hitilafu, mfumo utamwomba tu aiandike upya sehemu ya mwisho ya jibu katika kikao cha awali; hautatekeleza tena operesheni za biashara zilizokamilika. Ikiwa kuandika upya kutashindikana tena, mfumo utahifadhi hitimisho la awali na kukuarifu kuwa jibu halikuanza kutumika.

Tumia violezo vya matukio vilivyo tayari

Mradi unatoa violezo kadhaa vyenye sheria, Skills za kazi na maelekezo ya kuwezesha, ambavyo vinaweza kuwa mwanzo wa usanidi halisi:

• Taarifa ya kila siku: Panga madokezo ya ndani na commits za Git, kisha uyaandike kwenye faili yenye jina la tarehe.
• Ufuatiliaji wa GitHub Issue: Kagua Issue mpya mara kwa mara, rekebisha msimbo ndani na kukuarifu uikague; kwa chaguo-msingi hai-submit, hai-push wala kujibu Issue.
• Uchunguzi wa arifa za uzalishaji: Pokea hitilafu na uchanganue sababu kwa kulinganisha na msimbo; omba idhini kwanza unapofikia operesheni ya kuanzisha upya.
• Ushughulikiaji wa maoni ya watumiaji: Kagua hali ya maoni, rekebisha tatizo, thibitisha uwasilishaji na andaa jibu; uamuzi unapohitajika, uliza kupitia Feishu.
• Ukaguzi wa tovuti: Kagua hali na maudhui muhimu mara kwa mara, epuka arifa zinazorudiwa kutokana na hitilafu inayoendelea, na usasishe kadi ya awali baada ya huduma kurejea.
• Taarifa ya kila wiki ya Feishu na muhtasari wa biashara: Soma ripoti na majedwali yaliyobainishwa kulingana na ruhusa, hifadhi muhtasari kamili ndani na utume maudhui mafupi tu kwa Feishu.
• Uwasilishaji wa PR kiotomatiki: Anza na ukaguzi wa msimbo, subiri CI, unganisha PR, subiri uwasilishaji, kisha hakiki toleo la mtandaoni.

Unapowezesha kiolezo, weka Skill ya kazi kwenye saraka ya skills ya Agent unayotumia, unganisha sheria za mfano kwenye ~/.agent-autoloop/rules.json, badilisha njia na jina la kompyuta, kisha utekeleze agent-autoloop check.

README inaeleza hasa: data za mfano katika kushughulikia maoni, ukaguzi wa tovuti na muhtasari wa Feishu ni za kubuni; script na majibu husika yamethibitishwa tu kupitia HTTP ya ndani na CLI ya Feishu ya kuiga, na bado hayajafanyiwa majaribio kamili kwenye akaunti halisi.

Unganisha Agent na njia tofauti za arifa

Programu-jalizi za Agent zilizojengwa ndani

Mradi una programu-jalizi zilizojengwa ndani za Claude Code, Codex, ACP na amri ya jumla. Claude Code, Codex na adapta rasmi ya Codex ACP tayari zimefanyiwa majaribio ya mizunguko mingi ya maswali na majibu pamoja na kuendeleza vikao kati ya michakato.

Unganisha Agent wengine kupitia amri ya jumla

Kwa Agent wengine wa mstari wa amri, unaweza kuweka use: "command" na kutoa safu ya amri. Kishikilia nafasi {prompt} kitapitishwa kama hoja huru, na hakitatekelezwa kama msimbo wa Shell.

README, kwa kuzingatia nyaraka rasmi za kila zana, imeorodhesha mifano ya amri ya DeepSeek Harness, pi, OpenClaw, Hermes, Cursor na WorkBuddy／CodeBuddy, lakini pia inaeleza wazi kuwa amri hizo bado hazijajaribiwa moja baada ya nyingine. Kwa hiyo, kabla ya matumizi rasmi, thibitisha kwanza hoja, muundo wa matokeo na tabia ya kikao kwenye saraka iliyotengwa.

Sakinisha programu-jalizi za wahusika wengine

Programu-jalizi za wahusika wengine zinaweza kusakinishwa kupitia anwani ya Git:

agent-autoloop add <anwani ya git>

Ukitaka kuunda programu-jalizi yako mwenyewe, anza na violezo vidogo vya programu-jalizi za Agent, njia na matukio vinavyotolewa na mradi, na rejelea maelekezo ya kutengeneza programu-jalizi.

Chagua njia ya arifa

Arifa za eneo-kazi zimewashwa kwa chaguo-msingi. Feishu tayari imejaribiwa kutuma ujumbe, kurejesha majibu ya vitufe na kusasisha kadi. DingTalk, WeCom, Slack na Discord hutumia violezo vya Webhook; kwa sasa vimethibitishwa tu kwenye huduma ya uigaji ya ndani.

Njia hizi za mawasiliano ya maandishi hutuma maamuzi kupitia kiungo cha kujibu, hivyo lazima usanidi hub.publicUrl kuwa anwani inayoweza kufikiwa na simu au kompyuta. Ikiwa ufikiaji wa umma unahitajika hutegemea njia na mazingira ya mtandao utakayochagua, si uendeshaji wa msingi wa ndani wenyewe.

Mbinu za Kina na Muundo wa Uaminifu

Kuuliza kwa nini mzunguko wa kazi uliendeshwa

Tumia amri ya why kuona tukio la kichochezi, toleo la kanuni, mtekelezaji na matokeo ya mwisho ya mzunguko uliobainishwa:

agent-autoloop why 1

Hii ni muhimu hasa katika kuchunguza kanuni zisizo sahihi, matukio yanayojirudia au ugawaji wa kazi usiotarajiwa.

Kuelewa taratibu nne za msingi

• Kusitisha bila matumizi: Wakati wa kusubiri jibu la mtu, mchakato wa Agent hutoka na hali huhifadhiwa kwenye hifadhidata; baada ya jibu, kikao cha awali huendelea.
• Ufuatiliaji wa matukio: Hali zote huhesabiwa kutoka kwenye kumbukumbu inayoongezwa tu; kumbukumbu na faharasa huandikwa kwenye diski katika muamala mmoja, na hali inaweza kujengwa upya kutoka kwenye kumbukumbu baada ya muundo kubadilika.
• Utenganishaji wa maagizo na data: Maudhui ya nje kama kichwa na mwili wa Issue huhifadhiwa kama marejeo, wala hayaunganishwi moja kwa moja kwenye kidokezo. Agent, saraka ya kazi na ruhusa huamuliwa tu na kanuni za kompyuta ya ndani; sehemu za cwd, agent na access katika matukio zitakataliwa.
• Kikata mzunguko wa kina: Matukio mapya yanayochochewa na Agent huongeza kiwango cha kina; maswali ya mtu na ukaguzi wa ratiba hayaanzi upya kiwango hicho. Baada ya kuzidi viwango 8, tukio hurekodiwa tu bila kuendelea kugawa kazi, na kadi hutumwa kwa mtumiaji.

Kuendesha uigaji na vipimo vya utendaji

Ingia kwenye saraka ya programu:

cd ~/.agent-autoloop/app

Kisha unaweza kuendesha amri za uthibitishaji zinazotolewa na README:

node sim/random.ts 24301 200000
node sim/crash.ts 1000 12648430
npm run benchmark

Amri ya kwanza huiga kukatika kwa mtandao, kupotea kwa pakiti, kuanguka kwa mchakato na uwasilishaji unaojirudia; amri ya pili hukagua kwa kulazimisha mchakato kufungwa mara kwa mara ikiwa rekodi zilizothibitishwa zitapotea; amri ya tatu huendesha kipimo cha utendaji. Kiwango cha kufaulu katika README kinategemea Apple M5 Pro, kumbukumbu ya GB 24 na Node 24.21.0; kwenye mashine nyingine huenda kikaonyeshwa kuwa hakijafikiwa kwa sababu ya tofauti za maunzi.

Kadiri kumbukumbu za zamani zinavyoongezeka, uundaji wa muhtasari wa hali huwa wa polepole zaidi, na kumbukumbu pamoja na faharasa huendelea kutumia nafasi ya diski. Uanzishaji wa kwanza baada ya muundo wa data kubadilika unaweza kuhitaji kujenga kila kitu upya, hivyo wakati wa uendeshaji wa muda mrefu unapaswa kufuatilia nafasi ya diski na muda wa kuanza.

Mipaka ya Matumizi ya Mtiririko wa Uwasilishaji

Agent Autoloop hutoa programu-jalizi ya delivery. Baada ya kuongeza lebo ya deliver kwenye GitHub PR, unaweza kuendelea kufuatilia kwa mpangilio wa “kagua msimbo, subiri CI, unganisha PR, subiri uchapishaji, kagua toleo la mtandaoni”.

Usanidi wa ukaguzi na uwasilishaji husomwa kutoka kwenye tawi la main pekee, na msimbo ulio kwenye PR hautachukuliwa wala kuendeshwa kwenye kompyuta inayopokea kazi. Upangaji foleni, uendeshaji sambamba na majaribio ya kurudia hutumia taratibu zilezile za msingi. Kabla ya kuwezesha rasmi, soma maelezo ya mipaka ya usalama ukizingatia ruhusa za hazina na mchakato wa uchapishaji.

Mapendekezo ya Matumizi na Uzingatiaji wa Kanuni

Matumizi ya miundo huhesabiwa kwenye akaunti yako mwenyewe, na viwango pamoja na upeo wa matumizi vinasimamiwa na masharti ya huduma ya mtoa modeli husika. README inaonya kuwa matukio ya otomatiki ya mara kwa mara kwa kawaida yanafaa zaidi kutumia API Key; viwango vya usajili binafsi vinalenga hasa mwingiliano wa kila siku wa kibinadamu. Ukitumia zana hii kutoa huduma kwa wengine, unapaswa kutumia API Key na kuthibitisha mwenyewe masharti ya huduma pamoja na mahitaji ya uzingatiaji wa kanuni.

Agent Autoloop ni mradi huru wa chanzo huria, na hauna uhusiano wa umiliki wala uidhinishaji kutoka kwa watoa modeli kama Anthropic na OpenAI.

Hitimisho

Lengo kuu la Agent Autoloop si kuifanya Agent iwe mtandaoni daima, bali kuwezesha kazi kusitishwa, kusubiri na kuendelea kwa uaminifu. Unaweza kwanza kutumia agent-autoloop try kuthibitisha mzunguko kamili wa mwingiliano, kisha uanze kuandika kanuni kwa kutumia muundo wa taarifa ya kila siku au Issue ya GitHub. Baada ya kuthibitisha kuwa mchakato wa ndani ni thabiti, unganisha hatua kwa hatua Feishu, Webhook, matukio ya nje na mtiririko wa uwasilishaji wa PR.

Kwa usanidi zaidi, soma mwongozo wa usanidi wa kanuni na uwasilishaji, itifaki kamili ya mawasiliano pamoja na nyaraka za uundaji wa programu-jalizi.