واجهة برمجة التطبيقات/AI Gateway/استعلام RAG واستيعاب المستندات

استعلام RAG واستيعاب المستندات

POST/v1/ai/{project_id}/rag

استيعاب مستندات كبيرة (تصل إلى 5 ميجابايت) مع تداخل قابل للتكوين واستعلام عن استجابات LLM المستندة إلى السياق.

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

rag.tstypescript

// 1. قم بإدخال مستند نصي كبير في مساحة الاسم
await aura.ai.ragIngest({
  document: 'Full text of enterprise security guide...',
  namespace: 'security-kb',
  chunk_size: 1000,
  chunk_overlap: 200,
})

// 2. استعلام عن استجابة RAG
const { data: answer } = await aura.ai.rag({
  question: 'How are database backups encrypted?',
  namespace: 'security-kb',
  system: 'Answer using only the provided context.',
})
console.log('Answer:', answer?.answer)
console.log('Sources cited:', answer?.sources)

200.jsonjson

{
  "data": {
    "answer": "Database backups are encrypted at rest using AES-256-GCM via Vault Transit KEK...",
    "sources": [
      {
        "id": "b1a2c3d4-...",
        "content": "All automated WAL and snapshot backups utilize AES-256-GCM keys...",
        "similarity": 0.912
      }
    ],
    "model": "claude-3-5-sonnet",
    "provider": "anthropic"
  }
}

الابتلاع

معلمات التقسيم

المعلمة	اكتب	مطلوب	الوصف
`document`	`string`	نعم	محتوى المستند (حجم حمولة يصل إلى 5 ميجابايت).
`namespace`	`string`	نعم	مساحة اسم القسم المستهدف.
`chunk_size`	`number`	لا	الأحرف المستهدفة لكل قطعة (الافتراضي `1000`).
`chunk_overlap`	`number`	لا	تداخل الأحرف بين القطع المتتالية (الافتراضي `200`).
`metadata`	`object`	لا	بيانات تعريف JSON التعسفية المرفقة بكل قطعة.

الإدارة

عمليات دورة حياة مساحة الاسم

GET /v1/ai/{project_id}/rag/namespaces: يسرد كافة مساحات أسماء RAG النشطة.
DELETE /v1/ai/{project_id}/rag/{namespace}: يحذف كافة الأجزاء وإدخالات المتجهات في مساحة الاسم.
POST /v1/ai/{project_id}/rag/{namespace}/reindex: إعادة حساب التضمينات لجميع القطع في مساحة الاسم عند تبديل نماذج التضمين.

v1.0 · منقحة 31‏/10‏/2026
↗ مواصفات OpenAPI↗ جيثب

← السابق

البحث الدلالي

التالي →

NL to SQL