Asistana Bağla/Ayır
Bilgi bankasını bir asistana bağlayın veya mevcut bağlantıyı kaldırın
Bilgi Bankası Bağla
POST
/assistants/:assistantId/knowledge-bases/:knowledgeBaseIdBelirtilen bilgi bankasını asistana bağlar. Asistan aramalar sırasında bu bilgi bankasını kullanabilir.
Yol Parametreleri
assistantId(zorunlu)Asistan benzersiz kimliği
knowledgeBaseId(zorunlu)Bağlanacak bilgi bankası benzersiz kimliği
Bağla - İstek Örneği
cURL
curl -X POST https://api.wespoke.ai/api/v1/assistants/ast_123/knowledge-bases/kb_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"Bağla - Yanıt Örneği
200 OK
{
"message": "Bilgi bankası asistana başarıyla bağlandı",
"assistant": {
"id": "ast_123",
"name": "Müşteri Destek Asistanı",
"knowledgeBases": [
{
"id": "kb_abc123",
"name": "Ürün Bilgi Bankası",
"documentCount": 25,
"attachedAt": "2024-01-22T17:30:00Z"
}
]
}
}Bilgi Bankası Ayır
DELETE
/assistants/:assistantId/knowledge-bases/:knowledgeBaseIdBelirtilen bilgi bankasını asistandan ayırır. Asistan artık bu bilgi bankasını kullanamaz.
Ayır - İstek Örneği
cURL
curl -X DELETE https://api.wespoke.ai/api/v1/assistants/ast_123/knowledge-bases/kb_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"Ayır - Yanıt Örneği
200 OK
{
"message": "Bilgi bankası asistandan başarıyla ayrıldı",
"assistant": {
"id": "ast_123",
"name": "Müşteri Destek Asistanı",
"knowledgeBases": []
}
}Bağlı Bilgi Bankalarını Listele
GET
/assistants/:assistantId/knowledge-basesAsistana bağlı tüm bilgi bankalarını listeler.
cURL
curl -X GET https://api.wespoke.ai/api/v1/assistants/ast_123/knowledge-bases \
-H "Authorization: Bearer YOUR_API_KEY"Liste - Yanıt Örneği
200 OK
{
"knowledgeBases": [
{
"id": "kb_abc123",
"name": "Ürün Bilgi Bankası",
"description": "Ürünlerimiz hakkında genel bilgiler",
"documentCount": 25,
"attachedAt": "2024-01-22T17:30:00Z"
},
{
"id": "kb_def456",
"name": "Teknik Destek",
"description": "Teknik sorunlar ve çözümleri",
"documentCount": 18,
"attachedAt": "2024-01-20T14:15:00Z"
}
]
}Kullanım Senaryoları
Çoklu Bilgi Kaynağı
Bir asistana birden fazla bilgi bankası bağlayarak farklı konularda uzmanlaşmasını sağlayın.
Dinamik Güncelleme
Sezonluk kampanyalar veya güncellemeler için bilgi bankalarını geçici olarak bağlayıp ayırın.
A/B Testi
Farklı bilgi kaynakları kullanarak asistan performansını test edin.
Hata Yanıtları
404 Not Found - Asistan veya bilgi bankası bulunamadı
{
"error": "Not found",
"message": "Asistan veya bilgi bankası bulunamadı"
}409 Conflict - Zaten bağlı
{
"error": "Conflict",
"message": "Bu bilgi bankası zaten asistana bağlı"
}