Fonctions du Developer Hub

La page Fonctions centralise les fonctions du Developer Hub et fournit un éditeur Deluge, une assistance IA, une analyse de sécurité et une synchronisation GitHub.

Accès et périmètre

Ouvrez Developer Hub → Fonctions, ou utilisez ?tab=functions. Une connexion CRM active est obligatoire.

La liste est alimentée par Zoho CRM et récupère toutes les pages disponibles. Les résultats sont mis en cache en mémoire puis dans le cache local du navigateur. Actualiser ignore ce cache et relance la synchronisation.

Colonne	Description
Nom / API name	Nom d'affichage et nom technique
Runtime / catégorie	Environnement et catégorie Zoho
État	Fonction active ou inactive
REST API	Modes d'exposition REST configurés
Arguments	Paramètres déclarés dans la signature
Source	Fonction CRM ou plugin Marketplace
Brouillon	Présence d'une version brouillon
Type de retour	Type renvoyé par la fonction
Tags	Tags Zoho associés
Modifié par / le	Auteur et date de modification

Les KPI indiquent le nombre total de fonctions, les fonctions actives, les fonctions Deluge et les fonctions Marketplace. La recherche, le tri, les filtres par runtime, catégorie, état, source et tags, la sélection multiple et les exports CSV, Excel et PDF sont disponibles.

Consulter et modifier le code

Depuis le menu d'actions d'une ligne, vous pouvez afficher le code, le télécharger ou ouvrir l'éditeur. L'édition est disponible uniquement pour une fonction CRM écrite en Deluge. Les fonctions Marketplace et les autres runtimes restent consultables sans modification.

L'éditeur permet de :

• consulter le code avec numéros de lignes, coloration syntaxique et pliage des blocs ;
• passer en mode édition et modifier le code ;
• gérer les arguments dans un panneau dédié ; les modifications sont répercutées dans la signature Deluge ;
• ajouter un message de changelog avant la publication ;
• valider la signature avant l'enregistrement : type et nom obligatoires, identifiants valides et noms uniques ;
• confirmer explicitement la publication vers Zoho CRM.

En cas d'erreur de compilation renvoyée par Zoho, le message, la ligne et la colonne sont affichés. La fermeture d'un éditeur modifié demande une confirmation. Une fonction Marketplace peut masquer son code source.

Assistant IA

Le bouton Assistant IA ouvre un panneau à côté du code. Il utilise la clé IA personnelle configurée dans les réglages BYOK ; sans clé valide, aucune action IA ne peut être lancée. La réponse suit la langue préférée du compte et arrive progressivement.

Expliquer

Expliquer le code produit une lecture structurée de la fonction : résumé, entrées et valeur de retour, déroulement, modules/API/connexions CRM utilisés, effets de bord et risques remarquables. L'IA n'exécute pas la fonction et ne réécrit pas le code.

Analyser

Analyser le code combine un contrôle local immédiat et, si le code fait au plus 120 000 caractères, une analyse IA. Le contrôle local recherche notamment :

• une valeur de retour manquante pour un type différent de void ;
• des identifiants numériques codés en dur ;
• une collection trigger vide ;
• un risque de récursion lors d'un updateRecord dans une automatisation ;
• des appels Zoho ou invokeurl coûteux dans une boucle ;
• l'absence de code source.

L'analyse IA ne réécrit pas le code et organise ses résultats en évaluation générale, risques confirmés, risques de performance et de workflow, maintenabilité et prochaines étapes prioritaires. Au-delà de 120 000 caractères, l'analyse reste locale.

Améliorer

Améliorer le code demande à l'IA de proposer un plan de corrections ciblées pour la fiabilité, les performances, la sécurité ou la maintenabilité. Chaque proposition présente un titre, une justification et une comparaison avant/après.

Vous pouvez accepter ou refuser chaque changement dans le tiroir de revue, puis appliquer uniquement les changements acceptés. Le système refuse les propositions ambiguës, non uniques ou qui se chevauchent et vérifie que la signature, le nom, la catégorie, le type de retour et les arguments restent inchangés. Cette action est limitée à 120 000 caractères.

Ajouter des commentaires

Ajouter des commentaires génère une documentation Deluge à partir de la fonction complète : description, @param pour chaque argument, @return et commentaires utiles placés avant les lignes exécutables.

La proposition doit conserver exactement les arguments déclarés et le type de retour, préserver les commentaires existants et ne modifier que les commentaires. Elle est affichée avant application et ne remplace le code qu'après confirmation.

Protection des secrets avant l'IA

Avant d'envoyer du code à l'IA, Zepiq recherche localement les clés privées, tokens Bearer, JWT, clés API connues, affectations sensibles, en-têtes d'autorisation et secrets présents dans les URL.

• Les secrets bloquants sont masqués et empêchent les actions Expliquer, Analyser, Améliorer et Commenter tant qu'une décision n'est pas prise.
• Pour l'explication et l'analyse, vous pouvez demander une nouvelle analyse du code automatiquement masqué.
• Les actions de commentaire et d'amélioration ne sont pas lancées sur du code contenant un secret détecté.
• Les valeurs elles-mêmes ne sont jamais affichées dans le rapport ; seuls le type et le numéro de ligne sont indiqués.

Partager un résultat

Après une explication ou une analyse terminée, le résultat peut être copié ou envoyé par email. Le formulaire demande un destinataire, un objet et un message. Le contenu est limité côté interface et l'envoi est limité à cinq demandes par minute.

Publier vers GitHub

Une fonction Deluge dont le code est disponible peut être envoyée vers le dépôt GitHub configuré :

• la connexion GitHub, le dépôt et la branche doivent être configurés ;
• le chemin utilise zoho-functions/{organisation}/functions/{api_name}.dg ;
• une confirmation affiche le dépôt, la branche et le chemin avant l'envoi ;
• le changelog de la publication Zoho peut être inclus comme note GitHub ;
• le statut et le dernier commit sont affichés dans le détail ;
• plusieurs fonctions peuvent être sélectionnées et envoyées en une seule opération.

Limites

Les fonctions sont lues depuis Zoho CRM, mais la sauvegarde, la publication et l'envoi GitHub restent soumis aux droits, connexions et scopes configurés. L'IA n'a pas accès aux outils CRM, n'exécute jamais le code et travaille sur le code comme une donnée à analyser.