Skip to content
Tutorials2 min read

البدء مع Potato في 5 دقائق

دليل سريع لإعداد أول مشروع توسيم مع Potato، من التثبيت إلى أول بيانات موسومة.

Potato Team·

البدء مع Potato في 5 دقائق

هل أنت مستعد لبدء التوسيم؟ سيجعلك هذا الدليل السريع توسم البيانات في أقل من 5 دقائق. سننشئ مهمة تحليل مشاعر بسيطة لتوضيح الأساسيات.

الخطوة 1: تثبيت Potato

أولاً، ثبّت Potato باستخدام pip:

bash
pip install potato-annotation

تحقق من التثبيت:

bash
potato --version

الخطوة 2: إنشاء التكوين

أنشئ ملفاً باسم config.yaml بهذا التكوين الأدنى:

yaml
annotation_task_name: "Quick Start Sentiment Analysis"
 
# Your data file
data_files:
  - data.json
 
# Annotation interface
annotation_schemes:
  - annotation_type: radio
    name: sentiment
    description: "What is the sentiment of this text?"
    labels:
      - Positive
      - Negative
      - Neutral

الخطوة 3: إنشاء بيانات نموذجية

أنشئ ملف data.json مع بعض النصوص النموذجية:

json
{"id": "1", "text": "I love this product! It's amazing!"}
{"id": "2", "text": "Terrible experience. Would not recommend."}
{"id": "3", "text": "The weather is partly cloudy today."}
{"id": "4", "text": "Best purchase I've ever made!"}
{"id": "5", "text": "This is the worst service I've encountered."}

الخطوة 4: بدء التوسيم

شغّل خادم التوسيم:

bash
potato start config.yaml

افتح المتصفح على http://localhost:8000. سترى واجهة التوسيم!

الخطوة 5: وسِم بياناتك

  1. سجّل الدخول بأي اسم مستخدم (Potato ينشئ الحسابات تلقائياً)
  2. اقرأ النص المعروض
  3. اختر تسمية المشاعر المناسبة
  4. انقر "إرسال" للحفظ والانتقال للعنصر التالي

الخطوة 6: تصدير توسيماتك

يتم حفظ توسيماتك تلقائياً في مجلد annotation_output/. يُحفظ عمل كل مُوسِّم في ملف منفصل.

لعرض توسيماتك:

bash
cat annotation_output/your_username.jsonl

ما التالي؟

تهانينا! لقد أكملت أول مهمة توسيم. إليك ما يمكنك فعله بعد ذلك:

  • إضافة اختصارات لوحة المفاتيح: تسريع التوسيم بالمفاتيح السريعة
  • تخصيص الواجهة: إضافة تعليمات وتلميحات وتحقق من الصحة
  • إعداد مُوسِّمين متعددين: تكوين إدارة المستخدمين وضبط الجودة
  • استكشاف أنواع التوسيم: جرب النطاقات وخانات الاختيار ومقاييس ليكرت والمزيد

اطلع على الوثائق للحصول على أدلة مفصلة لكل ميزة، أو تصفح المعرض للحصول على أمثلة تكوين كاملة.


هل تواجه مشكلة؟ راجع الأسئلة الشائعة أو افتح مشكلة على GitHub.