Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StajCase Multi-Agent Assistant

Türkçe + English documentation for the LangGraph-based multi-tool assistant.

Demo

TR — Proje Özeti

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.

EN — Project Overview

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.


TR — Özellikler

  • 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 status alanı)
  • UI üzerinden runtime environment yönetimi (API key, SMTP, Spotify)
  • Final response formatting katmanı

EN — Features

  • 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

TR — Klasör Yapısı

StajCase/
├─ app.py
├─ demo.png
└─ multiagents/
   ├─ agent.py
   ├─ main.py
   ├─ registry.py
   └─ state.py

EN — Folder Layout

StajCase/
├─ app.py
├─ demo.png
└─ multiagents/
   ├─ agent.py
   ├─ main.py
   ├─ registry.py
   └─ state.py

TR — Quick Start

1) Ortam oluştur

python -m venv .venv

Windows PowerShell:

.\.venv\Scripts\Activate.ps1

macOS/Linux:

source .venv/bin/activate

2) Bağımlılıkları kur

pip install -r requirements.txt

3) Environment ayarla

multiagents/.env.example dosyasındaki değerleri kendi değerlerinle doldur.

Gerekli alanlar:

  • LLM_PROVIDER (ollama | openai | gemini)
  • LLM_MODEL
  • OPENAI_API_KEY (OpenAI için)
  • GOOGLE_API_KEY (Gemini için)
  • SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET
  • SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS

4) UI çalıştır

streamlit run app.py

5) CLI çalıştır (alternatif)

python multiagents/main.py

EN — Quick Start

1) Create environment

python -m venv .venv

Windows PowerShell:

.\.venv\Scripts\Activate.ps1

macOS/Linux:

source .venv/bin/activate

2) Install dependencies

pip install -r requirements.txt

3) Configure environment

Fill values in multiagents/.env.example.

Required variables:

  • LLM_PROVIDER (ollama | openai | gemini)
  • LLM_MODEL
  • OPENAI_API_KEY (for OpenAI)
  • GOOGLE_API_KEY (for Gemini)
  • SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET
  • SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS

4) Run UI

streamlit run app.py

5) Run CLI (alternative)

python multiagents/main.py

TR — Tool Referansı (multiagents/registry.py)

Aşağıdaki tool'lar agent tarafından dinamik olarak keşfedilip çağrılır:

1) get_mood_music_recommendations(mood_text: str)

  • Amaç: Duygu metninden genre çıkarıp Spotify'dan şarkı önerisi döndürmek.
  • Input: mood_text
  • Output: {"status": "success|error", "songs": [{"title", "artist", "genre"}]}

2) calculate_math(expression: str)

  • Amaç: Güvenli AST tabanlı matematiksel ifade değerlendirme.
  • Input: expression
  • Output: {"expression", "result", "status"}

3) get_stock_price(ticker: str)

  • Amaç: Yahoo Finance endpoint üzerinden güncel hisse bilgisi.
  • Input: ticker
  • Output: İnsan okunur metin (fiyat, önceki kapanış, değişim)

4) translate_text(text: str, target_language: str)

  • Amaç: Metni hedef dile çevirmek.
  • Input: text, target_language
  • Output: {"input_text", "target_language", "translated_text", "status"}

5) search_arxiv_papers(topic: str, number_of_papers: int = 3)

  • Amaç: ArXiv API'den güncel makale listesi çekmek.
  • Input: topic, number_of_papers
  • Output: {"status", "data": [...], "message"}

6) improve_prompt(prompt: str)

  • Amaç: Prompt'u LLM ile daha açık/eyleme dönük hale getirmek.
  • Input: prompt
  • Output: {"original_prompt", "improved_prompt", "status"}

7) send_email(recipient_email: str, intent: str, context: str)

  • Amaç: LLM ile email body üretip SMTP ile göndermek.
  • Input: recipient_email, intent, context
  • Output: {"to", "intent", "generated_preview", "status"}

8) convert_currency(amount: float, from_curr: str, to_curr: str)

  • 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"}

9) news_summary(source_url: str = "https://feeds.bbci.co.uk/news/rss.xml", limit: int = 5)

  • Amaç: RSS feed'den haber başlık/özet/link çekmek.
  • Input: source_url, limit
  • Output: [{"title", "summary", "link"}, ...]

10) summarize_text(text: str)

  • Amaç: Uzun metni LLM ile sıkıştırılmış özet haline getirmek.
  • Input: text
  • Output: {"original_length", "summary_length", "compression_ratio", "summary", "status"}

Meta Tool: find_tools(query: str)

  • 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.

EN — Tool Reference (multiagents/registry.py)

The following tools are dynamically discovered and invoked by the agent:

  1. get_mood_music_recommendations(mood_text: str) — mood-to-genre + Spotify recommendations.
  2. calculate_math(expression: str) — safe AST-based math evaluation.
  3. get_stock_price(ticker: str) — latest stock data via Yahoo Finance.
  4. translate_text(text: str, target_language: str) — text translation.
  5. search_arxiv_papers(topic: str, number_of_papers: int = 3) — arXiv paper retrieval.
  6. improve_prompt(prompt: str) — LLM-based prompt refinement.
  7. send_email(recipient_email: str, intent: str, context: str) — LLM body generation + SMTP send.
  8. convert_currency(amount: float, from_curr: str, to_curr: str) — live currency conversion via exchange-rate API.
  9. news_summary(source_url: str, limit: int) — RSS news extraction.
  10. summarize_text(text: str) — LLM summarization with compression metadata.

Meta tool: find_tools(query: str) routes intent to relevant tool schemas.


TR — Mimari

Ana Bileşenler

  • multiagents/agent.py
    • LLM provider seçimi (LLM_PROVIDER / LLM_MODEL)
    • Graph düğümleri: model -> tools -> response
    • find_tools meta-tool ile dinamik tool bağlama
  • multiagents/registry.py
    • Tüm domain tool implementasyonları ve ToolRegistry
    • Intent → tool map (music, math, data, translation, search, communication, document)
  • app.py
    • Streamlit chat UI
    • Runtime environment konfigürasyonu
    • Agent module reload + chat/session yönetimi

Çalışma Akışı

  1. Kullanıcı mesajı alınır.
  2. Model gerekli görürse find_tools çağrılır.
  3. Uygun tool seti active_tools listesine eklenir.
  4. Tool sonucu model tarafından işlenir.
  5. response node çıktıyı son kullanıcı için temizler.

EN — Architecture

Core Components

  • 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.

Runtime Flow

  1. User message enters graph state.
  2. Agent may call find_tools for intent-based discovery.
  3. Discovered tools are bound dynamically.
  4. Tool outputs are fed back to the model.
  5. Final response layer formats the user-facing answer.

TR — Sorun Giderme

  • Unsupported LLM_PROVIDER: LLM_PROVIDER değerini ollama/openai/gemini olarak 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.

EN — Troubleshooting

  • Unsupported LLM_PROVIDER: set LLM_PROVIDER to ollama/openai/gemini.
  • Missing SMTP environment variables: fill SMTP credentials.
  • Missing Spotify credentials: fill Spotify client credentials.
  • Empty/error tool outputs: verify internet/API access.

License / Lisans

This repository currently does not define a separate license file.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages