Atalay Tech
Hizmetlerimiz
Kurumsal
ReferanslarMobil Uygulama Fiyatı
Müşteri Paneliİletişim
Yapay Zeka Entegrasyonu İçin Teknik Şartname Nasıl Hazırlanır?
Atalay Tech
Hizmetlerimiz
Kurumsal
ReferanslarMobil Uygulama Fiyatı
Müşteri Paneliİletişim
Atalay Tech
Hizmetlerimiz
Kurumsal
ReferanslarMobil Uygulama Fiyatı
Müşteri Paneliİletişim
Ana Sayfa
Blog
Yapay Zeka Entegrasyonu İçin Teknik Şartname Nasıl Hazırlanır?
Kaan Atalay
Kaan Atalay
Yayın: 26 Temmuz 2026
Son güncelleme: 26 Temmuz 2026
17 dk okuma

Rehber

Yapay Zeka Entegrasyonu İçin Teknik Şartname Nasıl Hazırlanır?

Yapay zeka entegrasyonu teknik şartname dokümanı, bir işletmenin AI projesinden ne beklediğini yazılım ekibine, yönetime ve tedarikçiye aynı netlikte anlatan ana belgedir. İyi hazırlanmış bir şartname; “chatbot istiyoruz”, “CRM’e yapay zeka ekleyelim” veya “teklifleri AI hazırlasın” gibi genel talepleri ölçülebilir iş akışlarına çevirir.

Bir yapay zeka entegrasyonu projesinde başarısızlığın en sık nedeni model kalitesi değil, belirsiz kapsam, dağınık veri yapısı, ölçülmemiş başarı kriterleri ve bakım planı olmayan entegrasyonlardır. Teknik şartname bu belirsizliği azaltır.

Atalay Tech’in mobil uygulama, web platformu, yönetim paneli, API bağlantısı ve AI otomasyon projelerinde gördüğü pratik gerçek şu: AI projesi yazılım projesinden ayrı düşünülmemelidir. Yapay zeka çoğu zaman mevcut CRM, ERP, web sitesi, mobil uygulama, WhatsApp hattı veya admin paneli üzerine eklenen bir karar, öneri, sınıflandırma ya da otomasyon katmanıdır.

Stanford HAI tarafından yayımlanan 2025 AI Index Report, üretken yapay zeka yatırımlarının 2024’te küresel ölçekte 33,9 milyar dolara ulaştığını belirtir. Bu ölçekte büyüyen bir teknoloji alanında işletmelerin “önce deneyelim, sonra bakarız” yaklaşımı yerine doğru kapsam, veri güvenliği ve risk yönetimiyle ilerlemesi gerekir.

Teknik Şartname Nedir ve AI Projelerinde Neden Daha Kritik Hale Gelir?

Teknik şartname; projenin amacı, kapsamı, kullanıcı rolleri, veri kaynakları, entegrasyon noktaları, güvenlik gereksinimleri, performans beklentileri, teslimatlar ve kabul kriterlerini yazılı hale getiren dokümandır.

Klasik yazılım projelerinde şartname genellikle ekranlar, formlar, roller ve raporlar üzerinden ilerler. Yapay zeka projelerinde buna ek olarak veri kalitesi, model davranışı, doğruluk eşiği, insan onayı, prompt yönetimi, loglama, hata senaryosu ve etik sınırlar da yazılmalıdır.

Örneğin bir müşteri destek AI ajanı için yalnızca “müşteri sorularını cevaplayacak” yazmak yeterli değildir. Şartnamede şu ayrıntılar bulunmalıdır:

  • Hangi kanallardan gelen sorular işlenecek?
  • Bot hangi kaynaklardan cevap üretecek?
  • Hangi konularda canlı temsilciye devredecek?
  • Yanlış cevap verdiğinde nasıl kayıt tutulacak?
  • KVKK kapsamındaki veriler modele nasıl gönderilecek?
  • Başarı metriği cevap doğruluğu mu, çözüm oranı mı, temsilciye aktarım oranı mı?

NIST’in AI Risk Management Framework dokümanı, AI sistemlerinde güvenilirlik, ölçülebilir risk yönetimi ve yönetişim yaklaşımının önemini vurgular. Teknik şartname de bu yaklaşımı proje düzeyine indirir.

İlgili hizmetimiz

Yapay Zeka Entegrasyonu

Yapay Zeka Entegrasyonu

Atalay Tech ile yapay zeka entegrasyonu: LLM chatbot, RAG, otomasyon ve özel ML modülleri. Web, mobil ve kurumsal sistemlere API ile AI ekleyin.

Detaylı Bilgi
Tüm hizmetleri görüntüleİletişim

Yapay Zeka Entegrasyonu Teknik Şartnamesi Hangi Projeler İçin Hazırlanır?

Yapay zeka entegrasyonu yalnızca chatbot projeleri için şartname gerektirmez. AI’ın iş sürecine dokunduğu her senaryoda yazılı kapsam gerekir.

En sık karşılaşılan proje tipleri şunlardır:

Proje TipiAI KullanımıŞartnamede Kritik Nokta
Müşteri destek AI ajanıSSS yanıtlama, talep sınıflandırma, canlı desteğe yönlendirmeBilgi kaynağı, eskalasyon kuralları, cevap doğruluğu
WhatsApp AI botLead toplama, randevu alma, teklif ön elemeMesaj akışı, KVKK onayı, CRM aktarımı
CRM AI entegrasyonuLead skorlaması, özet çıkarma, görev önerisiCRM alanları, skor mantığı, satış ekibi onayı
ERP AI entegrasyonuStok tahmini, sipariş analizi, rapor özetlemeERP API erişimi, veri güncelliği, yetkilendirme
Web sitesi AI asistanıZiyaretçi yönlendirme, ürün önerisi, form tamamlamaSite içeriği, lead formu, takip entegrasyonu
Teklif hazırlama sistemiMüşteri ihtiyacından kapsam ve fiyat taslağı üretmeOnay mekanizması, şablon yapısı, revizyon takibi

Bu projelerin ortak noktası, AI’ın tek başına çalışmamasıdır. Çoğu senaryoda API entegrasyonu, yönetim ekranları, veri tabanı tasarımı, kullanıcı yetkileri ve bakım süreci birlikte planlanır.

Şartnameye Başlamadan Önce İş Hedefini Netleştirin

AI teknik şartnamesinin ilk bölümü teknolojiyle değil, iş hedefiyle başlamalıdır. Çünkü model seçimi, veri mimarisi ve entegrasyon yöntemi bu hedefe göre değişir.

Kötü hedef örnekleri:

  • “Web sitemize yapay zeka eklemek istiyoruz.”
  • “WhatsApp’ta otomatik cevap versin.”
  • “Satış ekibine yardımcı olsun.”
  • “CRM’i akıllı hale getirelim.”

Daha doğru hedef örnekleri:

  • “Web sitesi üzerinden gelen ziyaretçilerin proje ihtiyacını 6 soruluk akışla toplayıp CRM’e lead olarak aktarsın.”
  • “WhatsApp’tan gelen talepleri sektör, bütçe, aciliyet ve hizmet tipine göre sınıflandırsın.”
  • “Satış temsilcisine görüşme özeti, teklif kapsamı ve takip tarihi önerisi oluştursun.”
  • “Yönetim panelinde müşteri mesajlarını konu başlığına göre gruplayıp haftalık rapor üretsin.”

Atalay Tech kurucusu Kaan Atalay’ın proje değerlendirmelerinde özellikle dikkat ettiği noktalardan biri, AI özelliğinin “güzel görünen demo” değil, ölçülebilir iş çıktısı üretmesidir. Bu yüzden şartnamede hedef daima operasyonel bir metrikle bağlanmalıdır.

Persona ve Kullanıcı Senaryosu Yazın

Teknik şartname yalnızca sistemin ne yapacağını değil, kimin hangi durumda ne beklediğini de anlatmalıdır. Persona bölümü bu nedenle önemlidir.

Örnek persona:

Ayşe, 34 yaşında bir klinik yöneticisi. Gün içinde web sitesi, WhatsApp ve telefon üzerinden gelen hasta taleplerini takip ediyor. Sık sorulan fiyat, randevu ve işlem bilgisi soruları nedeniyle ekibi zaman kaybediyor. AI entegrasyonundan beklentisi, hastayı yanlış yönlendirmeden ön bilgi toplamak ve uygun talepleri sekreterya paneline aktarmak.

Bu persona üzerinden şartnameye şu kullanıcı senaryosu yazılabilir:

  • Kullanıcı web sitesindeki AI asistana işlem hakkında soru sorar.
  • AI asistan, klinik tarafından onaylanmış bilgi tabanından yanıt üretir.
  • Kullanıcının randevu niyeti varsa ad, telefon, tercih edilen tarih ve işlem türünü ister.
  • KVKK onayını almadan kişisel veriyi kaydetmez.
  • Bilgi eksikse “canlı ekip dönüş yapsın” statüsüyle panele kayıt açar.
  • Yönetim panelinde talebin kaynağı, özeti ve konuşma geçmişi görünür.

Bu seviye açıklık, yazılım ekibinin doğru veri modeli ve ekran akışı tasarlamasını sağlar. Proje yalnızca model API çağrısından ibaret kalmaz; gerçek operasyon akışına bağlanır.

Kapsamı Modüllere Bölün

Yapay zeka entegrasyonu teknik şartname dokümanında kapsam tek parça yazılmamalıdır. Modüllere ayrılmış bir yapı, hem fiyatlandırmayı hem de teslimat planını netleştirir.

Tipik modüller şunlardır:

ModülAçıklamaTeslimat Örneği
Veri hazırlığıSSS, ürün bilgisi, doküman, CRM alanları, geçmiş taleplerTemizlenmiş bilgi tabanı ve veri haritası
AI karar katmanıPrompt, model seçimi, sınıflandırma, özetleme, öneri üretimiTest edilebilir AI servis akışı
Entegrasyon katmanıCRM, ERP, web sitesi, mobil uygulama, WhatsApp, e-postaAPI bağlantıları ve webhook yapısı
Yönetim paneliKonuşma geçmişi, manuel onay, rapor, ayar ekranlarıAdmin panel modülleri
Güvenlik ve loglamaYetki, KVKK, erişim kaydı, hata takibiLog ekranı ve rol bazlı izinler
Test ve kabulSenaryo testleri, doğruluk ölçümü, performans kontrolüKabul test raporu

Bu ayrım özellikle özel yazılım geliştirme projelerinde önemlidir. Çünkü AI entegrasyonu çoğu zaman mevcut yazılım mimarisine özel geliştirme gerektirir.

Veri Kaynaklarını ve Veri Kalitesini Tanımlayın

AI projesinin kalitesi, modele verilen verinin kalitesiyle doğrudan ilişkilidir. Şartnameye “veriler sistemden alınacak” yazmak yeterli değildir. Hangi verinin nerede olduğu, ne sıklıkla güncellendiği ve kim tarafından onaylandığı belirtilmelidir.

Veri kaynakları şu şekilde sınıflandırılabilir:

Veri KaynağıÖrnekRiskŞartnamede Yazılması Gereken
Statik içerikSSS, hizmet sayfası, PDF, kullanım kılavuzuGüncel olmayan bilgiİçerik sahibi ve güncelleme periyodu
Operasyonel veriCRM leadleri, siparişler, randevularKişisel veri, eksik kayıtAlan listesi ve maskeleme kuralı
Konuşma geçmişiWhatsApp, canlı destek, e-postaHassas müşteri bilgisiSaklama süresi ve erişim yetkisi
Ürün/hizmet verisiFiyat, stok, paket, hizmet kapsamıYanlış öneri riskiKaynak sistem ve senkronizasyon sıklığı
Kullanıcı davranışıForm terk oranı, tıklama, sayfa ziyaretiRıza ve anonimleştirmeÖlçüm amacı ve veri anonimliği

Örneğin bir lead toplama sistemi için AI botun kullanıcıdan bütçe, sektör, proje tipi ve iletişim bilgisi alması yeterli değildir. Bu alanların CRM’de hangi kolonlara yazılacağı, eksik veri olduğunda ne yapılacağı ve satış ekibine nasıl bildirim gideceği de şartnameye eklenmelidir.

AI Modeli, Prompt ve Karar Mantığı Ayrı Yazılmalı

Teknik şartnamede “OpenAI kullanılacak”, “LLM entegre edilecek” veya “AI cevap verecek” gibi ifadeler tek başına yeterli değildir. Model sağlayıcısı değişebilir; fakat sistem davranışı değişmemelidir.

Bu yüzden şartnamede üç katman ayrı tanımlanmalıdır:

  • Model katmanı: Kullanılacak AI servis sağlayıcısı, model tipi, yedek sağlayıcı ihtiyacı.
  • Prompt katmanı: Sistem talimatları, cevap tonu, yasaklı cevaplar, kaynak kullanma kuralları.
  • Karar katmanı: Hangi durumda cevap verilecek, hangi durumda insana aktarılacak, hangi durumda kayıt açılacak.

Örnek karar kuralı:

DurumAI Davranışıİnsan Onayı Gerekir mi?
Kullanıcı genel hizmet sorusu sorarBilgi tabanından cevap üretirHayır
Kullanıcı fiyat isterÖn bilgi toplar, net fiyat vermezEvet
Kullanıcı hukuki/medikal kesin bilgi isterGenel bilgilendirme yapar, uzmana yönlendirirEvet
Kullanıcı kişisel veri paylaşırKVKK onayı kontrol edilirEvet, kayıt öncesi
Kullanıcı öfkeli veya şikayetçi konuşurÖzür + canlı temsilciye aktarımHayır, otomatik aktarım

Bu tablo, AI’ın sınırlarını netleştirir. Böylece sistem hem daha güvenli hem daha yönetilebilir hale gelir.

Entegrasyon Noktalarını Teknik Olarak Belirtin

Yapay zeka entegrasyonu genellikle mevcut sistemlere bağlanır. Şartnamede her entegrasyon için sistem adı, veri yönü, bağlantı yöntemi, yetkilendirme ve hata senaryosu yazılmalıdır.

Örnek entegrasyon tanımı:

  • Web sitesi formu → AI ön sınıflandırma → CRM kaydı
  • WhatsApp mesajı → AI yanıtı → satış temsilcisine bildirim
  • CRM görüşme notu → AI özet → teklif taslağı
  • ERP ürün verisi → AI öneri motoru → müşteri paneli
  • Mobil uygulama mesajı → AI moderasyon → admin onayı

Bu noktada yönetim paneli geliştirme ihtiyacı çoğu projede ortaya çıkar. Çünkü işletme, AI’ın verdiği yanıtları, topladığı leadleri, hata kayıtlarını ve performans metriklerini izlemek ister.

Şartnamede entegrasyon için şu alanlar bulunmalıdır:

AlanAçıklamaÖrnek
Kaynak sistemVerinin geldiği yerWeb formu, WhatsApp, CRM
Hedef sistemVerinin yazıldığı yerCRM, admin panel, ERP
Veri yönüTek yönlü veya çift yönlüWhatsApp → CRM
Kimlik doğrulamaAPI key, OAuth, tokenBearer token
Hata yönetimiAPI kesilirse ne olur?Kuyruğa al, tekrar dene
LoglamaHangi işlem kaydedilir?Mesaj, zaman, sonuç, hata kodu

Güvenlik, KVKK ve Regülasyon Maddelerini Atlamayın

AI projelerinde güvenlik yalnızca sunucu güvenliği değildir. Model sağlayıcısına hangi verinin gönderildiği, kişisel verinin nasıl maskelendiği, konuşma kayıtlarının ne kadar saklandığı ve kullanıcı onayının nasıl alındığı da güvenlik kapsamına girer.

Avrupa Birliği’nin AI Act sayfasında belirtildiği üzere yapay zeka sistemleri için risk temelli bir çerçeve uygulanır. Türkiye’de hizmet veren işletmeler için de KVKK, açık rıza, veri minimizasyonu ve erişim kontrolü şartnamede yer almalıdır.

Şartnameye eklenmesi gereken güvenlik maddeleri:

  • Kişisel veriler modele gönderilmeden önce maskeleme yapılacak mı?
  • Kullanıcı konuşma geçmişi kaç gün saklanacak?
  • Admin panelde kim hangi konuşmayı görebilecek?
  • AI yanıtları loglanacak mı?
  • Hassas konular için insan onayı zorunlu olacak mı?
  • Veriler hangi sunucuda ve hangi bölgede tutulacak?
  • API anahtarları nasıl saklanacak?
  • Sistem üçüncü taraf model sağlayıcılarına hangi verileri iletecek?

Örneğin bir klinik, hukuk danışmanlığı, finansal analiz veya insan kaynakları projesinde AI’ın kesin karar verici değil, destekleyici araç olarak konumlandırılması gerekir. Teknik şartnamede “nihai karar insan kullanıcıya aittir” maddesi açıkça yazılmalıdır.

Başarı Kriterleri Ölçülebilir Olmalı

AI projelerinde “iyi çalışsın” kabul kriteri değildir. Şartname, test edilebilir metrikler içermelidir.

Örnek başarı kriterleri:

MetrikHedefÖlçüm Yöntemi
Doğru kategori sınıflandırmaEn az %85100 örnek talep üzerinde manuel kontrol
Canlı temsilciye gereksiz aktarımEn fazla %20Konuşma log analizi
Lead form tamamlama oranıTahmini %10-25 artışA/B test veya dönem karşılaştırması
Ortalama cevap süresi3 saniye altıAPI yanıt süresi ölçümü
Yanlış bilgi oranı%5 altındaRastgele kalite kontrol
Sistem erişilebilirliği%99 hedefSunucu ve servis izleme

Buradaki oranlar sektör, veri kalitesi ve senaryoya göre değişir. Bu yüzden şartnamede hedefler “tahmini” veya “pilot dönem hedefi” olarak ayrılabilir.

Atalay Tech tarafında pratik yaklaşım genellikle şöyledir: İlk MVP’de sistemin tüm işletmeyi otomatik yönetmesi beklenmez. Önce 2-3 kritik iş akışı seçilir, ölçüm yapılır, ardından model davranışı ve ekranlar iyileştirilir.

MVP, Orta Ölçek ve Kurumsal Kapsamı Ayırın

AI entegrasyonu teknik şartname dokümanında maliyet beklentisi doğrudan yazılacaksa kapsam seviyelerine göre ayrılmalıdır. Aksi halde basit bir chatbot ile çok sistemli kurumsal AI otomasyonu aynı başlık altında karışır.

Aşağıdaki tablo Türkiye’de özel yazılım ve AI entegrasyonu projeleri için 2026 koşullarında tahmini aralıkları gösterir. Projenin veri yapısı, entegrasyon sayısı, panel ihtiyacı ve güvenlik seviyesi maliyeti ciddi şekilde etkiler.

Kapsam SeviyesiTipik İçerikTahmini SüreTahmini Maliyet
MVP AI entegrasyonuWeb sitesi chatbot, temel SSS, tek kanal, basit panel3-6 hafta150.000 TL - 350.000 TL + KDV
Orta ölçek entegrasyonWhatsApp bot, CRM bağlantısı, lead sınıflandırma, rapor ekranı6-10 hafta350.000 TL - 900.000 TL + KDV
Kurumsal AI otomasyonuCRM/ERP/API bağlantıları, rol bazlı panel, loglama, test seti, bakım10-20 hafta900.000 TL - 2.500.000 TL+ + KDV
Çok sistemli özel mimariMobil uygulama, web platformu, AI ajan, özel veri işleme, yüksek güvenlik4-8 ay2.500.000 TL+ + KDV

Bu tablo satın alma odaklı kesin fiyat listesi olarak değil, şartname hazırlarken kapsamı ayrıştırmak için kullanılmalıdır. Net fiyatlandırma için veri yapısı, ekran sayısı, entegrasyon sayısı ve bakım beklentisi ayrıca incelenir.

Geliştirme Süreci Şartnamede Nasıl Yazılmalı?

Yapay zeka entegrasyonu için teknik şartname, proje sürecini de tarif etmelidir. Süreç yazılmadığında taraflar yalnızca “teslim tarihi” üzerine konuşur; oysa AI projelerinde ara testler ve geri bildirim döngüleri kritik rol oynar.

Önerilen süreç:

AşamaAmaçÇıktı
Keşifİş hedefi, veri kaynakları, kullanıcı rolleri belirlenirKapsam dokümanı
Teknik analizAPI, veri tabanı, güvenlik, model seçenekleri incelenirTeknik mimari taslak
UX ve akış tasarımıKullanıcı senaryoları ve admin ekranları hazırlanırAkış diyagramı ve ekran taslağı
MVP geliştirmeTemel AI akışı ve entegrasyonlar kurulurTest edilebilir ilk sürüm
Test ve validasyonSenaryo, güvenlik, doğruluk ve performans test edilirKabul test raporu
YayınCanlı ortam, izleme ve loglama aktif edilirProd ortam teslimi
Bakım ve iyileştirmeYanıt kalitesi, prompt, veri ve entegrasyonlar güncellenirAylık iyileştirme raporu

Bu akış özellikle yapay zeka ajanı projelerinde önemlidir. Çünkü ajan sistemleri tek seferlik kurulumdan sonra davranış verisiyle iyileştirilmelidir.

Kabul Kriterleri ve Test Senaryoları Yazılmalı

AI entegrasyonu tesliminde “çalışıyor” demek yeterli değildir. Kabul kriterleri, örnek senaryolar üzerinden test edilmelidir.

Örnek test senaryosu:

  • Kullanıcı “mobil uygulama yaptırmak istiyorum” yazar.
  • AI bot proje tipini “mobil uygulama” olarak sınıflandırır.
  • Kullanıcıdan platform, sektör, hedef kitle, bütçe aralığı ve iletişim bilgisi ister.
  • Eksik bilgi varsa tamamlatır.
  • Bilgileri CRM’e aktarır.
  • Satış ekibine özet bildirim gönderir.
  • Admin panelde konuşma geçmişi ve lead skoru görünür.

Kabul kriteri şöyle yazılabilir:

Test SenaryosuBeklenen SonuçKabul Durumu
Eksik bilgiyle lead oluşturmaBot eksik alanları tamamlatırZorunlu
Fiyat sorusuNet fiyat vermeden kapsam toplarZorunlu
KVKK onayı yokKişisel veri kaydı yapılmazZorunlu
CRM API hatasıKayıt kuyruğa alınır, hata loglanırZorunlu
Bilgi tabanında olmayan soruUydurma cevap yerine temsilciye yönlendirirZorunlu

Bu yaklaşım, AI sistemlerinin en riskli tarafı olan “kendinden emin ama yanlış cevap” problemini azaltır.

Teknik Şartnameye Eklenmesi Gereken Kontrol Listesi

Aşağıdaki kontrol listesi, yapay zeka entegrasyonu teknik şartname dokümanının omurgasını oluşturabilir:

  • Projenin iş hedefi ve başarı metriği
  • Kullanıcı personabları ve ana senaryolar
  • Kullanılacak kanallar: web, mobil, WhatsApp, CRM, ERP, e-posta
  • Veri kaynakları ve veri sahipleri
  • AI model sağlayıcısı ve yedek plan
  • Prompt yönetimi ve cevap sınırları
  • API entegrasyonları ve veri yönleri
  • Admin panel ihtiyaçları
  • Rol ve yetki matrisi
  • KVKK, veri saklama ve açık rıza gereksinimleri
  • Loglama, hata yönetimi ve izleme
  • Test senaryoları ve kabul kriterleri
  • MVP kapsamı ve sonraki fazlar
  • Bakım, eğitim ve iyileştirme planı

Bu listeyi doğrudan kopyalayıp proje brief’i olarak kullanmak mümkündür; ancak her işletmenin sektörü, veri yapısı ve operasyon akışı farklı olduğu için maddeler özelleştirilmelidir.

Sık Yapılan Hatalar

Yapay zeka entegrasyonu şartnamelerinde en sık görülen hata, AI’ın yazılım mimarisinden bağımsız düşünülmesidir. Oysa model yalnızca bir bileşendir; veriyi alacak, işleyecek, kaydedecek, gösterecek ve hatayı yönetecek sistem tasarımı olmadan proje sürdürülebilir olmaz.

Diğer yaygın hatalar:

  • Başarı kriteri yazılmadan projeye başlamak
  • Tüm müşteri iletişimini ilk fazda AI’a bırakmak
  • Veri temizliği için zaman ayırmamak
  • KVKK ve açık rıza süreçlerini sona bırakmak
  • Admin panel ihtiyacını ihmal etmek
  • API kesintisi veya model hatası için yedek senaryo yazmamak
  • İnsan onayı gereken durumları tanımlamamak
  • Bakım maliyetini ve sürekli iyileştirmeyi plana dahil etmemek

Özellikle satış, sağlık, finans, hukuk, insan kaynakları ve müşteri şikayet yönetimi gibi alanlarda AI’ın sınırları çok net yazılmalıdır. Aksi halde sistem kısa vadede demo olarak etkileyici görünür, fakat canlı operasyon içinde risk üretir.

Atalay Tech Perspektifiyle Doğru Şartname Nasıl Görünür?

Atalay Tech için iyi bir yapay zeka entegrasyonu şartnamesi; teknik ekibin geliştirme yapabileceği kadar detaylı, yönetimin karar verebileceği kadar anlaşılır ve operasyon ekibinin test edebileceği kadar somut olmalıdır.

Örneğin bir işletme web sitesine AI destekli teklif ön hazırlama sistemi kurmak istiyorsa, şartname şu akışı net anlatmalıdır:

  • Kullanıcı hangi sayfadan konuşmayı başlatır?
  • Hangi sorular sırasıyla sorulur?
  • Kullanıcı cevap vermezse sistem nasıl devam eder?
  • Hangi bilgiler zorunludur?
  • AI teklif kapsamını nasıl özetler?
  • Fiyat aralığı gösterilecek mi, yoksa satış ekibine mi aktarılacak?
  • Yönetim panelinde hangi alanlar görünecek?
  • CRM veya e-posta bildirimi nasıl çalışacak?
  • Satış ekibi konuşmayı nasıl devralacak?

Bu netlik yoksa proje “AI bot yapalım” seviyesinde kalır. Netlik varsa sistem; lead toplama, operasyon yükünü azaltma, müşteri deneyimini iyileştirme ve raporlama açısından gerçek değer üretir.

Sık Sorulan Sorular

Kapsama göre değişir; ancak ciddi bir AI entegrasyonu için 5-15 sayfalık bir doküman çoğu zaman yeterli başlangıç seviyesidir. Basit bir web sitesi chatbot projesinde 5-7 sayfa yeterli olabilirken, CRM, ERP, WhatsApp, yönetim paneli ve çoklu kullanıcı rolü içeren kurumsal projelerde 20 sayfaya yaklaşan bir şartname daha sağlıklı olur. Sayfa sayısından çok içeriğin ölçülebilir olması önemlidir. İş hedefi, veri kaynakları, entegrasyonlar, güvenlik, test senaryoları ve kabul kriterleri net değilse 30 sayfalık doküman bile zayıf kalır.

En sağlıklı yöntem, işletmenin iş hedeflerini ve mevcut süreçlerini hazırlaması, yazılım firmasının ise bunu teknik mimariye çevirmesidir. İşletme; hangi problemi çözmek istediğini, hangi departmanların kullanacağını, hangi verilerin mevcut olduğunu ve başarı beklentisini anlatmalıdır. Yazılım firması ise API yapısı, veri tabanı, AI model kullanımı, güvenlik, panel ekranları ve test kriterlerini teknik olarak detaylandırmalıdır. Atalay Tech gibi özel yazılım ve AI entegrasyonu yapan ekiplerde keşif süreci bu iki tarafı aynı dokümanda buluşturmak için kullanılır.

Tam olarak aynı değildir. AI chatbot genellikle kullanıcı sorularına cevap veren, bilgi toplayan veya yönlendirme yapan daha sınırlı bir sistemdir. AI ajan ise belirli araçlara bağlanabilir, CRM kaydı açabilir, özet çıkarabilir, takip görevi oluşturabilir veya insan onayına sunulacak aksiyonlar hazırlayabilir. Bu nedenle AI ajan şartnamesinde araç kullanımı, yetki sınırları, karar kuralları, loglama ve geri alma senaryoları daha detaylı yazılmalıdır. Chatbot şartnamesinde ise bilgi tabanı, cevap sınırları ve kanal deneyimi daha merkezi konumdadır.

Evet, ancak model adı tek başına proje bağımlılığı haline getirilmemelidir. Şartnamede model sağlayıcısı, kullanım amacı, veri gönderim sınırları, maliyet yaklaşımı ve alternatif model stratejisi yazılabilir. Örneğin özetleme, sınıflandırma ve doğal dilde cevap üretme için farklı model seçenekleri değerlendirilebilir. Daha doğru yaklaşım, “sistem şu davranışı üretmelidir” şeklinde performans ve güvenlik beklentisini tanımlamaktır. Böylece ileride model değişse bile proje hedefi ve kabul kriterleri sabit kalır.

Kişisel veri işleyen neredeyse her AI entegrasyonu için KVKK bölümü zorunlu kabul edilmelidir. Web formu, WhatsApp konuşması, CRM kaydı, randevu bilgisi, hasta talebi, finansal bilgi veya çalışan verisi işleniyorsa açık rıza, veri saklama süresi, erişim yetkisi ve maskeleme kuralları yazılmalıdır. AI sistemlerinde risk, kullanıcının doğal dilde hassas bilgi paylaşabilmesidir. Bu yüzden şartnamede hangi verilerin modele gönderileceği, hangi verilerin saklanacağı ve hangi durumlarda insan onayı gerekeceği net belirtilmelidir.

Hayır. MVP aşamasında en yüksek iş değerini üreten 1-3 ana senaryo seçilmelidir. Örneğin bir satış otomasyonu projesinde ilk faz yalnızca lead toplama, lead sınıflandırma ve CRM aktarımı olabilir. Teklif hazırlama, satış tahmini, otomatik takip mesajları ve gelişmiş raporlama sonraki fazlara bırakılabilir. Bu yaklaşım hem maliyeti kontrol eder hem de gerçek kullanıcı verisiyle sistemi iyileştirme fırsatı sağlar. AI projelerinde küçük ama ölçülebilir başlangıç, geniş ama kontrolsüz kapsamdan daha sağlıklıdır.

Evet, ancak maliyet aralığı kapsam seviyesine göre yazılmalıdır. “AI entegrasyonu 300.000 TL’dir” gibi tek satırlık ifade sağlıklı değildir. Bunun yerine MVP, orta ölçek ve kurumsal kapsam ayrımı yapılmalıdır. Entegrasyon sayısı, veri kaynağı sayısı, admin panel ihtiyacı, güvenlik seviyesi, model kullanım hacmi ve bakım beklentisi maliyeti değiştirir. Şartnamede maliyetin hangi varsayımlara dayandığı belirtilirse hem işletme hem yazılım ekibi daha gerçekçi planlama yapar.

Mümkündür, fakat alınan teklif genellikle geniş varsayımlara dayanır. Teknik şartname olmadan verilen fiyatlarda kapsam dışı işler, revizyonlar, ek entegrasyonlar ve veri temizliği sonradan maliyet oluşturabilir. Daha sağlıklı süreçte önce kısa bir keşif yapılır, ana senaryolar çıkarılır, veri kaynakları incelenir ve ardından teknik şartnameye bağlı teklif hazırlanır. Bu yöntem hem müşteri tarafında beklentiyi netleştirir hem de yazılım ekibinin gerçekçi süre ve maliyet vermesini sağlar.

İçindekiler

  • Teknik Şartname Nedir ve AI Projelerinde Neden Daha Kritik Hale Gelir?
  • Yapay Zeka Entegrasyonu Teknik Şartnamesi Hangi Projeler İçin Hazırlanır?
  • Şartnameye Başlamadan Önce İş Hedefini Netleştirin
  • Persona ve Kullanıcı Senaryosu Yazın
  • Kapsamı Modüllere Bölün
  • Veri Kaynaklarını ve Veri Kalitesini Tanımlayın
  • AI Modeli, Prompt ve Karar Mantığı Ayrı Yazılmalı
  • Entegrasyon Noktalarını Teknik Olarak Belirtin
  • Güvenlik, KVKK ve Regülasyon Maddelerini Atlamayın
  • Başarı Kriterleri Ölçülebilir Olmalı
  • MVP, Orta Ölçek ve Kurumsal Kapsamı Ayırın
  • Geliştirme Süreci Şartnamede Nasıl Yazılmalı?
  • Kabul Kriterleri ve Test Senaryoları Yazılmalı
  • Teknik Şartnameye Eklenmesi Gereken Kontrol Listesi
  • Sık Yapılan Hatalar
  • Atalay Tech Perspektifiyle Doğru Şartname Nasıl Görünür?
  • Sık Sorulan Sorular

Paylaş

İlgili hizmetimiz

Yapay Zeka Entegrasyonu

Yapay Zeka Entegrasyonu

Atalay Tech ile yapay zeka entegrasyonu: LLM chatbot, RAG, otomasyon ve özel ML modülleri. Web, mobil ve kurumsal sistemlere API ile AI ekleyin.

Detaylı Bilgi
Tüm hizmetleri görüntüleİletişim

Benzer yazılar

Rehber
Restoranlar İçin Yapay Zeka Entegrasyonu

Restoranlar İçin Yapay Zeka Entegrasyonu

Restoranlar için yapay zeka entegrasyonu; sipariş alma, WhatsApp iletişimi, stok tahmini, müşteri destek, kampanya yönetimi ve operasyon takibi gibi süreçleri daha ölçülebilir hale getirir. Bu rehber, restoran işletmeleri için gerçekçi kullanım senaryoları, maliyet aralıkları ve uygulama adımlarını açıklar.

Kaan Atalay
Kaan Atalay
· 25 Tem 2026 · 15 dk
Rehber
Emlak Firmaları İçin Yapay Zeka Entegrasyonu

Emlak Firmaları İçin Yapay Zeka Entegrasyonu

Emlak firmaları için yapay zeka entegrasyonu; ilan yönetimi, müşteri adayı toplama, portföy eşleştirme, WhatsApp otomasyonu, CRM takibi ve mobil uygulama deneyimini daha ölçülebilir hale getirir. Bu rehber, emlak sektöründe AI kullanımını teknik ve ticari açıdan açıklar.

Kaan Atalay
Kaan Atalay
· 24 Tem 2026 · 17 dk
Rehber
Oteller İçin Yapay Zeka Entegrasyonu

Oteller İçin Yapay Zeka Entegrasyonu

Oteller için yapay zeka entegrasyonu; rezervasyon taleplerinden WhatsApp iletişimine, oda doluluk tahmininden housekeeping planlamasına kadar birçok operasyonel süreci daha ölçülebilir hale getirir. Bu rehber, otel işletmeleri için AI kullanım alanlarını, maliyet aralıklarını, entegrasyon sürecini ve dikkat edilmesi ge

Kaan Atalay
Kaan Atalay
· 23 Tem 2026 · 18 dk