FoloToy/folotoy-toy-role-config-skill

Configuração de Personagem FoloToy

Configure com segurança um personagem FoloToy e verifique o resultado no dispositivo real.

Leia references/api-workflow.md antes de fazer chamadas de API. Leia references/examples.md quando o usuário precisar de ajuda para criar uma persona ou fala de abertura.

Tarefas suportadas

• Fazer login com um número de telefone e um código SMS de uso único.
• Verificar se um dispositivo autorizado já está emparelhado.
• Emparelhar um dispositivo não emparelhado com seu SN e chave de emparelhamento.
• Ler o dispositivo atual, o personagem ativo e os modelos de voz disponíveis.
• Alterar a persona do personagem, a fala de abertura e a voz.
• Ler o personagem salvo novamente e orientar um teste no dispositivo físico.

Não use esta habilidade para desemparelhar um dispositivo, apagar memória, redefinir rede, excluir uma conta, comprar serviços ou controlar um dispositivo que o usuário não possui ou não tem autorização explícita para gerenciar.

Modelo de segurança

Segredos identificam uma conta ou dispositivo físico. Mantenha-os fora de prompts, arquivos fonte, capturas de tela, URLs, logs persistentes e relatórios finais.

1. Solicite o número de telefone, código SMS, SN e chave de emparelhamento somente quando cada valor for necessário.
2. Não exiba um número de telefone completo, código SMS, chave de emparelhamento ou token de acesso.
3. Mantenha o token de acesso apenas para a tarefa atual. Prefira uma variável em memória ou uma sessão temporária protegida e remova-o quando terminar.
4. Pare quando a propriedade não estiver clara ou o dispositivo estiver emparelhado a outra conta.
5. Mostre um diff legível e obtenha confirmação explícita antes da solicitação de atualização.
6. Altere apenas os campos aprovados. Preserve os IDs dos modelos atuais e todos os outros campos obrigatórios.
7. Leia o personagem novamente após salvar. Uma resposta de escrita bem-sucedida por si só não é verificação suficiente.

Fluxo de trabalho

1. Estabelecer região e consentimento

Pergunte se a conta usa o serviço da China Continental ou internacional:

• China Continental: https://webapp.folotoy.cn
• Internacional: https://webapp.folotoy.com

Explique que o fluxo de trabalho envia um SMS e altera a configuração de um dispositivo físico. Confirme que o usuário possui o dispositivo ou está autorizado a gerenciá-lo.

2. Fazer login

Solicite o número de telefone incluindo o código do país. Envie o código de verificação usando a solicitação documentada na referência da API.

Pare e solicite o código de seis dígitos. Não o adivinhe, recupere de outra fonte ou continue antes que o usuário o forneça.

Faça login e retenha o token de portador retornado apenas para esta tarefa. Se a autenticação falhar, verifique o código do país e a expiração do código. Não envie mensagens SMS repetidamente.

3. Resolver o dispositivo alvo

Solicite o SN do dispositivo e verifique seu estado de emparelhamento.

• Se já estiver emparelhado com a conta atual, continue.
• Se não estiver emparelhado, solicite a chave de emparelhamento e obtenha confirmação antes de emparelhar.
• Se estiver emparelhado em outro lugar, pare e explique que o proprietário atual deve desemparelhá-lo através do fluxo de produto suportado.

Leia os dispositivos da conta e identifique o alvo exato pelo SN. Nunca selecione um dispositivo apenas porque seu nome de exibição parece familiar.

4. Ler antes de criar

Leia os detalhes do dispositivo, estado online, ID do produto, personagem ativo e objeto completo do personagem atual. Busque os modelos TTS disponíveis para o produto e mapeie IDs para nomes de voz legíveis.

Pergunte sobre o público-alvo, cenário, personalidade, tom, comprimento da resposta, regras de comportamento, limites de segurança e preferência de voz. Se o usuário tiver apenas uma ideia vaga, proponha um rascunho conciso em vez de bloquear.

5. Visualizar a alteração

Mostre esta pré-visualização compacta:

Dispositivo: [SN e nome de exibição mascarados]
Personagem: [nome]

Persona:     atual -> proposta
Fala de abertura: atual -> proposta
Voz:        nome atual -> nome proposto

Inalterado: modelo STT, modelo LLM, memória, rede, emparelhamento e todos os outros campos

Pergunte: Aplicar esta alteração ao dispositivo FoloToy listado?

Continue somente após uma confirmação explícita.

6. Aplicar com segurança

Comece a partir do objeto completo do personagem retornado pelo serviço. Mescle apenas a persona, fala de abertura e ID de voz aprovados. Preserve valores obrigatórios existentes como speech_to_text_id, language_model_id e todos os outros campos específicos do produto.

Envie o objeto completo mesclado para o endpoint de atualização do personagem. Não envie um payload adivinhado ou mínimo quando o serviço espera a configuração completa.

7. Verificar e testar

Leia a lista de personagens novamente e compare o custom_ability, start_text e text_to_speech_id retornados com a proposta aprovada. Mapeie o ID da voz de volta para seu nome legível.

Verifique se o dispositivo está online. Peça ao usuário para iniciar uma nova conversa e testar:

1. A fala de abertura.
2. Um cenário normal dentro do personagem.
3. Um limite de segurança ou incerteza.

Se a configuração salva estiver correta, mas o comportamento não mudou, verifique o personagem ativo e inicie uma nova conversa antes de alterar mais campos.

8. Relatar e limpar

Relate o nome do personagem, fala de abertura final, nome da voz final, status de leitura, status do teste físico e uma próxima iteração sugerida. Masque a identidade do dispositivo e limpe dados de autorização temporários.

Tratamento de falhas

• SMS não recebido: verifique o código do país, aguarde o temporizador de reenvio e evite envios repetidos.
• 401 ou 403: trate a sessão como expirada e faça login novamente. Não reutilize o token antigo.
• Emparelhamento rejeitado: verifique o SN e a chave de emparelhamento; pare se o dispositivo pertencer a outra conta.
• Rota de voz não encontrada: use o endpoint do modelo do produto com mod_type=tts; não confie em rotas legadas /v1/voices.
• Erro de revisão de conteúdo como 10500: encurte e simplifique a persona ou fala de abertura. Mantenha a configuração atual intacta até que um novo rascunho seja aprovado.
• Salvo, mas não audível: verifique o personagem ativo, estado online do dispositivo e uma conversa recém-iniciada.

Critérios de conclusão

A tarefa está completa somente quando:

• O dispositivo alvo foi autorizado e resolvido pelo SN.
• Nenhum segredo foi incorporado ou exibido sem máscara.
• O usuário aprovou explicitamente o diff exibido.
• Apenas campos aprovados foram alterados.
• A leitura da API corresponde à proposta.
• O usuário recebeu um script de teste físico, mesmo que o dispositivo esteja temporariamente offline.