Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aiagenttr.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
JIRA Bilgi Bankası - Hızlı Başlangıç Kılavuzu

​
Özet

Bu bilgi bankası sistemi, AI Çağrı Merkezi Platformu dokümantasyonunu otomatik olarak JIRA Service Management’a yükler ve senkronize eder.

​
✨ Özellikler

  • ✅ Markdown dosyalarını JIRA Wiki formatına otomatik dönüştürme
  • ✅ Git commit bazlı değişiklik takibi
  • ✅ Sadece değişen dosyaların güncellenmesi (incremental sync)
  • ✅ 8 kategori altında organize edilmiş Türkçe kullanıcı kılavuzları
  • ✅ Admin-only içerikler bilgi bankasından çıkarılmış

​
🚀 Hızlı Başlangıç

​
1. JIRA API Token Alın

  1. https://id.atlassian.com/manage-profile/security/api-tokens adresine gidin
  2. Create API token butonuna tıklayın
  3. Token’a bir isim verin (örn: “KB Publisher”)
  4. Token’ı kopyalayın

​
2. Yapılandırma

cd knowledge_base/scripts
cp .env.example .env
.env dosyasını düzenleyin: 
JIRA_URL=https://your-company.atlassian.net
JIRA_EMAIL=your.email@company.com
JIRA_API_TOKEN=ATATT3xFf... # Kopyaladığınız token
JIRA_PROJECT_KEY=SUPPORT  # Projenizin kodu
JIRA_SERVICE_DESK_ID=1    # Service desk numaranız

​
3. Bağımlılıkları Yükleyin

bun install

​
4. İlk Yükleme

Tüm dokümantasyonu JIRA’ya yükleyin: 
bun run publish

​
🔄 Güncellemeleri Senkronize Etme

Kod değiştikçe dokümantasyonu güncellemek için:

​
Adım 1: Ne Değişti Kontrol Edin

bun run check
Bu komut:
  • Son senkronizasyondan sonraki git commit’leri analiz eder
  • Hangi dosyaların değiştiğini gösterir
  • JIRA’ya yüklemeden önce önizleme sağlar

​
Adım 2: Değişiklikleri Senkronize Edin

bun run sync
Bu komut:
  • Sadece değişen dosyaları JIRA’ya yükler
  • Mevcut makaleleri günceller veya yeni makaleler oluşturur
  • Mevcut commit ID’yi kaydeder

​
📁 Bilgi Bankası Yapısı

knowledge_base/
├── baslangic/                  # Başlangıç rehberi
│   ├── 01-platforma-giris.md
│   └── 02-api-anahtari-kurulumu.md
├── sesli-yapay-zeka-ajanlar/   # AI Agent'lar
│   └── 01-agent-olusturma.md
├── musteri-yonetimi/           # CRM
│   └── 01-musteri-ekleme.md
├── kampanyalar/                # Kampanya yönetimi
│   └── 01-kampanya-olusturma.md
├── cagri-izleme/               # Görüşmeler
├── telefon-numaralari/         # Santral
├── analizler/                  # Raporlar
├── sorun-giderme/              # Troubleshooting
└── scripts/                    # Otomasyon scriptleri
    ├── publish-to-jira.ts
    ├── sync-changes.ts
    └── check-changes.ts

​
🛠️ Nasıl Çalışır?

​
Git Commit Takibi

  1. İlk yükleme yapıldığında mevcut git commit ID kaydedilir: .last-sync-commit
  2. Kod değiştiğinde ve commit yapıldığında:
    • bun run sync komutu çalıştırılır
    • Son commit’ten itibaren değişen .md dosyaları tespit edilir
    • Sadece değişen dosyalar JIRA’ya yüklenir
    • Yeni commit ID kaydedilir

​
Markdown → JIRA Dönüşümü

Script otomatik olarak markdown’ı JIRA Wiki formatına dönüştürür:
MarkdownJIRA Wiki
# Başlıkh1. Başlık
**kalın***kalın*
*italik*_italik_
`kod`{{kod}}
- Liste* Liste
[Link](url)[Link|url]

​
📝 Yeni Dokümantasyon Ekleme

  1. İlgili kategoride yeni .md dosyası oluşturun
  2. Markdown formatında içeriği yazın
  3. Commit yapın
  4. bun run sync çalıştırın
Örnek: 
# Yeni dosya oluştur
nano knowledge_base/baslangic/03-yeni-makale.md

# Commit yap
git add knowledge_base/baslangic/03-yeni-makale.md
git commit -m "Yeni makale: Başlangıç rehberi"

# JIRA'ya senkronize et
cd knowledge_base/scripts
bun run sync

​
🔧 Sorun Giderme

​
”Authentication failed”

  • .env dosyasında JIRA_EMAIL ve JIRA_API_TOKEN kontrolü yapın
  • API token’ın geçerli olduğundan emin olun

​
”No changes detected”

  • git status ile değişikliklerinizi commit ettiğinizden emin olun
  • .last-sync-commit dosyasını silin (tam yükleme yapar)

​
“Could not read commit”

  • Git repository içinde olduğunuzdan emin olun
  • .git klasörünün var olduğunu kontrol edin

​
💡 İpuçları

​
CI/CD Entegrasyonu

GitHub Actions ile otomatik senkronizasyon: 
# .github/workflows/sync-kb.yml
name: Sync Knowledge Base
on:
  push:
    paths:
      - 'knowledge_base/**/*.md'
    branches:
      - main
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          fetch-depth: 0  # Tüm git history
      - uses: oven-sh/setup-bun@v1
      - run: cd knowledge_base/scripts && bun install
      - run: cd knowledge_base/scripts && bun run sync
        env:
          JIRA_URL: ${{ secrets.JIRA_URL }}
          JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
          JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
          JIRA_PROJECT_KEY: ${{ secrets.JIRA_PROJECT_KEY }}
          JIRA_SERVICE_DESK_ID: ${{ secrets.JIRA_SERVICE_DESK_ID }}

​
Sadece Belirli Kategoriyi Yükleme

publish-to-jira.ts dosyasını düzenleyin: 
const CATEGORIES = {
  'baslangic': 'Başlangıç',
  // Diğer kategorileri yorum satırına alın
};

​
📚 Detaylı Dokümantasyon

Daha fazla bilgi için:

​
✅ Kontrol Listesi

Başlamadan önce:
  • JIRA Service Management erişiminiz var
  • JIRA API token aldınız
  • .env dosyasını yapılandırdınız
  • bun install çalıştırdınız
  • JIRA Service Desk ID ve Project Key bilgileriniz doğru
İlk yükleme sonrası:
  • bun run publish başarıyla tamamlandı
  • JIRA’da makaleler görünüyor
  • .last-sync-commit dosyası oluşturuldu
Her güncelleme için:
  • Değişiklikleri commit yaptınız
  • bun run check ile önizleme yaptınız
  • bun run sync ile senkronize ettiniz
  • JIRA’da güncellemeleri kontrol ettiniz

​
🎉 Tamamlandı!

Artık bilgi bankanız JIRA Service Management’ta ve otomatik güncelleme sistemi hazır! Sorularınız için: GitHub Issues