Bilgi Bankası Python Demosunu Kullanmaya Başlayın

Yaygın Bilgi Bankası API iş akışlarının çalışan bir Python uygulamasını çalıştırın, inceleyin ve uyarlayın.

Python Demo, uygulama geliştirme için işlevsel bir başlangıç noktası sağlar. Koleksiyon oluşturma, belge işleme ve yapay zeka çıkarımının birlikte çalıştığını görmek için eksiksiz iş akışını kullanın, ardından belirli koleksiyon ve çıkarım işlemleri için ayrı komut dosyalarını keşfedin.

Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

• Bilgi Bankası API'sine erişim.
• Uygulamanızın kimlik doğrulaması için gerekli kimlik bilgileri.
• Python 3.7 veya üzeri. Python 3.11 veya üzeri önerilir.
• Eksiksiz demo iş akışında kullanabileceğiniz bir PDF.

API erişimini yapılandırmadıysanız, bkz. Bilgi Bankası API erişimi kurulumu.

Python Demo'yu indirme ve kurma

Demo requests, pyyaml ve tqdm kullanır. Kimlik bilgileri config.yaml dosyasında saklanır ve kimlik doğrulama belirteçleri otomatik olarak yönetilir.

config.yaml veya oluşturulan .token dosyalarını kaynak kontrolüne işlemeyin.

Tam iş akışını çalıştırma

Çalıştırın:

python knowledgebase.py

Belirli bir PDF kullanmak için:

python knowledgebase.py --document=<path-to-pdf>

Demo:

1. API ile kimlik doğrulaması gerçekleştirir.
2. demo-collection adlı bir koleksiyon oluşturur.
3. Bir PDF yükler.
4. Dizin oluşturma tamamlanana kadar belgeyi izler.
5. İşlenmiş belge üzerinde bir çıkarım isteği çalıştırır.

Yükleme ve dizin oluşturma, belge alım sürecinin ayrı bölümleridir. Dizin oluşturma belge içeriğini çıkarır ve yapay zeka işlemlerinde kullanılabilir hale getirir.

PDF belirtilmezse Demo paketteki documents dizininden bir PDF seçer. Belge işleme, tamamlandı durumuna ulaşmazsa beş dakika sonra zaman aşımına uğrar.

Koleksiyon işlemlerini keşfetme

Tam iş akışını çalıştırdıktan sonra, belirli API işlemlerini keşfetmek için ayrı komut dosyaları kullanın.

Koleksiyon oluşturma

python collection.py --action create --name <collection-name>

Koleksiyon adları en fazla 255 karakter içerebilir.

Koleksiyonları listeleme

python collection.py --action list

İstendiğinde sizin tarafınızdan oluşturulan, sizin tarafınızdan paylaşılan veya başkaları tarafından paylaşılan koleksiyonları listeleyip listelemeyeceğinizi seçin.

Koleksiyonu paylaşma

python collection.py --action share --collection-id <collection-id>

İstendiğinde okuma veya yazma erişimi alması gereken e-posta adreslerini girin.

Belge yükleme

python collection.py --action upload --collection-id <collection-id> --path=<path-to-file-or-directory>

Komut dosyası belirtilen dizindeki tek bir dosyayı veya belgeleri yükleyebilir.

Koleksiyondaki belgeleri listeleme

python collection.py --action get_documents --collection-id <collection-id>

Belge işleme durumunu kontrol etme

python collection.py --action get_status --document-id <document-id>

Demo, bağımsız örnekler olarak bu işlemleri sunar; bunları inceleyip tam iş akışından bağımsız olarak uyarlayabilirsiniz. 

Çıkarım işlemlerini keşfetme

Çıkarım örnekleri için koleksiyon kimliği ve belge kimliği gereklidir. Bunları belirlemek için koleksiyon komut dosyalarını kullanın:

python collection.py --action list
python collection.py --action get_documents --collection-id <collection-id>

Soruların yanıtlanması

Koleksiyonlarınızı ve belgelerinizi listeleyin, ardından soru cevap örneğini çalıştırın:

python collection.py --action list
python collection.py --action get_documents --collection-id <collection-id>
python inference.py --questionAnswer

İstendiğinde koleksiyon kimliği, belge kimliği ve soruyu girin.

Belge özetleme

Koleksiyonu ve belgeyi belirleyin, ardından özetleme örneğini çalıştırın:

python collection.py --action list
python collection.py --action get_documents --collection-id <collection-id>
python inference.py --summarize

İstendiğinde koleksiyon kimliği ve belge kimliğini girin.

Bağlam arama

Koleksiyon ve belgeyi belirleyin, ardından bağlam arama örneğini çalıştırın:

python collection.py --action list
python collection.py --action get_documents --collection-id <collection-id>
python inference.py --context-search

İstendiğinde koleksiyon kimliği, belge kimliği ve arama metnini girin.

Özellik çıkarma

Koleksiyonu ve belgeyi belirleyin, ardından çıkarma örneğini çalıştırın:

python collection.py --action list
python collection.py --action get_documents --collection-id <collection-id>
python inference.py --extract

İstendiğinde koleksiyon kimliğini, belge kimliğini, özellik adını, çıkarım istemini, veri türünü ve isteğe bağlı açıklamayı girin. 

API ile geliştirmeye devam etme

Python Demosu, tam API belgelerinden ziyade çalışan uygulama kalıpları sağlar.

Bilgi Bankası API ile Başlayın kısmını kullanarak API kaynak modelini, belge yaşam döngüsünü, çıkarım davranışını ve yanıt işlemeyi anlayın.

Bilgi Bankası API başvurusu'nu güncel uç nokta yollarına, parametrelere, istek ve yanıt şemalarına ve durum bilgilerine ihtiyacınız olduğunda kullanın.

Sorun Giderme

Demo ayrıntılı tanı bilgilerini şuraya yazar:

logs/knowledgebase-demo.log

Günlük dosyası HATA AYIKLAMA düzeyinde bilgileri kaydeder, konsol ise UYARI düzeyinde mesajları ve üstünü görüntüler.

Bir işlem başarısız olursa:

• İstek ve kimlik doğrulama ayrıntıları için logs/knowledgebase-demo.log'u gözden geçirin.
• config.yaml içindeki ayarları doğrulayın.
• Kullanılan PDF'nin mevcut ve erişilebilir olduğunu doğrulayın.
• Uygulamanın kuruluşunuz için uygun hizmet uç noktasını kullandığını onaylayın. 
• Doğrulanmış kimliğin istenen kaynağa erişimi olduğunu onaylayın.
• API hataları için, mevcut olduğunda yanıt başlıklarında döndürülen X-Request-ID'yi saklayın. Destek ekibi isteği izlemek için bu tanımlayıcıyı kullanabilir. 

Uygulamada göz önünde bulundurulacaklar

• Tam iş akışı PDF dosyalarını kabul eder.
• Demo, API erişimi yapılandırıldıktan sonra kimlik doğrulama belirteçlerini yönetir.
• API işlemleri, kimliği doğrulanmış kimliğin mevcut izinlerini kullanır.
• Kaynak paketi bölgesel uç nokta keşif işlevselliği içerir, ancak üretim uç nokta değerleri demo ile birlikte verilen eski değerler yerine güncel Bilgi Bankası API belgelerinden alınmalıdır.