README.md

---
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/)