إعداد API نموذج الذكاء الاصطناعي على Android: الاتصال والصور والأدوات

استخدم النموذج الافتراضي أو مزودًا متوافقًا

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

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

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

افهم إعداد المزود والعنوان والمفتاح ومعرّف النموذج

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

العنوان الأساسي ليس بالضرورة الصفحة الرئيسية للمزود أو لوحة حسابك. تعرض وثائق Gemini API للتوافق مع OpenAI مثالًا على مسار متوافق يحدده المزود. هذا لا يعني أن جميع الخدمات تستخدم البروتوكول نفسه.

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

اضبط المزود ودعم الصور والأدوات

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

1. تأكد من اتصال الهاتف بالإنترنت.
2. اختر المزود أو إعداد الاتصال المتوافق.
3. راجع العنوان الأساسي وأدخل المفتاح في حقله المخصص.
4. حدد معرّف نموذج متاح لحسابك عند تلك النقطة.
5. اضبط خيارات دعم الصور واستدعاء الأدوات وفق القدرات الموثقة.
6. احفظ الإعداد واختر النموذج للتجربة، ثم ابدأ بالنص وحده.

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

احتفظ بإعداد تعرف أنه يعمل لتستطيع الرجوع إليه عند الحاجة. وإذا كان سؤالك عن توزيع المهام بين نماذج متعددة، يتناول Kimi K3 وDeepSeek V4 وGLM-5.2 لوكلاء الهاتف: كيف تختار النموذج؟ ذلك الاختيار بتفصيل أوسع.

اختبر النص والصورة وأداة الهاتف منفصلة

ابدأ بطلب نصي قصير مثل: «اكتب جملة تؤكد فهم هذا الطلب». إذا وصل الرد، فهذا يؤكد عمل الاتصال الأساسي لهذه المحاولة. لا يثبت بعد دعم الصور أو استدعاء الأدوات أو تنفيذ إجراء على أندرويد.

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

للاختبار الثالث، فعّل أداة قراءة منخفضة الأثر واطلب فحص حالة Bluetooth أو مستوى صوت الوسائط. يفسر النموذج الطلب ويطلب الأداة المدعومة، ثم تنفذها FoneClaw وفق الأذونات والسياسة الفعلية. راجع النتيجة وقارنها بإعدادات الهاتف؛ مجرد كتابة النموذج قيمة في المحادثة لا يثبت أن الأداة قرأت الحالة.

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

حدد طبقة الفشل قبل إعادة المحاولة

اقرأ رسالة الخطأ وحدد متى ظهرت: قبل رد النموذج، عند إرفاق صورة، عند طلب أداة، أم أثناء تنفيذها على الهاتف؟ يفصل هذا بين إعداد الخدمة وقدرات النموذج وأذونات أندرويد.

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

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

راجع دورة حياة النموذج قبل تبديله

مثال صيانة مؤرخ: تدرج وثائق Anthropic لدورة حياة النماذج المعرّف claude-sonnet-4-5-20250929 ضمن النماذج التي بدأ إنهاء دعمها في 30 سبتمبر 2026، مع إيقاف مقرر في 30 نوفمبر 2026، وتوصي بالانتقال إلى claude-sonnet-5-5. إعلان انتهاء الدعم لا يعني أن الطلبات توقفت بالفعل؛ أما الإيقاف الفعلي فيعني فشل الطلبات الموجهة إلى النموذج المتقاعد.

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

التوصية بنموذج Claude بديل لا تثبت أن واجهة Anthropic Messages الأصلية متوافقة تلقائيًا مع إعداد يتوقع صيغة OpenAI. تحتاج إلى نقطة موثقة ومتوافقة مع مسار FoneClaw الذي تستخدمه. وبعد الانتقال، أعد اختبارات النص والصورة والأداة؛ نجاح الاسم الجديد في الدردشة وحده لا يثبت بقية القدرات.

إذا أردت فهم علاقة نموذج آخر بتنفيذ الهاتف، يشرح هل يستطيع DeepSeek التحكم في هاتف Android؟ ما يستطيع فعله وما يحتاج إلى طبقة تنفيذ وهل يستطيع Grok التحكم في هاتف Android؟ المكالمات والمساعد الأساسي ودور FoneClaw الفصل بين تخطيط النموذج وأداة أندرويد التي تنفذ الإجراء.

أعد الاختبار وتحقق من الأفعال غير المكتملة

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

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

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