vibecoding-homework-agent

Domáca úloha: Python skript, ktorý volá LLM API, použije nástroj (tool) a výsledok vráti späť LLM.

agent-sunrise.py je agent pre fotografov — odporučí najlepšie dni a časy na fotenie východu a západu slnka v zadanom meste podľa časov východu/západu slnka a predpovede počasia.

Ako to funguje

Skript spustí agent loop nad OpenAI Chat Completions API s dvomi nástrojmi:

• get_sunrise_sunset_week — časy východu/západu slnka, blue hour a golden hour pre každý deň v zadanom rozsahu (Sunrise-Sunset API).
• get_weather_forecast — predpoveď oblačnosti, zrážok, teploty a vetra okolo východu/západu slnka z modelu ECMWF (Open-Meteo API).

Model si nástroje vyberá sám (tool_choice="auto"). Po každom volaní pošleme výsledok späť ako role: "tool" správu a loop pokračuje, kým model nevráti finálnu odpoveď bez ďalších volaní.

Setup

Potrebuješ Python 3.10+ a OpenAI API kľúč.

pip install openai requests python-dotenv

V priečinku so skriptom vytvor .env:

OPENAI_API_KEY=sk-...

Spustenie

python agent-sunrise.py

Defaultne sa pýta na najlepšie dni pre fotenie východu a západu slnka v Prahe na najbližších 7 dní. Pre vlastnú otázku uprav volanie run_agent(...) na konci súboru.

Použité API

• OpenAI Chat Completions — LLM s tool callingom
• Open-Meteo Geocoding — mesto → GPS súradnice
• Sunrise-Sunset.org — časy východu/západu slnka
• Open-Meteo Forecast — predpoveď počasia (model ECMWF)