Update functionalities.py

functionalities.py

@@ -4,13 +4,11 @@ import requests
 @tool
 def suggest_outfit(occasion: str) -> str:
     """
-    Suggests an outfit based on the occasion.
+    Suggests an outfit based on the occasion type.
     Args:
-        occasion (str): The type of occasion for the event. Allowed values are:
-                        - "casual": Outfit for casual event.
-                        - "formal": Outfit for formal event.
-                        - "active": Outfit for doing sport.
-                        - "custom": Custom outfit.
+        occasion (str): One of "casual", "formal", "active", or "custom".
+    Returns:
+        str: A recommended outfit description suitable for the occasion.
     """
     if occasion == "casual":
         return "T‑shirt, Jeans and sneakers."
@@ -24,11 +22,12 @@ def suggest_outfit(occasion: str) -> str:
 @tool
 def define_coordinates(city: str) -> dict:
     """
-    Returns a dictionary with the geographical coordinates of a city.
+    Looks up geographic coordinates and timezone for a city.
     Args:
-        city (str): A city name.
-    Returns: 
-        A dictionary with the latitude, longitude and timezone of the city
+        city (str): Name of the city to geocode.
+    Returns:
+        dict: Contains "latitude", "longitude", and "timezone",
+              or {"error": "..."} if lookup fails.
     """
     city = city.strip()
     if not city:
@@ -43,11 +42,12 @@ def define_coordinates(city: str) -> dict:
 @tool
 def get_weather(city: str) -> dict:
     """
-    Returns a dictionary with the current weather conditions in a city.
+    Retrieves current weather (temp, wind, code, description) for a city.
     Args:
-        city (str): A city name.
-    Returns: 
-        A dictionary with: temperature, wind_speed, weather_code, weather_description and a summary of the current weather.
+        city (str): Name of the city to fetch weather for.
+    Returns:
+        dict: Keys include "temperature", "wind_speed", "weather_code",
+              "description", and "summary", or {"error": "..."} if failure.
     """
     coords = define_coordinates(city)
     if "error" in coords: