Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Kompletný agent pre počasie

Lekcia 12 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Vytvor kompletného agenta pre počasie od nuly
  2. Architektúra agenta
  3. Implementácia funkcií
  4. Hlavná slučka agenta
  5. Otestuj agenta
  6. Možné vylepšenia
  7. Kľúčové poznatky

Vytvor kompletného agenta pre počasie od nuly

V tejto lekcii pospájaš všetko, čo si sa doteraz naučil, aby si zostavil kompletného agenta pre počasie. Tento agent ilustruje celý cyklus volania funkcií: definícia nástrojov, spracovanie viacerých kôl konverzácie, ošetrenie chýb a odpovede v prirodzenom jazyku.

Architektúra agenta

Agent pre počasie disponuje tromi nástrojmi:

  1. get_weather – získa aktuálne počasie pre mesto
  2. get_forecast – získa predpoveď na viacero dní
  3. get_alerts – skontroluje aktívne výstrahy pred počasím
import json
from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a city. "
                          "Returns temperature, humidity, wind, and conditions.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City name (e.g., Paris, Lyon, Marseille)"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "default": "celsius"
                    }
                },
                "required": ["city"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "get_forecast",
            "description": "Get weather forecasts for multiple days. "
                          "Returns day-by-day conditions.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City name"
                    },
                    "days": {
                        "type": "integer",
                        "description": "Number of forecast days (1-7)",
                        "default": 3
                    }
                },
                "required": ["city"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "get_alerts",
            "description": "Check active weather alerts (storms, heatwaves, "
                          "floods) for a city or region.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "City or region name"
                    }
                },
                "required": ["city"]
            }
        }
    }
]

Implementácia funkcií

V produkčnom prostredí by tieto funkcie volali skutočné API pre počasie. Tu ich odpovede simulujeme:

def get_weather(city, unit="celsius"):
    # In production: call OpenWeatherMap, WeatherAPI, etc.
    data = {
        "Paris": {"temp": 18, "humidity": 65, "wind": 12, "conditions": "Cloudy"},
        "Lyon": {"temp": 21, "humidity": 55, "wind": 8, "conditions": "Sunny"},
        "Marseille": {"temp": 24, "humidity": 70, "wind": 15, "conditions": "Clear"},
    }
    result = data.get(city, {"error": f"City {city} not found"})
    if "error" not in result:
        result["city"] = city
        result["unit"] = unit
    return result

def get_forecast(city, days=3):
    return {
        "city": city,
        "forecast": [
            {"day": f"Day+{i+1}", "temp_max": 20+i, "temp_min": 12+i,
             "conditions": "Variable"}
            for i in range(days)
        ]
    }

def get_alerts(city):
    alerts = {
        "Marseille": [{"type": "Strong Wind", "severity": "orange",
                       "message": "Gusts up to 90 km/h expected"}],
    }
    return {"city": city, "alerts": alerts.get(city, [])}

Hlavná slučka agenta

def execute_function(name, args):
    functions = {
        "get_weather": get_weather,
        "get_forecast": get_forecast,
        "get_alerts": get_alerts,
    }
    fn = functions.get(name)
    if not fn:
        return {"error": f"Unknown function {name}"}
    try:
        return fn(**args)
    except Exception as e:
        return {"error": str(e)}

def weather_agent(user_message):
    messages = [
        {
            "role": "system",
            "content": "You are an expert weather assistant. "
                       "Use the available tools to provide "
                       "accurate weather information. Always "
                       "check alerts when asked about the "
                       "weather for a city."
        },
        {"role": "user", "content": user_message}
    ]

    for _ in range(5):  # Max 5 turns
        response = client.chat.completions.create(
            model="grok-4.5",
            messages=messages,
            tools=tools
        )

        message = response.choices[0].message
        messages.append(message)

        if not message.tool_calls:
            return message.content

        for tc in message.tool_calls:
            args = json.loads(tc.function.arguments)
            print(f"  → Calling: {tc.function.name}({args})")
            result = execute_function(tc.function.name, args)
            messages.append({
                "role": "tool",
                "tool_call_id": tc.id,
                "content": json.dumps(result, ensure_ascii=False)
            })

    return "Sorry, too many turns required."

Otestuj agenta

# Test 1: simple question
print(weather_agent("What's the weather like in Paris?"))

# Test 2: forecast
print(weather_agent("Give me the forecast for Lyon for 5 days"))

# Test 3: multi-city (parallel calls)
print(weather_agent("Compare the weather between Paris, Lyon, and Marseille"))

# Test 4: complex question
print(weather_agent("I'm going to Marseille this weekend, what do you recommend?"))

Test 3 spustí paralelné volania: model zavolá funkciu get_weather trikrát súčasne. Test 4 je najzaujímavejší – model by mal zavolať get_forecast AJ get_alerts pre Marseille a následne syntetizovať výsledky do praktických odporúčaní.

Možné vylepšenia

Pre agenta pripraveného na nasadenie do produkcie pridaj:

  • Cache: vyhni sa volaniu API pre počasie pre to isté mesto do 10 minút
  • Geokódovanie: preveď názvy miest na súradnice pre lepšiu presnosť
  • História: ukladaj používateľské preferencie (jednotky, obľúbené mestá)
  • Internacionalizácia: podpora názvov miest vo všetkých jazykoch

Kľúčové poznatky

  • Kompletný agent kombinuje viacero nástrojov s odlišnými zodpovednosťami
  • Systémový prompt usmerňuje správanie modelu (systematická kontrola výstrah)
  • Slučka s viacerými kolami a parametrom max_iterations zabraňuje nekonečným cyklom
  • Dispatcher execute_function centralizuje vykonávanie a ošetrenie chýb
  • Testuj s rôznymi typmi dopytov: jednoduché, pre viacero miest, komplexné
  • V produkčnom prostredí pridaj cachovanie, geokódovanie a históriu používateľa