كيفية بناء وكلاء ذكاء اصطناعي طويلة الأمد باستخدام Google Gen AI SDK

ما الذي نبنيه

مع إعلان Google Cloud عن وكلاء طويلة الأمد في Gemini Enterprise، تغيرت قواعد التطوير بشكل رسمي. في هذا الدرس، سنقوم ببناء البنية التحتية الأساسية “الإيقاف والاستئناف” المطلوبة لبناء هؤلاء الوكلاء.

لن نبني مجرد روبوت دردشة. سنبني عامل Python غير متزامن يحتفظ بالحالة وينفذ مهمة متعددة الخطوات، ويتوقف عن عمد عندما يحتاج إلى موافقة بشرية محاكاة (محاكاة لـ Unified Inbox)، ويستأنف عند التأكيد.

الإعداد والتثبيت

سنستخدم Google Gen AI SDK الرسمي و`python-dotenv` لمتغيرات البيئة الخاصة بنا.

pip install google-genai python-dotenv asyncio

قم بتأمين بيانات اعتماد API الخاصة بك في ملف `.env`.

# .env file
GEMINI_API_KEY=your_gemini_api_key_here

الخطوة ١: تصميم العميل ذو الحالة

على عكس روبوت الدردشة القياسي الذي ينسى البيانات بين الاستفسارات، يجب على الوكيل طويل الأمد الحفاظ على قاموس حالة صارم. نقوم بتهيئة `genai.Client` الرسمي ونقوم بإعداد مدير الحالة الخاص بنا.

import os
import asyncio
from google import genai
from dotenv import load_dotenvload_dotenv()class LongRunningAgent:
def __init__(self):
# Initialize the official Google Gen AI Client
self.client = genai.Client(api_key=os.getenv("GEMINI_API_KEY"))
self.model = "gemini-1.5-pro"
# This dictionary mimics the persistent state stored in a database
self.state = {
"status": "idle", # idle, running, awaiting_approval, completed
"workflow_history": [],
"pending_approval_request": None
}def log_action(self, action):
print(f"[AGENT LOG]: {action}")
...
تابع القراءة
سجل دخولك مجاناً لقراءة المقال كاملاً والوصول إلى أدوات الذكاء الاصطناعي.
تسجيل الدخول / إنشاء حساب