Ek bilgi göndermek
Kurum ve proje bağımsız yedi aile; anlamlı veriyi doğru alanla kaydedin.
#Ortak aileler
| Aile | Kullanım |
|---|---|
| lifecycle | Gerçek işlem ve adım başlangıcı/sonu; normalde SDK yönetir |
| ai | Model, sınıflandırma, retrieval, araç, embedding, inference, değerlendirme, politika, açıklama |
| http | Desteklenen sınırdaki gerçek istek/yanıt gözlemi |
| otel | Gerçek teknik span, event, attribute, link ve durum |
| context | Gerçek bağlam ve isteğe bağlı referanslar |
| source | Kurumdaki kayıt karşılığı ve özgün kaynak içerik |
| custom | Kurumun anlamlı ek iş bilgisi; JSON nesnesi |
from sigillum_finans import JsonData, Attachment
with sdk.start_step("record-source") as step:
step.observe("source", "comparison.source",
JsonData.raw('{"reference":"DEMO-001"}'),
attachments=(Attachment(
"original", original_bytes,
"application/json", "comparison.originalContent"
),))
step.observe("custom", "decision.explanation",
JsonData.raw(explanation_json))using var step = observer.BeginStep("record-source");
observer.Source(
"""{"reference":"DEMO-001"}"""u8.ToArray(),
[new SdkAttachment("original", "application/json",
"comparison.originalContent", originalBytes)]);
observer.Custom("decision.explanation", explanationJson);try (var step = sdk.child("record-source");
var active = step.activate()) {
sdk.capture(sdk.current(), "source", "comparison.source",
"institution.source/1", metadataJson,
new CaptureContent("original", "application/json",
"comparison.originalContent", originalBytes));
sdk.capture("custom", "decision.explanation", explanationJson);
}#AI bilgisi için alan örnekleri
| Bilgi | Gerçekte varsa gönderilebilecek içerik |
|---|---|
| model | ad, sağlayıcı, sürüm, çalışma tipi, gerçek parametreler |
| classification | sınıf/niyet ve gözlenen güven puanı |
| retrieval | kaynak kimliği, belge referansı, sıra ve ağırlık |
| tool | aday/seçilen araç, argümanlar, gerçek sonuç |
| embedding | model ve sürüm, girdi referansı, vektör boyutu; gerekli özgün içerik |
| inference | gerçek özellik girdisi, tahmin/puan ve çıktı |
| evaluation | kontrol adı, ölçüt ve gözlenen sonuç |
| policy | uygulanmış kural ve sürümü |
| explanation | kaynak uygulamanın gerçekten ürettiği açıklama |
Bu JSON anahtarları örnek iş verisidir; her senaryo için doldurulması gereken zorunlu alan listesi değildir. Gerçekte bulunmayan bilgi üretmeyin.
#Neyi uygulama set eder?
Uygulama kendi data JSON içeriğini, içerik eklerini, uygun referanslarını ve gerçekten bildiği açık nedensel bağlantıları sağlar. SDK/ürün; kurum/ortam/servis yetkisini, kaynak kayıt kimliğini ve sırasını, imzalı kapsamı, kendi trace/span bağlarını, içerik hash/uzunluk referanslarını, teslim makbuzunu ve mühürleri yönetir. İş verisi içine aynı isimli bir alan eklemek ürün kimliğini değiştirmez.
#Doğruluk ve sınırlar
Hazır ham JSON nesnesi kullanın. null ile hiç bulunmayan alan farklıdır. JSON nesnesinde yinelenen anahtar veya geçersiz içerik kayıp/ret durumuna yol açar. Büyük binary içerik ek olarak taşınabilir; bunu base64 ile data içinde ikinci kez çoğaltmayın. Her dilin paket referansı boyut ve kapasite sınırlarını belirtir.
#Diller arası karşılık
Aşağıdaki dil seçimi aynı ortak amaç için gerçek SDK yüzeyini gösterir. Örnek değerleri kurumunuzun kaynakta zaten bulunan verisiyle değiştirin. Gizli model muhakemesi veya tahmini bir karar gerekçesi eklemeyin.
