FoloToy/folotoy-toy-role-config-skill

Configuration du personnage FoloToy

Configurez en toute sécurité un personnage FoloToy et vérifiez le résultat sur l'appareil réel.

Lisez references/api-workflow.md avant d'effectuer des appels API. Consultez references/examples.md lorsque l'utilisateur souhaite de l'aide pour concevoir un personnage ou une ligne d'ouverture.

Tâches prises en charge

• Se connecter avec un numéro de téléphone et un code SMS unique.
• Vérifier si un appareil autorisé est déjà appairé.
• Appairer un appareil non appairé avec son SN et sa clé d'appairage.
• Lire l'appareil actuel, le personnage actif et les modèles vocaux disponibles.
• Modifier le personnage, la ligne d'ouverture et la voix.
• Relire le personnage sauvegardé et guider un test sur l'appareil physique.

N'utilisez pas cette compétence pour désappairer un appareil, effacer la mémoire, réinitialiser le réseau, supprimer un compte, acheter des services ou contrôler un appareil que l'utilisateur ne possède pas ou pour lequel il n'a pas d'autorisation explicite de gestion.

Modèle de sécurité

Les secrets identifient un compte ou un appareil physique. Gardez-les hors des invites, fichiers sources, captures d'écran, URL, journaux persistants et rapports finaux.

1. Demandez le numéro de téléphone, le code SMS, le SN et la clé d'appairage uniquement lorsque chaque valeur est nécessaire.
2. Ne renvoyez pas un numéro de téléphone, un code SMS, une clé d'appairage ou un jeton d'accès complet.
3. Conservez le jeton d'accès uniquement pour la tâche en cours. Privilégiez une variable en mémoire ou une session temporaire protégée et supprimez-la une fois terminé.
4. Arrêtez-vous lorsque la propriété n'est pas claire ou que l'appareil est appairé à un autre compte.
5. Affichez une différence lisible par un humain et obtenez une confirmation explicite avant la demande de mise à jour.
6. Modifiez uniquement les champs approuvés. Préservez les identifiants de modèle actuels et tous les autres champs obligatoires.
7. Relisez le personnage après la sauvegarde. Une réponse d'écriture réussie seule ne constitue pas une vérification suffisante.

Flux de travail

1. Établir la région et le consentement

Demandez si le compte utilise le service Chine continentale ou international :

• Chine continentale : https://webapp.folotoy.cn
• International : https://webapp.folotoy.com

Expliquez que le flux de travail envoie un SMS et modifie la configuration d'un appareil physique. Confirmez que l'utilisateur possède l'appareil ou est autorisé à le gérer.

2. Connexion

Demandez le numéro de téléphone, indicatif du pays compris. Envoyez le code de vérification en utilisant la demande décrite dans la référence API.

Marquez une pause et demandez le code à six chiffres. Ne le devinez pas, ne le récupérez pas d'une autre source et ne continuez pas avant que l'utilisateur ne le fournisse.

Connectez-vous et conservez le jeton porteur renvoyé uniquement pour cette tâche. Si l'authentification échoue, vérifiez l'indicatif du pays et la durée de validité du code. N'envoyez pas de SMS à répétition.

3. Résoudre l'appareil cible

Demandez le SN de l'appareil et vérifiez son état d'appairage.

• S'il est déjà appairé au compte actuel, continuez.
• S'il n'est pas appairé, demandez la clé d'appairage et obtenez une confirmation avant l'appairage.
• S'il est appairé ailleurs, arrêtez-vous et expliquez que le propriétaire actuel doit le désappairer via le flux produit pris en charge.

Lisez les appareils du compte et identifiez la cible exacte par SN. Ne sélectionnez jamais un appareil uniquement parce que son nom d'affichage semble familier.

4. Lire avant de concevoir

Lisez les détails de l'appareil, l'état en ligne, l'ID du produit, le personnage actif et l'objet complet du personnage actuel. Récupérez les modèles TTS disponibles pour le produit et mappez les ID avec des noms vocaux lisibles.

Demandez le public cible, le scénario, la personnalité, le ton, la longueur des réponses, les règles de comportement, les limites de sécurité et la préférence vocale. Si l'utilisateur a une idée vague, proposez une ébauche concise au lieu de bloquer.

5. Prévisualiser la modification

Affichez cet aperçu compact :

Appareil : [SN masqué et nom d'affichage]
Personnage : [nom]

Personnalité :    actuelle -> proposée
Ligne d'ouverture : actuelle -> proposée
Voix :           nom actuel -> nom proposé

Inchangés : modèle STT, modèle LLM, mémoire, réseau, appairage et tous les autres champs

Demandez : Appliquer cette modification à l'appareil FoloToy répertorié ?

Continuez uniquement après une confirmation explicite.

6. Appliquer en toute sécurité

Partez de l'objet complet du personnage renvoyé par le service. Fusionnez uniquement la personnalité, la ligne d'ouverture et l'ID vocal approuvés. Préservez les valeurs obligatoires existantes telles que speech_to_text_id, language_model_id et tous les autres champs spécifiques au produit.

Envoyez l'objet fusionné complet au point de terminaison de mise à jour du personnage. N'envoyez pas une charge utile devinée ou minimale lorsque le service attend la configuration complète.

7. Vérifier et tester

Lisez à nouveau la liste des personnages et comparez les valeurs custom_ability, start_text et text_to_speech_id renvoyées avec la proposition approuvée. Mappez à nouveau l'ID vocal sur son nom lisible.

Vérifiez que l'appareil est en ligne. Demandez à l'utilisateur de démarrer une nouvelle conversation et de tester :

1. La ligne d'ouverture.
2. Un scénario normal dans le personnage.
3. Une limite de sécurité ou d'incertitude.

Si la configuration sauvegardée est correcte mais que le comportement n'a pas changé, vérifiez le personnage actif et démarrez une nouvelle conversation avant de modifier d'autres champs.

8. Rapport et nettoyage

Rapportez le nom du personnage, la ligne d'ouverture finale, le nom vocal final, l'état de relecture, l'état du test physique et une suggestion d'itération suivante. Masquez l'identité de l'appareil et effacez les données d'autorisation temporaires.

Gestion des échecs

• SMS non reçu : vérifiez l'indicatif du pays, attendez le minuteur de renvoi et évitez les envois répétés.
• 401 ou 403 : considérez la session comme expirée et reconnectez-vous. Ne réutilisez pas l'ancien jeton.
• Appairage rejeté : vérifiez le SN et la clé d'appairage ; arrêtez-vous si l'appareil appartient à un autre compte.
• Route vocale introuvable : utilisez le point de terminaison du modèle produit avec mod_type=tts ; ne vous fiez pas aux routes obsolètes /v1/voices.
• Erreur de révision de contenu comme 10500 : raccourcissez et simplifiez le personnage ou la ligne d'ouverture. Conservez la configuration actuelle intacte jusqu'à ce qu'une nouvelle ébauche soit approuvée.
• Sauvegardé mais inaudible : vérifiez le personnage actif, l'état en ligne de l'appareil et une conversation nouvellement démarrée.

Critères d'achèvement

La tâche est terminée uniquement lorsque :

• L'appareil cible a été autorisé et résolu par SN.
• Aucun secret n'a été intégré ou affiché non masqué.
• L'utilisateur a approuvé explicitement la différence affichée.
• Seuls les champs approuvés ont été modifiés.
• La relecture API correspond à la proposition.
• L'utilisateur a reçu un script de test physique, même si l'appareil est temporairement hors ligne.