Kit développeur

L'écran Kit développeur vous permet de voir, pour une application, un agent ou un projet, chaque ressource que la plateforme lui fournit (passerelle LLM, identité, politiques, protection des données, traces, outils, documents, SDK et tests), de télécharger son fichier d'environnement et de copier des extraits SDK prêts à l'emploi. Chemin dans le portail : /developer/kit. Il sert aux développeurs, aux responsables d'application et aux administrateurs du tenant qui branchent une application sur la Navin Platform.

Ce que montre l'écran

• Kit pour : choisissez Une application, Un agent ou Un projet. Les applications viennent de GET /v1/applications, les agents de GET /v1/agents (200 premiers), les projets sont les projets distincts des applications.
• Application, agent ou projet : le sujet du kit. Le kit lui-même est lu avec GET /v1/developer/kit et le paramètre de requête application_id, agent_id ou project.
• Un badge {ready} sur {total} prêts : vert quand toutes les ressources sont prêtes, orange sinon.
• Quatre onglets (l'onglet choisi est conservé dans l'adresse) :
  • Ce que vous obtenez (avec le nombre de lignes) : un tableau avec les colonnes Ressource, Fourni par, Valeur, État, Action et un menu de ligne. Les neuf lignes sont Passerelle LLM, clé et modèles autorisés, Identité et session de l'utilisateur, Permissions et politiques, Protection des données, Traçabilité IA, Outils métier autorisés, Accès contrôlé aux documents, SDK, contexte utilisateur et règles, Tests de qualité et de sécurité. Chaque ligne de valeur a son propre bouton de copie. État vaut Prêt, Non configuré ou Service non installé. Action est le message du Control Plane qui indique comment corriger la ligne.
  • Fichier d'environnement : le fichier .env du sujet dans un éditeur en lecture seule (passerelle, OIDC, DLP, passerelle MCP, OTLP et Opik). Une entrée secrète reste vide avec un commentaire : le kit ne transporte jamais de secret.
  • Extraits SDK : une liste Langage (Python, TypeScript, Go, Java) et un extrait en lecture seule qui masque le texte utilisateur avec la DLP, puis appelle une complétion de chat par la passerelle avec l'agent, la finalité et la classification du sujet.
  • Prochaines étapes (avec le nombre d'étapes) : créer une clé de projet et la mettre dans EAI_API_KEY, lancer les suites de qualité, lancer un red team avant la production.

remarque

L'entrée de la clé d'API du fichier d'environnement est toujours vide. La clé est créée sur la page des clés LiteLLM et affichée une seule fois.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Kit pour	Change le type de sujet et réinitialise la liste des sujets.	GET /v1/applications ou GET /v1/agents	Rôles autorisés à lire les applications ou les agents
Application, agent ou projet	Charge le kit du sujet choisi.	GET /v1/developer/kit	tenant_admin, developer, application_owner
Bouton de copie d'une ligne de valeur	Copie une valeur (URL, identifiant, liste de modèles).	Aucun	Toute personne qui voit le kit
Menu de ligne > Ouvrir la page	Ouvre la page du portail qui corrige la ligne.	Aucun	Toute personne qui voit le kit
Bouton de copie du Fichier d'environnement	Copie tout le texte du .env.	Aucun	Toute personne qui voit le kit
Télécharger le .env	Télécharge le fichier <nom-du-sujet>.env.	Aucun	Toute personne qui voit le kit
Langage	Affiche l'extrait du SDK choisi.	Aucun	Toute personne qui voit le kit
Bouton de copie des Extraits SDK	Copie l'extrait.	Aucun	Toute personne qui voit le kit
Ouvrir la page (prochaine étape)	Ouvre la page de l'étape (clés, évaluation, red team).	Aucun	Toute personne qui voit le kit
Réessayer (état d'erreur)	Relit la liste ou le kit.	Le même appel que celui en échec	Mêmes rôles

Rôles

Le Control Plane ne construit le kit que pour les rôles tenant_admin, developer et application_owner (KIT_ROLES dans services/control-plane/src/eai/domains/developer/__init__.py) ; platform_admin passe tous les contrôles de rôle. Le portail ne demande lui-même aucun rôle sur cet écran : tout autre utilisateur voit l'erreur renvoyée par l'API. Le kit n'affiche jamais de secret et peut donc être partagé dans l'équipe.

Tâches courantes

Obtenir le fichier d'environnement d'une application

1. Choisir le sujet. Le kit est calculé par application. Dans Kit pour, choisissez Une application, puis sélectionnez-la dans Application, agent ou projet. Résultat attendu : le badge affiche le nombre de ressources prêtes. En cas d'échec : la liste est vide quand aucune application n'est enregistrée ; enregistrez-en une sur la page Applications.
2. Vérifier les ressources. Une ligne qui n'est pas prête donne une valeur fausse dans le fichier. Ouvrez Ce que vous obtenez et lisez la colonne État. Résultat attendu : toutes les lignes sont Prêt. En cas d'échec : utilisez le menu de ligne Ouvrir la page et suivez le message Action.
3. Télécharger le fichier. L'application y lit ses paramètres. Ouvrez Fichier d'environnement et cliquez sur Télécharger le .env. Résultat attendu : un fichier <nom>.env est téléchargé, avec EAI_API_KEY= vide. En cas d'échec : copiez le texte avec le bouton de copie.
4. Ajouter la clé. Le kit ne contient jamais de secret. Créez une clé de projet sur la page des clés LiteLLM et collez-la après EAI_API_KEY=. Résultat attendu : l'application s'authentifie auprès de la passerelle. En cas d'échec : vérifiez que la clé appartient au projet de l'application.

Copier un extrait pour un agent

1. Sélectionner l'agent. L'extrait reprend le nom de l'agent et le premier modèle autorisé. Dans Kit pour, choisissez Un agent, puis l'agent. Résultat attendu : le kit de l'agent se charge. En cas d'échec : une liste vide signifie qu'aucun agent n'est encore enregistré.
2. Choisir le langage. Ouvrez Extraits SDK et choisissez Python, TypeScript, Go ou Java dans Langage. Résultat attendu : l'extrait montre la ligne d'installation et les appels DLP et passerelle. En cas d'échec : quand le modèle vaut your-model, la ligne LLM n'a aucun modèle autorisé ; corrigez-la depuis Ce que vous obtenez.
3. L'exécuter. Copiez l'extrait et lancez-le avec le fichier d'environnement chargé. Résultat attendu : la réponse du modèle s'affiche. En cas d'échec : consultez le tableau de dépannage ci-dessous.

Dépannage

Symptôme	Cause	Correction
Erreur forbidden (403) avec required_roles	Vos rôles ne sont pas tenant_admin, developer ou application_owner.	Demandez l'un de ces rôles à un administrateur du tenant.
Erreur invalid_request (400) avec expected_one_of	Le kit a été demandé avec zéro ou plusieurs sujets.	Choisissez exactement un sujet dans la liste.
Erreur not_found (404) sur un projet	Le projet du kit n'existe plus.	Choisissez un autre projet ou créez-le sur la page Projets.
Aucune application pour l'instant ou Aucun agent pour l'instant	Rien n'est enregistré pour ce type.	Enregistrez une application sur la page Applications ou un agent dans le Registre, puis revenez.
Une ligne affiche Service non installé	Le service derrière la ligne n'est pas installé sur la plateforme.	Installez-le avec le Navin Manager, puis rechargez le kit.
Une ligne affiche Non configuré	Le service est installé mais pas configuré pour ce sujet.	Suivez le message Action de la ligne.

Pages liées

• Guide du portail développeur
• Démarrage SDK
• Référence API
• Clés LiteLLM
• Applications
• Registre des agents
• Suites d'évaluation
• Documentation des SDK