| --- |
| 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 |
|
|
| ```bash |
| 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](https://agenticscraper.com/) |
| - [Dokümantasyon](https://docs.agenticscraper.com/) |
| - [API referansı](https://docs.agenticscraper.com/api-reference/) |
| - [MCP Market rehberi](https://docs.agenticscraper.com/users/mcp/) |
|
|
