Form
Transformez un workflow en formulaire pour votre site web, avec un lien de test avant le déploiement.
Le déclencheur Form transforme un workflow en formulaire. Chaque envoi exécute le workflow une fois.
Le construire
- Ajoutez un déclencheur Form. Un workflow doté d'un déclencheur Form n'a aucun autre déclencheur.
- Sous Fields, ajoutez les champs que le visiteur remplit. Chaque champ est disponible pour les blocs suivants sous la forme
<form.<field name>>. - Terminez éventuellement par un bloc Form Reply : son message est affiché au visiteur après l'envoi. Sans lui, le visiteur voit le Thank-you message du déclencheur (ou est redirigé vers son Redirect URL).
- Avant de déployer, cliquez sur Deploy (le bouton affiche Versions une fois tout déployé), ouvrez Paramètres d'exécution, choisissez l'environnement puis un compte de service sous Exécuter en tant que. Une URL en production s'exécute toujours sous ce compte, jamais sous votre identité, et un formulaire sans compte de service ne peut être ni déployé ni promu. L'URL de test s'exécute aussi sous ce compte ou, tant qu'aucun n'est choisi, sous votre identité. Le menu Exécuter en tant que à côté du bouton Run de la barre d'outils ne modifie qu'une seule exécution manuelle.
Les autres paramètres du déclencheur Form sont Title, Description, Submit button, Redirect URL et Reply wait (seconds). Le Redirect URL doit être en https : une URL qui n'est pas en https est ignorée, et le visiteur voit le message de remerciement à la place. Le délai de réponse (de 0 à 60, 30 par défaut) est le temps pendant lequel la page attend un Form Reply avant d'afficher le message de remerciement. L'exécution se poursuit dans les deux cas.
Ce que l'exécution d'un formulaire peut lire et écrire
Les exécutions d'un formulaire suivent les mêmes règles que celles d'un chat : voir Ce que les visiteurs peuvent lire et écrire. Rien de ce qu'envoie un visiteur n'est écrit dans une base de connaissances, dans Memex ou dans le stockage.
Tester, passer en production, intégrer
L'URL de test, l'URL en production, les Origines autorisées (mêmes règles et limites : au plus 50 origines, de 512 caractères chacune), le mot de passe et les limites fonctionnent comme pour le déclencheur Chat : une URL de test une fois le workflow enregistré dans un environnement (un workflow qui n'appartient à aucun environnement n'obtient pas d'interface), une URL en production par environnement promu, et l'extrait iframe dans le panneau du déclencheur dès qu'une URL en production existe. Dans un environnement que vous ne pouvez pas modifier, comme la production, l'éditeur ne s'ouvre pas : l'onglet Partager de la page du workflow affiche l'URL en production, l'extrait iframe et l'état de Interface activée, et Monitor affiche l'URL en production sur la ligne du déclencheur du workflow, avec un bouton de copie. La page hébergée est /form/<identifier>, par exemple https://app.example.com/agentic/form/<identifier> en mode sous-chemin. Un formulaire n'a pas de bulle de lancement ; dans son panneau, Ouvrir le formulaire de test ouvre le formulaire dans un nouvel onglet, comme Ouvrir le chat de test pour un chat.
Les Limites d'un formulaire se réduisent à Envois par jour, tous visiteurs confondus (1 000 par défaut ; le quota se renouvelle toutes les 24 heures). Un formulaire ne conserve aucune conversation.
Une interface protégée par mot de passe exige https à la fois sur la page qui l'intègre et sur l'hôte Scrydon. Le cookie de connexion est SameSite=None; Partitioned, que les navigateurs rejettent en http simple.
Depuis votre propre interface
submitForm(values) dans le client d'interface renvoie { status: "replied", message } lorsqu'un Form Reply a répondu à temps, sinon { status: "submitted" }.
Dépannage
| Symptôme | Cause probable |
|---|---|
| L'iframe affiche une page blanche ou une erreur de navigateur indiquant que l'affichage en iframe est bloqué | Le site ne figure pas dans les Origines autorisées, la page n'est pas servie en https, ou vous avez intégré une URL de test. Seule une URL en production peut être intégrée. |
| Dans l'iframe, le mot de passe est accepté puis la page indique que le navigateur bloque la connexion | Le navigateur du visiteur ne conserve aucun cookie pour une page intégrée (il bloque les cookies tiers, ou ne prend pas en charge les cookies partitionnés). La page propose un lien Ouvrir dans un nouvel onglet, où le formulaire fonctionne comme une page autonome. |
L'envoi échoue avec UNAUTHORIZED | Le mot de passe est absent, incorrect, ou a été modifié depuis la connexion du visiteur. |
L'envoi échoue avec RATE_LIMITED ou BUDGET_EXHAUSTED | Plus de 120 requêtes par minute ont atteint le formulaire, plus de 10 par minute proviennent d'une même adresse IP, ou les envois du jour sont épuisés. Réessayez après la valeur de Retry-After, ou augmentez la limite. |
| L'URL répond « Cette page n'existe pas. » | L'identifiant est incorrect, Interface activée est désactivé, ou l'interface a été remplacée. Sur un déploiement en sous-chemin, vérifiez aussi le préfixe /agentic. Pour une URL de test : vous n'êtes pas connecté à Scrydon dans ce navigateur, vous n'avez pas d'accès en modification, ou le workflow s'exécute sous un compte de service que vous ne pouvez pas utiliser. |
| La page indique « Cette page n'est pas disponible pour le moment. » | La version déployée ne peut pas s'exécuter, ou le workflow n'a plus de déclencheur Form fonctionnel. |
| L'envoi signale un problème sur des champs marqués | Une valeur ne correspond pas au type du champ ; corrigez les champs marqués. |
Publications de formulaire
Les publications de formulaire ont été supprimées (voir Mises à jour). Recréez un formulaire publié sous la forme d'un workflow doté d'un déclencheur Form.