Giriş
Bunu daha önce görmüşsünüzdür. Bir şirket yeni bir politika duyurur. Bir ünlü tartışmalı bir açıklama yapar. Kimsenin beklemediği bir haber patlak verir. Sosyal medya patlar ve sonuçları kimsenin tahmin edemeyeceği şekillerde yayılır.
Ya bir senaryonun gerçek dünyada yaşanmadan önce nasıl geliştiğini görebilseydiniz?
MiroFish, sosyal medya hakkındaki "ne olurdu" sorularını yanıtlayan çoklu ajanlı bir yapay zeka simülasyon platformudur. Farklı kişiliklere, anılara ve davranış kalıplarına sahip yüzlerce yapay zeka ajanının serbestçe etkileşimde bulunduğu dijital bir paralel dünya yaratır. Tohum materyali (bir haber makalesi, bir politika taslağı, bir araştırma makalesi) yüklersiniz ve MiroFish, farklı kitlelerin zaman içinde nasıl tepki verebileceğini simüle eder.
Bu açıklayıcı, MiroFish'in ne yaptığını, çoklu ajan simülasyonunun nasıl çalıştığını ve ne zaman kullanabileceğinizi kapsar.
MiroFish Hangi Sorunu Çözüyor?
Tahmin Boşluğu
Sosyal medya hızlı hareket eder ve öngörülemez şekillerde tepki verir. Geleneksel analiz araçları geriye dönük bakar:
- Duygu analizi size insanların şu anda ne düşündüğünü söyler
- Trend takibi size bugün neyin popüler olduğunu gösterir
- Etkileşim metrikleri zaten ne olduğunu ölçer
Bunların hiçbiri, o duyuruyu yayınlarsanız, o raporu yayımlarsanız veya o tartışmaya yanıt verirseniz ne olabileceğini görmenize yardımcı olmaz.
Alternatif: Dijital Paralel Dünyalar
MiroFish farklı bir yaklaşım benimser. Gerçek sosyal medyayı analiz etmek yerine, simüle edilmiş bir sürümünü oluşturur:
- Kaynağınızdaki belgelerden bir bilgi grafiği oluşturun
- Varlıkları çıkarın (kişiler, kuruluşlar, medya kuruluşları) ve onları yapay zeka ajanlarına dönüştürün
- Çıkarılan bilgilere göre kişilikler atayın (aktivite seviyeleri, etki ağırlıkları, duruş pozisyonları)
- Ajanların simüle edilmiş saatler veya günler boyunca gönderi paylaştığı, yorum yaptığı ve tepki verdiği bir simülasyon çalıştırın
- Anlatıların nasıl oluştuğunu, hangi seslerin hakim olduğunu ve hangi karşı hareketlerin ortaya çıktığını görmek için sonucu analiz edin
Bunu sosyal medya senaryoları için bir uçuş simülatörü olarak düşünebilirsiniz.
MiroFish Nasıl Çalışır: Beş Adımlı İş Akışı
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Adım 1 │ ──► │ Adım 2 │ ──► │ Adım 3 │ ──► │ Adım 4 │ ──► │ Adım 5 │
│ Ontoloji │ │ GraphRAG │ │ Ortam │ │ Simülasyon │ │ Rapor │
│ Üretimi │ │ Oluşturma │ │ Kurulumu │ │ Çalıştırma│ │ Üretimi │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
Adım 1: Ontoloji Üretimi
Sistem, girdi belgelerinizi ve simülasyon gereksinimlerini analiz eder, ardından özel bir ontoloji oluşturmak için bir LLM kullanır. Bu, şunları tanımlar:
- 10 varlık türü (örn. Öğrenci, Profesör, Üniversite, MedyaKuruluşu, HükümetAjansı)
- 10 ilişki türü (örn. ÇALIŞIR_İÇİN, YORUM_YAPAR, YANIT_VERİR)
- Her tür için Özellikler
Ontoloji iki katmanlı bir yapı uygular: İçeriğinize dayalı 8 belirli tür, artı başka hiçbir yere uymayan her şeyi yakalamak için 2 yedek tür (Kişi ve Organizasyon).
Adım 2: GraphRAG Oluşturma
Belgeleriniz parçalara ayrılır (50 karakterlik örtüşme ile 500 karakter) ve toplu halde Zep Cloud'a gönderilir. Sistem:
- Benzersiz bir kimliğe sahip bağımsız bir grafik oluşturur
- Özel ontolojiyi ayarlar
- Varlık ve ilişki çıkarımı için metin parçalarını gönderir
- Zep'in her bölümü işlemesini bekler
- Düğümler ve kenarlar ile nihai grafiği alır
Sonuç: ilişkilerle bağlı yüzlerce veya binlerce varlığa sahip bir bilgi grafiği.
Adım 3: Ortam Kurulumu
Simülasyon yapılandırma oluşturucusu, bilgi grafiğini analiz eder ve ayrıntılı ajan parametreleri oluşturur:
- Çin saat dilimi kalıplarına dayalı zaman yapılandırması (yoğun saatler 19-22, ölü saatler 0-5)
- İlk gönderiler ve sıcak konularla olay yapılandırması
- Ajan aktivite yapılandırmaları (saat başına gönderi, yanıt gecikmeleri, etki ağırlıkları)
- Farklı viral eşiklerle Twitter ve Reddit için platform yapılandırmaları
Adım 4: Simülasyon Çalıştırma
Ajanlar aktivite programlarına göre uyanır ve gönderi paylaşmaya, yorum yapmaya ve tepki vermeye başlar. Sistem, Twitter ve Reddit'te paralel simülasyonlar çalıştırır ve her eylemi gerçek zamanlı olarak JSONL dosyalarına kaydeder.
Tipik bir 72 saatlik simülasyon, her iki platformda binlerce eylem üretir.
Adım 5: Rapor Üretimi
Rapor Ajansı, ne olduğunu analiz etmek için üç temel alma aracı kullanır:
- InsightForge: Soruları alt sorgulara ayıran derinlemesine arama
- PanoramaSearch: Süresi dolmuş/geçersiz geçmiş gerçekleri içeren tam kapsamlı görünüm
- InterviewAgents: IPC aracılığıyla aktif ajanlarla gerçek zamanlı görüşmeler
Nihai rapor, anlatı evrimini, önemli anları, etkili sesleri ve karşı hareketleri gösterir.
MiroFish'teki Yapay Zeka Ajanları Nedir?
MiroFish'teki her ajan, aşağıdaki özelliklere sahip bağımsız bir yapay zeka varlığıdır:
| Özellik | Açıklama | Örnek |
|---|---|---|
| Kimlik | Ad, kullanıcı adı, biyografi | “@ZhangWei_Student” |
| Kişilik | Kişilik ve arka plan | “Yapay zeka etiği üzerine araştırma yapan lisansüstü öğrencisi” |
| Aktivite Seviyesi | Ne sıklıkla gönderi paylaştığı (0.0-1.0) | 0.8 = çok aktif |
| Aktif Saatler | Çevrimiçi olduğu zamanlar | [8, 9, 10, 11, 18, 19, 20, 21, 22, 23] |
| Yanıt Gecikmesi | Ne kadar hızlı tepki verdiği (dakika) | 5-30 dakika |
| Etki Ağırlığı | Gönderilerinin başkaları tarafından görülme olasılığı | 0.8 (düşük) ila 3.0 (yüksek) |
| Duruş | Konulara ilişkin pozisyonu | Destekleyici, karşıt, nötr, gözlemci |
| Bellek | Geçmiş eylemler ve etkileşimler | Zep Cloud grafiğinde depolanır |
Ajanlar kararları özerk bir şekilde verir. Ne zaman gönderi paylaşacaklarını, neye yorum yapacaklarını ve kişiliklerine ve simülasyonun mevcut durumuna göre nasıl yanıt vereceklerini seçerler.
Neleri Simüle Edebilirsiniz?
Haberler ve Politika Duyuruları
Bir politika taslağı veya haber makalesi yükleyin. Farklı paydaş gruplarının nasıl tepki verdiğini görün:
- Mesajı hangi sesler yükseltiyor?
- Hangi eleştiriler ortaya çıkıyor?
- Anlatılar 24-72 saat içinde nasıl gelişiyor?
Akademik Araştırma
Bir araştırma makalesi yükleyin. Akademik ve halkın kabulünü simüle edin:
- Hangi bulgular dikkat çekiyor?
- Hangi yanlış anlaşılmalar ortaya çıkıyor?
- Uzman ve sıradan insanların tepkileri nasıl farklılık gösteriyor?
Kriz Senaryoları
Olay raporları veya arka plan materyalleri yükleyin. Yanıt stratejilerini test edin:
- Hemen yanıt verirseniz mi yoksa beklerseniz mi anlatı değişir?
- Hangi karşı anlatılar ortaya çıkar?
- Hangi etkileyiciler sohbeti yönlendirir?
Edebi ve Tarihsel Analiz
Bir roman veya tarihsel metin yükleyin. "Ne olurdu" senaryolarını keşfedin:
- Karakterler, orijinal sonun ötesindeki olaylara nasıl tepki verebilir?
- Hangi alternatif sonuçlar olasıdır?
- Hangi ilişkiler temel olay örgüsü noktalarını yönlendiriyor?
MiroFish'i Farklı Kılan Nedir?
Sürü Zekası, Tek Ajanlar Değil
Birçok yapay zeka aracı, "bir kullanıcıyı" simüle etmek için tek bir ajan kullanır. MiroFish, farklı kişiliklere sahip yüzlerce ajan kullanır. Bu, önceden programlanmış senaryolardan değil, etkileşimlerden kaynaklanan anlatılar ve hareketler gibi ortaya çıkan davranışlar yaratır.
Çift Platform Simülasyonu
Twitter ve Reddit, farklı dinamiklerle paralel çalışır:
- Twitter: Hızlı viral yayılma, yüksek etkileyici etkisi
- Reddit: Konulu tartışmalar, topluluk odaklı anlatılar
Her iki platformu karşılaştırmak, platform mekaniklerinin sonuçları nasıl etkilediğini gösterir.
Zamansal Bilgi Grafiği
MiroFish'teki ilişkilerin zaman meta verileri vardır:
valid_at: İlişkinin geçerli olduğu zamaninvalid_at: İlişkinin geçersiz olduğu zamanexpired_at: İlişkinin sona erdiği zaman
Bu, sadece mevcut durumu değil, ilişkilerin nasıl geliştiğini takip etmenizi sağlar.
Canlı Ajan Görüşmeleri
Simülasyon sırasında veya sonrasında aktif ajanlarla görüşme yapabilirsiniz:
Soru
Ajan 12 (Öğrenci)
Bu, nicel metriklerin ötesinde nitel içgörüler sağlar.
Teknik Mimariye Bir Bakış
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Ön Uç │ │ Arka Uç │ │ Harici │
│ (Vue.js) │ ◄─► │ (FastAPI) │ ◄─► │ Hizmetler │
│ │ │ │ │ │
│ - Grafik Oluş. │ │ - REST API │ │ - Zep Cloud │
│ - Simülasyon │ │ - Alt işlem │ │ - LLM API │
│ izleyicisi │ │ yönetimi │ │ - OASIS │
│ - Rapor görüntü.│ │ - JSONL akışı │ │ Çerçevesi │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Arka Uç Yığını
- REST uç noktaları için Python FastAPI
- Ajan simülasyonu için OASIS Çerçevesi
- Bilgi grafiği depolama ve alma için Zep Cloud
- Simülasyon durumu veritabanları için SQLite
Ön Uç Yığını
- Reaktif kullanıcı arayüzü için Vue.js 3
- Gerçek zamanlı güncellemeler için WebSocket
- Grafik görselleştirme için D3.js
Apidog ile API Tasarımı
MiroFish arka ucu, 5 ana hizmette 40'tan fazla uç nokta sunar:
| Hizmet | Uç Noktalar | Amaç |
|---|---|---|
| Grafik Oluşturma | 8 | Ontoloji üretimi, toplu yükleme, durum sorgulama |
| Varlık Okuyucu | 4 | Varlık filtreleme, tür seçimi, dışa aktarma |
| Yapılandırma Üreteci | 6 | Zaman/olay/ajan/platform yapılandırma üretimi |
| Simülasyon Çalıştırıcı | 12 | Başlatma, durdurma, izleme, görüşme, durum yönetimi |
| Rapor Üreteci | 5 | Alma, analiz, özet üretimi |
Apidog tüm uç noktaları tasarlamak, ön uç geliştirme için yanıtları modellemek ve API belgelerini oluşturmak için kullanıldı. Bu, şema uyuşmazlıklarını erken aşamada yakaladı ve geliştirme boyunca ekibin uyumlu kalmasını sağladı.
MiroFish'i Ne Zaman Kullanmalısınız?
İyi Kullanım Senaryoları
- Senaryo planlaması: “Haftaya X'i duyurursak ne olur?”
- Paydaş analizi: “Farklı gruplar Y'ye nasıl tepki verir?”
- Anlatı takibi: “Z'ye karşı hangi karşı argümanlar ortaya çıkar?”
- Araştırma doğrulaması: “Kitle davranışıyla ilgili hipotezlerimiz geçerli mi?”
- Eğitimsel keşif: “Bu tarihi figürler modern olaylara nasıl tepki verebilir?”
İyi Olmayan Kullanım Senaryoları
- Kesin tahmin: MiroFish olası sonuçları gösterir, garanti edilmiş gelecekleri değil
- Gerçek zamanlı izleme: Varsayımsal senaryoları simüle eder, canlı sosyal medyayı izlemez
- Küçük ölçekli analiz: Sistem yüzlerce ajanla parlar; basit anketler için gereksizdir
- Sosyal olmayan fenomenler: Ekonomik veya fiziksel sistemleri değil, sosyal medya dinamiklerini modeller
MiroFish ile Başlarken
Gereksinimler
- Python 3.10+
- Node.js 18+
- Zep Cloud API anahtarı
- LLM API erişimi (OpenAI uyumlu)
Hızlı Başlangıç
# Depoyu klonlayın
git clone https://github.com/666ghj/MiroFish.git
cd MiroFish
# Bağımlılıkları yükleyin
pip install -r requirements.txt
npm install
# Ortamı yapılandırın
cp .env.example .env
# .env dosyasını API anahtarlarınızla düzenleyin
# Arka ucu başlatın
python backend/app/main.py
# Ön ucu başlatın
npm run dev
İlk Simülasyon
- Belgeleri yükleyin: Kaynak materyalinizi içeren PDF, TXT veya MD dosyaları
- Simülasyon gereksinimlerini tanımlayın: Hangi soruyu araştırıyorsunuz?
- Ontolojiyi oluşturun: Sistemin varlık türlerini analiz etmesine ve önermesine izin verin
- Bilgi grafiği oluşturun: Varlıkları ve ilişkileri çıkarın
- Yapılandırın ve çalıştırın: Simülasyon süresini ayarlayın ve başlatın
- İzleyin ve görüşme yapın: Eylemleri gerçek zamanlı izleyin, ajanlarla görüşme yapın
- Rapor oluşturun: Ne olduğuna dair bir özet alın
Tipik bir ilk simülasyon baştan sona 30-60 dakika sürer.
Sıkça Sorulan Sorular
Simülasyonlar ne kadar doğrudur?
MiroFish, girdi verilerine ve davranış modellerine dayanarak olası senaryolar üretir. Bunu, belirli sonuçları tahmin etmek yerine olasılık alanını keşfetmek olarak düşünün. Değer, tahmin edemeyeceğiniz dinamikleri ortaya çıkarmakta yatar.
MiroFish kaç ajanı simüle edebilir?
Sistem 50-200 ajanı rahatlıkla yönetir. Daha büyük simülasyonlar (500+) mümkündür ancak daha fazla hesaplama gücü gerektirir ve işlenmesi daha uzun sürer.
Ajan davranışını özelleştirebilir miyim?
Evet. Aktivite kalıplarını, etki ağırlıklarını ve duruş dağılımlarını değiştirebilirsiniz. Gelişmiş kullanıcılar, simülasyonları çalıştırmadan önce ajan yapılandırmalarını doğrudan düzenleyebilir.
MiroFish, Çin dışı senaryoları destekliyor mu?
Varsayılan saat dilimi yapılandırması, Çin sosyal medya davranışları için optimize edilmiştir. Zaman yapılandırmasını değiştirerek diğer bölgeler için aktivite kalıplarını özelleştirebilirsiniz.
Verilerim gizli mi?
Belgeler yerel olarak işlenir ve varlık çıkarımı için Zep Cloud'a gönderilir. Zep, verileri hizmet koşullarına göre saklar. Hassas materyaller için yerel bir grafik veritabanı alternatifi kullanmayı düşünebilirsiniz.
Sonuç
MiroFish, sosyal medya senaryolarını gerçek dünyada yaşanmadan önce test edebileceğiniz dijital paralel dünyalar yaratır. Farklı kişiliklere ve davranış kalıplarına sahip yüzlerce yapay zeka ajanını simüle ederek, geleneksel analiz araçlarının kaçırdığı ortaya çıkan anlatıları, karşı hareketleri ve etkili sesleri ortaya çıkarır.
İster bir politika duyurusu planlıyor, ister hedef kitle davranışını araştırıyor veya edebi "ne olurdu"ları keşfediyor olun, MiroFish karmaşık sosyal dinamikleri anlamak için yeni bir bakış açısı sunar.
