تخطَّ إلى المحتوى

أمثلة

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

كل مثال يفترض أنك ربطت أداتك بالفعل.

تقول: «انشر “Our new pricing is live” على X غدًا في التاسعة صباحًا.»

يجد مساعدك القناة بـ integrationList، فيعطيه ذلك المعرف ويؤكد أن الحساب على X. ثم يقرأ القواعد بـ integrationSchema، فتعود بحد الأحرف لتلك القناة وبالإعدادات التي يشترطها X. ثم يجدول:

{
"socialPost": [
{
"integrationId": "channel-id",
"isPremium": false,
"date": "2027-09-01T09:00:00.000Z",
"shortLink": false,
"type": "schedule",
"postsAndComments": [
{ "content": "<p>Our new pricing is live</p>", "attachments": [] }
],
"settings": [{ "key": "who_can_reply_post", "value": "everyone" }]
}
]
}

التاريخ بتوقيت UTC. فإن قلت «التاسعة صباحًا» حوله مساعدك من منطقتك الزمنية، ولذلك يستحق الوقت الذي يبلغك به تأكيدًا منك.

النشر على Discord، الذي يحتاج معرف قناة

Section titled “النشر على Discord، الذي يحتاج معرف قناة”

تقول: «أعلن عن الإصدار في Discord لدينا.»

لن يقبل Discord اسم قناة. وتخبر integrationSchema المساعد أن لهذا المزود أداة مساعدة تسرد القنوات، فيستدعيها عبر triggerTool بمعرف القناة واسم الأداة المساعدة. تعيد الأداة قنوات الخادم بمعرفاتها، فيختار المساعد ما قصدته، أو يسألك إن كان الأمر ملتبسًا، ثم يمرر المعرف في الإعدادات:

"settings": [{ "key": "channel", "value": "channel-id" }]

وReddit وPinterest وغيرهما تعمل بالطريقة نفسها. فحين يتوقف مساعدك ليسأل «أي لوحة؟» أو «أي مجتمع subreddit؟»، فهذه هي الخطوة التي يقف عندها.

مقطع Reel على Instagram بصوت رائج

Section titled “مقطع Reel على Instagram بصوت رائج”

تقول: «انشر هذا المقطع كـ Reel مع صوت رائج.»

يوفر Instagram أداة مساعدة للبحث في الأصوات. يستدعيها مساعدك عبر triggerTool باستعلام فارغ، فتعيد الأصوات الرائجة بدل نتائج بحث، فيختار واحدًا ويرفقه:

"settings": [
{ "key": "post_type", "value": "post" },
{ "key": "audio", "value": { "id": "audio-track-id" } }
]

لا يوجد نوع reel: فـ post_type يأخذ post أو story، والفيديو المنفرد المنشور بنوع post ينشر كمقطع Reel. والصوت لا ينطبق إلا على مقاطع Reels، ولا ينطبق أبدًا على القصص.

واطلب أغنية بعينها بدلًا من ذلك، تبحث عنها الأداة نفسها بالاسم.

تقول: «انشر عن الإطلاق على LinkedIn، وأنشئ له صورة.»

يستدعي المساعد generateImageTool بوصف مأخوذ من منشورك. فيعيد ذلك وسائط مخزنة في مكتبتك بالفعل:

{ "id": "media-id", "path": "https://media.example.com/generated.png" }

ثم يضع ذلك path في attachments الخاصة بالمنشور:

"postsAndComments": [
{
"content": "<p>The launch is here</p>",
"attachments": ["https://media.example.com/generated.png"]
}
]

وتصل الصورة إلى مكتبة الوسائط أيضًا، فتستطيع إعادة استخدامها. وإن نفد رصيد الصور لديك أعادت الأداة خطأً، وينبغي أن يخبرك مساعدك بذلك بدل أن ينشر دون الصورة.

وسائط لديك رابطها بالفعل

Section titled “وسائط لديك رابطها بالفعل”

تقول: «انشر هذه الصورة» وتلصق رابطًا من مكان آخر.

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

سلسلة نقاش على X، وتعليق على LinkedIn

Section titled “سلسلة نقاش على X، وتعليق على LinkedIn”

تقول: «اجعلها سلسلة نقاش من ثلاثة أجزاء على X.»

سلاسل النقاش والتعليقات آلية واحدة: postsAndComments قائمة أولها المنشور وكل ما بعده يتبعه.

"postsAndComments": [
{ "content": "<p>Part one</p>", "attachments": [] },
{ "content": "<p>Part two</p>", "attachments": [] },
{ "content": "<p>Part three</p>", "attachments": [] }
]

وعلى LinkedIn يعطيك الشكل نفسه منشورًا بتعليق أول تحته. فما تفعله المنصة بالعناصر الزائدة هو الشيء الوحيد الذي يتغير.

تقول: «انشر هذا على X وLinkedIn وThreads في التاسعة صباحًا.»

استدعاء واحد، وثلاثة مدخلات في socialPost، واحد لكل قناة، لكل منها معرفها وإعداداتها. ويقرأ مساعدك مخطط كل منصة أولًا، لأن ما يشترطه LinkedIn وما يشترطه X ليسا سواء.

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

تقول: «احفظ هذه كمسودات، ولا تنشرها بعد.»

الاستدعاء نفسه مع ضبط type على draft. فتظهر المنشورات في تقويمك خارج قائمة الانتظار، وتنشرها من هناك حين تجهز. استخدم schedule لوضعها في قائمة الانتظار لتاريخ محدد، وnow للنشر فورًا.

والمسودات لا تمر بفحص قواعد المنصة: فالمسودة التي ينقصها إعداد أو يتجاوز نصها الحد المسموح تحفظ مع ذلك، ولا ترفض إلا المسودة التي لا نص فيها ولا صورة. فأكمل ما ينقصها قبل أن تجدولها.