डेवलपर क्विकस्टार्ट

AI उपयोग ट्रैकिंग API और इंटीग्रेशन

एक प्रोजेक्ट और एक इवेंट से शुरू करें। जहाँ आपका वर्कफ़्लो पहले से चलता है, वहीं दृश्यता जोड़ें।

एक प्रोजेक्ट। केवल-पठन संदर्भ।

अपने संकेतों को बातचीत में लाएँ।

दोनों कनेक्शन आपका मापा गया उपयोग, ऑटोमेशन स्थिति और आंतरिक ग्राहक शुल्क अनुमान पढ़ते हैं। पहले समर्पित प्रोजेक्ट पठन कुंजी बनाएँ। प्रदाता की API कुंजियाँ आवश्यक नहीं हैं।

स्थानीय Codex प्लगइन

स्थानीय प्लगइन डाउनलोड करें

डाउनलोड में INSTALL.md शामिल है। निकालने के बाद चलाएँ npm ci --prefix server उस फ़ोल्डर से। नीचे का उदाहरण पूरे ऐप सोर्स की संरचना इस्तेमाल करता है।

शामिल सामग्री इस्तेमाल करें plugin/ सोर्स पैकेज। उसकी सर्वर निर्भरताएँ स्थापित करें, फिर अपने Codex होस्ट की समर्थित स्थानीय प्लगइन प्रक्रिया से पैकेज पंजीकृत करें।

npm ci --prefix plugin/server

# In your MCP host's secure environment:
TRACEWELL_URL=https://tracewell.bhsoftwareproductions.com
TRACEWELL_READ_KEY=YOUR_PROJECT_READ_KEY

पैकेज यहाँ स्थानीय stdio सर्वर घोषित करता है plugin/mcp.json. सेटअप विवरण इसमें शामिल हैं docs/PLUGIN.md. सोर्स उपलब्ध होने का मतलब यह नहीं कि प्लगइन आपके होस्ट में स्थापित है।

ChatGPT या संगत MCP होस्ट

होस्ट किए गए एंडपॉइंट और OAuth प्रमाणीकरण से कस्टम MCP कनेक्शन जोड़ें। Tracewell के सहमति पेज की समीक्षा करके वहाँ समर्पित प्रोजेक्ट पठन कुंजी अधिकृत करें; प्रदाता के सीक्रेट या पठन कुंजियाँ चैट में न चिपकाएँ।

होस्ट किया गया MCP एंडपॉइंटhttps://tracewell.bhsoftwareproductions.com/mcp

आपके होस्ट, खाते और प्रशासक को कस्टम MCP कनेक्शन समर्थन देना होगा। मालिक को होस्ट किए OAuth ओरिजिन और स्थायी स्टोरेज कॉन्फ़िगर करने होंगे। यह पेज स्थापित कनेक्शन सत्यापित नहीं करता।

आधिकारिक ChatGPT सेटअप गाइड खोलें

केवल आपके भेजे मेटाडेटा तक।

JavaScript SDK · Python SDK

ये टूल प्रदाता खाते, चैट सदस्यताएँ या हर बातचीत नहीं खोजते। दूसरे प्रोजेक्ट को जोड़ने के लिए अलग समर्पित पठन कुंजी और कनेक्शन इस्तेमाल करें।

प्रोजेक्ट पठन कुंजी बनाएँ

प्रोजेक्ट बनाएँ

वर्कस्पेस खोलें, ग्राहक और प्रोजेक्ट चुनें और अपने काम को नाम व मासिक USD बजट दें। वास्तविक वर्कस्पेस मोड केवल प्रमाणीकरण और API कॉन्फ़िगर होने पर इस्तेमाल करें।

प्रोजेक्ट खोलें →

सीमित-दायरे की कुंजी जारी करें

उस प्रोजेक्ट के लिए इनजेस्ट कुंजी बनाएँ। उसका सीक्रेट एक बार कॉपी करके सर्वर पर रखें। उसे कभी ब्राउज़र कोड में न रखें और प्रदाता के क्रेडेंशियल Tracewell को न भेजें।

उपयोग मेटाडेटा भेजें

curl https://YOUR_HOST/api/v1/usage \
  -H 'Authorization: Bearer YOUR_PROJECT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"eventId":"unique-event-id","provider":"custom",
       "model":"my-model","costUsd":0.042}'

सुरक्षित पुनर्प्रयास के लिए स्थिर और अनूठा eventId इस्तेमाल करें। टोकन संख्या के साथ costUsd या inputRatePerMillion और outputRatePerMillion दोनों दें। स्पष्ट मूल्य निर्धारण के बिना लागत अज्ञात रहती है। किसी भी प्रदाता या मॉडल का नाम समर्थित है।

परिणाम रिपोर्ट करें

POST /api/v1/runs
{
  "eventId": "unique-run-id",
  "automationId": "YOUR_AUTOMATION_ID",
  "status": "success",
  "recordsProcessed": 12,
  "durationMs": 3400
}

पहले ऑटोमेशन बनाएँ। अनुपस्थित रन का मूल्यांकन अपेक्षित अंतराल के पाँच मिनट बाद होता है। विफल या अपर्याप्त परिणाम ऐप में अलर्ट बनाते हैं। अलर्ट सूचना देते हैं; वे मूल वर्कलोड नहीं रोकते।

Codex में संदर्भ लाएँ

स्थानीय Codex प्लगइन या होस्ट किए गए OAuth MCP एंडपॉइंट के लिए ऊपर बॉक्स वाला कनेक्शन क्विकस्टार्ट देखें। दोनों समर्पित प्रोजेक्ट पठन एक्सेस से प्रोजेक्ट सारांश, उपयोग, ऑटोमेशन परिणाम और आंतरिक ग्राहक शुल्क अनुमान देते हैं। होस्ट सेटअप और अनुमति स्पष्ट रूप से करनी होती है।

यह केवल वे इवेंट पढ़ता है जिनके लिए आपने मापन जोड़ा है। यह चैट सदस्यताएँ नहीं खोजता, हर Codex या ChatGPT बातचीत नहीं जाँचता और खाता बिलिंग से लागत का अनुमान नहीं लगाता। API कॉल मापने के लिए इनजेस्ट एंडपॉइंट से उसका मेटाडेटा भेजें। प्रदाता सीक्रेट को Tracewell कुंजियों से अलग रखें।

केवल-पठन प्रोजेक्ट कुंजी बनाएँ →

पेलोड हल्के रखें

केवल दस्तावेज़ों में दिए मेटाडेटा फ़ील्ड स्वीकार हैं। प्रॉम्प्ट, पूर्ण उत्तर, प्रदाता सीक्रेट और मनमाने फ़ील्ड अस्वीकार होते हैं। JSON अनुरोध की सीमा 16 KB है। इवेंट ID का दायरा प्रोजेक्ट और इवेंट प्रकार से तय होता है।