Amigo ni nini?
Amigo ni bot ya Telegram ya kijumla ya Croco.Team kwa ajili ya shughuli za masoko. Badala ya zana tofauti za maudhui, mitandao ya kijamii, na uchambuzi, Amigo hutoa kiolesura kilichounganishwa kwa kila kitu ambacho timu ya masoko ya kisasa inahitaji - ikiongozwa na AI na kuongezewa nguvu na kumbukumbu ya kudumu.
Mfumo wa Amri
Amigo inatoa amri 20+ zinazohusu mtiririko kamili wa kazi za masoko:
/trends huonyesha mada zinazovuma sasa zinazohusiana na sekta yako, ikiwa na utambulisho wa chanzo na vipimo vya ushiriki. /content huzalisha mawazo ya maudhui, muhtasari, na rasimu kamili kulingana na ishara zinazovuma na mahitaji ya kampeni. /script hutengeneza miswada ya video, muhtasari wa podcast, na simulizi za mawasilisho. /reels huzalisha dhana za video fupi zilizoboreshwa kwa ajili ya TikTok, Instagram Reels, na YouTube Shorts.
/image huchochea uzalishaji wa picha za AI kwa ajili ya machapisho ya kijamii, matangazo, na vifaa vya masoko. /plan hutengeneza mipango ya kina ya masoko ikiwa na ratiba, mahitaji ya rasilimali, na vipimo vya mafanikio. /analyze hutoa ufahamu wa hadhira, uchambuzi wa washindani, na utambuzi wa utendaji.
/search hufanya utafiti wa kina katika vyanzo vingi kwa wakati mmoja. /translate hushughulikia tafsiri ya maudhui ikiwa na utoaji wa kitamaduni badala ya ubadilishaji wa neno kwa neno. /marketing huzalisha maandishi ya kampeni ya njia nyingi yaliyoboreshwa kulingana na mahitaji ya kila jukwaa. /twitter hutengeneza tweets, mfululizo wa tweets (threads), na majibu yaliyoboreshwa. /linkedin huzalisha machapisho ya kitaalamu, makala, na mbinu za ushiriki.
Amri za ziada zinahusu maudhui ya blogu, utoaji wa maelezo, usimamizi wa kumbukumbu, na utangamano na huduma za nje kama Notion na Google Workspace.
Ukusanyaji wa Vyanzo Vingi
Bot hii hukusanya maudhui na data kutoka vyanzo vingi:
SociaVault hutoa mtiririko wa maudhui ya Twitter, Reddit, na TikTok ikiwa na uchambuzi wa ushiriki na utambuzi wa mada zinazovuma. HikerAPI huunganishwa na Instagram kwa ajili ya ufuatiliaji wa washindani na msukumo wa maudhui. YouTube API huwezesha utafiti wa video, utoaji wa nakala (transcripts), na uchambuzi wa video zinazovuma. Firecrawl hushughulikia utafiti wa wavuti na ufuatiliaji wa maudhui ya washindani. OpenRouter hutumika kama kiolesura kikuu cha LLM ikiwa na ufikiaji wa modeli nyingi kupitia API moja.
Kila chanzo kinatunza matokeo yaliyohifadhiwa (cached) yenye muda wa kuisha wa dakika 30, ili kuepuka miito isiyo ya lazima ya API huku ikihakikisha upya kwa kazi zinazohitaji muda.
Kumbukumbu ya Grafu ya Maarifa
Amigo inadumisha grafu ya maarifa ya kudumu inayoungwa na PostgreSQL ikiwa na pgvector kwa ajili ya utafutaji wa kisemantiki. Utoaji wa vitu (Entity extraction) hutambua watu, kampuni, bidhaa, na dhana zilizotajwa katika mazungumzo. Ufuatiliaji wa uhusiano hujenga miunganisho kati ya vitu hivyo baada ya muda.
Mfumo wa kumbukumbu huwezesha Amigo kurejelea mazungumzo ya awali, kukumbuka mapendeleo ya mtumiaji, na kujenga juu ya muktadha uliowekwa. Badala ya kuanza kila mwingiliano upya, bot hii hukusanya maarifa ya shirika ambayo yanawanufaisha wanachama wote wa timu.
Utangamano wa Outline hutoa kumbukumbu ya ziada - maelezo, shajara, na folda husawazishwa pande zote na seva ya wiki ya Outline. Kurasa mpya zilizoundwa katika Outline zinakuwa zinatafutika katika Amigo; mazungumzo katika Amigo yanaweza kuunda au kusasisha kurasa za Outline.
Usanifu wa Modeli
Amigo hutumia majukumu 10 tofauti ya modeli badala ya kuandika modeli maalum katika msimbo:
Chat hushughulikia mwingiliano wa mazungumzo kwa uchangamfu na ufahamu wa muktadha. Structured huendesha kazi za matokeo ya JSON, ukamilishaji wa fomu, na utoaji wa data. Writer huzalisha maandishi ya masoko, machapisho ya blogu, na maudhui ya kijamii. Plan huzalisha mipango ya mradi, mbinu, na ramani za njia. Translate husimamia maudhui ya lugha mbalimbali ikiwa na utoaji wa kitamaduni.
Marketing huboresha kampeni, huchambua mifumo ya mauzo (funnels), na huzalisha maandishi yanayolenga ubadilishaji (conversion). Embedding hutengeneza uwakilishi wa vector kwa ajili ya utafutaji wa kisemantiki na utambuzi wa ufanano. Image hushughulikia maelekezo ya uzalishaji wa picha. Voice huchakata utoaji wa maandishi ya sauti na usanidi. Video husimamia uchambuzi wa video na uzalishaji wa klipu.
Mtiririko wa Kazi (Workflow Pipeline)
Matokeo yote hupita kwenye kichujio cha mfumo wa matokeo (format-output filter) kinachotumia mabadiliko ya LLM - kuhakikisha toni thabiti, mpangilio sahihi, na viwango vya maelezo vinavyofaa. Hatua ya kuboresha matokeo (polish-output) hutumia mabadiliko ya regex na usafishaji wa ziada wa LLM kwa ajili ya uboreshaji wa mwisho.
Mfumo huu huhakikisha ubora thabiti bila kujali ni modeli gani ya msingi iliyozalisha jibu la awali.
Kumbuka Muhimu ya Usanidi
Unapotumia modeli za mantiki (reasoning models) kupitia OpenRouter, @preset/manager lazima iwe na Reasoning imewekwa kuwa OFF. Modeli za mantiki wakati mwingine hurudisha maudhui tupu (null), jambo ambalo huvunja matarajio ya bot. Kuzima mantiki huhakikisha matokeo thabiti kwa shughuli zote.
Utekelezaji (Deployment)
Amigo inafanya kazi katika Docker Compose ikiwa na huduma tatu: bot yenyewe kwenye port 50501, PostgreSQL ikiwa na pgvector kwenye port 50504, na seva ya wiki ya Outline kwenye port 50505. Uratibu wa mtiririko wa kazi wa Mastra (uliowekwa kwenye v1.33.1) uratibu kazi za hatua nyingi katika mfumo wa wakala.