Update app.py

app.py

@@ -10,6 +10,14 @@ from langdetect import detect
 
 @tool
 def get_timezone_by_city(city: str) -> str:
+    """Fetches the timezone for a given city using geolocation.
+    
+    Args:
+        city: A string representing the city name, optionally with region or country (e.g., 'Бураево', 'Sydney').
+    
+    Returns:
+        A string with the timezone (e.g., 'Europe/Moscow') or an error message.
+    """
     if not isinstance(city, str):
         return f"Error: Expected a string for city, got: {type(city)}"
     try:
@@ -30,6 +38,14 @@ def get_timezone_by_city(city: str) -> str:
 
 @tool
 def get_current_time_in_timezone(timezone: str) -> str:
+    """Fetches the current local time in a specified timezone.
+    
+    Args:
+        timezone: A string representing a valid timezone (e.g., 'Europe/Moscow').
+    
+    Returns:
+        A string with the current time (e.g., '2025-05-03 12:00:00') or an error message.
+    """
     if not isinstance(timezone, str):
         return f"Error: Expected a string for timezone, got: {type(timezone)}"
     try:
@@ -41,6 +57,15 @@ def get_current_time_in_timezone(timezone: str) -> str:
 
 @tool
 def get_air_quality(city: str, lang: str = "en") -> str:
+    """Fetches air quality data for a given city using OpenWeatherMap API.
+    
+    Args:
+        city: A string representing the city name (e.g., 'Бирск', 'Sydney').
+        lang: A string representing the language code (e.g., 'en', 'ru').
+    
+    Returns:
+        A string with air quality index (AQI) and pollutant levels or an error message.
+    """
     if not isinstance(city, str):
         return f"Error: Expected a string for city, got: {type(city)}"
     try:
@@ -93,6 +118,15 @@ def get_air_quality(city: str, lang: str = "en") -> str:
 
 @tool
 def get_weather(city: str, lang: str = "en") -> str:
+    """Fetches weather data for a given city using OpenWeatherMap API.
+    
+    Args:
+        city: A string representing the city name (e.g., 'Бирск', 'Sydney').
+        lang: A string representing the language code (e.g., 'en', 'ru').
+    
+    Returns:
+        A string with weather conditions, temperature, and humidity or an error message.
+    """
     if not isinstance(city, str):
         return f"Error: Expected a string for city, got: {type(city)}"
     try:
@@ -159,6 +193,14 @@ def get_weather(city: str, lang: str = "en") -> str:
 
 @tool
 def final_answer(answer: str) -> str:
+    """Returns the final answer.
+    
+    Args:
+        answer: A string containing the final answer.
+    
+    Returns:
+        The input answer string.
+    """
     return answer
 
 try: