توضيح تكامل واجهة برمجة تطبيقات الدردشة بالذكاء الاصطناعي

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

عملية التقديم

لاستخدام واجهة برمجة تطبيقات الذكاء الاصطناعي للإجابة على الأسئلة، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية.

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

📘 الوثيقة الكاملة: واجهة برمجة تطبيقات الذكاء الاصطناعي للإجابة على الأسئلة →

الاستخدام الأساسي

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال السؤال والحصول على الإجابة، كل ما عليك هو تمرير حقل question وتحديد النموذج المناسب. على سبيل المثال، إذا سألت: “What’s your name؟”، يمكننا بعد ذلك ملء المحتوى المقابل على الواجهة، كما هو موضح في الصورة:

يمكنك أن ترى أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:

accept: نوع الاستجابة التي ترغب في تلقيها، هنا تم تعيينها إلى application/json، أي بتنسيق JSON.
authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكنك اختياره مباشرة بعد التقديم.

كما تم تعيين جسم الطلب، بما في ذلك:

model: اختيار النموذج، مثل GPT 3.5 أو GPT 4.
question: السؤال الذي تحتاج إلى طرحه، يمكن أن يكون نصًا عاديًا.

بعد الاختيار، يمكنك أن تلاحظ أنه تم إنشاء كود مطابق على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية:

{
  "answer": "I am an AI language model developed by OpenAI and I don't have a personal name. However, you can call me GPT or simply Chatbot. How can I assist you today?"
}

يمكنك أن ترى أن النتيجة التي تم إرجاعها تحتوي على حقل answer، وهو إجابة السؤال. يمكنك إدخال أي سؤال، وستحصل على أي إجابة. إذا كنت لا تحتاج إلى أي دعم للمحادثات متعددة الجولات، فإن هذه الواجهة يمكن أن تسهل تكاملك بشكل كبير. بالإضافة إلى ذلك، إذا كنت ترغب في توليد كود التكامل المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي:

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-3.5",
  "question": "What's your name?"
}'

كود التكامل بلغة Python كما يلي:

import requests

url = "https://api.acedata.cloud/aichat/conversations"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "gpt-3.5",
    "question": "What's your name?"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

المحادثات متعددة الجولات

إذا كنت ترغب في تكامل وظيفة المحادثات متعددة الجولات، تحتاج إلى تمرير معلمة إضافية stateful، وقيمتها تكون true، ويجب أن تحمل كل طلب لاحق هذه المعلمة. بعد تمرير معلمة stateful، ستقوم واجهة برمجة التطبيقات بإرجاع معلمة إضافية id، تمثل معرف المحادثة الحالية، وفيما بعد، كل ما عليك هو تمرير هذا المعرف كمعلمة، مما يسهل تنفيذ المحادثات متعددة الجولات. دعنا نوضح العملية المحددة. في الطلب الأول، قم بتعيين معلمة stateful إلى true، ومرر بشكل طبيعي معلمات model و question، كما هو موضح في الصورة:

الكود المقابل كما يلي:

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-3.5",
  "question": "What's your name?",
  "stateful": true
}'

يمكنك الحصول على الإجابة التالية:

{
  "answer": "I am an AI language model created by OpenAI and I don't have a personal name. You can simply call me OpenAI or ChatGPT. How can I assist you today?",
  "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"
}

في الطلب الثاني، قم بتمرير حقل id الذي تم إرجاعه من الطلب الأول كمعلمة، مع الحفاظ على تعيين معلمة stateful إلى true، واسأل “What I asked you just now؟”، كما هو موضح في الصورة:

الكود المقابل كما يلي:

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-3.5",
  "stateful": true,
  "id": "7cdb293b-2267-4979-a1ec-48d9ad149916",
  "question": "What I asked you just now?"
}'

النتيجة كما يلي:

{
  "answer": "You asked me what my name is. As an AI language model, I do not possess a personal identity, so I don't have a specific name. However, you can refer to me as OpenAI or ChatGPT, the names used for this AI model. Is there anything else I can help you with?",
  "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"
}

يمكنك أن ترى أنه يمكننا الإجابة على الأسئلة بناءً على السياق.

الاستجابة المتدفقة

تدعم هذه الواجهة أيضًا الاستجابة المتدفقة، وهو أمر مفيد جدًا لتكامل الويب، حيث يمكن أن يتيح للويب تحقيق تأثير العرض كلمة بكلمة. إذا كنت ترغب في إرجاع الاستجابة بشكل متدفق، يمكنك تغيير معلمة accept في رأس الطلب إلى application/x-ndjson. التعديل كما هو موضح في الصورة، ولكن يجب أن يكون هناك تغييرات مناسبة في كود الاستدعاء لدعم الاستجابة المتدفقة.

بعد تغيير accept إلى application/x-ndjson، ستقوم واجهة برمجة التطبيقات بإرجاع بيانات JSON المقابلة سطرًا بسطر، وعلى مستوى الكود، نحتاج إلى إجراء التعديلات اللازمة للحصول على النتائج سطرًا بسطر. كود استدعاء Python النموذجي:

import requests

url = "https://api.acedata.cloud/aichat/conversations"

headers = {
    "accept": "application/x-ndjson",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "gpt-3.5",
    "stateful": True,
    "id": "7cdb293b-2267-4979-a1ec-48d9ad149916",
    "question": "مرحبًا"
}

response = requests.post(url, json=payload, headers=headers, stream=True)
for line in response.iter_lines():
    print(line.decode())

输出效果如下：

{"answer": "مرحبًا", "delta_answer": "مرحبًا", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا!", "delta_answer": "!", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف", "delta_answer": " كيف", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكن", "delta_answer": " يمكن", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكنني", "delta_answer": "ني", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكنني المساعدة", "delta_answer": " المساعدة", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكنني المساعدة لك", "delta_answer": " لك", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكنني المساعدة لك اليوم", "delta_answer": " اليوم", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}
{"answer": "مرحبًا! كيف يمكنني المساعدة لك اليوم؟", "delta_answer": "؟", "id": "7cdb293b-2267-4979-a1ec-48d9ad149916"}

يمكن رؤية أن answer في الاستجابة هو المحتوى الأحدث للإجابة، و delta_answer هو المحتوى الجديد المضاف للإجابة، يمكنك استخدام النتائج لدمجها في نظامك. JavaScript أيضًا مدعوم، مثل كود الاستدعاء المتدفق لـ Node.js كما يلي:

const axios = require("axios");

const url = "https://api.acedata.cloud/aichat/conversations";
const headers = {
  "Content-Type": "application/json",
  Accept: "application/x-ndjson",
  Authorization: "Bearer {token}",
};
const body = {
  question: "مرحبًا",
  model: "gpt-3.5",
  stateful: true,
};

axios
  .post(url, body, { headers: headers, responseType: "stream" })
  .then((response) => {
    console.log(response.status);
    response.data.on("data", (chunk) => {
      console.log(chunk.toString());
    });
  })
  .catch((error) => {
    console.error(error);
  });

مثال كود Java:

String url = "https://api.acedata.cloud/aichat/conversations";
OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"question\": \"مرحبًا\", \"stateful\": true, \"model\": \"gpt-3.5\"}");
Request request = new Request.Builder()
        .url(url)
        .post(body)
        .addHeader("Content-Type", "application/json")
        .addHeader("Accept", "application/x-ndjson")
        .addHeader("Authorization", "Bearer {token}")
        .build();

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (!response.isSuccessful()) throw new IOException("رمز غير متوقع " + response);
        try (BufferedReader br = new BufferedReader(
                new InputStreamReader(response.body().byteStream(), "UTF-8"))) {
            String responseLine;
            while ((responseLine = br.readLine()) != null) {
                System.out.println(responseLine);
            }
        }
    }
});

يمكنك إعادة كتابة الكود بلغات أخرى، المبدأ هو نفسه.

نموذج الإعدادات

نعلم أن واجهات برمجة التطبيقات المتعلقة بـ OpenAI لديها مفهوم system_prompt، وهو إعداد نموذج كامل، مثل ما اسمه وما إلى ذلك. هذه واجهة برمجة التطبيقات الخاصة بالأسئلة والأجوبة AI تعرض أيضًا هذه المعلمة، المسماة preset، باستخدامها يمكننا إضافة إعدادات للنموذج، دعنا نجرب مثالًا: هنا نضيف حقل preset إضافي، المحتوى هو أنت فنان محترف، كما هو موضح في الصورة:

الكود المقابل كما يلي:

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-3.5",
  "stateful": true,
  "question": "ماذا يمكنك مساعدتي؟",
  "preset": "أنت فنان محترف"
}'

نتيجة التشغيل كما يلي:

{
    "answer": "كفنان محترف، يمكنني تقديم مجموعة من الخدمات والمساعدة حسب احتياجاتك المحددة. إليك بعض الطرق التي يمكنني مساعدتك بها:\n\n1. الأعمال الفنية المخصصة: إذا كان لديك رؤية أو فكرة معينة، يمكنني إنشاء أعمال فنية مخصصة لك. يمكن أن تشمل ذلك اللوحات، الرسومات، الفن الرقمي، أو أي وسيلة أخرى تفضلها.\n\n2. القطع المخصصة: إذا كان لديك موضوع أو مفهوم معين في ذهنك، يمكنني إنشاء قطع فنية مخصصة تناسب تفضيلاتك. يمكن أن يكون ذلك للتمتع الشخصي أو كهدية فريدة لشخص مميز.\n\n3. استشارة فنية: إذا كنت بحاجة إلى إرشادات حول اختيار الفن، تصميم الديكور الداخلي، أو كيفية عرض وعرض الفن في مساحتك، يمكنني تقديم نصائح احترافية للمساعدة في تعزيز إحساسك الجمالي وخلق مظهر متماسك."
}

يمكننا أن نرى هنا أننا أخبرنا GPT أنه روبوت، ثم سألناه ماذا يمكنه أن يفعل من أجلنا، فيمكنه أن يتقمص دور الروبوت للإجابة على الأسئلة.

التعرف على الصور

يمكن لهذا AI أيضًا دعم إضافة مرفقات لإجراء التعرف على الصور، من خلال تمرير روابط الصور المقابلة عبر references، على سبيل المثال، لدي هنا صورة لتفاح، كما هو موضح في الصورة:

رابط الصورة هو https://cdn.acedata.cloud/ht05g0.png، نقوم بتمريره مباشرة كمعامل references، مع ملاحظة أنه يجب اختيار نموذج يدعم التعرف البصري، والنموذج المدعوم حاليًا هو gpt-4-vision، لذا الإدخال كما يلي:

الكود المقابل كما يلي:

curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-4-vision",
  "question": "كم عدد التفاح في الصورة؟",
  "references": ["https://cdn.acedata.cloud/ht05g0.png"]
}'

نتيجة التشغيل كما يلي:

{
  "answer": "يوجد 5 تفاحات في الصورة."
}

يمكننا أن نرى أننا حصلنا بنجاح على نتيجة الإجابة المقابلة للصورة.

الأسئلة والأجوبة المتصلة بالإنترنت

تدعم هذه الواجهة أيضًا نماذج متصلة بالإنترنت، بما في ذلك GPT-3.5 وGPT-4، حيث يوجد في خلفية واجهة برمجة التطبيقات عملية بحث تلقائية على الإنترنت وتلخيص، يمكننا اختيار النموذج ليكون gpt-3.5-browsing لتجربته، كما هو موضح في الصورة:

الكود كما يلي:

```shell
curl -X POST 'https://api.acedata.cloud/aichat/conversations' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "gpt-3.5-browsing",
  "question": "ما هو الطقس في نيويورك اليوم؟"
}'

نتيجة التشغيل كما يلي:

{
  "answer": "الطقس في نيويورك اليوم هو كما يلي:\n- درجة الحرارة الحالية: 16°C (60°F)\n- العظمى: 16°C (60°F)\n- الصغرى: 10°C (50°F)\n- الرطوبة: 47%\n- مؤشر الأشعة فوق البنفسجية: 6 من 11\n- شروق الشمس: 5:42 صباحًا\n- غروب الشمس: 8:02 مساءً\n\nالجو غائم مع احتمال هطول أمطار متقطعة خلال الليل، وفرصة المطر هي 50%.\nلمزيد من التفاصيل، يمكنك زيارة [قناة الطقس](https://weather.com/weather/tenday/l/96f2f84af9a5f5d452eb0574d4e4d8a840c71b05e22264ebdc0056433a642c84).\n\nهل هناك أي شيء آخر تود معرفته؟"
}

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

إذا كانت لديك متطلبات أعلى لجودة إجابات النموذج، يمكنك تغيير النموذج إلى gpt-4-browsing، وستكون جودة الإجابة أفضل.

البداية

دردشة الذكاء الاصطناعي

صورة الذكاء الاصطناعي

فيديو الذكاء الاصطناعي

الصوت الذكي

الويب والبيانات

CAPTCHA

الهوية

وكيل

متقدم

Coding

توضيح تكامل واجهة برمجة تطبيقات الدردشة بالذكاء الاصطناعي

عملية التقديم

الاستخدام الأساسي

المحادثات متعددة الجولات

الاستجابة المتدفقة

نموذج الإعدادات

التعرف على الصور

الأسئلة والأجوبة المتصلة بالإنترنت

​عملية التقديم

​الاستخدام الأساسي

​المحادثات متعددة الجولات

​الاستجابة المتدفقة

​نموذج الإعدادات

​التعرف على الصور

​الأسئلة والأجوبة المتصلة بالإنترنت

عملية التقديم

الاستخدام الأساسي

المحادثات متعددة الجولات

الاستجابة المتدفقة

نموذج الإعدادات

التعرف على الصور

الأسئلة والأجوبة المتصلة بالإنترنت