AI Kodlama Araçları
AI asistanınızın mindzieAPI’yi anında anlamasını sağlayın
Claude Code, Cursor, Windsurf ve GitHub Copilot gibi modern AI kodlama araçları, dokümantasyonu doğrudan URL’lerden okuyabilir. Biz, AI kodlama asistanınıza mindzieAPI hakkında eksiksiz bilgi sağlayan LLM-uyumlu dokümantasyon dosyaları sunuyoruz.
Hızlı Referans
AI kodlama araçlarınızı yapılandırmak için bu URL’leri kopyalayın:
| Kaynak | URL | En İyi Kullanım |
|---|---|---|
| Tam Dokümantasyon | https://docs.mindziestudio.com/llms-full.txt |
Tam API anlayışı (~120K token) |
| Dokümantasyon Dizini | https://docs.mindziestudio.com/llms.txt |
Sayfalara bağlantılı hızlı referans |
Claude Code
Claude Code, WebFetch veya özel talimatlar kullanarak dokümantasyona erişebilir.
Yöntem 1: WebFetch (Önerilen)
Bir Claude Code oturumunda, tam dokümantasyonu çekin:
Please read the mindzieAPI documentation from https://docs.mindziestudio.com/llms-full.txt
Claude, API dokümantasyonunun tamamını çeker ve okur. Daha sonra uç noktalar, kimlik doğrulama, istek/yanıt formatları hakkında sorular sorabilir ve kod örnekleri alabilirsiniz.
Yöntem 2: Proje Talimatlarına Ekleme
Oturumlar arasında kalıcı erişim için projenizin CLAUDE.md veya .claude/settings.json dosyasına ekleyin:
## mindzieAPI Referansı
mindzieAPI ile çalışırken dokümantasyonu şuradan çekin:
https://docs.mindziestudio.com/llms-full.txt
Bu, tam API dokümantasyonunu içerir:
- Kimlik doğrulama (Bearer tokenlar, API anahtarları)
- Tüm uç noktalar (tenantlar, kullanıcılar, projeler, veri setleri, bloklar, panolar)
- İstek/yanıt formatları
- Birden çok dilde kod örnekleri
Örnek Komutlar
Claude dokümantasyona sahip olduktan sonra sorabilirsiniz:
- "mindzieAPI ile nasıl kimlik doğrulaması yaparım?"
- "Yeni bir veri seti oluşturmak için Python kodu yaz"
- "Bir bloğu yürütmek için uç nokta nedir?"
- "Bir projeye CSV dosyası nasıl yüklenir göster"
Cursor IDE
Cursor, kodlama sırasında anında erişim için @docs özelliği ile dokümantasyonu indeksleyebilir.
Kurulum Adımları
- Cursor Ayarlarını açın (Cmd/Ctrl + ,)
- Özellikler > Dokümanlar bölümüne gidin
- Yeni doküman ekle butonuna tıklayın
- URL girin:
https://docs.mindziestudio.com/llms-full.txt - İsmini verin:
mindzieAPI
Kullanım
Cursor sohbetinde bu dokümantasyona referans verin:
@mindzieAPI API isteklerini nasıl kimlik doğrularım?
@mindzieAPI Bir tenant içindeki tüm projeleri listeleyen fonksiyon yaz
Windsurf
Windsurf, AI destekli kodlama için harici doküman kaynaklarını destekler.
Kurulum
- Windsurf ayarlarını açın
- Bilgi tabanı veya dokümantasyon bölümüne gidin
- Harici kaynak olarak
https://docs.mindziestudio.com/llms-full.txtekleyin
Kullanım
Kodlama yaparken Windsurf, mindzieAPI dokümantasyonunu otomatik olarak referans göstererek doğru öneriler ve tamamlamalar sağlar.
GitHub Copilot
Copilot URL’leri doğrudan çekmese de proje dosyalarınız aracılığıyla bağlam sağlayabilirsiniz.
Seçenek 1: Projeye Dahil Etme
Projede docs/mindzieAPI.md dosyası oluşturun, API referansını buraya ekleyin. Copilot, o projede çalışırken bunu bağlam olarak kullanır.
Seçenek 2: Copilot Sohbet
GitHub Copilot Chat içinde dokümantasyonun önemli bölümlerini yapıştırabilir veya URL’yi referans gösterebilirsiniz:
Using the mindzieAPI documented at https://docs.mindziestudio.com/llms-full.txt,
write a Python class to manage datasets.
Cody (Sourcegraph)
Cody, bağlama duyarlı yardım için harici dokümantasyonu indeksleyebilir.
Kurulum
- Cody ayarlarını açın
- Bağlam kaynaklarına
https://docs.mindziestudio.com/llms-full.txtekleyin - Dokümantasyon kodlama oturumlarınız arasında erişilebilir olur
Genel LLM Kullanımı
Herhangi bir LLM arayüzü (ChatGPT, Claude web vb.) için:
- Önce dizini alın: Dokümantasyon yapısını görmek için
https://docs.mindziestudio.com/llms.txtadresini ziyaret edin - Tam dokümanları elde edin: İçeriği
https://docs.mindziestudio.com/llms-full.txt’den LLM bağlamınıza yapıştırın - Sorular sorun: LLM artık tüm mindzieAPI’yi anlar
Neler Dahil
LLM dokümantasyonu tüm mindzieAPI yeteneklerini kapsar:
| Kategori | Kapsam |
|---|---|
| Kimlik Doğrulama | API anahtarları (Genel ve Tenant), Bearer tokenlar, kapsamlar, güvenlik en iyi uygulamaları |
| Tenantlar | Çoklu tenant yönetimi, oluşturma, güncelleme, korumalı silme |
| Kullanıcılar | Genel işlemler, tenant’a özgü işlemler, roller ve izinler |
| Projeler | CRUD işlemleri, önbellekleme, kullanıcı erişimi, içe/dışa aktarma (.mpz dosyaları) |
| Veri Setleri | Oluşturma, CSV/XES içe aktarma, güncellemeler, sütun eşleme, dosya formatları |
| Bloklar | Analiz blokları, yürütme, sonuç alımı, blok türleri |
| Panolar | Yönetim, panel yapılandırma, paylaşım ve genel URL’ler |
| Zenginleştirmeler | Boru hatları, Python not defteri entegrasyonu, yürütme |
| Eylemler | İsimlendirilmiş eylem yürütme, ping uç noktaları, yürütme geçmişi |
| Yürütme | Asenkron iş yönetimi, kuyruk işlemleri, durum takibi |
Bağlam Penceresi Dikkatleri
Farklı AI modellerinin farklı bağlam sınırları vardır. Dokümantasyon dosyalarımızın durumu şöyle:
| Model | Bağlam Limiti | llms-full.txt | Öneri |
|---|---|---|---|
| Claude Opus 4 | 200K token | Sığar (~120K) | Tam dokümantasyon kullanın |
| Claude Sonnet | 200K token | Sığar (~120K) | Tam dokümantasyon kullanın |
| GPT-4 Turbo | 128K token | Sıkışık sığar | Tam dokümantasyon kullanın |
| GPT-4o | 128K token | Sıkışık sığar | Tam dokümantasyon kullanın |
| Claude Haiku | 200K token | Sığar (~120K) | Tam dokümantasyon kullanın |
| Gemini Pro | 128K token | Sıkışık sığar | Dizini + belirli sayfalar gerekebilir |
| GPT-3.5 | 16K token | Çok büyük | Dizini kullanın, belirli sayfaları çekin |
Daha Küçük Bağlam Pencereleri İçin
Modelinizin bağlam alanı kısıtlıysa:
- API yapısını anlamak için
llms.txt(dizin) dosyasını kullanın - İhtiyacınız olan bölümleri belirleyin
/docs-master/mindzieAPI/{category}/{page}/page.mdyolundan tek tek markdown dosyalarını çekin
Dosya Formatları
| URL | Format | Boyut | Token Sayısı |
|---|---|---|---|
/llms.txt |
Markdown (dizin) | ~6 KB | ~1.5K |
/llms-full.txt |
Markdown (tam) | ~470 KB | ~120K |
/docs-master/.../*.md |
Markdown (tek tek sayfalar) | 2-15 KB | ~500-4K |
Dokümantasyonun Güncel Tutulması
LLM dokümantasyonu API dokümantasyonu her güncellendiğinde yeniden üretilir. Dosyalar, ne zaman oluşturulduğunu gösteren zaman damgası içerir.
En güncel doküman için AI aracınız dokümanları sonsuza dek önbelleğe almak yerine taze kopyalarını çekmelidir.
MCP Sunucu Entegrasyonu
Gelişmiş AI araç entegrasyonu için mindzieAPI, AI asistanlarının mindzieStudio ile programlı şekilde etkileşime geçmesini sağlayan bir MCP (Model Context Protocol) sunucusu sunar.
MCP sunucu, tüm blok türlerini (filtreler, hesaplayıcılar ve zenginleştirmeler) eksiksiz metadata ile tek çağrıda döndüren mindzie_list_block_types gibi araçlar içerir.
MCP Sunucu Dokümantasyonunu Görüntüle
Sonraki Adımlar
AI yardımıyla kodlamaya başlamaya hazır mısınız? İşte deneyebileceğiniz bazı şeyler:
- AI kodlama aracınızı
https://docs.mindziestudio.com/llms-full.txtadresine yönlendirin - Sorun: "mindzieAPI ile nasıl kimlik doğrulaması yaparım?"
- İsteyin: "Tüm projeleri listeleyen Python kodu yaz"
- Oluşturun: AI destekli kod üretimi ile tam entegrasyonlar geliştirin
İnsana yönelik dokümantasyon için Hızlı Başlangıç Kılavuzu veya tam API Referansı sayfalarına göz atabilirsiniz.