app.py

"""
Tool Calling Demo — Saat Dilimi Farkı
=====================================

Bir LLM'in kullanıcı sorusuna göre doğru fonksiyonları (Tool / Function
Calling) çağırmasını sağlayan, timeapi.io (ücretsiz, anahtarsız) API'sinden
gerçek veri çeken ve çağrılan araçları arayüzde açıkça gösteren bir uygulama.

Araçlar:
  - get_current_time(timezone)                 -> o an ilgili zaman diliminde saat + UTC farkı
  - time_difference(timezone1, timezone2)      -> iki zaman dilimi arasındaki saat farkı

Not: timeapi.io'ya ulaşılamazsa Python'un yerleşik `zoneinfo` (IANA veritabanı)
kütüphanesine otomatik düşülür; böylece demo her koşulda çalışır.

Model: Hugging Face Inference Providers üzerinden tool-calling destekli bir
sohbet modeli (varsayılan: openai/gpt-oss-120b).
"""

import os
import json
from datetime import datetime

import requests
import gradio as gr
from huggingface_hub import InferenceClient

try:
    from zoneinfo import ZoneInfo  # Python 3.9+
except ImportError:  # çok eski sürümler için
    ZoneInfo = None

# ---------------------------------------------------------------------------
# ZeroGPU uyumluluğu
# ---------------------------------------------------------------------------
# HF Spaces ZeroGPU donanımı, başlatılabilmek için en az bir @spaces.GPU
# fonksiyonu ister. Bu uygulama GPU kullanmaz (yalnızca API çağırır); aşağıdaki
# fonksiyon sadece ZeroGPU'nun başlatma kontrolünü geçmek için vardır.
try:
    import spaces

    @spaces.GPU
    def _zerogpu_warmup():
        return True
except Exception:
    pass

MODEL_ID = os.environ.get("MODEL_ID", "openai/gpt-oss-120b")
HF_TOKEN = os.environ.get("HF_TOKEN") or os.environ.get("HUGGINGFACEHUB_API_TOKEN")
HF_PROVIDER = os.environ.get("HF_PROVIDER", "auto")
MAX_TURNS = 6  # Sonsuz döngüye karşı üst sınır

_client_kwargs = {"model": MODEL_ID, "token": HF_TOKEN}
if HF_PROVIDER:
    _client_kwargs["provider"] = HF_PROVIDER
client = InferenceClient(**_client_kwargs)

TIMEAPI_BASE = "https://timeapi.io/api"


def _fetch_zone(timezone: str) -> dict:
    """
    Önce timeapi.io public API'sinden dener; olmazsa yerel zoneinfo'ya düşer.
    Döner: {"timezone", "local_time", "utc_offset_hours"}
    """
    # 1) Birincil yol: public API
    try:
        r = requests.get(
            f"{TIMEAPI_BASE}/timezone/zone",
            params={"timeZone": timezone},
            timeout=10,
        )
        r.raise_for_status()
        data = r.json()
        offset_sec = data["currentUtcOffset"]["seconds"]
        local_raw = data.get("currentLocalTime", "")
        # "2026-07-30T15:30:00.123" -> "2026-07-30 15:30:00"
        local_time = local_raw.replace("T", " ").split(".")[0]
        return {
            "timezone": data.get("timeZone", timezone),
            "local_time": local_time,
            "utc_offset_hours": round(offset_sec / 3600, 2),
            "source": "timeapi.io",
        }
    except Exception:
        pass  # API başarısız -> yedek yola geç

    # 2) Yedek yol: yerel IANA veritabanı
    if ZoneInfo is not None:
        try:
            now = datetime.now(ZoneInfo(timezone))
            return {
                "timezone": timezone,
                "local_time": now.strftime("%Y-%m-%d %H:%M:%S"),
                "utc_offset_hours": round(now.utcoffset().total_seconds() / 3600, 2),
                "source": "zoneinfo (yerel)",
            }
        except Exception:
            pass

    return {"error": f"'{timezone}' geçerli bir IANA zaman dilimi değil (örn. 'Europe/Istanbul')."}


def get_current_time(timezone: str) -> dict:
    """Belirtilen IANA zaman diliminde güncel saati ve UTC farkını döndürür."""
    return _fetch_zone(timezone)


def time_difference(timezone1: str, timezone2: str) -> dict:
    """İki IANA zaman dilimi arasındaki saat farkını hesaplar."""
    z1 = _fetch_zone(timezone1)
    z2 = _fetch_zone(timezone2)
    if "error" in z1:
        return z1
    if "error" in z2:
        return z2

    diff = round(z2["utc_offset_hours"] - z1["utc_offset_hours"], 2)
    if diff > 0:
        note = f"{z2['timezone']}, {z1['timezone']}'dan {abs(diff)} saat ileridedir."
    elif diff < 0:
        note = f"{z2['timezone']}, {z1['timezone']}'dan {abs(diff)} saat geridedir."
    else:
        note = f"{z1['timezone']} ve {z2['timezone']} aynı saat dilimindedir."

    return {
        "timezone1": z1["timezone"],
        "timezone2": z2["timezone"],
        "difference_hours": diff,
        "note": note,
    }


TOOL_FUNCS = {
    "get_current_time": get_current_time,
    "time_difference": time_difference,
}


TOOLS = [
    {
        "type": "function",
        "function": {
            "name": "get_current_time",
            "description": (
                "Belirtilen zaman diliminde o anki yerel saati ve UTC farkını "
                "döndürür."
            ),
            "parameters": {
                "type": "object",
                "properties": {
                    "timezone": {
                        "type": "string",
                        "description": (
                            "IANA zaman dilimi kimliği, örn. 'Europe/Istanbul', "
                            "'America/New_York', 'Asia/Tokyo'. Kullanıcı şehir adı "
                            "verirse uygun IANA kimliğine çevir."
                        ),
                    }
                },
                "required": ["timezone"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "time_difference",
            "description": "İki zaman dilimi arasındaki saat farkını hesaplar.",
            "parameters": {
                "type": "object",
                "properties": {
                    "timezone1": {
                        "type": "string",
                        "description": "Birinci IANA zaman dilimi, örn. 'America/New_York'.",
                    },
                    "timezone2": {
                        "type": "string",
                        "description": "İkinci IANA zaman dilimi, örn. 'Asia/Tokyo'.",
                    },
                },
                "required": ["timezone1", "timezone2"],
            },
        },
    },
]

SYSTEM_PROMPT = (
    "Sen araç kullanabilen yardımcı bir asistansın. Saat ve zaman dilimi "
    "sorularında ASLA bilgi uydurma; her zaman verilen araçları "
    "(get_current_time, time_difference) çağırarak gerçek verilere ulaş. "
    "Kullanıcı şehir adı verirse ('New York', 'Tokyo', 'İstanbul'), bunu doğru "
    "IANA zaman dilimi kimliğine çevir (örn. 'America/New_York', 'Asia/Tokyo', "
    "'Europe/Istanbul'). Birden fazla yer sorulduğunda her biri için ayrı araç "
    "çağır. Son yanıtını kullanıcının diliyle, kısa ve net ver."
)


def _fmt_args(args: dict) -> str:
    return ", ".join(f"{k}={v!r}" for k, v in args.items())


def run_agent(user_message: str, history_messages: list):
    """Modeli araçlarla çalıştırır. (nihai_yanit, adim_izi) döner."""
    if not HF_TOKEN:
        return (
            "⚠️ HF_TOKEN ayarlı değil. HF Spaces > Settings > Secrets bölümünden "
            "`HF_TOKEN` ekleyin (huggingface.co/settings/tokens).",
            "",
        )

    messages = [{"role": "system", "content": SYSTEM_PROMPT}]
    messages.extend(history_messages)
    messages.append({"role": "user", "content": user_message})

    trace_lines = []

    for turn in range(1, MAX_TURNS + 1):
        try:
            resp = client.chat_completion(
                messages=messages,
                tools=TOOLS,
                tool_choice="auto",
                max_tokens=1024,
                temperature=0.2,
            )
        except Exception as exc:
            return f"Model çağrısı başarısız oldu: {exc}", "\n".join(trace_lines)

        msg = resp.choices[0].message
        tool_calls = msg.tool_calls or []

        if not tool_calls:
            final = msg.content or "(boş yanıt)"
            if trace_lines:
                trace_lines.append(f"\n[Turn {turn}] Nihai Yanıt:")
                trace_lines.append(final)
            return final, "\n".join(trace_lines)

        messages.append(
            {
                "role": "assistant",
                "content": msg.content or "",
                "tool_calls": [
                    {
                        "id": tc.id,
                        "type": "function",
                        "function": {
                            "name": tc.function.name,
                            "arguments": tc.function.arguments,
                        },
                    }
                    for tc in tool_calls
                ],
            }
        )

        trace_lines.append(f"[Turn {turn}] Araç Çağrıları:")
        for tc in tool_calls:
            name = tc.function.name
            try:
                args = json.loads(tc.function.arguments or "{}")
            except json.JSONDecodeError:
                args = {}

            func = TOOL_FUNCS.get(name)
            result = func(**args) if func else {"error": f"Bilinmeyen araç: {name}"}

            trace_lines.append(f"   -> {name}({_fmt_args(args)})")
            trace_lines.append(f"   <- {result}")

            messages.append(
                {
                    "role": "tool",
                    "tool_call_id": tc.id,
                    "name": name,
                    "content": json.dumps(result, ensure_ascii=False),
                }
            )

    return "Adım sınırına ulaşıldı, yanıt tamamlanamadı.", "\n".join(trace_lines)


def respond(message, chat_history):
    history_messages = [
        {"role": t["role"], "content": t["content"]} for t in chat_history
    ]
    final, trace = run_agent(message, history_messages)
    chat_history = chat_history + [
        {"role": "user", "content": message},
        {"role": "assistant", "content": final},
    ]
    return chat_history, trace, ""


with gr.Blocks(title="Tool Calling — Saat Dilimi Farkı") as demo:
    gr.Markdown(
        "# 🕐 Tool Calling Demo — Saat Dilimi Farkı\n"
        "Model, sorunuza göre **`get_current_time`** ve **`time_difference`** "
        "araçlarını otomatik çağırır. Sağ tarafta arka planda çağrılan araçları "
        "ve adımları görebilirsiniz.\n\n"
        f"**Model:** `{MODEL_ID}` · **Veri kaynağı:** timeapi.io"
    )

    with gr.Row():
        with gr.Column(scale=3):
            chatbot = gr.Chatbot(height=420, label="Sohbet")
            msg = gr.Textbox(
                placeholder="Örn: New York ile Tokyo arasında kaç saat fark var, şu an saat kaç?",
                label="Sorunuz",
            )
            with gr.Row():
                send = gr.Button("Gönder", variant="primary")
                clear = gr.Button("Temizle")
        with gr.Column(scale=2):
            trace_box = gr.Textbox(
                label="🔧 Araç Çağrı Adımları (Tool Trace)",
                lines=22,
                interactive=False,
            )

    gr.Examples(
        examples=[
            "New York ile Tokyo arasında kaç saat fark var, şu an oralarda saat kaç?",
            "İstanbul'da şu an saat kaç?",
            "Londra mı ileride Los Angeles mı, aradaki fark nedir?",
            "Sidney ile Berlin arasındaki saat farkı kaç saat?",
        ],
        inputs=msg,
    )

    send.click(respond, [msg, chatbot], [chatbot, trace_box, msg])
    msg.submit(respond, [msg, chatbot], [chatbot, trace_box, msg])
    clear.click(lambda: ([], "", ""), None, [chatbot, trace_box, msg])


if __name__ == "__main__":
    demo.launch()