Skip to content

सिमैंटिक क्यूरेशन (Catalog)

पता लगाएँ कि किन एजेंट ट्रेस की समीक्षा करनी है, सिर्फ़ नियमों से नहीं बल्कि समानता से। आपकी आइटमों पर बना embedding इंडेक्स समानता खोज (“इस विफलता जैसी ट्रेस खोजें”) और डायनामिक slice चलाता है, जो सहेजे गए सिमैंटिक और मेटाडेटा फ़िल्टर हैं और मेल खाने वाली नई ट्रेस को अपने आप शामिल करके उन्हें डेटासेटों में संकलित कर देते हैं।

सिमैंटिक क्यूरेशन आपको क्या समीक्षा करनी है यह समानता से खोजने में मदद करता है, सिर्फ़ नियमों या अनिश्चितता से नहीं। आपकी आइटमों पर बना एक embedding इंडेक्स समानता खोज (“इस विफलता जैसी ट्रेस खोजें”) और डायनामिक slice चलाता है: सहेजे गए सिमैंटिक और मेटाडेटा फ़िल्टर, जो मेल खाने वाली नई ट्रेस को अपने आप शामिल कर लेते हैं और उन्हें डेटासेटों में संकलित कर देते हैं। यह नियम-आधारित ट्राइएज और मॉडल-अनिश्चितता वाले सक्रिय अधिगम का पूरक है।

सक्रिय करना

yaml
curation:
  enabled: true
  model_name: all-MiniLM-L6-v2   # any sentence-transformers model
  embed_on_ingest: false          # index runtime-ingested traces on arrival
  text_key: task_description      # which field to embed

Embedding आलसी ढंग से बनते हैं: sentence-transformers केवल तभी import होता है जब आप इंडेक्स बनाते हैं, स्टार्टअप पर कभी नहीं, इसलिए बूट तेज़ बना रहता है। इसे pip install sentence-transformers से इंस्टॉल करें, या अपना कस्टम embedder जोड़ें। सक्रिय होने पर एडमिन डैशबोर्ड में एक Catalog लिंक दिखता है।

बनाना, खोजना, slice करना

bash
# Build the index over current items
curl -X POST localhost:8000/admin/catalog/api/build -H "X-API-Key: <key>"
 
# Search by text query (or by an anchor instance to find neighbours)
curl -X POST localhost:8000/admin/catalog/api/search -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" -d '{"query": "tool call failed", "top_k": 10, "threshold": 0.3}'

slice एक सहेजा गया फ़िल्टर है जो वर्तमान इंडेक्स के विरुद्ध माँग पर हल किया जाता है, इसलिए सहेजने के बाद ग्रहण की गई ट्रेस भी मेल खाने पर अपने आप शामिल हो जाती हैं। यह एक वैकल्पिक सिमैंटिक पड़ोस को मेटाडेटा फ़िल्टर के साथ जोड़ता है:

bash
curl -X POST localhost:8000/admin/catalog/api/slices -H "X-API-Key: <key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "tool-errors", "query": "tool call failed", "threshold": 0.3,
       "metadata_filter": [{"field": "metadata.outcome", "equals": "error"}]}'
 
# Curate the resolved instances straight into a dataset
curl -X POST localhost:8000/admin/catalog/api/slices/tool-errors/to_dataset \
  -H "X-API-Key: <key>" -H "Content-Type: application/json" \
  -d '{"dataset": "tool-errors-to-fix"}'

संबंधित