Apppublic

Endezyar/tool-calling-ulke-rehberi

sourceHugging Facemitupdated 2mo agoView on Hugging Face

1likes

App README

🌍 AI Ülke Rehberi: Tool Calling & API Entegrasyonu

Bu proje, Magibu Uygulamalı Yapay Zekâ Mimarisi Eğitimi kapsamında geliştirilmiş bir "Tool Calling" (Araç Kullanımı) demosu ve ödev teslimidir.

Projenin temel amacı, bir Büyük Dil Modelinin (LLM) kapalı bir kutu olmaktan çıkıp, dış dünyadaki bir API ile gerçek zamanlı etkileşime girmesini ve aldığı verileri sentezleyerek kullanıcıya sunmasını sağlamaktır.

🚀 Proje Mimarisi

—Yapay Zekâ Modeli: Qwen/Qwen2.5-1.5B-Instruct (Hafif ve Tool Calling konusunda son derece başarılı bir model)
—Dış Veri Kaynağı (API): REST Countries API (Ülkelerin güncel nüfus, başkent, yüz ölçümü ve kıta verileri)
—Arayüz: Gradio
—Platform: Hugging Face Spaces

🧠 Nasıl Çalışır? (Örnek İşleyiş)

Model, kullanıcının sorusunu analiz eder, arka planda hangi araca ihtiyacı olduğuna karar verir, API'yi tetikler ve dönen taze verilerle nihai yanıtı üretir. Aşağıda sistemin kaputunun altında gerçekleşen iki örnek akışı görebilirsiniz:

Örnek 1: Türkiye ve Kanada Kıyaslaması

Kullanıcı Sorusuna İstinaden Arka Planda Gerçekleşen Akış: Soru: Türkiye'nin ve Almanyanın'nın nüfuslarını karşılaştır ve hangisi daha büyük söyle.

text

Model düşünüyor ve karar veriyor...

--- MODELİN KARARI [TURN 1] ---
<tool_call>
{"name": "get_country_info", "arguments": {"country_name": "Turkey"}}
</tool_call>
<tool_call>
{"name": "get_country_info", "arguments": {"country_name": "Canada"}}
</tool_call><|im_end|>

--- [TURN 2] ARAÇ ÇAĞRILARI VE API ÇALIŞTIRMA ---
-> get_country_info(country_name='Turkey') çalıştırılıyor...
<- Sonuç: {'country': 'Turkey', 'capital': 'Ankara', 'population': 86092168, 'region': 'Asia', 'area_km2': 783562}
-> get_country_info(country_name='Canada') çalıştırılıyor...
<- Sonuç: {'country': 'Canada', 'capital': 'Ottawa', 'population': 41417056, 'region': 'Americas', 'area_km2': 9984670}

--- [TURN 3] NİHAİ YANIT ÜRETİLİYOR ---
Türkiye'nin nüfusu yaklaşık 86 milyon ve Kanada'nın nüfusu yaklaşık 41 milyon olarak tespit edildi. Bu bilgilere göre, Türkiye'nin nüfusu Kanada'nın nüfusundan daha büyüktür.



-----------------------
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference