የAI ይዘት የሥራ ሂደት · የSmartERP መመሪያ

የai-content-generation የሥራ ሂደትን አስመጥተው ከClaude እና ከSmartERP ጋር ያገናኙት።

AI Content Generation የሥራ ሂደት (workflow) አንድ ሰው Generate with AI ሲጫን የልጥፍን መልዕክትና ሃሽታጎች ያዘጋጃል። ፋይሉ n8n/workflows/ai-content-generation.json ነው።

የሚሠራው#

ኖድ	ሥራ
Webhook	የOdoo ጥያቄን በ`social-media-generate-content` መስመር (POST) ይቀበላል፣ ወዲያውኑም ይመልሳል።
Call Claude (Anthropic API)	አጭር መግለጫውን (brief) ወደ Anthropic Messages API ይልካል፣ JSON ብቻ እንዲመልስ ይጠይቃል፦ `{"message": "…", "hashtags": ["…"]}`.
Build Result Payload	ምላሹን ይተነትናል (parse). ጥሪው ካልተሳካ ወይም ምላሹ ትክክለኛ JSON ካልሆነ በምትኩ የውድቀት payload ይገነባል።
Send Result to Odoo	ውጤቱን Odoo ወደላከው `callback_url` `POST` ያደርጋል፣ የጋራ ቁልፉንም እንደ `X-Api-Key` ይልካል።

በሥራ ሂደቱ ውስጥ ያለው Setup Notes የማስታወሻ ወረቀት (sticky note) ከታች ያሉትን ደረጃዎች ይደግማል።

ማዋቀር#

መጀመሪያ SmartERPን ያዋቅሩ። የጋራ የAPI ቁልፉን ያስቀምጡ፤ የwebhook URL ን ደግሞ ካገኙት በኋላ (ደረጃ 3) ያስቀምጡ፦
- Social Media Marketing Automation፦ Social Marketing → Configuration → Automation Settings።
- AI Growth Workforce፦ በየሲስተም ግቤቶች ውስጥ ያሉት የሲስተም ግቤቶች።
ማስመጣት። በn8n ውስጥ Workflows → Import from File ይክፈቱና ai-content-generation.json ን ይምረጡ።
የሥራ ሂደቱን ያንቁ (Activate)፤ ከዚያ የWebhook ኖድ Production URL ን ገልብጠው በSmartERP n8n AI Content Webhook URL ቅንብር ውስጥ ይለጥፉ።
የAI ምስክርነት ያክሉ። Anthropic API Key የሚል ስም ያለው HTTP Header Auth ምስክርነት ይፍጠሩ፤ የheader ስሙ x-api-key ይሁን፣ ዋጋውም የእርስዎ Anthropic የAPI ቁልፍ ይሁን። ወደ Call Claude ኖድ ያያይዙት።

ወደ SmartERP ለሚደረገው callback ምንም ምስክርነት አያስፈልግም፦ የጋራ ቁልፉ በጥያቄው body ውስጥ ይመጣል፣ የሥራ ሂደቱም መልሶ ይልከዋል።

ከፈለጉ ሌላ ማንኛውንም የAI አቅራቢ ወይም ኖድ መተካት ይችላሉ። የመጨረሻው Build Result Payload ደረጃ ብቻ {message, hashtags} ማውጣቱን መቀጠል አለበት።

አጠቃቀም#

ልጥፍ ይክፈቱና ከፈለጉ AI Brief (ስለምን እንደሚጻፍ) ይሙሉ። ባዶ ካደረጉት AI አሁን ካለው መልዕክት ተነስቶ ይሠራል።
Generate with AI ን ይጫኑ። SmartERP "AI Content Requested" (በAI Workforce) ያሳያል፣ የAI ሁኔታንም ወደ Requested ያዘጋጃል።
ከጥቂት ሰከንዶች በኋላ የልጥፉ መልዕክትና ሃሽታጎች ይተካሉ፣ ሁኔታውም Received ይሆናል።

ማስታወሻ

ረቂቁ መልዕክቱን ይተካል። ሰው እንዲገመግመው የመነሻ ነጥብ እንጂ የታተመ ልጥፍ አይደለም። በAI Growth Workforce ውስጥ ደግሞ AI Generated ይሞላል፣ ረቂቁ በሰው ለመገምገም ዝግጁ መሆኑን የሚገልጽ ግቤት በየእንቅስቃሴ መዝገብ ውስጥ ይጻፋል፤ ልጥፉም አሁንም በየማጽደቅ የሥራ ሂደት ይገዛል።

ለAI Growth Workforce ማስተካከል#

አብነቱ prompt ን የሚገነባው ራሱን የቻለው ሞጁል ከሚልካቸው platform እና account_handle ነው። AI Growth Workforce ግን የተለያዩ መስኮችን ይልካል፦

አብነቱ የሚያነበው	AI Workforce በምትኩ የሚልከው
`body.platform`	`body.platforms` (ካርታ (map): `telegram`, `facebook`, `instagram`, `twitter`)
`body.account_handle`	`body.agent` (የወኪሉ ስም)
`body.brief`	`body.brief` (ተመሳሳይ)
`body.callback_url`	`body.callback_url` (ተመሳሳይ)

በCall Claude ኖድ ውስጥ ያለውን prompt በትክክል የሚቀበሏቸውን መስኮች እንዲጠቀም ያርሙት፤ ለምሳሌ ባንዲራቸው true የሆኑትን መድረኮች ይዘርዝሩ። ሳይለወጥ ከቀረ prompt በመድረኩና በhandle ቦታ undefined የሚለውን ቃል ይይዛል።

callback እንዳለ ይሠራል፦ {success, message, hashtags, error} ን ወደ callback_url ይልካል፤ AI Workforce ይህንን ይቀበላል፣ hashtags እንደ ዝርዝር (list) መሆኑንም ጨምሮ።

የችግር መፍቻ#

ምልክት	የሚሆነው ምክንያት
"Configure the n8n AI webhook URL and shared API key first…"	ቅንብሮች ጎድለዋል። ደረጃ 1 ይመልከቱ።
"Could not reach the n8n webhook…" ወይም "Could not reach the AI workflow…"	የተሳሳተ URL, የሥራ ሂደቱ ንቁ አይደለም፣ ወይም n8n ከOdoo ሰርቨር ሊደረስበት አልቻለም።
"AI workflow returned HTTP …"	n8n በስህተት መለሰ። የሥራ ሂደቱን executions ይመልከቱ።
ሁኔታው Requested ሆኖ ይቀራል	n8n callback ማድረግ አልቻለም፦ `web.base.url` የእርስዎ ይፋዊ አድራሻ መሆኑን እና ቁልፉ እንደሚዛመድ ያረጋግጡ።
ሁኔታው Failed ይሆናል	የAI ጥሪው ወይም የJSON ትንተና አልተሳካም። በልጥፉ ላይ ያለው AI Error / Error Message ምክንያቱን ያሳያል።