n8n için Minds: kurulum ve iş akışı kılavuzu
Kendi kendine barındırılan n8n'de Çalışmaları hazırlamak ve incelemek için n8n-nodes-minds kullanın. 0.1.1 sürümü npm'de yayınlanmıştır; n8n doğrulaması inceleme aşamasındadır. Araştırma yalnızca Minds içinde ayrı bir onaydan sonra başlar.
Minds, ticari sentetik araştırma için uçtan uca bir platformdur. Minds topluluk düğümü, n8n iş akışlarınızı Çalışma API'sine bağlar: bir Çalışma oluşturun, incelenebilir bir plan hazırlayın ve sonraki iş akışları için mevcut sonuçları toplayın. Ayrıca bir Minds işlemini n8n Yapay Zeka Ajanı için bir araç olarak kullanıma sunabilirsiniz.
Kullanılabilirlik ve gereksinimler
Minds tarafından yönetilen n8n-nodes-minds paketi npm üzerinde yayınlanmıştır. Bu kılavuz, npm'deki güncel sürüm olan 0.1.1 sürümünü kapsamaktadır. Otomatik n8n incelemesi geçilmiştir; manuel doğrulama inceleme aşamasındadır. Bu henüz doğrulanmış bir liste değildir ve düğüm n8n Cloud üzerinde yüklenemez.
Topluluk paketlerine izin veren, kendi kendine barındırılan bir n8n örneği, bunları yükleyebilecek bir sahip veya yönetici ve API erişimi olan bir Minds hesabı kullanın. Mevcut API izinleri ve kullanım limitleri geçerliliğini korur. Düğümü n8n içinde yapılandırırsınız; Minds içinde kurulacak bir OAuth bağlantısı yoktur.
Kurulum ve bağlantı
- n8n içinde Ayarlar → Topluluk Düğümleri → Yükle (Settings → Community Nodes → Install) kısmını açın.
[email protected]girin, n8n'in topluluk kodu bildirimini inceleyin ve yükleyin. Örneğiniz farklı bir kurulum yöntemi kullanıyorsa n8n'in kurulum kılavuzuna bakın.- Minds içinde Ayarlar → API Anahtarları kısmını açın ve bu entegrasyon için bir anahtar oluşturun.
- Bir n8n iş akışına bir Minds düğümü ekleyin. Bir Minds API kimlik bilgisi oluşturun, anahtarı API Anahtarı (API Key) alanına yapıştırın, kaydedin ve bağlantı testini çalıştırın.
- Çalışma → Çoklu Getir (Study → Get Many) seçeneğini belirleyin ve erişimi doğrulamak için çalıştırın. Boş bir liste, hesabın henüz Çalışması olmadığı anlamına gelebilir.
n8n, anahtarı şifreli kimlik bilgileri sisteminde saklar. Anahtarı düğüm ifadelerinde, iş akışı JSON'unda, istemlerde veya dışa aktarılan dosyalarda değil, bu kimlik bilgisinde tutun. İstekler https://getminds.ai/api/v1 adresine gider. Bağlantı testi, kimliği doğrulanmış Minds hesabını kontrol eder; erişim ayrıntıları için API kimlik doğrulamasına bakın.
Desteklenen işlemler
Beş işlemin tamamı Çalışma (Study) kaynağını kullanır. n8n, API'nin data yükünü doğrudan dışa aktarır, bu nedenle oluşturulan bir Çalışmanın kimliği, sonraki düğümde {{ $json.id }} olarak kullanılabilir.
| İşlem | Girdiler ve davranış |
|---|---|
| Get Many | Erişilebilir Çalışmaları listeler. Limiti 1 ile 100 arasında ayarlayın veya sayfalama için Tümünü Döndür'ü etkinleştirin. |
| Create | İsim gerektirir. Kitle Kimlikleri (Audience IDs), mevcut Kitlelerin virgülle ayrılmış kimliklerini kabul eder. Bağlantı Paylaşımı (Link Sharing) varsayılan olarak kapalıdır; açmak, Çalışmaya ve ekli Kitlelerine erişimi yayınlar. |
| Get | Çalışma Kimliği (Study ID) gerektirir; Çalışmayı, Kitlelerini, Minds'ı ve mesajları alır. |
| Preview Research Plan | Çalışma Kimliği (Study ID) ve Araştırma İsteği gerektirir. Çalışma Yerel Ayarını (Study Locale) seçin ve katılımcıların görebileceği materyali Kaynak Türü (Source Kind), Kaynak Etiketi (Source Label) ve Kaynak İçeriği veya Kaynak URL'si aracılığıyla ayrı olarak sağlayın. Araştırmayı başlatmadan bir plan taslağı kaydeder. |
| Get Summary | Çalışma Kimliği (Study ID) gerektirir; kalıcı Çalışma özetini ve anlamsal çıktı bloklarını okur. Eksik bir özeti oluşturmaz veya yenilemez. |
Planlayıcı talimatları (hangi soruların sorulacağı gibi) için Araştırma İsteği (Research Request) kullanın. Katılımcıların değerlendirmesi gereken gerçek metni Kaynak İçeriği (Source Content) kısmına koyun. Kaynak İçeriği (Source Content), Prompt kaynak türü için kullanılabilir. Web sitesi, görsel veya video gibi diğer türler için herkese açık bir HTTPS URL'si ile Kaynak URL'si (Source URL) kullanın. Bir kaynak türü seçmek yerel bir dosyayı yüklemez.
Bir araştırma planı hazırlama
- Manuel Tetikleyici ve Çalışma → Oluştur (Study → Create) olarak ayarlanmış bir Minds düğümü ile başlayın. Tanımlayıcı bir isim ve kullanmak istediğiniz mevcut Kitle Kimliklerini girin. Erişim yayınlamadığınız sürece bağlantı paylaşımını kapalı bırakın.
- Araştırma Planını Önizle (Preview Research Plan) olarak ayarlanmış başka bir Minds düğümü bağlayın. Çalışma Kimliği (Study ID) için
{{ $json.id }}kullanın. - Araştırma İsteğini şu şekilde ayarlayın: “Netlik, uygunluk ve güvenilirlik hakkında üç soru taslağı hazırlayın. Çalışmayı yürütmeyin.” Çıktı dilini seçin, Kaynak Türü (Source Kind) olarak İstem (Prompt) seçin ve tam mesajı veya kavramı Kaynak İçeriğine koyun.
- İş akışını bir kez çalıştırın. Kaydedilen taslağı, Kitleleri, soruları ve kaynağı Minds içinde inceleyin, ardından araştırmayı orada açıkça onaylayıp başlatın.
- Daha sonraki bir iş akışı yürütmesinde, Çalışmayı incelemek için kaydedilen Çalışma Kimliği (Study ID) ile Getir (Get) işlemini ve mevcut bir özeti toplamak için Özet Getir (Get Summary) işlemini kullanın. Elde edilen verileri uygun şekilde raporlama veya bildirim düğümlerinize iletin.
Çalışma Kimliği (Study ID)ni iş akışı yürütmeleri arasında koruyun. Oluştur (Create) işlemini yeniden çalıştırmak başka bir Çalışma oluşturur; öncekini devam ettirmez. Başarılı olup olmadığını kontrol edene kadar belirsiz bir zaman aşımından sonra oluşturmayı otomatik olarak yeniden denemekten kaçının.
Minds'ı bir Yapay Zeka Ajanı aracı olarak kullanma
Bir n8n Yapay Zeka Ajanı (AI Agent) ve uyumlu bir sohbet modeli ekleyin, ardından Minds'ı Ajanın araç bağlayıcısına ekleyin. Minds API kimlik bilgisini, Çalışma kaynağını ve kullanıma sunmak istediğiniz belirli işlemi seçin. Çoklu Getir (Get Many) veya Oluştur (Create) ile başlayın ve araca net bir açıklama verin.
Örneğin: “Yapılandırılmış Minds aracını kullanarak Commuter bottle review adında bir taslak Çalışma oluşturun. Kimliğini döndürün. Araştırmayı başlatmayın.” Araç yapılandırmasında İsim belirleyin veya Ajanın seçmesine izin verdiğiniz alanlar için n8n'in model tanımlı parametre kontrolünü kullanın. Kimlik bilgilerini model isteminin dışında tutun ve bağlantı paylaşımını devre dışı bırakın. Araç, normal düğümle aynı beş işleme sahiptir; bir Ajana eklemek araştırma yürütmeyi etkinleştirmez.
Örnekler ve sorun giderme
Örnek iş akışlarını n8n'in Dosyadan İçe Aktar (Import from File) özelliği ile içe aktarın: Çalışmaları listeleyin, bir araştırma planı hazırlayın veya bir Çalışma özeti okuyun. İçe aktardıktan sonra kendi kimlik bilgilerinizi seçin ve gerekli Kitle veya Çalışma Kimliklerini doldurun.
- Düğüm eksik: tam paket adını, kurulum durumunu ve kendi kendine barındırılan örneğinizin topluluk düğümlerine izin verip vermediğini doğrulayın. n8n Cloud bu doğrulanmamış paketi yükleyemez.
- Bağlantı testi veya 401 hatası: kimlik bilgisinin güncel bir Minds API anahtarı içerdiğini kontrol edin ve iptal edilen bir anahtarı değiştirdikten sonra yeniden test edin.
- 403 veya plan sınırlı yanıt: hesabın API erişimini, çalışma alanı izinlerini ve mevcut kullanım kotasını kontrol edin.
- Çalışma bulunamadı: aynı hesap için Çoklu Getir tarafından döndürülen bir kimliği kullanın; bir Çalışma adı onun kimliği değildir.
- Özet yok: Çalışmayı Minds içinde açın ve araştırmanın tamamlandığını ve bir özetin var olduğunu kontrol edin. Özet Getir yalnızca kalıcı çıktıyı okur.
- 429 veya geçici hizmet hatası: okumaları gecikmeli olarak yeniden deneyin ve API hataları ve limitlerini takip edin. Bir yazma işlemini yeniden denemeden önce zaten oluşturulmuş bir Çalışma olup olmadığını kontrol edin.
0.1.1 sürümü Kitle oluşturmaz, dosya yüklemez, araştırma başlatmaz, veri silmez veya bir Minds olay tetikleyicisi sağlamaz. Ek işlemler için Çalışma API'sine ve MCP belgelerine başvurun. Sentetik bulgular yönlendirici kanıt sağlar; temsili insan popülasyonu tahminleri oluşturmazlar.
Tüm entegrasyonlara göz atın veya n8n kitle kontrolü iş akışına bakın.
