DÉMARRAGE RAPIDE POUR DÉVELOPPEURS

API de suivi IA et intégrations

Commencez avec un projet et un événement. Ajoutez de la visibilité là où votre processus s’exécute déjà.

UN PROJET. UN CONTEXTE EN LECTURE SEULE.

Invitez vos signaux dans la conversation.

Les deux connexions lisent l’utilisation instrumentée, l’état des automatisations et les estimations internes des montants clients. Créez d’abord une clé de lecture dédiée au projet. Aucune clé API fournisseur n’est nécessaire.

Plugin Codex local

Télécharger le plugin local

Le téléchargement inclut INSTALL.md. Après extraction, exécutez npm ci --prefix server depuis ce dossier. L’exemple ci-dessous utilise l’arborescence complète des sources de l’application.

Utilisez le paquet inclus plugin/ contenant les sources. Installez ses dépendances serveur, puis enregistrez le paquet selon la procédure de plugin local prise en charge par votre hôte 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

Le paquet déclare un serveur stdio local dans plugin/mcp.json. Les détails de configuration sont inclus dans docs/PLUGIN.md. La disponibilité des sources ne signifie pas que le plugin est installé dans votre hôte.

ChatGPT ou un hôte MCP compatible

Ajoutez une connexion MCP personnalisée avec le point de terminaison hébergé et l’authentification OAuth. Consultez la page de consentement de Tracewell et autorisez-y une clé de lecture dédiée au projet ; ne collez aucun secret fournisseur ni clé de lecture dans une conversation.

Point de terminaison MCP hébergéhttps://tracewell.bhsoftwareproductions.com/mcp

Votre hôte, votre compte et votre administrateur doivent prendre en charge les connexions MCP personnalisées. Le propriétaire doit configurer l’origine OAuth hébergée et la persistance. Cette page ne vérifie pas une connexion installée.

Ouvrir le guide officiel de configuration ChatGPT

Uniquement les métadonnées que vous envoyez.

SDK JavaScript · SDK Python

Ces outils ne découvrent ni les comptes fournisseurs, ni les abonnements de chat, ni toutes les conversations. Pour connecter un autre projet, utilisez une autre clé de lecture dédiée et une autre connexion.

Créer une clé de lecture du projet

Créer un projet

Ouvrez l’espace, choisissez Clients et projets et attribuez un nom et un budget mensuel en USD à votre travail. N’utilisez le mode réel que lorsque l’authentification et l’API sont configurées.

Ouvrir les projets →

Émettre une clé à portée limitée

Créez une clé d’ingestion pour ce projet. Copiez son secret une fois et conservez-le côté serveur. Ne le placez jamais dans du code navigateur et n’envoyez pas vos identifiants fournisseur à Tracewell.

Envoyer les métadonnées d’utilisation

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

Utilisez un eventId unique et stable pour réessayer sans risque. Fournissez costUsd ou inputRatePerMillion et outputRatePerMillion avec les nombres de jetons. Sans tarification explicite, le coût reste inconnu. Tout nom de fournisseur ou de modèle est pris en charge.

Rapporter les résultats

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

Créez d’abord une automatisation. Une exécution manquante est évaluée après l’intervalle prévu, augmenté de cinq minutes. Les résultats en échec ou insuffisants créent des alertes dans l’application. Les alertes informent ; elles n’arrêtent pas les traitements sources.

Apportez du contexte dans Codex

Utilisez le démarrage rapide de connexion encadré ci-dessus pour le plugin local Codex ou le point de terminaison MCP OAuth hébergé. Les deux exposent les résumés de projet, l’utilisation, les résultats des automatisations et les estimations internes des montants clients via un accès de lecture dédié au projet. La configuration de l’hôte et l’autorisation sont explicites.

Seuls les événements que vous avez instrumentés sont lus. Les abonnements de chat ne sont pas découverts, les conversations Codex ou ChatGPT ne sont pas toutes inspectées et aucun coût n’est déduit de la facturation des comptes. Pour mesurer un appel API, envoyez ses métadonnées au point de terminaison d’ingestion. Séparez les secrets fournisseurs des clés Tracewell.

Créer une clé de projet en lecture seule →

Limiter les données transmises

Seuls les champs de métadonnées documentés sont acceptés. Les prompts, les réponses générées, les secrets fournisseurs et les champs arbitraires sont rejetés. Les requêtes JSON sont limitées à 16 Ko. Les ID d’événement sont propres au projet et au type d’événement.