FoloToy/folotoy-toy-role-config-skill

FoloToy-Charakter-Konfiguration

Konfiguriere sicher einen FoloToy-Charakter und überprüfe das Ergebnis auf dem echten Gerät.

Lies references/api-workflow.md, bevor du API-Aufrufe tätigst. Lies references/examples.md, wenn der Benutzer Hilfe beim Entwerfen einer Persona oder eines Eröffnungssatzes benötigt.

Unterstützte Aufgaben

• Anmelden mit einer Telefonnummer und einem einmaligen SMS-Code.
• Überprüfen, ob ein autorisiertes Gerät bereits gekoppelt ist.
• Koppeln eines ungekoppelten Geräts mit seiner Seriennummer (SN) und dem Pairing-Key.
• Lesen des aktuellen Geräts, des aktiven Charakters und der verfügbaren Sprachmodelle.
• Ändern der Charakter-Persona, des Eröffnungssatzes und der Stimme.
• Rücklesen des gespeicherten Charakters und Anleiten eines physischen Gerätetests.

Verwende diesen Skill nicht, um ein Gerät zu entkoppeln, Speicher zu löschen, Netzwerkeinstellungen zurückzusetzen, ein Konto zu löschen, Dienste zu kaufen oder ein Gerät zu steuern, das dem Benutzer nicht gehört oder für das er keine ausdrückliche Berechtigung hat.

Sicherheitsmodell

Geheimnisse identifizieren ein Konto oder ein physisches Gerät. Halte sie aus Prompts, Quelldateien, Screenshots, URLs, persistenten Logs und endgültigen Berichten heraus.

1. Frage nach Telefonnummer, SMS-Code, SN und Pairing-Key nur dann, wenn der jeweilige Wert benötigt wird.
2. Gib keine vollständige Telefonnummer, keinen vollständigen SMS-Code, keinen vollständigen Pairing-Key und keinen vollständigen Zugriffstoken wieder.
3. Behalte den Zugriffstoken nur für die aktuelle Aufgabe. Bevorzuge eine In-Memory-Variable oder eine geschützte temporäre Sitzung und entferne ihn, wenn die Aufgabe abgeschlossen ist.
4. Stoppe, wenn die Eigentumsverhältnisse unklar sind oder das Gerät mit einem anderen Konto gekoppelt ist.
5. Zeige einen menschenlesbaren Diff an und hole eine ausdrückliche Bestätigung ein, bevor die Aktualisierungsanfrage gesendet wird.
6. Ändere nur die genehmigten Felder. Bewahre die aktuellen Modell-IDs und alle anderen erforderlichen Felder.
7. Lies den Charakter nach dem Speichern zurück. Eine erfolgreiche Schreibantwort allein ist keine ausreichende Verifizierung.

Arbeitsablauf

1. Region und Zustimmung festlegen

Frage, ob das Konto den Festland-China-Dienst oder den internationalen Dienst verwendet:

• Festland-China: https://webapp.folotoy.cn
• International: https://webapp.folotoy.com

Erkläre, dass der Arbeitsablauf eine SMS sendet und die Konfiguration eines physischen Geräts ändert. Bestätige, dass der Benutzer das Gerät besitzt oder zur Verwaltung berechtigt ist.

2. Anmelden

Frage nach der Telefonnummer inklusive Ländervorwahl. Sende den Bestätigungscode mit der in der API-Referenz dokumentierten Anfrage.

Halte inne und frage nach dem sechsstelligen Code. Rate ihn nicht, rufe ihn nicht aus einer anderen Quelle ab und fahre nicht fort, bevor der Benutzer ihn bereitstellt.

Melde dich an und behalte das zurückgegebene Bearer-Token nur für diese Aufgabe. Wenn die Authentifizierung fehlschlägt, überprüfe die Ländervorwahl und die Gültigkeit des Codes. Sende nicht wiederholt SMS-Nachrichten.

3. Zielgerät ermitteln

Frage nach der Geräte-SN und überprüfe den Kopplungsstatus.

• Wenn es bereits mit dem aktuellen Konto gekoppelt ist, fahre fort.
• Wenn es nicht gekoppelt ist, frage nach dem Pairing-Key und hole die Bestätigung ein, bevor du koppelst.
• Wenn es anderweitig gekoppelt ist, stoppe und erkläre, dass der aktuelle Besitzer es über den unterstützten Produktablauf entkoppeln muss.

Lese die Kontogeräte und identifiziere das genaue Ziel anhand der SN. Wähle niemals ein Gerät nur, weil sein Anzeigename vertraut aussieht.

4. Vor dem Entwurf lesen

Lese die Gerätedetails, den Online-Status, die Produkt-ID, den aktiven Charakter und das vollständige aktuelle Charakterobjekt. Rufe die verfügbaren TTS-Modelle für das Produkt ab und ordne die IDs lesbaren Stimmnamen zu.

Frage nach der Zielgruppe, dem Szenario, der Persönlichkeit, dem Ton, der Antwortlänge, den Verhaltensregeln, den Sicherheitsgrenzen und der Stimmpräferenz. Wenn der Benutzer nur eine grobe Idee hat, schlage einen prägnanten Entwurf vor, anstatt zu blockieren.

5. Änderung in der Vorschau anzeigen

Zeige diese kompakte Vorschau:

Gerät: [maskierte SN und Anzeigename]
Charakter: [Name]

Persona:      aktuell -> vorgeschlagen
Eröffnungssatz: aktuell -> vorgeschlagen
Stimme:       aktueller Name -> vorgeschlagener Name

Unverändert: STT-Modell, LLM-Modell, Speicher, Netzwerk, Kopplung und alle anderen Felder

Frage: Diese Änderung auf das aufgeführte FoloToy-Gerät anwenden?

Fahre erst nach einer ausdrücklichen Bestätigung fort.

6. Sicher anwenden

Beginne mit dem vollständigen Charakterobjekt, das vom Dienst zurückgegeben wurde. Führe nur die genehmigte Persona, den Eröffnungssatz und die Stimm-ID zusammen. Bewahre vorhandene erforderliche Werte wie speech_to_text_id, language_model_id und alle anderen produktspezifischen Felder.

Sende das vollständig zusammengeführte Objekt an den Endpunkt zur Charakteraktualisierung. Sende keine erratene oder minimale Nutzlast, wenn der Dienst die vollständige Konfiguration erwartet.

7. Verifizieren und testen

Lese die Charakterliste erneut und vergleiche die zurückgegebenen Werte custom_ability, start_text und text_to_speech_id mit dem genehmigten Vorschlag. Ordne die Stimm-ID wieder ihrem lesbaren Namen zu.

Überprüfe, ob das Gerät online ist. Bitte den Benutzer, ein neues Gespräch zu beginnen und Folgendes zu testen:

1. Den Eröffnungssatz.
2. Ein normales, charakterkonformes Szenario.
3. Eine Sicherheits- oder Unsicherheitsgrenze.

Wenn die gespeicherte Konfiguration korrekt ist, sich das Verhalten jedoch nicht geändert hat, überprüfe den aktiven Charakter und beginne ein neues Gespräch, bevor du weitere Felder änderst.

8. Bericht und Bereinigung

Berichte den Charakternamen, den endgültigen Eröffnungssatz, den endgültigen Stimmnamen, den Rücklesestatus, den Status des physischen Tests und eine vorgeschlagene nächste Iteration. Maskiere die Geräteidentität und lösche die temporären Autorisierungsdaten.

Fehlerbehandlung

• SMS nicht erhalten: Überprüfe die Ländervorwahl, warte auf den Wiederholungs-Timer und vermeide wiederholtes Senden.
• 401 oder 403: Behandle die Sitzung als abgelaufen und melde dich erneut an. Verwende das alte Token nicht wieder.
• Kopplung abgelehnt: Überprüfe die SN und den Pairing-Key; stoppe, wenn das Gerät zu einem anderen Konto gehört.
• Sprachroute nicht gefunden: Verwende den Produktmodell-Endpunkt mit mod_type=tts; verlasse dich nicht auf veraltete /v1/voices-Routen.
• Inhaltsprüfungsfehler wie 10500: Kürze und vereinfache die Persona oder den Eröffnungssatz. Behalte die aktuelle Konfiguration bei, bis ein neuer Entwurf genehmigt ist.
• Gespeichert, aber nicht hörbar: Überprüfe den aktiven Charakter, den Online-Status des Geräts und ein neu gestartetes Gespräch.

Abschlusskriterien

Die Aufgabe ist nur dann abgeschlossen, wenn:

• Das Zielgerät autorisiert und anhand der SN ermittelt wurde.
• Kein Geheimnis eingebettet oder unmaskiert angezeigt wurde.
• Der Benutzer den angezeigten Diff ausdrücklich genehmigt hat.
• Nur genehmigte Felder geändert wurden.
• Der API-Rücklesewert mit dem Vorschlag übereinstimmt.
• Der Benutzer ein physisches Testskript erhalten hat, auch wenn das Gerät vorübergehend offline ist.