بناء وكيل ذكاء اصطناعي مجاني ينفذ إجراءات بدون كود

معظم الشات بوتات لا تستطيع إلا الكلام. إذا سألت أحدها عن سعر بعملتك، أو حالة طلب، أو سعر صرف اليوم، فإما أن يخمن أو يخبرك بأن تتحقق من مكان آخر. أما وكيل الذكاء الاصطناعي الذي ينفذ إجراءات فيفعل العكس: يستدعي API حقيقيًا في منتصف المحادثة، ويقرأ النتيجة، ويجيب بها.

يبني هذا الدليل وكيلًا من حساب فارغ، بدون كود. في النهاية سيكون لديك وكيل يجيب عن الأسئلة من معرفة تزوده بها، ويستدعي REST API مباشرًا أثناء الدردشة، وسترى ذلك يحدث في Inbox. الإجراء الذي تبنيه هنا هو الوصفة الأساسية: طلب HTTP موصوف واحد. وجّهه إلى عنوان URL مختلف، وستسجل الوصفة نفسها عميلًا محتملًا في جدول بيانات، أو تكتب إلى CRM، أو تشرف على خادم دردشة. كل درس تكامل في نهاية هذه المقالة هو مثال عملي عليه.

كل ما يلي بُني واختُبر على وكيل حقيقي. كل محادثة واستدعاء API في لقطات الشاشة أنتجه الوكيل وهو يعمل فعليًا؛ يمكنك إعادة إنتاج كل واحد منها.

ما الذي ستبنيه

وكيل دعم واحد لأداة تخطيط مشاريع خيالية اسمها Meridian. يفعل شيئين من البداية إلى النهاية، في نحو عشر دقائق:

يجيب من المعرفة التي تزوده بها: خطط Meridian وأسعارها وميزاتها.
يستدعي API مباشرًا واحدًا أثناء المحادثة لتحويل سعر إلى عملة الزائر، ثم يستخدم النتيجة في رده.

يستدعي الإجراء Frankfurter، وهو API مجاني لأسعار الصرف لا يحتاج إلى مفتاح، لذلك يمكنك إنهاء كل شيء بحساب Quickchat فقط ودون التسجيل في أي خدمة أخرى. المقصود هو النمط، لا العملات: بمجرد بناء هذا الإجراء، تكون قد بنيت شكل كل تكامل.

ما تحتاج إليه:

حساب Quickchat AI مجاني (سجّل هنا).
لا كود، لا خادم، لا مفتاح API.

ما وكيل الذكاء الاصطناعي، وكيف يختلف عن الشات بوت؟

الشات بوت يجيب. الوكيل يجيب وينفذ إجراءات. في Quickchat، تبني الوكيل من ثلاثة أجزاء.

الأجزاء الثلاثة لوكيل الذكاء الاصطناعي: Identity هو من يكون، وKnowledge هي ما يجيب منه، وActions and MCPs هي ما يستطيع فعله أول جزأين يصنعان شات بوت. الثالث، Actions، يجعله وكيلًا.

Identity هو من يكون الوكيل: اسمه ودوره وتعليماته. هذا هو AI Main Prompt.
Knowledge هي ما يجيب منه: مستنداتك وصفحاتك وحقائقك.
Actions & MCPs هي ما يستطيع فعله: استدعاء API أثناء المحادثة.

أول جزأين يصنعان شات بوت جيدًا. الثالث يجعله وكيلًا. تقضي هذه المقالة معظم وقتها في الجزء الثالث.

ما هي AI Action فعليًا

AI Action هي طلب HTTP موصوف. تملأ الطلب مرة واحدة (الطريقة وعنوان URL والقيم التي سترسلها) وتكتب وصفًا لموعد استخدامه. أثناء المحادثة يقرر النموذج ما إذا كان سيستدعيه ويملأ الأجزاء التي تركتها مفتوحة، وترسل Quickchat الطلب، ثم يقرأ النموذج الاستجابة.

أوضح طريقة لفهم سبب موثوقية ذلك هي تقسيم كل قيمة في الطلب إلى نوعين.

AI Action واحدة هي طلب HTTP موصوف واحد. تثبّت القيم الحتمية مثل الطريقة وعنوان URL والعملة الأساسية؛ ويملأ النموذج قيم الحكم مثل العملة المستهدفة والمبلغ من المحادثة أنت تثبّت القيم الحتمية؛ ويملأ النموذج قيم الحكم من الدردشة. المعلمات هي القيم الوحيدة التي يجب أن يضبطها بشكل صحيح.

القيم الحتمية هي القيم التي تثبتها: الطريقة، عنوان URL، عملة أساسية. لا يمكن للنموذج أن يخطئ فيها لأنه لا يلمسها مطلقًا.
قيم الحكم هي القيم التي يملؤها النموذج من المحادثة: ما العملة التي طلبها الزائر، وأي سعر يجب تحويله. هذه هي القيم الوحيدة التي تحتاج إلى تفكير، والوحيدة التي تضبطها.

تدرج قيم الحكم من قائمة Add AI Data، التي تضع شريحة {{...}} في أي حقل. تعرض هذه القائمة بالضبط الأشياء الثلاثة التي قد يحتاج أي إجراء إلى جلبها:

Parameters التي تحددها (قيم الحكم التي يملؤها النموذج، مثل {{currency}}).
Conversation metadata التي تضبطها القناة (مثل {{conversation_channel}} أو {{metadata_visitor_email}}).
System Tokens: أسرار تخزنها Quickchat وتحقنها، وتظهر كشارة، ولا تُعطى للنموذج مطلقًا.

قائمة Add AI Data مفتوحة على حقل، وتعرض معلمات الإجراء (currency وamount) تحت Parameters، ثم قيم Visitor metadata، ثم Built-in variables مثل scenario_id وconversation_channel تدرج قائمة Add AI Data قيمة كشريحة: معلمة حددتها، أو قيمة زائر أو محادثة، أو متغيرًا مدمجًا.

قيم بيانات المحادثة الوصفية جاهزة للاستخدام دون طلبها. بعض القيم المفيدة:

Variable	ما تحتويه
`{{conversation_channel}}`	القناة التي تجري عليها الدردشة (`widget`، `telegram`، `whatsapp`، وما إلى ذلك)
`{{conversation_url}}`	رابط إلى هذه المحادثة تحديدًا في Inbox
`{{language}}`, `{{country}}`	لغة الزائر وبلده، كرمزين من حرفين
`{{metadata_visitor_email}}`	بريد الزائر الإلكتروني، بعد أن يشاركه
`{{scenario_id}}`, `{{conversation_id}}`	معرّفات هذا الوكيل وهذه المحادثة

بالنسبة إلى هذا الإجراء، تحتاج فقط إلى النوع الأول (المعلمات). تصبح الأنواع الأخرى مهمة عندما توصل خدمة حقيقية؛ تعتمد أدلة HubSpot وDiscord في النهاية على الأنواع الثلاثة كلها.

الخطوة 1: أنشئ الوكيل وأعطه معرفة

سجّل وافتح وكيلًا جديدًا. في صفحة Identity، اضبط AI Agent Name على Meridian والصق هذا في AI Main Prompt. هذا هو حقل الـ prompt المتاح دائمًا في كل خطة؛ لا تحتاج إلى قائمة AI Guidelines المنفصلة.

صفحة Identity لوكيل Meridian، مع ضبط AI Agent Name على Meridian وAI Main Prompt الذي يصف دوره، وكيف يستخدم المعرفة، ومتى يحول العملة، وأن يقول لا عندما لا يعرف توضع تعليمات الوكيل في AI Main Prompt المتاح دائمًا، وليس في قائمة AI Guidelines المنفصلة.

أنت مساعد الدعم لـ Meridian، وهي أداة تخطيط مشاريع لفرق المنتجات. تجيب عن أسئلة زوار موقع Meridian حول الخطط والأسعار والميزات وبدء الاستخدام.

أجب باستخدام معرفتك. كل سعر في معرفتك بالدولار الأمريكي (USD).

عندما يسأل زائر عن تكلفة خطة أو سعر بعملة أخرى، أو يذكر بلده أو عملته المحلية، استدعِ الإجراء "Convert price to currency" بمبلغ الدولار الأمريكي ورمز العملة المستهدفة المكون من 3 أحرف، ثم أعطه كلًا من سعر USD والمبلغ المحول بسعر اليوم.

إذا كنت لا تعرف الإجابة، فقل ذلك بصدق واعرض تحويله إلى الفريق. لا تخمّن أبدًا.

سطران يستحقان وجودهما. السطر المتعلق بـ الدولار الأمريكي يخبر النموذج بمعنى الأسعار في المعرفة، حتى يعرف ما الذي يمرره إلى الإجراء. السطر الأخير، قل ذلك عندما لا تعرف، هو ما ينتج رفضًا صادقًا بدلًا من التخمين. سنختبر كليهما لاحقًا.

الآن أعطه شيئًا يجيب منه. في صفحة Knowledge Base، أضف بضع مقالات قصيرة تحتوي على حقائق Meridian. تعتمد النسخة التجريبية على مقالة التسعير هذه:

لدى Meridian ثلاث خطط، تُحاسب لكل مستخدم شهريًا بالدولار الأمريكي (USD):
- Starter: ‏$19 لكل مستخدم شهريًا. مشاريع غير محدودة، وعرضا timeline وboard، وما يصل إلى 3 تكاملات.
- Pro: ‏$49 لكل مستخدم شهريًا. تضيف تخطيط السبرنت، وتبعيات المهام، والحقول المخصصة، والتكاملات غير المحدودة.
- Business: ‏$99 لكل مستخدم شهريًا. تضيف خرائط طريق المحافظ، والأذونات المتقدمة، وSSO، والدعم ذي الأولوية.
الفوترة السنوية تكلف أقل بنسبة 17% من الشهرية. تبدأ كل خطة بفترة تجربة مجانية مدتها 14 يومًا، ولا يلزم إدخال بطاقة ائتمان.

صفحة Knowledge Base لوكيل Meridian، تعرض ثلاث مقالات مضافة يدويًا (Getting started and support، وWhat Meridian does، وMeridian plans and pricing)، وكل واحدة معلّمة Ready، مع استخدام ثلاث مقالات من خمسين حقائق النسخة التجريبية، مضافة كمقالات قصيرة ومعلّمة Ready. يجيب الوكيل عن أسئلة التسعير من هذه المقالات.

هذا يكفي ليجيب الوكيل عن أسئلة التسعير. اترك شيئًا واحدًا عمدًا، وهو شهادة أمان، حتى يكون لدينا سؤال حقيقي يجب أن لا يستطيع الوكيل الإجابة عنه.

الخطوة 2: وصفة AI Action الأساسية: استدعاء أي REST API

هذا هو الجزء القابل لإعادة الاستخدام. افتح Actions & MCPs، وتحت Custom Actions انقر Add Action، ثم API Action.

تحت Custom Actions، تعرض Add Action خيار API Action أولًا: طلب HTTP موصوف إلى أي REST API.

كل API Action يستخدم النموذج نفسه، وبالترتيب نفسه. تعلمه مرة هنا وستكون كل وصفة لاحقة هي الصناديق نفسها بقيم مختلفة. له نصفان: ما الذي يجب جمعه من الزائر، والطلب الذي يجب إرساله. (يوجد أيضًا مسار مولّد: صف الـ API بلغة عادية ودع Quickchat يبني الإجراء لك، مع اقتباسات من المستندات. هذا الدليل هو النسخة اليدوية من الإجراء نفسه، وهو المكان الأفضل لفهم وظيفة كل حقل.)

القيم التي يجب جمعها

أعلى محرر API Action: حقل API Action Name مضبوط على Convert price to currency، وجدول What to ask the user first يحتوي على معلمتين مطلوبتين، currency (Text) وamount (Decimal Number) أعلى النموذج: API Action Name، والمعلمتان المطلوبتان اللتان يملؤهما النموذج، currency وamount.

API Action Name. اسم قصير يستخدمه النموذج للإشارة إلى الإجراء.

Convert price to currency

What to ask the user first. قيم الحكم، صف واحد لكل قيمة. أعطِ كل واحدة Format، وName، وDescription يخبر النموذج كيف يملؤها، وعلّمها Required حتى لا يستدعي النموذج الإجراء بدونها.

Format	Name	Description	Required
Text	`currency`	رمز ISO للعملة المكوّن من 3 أحرف للتحويل إليها، مثل EUR أو GBP أو JPY. استنتجه من العملة أو البلد الذي يذكره الزائر.	نعم
Decimal Number	`amount`	المبلغ بالدولار الأمريكي المطلوب تحويله، مأخوذ من الخطة أو السعر الذي سأل عنه الزائر.	نعم

“What to ask the user first” هو اسم الحقل في المنتج، لكن الوكيل نادرًا ما يتوقف ليسأل. عندما يكتب الزائر “كم سعر Business باليورو”، يكون لدى النموذج القيمتان بالفعل (amount من معرفتك، وcurrency من “اليورو”) ويملؤهما مباشرة.

الطلب الذي يجب إرساله

النصف السفلي من محرر API Action: طريقة API request مضبوطة على GET، وعنوان API endpoint URL مضبوط على نقطة النهاية latest في Frankfurter، وتبويب Query Params يعرض base مضبوطة على USD وsymbols وamount مضبوطتين على شرائح currency وamount، وAPI Action Description الطلب: GET إلى Frankfurter، مع تثبيت base على USD وإضافة شريحتي currency وamount تحت Query Params.

API request method and endpoint URL. طلب GET إلى نقطة نهاية أحدث الأسعار في Frankfurter:

GET
https://api.frankfurter.dev/v1/latest

Query Params. هنا تلتقي القيم الحتمية وقيم الحكم. أضف ثلاثة صفوف تحت تبويب Query Params. اكتب USD للقيمة base، وبالنسبة إلى القيمتين الأخريين انقر Add AI Data واختر المعلمات التي حددتها، مما يدرج شريحتي {{currency}} و{{amount}}.

Key	Value
`base`	`USD`
`symbols`	`{{currency}}`
`amount`	`{{amount}}`

Headers وBody: لا شيء. هذا طلب GET وكل شيء فيه في سلسلة الاستعلام.

API Action Description. أهم حقل منفرد. هذا ما يقرأه النموذج ليقرر ما إذا كان سيستدعي الإجراء، لذلك اربطه بإشارة واضحة بدلًا من وصف الآلية.

حوّل مبلغًا بالدولار الأمريكي إلى عملة أخرى بسعر صرف اليوم. استدعِ هذا كلما سأل الزائر عن تكلفة سعر أو خطة بعملة غير الدولار الأمريكي، أو ذكر بلده أو عملته المحلية. مرّر المبلغ بالدولار الأمريكي ورمز ISO للعملة المراد التحويل إليها المكوّن من 3 أحرف.

احفظه وفعّل الإجراء on. هذه هي الوصفة كاملة: اسم، والقيم التي يجب جمعها، وطلب، ووصف.

إجراء Convert price to currency النهائي في صفحة Actions and MCPs، مفعّلًا، وموسومًا API Action، ويعرض معدل نجاح استدعاء 100 بالمئة الإجراء النهائي، مفعّل on. تعرض البطاقة عدد استدعاءاته ومعدل نجاحه بنظرة سريعة.

لا يوجد هنا ما يخص العملات تحديدًا. استبدل عنوان URL والاستعلام بـ API الخاص بك وستحصل على إجراء مختلف.

وجّهه إلى API الخاص بك

إجراء Frankfurter هو قراءة: طلب GET ببيانات عامة. API الخاص بك غالبًا يكون النموذج نفسه مع ملء بضعة حقول إضافية.

للكتابة، وليس القراءة فقط، اضبط الطريقة على POST أو PATCH أو DELETE، وضع البيانات في تبويب Body كـ JSON. تعمل شرائح {{...}} نفسها داخل الـ body، لذلك يرسل { "email": "{{email}}" } ما جمعه النموذج.
بالنسبة إلى API يحتاج إلى مفتاح، أضف صفًا تحت تبويب Headers (مثل Authorization) وأدرج المفتاح باستخدام Add AI Data، مع اختيار System Token. تخزن Quickchat السر وتحقنه وقت الاستدعاء، لذلك يظهر كشارة ولا يُعطى للنموذج ولا يُكتب في الـ prompt مطلقًا.
كل شيء آخر مطابق: الاسم، والمعلمات التي يجب جمعها، والوصف الذي يقرر متى يعمل.

يبني دليل HubSpot أربعة إجراءات POST بهذه الطريقة مع رمز OAuth محقون، ويبني دليل Discord سبعة إجراءات مقابل Discord API مع رمز bot في الترويسة. كلاهما يستخدم النموذج نفسه الذي ملأته للتو، مع عنوان URL وbody مختلفين.

الخطوة 3: اختبره وشاهد الاستدعاء يحدث

هذه هي الدورة الكاملة في صورة واحدة: يسأل الزائر، ويملأ النموذج قيم الحكم، وتضيف Quickchat القيم الثابتة وتجري الطلب، ويحمل الرد النتيجة إلى المستخدم.

تدفق من خمس خطوات لاستدعاء AI Action واحد: يسأل الزائر عن سعر باليورو، ويملأ النموذج قيم الحكم (currency EUR، amount 99)، وتضيف Quickchat القيم الثابتة وترسل طلب GET إلى Frankfurter API، ويعيد الـ API السعر المحول، ويرد الوكيل به استدعاء واحد من البداية إلى النهاية: يملأ النموذج قيم الحكم، وتضيف Quickchat القيم الثابتة وتجري الطلب.

تحدث مع وكيلك في AI Preview (في أعلى القائمة اليسرى)، أو على الـ widget المباشر، ثم افتح المحادثة في Inbox. اطرح سؤال تسعير عاديًا أولًا، ثم اطلبه بعملة أخرى:

Visitor: ما سعر خطة Business؟ Meridian: خطة Business تكلف $99 لكل مستخدم شهريًا.

Visitor: كم يساوي ذلك باليورو؟ Meridian: خطة Business تكلف $99 لكل مستخدم شهريًا، وهو ما يعادل نحو €86.81 لكل مستخدم شهريًا بسعر اليوم.

الإجابة الأولى تأتي من المعرفة. الثانية هي عمل الإجراء. لا تحتاج إلى تصديق الرد وحده: تعرض المحادثة علامة 1 action called، وعند توسيعها يظهر الاستدعاء نفسه.

محادثة Meridian في Inbox. يجيب الوكيل عن سعر خطة Business من المعرفة، ثم يحوله إلى اليورو. تعرض بطاقة استدعاء إجراء موسعة أن Convert price to currency أعاد 200 في 85 مللي ثانية، مع إرسال amount 99 وcurrency EUR، واستجابة Frankfurter يجيب الوكيل بـ $99 من المعرفة، ثم يحولها إلى اليورو. تثبت بطاقة 1 action called أن الاستدعاء حدث وأعاد 200.

البطاقة هي الوسط الصادق بين الرسالة والرد. تعرض أن الإجراء أعاد 200، والقيم الدقيقة التي أرسلها النموذج (amount: 99، currency: EUR)، والاستجابة التي أرسلها Frankfurter. عند بناء إجراءك، تكون هذه البطاقة وسجل الاستدعاءات لكل إجراء (إجمالي الاستدعاءات، ومعدل النجاح، وكل طلب واستجابة) هي المكان الذي تؤكد فيه أن الوكيل استدعى الإجراء الصحيح بالقيم الصحيحة، لا أن الرد بدا صحيحًا فقط.

يتعامل الإجراء نفسه مع أي عملة. اسأل عن خطة Starter بالين الياباني وسيستدعي الوكيل Frankfurter باستخدام amount: 19 وcurrency: JPY، ثم يجيب بأن $19 تساوي نحو ¥3,087 بسعر اليوم. الوصفة نفسها، مع قيمة مختلفة ملأها النموذج.

محادثة Meridian حيث يسأل زائر عن خطة Starter بالين الياباني، ويرد الوكيل بأن 19 دولارًا تساوي نحو 3,087 ين لكل مستخدم شهريًا، مع بطاقة استدعاء إجراء تعرض amount 19 وcurrency JPY وتعيد 200 الإجراء نفسه، بعملة مختلفة: يتحول $19 إلى ¥3,087. القيمة التي ملأها النموذج فقط هي التي تغيرت.

سجل كل إجراء يبعد نقرة واحدة. افتح View logs على الإجراء لرؤية كل استدعاء أجراه: الإجمالي، ومعدل النجاح، ولكل استدعاء الطلب الدقيق والاستجابة التي حصل عليها.

سجل إجراء Convert price to currency: استدعاءان، ومعدل نجاح 100 بالمئة، ومتوسط زمن استجابة 144 مللي ثانية، مع عرض كل استدعاء لعنوان URL للطلب، والمعلمات المرسلة (amount وcurrency)، والاستجابة الكاملة من Frankfurter كل استدعاء أجراه الإجراء، مع الطلب والاستجابة والحالة الدقيقة. أعاد كلا التحويلين 200.

الخطوة 4: اجعله موثوقًا

يعمل الإجراء أعلاه من أول محاولة بسبب أربعة اختيارات، كل واحد منها رافعة ستعيد استخدامها في كل تكامل.

علّم المعلمات كمطلوبة. كل من currency وamount مطلوب، لذلك لا يستطيع النموذج استدعاء الإجراء بنصف طلب. المعلمات الاختيارية مخصصة للقيم الاختيارية فعلًا.

دع الوصف يقرر متى يعمل. يقرأ النموذج description، وليس الاسم، لاختيار الإجراء. الوصف الغامض (“يحوّل العملات”) يعمل بشكل غير متوقع. الوصف المرتبط بالإشارة (“استدعِ هذا كلما سأل الزائر عن تكلفة سعر بعملة غير الدولار الأمريكي”) يعمل عندما يجب. عندما يُستدعى إجراء في وقت خاطئ أو لا يُستدعى إطلاقًا، يكون الوصف هو الإصلاح في معظم الحالات.

دع الـ API يجري الحساب، لا النموذج. المحاولة الأولى في إجراء عملات غالبًا تجلب سعر الصرف وتترك الضرب للنموذج. نماذج اللغة ليست حاسبات موثوقة، وإجمالي خاطئ في سؤال تسعير أسوأ من عدم تقديم إجمالي. يقبل Frankfurter معلمة amount ويعيد الرقم المحول بالفعل، لذلك لا يحتاج النموذج إلا إلى قراءة 86.81، لا حسابها. كلما كان بإمكان API إرجاع القيمة النهائية، فضّل ذلك على مطالبة النموذج بحسابها.

تأكد من أنه يقول لا. الموثوقية لا تتعلق بالتشغيل فقط؛ بل تتعلق أيضًا بعدم اختلاق الأشياء. اسأل الوكيل عن شيء لا تغطيه معرفته، وهو شهادة الأمان التي تركتها:

محادثة Meridian حيث يسأل زائر هل Meridian حاصلة على شهادة SOC 2 Type II. يرد الوكيل بأنه لا توجد لديه معلومات عن ذلك في وثائقه، ولا يستطيع تأكيده، ويوصي بالتواصل مع الفريق بدلًا من التخمين كلمة “لا” الصادقة: عندما لا تحتوي معرفته على شيء عن SOC 2، يرفض الوكيل بدلًا من التخمين.

Visitor: هل Meridian حاصلة على شهادة SOC 2 Type II؟ Meridian: لا توجد لدي أي معلومات في وثائقي عن حصول Meridian على شهادة SOC 2 Type II، لذلك لا أستطيع تأكيد ذلك. إذا كنت تحتاج إلى إجابة نهائية لمراجعة أمنية أو شراء، أوصي بالتواصل مع الفريق مباشرة على support@meridian.example.

هذا الرفض هو السطر الأخير من الـ prompt وهو يؤدي وظيفته. الوكيل الذي يستدعي واجهات API حقيقية يجب أن يكون موثوقًا في معرفة حدود ما يعرفه، لذلك اختبر “لا” بقدر تعمدك اختبار “نعم”.

تجعل هذه الروافع الأربع إجراء قراءة واحدًا موثوقًا. الإجراءات التي تكتب، مثل إرجاع، أو استرداد، أو سجل، تحتاج إلى المزيد: يجب ألا تعمل إلا عندما يحدث الشيء الصحيح، وأن تمرر قيمة بشكل نظيف إلى الإجراء التالي. لذلك دليل مستقل: اجعل إجراءات وكيلك موثوقة يغطي تقييد الإجراء بشروط على جهة الخادم لا تستطيع الدردشة تجاوزها، وحمل قيمة ملتقطة إلى إجراءات لاحقة.

النشر المباشر

الإجراء يتبع الوكيل، لا قناة واحدة، لذلك يعمل في كل مكان يُنشر فيه الوكيل. فعّل web widget وسيعمل تحويل العملة نفسه للزائر على موقعك. صِل Telegram، WhatsApp، Messenger، Slack، أو Discord وسيعمل هناك أيضًا، بدون تغيير. لا يوجد شيء يجب إعادته لكل قناة؛ الوكيل المنشور يحمل إجراءاته معه.

إلى أين تذهب بعد ذلك: التكاملات الحقيقية

لقد بنيت الوصفة الأساسية. كل دليل أدناه هو شكل الإجراء نفسه موجّه إلى خدمة حقيقية، لذلك يبدأ كل واحد من شيء تفهمه الآن ولا يضيف إلا ما يخصه.

تسجيل العملاء المحتملين والتقارير في Google Sheets: يضيف الوكيل صفًا عندما تنتج المحادثة عميلًا محتملًا أو ملاحظة.
إنشاء جهات اتصال وصفقات وتذاكر في HubSpot: تصميم CRM للكتابة فقط يملأ سجلًا خطوة بخطوة ولا يقرأ بيانات أي شخص.
الإشراف على خادم Discord: timeout وkick وban كـ AI Actions، مع قفل الإجراءات التدميرية على المشرفين عبر بوابة من جهة الخادم.
تشغيل بوت تذاكر دعم على Discord: ثلاثة إجراءات متسلسلة تفتح thread خاصًا، وتضيف العضو، وتنبه دور الدعم لديك.
إدارة مجموعة Telegram: الإعلان والتثبيت والإشراف بلغة عادية عبر Telegram Bot API.
تحويل وكيلك إلى خادم MCP: أتحه كأداة يستطيع ChatGPT وClaude وCursor استدعاءها.
تشغيل وكيلك وإدارته من ChatGPT: قد الوكيل الذي بنيته من داخل عميل ذكاء اصطناعي عبر MCP.

مرجع الحقول الكامل موجود في مستندات AI Actions.

الأسئلة الشائعة

كيف أبني وكيل ذكاء اصطناعي مجانًا؟

أنشئ حساب Quickchat AI مجانيًا، وأعط الوكيل prompt رئيسيًا قصيرًا وبعض المعرفة التي يجيب منها، ثم أضف AI Action واحدة، وهي طلب HTTP موصوف، حتى يتمكن من استدعاء API أثناء المحادثة. بناء الوكيل، وتحميل المعرفة، وإنشاء الإجراءات وتفعيلها كلها مجانية، ويعمل الدليل كاملًا على الخطة المجانية.

هل أحتاج إلى كتابة كود لبناء وكيل ذكاء اصطناعي؟

لا. تصف الوكيل بلغة عادية وتملأ نموذج إجراء: اسم، والقيم التي يجب جمعها من الزائر، وطريقة الطلب وعنوان URL، ووصف لموعد استدعائه. ترسل Quickchat الطلب وتعيد الاستجابة إلى الوكيل. لن تكتب أو تستضيف أي كود.

كم يستغرق بناء وكيل ذكاء اصطناعي؟

نحو عشر دقائق للوكيل في هذا الدليل: بضع دقائق لكتابة الـ prompt وإضافة حقائقك كمعرفة، وبضع دقائق أخرى لملء نموذج AI Action واحد. لا يوجد شيء لتثبيته ولا كود لكتابته.

ما الفرق بين وكيل الذكاء الاصطناعي والشات بوت؟

الشات بوت يجيب عن الأسئلة. وكيل الذكاء الاصطناعي ينفذ إجراءات أيضًا: يمكنه استدعاء API أثناء المحادثة للبحث عن شيء أو إجراء تغيير، ثم استخدام النتيجة في رده. في Quickchat تبني الوكيل من ثلاثة أجزاء: Identity (من هو)، وKnowledge (ما الذي يجيب منه)، وActions (ما الذي يمكنه فعله).

هل يمكن لوكيل الذكاء الاصطناعي استخدام بيانات مباشرة وفورية؟

نعم. في كل مرة يستدعي فيها الوكيل AI Action يجري طلبًا جديدًا، لذلك يستخدم دائمًا بيانات مباشرة. يجلب الوكيل في هذا الدليل سعر الصرف الحالي في كل تحويل؛ وجّه الإجراء إلى API الخاص بك وسيقرأ بياناتك الحالية بالطريقة نفسها.

هل يمكن لوكيل الذكاء الاصطناعي استدعاء API الخاص بي؟

نعم. AI Action في هذا الدليل هو طلب HTTP عام. وجّهه إلى REST API الخاص بك بدلًا من الـ API العام المستخدم هنا، واضبط الطريقة وعنوان URL والترويسات والـ body، وصف متى يجب على الوكيل استدعاؤه. تعمل الوصفة نفسها مع أي REST API، بما في ذلك واجهات API الخاصة المحمية برمز مصادقة.

هل يمكن أن يكون لوكيل ذكاء اصطناعي واحد أكثر من إجراء؟

نعم. يمكن أن يكون للوكيل كثير من AI Actions، ويختار الإجراء المناسب لكل رسالة بناءً على الأوصاف التي تكتبها. يبني هذا الدليل إجراءً واحدًا للتركيز؛ وتضيف أدلة التكامل عدة إجراءات إلى الوكيل نفسه.

هل يستطيع ChatGPT أو Claude أو Gemini بناء وكيل ينفذ إجراءات؟

يمكنك بناء الوكيل باستخدام Quickchat واختيار النموذج الذي يشغله. أثناء المحادثة يقرر النموذج متى يستدعي إجراءك ويملأ القيم من الدردشة، فيبحث الوكيل عن شيء أو يجري تغييرًا بنفسه. يمكنك أيضًا إتاحة وكيلك النهائي إلى ChatGPT وClaude وCursor كخادم MCP.

ما الذي يمكن للوكيل فعله فعليًا بعد بنائه؟

أي شيء يستطيع REST API فعله. يستخدم هذا الدليل بحثًا مباشرًا عن العملة، لكن شكل الإجراء نفسه يسجل عميلًا محتملًا في Google Sheets، أو ينشئ جهة اتصال في HubSpot، أو يدير الإشراف على خادم Discord، أو يدير مجموعة Telegram. كل واحد من هذه مثال عملي للوصفة الأساسية في هذه المقالة.

كيف يعرف الوكيل متى يستدعي الإجراء؟

وصف الإجراء هو ما يقرأه النموذج لاتخاذ القرار. اربطه بإشارة واضحة، مثل “استدعِ هذا عندما يطلب الزائر سعرًا بعملة غير الدولار الأمريكي”، وعلّم القيم التي يحتاج إليها على أنها مطلوبة. المعلمات هي القيم الوحيدة التي يجب على النموذج ملؤها؛ كل شيء آخر في الطلب ثابت.

هل من الآمن السماح لوكيل ذكاء اصطناعي باستدعاء API؟

تبقى أنت المتحكم في الطلب. تثبّت الطريقة وعنوان URL وأي أسرار (تُحقن من جهة Quickchat ولا تُعرض أبدًا على النموذج)، ولا يملأ النموذج إلا المعلمات التي تحددها. بالنسبة إلى الإجراءات التي تكتب بيانات، يمكنك تقييد الاستدعاء بشروط على جهة الخادم لا تستطيع الدردشة تجاوزها. تشرح أدلة HubSpot وDiscord أنماط الأمان كاملة.

هل البناء والتجربة مجانيان؟

نعم. إنشاء الوكيل، وإضافة المعرفة، وبناء AI Actions وتفعيلها كلها مجانية، ويعمل الدليل كاملًا على الخطة المجانية. عندما تكون مستعدًا لنشر وكيلك لعدد أكبر من الزوار، تضيف الخطط المدفوعة حدودًا أعلى ونماذج أكثر تقدمًا.