acme/legal-assistant. Seul votre espace de travail peut le voir ou l’appeler, et il fonctionne partout où un identifiant de modèle public fonctionne.
Les modèles privés sont en Bêta. Les propriétaires et les administrateurs de l’espace de travail les ajoutent et les gèrent.
Avant de commencer
Votre déploiement doit fournir :- une URL de base HTTPS publique ;
- un endpoint
/chat/completionscompatible OpenAI ; - une authentification par jeton Bearer ; et
- un identifiant de modèle ou de déploiement amont accepté par cet endpoint.
/responses est facultative. Laissez-la désactivée, sauf si le déploiement implémente explicitement cet endpoint.
Connecter un déploiement
1
Ouvrir Modèles privés
Ouvrez Tableau de bord → Paramètres → Espace de travail → Modèles privés, puis sélectionnez Ajouter un modèle. Vous devez être propriétaire ou administrateur de l’espace de travail. Pour l’automatiser, appelez
POST /v1/private-models avec les mêmes champs et une clé de gestion.2
Nommer le modèle
Choisissez un modèle existant du catalogue pour ajouter ce déploiement à sa liste de fournisseurs, ou saisissez un slug de modèle court tel que Vous ne pouvez ni choisir ni remplacer l’espace de noms de l’espace de travail. Les identifiants exacts du catalogue se rattachent à ce modèle sans changer son identité publique.
legal-assistant. Si aucun modèle du catalogue n’a ce slug unique, Phaseo le combine avec l’espace de noms de confiance de l’espace de travail :3
Configurer l’endpoint
Saisissez l’URL de base, avant le chemin d’inférence. Par exemple :N’incluez pas
/chat/completions ni /responses. Saisissez séparément l’identifiant exact du modèle ou du déploiement amont ; Phaseo le substitue lors du transfert des requêtes.4
Enregistrer l’identifiant
Saisissez la clé API du déploiement. Phaseo chiffre l’identifiant et ne le renvoie jamais après l’enregistrement. Vous pouvez le remplacer plus tard depuis la page de paramètres du modèle.
5
Appeler le modèle
Utilisez l’identifiant de modèle généré avec l’endpoint Chat Completions habituel :La clé API appelante doit appartenir au même espace de travail que le modèle privé.
cURL
Fonctionnement du routage
Un modèle autonome d’espace de travail n’est routé que vers son endpoint configuré. Un endpoint rattaché à un modèle du catalogue rejoint la liste de fournisseurs de ce modèle selon sa politique de routage :
Phaseo envoie l’identifiant enregistré comme jeton Bearer et substitue l’identifiant de modèle amont configuré.
Un modèle privé ne devient jamais une route de fournisseur publique et n’est pas visible par les autres espaces de travail. Les modèles privés activés figurent dans le catalogue de modèles authentifié et apparaissent sous le filtre Privé.
Après avoir ajouté, modifié ou activé un déploiement privé, attendez jusqu’à une minute avant de tester son routage. D’ici là, certaines requêtes peuvent encore utiliser la configuration précédente, par exemple les fournisseurs publics du modèle. Les requêtes déjà en cours ne sont pas réacheminées.
Exemples par fournisseur
Les produits et formats d’URL des fournisseurs peuvent changer. Vérifiez l’URL de base, l’identifiant de modèle, la méthode d’authentification et les endpoints pris en charge dans la documentation de déploiement actuelle du fournisseur.
Gérer les modèles privés via l’API
L’administration côté serveur peut utiliser l’API Private Models avec une clé de gestion portantprivate_models:read, private_models:write ou private_models:delete selon les besoins.
Les requêtes de création et de mise à jour acceptent model_reference, soit un identifiant exact de modèle du catalogue, soit un slug court. Phaseo dérive model_id ; les clients ne peuvent pas l’envoyer directement. Utilisez host_provider_id pour un fournisseur Phaseo existant, ou custom_provider_name et éventuellement custom_provider_url pour un autre opérateur.
Dépannage
- 404 du fournisseur : vérifiez que l’URL de base s’arrête avant le chemin d’inférence.
- Modèle inconnu : copiez l’identifiant de déploiement amont du fournisseur dans Identifiant du modèle amont. N’y mettez pas l’identifiant de modèle de l’espace de travail Phaseo.
- Requête amont non autorisée : remplacez l’identifiant enregistré et vérifiez que le fournisseur accepte l’authentification Bearer.
- Chat fonctionne mais Responses échoue : désactivez Responses API, sauf si le fournisseur implémente
/responsesnativement. - Modèle absent du catalogue : vérifiez que le modèle est activé et que l’appelant est authentifié dans le même espace de travail.