Google Gen AI Python SDK: إعدادات الوكيل المتزامنة وغير المتزامنة

لوكيل HTTP عادي، وفّر بيئة التشغيل المشتركة الموثّقة قبل إنشاء العميل:

HTTPS_PROXY='http://proxy.example:8080' python app.py

احتفظ ببيانات اعتماد مفتاح API والسحابة المعتادة. يمكن لمستمع HTTP نقل وجهات HTTPS.

لمسار HTTPX SOCKS الموثّق عند توفر دعمه، اضبط مجموعتي الخيارات معًا:

from google import genai
from google.genai import types

options = types.HttpOptions(
    client_args={'proxy': 'socks5://proxy.example:1080'},
    async_client_args={'proxy': 'socks5://proxy.example:1080'},
)
client = genai.Client(api_key=api_key, http_options=options)

عندما يُسمح لمسار HTTPX SOCKS هذا باستخدام وسيط عام، تقدّم قائمة وكلاء SOCKS5 مرشحين لكل من عنواني URL للوكيل. أبقِ العميل وأغلقه عبر عبء العمل الخاص به. لا يختار client_args وحده المسار غير المتزامن.

يمكن للخلفية الاختيارية aiohttp أن تتولى الاستدعاءات غير المتزامنة بدلًا من ذلك. تختلف بروتوكولات الوكيل ووسائط الطلب فيها؛ استخدم الخيار المدعوم في SDK المثبّت من ناقل غير متزامن أو عميل HTTPX متوافق بدلًا من افتراض أن خيارات HTTPX تضبط aiohttp.

صنّف العملية الفاشلة بحسب التزامن وعدم التزامن والخلفية وبروتوكول الوكيل. النجاح في مسار واحد لا يثبت إلا ذلك المسار.