Sidee Wakiilka AI ee Wada-hadalka uga Shaqeeyo Gudaha

Sida uu Wakiilka AI-ga Wada-sheekeysiga Gudaha uga Shaqeeyo (Qaab-dhismeedka OpenClaw)

Sida uu wakiilka AI-ga wada-sheekeysiga u shaqeeyo dhab ahaanba, wareeg ilaa wareeg? Qoraalkan wuxuu furaa sanduuqa madow ee OpenClaw: laga bilaabo xilliga farriinta macmiilku ay ku timaado WhatsApp ilaa qoraalka wakiilku dib ugu qoro. Waxay noqon doontaa mid farsamaysan. Waxay qiimo u leedahay haddii aad go'aaminayso qaab-dhismeedka badeecada, haddii aad iibsanayso xal oo aad rabto inaad qiyaasto moolka, ama haddii aad jeceshahay inaad ogaato waxa ka dhacaya gadaasha wada-sheekeysiga.

TL;DR: wareeg kasta wuxuu maraa 6 marxaladood — soo-gelinta, xallinta macnaha guud, xulashada xirfadaha, go'aaminta tallaabada xigta, fulinta iyadoo leh xad-dhaafka, kaydinta xusuusta. Wareegga oo dhan wuxuu ku socdaa <2 ilbiriqsi cidhifka Cloudflare, iyada oo aan server go'an lahayn.

---

Sababta qaab-dhismeedku muhiim u yahay

Wakiilka wada-sheekeysiga oo u muuqda mid shaqeeya demo laakiin ka jabta wax-soo-saarka caadi ahaan wuxuu leeyahay mid ka mid ah 4-tan dhibaato:

1. Raagitaan sare — macmiilku wuxuu sugayaa 8 ilbiriqsi jawaab, wada-sheekeysigu wuu dhintaa.
2. Khayaali aan la xakamayn — wakiilku wuxuu hal-abuuraa qiime, waqti, siyaasad.
3. Macnaha guud oo lumay — macmiilku wuxuu ku soo noqdaa 2 maalmood kadib wakiilkuna wuxuu "illoobaa" wax walba.
4. Kharash aan la xakamayn — wada-sheekeysiga dheer kasta wuxuu buuxiyaa codsiga oo waxaad bixisaa maal badan token.

4-tu waa doorashooyin qaab-dhismeed, maaha xadudaadka moodeelka. OpenClaw waxaa loo dhisay in laga fogaado 4-ta — jidka lagu fahmo waa in la eego wareegga hal wareeg.

---

Wareegga hal wareeg (6 marxaladood)

Qiyaas in macmiilku hadda soo diray farriinta "waxaan rabaa inaan ballan u dhigo sabti subaxnimo". Maxaa dhex mara "la helay" iyo jawaabta wakiilka?

Marxaladda 1 — Soo-gelinta (shaqaalaha cidhifka, <50ms)

Farriinta WhatsApp waxay ku timaadaa webhook Meta toos Cloudflare Worker meesha ugu dhow juqraafiyeed. Barasiile, taasi waxay ka dhigan tahay São Paulo ama Rio, raagitaanka shabakadda < 20ms.

Shaqaaluhu wuxuu sameeyaa saddex shay:

1. Xaqiijinta saxiixa webhook (HMAC ka soo horjeeda sirta WABA).
2. Aqoonsiga tenant-ka lambarka taleefanka qaataha (multi-tenant to_number).
3. Caadaynta payload — codku wuxuu noqdaa qoraal, sawirku wuxuu noqdaa sharaxaad, goobtu waxay noqotaa {lat,lng}, qoraalkuna siduu yahay ayuu ahaanayaa.

Dhammaadka marxaladda 1 waxaad haysataa shay {tenant_id, conversation_id, user_message} diyaar u ah tallaabada xigta.

Marxaladda 2 — Xallinta macnaha guud (D1 + KV, ~80ms)

Wakiilku wuxuu u baahan yahay 3 qayb oo macnaha guud ah ka hor inta uusan go'aan gaarin:

• Taariikhda dhowaan ee wadahadalka (wareegyada ugu dambeeyay ee N ee khuseeya).
• Xusuusta muddada dheer ee macmiilka (dookhumaha, taariikhda iibsiga, qoraallada).
• Xaaladda wakiilka (shakhsiyad, xirfadaha la hawlgeliyay, xeerarka).

Dhammaan waxay ka imanayaan D1 (SQLite-ka la qaybiyay ee Cloudflare). D1 wuxuu beddelaa Postgres/Mongo dhaqameedka — server xog-kaydin la ilaalinayo ma jiro, helitaan dhowr ms ah oo ka socda shaqaalaha, multi-tenant by tenant_id.

Qodobka muhiimka ah: annagu ma rarnaan wadahadalka oo dhan ee tilmaamaha. Memory Manager v2 ee OpenClaw (oo lagu sharaxay dukumeentiyaashayada gudaha) wuxuu doortaa kaliya wareegyada khuseeya wareegga hadda (kuwa ugu dambeeyay N + N oo leh muhiimad semantic sare). Tani waxay ilaalisa kharashka token-ka oo la saadaalin karo xitaa wadahadalada 100+ wareeg ah.

Marxaladda 3 — Doorashada xirfadaha (policy engine, ~20ms)

Wakiil kasta wuxuu leeyahay ururka xirfadaha la heli karo — shaqooyinka uu yeedhsan karo. Tusaalayaal: consultar_calendario, criar_evento, gerar_link_pagamento, consultar_pedido, chamar_humano.

Marka la helo fariinta "quero marcar pra sábado de manhã", policy engine wuxuu shaandheeyo:

• Xirfadaha ku habboon ujeedada la ogaaday (ballan-qaadid).
• Xirfadaha loo oggol yahay marxaladdan wadahadalka (xirfad kasta weligeed ma jirto).
• Xirfadaha tenant-kan hawlgeliyay (kalandar kaliya wuu soo muuqdaa haddii tenant-ku isku dhafay).

Ugu dambeyntii waxaad haysataa qayb yar oo xirfado ah oo loo gudbiyay qaabka — maaha 50-ka suurtagalka ah, kaliya 4-ta halkan macno leh. Tani si weyn ayay u dhimaysaa fursadda qaabku uu yeedho xirfad khaldan.

Marxaladda 4 — Go'aanka (LLM call, 400-1200ms)

Hadda qaabku wuu galayaa. OpenClaw wuxuu sameeyaa wicitaan hal ah oo LLM soohdinta ah (Anthropic Claude, OpenAI GPT, Google Gemini — la habeyn karo tenant kasta) oo leh:

• System prompt = shakhsiyada wakiilka + xeerarka + xirfadaha la heli karo.
• History = wareegyada la doortay marxaladda 2.
• User message = fariinta wareegga hadda.

Qaabku wuxuu ka jawaabaa mid laba ka mid ah:

• Jawaabta ugu dambeysa (qoraal toos ah oo macmiilka u socda).
• Tool call (codsiga in la fuliyo xirfad gaar ah oo leh cabbirro).

Tusaalaha "quero marcar pra sábado de manhã", qaabku sida caadiga ah wuxuu soo celiyaa:

{
  "tool": "consultar_calendario",
  "args": { "date_range": "2026-04-19 06:00 to 12:00" }
}

Marxaladda 5 — Fulinta leh guard-rails (doorsoomaya, ~100-500ms)

Xirfaddu maaha inay ku socoto qaabka. Waxay ku socdaa koodkayaga, kaas oo:

1. Xaqiiji parameetarada (date_range ma qaab sax ah ayay leedahay? ma ku jirtaa xeerarka tenant-ka?).
2. Hubi ogolaanshaha (wakiilkani ma xaq u leeyahay inuu kalandarkan eego?).
3. Fulin wicitaanka (Google Calendar API xaaladdan).
4. Soo celi natiijo qabanqaabaysan moodeelka.

Maxay taasi muhiim u tahay? Sababtoo ah moodeelku weligiis ma samayn natiijooyinka. Haddii kalandarku soo celiyo [10h, 11h], waa sida saxda ah ee u socota wicitaanka xiga. Haddii xirfaddu fashilanto, moodeelku wuu ogaadaa inay fashilantay. Eber khatarta ah in wakiilku "abuuro" inuu waqti 9h ku leeyahay marka uusan jirin.

Kiisaska ku lug leh macluumaad xasaasi ah (qiimo, waqti, magaca macmiilka), dhuumaha ku diraa tool call — uma oggolaato moodeelka inuu ka jawaabo "aqoontiisa" keliya. Tani meesha ka saartaa qaybta khiyaanada ee ugu caansan wakiillada ganacsiga.

Heerka 6 — Jawaabta iyo joogtaynta (~50ms)

Iyada oo leh natiijada xirfadda, moodeelku wuxuu sameeyaa wicitaanka labaad — hadda si uu u sameeyo jawaabta u dambaysa macmiilka. Tusaale:

"Waxaan haystaa Sabti 10h iyo 11h. Kee ayaad doorbidaysaa?"

Isla mar ahaantaana, shaqaalaha:

1. Diraa fariinta dib ugu noqota API-ga WhatsApp.
2. Keydiyaa wareegga buuxa (isticmaale + caawiye + tool calls + muddada) D1.
3. Cusboonaysiiyaa xusuusta muddada dheer haddii wareeggu soo saaray xaqiiqo cusub (tusaale: "macmiilku wuxuu doorbidaa Sabti").
4. Soo saaraa dhacdada la arki karo (cabbirka raagitaanka, qiimaha token-ka, heerka kor u qaadista).

Wax walba waxay ku socdaan isku mar. Keydinta ma xannibayso dirista fariinta — macmiilku ma sugayo D1.

---

Halka ku jirto difaaca khiyaanada

Wakiilka khiyaanada ku sameeya wax-soo-saarka wuxuu si degdeg ah u lumiyaa kalsoonida. OpenClaw wuxuu leeyahay 4 khad oo difaac ah:

1. Isha-runta la qasbay. Xogta xaqiiqada ah (qiimo, waqti, magac) had iyo jeer waxay ka imaanayaan xirfadda, marna moodeelka keligiis.
2. Xaqiijinta labanlaab ee xogta xasaasiga ah. Ballamaha waxaa lagu xaqiijiyaa macmiilka ka hor inta aan la keydinin. Lacag-bixinta waa la xaqiijiyaa ka hor inta aan la siin gelitaanka.
3. Xeerarka diidmada cad. Shakhsiyada wakiil kasta waxaa ku jira "weligaa ha abuurin X, Y, Z" — moodeelku wuu addeecaa.
4. Fallback dadka. Marka aan xirfad midna daboolayso su'aasha, wakiigu wuxuu yiraahdaa "aan la hubiyo kooxda" oo wuxuu furaa tikidh — ma saadaalin.

Baaritaannada aan sameynay lix bilood ee la soo dhaafay (wada-hadallo dhabta ah oo si gacanta ah dib loo eegay), heerka khiyaanada xaqiiqada ah wuxuu ka hoosayay 0.3% wareegyada — qaar badan oo kiisaska ah waxay ahaayeen qaabeyn (tenant-ku wuxuu illoobay inuu awood siiyo xirfad khusaysa), maaha khalad moodeelka.

---

Qiimaha wada-hadal kasta

Naqshadda wanaagsan ma muuqato ilaa aad eegto biilka. Maadaama wareeg kasta uu sameeyo 1-2 wicitaan LLM + raadinta D1, qiimaha caadiga ah ee sheeko dhamaystiran (10-15 wareeg) wuxuu ku dhacaa: