Prise en main

Ce guide vous permet de passer, pour une installation, de zéro à une première requête fonctionnelle en trois étapes, puis vous montre comment vérifier que tout a fonctionné.

Avant de commencer

• Vous devez être Organisation Administrator. Model Router est disponible uniquement pour les Organisation Administrators, dans les installations Technology Stack.
• Sélectionnez l'installation que vous souhaitez configurer à l'aide du sélecteur d'installation dans la barre d'outils principale de Performance Hub.
• Disposez d'une carte de facturation enregistrée pour l'installation, ou soyez prêt à en ajouter une. Les rechargements débitent votre carte de facturation enregistrée ; si aucune carte n'est enregistrée, la page Balance & Top-up affiche "No card on file." avec un lien Add payment details.

Étape 1 : activer Model Router

Ouvrez Model Router depuis le menu principal (dans le groupe AI Modules & Agents). Si le module n'a pas encore été activé pour cette installation, la page Welcome to Model Router s'affiche :

"Offrez à votre entreprise un accès prépayé à un catalogue de modèles IA de premier plan via un point de terminaison unique compatible avec OpenAI. Vos AI Agents Performance Hub se connectent automatiquement et vous pouvez créer des clés API pour intégrer ces mêmes modèles dans votre propre logiciel, avec des Spend Limits et une visibilité complète sur l'utilisation."

Figure 1 : La page Welcome to Model Router qu'une installation voit avant l'activation du module

La page comporte trois boutons : Enable Model Router, Read the documentation (qui ouvre cette documentation) et Explore first without enabling. En dessous, trois étapes présentent la configuration :

Chaque étape comporte également un lien Learn more.

Cliquez sur Enable Model Router (ou Enable module) pour activer le module.

La liste de contrôle de configuration

Une fois le module activé, une bannière de liste de contrôle de configuration s'affiche en haut de Model Router jusqu'à ce que la configuration soit terminée. Elle s'intitule Finish setting up Model Router et affiche une estimation du temps restant (par exemple ~3 min left), le nombre d'étapes terminées (par exemple 2 of 3 complete) et un bouton Resume qui développe la liste de contrôle complète. Chaque étape propose Review (ou Review again) et Learn more ; Collapse la replie à nouveau. Lorsqu'il ne reste qu'une étape, le sous-titre développé indique "Just one step to go before AI requests start flowing. Steps can be done in any order."

Figure 2 : La bannière de liste de contrôle de configuration affichée jusqu'à la fin de la configuration

Les étapes obligatoires sont Add a billing card, Top up your balance et Connect an agent or create an API key. Les étapes facultatives (Set spend limits, Turn on auto top-up et Verify your first request) peuvent être ignorées avec Skip for now.

Étape 2 : effectuer votre premier rechargement

Accédez à Budgets & Limits → Balance & Top-up.

Figure 3 : La carte Top up balance (montants prédéfinis, montant, carte enregistrée) et la carte Auto top-up

1. Dans la carte Top up balance, choisissez un montant prédéfini ($25, $50, $100, $250, $500, $1000) ou saisissez un montant. "Minimum top-up is $10."
2. Vérifiez la carte enregistrée affichée sous le montant (par exemple "Amex ending 0005 · exp 06/29"). Utilisez Edit payment details si elle doit être mise à jour.
3. Cliquez sur Top up $–.––. En cas de réussite, vous verrez "Top-up successful. Your balance has been credited." Les rechargements apparaissent instantanément dans le solde.

Recommandé : dans la carte Auto top-up, activez Enable auto top-up, définissez When balance is below et Top up by (minimum $10 également), puis cliquez sur Enregistrer les modifications. Votre carte est alors débitée automatiquement chaque fois que le solde passe sous le seuil, afin que l'inférence ne s'arrête jamais de manière inattendue. Consultez Budgets et rechargements pour plus de détails.

Étape 3 : envoyer votre première requête

Choisissez la voie qui vous concerne :

Si vous avez des AI Agents ou des Workflows

Rien à configurer : les appareils Agent IA associés à cette installation se connectent automatiquement, et les Workflows peuvent également se connecter. Ouvrez Settings (roue dentée) → Service Access & API Keys et vérifiez que votre agent apparaît sous Connected Services avec l'état En ligne. Consultez Connected Services.

Si vous connectez vos propres logiciels

1. Ouvrez Settings (roue dentée) → Service Access & API Keys et cliquez sur Create key. Copiez le secret depuis la boîte de dialogue "Copy your API key" : "This is the only time the full key is shown. Store it somewhere safe."
2. Utilisez la Base URL et l'exemple de requête affichés dans la carte Connecting to the API de la même page. Un test minimal :

curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Consultez Connecter votre application pour des exemples en Python et TypeScript.

Étape 4 : vérifier

Ouvrez l'onglet Logs. Votre requête de test devrait apparaître en quelques instants, avec son modèle, ses nombres de tokens, son coût, sa vitesse et un état success. Si ce n'est pas le cas, consultez Dépannage.

Prochaines étapes recommandées

• Définissez des limites de dépenses : Budgets & Limits → Spend Limits. Un plafond mensuel constitue un filet de sécurité judicieux ; consultez Budgets et rechargements.
• Examinez le catalogue de modèles : Settings → Models. Tous les modèles sont activés par défaut ; utilisez les préréglages rapides pour restreindre la sélection si vous avez des préférences en matière de fournisseurs ou de budget. Consultez Models.
• Envisagez des guardrails : Settings → Guardrails pour le masquage des données personnelles, le masquage des secrets et la protection contre l'injection de prompts. Aucun n'est activé par défaut. Consultez Guardrails.