اطلب التفريغ مرة واحدة واحتفظ بمعرفه
تنتظر أداة transcribe اكتمال التفريغ وتعيد الصفحة الأولى. إذا لم ينته بعد، تحتفظ بقيمة id وتتابع الطلب عبر get_transcription. راجع معاملات الأداتين في توثيق أدوات MCP.
افصل في تعليمات الوكيل بين إنشاء طلب ومتابعته. الإنشاء يبدأ العمل وقد يستهلك دقائق التفريغ الصوتي. أما قراءة طلب موجود فتتيح معرفة حالته أو استرجاع النص بعد اكتماله.
احفظ id في حالة المهمة الدائمة، خارج نافذة محادثة النموذج. بذلك يستطيع الوكيل متابعة العمل بعد إعادة تشغيله. وعند معالجة عدة فيديوهات، احتفظ بالرابط بجانب معرف كل طلب.
يمكن مطابقة رابط المنشور الكامل مع تفريغ حديث له الخيارات نفسها. لا يمكن إجراء هذه المطابقة عند إرسال رابط مشاركة مختصر. قراءة id معروف هي أبسط طريقة لتجنب إنشاء طلب ثان.
يستخدم المثال أدناه رابطا افتراضيا لمنشور فيديو عام على Bluesky، ثم يوضح كيف تتابع قراءة النص من موضع محدد.
transcribe(url="[public bsky.app video-post URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", from_seconds=900)أضف تعليمات transcript1 إلى وكيلك
يستطيع الوكيل الذي يدعم Agent Skill اكتشاف transcript1 من الفهرس، ثم قراءة تعليماته في SKILL.md.
يوضح ملف التعليمات ترتيب الطلبات وكيفية التعامل مع الأخطاء. توفر MCP الأدوات التي يستدعيها الوكيل، ويشرح SKILL.md طريقة استخدامها. ويمكن لخدمة تعمل عبر REST اتباع دورة الطلب نفسها دون عميل MCP.
ملف llms.txt مدخل إلى التوثيق فقط. لا يستقبل روابط الفيديو ولا ينشئ نصوصا مفرغة.
اختر وسيلة الاتصال حسب مكان تشغيل الوكيل. يناسب MCP المساعد التفاعلي الذي يقرأ النص على صفحات. أما خدمة جمع التسجيلات في الخلفية، فيمكنها استخدام REST مع إشعارات webhook التي تحمل توقيعا عند انتهاء التفريغ.
يشترك MCP وREST في حدود الحساب ودقائق التفريغ الصوتي. عند ضبط عدد الطلبات المتزامنة، احسب الطلبات من جميع العملاء المتصلين بالحساب.
https://transcript1.com/.well-known/agent-skills/index.json
https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.mdجهز نص فيديو لنماذج اللغة مع مرجعه وتوقيته
اطلب النص مع الطوابع الزمنية كما يوضح توثيق تنزيل النص، ثم مرره إلى نموذجك. في MCP، اقرأ النص الطويل على صفحات لضبط حجم السياق. وللطلبات المتتابعة عبر REST، استخدم إشعارات webhook.
عندما تمرر نص الفيديو لوكيل ذكاء اصطناعي، أرفق رابط المصدر وتوقيت المقاطع. يصعب التحقق من ملخص إذا انفصلت عباراته عن التسجيل الذي جاءت منه.
للبحث في النصوص، احفظ المقاطع مع معرف المصدر ووقت البداية والنهاية. قسم النص عند نهاية مقطع كامل أو تغير الموضوع. تجنب القطع وسط كلمة أو مداخلة أحد المتحدثين.
يتولى مساعدك التلخيص واستخراج المعلومات بعد قراءة النص. اطلب منه فصل الاقتباس الحرفي عن إعادة الصياغة، والتصريح عندما لا يذكر التسجيل معلومة مطلوبة.
قد يقول صاحب فيديو Instagram «اضغط هنا» من دون تسمية الخيار المعروض. لن يجد النموذج اسم الخيار في النص، ولا ينبغي له تخمينه.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"تأكد مما قرأه الوكيل قبل اعتماد تحليله
إذا بقي نص لم يقرأه الوكيل، تتضمن استجابة MCP قيمة next_from_seconds. مررها في from_seconds لقراءة الصفحة التالية، وسجل الصفحات المقروءة. نجاح استدعاء واحد لا يعني أن الوكيل قرأ الفيديو كله.
قد تقتصر الصفحة الأولى من محاضرة على المقدمة. قبل صياغة الملخص النهائي، اجمع الملاحظات من جميع الصفحات اللازمة، واحتفظ بالطوابع الزمنية. انتبه إلى أي تصحيح أو تحفظ يذكره المتحدث لاحقا.
عند مقارنة عدة تسجيلات، اذكر ما قرأه الوكيل بنجاح وما تعذر الوصول إليه. تعذر قراءة مصدر لا يعني أنه يؤيد بقية المصادر، ولا أنه يخلو من معلومات ذات صلة.
أظهر سبب التعذر وتعامل مع رفع الملفات بوضوح
إذا ظهر login_required أو no_audio، فأنت بحاجة إلى مصدر آخر. أما الطلب الجاري فيحتاج إلى متابعة حالته. أوضح هذا الفرق للمستخدم أو للعملية التي تستدعي وكيلك. لا تستبدل خطأ المصدر بنص فارغ قد يفهمه النموذج على أنه تسجيل بلا كلام.
يتطلب رفع ملف محلي بيئة قادرة على إرسال بايتاته. تحجز أدوات MCP عملية الرفع وتكملها، لكن نقل الملف نفسه يجري عبر طلبات HTTP PUT خارج MCP.
إذا لم يستطع المساعد نقل الملف، وجه المستخدم إلى رفعه في لوحة التحكم. بعد ذلك يستطيع المساعد استخدام id الناتج لقراءة النص بالأدوات المعتادة.