Türkçe + English documentation for the LangGraph-based multi-tool assistant.
Bu proje, LangGraph ile kurulmuş dinamik tool yönetimli bir asistan içerir. Asistan önce ihtiyaç duyduğu tool'u keşfeder (find_tools), sonra ilgili tool'u çağırır ve son cevabı kullanıcıya temizlenmiş şekilde sunar. Proje hem Streamlit UI hem de CLI üzerinden çalıştırılabilir.
This project is a LangGraph-based assistant with dynamic tool management. The agent first discovers required tools (find_tools), invokes them, and returns a cleaned final response. It supports both a Streamlit UI and a CLI flow.
- Dinamik tool keşfi (intent tabanlı)
- Çoklu LLM provider desteği:
ollama,openai,gemini - Tool sonuçları için yapılandırılmış çıktı (çoğu tool için
statusalanı) - UI üzerinden runtime environment yönetimi (API key, SMTP, Spotify)
- Final response formatting katmanı
- Dynamic tool discovery (intent-based routing)
- Multi-provider LLM support:
ollama,openai,gemini - Structured tool outputs (most tools include
status) - Runtime environment management via UI (API keys, SMTP, Spotify)
- Final response formatting layer
StajCase/
├─ app.py
├─ demo.png
└─ multiagents/
├─ agent.py
├─ main.py
├─ registry.py
└─ state.py
StajCase/
├─ app.py
├─ demo.png
└─ multiagents/
├─ agent.py
├─ main.py
├─ registry.py
└─ state.py
python -m venv .venvWindows PowerShell:
.\.venv\Scripts\Activate.ps1macOS/Linux:
source .venv/bin/activatepip install -r requirements.txtmultiagents/.env.example dosyasındaki değerleri kendi değerlerinle doldur.
Gerekli alanlar:
LLM_PROVIDER(ollama | openai | gemini)LLM_MODELOPENAI_API_KEY(OpenAI için)GOOGLE_API_KEY(Gemini için)SPOTIFY_CLIENT_ID,SPOTIFY_CLIENT_SECRETSMTP_HOST,SMTP_PORT,SMTP_USER,SMTP_PASS
streamlit run app.pypython multiagents/main.pypython -m venv .venvWindows PowerShell:
.\.venv\Scripts\Activate.ps1macOS/Linux:
source .venv/bin/activatepip install -r requirements.txtFill values in multiagents/.env.example.
Required variables:
LLM_PROVIDER(ollama | openai | gemini)LLM_MODELOPENAI_API_KEY(for OpenAI)GOOGLE_API_KEY(for Gemini)SPOTIFY_CLIENT_ID,SPOTIFY_CLIENT_SECRETSMTP_HOST,SMTP_PORT,SMTP_USER,SMTP_PASS
streamlit run app.pypython multiagents/main.pyAşağıdaki tool'lar agent tarafından dinamik olarak keşfedilip çağrılır:
- Amaç: Duygu metninden genre çıkarıp Spotify'dan şarkı önerisi döndürmek.
- Input:
mood_text - Output:
{"status": "success|error", "songs": [{"title", "artist", "genre"}]}
- Amaç: Güvenli AST tabanlı matematiksel ifade değerlendirme.
- Input:
expression - Output:
{"expression", "result", "status"}
- Amaç: Yahoo Finance endpoint üzerinden güncel hisse bilgisi.
- Input:
ticker - Output: İnsan okunur metin (fiyat, önceki kapanış, değişim)
- Amaç: Metni hedef dile çevirmek.
- Input:
text,target_language - Output:
{"input_text", "target_language", "translated_text", "status"}
- Amaç: ArXiv API'den güncel makale listesi çekmek.
- Input:
topic,number_of_papers - Output:
{"status", "data": [...], "message"}
- Amaç: Prompt'u LLM ile daha açık/eyleme dönük hale getirmek.
- Input:
prompt - Output:
{"original_prompt", "improved_prompt", "status"}
- Amaç: LLM ile email body üretip SMTP ile göndermek.
- Input:
recipient_email,intent,context - Output:
{"to", "intent", "generated_preview", "status"}
- Amaç: Döviz dönüşümünü canlı kur API'si ile hesaplamak.
- Input:
amount,from_curr,to_curr - Output:
{"amount", "from", "to", "converted_amount", "rate", "status"}
- Amaç: RSS feed'den haber başlık/özet/link çekmek.
- Input:
source_url,limit - Output:
[{"title", "summary", "link"}, ...]
- Amaç: Uzun metni LLM ile sıkıştırılmış özet haline getirmek.
- Input:
text - Output:
{"original_length", "summary_length", "compression_ratio", "summary", "status"}
- Amaç: Sorgudan intent çıkarıp uygun tool listesini döndürmek.
- Kullanım: Agent önce bunu çağırıp sonra gerçek tool'a geçer.
The following tools are dynamically discovered and invoked by the agent:
get_mood_music_recommendations(mood_text: str)— mood-to-genre + Spotify recommendations.calculate_math(expression: str)— safe AST-based math evaluation.get_stock_price(ticker: str)— latest stock data via Yahoo Finance.translate_text(text: str, target_language: str)— text translation.search_arxiv_papers(topic: str, number_of_papers: int = 3)— arXiv paper retrieval.improve_prompt(prompt: str)— LLM-based prompt refinement.send_email(recipient_email: str, intent: str, context: str)— LLM body generation + SMTP send.convert_currency(amount: float, from_curr: str, to_curr: str)— live currency conversion via exchange-rate API.news_summary(source_url: str, limit: int)— RSS news extraction.summarize_text(text: str)— LLM summarization with compression metadata.
Meta tool: find_tools(query: str) routes intent to relevant tool schemas.
multiagents/agent.py- LLM provider seçimi (
LLM_PROVIDER/LLM_MODEL) - Graph düğümleri:
model -> tools -> response find_toolsmeta-tool ile dinamik tool bağlama
- LLM provider seçimi (
multiagents/registry.py- Tüm domain tool implementasyonları ve
ToolRegistry - Intent → tool map (
music,math,data,translation,search,communication,document)
- Tüm domain tool implementasyonları ve
app.py- Streamlit chat UI
- Runtime environment konfigürasyonu
- Agent module reload + chat/session yönetimi
- Kullanıcı mesajı alınır.
- Model gerekli görürse
find_toolsçağrılır. - Uygun tool seti
active_toolslistesine eklenir. - Tool sonucu model tarafından işlenir.
responsenode çıktıyı son kullanıcı için temizler.
multiagents/agent.py: provider/model selection, graph composition, dynamic tool orchestration.multiagents/registry.py: all tool implementations + intent-based registry.app.py: Streamlit UI, runtime env settings, module reload/session behavior.
- User message enters graph state.
- Agent may call
find_toolsfor intent-based discovery. - Discovered tools are bound dynamically.
- Tool outputs are fed back to the model.
- Final response layer formats the user-facing answer.
Unsupported LLM_PROVIDER:LLM_PROVIDERdeğeriniollama/openai/geminiolarak düzelt.Missing SMTP environment variables: SMTP alanlarını doldur.Missing Spotify credentials: Spotify client id/secret gir.- Boş veya hatalı tool çıktıları: API erişimi / internet bağlantısını kontrol et.
Unsupported LLM_PROVIDER: setLLM_PROVIDERtoollama/openai/gemini.Missing SMTP environment variables: fill SMTP credentials.Missing Spotify credentials: fill Spotify client credentials.- Empty/error tool outputs: verify internet/API access.
This repository currently does not define a separate license file.
