Sidee Wakiilka AI ee Wada-hadalka uga Shaqeeyo Gudaha

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

Sida wakiilka AI-ga wada-sheekeysiga u shaqeeyo dhab ahaanba, wareeg ilaa wareeg? Qoraalkan wuxuu furaa sanduuqa madow ee OpenClaw: laga bilaabo xilliga fariinta 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 dambeeya wada-sheekeysiga.

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

---

Sababta qaab-dhismeedku muhiim u yahay

Wakiilka wada-sheekeysiga oo u muuqda mid shaqeeya demo-ga laakiin 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-sheekeysiga wuu dhintaa.
2. Khayaali aan la xakamayn — wakiilku wuxuu hal-abuuraa qiime, waqti, siyaasad.
3. Macnaha guud oo lumay — macmiilku wuxuu dib u soo noqdaa 2 maalmood ka dib wakiilkuna wuxuu "illoobaa" wax walba.
4. Kharash aan la xakamayn — wada-sheekeysiga kasta oo dheer wuxuu buuxiyaa codsiga oo waxaad bixisaa lacag badan token.

4-ta oo dhan waa doorashooyin qaab-dhismeed, maaha xaddidaadaha moodeelka. OpenClaw waxaa loo dhisay in laga fogaado 4-ta — jidka fahamka ahina waa in la eego wareegga wareeg.

---

Wareegga wareeg (6 marxaladood)

Qiyaas in macmiilku hadda soo diray fariinta "waxaan rabaa inaan balan qaato sabti subaxnimo". Maxaa dhex mara "la helay" iyo jawaabta wakiilka?

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

Fariinta WhatsApp waxay ku timaadaa webhook Meta toos ahaan 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 lambarka taleefanka qaataha (multi-tenant to_number).
3. Caadaynta payload — codku wuxuu noqdaa qoraal, sawirku wuxuu noqdaa sharax, goobtu waxay noqotaa {lat,lng}, qoraalku 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'aamin:

• Taariikhda dhowaan ee wadahadalka (wareegyada N ee ugu dambeeyay ee muhiimka ah).
• Xusuusta muddada dheer ee macmiilka (dookhumaha, taariikhda iibsiga, qoraallada).
• Xaaladda wakiilka (shaqsiyad, 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 haayo ma jiro, gelitaan dhowr ms ah laga bilaabo shaqaalaha, multi-tenant by tenant_id.

Qodobka muhiimka ah: annagu ma rarnaan wadahadalka oo dhan ee tilmaamaha. Memory Manager v2 ee OpenClaw (oo lagu sharraxay dukumeentiyadeenna gudaha) wuxuu doortaa kaliya wareegyada ku habboon wareegga hadda (N ee ugu dambeeyay + N oo leh muhiimad macno ahaan sare). Tani waxay ilaalisa kharashka calaamadda la saadaalin karo xitaa wadahadallo 100+ wareeg ah.

Marxaladda 3 — Xulashada xirfadaha (matoorka siyaasadda, ~20ms)

Wakiil kasta wuxuu leeyahay ururka xirfadaha la heli karo — shaqooyin 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ã", matoorka siyaasaddu wuu shaandheeyo:

• Xirfadaha ku habboon ujeedada la ogaaday (ballan-qabasho).
• Xirfadaha loo oggol yahay marxaladdaan ee wadahadalka (xirfad kasta weligeed ma heli kartid).
• Xirfadaha tenant-kan hawlgeliyay (kalandar wuxuu soo muuqdaa haddii tenant-ku isku daray).

Dhammaadka waxaad haysataa qayb yar oo xirfado ah oo loo gudbiyay moodeelka — ma aha 50-ka suurtagalka ah, kaliya 4-ta halkan macno leh. Tani si weyn ayay u dhimaysaa fursadda moodeelku uu yeedho xirfad khaldan.

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

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

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

Moodeelku wuxuu ka jawaabaa mid laba ka mid ah:

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

Tusaalaha "quero marcar pra sábado de manhã", moodeelku caadi ahaan wuxuu soo celiyaa:

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

Marxaladda 5 — Fulinta oo leh ilaalada (doorsoome, ~100-500ms)

Xirfaddu ma socoto moodeelka. Waxay ku socdaa koodka keena, 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. Fuliso wicitaanka (Google Calendar API xaaladdan).
4. Soo celi natiijo habaysan qaabka.

Maxay taasi muhiim u tahay? Sababtoo ah qaabku weligiis ma samayn natiijada. Haddii kalandarka uu soo celiyo [10h, 11h], waa si sax ah waxa aada wicitaanka xiga. Haddii xirfaddu fashilanto, qaabku wuu ogyahay inay fashilantay. Eber khatarta ah in wakiilku "abuurto" inuu waqti 9h ku leeyahay marka uusan jirin.

Kiisaska ku lug leh macluumaad xasaasi ah (qiimo, muddo, magaca macmiilka), dhuumaha wuxuu ku qasbaayaa tool call — uma oggolaado qaabka inuu ka jawaabo "aqoonta" uu leeyahay. Tani waxay meesha ka saartaa qaybta hallucination-ka ee ugu caansan wakiillada ganacsiga.

Heerka 6 — Jawaab iyo joogteyn (~50ms)

Iyada oo natiijada xirfadda gacanta ku haysa, qaabku wuxuu sameeyaa wicitaanka labaad — hadda si uu u sameeyo jawaabta ugu 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 oo dhan (user + assistant + tool calls + muddada) D1.
3. Cusboonaysiiyaa xusuusta muddada dheer haddii wareeggu soo saaray xaqiiqo cusub (tusaale: "macmiilku wuxuu doorbidayaa sabti").
4. Soo saaraa dhacdo la arki karo (qiyaasta jaagooyinka, kharashka token-ka, heerka kor u qaadista).

Wax walba waxay ku socdaan si is-waafajin ah. Joogtayntu ma xannibayso dirista fariinta — macmiilku ma sugayo D1.

---

Meeqa ku taal difaaca ka hortagga hallucination-ka

Wakiil hallucination sameeya wax soo saarka wuxuu si dhakhso ah u lumiyaa kalsoonida. OpenClaw wuxuu leeyahay 4 khad oo difaac ah:

1. Isha-runta la qasbaayo. Xogta xaqiiqada ah (qiimo, waqti, magac) had iyo jeer waxay ka imaanayaan xirfad, marna kama imaanayaan qaabka keligiis.
2. Xaqiijin labanlaab ah xogta xasaasiga ah. Ballamaha waxaa lagu xaqiijiyaa macmiilka ka hor inta aan la keydsan. Lacag bixinta waxaa lagu xaqiijiyaa ka hor inta aan la siin gelitaanka.
3. Xeerarka diidmada cad. Shakhsiyada wakiil kasta waxaa ku jira "weligaa ha abuurin X, Y, Z" — qaabku wuu addeecaa.
4. Fallback dadka. Marka aan xirfad uusan daboollayn su'aasha, wakiilku wuxuu yiraahda "aan la hubiyo kooxda" oo wuxuu furaa tikit — ma saadaalin.

Baaritaannada aan sameynay 6-kii bilood ee la soo dhaafay (wada hadalladii dhabta ahaa oo gacanta lagu eegay), heerka hallucination-ka xaqiiqada ahi wuxuu ka hooseeyay 0.3% wareegyada — qaar badan oo kiisaska ah waxay ahaayeen qaabeyn (tenant-ku wuu illoobay inuu awood siiyo xirfad khusaysa), maaha khalad qaabka.

---

Kharashka 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 wadahadal dhamaystiran (10-15 wareeg) wuxuu noqdaa: