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

مثال على تطبيق SmolAgents

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

from typing import Optional
from smolagents import CodeAgent, HfApiModel, tool

@tool
def get_travel_duration(start_location: str, destination_location: str, transportation_mode: Optional[str] = None) -> str:
    """Gets the travel time between two places.

    Args:
        start_location: the place from which you start your ride
        destination_location: the place of arrival
        transportation_mode: The transportation mode, in 'driving', 'walking', 'bicycling', or 'transit'. Defaults to 'driving'.
    """
    import os   # All imports are placed within the function, to allow for sharing to Hub.
    import googlemaps
    from datetime import datetime

    gmaps = googlemaps.Client(os.getenv("GMAPS_API_KEY"))

    if transportation_mode is None:
        transportation_mode = "driving"
    try:
        directions_result = gmaps.directions(
            start_location,
            destination_location,
            mode=transportation_mode,
            departure_time=datetime(2025, 6, 6, 11, 0), # At 11, date far in the future
        )
        if len(directions_result) == 0:
            return "No way found between these places with the required transportation mode."
        return directions_result[0]["legs"][0]["duration"]["text"]
    except Exception as e:
        print(e)
        return e

agent = CodeAgent(tools=[get_travel_duration], model=HfApiModel(), additional_authorized_imports=["datetime"])

agent.run("Can you give me a nice one-day trip around Paris with a few locations and the times? Could be in the city or outside, but should fit in one day. I'm travelling only with a rented bicycle.")

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

1. ابدأ من برج إيفل في الساعة 9:00 صباحاً.
2. مشاهدة المعالم السياحية في برج إيفل حتى الساعة 10:30 صباحاً.
3. السفر إلى كاتدرائية نوتردام في الساعة 10:46 صباحاً.
4. مشاهدة المعالم السياحية في كاتدرائية نوتردام حتى الساعة 12:16 ظهراً.
5. سافر إلى مونمارتر في الساعة 12:41 ظهراً.
6. مشاهدة المعالم السياحية في مونمارتر حتى الساعة 2:11 مساءً.
7. السفر إلى حديقة لوكسمبورغ في الساعة 2:33 بعد الظهر.
8. زيارة المعالم السياحية في حديقة لوكسمبورغ حتى الساعة 4:03 عصراً.
9. السفر إلى متحف اللوفر في الساعة 4:12 مساءً.
10. زيارة متحف اللوفر حتى الساعة 5:42 مساءً.
11. استراحة الغداء حتى الساعة 6:12 مساءً.
12. وقت الانتهاء المقرر: 6:12 مساءً.

بعد إنشاء الأداة، تكون مشاركتها على المحور بسيطة مثل:

get_travel_duration.push_to_hub("{your_username} /get-travel-duration-tool")