ChatBot Ajanı İçin Pinecone Index Oluşturma

ChatBot ajanınızın bilgi bankasındaki sorular vektör olarak Pinecone'da saklanır; yapay zeka ziyaretçinin sorusunu en yakın anlamlı cevapla eşleştirmek için bu vektör veritabanını kullanır. Pinecone hesabı kendinize aittir; faturalandırma doğrudan Pinecone üzerinden yürür.

Bu rehber sıfırdan bir Pinecone hesabı açıp BulutPress paneline yapıştırabileceğiniz API anahtarı, Host URL ve Index adı üçlüsünü edinmeniz için gereken adımları anlatır. Ortalama tamamlanma süresi 5 dakikadır.

⚠️ En Kritik Ayar: Index'i mutlaka 1536 boyut (dimension) ile oluşturun. BulutPress ChatBot, OpenAI'ın text-embedding-3-small modelini kullanır ve bu model 1536 boyutlu vektör üretir. Yanlış boyutlu index seçerseniz senkronizasyon hata verir ve hiçbir soru saklanamaz.

1. Pinecone Hesabı Açın

1. Tarayıcınızdan https://app.pinecone.io/?sessionType=signup adresine gidin.
2. E-posta + şifre ile veya Google / GitHub / Microsoft hesabınızla kayıt olun.
3. Doğrulama e-postasını onaylayın.
4. Karşılama anketinde sektör/kullanım amacı sorulabilir; istediğiniz seçenekleri işaretleyip geçebilirsiniz.

Zaten hesabınız varsa https://app.pinecone.io üzerinden giriş yapın.

Pinecone'un Starter (ücretsiz) planı ChatBot kullanımı için fazlasıyla yeterlidir; kredi kartı bilgisi bile istenmez, ödeme yöntemi tanımlamadan başlayabilirsiniz. Detaylı limitler için bu sayfanın altındaki Pinecone Maliyetleri bölümüne bakın — göreceksiniz, ücretsiz hak gerçekten cömert.

2. Index Oluşturun

Index, Pinecone'da vektörlerin saklandığı kaba verilen addır. Her ChatBot ajanı için ayrı bir index oluşturmanız tavsiye edilir (verilerin karışmaması için).

1. Sol menüden Indexes sekmesine gidin.

2. Create index düğmesine basın (yeni hesaplarda büyük bir başlat düğmesi görebilirsiniz).

3. Açılan formda şu değerleri girin:

   Alan	Değer	Açıklama
   Name	bulutpress-chatbot	Küçük harfler, rakam ve tire kullanın. Ajan başına ayırt edici bir ad seçin (örn. bulutpress-chatbot-magaza).
   Configuration	Custom settings	"Setup by model" seçeneğini kullanmıyoruz çünkü sabit ayarlar gerekiyor.
   Dimensions	1536	⚠️ MUTLAKA 1536. Değiştirmeyin.
   Metric	cosine	OpenAI embedding'leri için doğru metrik.
   Capacity mode	Serverless	Ücretsiz tier ve ölçeklenebilirlik için en uygun.
   Cloud provider	AWS	Varsayılan, en geniş bölge desteği.
   Region	us-east-1 (Virginia)	Starter (ücretsiz) tier yalnızca bu bölgede çalışır. Ücretli planda dilediğiniz bölgeyi seçebilirsiniz.

4. Diğer alanları varsayılan bırakın.

5. Create index düğmesine basın.

6. Index hazırlanması 30-60 saniye sürer; Status sütunu Ready olduğunda kullanıma hazır demektir.

Önemli: Bir index oluşturulduktan sonra boyut (Dimensions) değiştirilemez. Yanlış boyut seçtiyseniz index'i silip 1536 ile yeniden oluşturmanız gerekir.

3. Host URL'i Kopyalayın

1. Indexes listesinden oluşturduğunuz index adına tıklayın.
2. Üstte Host etiketinin yanında URL gösterilir (örnek: bulutpress-chatbot-abc123.svc.aped-4627-b74a.pinecone.io).
3. Yanındaki kopyala simgesine basarak URL'i panoya alın.

Not: Bu URL'i https:// ön eki olmadan kopyalamanız yeterli; BulutPress paneli ön eki otomatik tamamlar. Yine de https:// ile yapıştırırsanız da çalışır.

4. API Anahtarını Edinin

1. Sol menüden API keys sekmesine gidin (alternatif yol: sol alt Settings → API keys).
2. Yeni hesaplarda zaten default adında bir anahtar üretilmiş olur — bu anahtarı kullanabilirsiniz.
3. Yeni bir anahtar oluşturmak için sağ üstteki + Create API key düğmesine basın.
4. Name alanına ayırt edici bir ad girin (örn. BulutPress ChatBot - Site Adı).
5. Create key düğmesine basın.
6. Açılan ekranda pcsk_... ile başlayan anahtarı hemen kopyalayın ve güvenli bir yerde saklayın.

⚠️ Çok Önemli: API anahtarı yalnızca bu ekranda bir kez gösterilir. Pencereyi kapatırsanız bir daha göremezsiniz; yeni anahtar oluşturmak zorunda kalırsınız.

5. BulutPress Panelinde Tanımlayın

1. ChatBot ajanınızın Ayarlar sayfasına girin.
2. Pinecone API Anahtarı alanına pcsk_... ile başlayan değeri yapıştırın.
3. Pinecone Host URL alanına 3. adımdaki host URL'ini yapıştırın.
4. Pinecone Index alanına 2. adımda verdiğiniz index adını (örn. bulutpress-chatbot) yazın.
5. Kaydet düğmesine basın.

Form kaydedildikten sonra ayarlar BulutPress tarafından doğrulanır; geçersiz değer girerseniz hata mesajı ile geri dönülür.

6. Senkronizasyonu Başlatın

Pinecone bağlantısı tanımlandıktan sonra:

1. ChatBot ajanı menüsünden Bilgi Bankası → Pinecone Senkronizasyonu sayfasına girin.
2. Tümünü Senkronize Et düğmesine basarak bilgi bankanızdaki sorularınızı Pinecone'a yükleyin.
3. İlerleme çubuğu süreci gösterir; tamamlandığında her satır Senkronize etiketi alır.

Senkronizasyon tamamlandıktan sonra widget canlı sorulara yanıt vermeye başlar.

Pinecone Maliyetleri — Korkmayın, Ücretsiz Plan Yeter

Bu bölümü dikkatle okumanızı öneriyoruz; çoğu kullanıcı Pinecone deyince "vektör veritabanı, pahalıdır herhalde" diye geri çekiliyor. Oysa Pinecone'un Starter (ücretsiz) planı son derece cömerttir ve kredi kartı bilgisi bile istenmez.

Aylık ücretsiz haklar şunlardır:

Yani tipik bir kurumsal sitenin bilgi bankası (100-2.000 soru) ve aylık trafiği (birkaç bin ziyaretçi sorusu) Starter planın yüzde birkaçını ancak doldurur.

• Depolama tarafından doldurmak neredeyse imkansız — 2 GB ile yaklaşık 1 milyon soru vektörü saklayabilirsiniz. Hiçbir kurumsal bilgi bankası bu büyüklüğe ulaşmaz.
• Yazma limiti yüksek — Tüm bilgi bankanızı aylık 2.000 kez sıfırdan senkronize etseniz bile sınıra varmazsınız.
• Okuma limiti rahat — Günde ~2.500 ziyaretçi sorusu (aylık ~75.000) civarına kadar ücretsiz plan yeterlidir. Bu rakam çoğu KOBİ sitesinin çok üzerindedir.

Sonuç: Pinecone hesabınızı ücretsiz açın, Upgrade düğmesine bakmadan rahat rahat ChatBot ajanınızı çalıştırın. Ücretli plana geçme ihtiyacı, ancak çok yüksek trafikli (günde 5.000+ sorgu) veya milyonlarca soru içeren özel kullanımlarda ortaya çıkar.

Ücretli planlara (Standard / Enterprise) ihtiyaç duyduğunuzda çoklu index, ek bölgeler ve SLA seçenekleri devreye girer. Güncel fiyatlandırma için https://www.pinecone.io/pricing adresine bakabilirsiniz.

Sorun Giderme

• "Invalid API key" / "Authentication failed" hatası — Anahtarın başında veya sonunda boşluk olmadığından emin olun. Hâlâ olmuyorsa Pinecone panelinden anahtarı silip yenisini oluşturun.
• "Dimension mismatch" hatası — Index'i 1536 boyut yerine farklı bir boyutla oluşturmuşsunuzdur. Index'i silip 1536 ile yeniden oluşturmanız gerekir.
• Senkronizasyon başlamıyor — Host URL'inin doğru index'e ait olduğundan emin olun. Birden fazla index'iniz varsa karıştırmış olabilirsiniz.
• "Index not found" hatası — BulutPress panelindeki index adı yazımı Pinecone'daki index adı ile birebir aynı (büyük/küçük harf, tire) olmalıdır.

Tüm adımlar tamamlandıktan sonra ChatBot ajanınız Pinecone üzerinden vektör arama yapmaya hazırdır. Henüz OpenAI API anahtarı tanımlamadıysanız sağ menüdeki OpenAI API Anahtarı Alma rehberine bakabilirsiniz.

Güncelleme Tarihi: 04.05.2026 11:19