Derinlemesine araştırma için yapay zekanın gücünden yararlanmayı hiç dilediniz mi, ancak kapalı kaynak çözümler ve veri gizliliği endişeleri nedeniyle sınırlı hissettiniz mi? O halde, bu makalede, Gemini API tarafından desteklenen, tamamen bize ait bir Açık Kaynaklı Derin Araştırma Aracı oluşturduğumuz için kolları sıvamaya hazır olun!
Evet, tamamen kontrolünüz altında olan bir araştırma merkezi oluşturuyoruz. Bunu, parmaklarınızın ucunda, yoluna çıktığınız herhangi bir konuya derinlemesine dalmaya hazır, özel bir yapay zeka araştırma asistanına sahip olmak gibi düşünebilirsiniz. Ve en iyi yanı? Doğru ve anlayışlı analizler elde etmek için Gemini API'den yararlanacağız. Haydi başlayalım!
We’re thrilled to share that MCP support is coming soon to Apidog! 🚀
— Apidog (@ApidogHQ) March 19, 2025
Apidog MCP Server lets you feed API docs directly to Agentic AI, supercharging your vibe coding experience! Whether you're using Cursor, Cline, or Windsurf - it'll make your dev process faster and smoother.… pic.twitter.com/ew8U38mU0K
Açık Kaynaklı Derin Araştırma Nedir?
Açık Kaynaklı Derin Araştırma, araştırma sürecinizi kontrol altına almakla ilgilidir. Yapay zekanın gücünden yararlanırken, şeffaflığı, gizliliği ve araçlarınızı özel ihtiyaçlarınıza uyacak şekilde özelleştirme yeteneğini korumakla ilgilidir. Kendi araştırma aracımızı oluşturarak, kapalı kaynak çözümlerin sınırlamalarından ve potansiyel önyargılarından kaçınır ve verilerimizin güvenli kalmasını sağlarız. MCP, çeşitli API'lerle ve gelişmiş performans için işlevselliklerle uygun entegrasyon sağlayarak bu süreci kolaylaştırabilir.
Derin Araştırma için Neden Gemini API Kullanmalısınız?
Gemini API, yapay zekaya son teknoloji bir yaklaşım sunarak daha sezgisel ve etkili insan-makine etkileşimlerini mümkün kılar. Yalnızca metin tabanlı içgörüler sağlamakla kalmaz, aynı zamanda çok modlu girdileri de destekleyerek, görüntüler, videolar ve sesler aracılığıyla araştırma materyallerinin daha zengin bir şekilde anlaşılmasını sağlar. Bu, çeşitli veri türlerini analiz etmeyi gerektiren kapsamlı araştırma projeleri için özellikle değerlidir. Ek olarak, API'nin esnek tasarımı ve güçlü geliştirici desteği, yeniliği ve özelleştirmeyi teşvik ederek araştırmacıların aracı özel ihtiyaçlarını ve bağlamlarını karşılayacak şekilde uyarlamalarını sağlar ve sonuçta karmaşık konuların daha derin ve daha nüanslı bir şekilde anlaşılmasını teşvik eder.
Açık Kaynaklı Derin Araştırma Aracımızın Temel Özellikleri
Yapım sürecine dalmadan önce, hayata geçireceğimiz bazı özelliklere bir göz atalım:
- Hızlı içgörüler için Hızlı Derin Araştırma.
- Kesintisiz erişim için Çoklu Platform Desteği.
- Gelişmiş yapay zeka yetenekleri için Google Gemini tarafından desteklenmektedir.
- Akıllı analiz için Düşünme ve Ağ Modelleri.
- Görsel organizasyon için Tuval Desteği.
- İlerlemeyi izlemek için Araştırma Geçmişi.
- Esneklik için Yerel ve Sunucu API Desteği.
- Güvenli araştırma için Gizliliğe Odaklı tasarım.
- Gelişmiş işlevsellik için Çoklu Anahtar Yük Desteği.
- Çoklu dil desteği: English, 简体中文.
- Verimlilik ve performans için Modern Teknolojilerle Oluşturulmuştur.
Açık Kaynaklı Derin Araştırma Aracı'na Başlarken
Kendi yapay zeka destekli araştırma asistanınızı oluşturmaya hazır mısınız? İşte başlamak için ihtiyacınız olanlar:
1. Gemini API Anahtarı Alın: Her şeyden önce, Google'ın yapay zeka modellerinin gücüne erişmek için bir Gemini API anahtarına ihtiyacınız olacak. Google AI Studio'ya gidin ve bir API anahtarı için kaydolun. Bu anahtarı güvenli ve emniyetli tutun; bu, Gemini dünyasına giriş biletinizdir!
2. Tek Tıkla Dağıtım (İsteğe Bağlı): Mümkün olan en hızlı başlangıç için, tek tıkla dağıtım seçeneklerini kullanabilirsiniz:
- Vercel ile dağıtın (Vercel için talimatlar genellikle basittir ve GitHub deponuzu ve Vercel hesabınızı bağlamayı gerektirir).
- Cloudflare ile dağıtın (Şu anda proje Cloudflare'e dağıtımı destekliyor, ancak bunu yapmak için Cloudflare Pages'e nasıl dağıtılır'i izlemeniz gerekiyor).
Bu seçenekler, araştırma aracınızı dakikalar içinde çalışır duruma getirecektir, ancak tam özelleştirme deneyimi için yerel geliştirmeye odaklanacağız.
Açık Kaynaklı Derin Araştırma Aracı'nı Geliştirin
Yapım sürecinin kalbine dalalım! Deep Research'ü yerel tarayıcınızda çalışır duruma getirmek için şu adımları izleyin.
Önkoşullar
Başlamadan önce, sisteminizde aşağıdakilerin yüklü olduğundan emin olun:
- Node.js: (sürüm 18.18.0 veya üzeri önerilir). Bunu resmi Node.js web sitesinden indirebilirsiniz.
- pnpm veya npm veya yarn: Bunlar, Node.js için paket yöneticileridir. Bu eğitimde pnpm kullanacağız, ancak hangisini tercih ederseniz onu kullanabilirsiniz.
Kurulum
1. Depoyu klonlayın:
git clone https://github.com/u14app/deep-research.git
cd deep-researchBu, kodu GitHub'dan indirecek ve sizi proje dizinine taşıyacaktır.
2. Bağımlılıkları yükleyin:
pnpm install # or npm install or yarn installBu komut, proje için gerekli tüm paketleri yükleyecektir.
3. Ortam Değişkenlerini Ayarlayın:
Bu çok önemli bir adım! Projenizin kök dizininde bir .env dosyası oluşturmanız ve aşağıdaki ortam değişkenlerini yapılandırmanız gerekecektir:
# (Optional) Server-side Gemini API Key (Required for server API calls)
GOOGLE_GENERATIVE_AI_API_KEY=YOUR_GEMINI_API_KEY
# (Optional) Server API Proxy URL. Default, `https://generativelanguage.googleapis.com`
API_PROXY_BASE_URL=
# (Optional) Server API Access Password for enhanced security
ACCESS_PASSWORD=
# (Optional) Injected script code can be used for statistics or error tracking.
HEAD_SCRIPTS=YOUR_GEMINI_API_KEY'i, Google AI Studio'dan aldığınız gerçek API anahtarıyla değiştirin.
Ortam Değişkenleri Hakkında Önemli Notlar:
- GOOGLE_GENERATIVE_AI_API_KEY: İsteğe bağlı ancak sunucu tarafı API'yi kullanmak için gereklidir. Google AI Studio'dan bir Google Generative AI API anahtarı almanız gerekir. Bu anahtar gizli tutulmalı ve asla genel deponuza işlenmemelidir.
- API_PROXY_BASE_URL: İsteğe bağlı. API istekleri için bir proxy sunucusu kullanmanız gerekiyorsa, bu değişkeni proxy sunucunuzun temel URL'si ile yapılandırın. Bu, sunucu tarafı API çağrıları için geçerlidir.
- ACCESS_PASSWORD: İsteğe bağlı ancak sunucu tarafı dağıtımlar için şiddetle tavsiye edilir. Sunucu tarafı API uç noktalarınızı korumak için güçlü bir parola ayarlayın. Bu parola, sunucu tarafı API işlevlerine erişmek için gerekecektir.
- HEAD_SCRIPTS: İsteğe bağlı Enjekte edilen komut kodu, istatistik veya hata takibi için kullanılabilir.
Gizlilik Hatırlatıcısı: Bu ortam değişkenleri öncelikle sunucu tarafı API çağrıları için kullanılır. Yerel API modunu kullanırken, gizliliğinizi daha da artıran hiçbir API anahtarına veya sunucu tarafı yapılandırmasına gerek yoktur.
Çoklu anahtar Desteği: Birden fazla anahtarı destekler, her anahtar ,, ile ayrılır, örn. key1,key2,key3. Resmi derleme betiği Next.js 15'i desteklemediğinden, Cloudflare şu anda çoklu anahtar kullanamaz.
4. Geliştirme sunucusunu çalıştırın:
pnpm dev # or npm run dev or yarn devBu, geliştirme sunucusunu başlatacak ve http://localhost:3000 adresinden tarayıcınızda Deep Research'e erişebilirsiniz.
- Araştırmanız gereken herhangi bir soruyu sormaya başlayın.
- Ve sonuçları görüntüleyin!
Açık Kaynaklı Derin Araştırma Aracı'nı Dağıtın
Yerel kurulumunuzdan memnun kaldığınızda, araştırma aracınızı buluta dağıtabilirsiniz! İşte birkaç popüler seçenek:
1. Vercel: Vercel ile dağıtın (Bu genellikle en kolay seçenektir).
2. Cloudflare: Şu anda proje Cloudflare'e dağıtımı destekliyor, ancak bunu yapmak için Cloudflare Pages'e nasıl dağıtılır'i izlemeniz gerekiyor.
3. Docker:
- Docker sürümünün 20 veya üzeri olması gerekir.
- Önceden oluşturulmuş görüntüyü çekin:
docker pull xiangfa/deep-research:latest- Kapsayıcıyı çalıştırın:
docker run -d --name deep-research -p 3333:3000 xiangfa/deep-researchAyrıca ortam değişkenleri de belirtebilirsiniz:
docker run -d --name deep-research \
-p 3333:3000 \
-e GOOGLE_GENERATIVE_AI_API_KEY=AIzaSy... \
-e ACCESS_PASSWORD=your-password \
xiangfa/deep-research- Veya kendi docker görüntünüzü oluşturun:
docker build -t deep-research .
docker run -d --name deep-research -p 3333:3000 deep-research- docker-compose.yml kullanarak dağıtın:
version: '3.9'
services:
deep-research:
image: xiangfa/deep-research
container_name: deep-research
environment:
- GOOGLE_GENERATIVE_AI_API_KEY=AIzaSy...
- ACCESS_PASSWORD=your-password
ports:
- 3333:3000Ardından kendi docker compose'unuzu oluşturun:
docker compose -f docker-compose.yml build4. Statik Dağıtım:
- Ayrıca doğrudan bir statik sayfa sürümü oluşturabilir ve ardından out dizinindeki tüm dosyaları Github Page, Cloudflare, Vercel vb. gibi statik sayfaları destekleyen herhangi bir web sitesi hizmetine yükleyebilirsiniz.
pnpm build:exportAçık Kaynaklı Derin Araştırma Aracı Yapılandırması
"Açık Kaynaklı Derin Araştırma Aracı'na Başlarken" bölümünde belirtildiği gibi, Deep Research, sunucu tarafı API yapılandırmaları için aşağıdaki ortam değişkenlerini kullanır:
- GOOGLE_GENERATIVE_AI_API_KEY
- API_PROXY_BASE_URL
- ACCESS_PASSWORD
Bu değişkenler, yalnızca sunucu tarafı API çağırma işlevini kullanmayı amaçlıyorsanız gereklidir. Yerel API çağrıları için, projeyi ayarlamanın ötesinde hiçbir yapılandırmaya gerek yoktur.
API anahtarlarınızı ve parolalarınızı her zaman güvende tutmayı unutmayın!
Sonuç: Araştırmanızı Yapay Zeka ile Güçlendirmek
Artık Gemini API tarafından desteklenen kendi Açık Kaynaklı Derin Araştırma aracınızı başarıyla oluşturdunuz! Bu, araştırma sürecinizde yapay zekanın tüm potansiyelini ortaya çıkarmanın büyük bir adımıdır.
Kendi aracınızı oluşturarak, verileriniz üzerinde tam kontrole sahip olur, iş akışlarınızı özelleştirir ve açık kaynak topluluğuna katkıda bulunursunuz. Farklı araştırma modelleriyle deneyler yapın, Gemini API'nin yeteneklerini keşfedin ve araştırma deneyiminizi gerçekten kişiselleştirmek için özel araçlar oluşturun.
Araştırmanın geleceği zeki ve açıktır. Açık Kaynaklı Derin Araştırma'yı benimseyin ve ihtiyacınız olan bilgiyle kendinizi güçlendirin!
