تلخيص المستندات

تُكثّف Discuse النصوص أو المستندات الطويلة في ملخص قصير عبر POST /api/v2/summarize. أرسل نصًا خامًا (حتى 100,000 حرف) أو ما يصل إلى 5 عناوين URL لمستندات، وستحصل على summary واحد بلغة واضحة — مفيد لمنح المشرفين البشريين فكرة عامة عن تقرير طويل أو تذكرة دعم أو ملف مرفوع قبل قراءة المحتوى كاملًا.

متى يكون التلخيص مفيدًا؟

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

كيف ألخّص المحتوى؟

قدّم إما text أو file_urls (أحدهما مطلوب). عند استخدام file_urls، تستخرج Discuse النص من المستندات أولًا، ثم تلخّصه.

تلخيص نص خام

curl -X POST https://api.discuse.com/api/v2/summarize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "text": "Long support thread or article text here..."
  }'

تلخيص المستندات

curl -X POST https://api.discuse.com/api/v2/summarize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "file_urls": ["https://example.com/user-report.pdf"]
  }'

الاستجابة

{
  "summary": "A user reports repeated harassment from another account over three days, including direct messages and comments. They have screenshots and request the account be reviewed.",
  "usage": {
    "api_requests_used": 87,
    "api_requests_limit": 500,
    "api_requests_remaining": 413
  }
}

حقول الطلب

الحقل	النوع	ملاحظات
api_key	string	اختياري داخل جسم الطلب؛ يمكنك إرسال X-API-Key بدلًا منه
text	string	النص المراد تلخيصه، حتى 100,000 حرف
file_urls	string[]	عناوين URL للمستندات المطلوب قراءتها وتلخيصها، حتى 5

قدّم أحد الحقلين text أو file_urls. إذا أرسلتهما معًا، فسيُستخدم text.

حقول الاستجابة

الحقل	النوع	الوصف
summary	string	الملخص الذي تم إنشاؤه
usage	object	api_requests_used, api_requests_limit, api_requests_remaining

حدود الاستخدام

التلخيص ميزة ضمن الخطط المدفوعة؛ ويُحتسب كل ملخص مرة واحدة من حصة تلخيص المستندات لديك.

الخطة	الملخصات الشهرية	رسوم التجاوز
Basic	غير متاح	-
Gold	100	$0.02/summary
Platinum	500	$0.017/summary (خصم 15%)
Ultimate	2,000	$0.015/summary (خصم 25%)

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

أفضل الممارسات

لخّص للفرز، لا لاتخاذ القرار

الملخص أداة مساعدة على القراءة للمراجعين البشريين، وليس حكمًا رقابيًا. استخدمه لتحديد أولويات قائمة الانتظار، ثم مرّر المحتوى الأصلي عبر POST /api/v2/check (أو راقبه أثناء OCR) لاتخاذ قرار السياسة الفعلي.

اقرنه مع OCR للمستندات الممسوحة ضوئيًا

يقوم file_urls بالفعل بتشغيل OCR قبل التلخيص، لذا فإن ملف PDF ممسوحًا ضوئيًا أو صورة تحتوي على نص يعملان مباشرة — ولا حاجة إلى استدعاء OCR منفصل.

احترم حد الطول

يقتصر text على 100,000 حرف. بالنسبة للمواد المصدرية الأطول، لخّصها على أقسام ثم اجمع النتائج، أو مرّر المستند كعنوان URL.

أمثلة التكامل

Node.js

async function summarize({ text, fileUrls }) {
  const response = await fetch('https://api.discuse.com/api/v2/summarize', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.DISCUSE_API_KEY
    },
    body: JSON.stringify(text ? { text } : { file_urls: fileUrls })
  });
  return response.json();
}

Python

import os
import requests

def summarize(text=None, file_urls=None):
    payload = {'text': text} if text else {'file_urls': file_urls}
    response = requests.post(
        'https://api.discuse.com/api/v2/summarize',
        headers={
            'Content-Type': 'application/json',
            'X-API-Key': os.environ['DISCUSE_API_KEY']
        },
        json=payload
    )
    return response.json()

هل أنت مستعد لتسريع قائمة انتظار المراجعة لديك؟ ابدأ مع Discuse.