ZIP ile Toplu İçe Aktarma
Bilgi tabanlarını tek tek oluşturmak yerine, bir ZIP arşivi yükleyerek aynı anda birden fazla bilgi tabanını içe aktarabilirsiniz. Bu, özellikle bir ajan için hazırlanmış birçok bilgi tabanınız olduğunda kullanışlıdır.
Hızlı Başlangıç
- Kenar çubuğunda Bilgi Tabanı'na gidin
- **"ZIP İçe Aktar"**a tıklayın
- ZIP arşivinizi yükleme alanına bırakın
- Ayrıştırılan sonuçları gözden geçirin ve düzenleyin
- **"İçe Aktar"**a tıklayın
ZIP Arşivi Yapısı
Basit Yapı (Tek Ajan)
Tüm KB dosyalarını ve bir TRIGGERS.md dosyasını arşivin kök dizinine yerleştirin:
hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
İç İçe Yapı (Birden Fazla Ajan)
Bilgi tabanlarını klasörler halinde düzenleyebilirsiniz. Her klasör kendi TRIGGERS.md dosyasıyla bağımsız olarak işlenir:
hanc-all-agents.zip
├── Sales-Agent/
│ ├── KB01_platform_overview.md
│ ├── KB02_pricing_plans.md
│ ├── KB03_roi_calculator.md
│ ├── KB04_competitors.md
│ └── TRIGGERS.md
├── Tech-Support-Agent/
│ ├── KB01_widget_setup.md
│ ├── KB02_api_reference.md
│ ├── KB03_troubleshooting.md
│ └── TRIGGERS.md
└── Onboarding-Agent/
├── KB01_getting_started.md
├── KB02_first_agent.md
├── KB03_knowledge_base.md
├── KB04_phone_numbers.md
├── KB05_billing.md
└── TRIGGERS.md
Dosya Adlandırma Kuralları
KB Dosyaları
KB dosyaları, bir sayıdan sonra KB ile başlamak zorundadır:
| Geçerli | Geçersiz |
|---|---|
KB01_platform_overview.md | platform_overview.md |
KB02_pricing.md | 02_pricing.md |
KB1_faq.md | knowledge_base_1.md |
KB10_integrations.md | FAQ.md |
Sayıdan sonraki metin isteğe bağlıdır ve yalnızca sizin referansınız içindir. Sistem, KB dosyalarını TRIGGERS.md dosyasındaki komut dosyalarıyla eşleştirmek için sayıyı kullanır.
TRIGGERS.md
Dosya tam olarak TRIGGERS.md (büyük/küçük harfe duyarsız) olarak adlandırılmak zorundadır. Her bilgi tabanı için komut dosyalarını (açıklamaları) içerir.
KB Dosya Formatı
Her KB dosyası, bir H1 başlığı (# Başlık) ile başlayan bir Markdown dosyası (.md) olmalıdır. Bu başlık sistemde bilgi tabanının adı olur.
Örnek: KB01_platform_overview.md
# HANC.AI Platform Overview [sales]
## What is HANC.AI?
HANC.AI is an AI voice agent platform that allows businesses to create
intelligent voice assistants. These agents handle phone calls,
answer customer questions using knowledge bases, and integrate
with existing business tools.
## Key Features
- Unlimited AI voice agents on all plans
- Knowledge base with RAG technology
- SIP integration for phone systems
- Google Calendar integration
- Web widget for website calls
- Real-time analytics dashboard
Neler Çıkarılır
| Bölüm | Nasıl Kullanılır |
|---|---|
H1 başlığı (# Başlık) | Bilgi tabanı adı (maks. 100 karakter) |
| Tam dosya içeriği | Bilgi tabanı dosyası (.md olarak yüklenir) |
Bir KB dosyasında H1 başlığı yoksa, ad olarak dosya adı kullanılır. Bir uyarı görürsünüz ve içe aktarmadan önce düzenleyebilirsiniz.
TRIGGERS.md Formatı
TRIGGERS.md, her bilgi tabanı için komut dosyasını tanımlar. Komut dosyası, AI ajanına bu bilgi tabanını ne zaman ve nasıl kullanacağını söyler.
Yapı
Her bölüm, sayıdan (KB dosya numarasıyla eşleşen) önce ## KB ile başlar. Alttaki metin komut dosyası olur.
## KB01
HANC.AI platform overview: what the product does, key features, and
benefits. Use when the customer asks what HANC.AI is, how it works,
or what problems it solves.
## KB02
Pricing plans and billing: Free, Starter, Pro, Business, Enterprise tiers
with credit amounts and per-minute rates. Use when the customer asks about
costs, plans, or how billing works.
## KB03
Agent setup guide: step-by-step instructions for creating and
configuring a voice agent. Use when the customer asks how to create
an agent, configure settings, or write a prompt.
Komut Dosyası Yönergeleri
| Kural | Detaylar |
|---|---|
| Maks. uzunluk | Komut dosyası başına 300 karakter |
| Bölüm formatı | ## KB01, ## KB02 vb. |
| İçerik | KB'nin ne içerdiğini ve ne zaman kullanılacağını açıklayın |
| Dil | Ajanınızla aynı dilde yazın |
- Spesifik olun: "genel bilgi" yerine "platform özellikleri, desteklenen entegrasyonlar ve teknik gereksinimler" yazın
- Tetikleyici kelimeler ekleyin: Bu KB'yi etkinleştirmesi gereken anahtar konuları belirtin
- Amacı tanımlayın: Yalnızca KB'de ne olduğunu değil, ajanın ne zaman kullanması gerektiğini de açıklayın
Farklı Numaralandırma ile Örnek
Her iki format da desteklenir:
## KB01
Prompt for knowledge base 1...
## KB-02
Prompt for knowledge base 2...
KB ile sayı arasındaki tire isteğe bağlıdır. Hem KB01 hem de KB-01 aynı bilgi tabanına başvurur.
İçe Aktarma Süreci
Adım 1: ZIP Yükleme
ZIP dosyanızı yükleme alanına sürükleyip bırakın veya göz atmak için tıklayın. Maksimum dosya boyutu 50 MB'dir.
Adım 2: İnceleme
Yüklendikten sonra, ayrıştırılan tüm bilgi tabanlarını içeren bir tablo göreceksiniz:
| Sütun | Açıklama |
|---|---|
| Ad | H1 başlığından çıkarıldı (düzenlenebilir) |
| Komut Dosyası | TRIGGERS.md'den çıkarıldı (düzenlenebilir, maks. 300 karakter) |
| Dosya | Orijinal dosya adı |
Şunları yapabilirsiniz:
- İçe aktarmadan önce herhangi bir adı veya komut dosyasını düzenleyin
- İçe aktarmak istemediğiniz bilgi tabanlarını kaldırın
- Farklı bir ZIP yüklemek için geri dönün
Adım 3: Uyarıları Düzeltme
Sistem sorunları algılarsa, sarı uyarılar göreceksiniz:
| Uyarı | Anlamı | Eylem |
|---|---|---|
| TRIGGERS.md bulunamadı | Klasörde TRIGGERS.md yok | Komut dosyalarını manuel olarak doldurun |
| H1 başlığı yok | KB dosyası # Başlık ile başlamıyor | Tablodaki adı düzenleyin |
| TRIGGERS.md'de eşleşen bölüm yok | TRIGGERS.md'de bu dosya için ## KBxx yok | Komut dosyasını manuel olarak doldurun |
| Dosya boş | KB dosyasında içerik yok | Dosya otomatik olarak atlanır |
Tüm adlar ve komut dosyaları doldurulana kadar İçe Aktar düğmesi devre dışı bırakılır. Boş alanlar kırmızı ile vurgulanır.
Adım 4: İçe Aktarma
Yüklemeyi başlatmak için **"İçe Aktar"**a tıklayın. Bir ilerleme çubuğu yükleme durumunu gösterir. Bilgi tabanları tek tek oluşturulur.
Tamamlandıktan sonra:
- Hepsi başarılı: Modal kapanır, başarı bildirimi görünür
- Bazıları başarısız: Hata bildirimi kaçının başarılı olduğunu toplama karşı gösterir
Tam Örnek
İşte HANC.AI sesli satış ajanı için bir bilgi tabanı setinin tam örneği — platformu potansiyel müşterilere sunan.
Klasör Yapısı
HANC-Sales-Agent/
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_features.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
KB01_platform_overview.md
# HANC.AI Platform Overview [sales]
## What is HANC.AI?
HANC.AI is a cloud-based AI voice agent platform. Businesses create
intelligent voice assistants that handle phone calls autonomously —
answering questions, booking appointments, qualifying leads, and
providing support 24/7.
## How It Works
1. Create a voice agent in the HANC.AI dashboard
2. Write a prompt describing the agent's role and behavior
3. Upload knowledge bases with business-specific information
4. Connect a phone number or embed a web widget
5. The agent handles calls using AI with RAG technology
## Key Benefits
- **Available 24/7** — never miss a call again
- **Cost reduction 60-80%** compared to traditional call centers
- **Unlimited agents** on all plans including Free
- **Setup in minutes** — no coding required
- **Multilingual** — agents speak any language
KB02_pricing_plans.md
# Pricing Plans [sales]
## Plan Overview
| Plan | Monthly Credits | Web Call Rate | Best For |
|------|----------------|---------------|----------|
| Free | €10 (one-time) | €0.13/min | Testing the platform |
| Starter | €30 | €0.13/min | Small businesses |
| Pro | €100 | €0.11/min | Growing companies |
| Business | €250 | €0.10/min | Established businesses |
| Enterprise | Custom | Custom | Large organizations |
## What's Included on All Plans
- Unlimited AI voice agents
- Knowledge base with RAG
- SIP integration
- Calendar integration
- Web call widget
- Analytics dashboard
## Credits
Credits roll over to the next month. 100% of your subscription
converts to credit. No hidden fees, no per-agent charges.
TRIGGERS.md
## KB01
HANC.AI platform overview: what the product is, how it works, key
benefits like 24/7 availability, 60-80% cost reduction, unlimited
agents. Use when customer asks what HANC.AI is or why they should use it.
## KB02
Pricing plans: Free, Starter, Pro, Business, Enterprise with credit amounts
and per-minute rates. All plans include unlimited agents, SIP, calendar.
Use when customer asks about pricing, costs, or plan comparison.
## KB03
Detailed agent features: voice settings, prompt configuration,
knowledge base setup, call forwarding, greeting messages, and tools.
Use when customer asks what agents can do or how to configure them.
## KB04
Integrations: SIP trunking, Google Calendar, web widget,
API keys, webhooks (call-start, call-end events). Use when customer
asks about connecting HANC.AI with their existing systems.
## KB05
Frequently asked questions: setup time, supported languages, data
security, trial period, cancellation policy, technical requirements
(WebGL 2.0, Web Audio API, WebRTC). Use for common questions.
İçe Aktarmadan Sonraki Sonuç
| Ad | Komut Dosyası | Dosya |
|---|---|---|
| HANC.AI Platform Overview [sales] | HANC.AI platform overview: what the product is... | KB01_platform_overview.md |
| Pricing Plans [sales] | Pricing plans: Free, Starter, Pro, Business... | KB02_pricing_plans.md |
| Agent Features [sales] | Detailed agent features: voice settings... | KB03_agent_features.md |
| Integrations [sales] | Integrations: SIP trunking, calendar... | KB04_integrations.md |
| FAQ [sales] | Frequently asked questions: setup time... | KB05_faq.md |
İpuçları
- H1'de ajan tanımlayıcısı: Listede görüntülediğinizde bir KB'nin hangi ajana ait olduğunu kolayca tanımlamak için H1 başlıklarına
[sales]veya[support]gibi bir etiket ekleyin - Numaralandırma tutarlılığı: Dosya adlarında ve TRIGGERS.md'de aynı numaralandırmayı kullanın (dosya adında
KB01= TRIGGERS.md'de## KB01) - İçe aktarmadan önce test edin: Birden fazla uyarıyı düzeltmek zorunda kalmamak için yüklemeden önce arşiv içeriğinizi kontrol edin
- Klasör başına bir ajan: İç içe yapı kullanırken, netlik için ajana göre düzenleyin
İlgili Konular
- Bilgi Tabanı — Bilgi tabanları oluşturma ve yönetme
- AI Sesli Ajanlar — KB'yi ajanlara bağlama
- Komut Dosyası Mühendisliği — Etkili komut dosyaları yazma