# إضافة مستند نصي جديد إلى متجر المتجهات

{% openapi src="/files/HnPQpOiuTrIsiKLD8NFc" path="/vector-stores/{vector-store-id}/documents/create" method="post" %}
[rememberizer\_openapi.yml](https://4065521171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKV4TZLzR1jCpM5coRezn%2Fuploads%2Fgit-blob-77b6137eeb641262ec8e531c78123c02b825b865%2Frememberizer_openapi.yml?alt=media\&token=5e84eb03-c48b-4980-9792-73172ea64dd4)
{% endopenapi %}

## طلبات مثال

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X POST \
  https://api.rememberizer.ai/api/v1/vector-stores/vs_abc123/documents/create \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "نظرة عامة على المنتج",
    "text": "منتجنا هو حل مبتكر لإدارة تضمينات المتجهات. يوفر تكاملًا سلسًا مع أنظمتك الحالية ويقدم قدرات بحث دلالي قوية."
  }'
```

{% hint style="info" %}
استبدل `YOUR_API_KEY` بمفتاح API الخاص بمخزن المتجهات الفعلي و `vs_abc123` بمعرف مخزن المتجهات الخاص بك.
{% endhint %}
{% endtab %}

{% tab title="JavaScript" %}

```javascript
const addTextDocument = async (vectorStoreId, name, text) => {
  const response = await fetch(`https://api.rememberizer.ai/api/v1/vector-stores/${vectorStoreId}/documents/create`, {
    method: 'POST',
    headers: {
      'x-api-key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: name,
      text: text
    })
  });
  
  const data = await response.json();
  console.log(data);
};

addTextDocument(
  'vs_abc123',
  'نظرة عامة على المنتج',
  'منتجنا هو حل مبتكر لإدارة تضمينات المتجهات. يوفر تكاملًا سلسًا مع أنظمتك الحالية ويقدم قدرات بحث دلالي قوية.'
);
```

{% hint style="info" %}
استبدل `YOUR_API_KEY` بمفتاح API الخاص بمخزن المتجهات الفعلي و `vs_abc123` بمعرف مخزن المتجهات الخاص بك.
{% endhint %}
{% endtab %}

{% tab title="Python" %}

```python
import requests
import json

def add_text_document(vector_store_id, name, text):
    headers = {
        "x-api-key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    
    payload = {
        "name": name,
        "text": text
    }
    
    response = requests.post(
        f"https://api.rememberizer.ai/api/v1/vector-stores/{vector_store_id}/documents/create",
        headers=headers,
        data=json.dumps(payload)
    )
    
    data = response.json()
    print(data)

add_text_document(
    'vs_abc123',
    'نظرة عامة على المنتج',
    'منتجنا هو حل مبتكر لإدارة تضمينات المتجهات. يوفر تكاملًا سلسًا مع أنظمتك الحالية ويقدم قدرات بحث دلالي قوية.'
)
```

{% hint style="info" %}
استبدل `YOUR_API_KEY` بمفتاح API الخاص بمخزن المتجهات الفعلي و `vs_abc123` بمعرف مخزن المتجهات الخاص بك.
{% endhint %}
{% endtab %}
{% endtabs %}

## معلمات المسار

| المعلمة         | النوع | الوصف                                                       |
| --------------- | ----- | ----------------------------------------------------------- |
| vector-store-id | سلسلة | **مطلوب.** معرف مخزن المتجهات الذي سيتم إضافة المستند إليه. |

## جسم الطلب

```json
{
  "name": "نظرة عامة على المنتج",
  "text": "منتجنا هو حل مبتكر لإدارة تضمينات المتجهات. يوفر تكاملًا سلسًا مع أنظمتك الحالية ويقدم قدرات بحث دلالي قوية."
}
```

| المعامل | النوع | الوصف                             |
| ------- | ----- | --------------------------------- |
| name    | سلسلة | **مطلوب.** اسم الوثيقة.           |
| text    | سلسلة | **مطلوب.** المحتوى النصي للوثيقة. |

## تنسيق الاستجابة

```json
{
  "id": 1234,
  "name": "نظرة عامة على المنتج",
  "type": "text/plain",
  "vector_store": "vs_abc123",
  "size": 173,
  "status": "قيد المعالجة",
  "processing_status": "في قائمة الانتظار",
  "indexed_on": null,
  "status_error_message": null,
  "created": "2023-06-15T10:15:00Z",
  "modified": "2023-06-15T10:15:00Z"
}
```

## المصادقة

تتطلب هذه النقطة النهائية المصادقة باستخدام مفتاح API في رأس `x-api-key`.

## ردود الأخطاء

| رمز الحالة | الوصف                                                     |
| ---------- | --------------------------------------------------------- |
| 400        | طلب غير صالح - الحقول المطلوبة مفقودة أو التنسيق غير صالح |
| 401        | غير مصرح - مفتاح API غير صالح أو مفقود                    |
| 404        | غير موجود - لم يتم العثور على متجر المتجهات               |
| 500        | خطأ في الخادم الداخلي                                     |

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rememberizer.ai/ar/mward-almtwryn/api-docs/vector-store/add-new-text-document-to-a-vector-store.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.