Smolagents AI Agent Framework

Пример применения SmolAgents

В Smolagents агенты инкапсулируются в классы, которые позволяют им выполнять определенные задачи. Например ManagedAgent Можно создать инструмент для управления различными задачами, используя различные типы агентов. Ниже приведен упрощенный пример реализации двух агентов - одного для поиска в Интернете и другого для создания изображений. Вот как создать пользовательский инструмент, который получает время поездок из Google Maps, и как использовать его в агенте для планирования поездок:

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. Осмотр достопримечательностей на Монмартре до 14:11.
7. Отправляйтесь в Люксембургский сад в 14:33.
8. Осмотр Люксембургского сада до 16:03.
9. Поездка в музей Лувр в 16:12.
10. Осмотр музея Лувр до 17:42.
11. Перерыв на обед до 18:12.
12. Планируемое время окончания: 18:12.

После создания инструмента поделиться им с Hub очень просто:

get_travel_duration.push_to_hub("{ваше_имя_пользователя}/get-travel-duration-tool")