БЫСТРЫЙ СТАРТ ДЛЯ РАЗРАБОТЧИКОВ

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-хост

Добавьте пользовательское MCP-подключение с размещённой конечной точкой и аутентификацией OAuth. Ознакомьтесь со страницей согласия Tracewell и авторизуйте там отдельный ключ чтения проекта; не вставляйте секреты поставщиков или ключи чтения в чат.

Размещённая конечная точка MCPhttps://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 или размещённой конечной точки MCP с OAuth. Оба предоставляют сводки проекта, использование, результаты автоматизаций и внутренние оценки начислений клиентам через отдельный доступ чтения проекта. Настройка хоста и авторизация выполняются явно.

Читаются только инструментированные вами события. Подписки на чаты не обнаруживаются, все разговоры Codex и ChatGPT не проверяются, затраты не выводятся из счетов учётной записи. Для измерения API-вызова отправьте его метаданные в конечную точку приёма. Храните секреты поставщиков отдельно от ключей Tracewell.

Создать ключ проекта только для чтения →

Не перегружайте запросы

Принимаются только документированные поля метаданных. Промпты, ответы моделей, секреты поставщиков и произвольные поля отклоняются. JSON-запросы ограничены 16 КБ. ID событий ограничены проектом и типом события.