BẮT ĐẦU NHANH CHO NHÀ PHÁT TRIỂN

API theo dõi sử dụng AI và tích hợp

Bắt đầu với một dự án và một sự kiện. Thêm khả năng quan sát ở nơi quy trình vốn đang chạy.

MỘT DỰ ÁN. BỐI CẢNH CHỈ ĐỌC.

Đưa tín hiệu vào cuộc trò chuyện.

Cả hai kết nối đều đọc mức sử dụng đã đo lường, tình trạng tự động hóa và ước tính nội bộ về phí khách hàng. Trước tiên hãy tạo khóa đọc dự án riêng. Không cần khóa API của nhà cung cấp.

Plugin Codex cục bộ

Tải plugin cục bộ

Bản tải xuống gồm INSTALL.md. Sau khi giải nén, chạy npm ci --prefix server từ thư mục đó. Ví dụ bên dưới dùng bố cục mã nguồn ứng dụng đầy đủ.

Dùng phần đi kèm plugin/ gói mã nguồn. Cài các phụ thuộc máy chủ, rồi đăng ký gói qua quy trình plugin cục bộ mà ứng dụng chủ Codex hỗ trợ.

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

Gói khai báo máy chủ stdio cục bộ trong plugin/mcp.json. Chi tiết thiết lập nằm trong docs/PLUGIN.md. Có mã nguồn không có nghĩa plugin đã được cài trong ứng dụng chủ.

ChatGPT hoặc ứng dụng chủ MCP tương thích

Thêm kết nối MCP tùy chỉnh bằng điểm cuối được lưu trữ và xác thực OAuth. Xem trang chấp thuận của Tracewell rồi cấp quyền cho khóa đọc dự án riêng tại đó; không dán khóa bí mật của nhà cung cấp hoặc khóa đọc vào cuộc trò chuyện.

Điểm cuối MCP được lưu trữhttps://tracewell.bhsoftwareproductions.com/mcp

Ứng dụng chủ, tài khoản và quản trị viên phải hỗ trợ kết nối MCP tùy chỉnh. Chủ sở hữu phải cấu hình origin OAuth được lưu trữ và lưu trữ lâu dài. Trang này không xác minh kết nối đã cài.

Mở hướng dẫn thiết lập ChatGPT chính thức

Chỉ siêu dữ liệu bạn gửi.

JavaScript SDK · Python SDK

Các công cụ không phát hiện tài khoản nhà cung cấp, gói đăng ký chat hoặc mọi cuộc trò chuyện. Để kết nối dự án khác, dùng khóa đọc và kết nối riêng biệt.

Tạo khóa đọc dự án

Tạo dự án

Mở không gian làm việc, chọn Khách hàng và dự án, đặt tên công việc và ngân sách tháng bằng USD. Chỉ dùng chế độ không gian làm việc thật khi đã cấu hình xác thực và API.

Mở dự án →

Cấp khóa có phạm vi

Tạo khóa tiếp nhận cho dự án đó. Sao chép khóa bí mật một lần rồi lưu phía máy chủ. Không đưa khóa vào mã trình duyệt hoặc gửi thông tin xác thực nhà cung cấp đến Tracewell.

Gửi siêu dữ liệu sử dụng

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}'

Dùng eventId duy nhất và ổn định để thử lại an toàn. Cung cấp costUsd hoặc cả inputRatePerMillion và outputRatePerMillion cùng số token. Không có giá rõ ràng, chi phí vẫn chưa biết. Hỗ trợ mọi tên nhà cung cấp hoặc mô hình.

Báo cáo kết quả

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

Trước tiên hãy tạo tự động hóa. Lượt chạy bị thiếu được đánh giá sau khoảng thời gian dự kiến cộng năm phút. Kết quả thất bại hoặc không đủ tạo cảnh báo trong ứng dụng. Cảnh báo cung cấp thông tin, không dừng tác vụ ở hệ thống nguồn.

Đưa bối cảnh vào Codex

Dùng hướng dẫn kết nối nhanh trong khung bên trên cho plugin Codex cục bộ hoặc điểm cuối MCP OAuth được lưu trữ. Cả hai cung cấp tóm tắt dự án, mức sử dụng, kết quả tự động hóa và ước tính phí khách hàng nội bộ qua quyền đọc dự án riêng. Việc thiết lập ứng dụng chủ và cấp quyền đều cần thực hiện rõ ràng.

Công cụ chỉ đọc sự kiện bạn đã tích hợp đo lường. Nó không phát hiện gói đăng ký chat, kiểm tra mọi cuộc trò chuyện Codex hoặc ChatGPT, hay suy ra chi phí từ hóa đơn tài khoản. Để đo một lần gọi API, hãy gửi siêu dữ liệu qua điểm cuối tiếp nhận. Giữ khóa bí mật nhà cung cấp riêng với khóa Tracewell.

Tạo khóa dự án chỉ đọc →

Giữ payload gọn nhẹ

Chỉ chấp nhận các trường siêu dữ liệu được mô tả. Từ chối prompt, nội dung trả lời, khóa bí mật nhà cung cấp và trường tùy ý. Yêu cầu JSON giới hạn 16 KB. ID sự kiện có phạm vi theo dự án và loại sự kiện.