README.md

metadata

title: Dynamic Agent Studio
emoji: 🧩
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
license: mit

Dynamic Agent Studio

Dynamic Agent Studio, kod değiştirmeden çalışma anında bir agent yapılandırmayı sağlar:

• Kullanıcı istediği kadar OpenAPI 3.x veya uzak MCP kaynağı ekler.
• Agentic Scraper API key ile onaylı MCP Market entegrasyonları listelenip seçilebilir. Market bağlantı parametreleri kullanıcıdan istenmez; platform tarafından çözülür.
• OpenAPI belgesindeki GET operasyonları model araçlarına dönüştürülür.
• MCP sunucuları OpenAI Responses API'nin uzak MCP aracı olarak eklenir.
• OpenAI veya OpenRouter sağlayıcısı ve uyumlu model seçilebilir.
• Kullanıcı tablo üzerinden nihai structured output alanlarını tanımlar.
• Uygulama bu alanlardan strict JSON Schema üretir.
• Agent görevi araçlarla tamamlar; nihai sonuç hem okunabilir hem JSON olarak gösterilir.
• Function ve MCP olayları, argümanlar ve sonuçlarla birlikte iz panelinde görünür.

Neden yalnızca OpenAPI GET?

Bu herkese açık bir demo Space'idir. İstenmeyen veri değişikliklerini önlemek için OpenAPI'den yalnızca yan etkisiz GET operasyonları araca dönüştürülür. Üretim uygulamasında POST/PUT/PATCH/DELETE için kullanıcı onayı ve hedef bazlı yetkilendirme eklenmelidir.

Güvenlik sınırları

• Yalnızca HTTPS kaynakları kabul edilir.
• Localhost, özel ağ ve ayrılmış IP adresleri engellenir.
• Yönlendirmeler takip edilmez.
• OpenAPI belge boyutu 2 MB ile, tool sonucu 30.000 karakter ile sınırlıdır.
• Kimlik bilgileri sadece kullanıcının Gradio oturum state'inde tutulur; özet ve izlerde maskelenir, diske yazılmaz.
• MCP için require_approval="never" demo akışını kolaylaştırır. Sadece güvendiğiniz, salt-okunur araçlar sunan MCP sunucularını ekleyin.

Bu kontroller eğitim demosu için savunma katmanlarıdır; çok kiracılı üretim ortamında ağ egress proxy'si, DNS pinning, secret vault ve ayrıntılı araç izinleri de gerekir.

Hugging Face Spaces kurulumu

1. Yeni ve ayrı bir Gradio Space açın.
2. Bu klasördeki dosyaları Space deposunun köküne yükleyin.
3. Space → Settings → Variables and secrets altında OPENAI_API_KEY Secret'ını ekleyin.
4. İsteğe bağlı olarak OPENROUTER_API_KEY Secret'ını ekleyin.
5. İsteğe bağlı variable: OPENAI_MODEL=gpt-5.6-sol.
6. Space'i yeniden başlatın.

Kullanım

1. Kaynakları ekle: OpenAPI, uzak MCP veya Agentic Scraper MCP Market kaydı ekleyin. Aynı oturuma birden fazla kaynak ekleyebilirsiniz.
2. Çıktıyı tasarla: Alan adı, tür, açıklama ve zorunluluk seçin.
3. Agentı çalıştır: Görevi ve isterseniz özel agent talimatını yazın.
4. Sonucu ve Agent araç izleri panelini inceleyin.

Yerelde çalıştırma

pip install -r requirements.txt
export OPENAI_API_KEY="..."
export OPENROUTER_API_KEY="..."
python app.py

Kapsam notları

• OpenAPI 3.x, query/path parametreleri ve belge içi $ref desteklenir.
• Request body ve cookie/header parametreleri bu salt-okunur demoda kullanılmaz.
• MCP sunucusunun OpenAI Responses API tarafından erişilebilir uzak bir HTTPS sunucusu olması gerekir; yerel stdio MCP süreçleri desteklenmez.
• OpenRouter model listesinde yalnızca hem tools hem structured_outputs desteği bildiren modeller gösterilir.
• MCP Market kataloğu ve çalıştırmaları için kullanıcının Agentic Scraper API key'i zorunludur. Ücretli kayıtlar kullanıcının Agentic Scraper bakiyesini kullanabilir.
• MCP Market çalıştırmaları Agentic Scraper orkestrasyonu üzerinden OpenRouter modeliyle yürütülür.
• Kaynak yapılandırması kalıcı değildir; sayfa oturumu sona erdiğinde silinir.

Agentic Scraper bağlantıları

• Web sitesi
• Dokümantasyon
• API referansı
• MCP Market rehberi