Bilgi tabanınızı, yapay zeka ile daha hızlı ve daha doğru bilgi erişimi için hazırlayın.

AI temsilciniz, bulabildiği bilgiler kadar iyidir. Bir AI temsilcisi kurarken karşılaşılan en büyük zorluklardan biri, temsilcinin kullanacağı bilgi kaynaklarını hazırlamaktır. PDF’ler, Word belgeleri, elektronik tablolar ve sunumlar gibi geleneksel formatlar, insanlar tarafından okunmak üzere tasarlanmıştır. Bunların AI tarafından işlenmesi her zaman kolay olmayabilir. Bu durum bazı sorunlara yol açabilir:

  • Başlıklar, ait oldukları metinden ayrılabilir.
  • Tabloların yapısı bozulabilir.
  • Önemli bağlam bilgileri gözden kaçabilir.
  • AI temsilci, bir belgenin yanlış bölümünü alabilir.

Bunu önlemek için, AI temsilcinizin bilgi kaynakları olarak Markdown (.md) dosyalarını kullanın.

Markdown, belgeleri düzenli, yapılandırılmış ve okunması kolay hale getirir. İnsanlar için oldukça kullanışlıdır ve AI temsilcisinin arama yapıp sonuçları alabileceği daha net içerikler sunar.

Markdown Neden Daha İyi Çalışır

Markdown, gereksiz biçimlendirmeleri kaldırır ve belgenin yapısını net tutar. Başlıklar, listeler, tablolar ve bölümler için basit metin işaretleyicileri kullanır. Bu, AI temsilcisinin bilgilerin nasıl düzenlendiğini anlamasına yardımcı olur.

  • Net başlıklar: #, ## ve ### gibi Markdown başlıkları net bir yapı oluşturur. Bu, konuların ve alt konuların bir arada tutulmasına yardımcı olur.
  • Okunabilir tablolar: Markdown tabloları, satırları ve sütunları hizalı tutarak ürün özellikleri, kurulum gereksinimleri ve karşılaştırma tablolarının işlenmesini kolaylaştırır.
  • Daha temiz içerik: Markdown, geleneksel ofis dosyalarında bulunan gizli biçimlendirmeleri ve fazladan düzen verilerini ortadan kaldırır.
  • Daha hızlı erişim: Daha temiz dosyalar, işlenen metin miktarını azaltmaya yardımcı olur ve erişimi daha verimli hale getirir.
  • Daha az yanlış cevap: Daha iyi yapılandırılmış bilgi kaynakları, AI temsilcisinin doğru bilgileri daha güvenilir bir şekilde bulmasına yardımcı olur.

Mevcut Belgeleri Markdown’a Dönüştürün

Her dosyayı elle yeniden yazmanıza gerek yok. MarkItDown ve Docling gibi açık kaynaklı araçlar, mevcut dosyaları yapılandırılmış Markdown biçimine dönüştürmenize yardımcı olabilir. Bu araçlar, aşağıdakiler gibi yaygın biçimleri işleyebilir:

  • .docx
  • .pptx
  • .xlsx
  • PDFs

Ayrıca okuma sırasını korumaya, tabloları Markdown biçimine dönüştürmeye ve daha karmaşık belge düzenlerinden içerik çıkarmaya da yardımcı olabilirler.

AI Temsilciniz için Markdown Belgeleri Hazırlama Örneği

Terminalinizi açın, temiz bir Python ortamı kurun ve gerekli aracı yükleyin.

# Sanal bir ortam oluşturun ve etkinleştirin
python3 -m venv .venv
source .venv/bin/activate# MarkItDown’u tüm biçim desteğiyle yükleyin
pip install ‘markitdown[all]’

Yükleme tamamlandıktan sonra, bir dosyayı doğrudan komut satırından dönüştürebilir veya komut satırını kullanarak dosyayı otomatik veri iş akışınıza ekleyebilirsiniz:

markitdown internal_kb_report.pdf > internal_kb_report.md

…ya da Python kodu kullanarak:

from markitdown import MarkItDown# Initialize the converter
md_converter = MarkItDown()# Karmaşık bir düzen dosyasını yapılandırılmış Markdown’a dönüştürün
result = md_converter.convert(“product_specs.docx”)

# Temiz, makine tarafından okunabilir metne bir göz atın
print(result.text_content)

Markdown Biçimlendirme Kuralları

AI Temsilci bilgi kaynakları için Markdown dosyaları oluştururken veya düzenlerken şu kurallara uyun:

  • Başlık seviyelerini atlamayın: Başlıkları sırayla düzenleyin. # seviyesinden doğrudan ### seviyesine atlamayın.
  • Tabloların etrafında boşluk bırakın: Her Markdown tablosunun önüne ve arkasına birer boş satır ekleyin.
  • En üste bağlam bilgisi ekleyin: Gerekli olduğu durumlarda kısa bir meta veri bloğu kullanın; böylece AI Temsilci dosyanın ne hakkında olduğunu anlayabilir.

Örnek:

—
category: Technical Documentation
product: 3CX PBX V20
audience: System Administrators
last_updated: 2026-06-01
—# Setting up AI Agent Knowledgebases
…

Daha temiz bilgi kaynakları, AI temsilcisinin daha iyi yanıtlar vermesine yardımcı olur. Mevcut dosyalarınızı gözden geçirin, önemli belgeleri Markdown formatına dönüştürün ve bunları bir AI temsilcisine atamadan önce başlıkların, tabloların ve meta verilerin net olup olmadığını kontrol edin.

Tartışmaya Katılın

Özel İş Ortağı veya Müşteri Forumlarımızda 3CX tartışmalarına katılın. En son haberler ve yeni özellikler hakkında güncel bilgileri almak için bizi LinkedIn’de takip edin.