Configuration de l’infrastructure create-first-app
L’infrastructure est la base technique de votre application : les référentiels qui stockent son code et les services qui exécutent ses gestionnaires d’action et diffusent ses widgets aux utilisateurs.
Comme expliqué dans la présentation, un gestionnaire d’actions effectue une tâche, telle que la recherche de produits, tandis qu’un widget présente le résultat sous la forme d’une expérience interactive dans la conversation.
LLM Apps stocke le code source du gestionnaire et du widget dans deux référentiels GitHub distincts :
- Référentiel d’action : contient les gestionnaires côté serveur et leurs tests.
- Référentiel de widgets — contient le code et les styles pour les widgets interactifs.
Par exemple, un gestionnaire de recherche de produits récupère les produits correspondants et son widget les affiche sous forme de cartes de produits. Les référentiels stockent ce code ; Adobe I/O Runtime exécute les gestionnaires déployés et Edge Delivery Services diffuse les widgets.
L’assistant de configuration prépare ces référentiels et connecte les services dont votre application a besoin. Nous vous recommandons de commencer par l’infrastructure gérée par, la manière la plus rapide de commencer. Adobe crée et héberge les référentiels pour vos gestionnaires d’action et widgets. Vous n’avez pas besoin de configurer vous-même les référentiels.
Vous pouvez également fournir deux référentiels GitHub vides dans votre propre compte ou organisation. La plateforme les initialise avec les fichiers de projet requis ; il n’est pas nécessaire de préparer au préalable l’action ou le code du widget.
Dans ce guide : découvrez comment choisir une option d’infrastructure et créer votre application à l’aide de l’assistant de configuration. Après la configuration, passez à Création d’actions.
La création de l’application ne lance la génération d’actions. Démarrez la génération de l’action séparément de la page de l’application.
Ouvrir l’assistant de création d’application
Ouvrez Applications Adobe LLM. Sur la page d’accueil, sélectionnez Commencer. Si une application est déjà ouverte, utilisez le sélecteur d’applications et sélectionnez Créer une application.
L’assistant Créer votre application LLM commence par Commencer. Choisissez comment configurer l’environnement technique.
Les deux options prennent en charge la génération automatique d’actions ultérieurement. Aucune des deux options ne nécessite que vous écriviez des actions manuellement.
Utilisation de l’infrastructure gérée par Adobe adobe-managed-infrastructure
Utilisez cette option pour permettre à Adobe de configurer et de gérer les référentiels et les services connectés pour votre application. Vous n’avez pas besoin de créer de référentiels ni d’installer vous-même des applications GitHub.
- Sélectionnez Laissons-nous nous en occuper.
- Sélectionnez Étape suivante.
- Complétez Détails de l’application.
- Sélectionnez Créer une application.
La page de l’application affiche Configuration de l’application pendant qu’Adobe prépare les référentiels et connecte le site du widget. L’interface utilisateur indique que la configuration prend généralement entre 1 et 2 minutes ; les actions, les tests et le déploiement ne sont pas disponibles tant que la configuration n’est pas prête.
Si la configuration échoue, lisez l’erreur et sélectionnez Réessayer. Si la page ne peut pas vérifier la progression, l’installation se poursuit en arrière-plan ; sélectionnez Vérifier à nouveau pour vous reconnecter.
Une fois la configuration terminée, passez à Création d’actions.
Connecter vos propres référentiels your-own-repositories
Sélectionnez Je vais le configurer moi-même, puis Étape suivante. Ce chemin d’accès comporte quatre étapes d’assistant :
Prise en main → Configuration de l’infrastructure Action → Configuration de l’infrastructure Widget → Détails de l’application.
Vous devez accéder aux référentiels sélectionnés et disposer des autorisations nécessaires pour installer ou configurer les applications GitHub requises. Pour les référentiels appartenant à l’organisation, un administrateur peut avoir besoin d’approuver l’accès.
Créez deux référentiels vides : un pour les gestionnaires d’action et un pour les widgets. N’initialisez pas avec un fichier README, une licence ou une .gitignore. La plateforme ajoute la structure de projet requise lorsque vous validez chaque référentiel dans l’assistant.
Si vous disposez déjà de projets d’action et EDS compatibles, vous pouvez les connecter à la place, mais le code existant n’est pas requis.
Configurer l’infrastructure d’action
Le référentiel d’actions contient les tests et gestionnaires côté serveur qui s’exécutent lorsqu’une plateforme LLM appelle une action.
-
Sous Source des actions, sélectionnez GitHub. Les autres sources de code ne sont actuellement pas disponibles.
-
Réponse Avez-vous déjà créé un référentiel GitHub ? :
- Sélectionnez Oui, j’utiliserai un référentiel déjà créé pour connecter un projet existant compatible ou un référentiel vide.
- Sélectionnez Je n’ai pas encore de référentiel puis Créer des référentiels sur GitHub pour créer un référentiel d’actions vide. Revenez ensuite à l’assistant.
-
Connectez le référentiel à l’application GitHub Adobe LLM Apps :
- Si aucune organisation n’est connectée, sélectionnez Installer sur GitHub.
- Si une organisation est déjà connectée, sélectionnez Connecter le référentiel et ajoutez le référentiel à cette installation.
-
Sur GitHub, choisissez Ne sélectionner que les référentiels et accordez l’accès uniquement aux référentiels utilisés par cette application.
-
Revenez à l’assistant. Sous Sélectionner le référentiel, choisissez les options Organisation et Référentiel.
-
Sélectionnez Valider le référentiel. La validation initialise un référentiel vide avec le modèle standard Applications LLM Adobe . Un référentiel existant doit contenir un projet d’actions compatible.
-
Une fois la validation réussie, sélectionnez Étape suivante.
Si une organisation ou un référentiel est manquant, utilisez Connecter une autre organisation ou Connecter un autre référentiel dans son sélecteur. Après avoir modifié l’accès sur GitHub, sélectionnez Actualiser les organisations et les référentiels.
Configurer l’infrastructure du widget
Les widgets sont des réponses visuelles facultatives jointes à des actions, telles que des cartes de produits ou des formulaires de réservation. L’assistant connecte un référentiel Edge Delivery Services (EDS) pour les héberger.
- Sous Source du widget, sélectionnez Sélectionner manuellement le référentiel de widgets.
- Sous Source du code, sélectionnez GitHub.
- Choisissez si vous disposez déjà d’un référentiel. Dans le cas contraire, sélectionnez Créer des référentiels sur GitHub, créez un référentiel de widget vide et revenez à l’assistant.
- Installez ou configurez l’application GitHub Adobe LLM Apps pour ce référentiel, comme vous l’avez fait pour le référentiel d’action.
- Sélectionnez ses Organisation et Référentiel. Ne sélectionnez pas le référentiel d’actions.
- Sélectionnez Valider le référentiel. La validation initialise un référentiel vide avec le modèle AEM. Un référentiel existant doit être un projet EDS compatible.
- Sélectionnez Installer la synchronisation du code AEM et accordez à la synchronisation du code AEM l’accès au référentiel de widgets.
- Sur la page de confirmation de l’installation, utilisez l’assistant d’installation pour vous ajouter en tant qu’administrateur du site EDS.
- Revenez à LLM Apps et sélectionnez Valider l’installation de la synchronisation du code AEM.
- Lorsque La synchronisation du code AEM est installée apparaît, sélectionnez Étape suivante.
Si la validation ne détecte pas la synchronisation du code AEM, vérifiez que la synchronisation du code AEM a accès au référentiel de widgets sélectionné et que vous vous êtes ajouté en tant qu’administrateur ou administratrice du site. Validez à nouveau.
Saisir les détails de l’application app-details
Les deux options d’infrastructure se terminent par Détails de l’application.
- Saisissez le Nom de l’application LLM. Utilisez un nom qui identifie la marque ou l’expérience, tel que café Frescopa.
- Sélectionnez le programme auquel l’application appartient. Si vous n’avez accès qu’à un seul programme, l’assistant le sélectionne automatiquement.
- Sous Région de données Analytics, choisissez États-Unis (US) ou Europe (UE).
- Sélectionnez Créer une application.
Si aucun programme AEM n’est disponible, demandez l’accès à votre administrateur. Si le chargement des programmes échoue, sélectionnez Réessayer de charger les programmes.
L’assistant ouvre la page de l’application après sa création. Avec l’infrastructure gérée par Adobe, attendez la fin de la configuration de l’infrastructure avant de continuer.
Ensuite : créez les actions
Votre application dispose désormais de son infrastructure, mais aucune action générée pour le moment. Continuez avec Créer des actions pour analyser un site web ou choisissez la création d’actions manuelles.
Pour connaître la relation entre les métadonnées d’action, les gestionnaires, les widgets et le serveur MCP déployé, consultez la section Comment une application est connectée ensemble.