> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# البداية السريعة لذاكرة الذكاء الاصطناعي

> أنشئ مفتاح تكامل، وتحقق منه عبر فحص حالة، واحفظ أول ذاكرة لمستخدم نهائي، ثم استدعِها بالبحث أو بالاستدعاء العميق المُركَّب بنموذج لغوي.

<Steps>
  <Step title="احصل على مفتاح تكامل">
    أنشئ تكاملاً في [لوحة تحكم Conare](https://conare.ai/dashboard). ستحصل على مفتاح Bearer محدد النطاق (`cint_...`) — يُعرض **مرة واحدة** ويُخزَّن فقط كملخّص SHA-256، لذا ضعه في مدير أسرار على جانب الخادم. لا تشحنه أبداً إلى المتصفح.
  </Step>

  <Step title="تحقق من بيانات الاعتماد">
    `GET /api/v1/status` هو اختبار دخان خالٍ من الآثار الجانبية: يتحقق من المفتاح وتوجيه مساحة الأسماء وقفزة مستوى الذاكرة دون إنشاء مستخدم نهائي أو استهلاك حصة.

    ```bash theme={null}
    curl https://api.conare.ai/api/v1/status \
      -H "Authorization: Bearer $CONARE_KEY"
    ```
  </Step>

  <Step title="احفظ ذاكرة">
    احفظ ملاحظات مُقطَّرة (جملة أو فقرة)، وليس أحداثاً خامة. حفظ محتوى مطابق مرتين لا يُحدث تأثيراً (`deduped: true`).

    ```bash theme={null}
    curl https://api.conare.ai/api/v1/memories \
      -H "Authorization: Bearer $CONARE_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "endUserId": "u_123",
        "content": "User prefers smaller islands, wants to avoid crowds. ASA 104 certified.",
        "containerTag": "profile"
      }'
    ```
  </Step>

  <Step title="استدعِها">
    وضعان للاسترجاع، اختر الأنسب لكل موضع استدعاء:

    ```bash theme={null}
    # بحث هجين خام — أقل من ثانية، بلا نموذج لغوي. وكيلك يقوم بالتفكير.
    curl https://api.conare.ai/api/v1/search \
      -H "Authorization: Bearer $CONARE_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "endUserId": "u_123", "query": "charter budget boat type", "limit": 10 }'

    # الاستدعاء العميق — إجابة مُركَّبة بواسطة نموذج لغوي ومُدعَّمة بالاستشهادات (~3–6 ثوانٍ).
    # حقن `answer` في موجّه نظام وكيلك عند بدء الجلسة.
    curl https://api.conare.ai/api/v1/recall \
      -H "Authorization: Bearer $CONARE_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "endUserId": "u_123", "query": "what do we know about this user and their upcoming trip" }'
    ```
  </Step>
</Steps>

<Note>
  تحمل كل استجابة `X-Request-Id`. أرسل مُعرِّفك الخاص (1–128 حرفاً، الحرف الأول أبجدي رقمي) لربط طلب واحد عبر حافة Conare ومستوى الذاكرة.
</Note>

التالي: افهم [التكاملات والمستخدمين النهائيين والحاويات](/platform/concepts)، أو انتقل إلى [مرجع API](/api-reference) الكامل.