README.md

metadata

title: Kripto Doviz Tool Calling Asistani
emoji: 💰
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false

Kripto & Döviz Tool-Calling Asistanı

Kullanıcının doğal dille sorduğu kripto para ve döviz sorularını, CoinGecko API'sini tool calling (function calling) ile kullanarak yanıtlayan bir asistan. Model, arka planda hangi araçları çağırdığını kullanıcıya adım adım gösterir.

Nasıl çalışır?

1. Kullanıcı soru sorar (ör. "1 Ethereum kaç TL eder?").
2. Model, soruya göre uygun tool'u seçer (get_crypto_price veya convert_currency).
3. Tool, CoinGecko API'sinden gerçek veriyi çeker.
4. Model, dönen veriyle Türkçe bir yanıt üretir.
5. Arka planda çağrılan tüm araçlar ve dönen veriler yanıtın altında gösterilir.

Örnek akış:

Kullanıcı: "Bitcoin mi daha pahalı Ethereum mi?"

[Turn 1] Araç Çağrıları:
   -> get_crypto_price(coin='bitcoin', currency='usd')
   <- {"coin": "bitcoin", "currency": "usd", "price": 65000}
   -> get_crypto_price(coin='ethereum', currency='usd')
   <- {"coin": "ethereum", "currency": "usd", "price": 3500}

[Turn 2] Nihai Yanıt:
Bitcoin (65000 USD), Ethereum'dan (3500 USD) daha pahalıdır.

Araçlar (Tool / Function Definition)

Araç	Açıklama
get_crypto_price(coin, currency)	Bir kripto paranın güncel fiyatını getirir
convert_currency(amount, from_currency, to_currency)	Kripto ve fiat para birimleri arasında dönüşüm yapar

Kullanılan teknolojiler

• API: CoinGecko (ücretsiz, anahtar gerektirmez)
• Model: Qwen/Qwen2.5-72B-Instruct (HF Inference API üzerinden)
• Arayüz: Gradio
• Yayın: Hugging Face Spaces

Kurulum (yerel)

pip install -r requirements.txt
export HF_TOKEN="hf_..."   # HF erisim tokeni
python app.py

Notlar

• HF Spaces'te HF_TOKEN, Space ayarlarından Secrets olarak eklenmelidir.
• CoinGecko ücretsiz katmanının dakikalık istek limiti vardır; yoğunlukta kısa süreli hata dönebilir.