Commencer par nommer la destination
« Je ne trouve pas mon agent » est incomplet : manque-t-il dans une application Gemini, un Agent Registry partagé ou le mécanisme de découverte d’un autre agent ? Notez destination, projet, emplacement, compte et point de terminaison déployé. Un déploiement réussi dans un projet ne prouve pas l’enregistrement dans une autre application ou un autre projet.
Excluez identifiants secrets, points de terminaison privés et identifiants de compte des notes publiques. Une URL n’autorise pas à rendre un service public ou à élargir les accès jusqu’à ce qu’un test passe.
- Nommez le produit ou l’application où l’agent doit apparaître.
- Faites correspondre projet et emplacement du déploiement et de l’enregistrement.
- Utilisez un compte autorisé à examiner les ressources concernées.
Séparer quatre tâches
Choisissez le rôle le plus limité répondant à la question de l’étape manquante. Guider l’écriture du code n’est pas déployer ; enregistrer ne prouve pas que le service répond correctement. Installer quatre skills n’accorde pas de droits cloud et ne relie pas automatiquement ces étapes.
| Question | Skill | Livrable ou état attendu |
|---|---|---|
| Comment réaliser l’agent ? | google-agents-cli-adk-code | Conseils de code et modèles d’utilisation des API |
| Où le service fonctionne-t-il ? | google-agents-cli-deploy | Service déployé et métadonnées de déploiement |
| Comment les consommateurs doivent-ils le découvrir ? | google-agents-cli-publish | Enregistrement d’un point de terminaison existant |
| Quelle étape du cycle de vie vient ensuite ? | google-agents-cli-workflow | Plan par étapes avec évaluation et approbations |
Examiner le déploiement avant de redéployer
Vérifiez l’état réel du déploiement, le service visé et les métadonnées disponibles. Une expiration de délai locale ne démontre pas l’échec de l’opération distante. Contrôlez l’opération existante avant d’en lancer une autre : une deuxième exécution peut modifier l’état ou coûter de l’argent sans résoudre un manque d’enregistrement.
La procédure publish examinée exige un agent déjà déployé et joignable. Elle peut utiliser les métadonnées de déploiement pour Agent Runtime ; les autres cibles nécessitent les informations de terminaison appropriées. Joignable ne signifie ni public ni sans authentification : préservez les contrôles d’accès prévus.
Vérifier mode d’enregistrement et transport
Dans la révision examinée, une application ADK sur Agent Runtime utilise par défaut l’enregistrement ADK natif ; Cloud Run et GKE utilisent A2A. Les autres combinaisons de framework et d’exécution exigent leur mode documenté. Ne choisissez pas un mode uniquement parce qu’il apparaît dans une commande copiée.
Pour une application Gemini, contrôlez l’application réelle, les métadonnées de service et les permissions pertinentes. La procédure examinée ne prend pas en charge les agents live/voice dans cette application. Agent Registry catalogue séparément agents et services MCP : son entrée n’équivaut pas à un enregistrement dans Gemini. Confirmez le type d’enregistrement avant d’en créer un autre.
Appliquer un changement approuvé, puis vérifier le bon résultat
Plan d’acceptation illustratif, non correction exécutée : prouvez d’abord que le service visé existe, identifiez l’enregistrement manquant, autorisez un changement vers une destination exacte, puis vérifiez la découverte comme utilisateur prévu autorisé. Testez le comportement de l’agent séparément. La visibilité seule ne prouve ni qualité ni sécurité.
Si une permission manque, demandez au responsable l’accès restreint nécessaire. Ne désactivez pas l’authentification, n’accordez pas de rôles larges et ne supprimez pas un enregistrement pour effacer une erreur. Examinez les coûts cloud et modèles avant tout déploiement ou test facturable.
- Consignez les identifiants des ressources existantes avant une écriture.
- Approuvez le changement exact d’enregistrement ou IAM et sa destination.
- Gardez un retour arrière ou une correction possible pour l’enregistrement modifié.
- Distinguez découverte, accès et comportement.
Périmètre des sources
Ce guide analyse google/agents-cli à la révision d445570c61fd446487ea6623c5635b23aded237f, examinée le 19 octobre 2026. Les fichiers d’instructions et empreintes sont consignés ci-dessous. Interfaces, options actuelles de la CLI et permissions des services peuvent changer : consultez la documentation officielle actuelle avant d’opérer un compte réel.
Nous n’avons ni ouvert de session Google Cloud, ni déployé d’agent, modifié IAM, enregistré ou supprimé un point de terminaison, ni reproduit ce scénario. Aucun taux de résolution ou volume de recherche mesuré n’est revendiqué. La liste est un conseil éditorial original, pas une étude de cas client.