Smolagents AIエージェント・フレームワーク

スモールエージェントの使用例

Smolagents では、エージェントは特定のタスクを実行するためのクラスにカプセル化されています。例えば マネージド・エージェント エージェントタイプを使い分けることで、様々なタスクを管理することができます。以下は、2つのエージェント（1つはウェブ検索用、もう1つは画像生成用）がどのように実装できるかの簡略化された例です。ここでは、Googleマップから旅行時間を取得するカスタムツールの作成方法と、それをトラベルプランナーエージェントに使用する方法を説明します：

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時にエッフェル塔をスタート。
2.午前10時30分までエッフェル塔観光。
3.午前10時46分、ノートルダム大聖堂へ。
4.午後12時16分までノートルダム大聖堂観光。
5.午後12時41分、モンマルトルへ。
6.午後2時11分までモンマルトル観光。
7.午後2時33分、リュクサンブール公園へ。
8.午後4時3分までリュクサンブール公園観光。
9.午後4時12分、ルーブル美術館へ。
10.午後5時42分までルーブル美術館観光。
11.午後6時12分まで昼食休憩。
12.終了予定時刻：午後6時12分。

ツールを作った後、それをハブに共有するのは簡単だ：

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