Ferramentas, Plugins, Skills, Workflows e Shortcuts na FoneClaw

Escolha o recurso adequado à tarefa

Ferramentas, Plugins, Skills e fluxos da FoneClaw resolvem necessidades diferentes. Quando você quer saber a bateria atual, já existe uma ferramenta para consultar o Android. Quando precisa repetir duas consultas em ordem, um Workflow guarda a sequência. O ponto de partida é a mudança que você espera ver, não a quantidade de recursos que pode combinar.

Na FoneClaw, ferramentas têm ações, resultados, classificações de risco e políticas de aprovação próprias. Um Plugin pode ampliar as capacidades disponíveis, mas não transforma qualquer pedido em uma ação possível. Uma Skill ajuda a escolher e conduzir ações já disponíveis; um Workflow preserva passos; um Shortcut facilita o início. Permissões do Android, parâmetros necessários e aprovações continuam valendo para a ferramenta efetivamente usada.

Também há duas formas de Shortcut. O atalho de pedido envia ao agente o texto definido pelo usuário, cujo título, descrição e comportamento precisam ser confirmados antes de salvar. O atalho de ferramenta direta exige que todas as ações desejadas correspondam a ferramentas conhecidas com parâmetros completos. O primeiro não garante sempre a mesma sequência de ferramentas; o segundo só pode ser criado quando seus passos estão totalmente definidos.

Entenda o que muda ao adicionar Plugin ou Skill

Se a ferramenta necessária não estiver disponível, podemos pesquisar os metadados de Plugins oficiais da FoneClaw. Essa pesquisa informa opções; não baixa nem instala uma extensão. Para uma opção escolhida, a solicitação de instalação cria uma proposta estruturada que o usuário revisa antes de prosseguir. Examine a origem, a capacidade declarada e as dependências da opção apresentada. A presença de um Plugin em uma busca não dispensa essa avaliação.

Uma Skill segue outro caminho. A prévia de um documento SKILL.md verifica seu conteúdo sem salvá-lo. Salvar cria um rascunho desativado; ativar uma Skill válida é uma ação posterior. Também é possível reverter sua ativação. As instruções de uma Skill podem orientar como o agente responde a uma classe de pedidos, mas não concedem permissões do Android nem autorizam ferramentas por conta própria.

Para instalar, ativar e administrar esses componentes no espaço de trabalho, consulte Workspace de plugins e Skills para agentes móveis: instalar com controle. Aqui, a decisão é mais simples: procure um Plugin quando faltar uma capacidade; escolha uma Skill quando a capacidade existir, mas o agente precisar de orientação recorrente. O guia Segurança de habilidades de agentes de IA no celular ajuda a revisar a confiança nas instruções antes de ativá-las.

Uma tarefa com arquivos ilustra por que a escolha importa. Orientar como nomear um resumo cabe em uma Skill; operar arquivos exige uma capacidade apropriada, acesso aos arquivos necessários e revisão da ação. O artigo Plugin de agente gerenciador de arquivos com IA para Android: operações, permissões e aprovação mostra essas verificações no caso de um Plugin de arquivos.

Veja uma sequência curta de consultas ao telefone

Para repetir uma checagem sem alterar configurações, um Workflow pode guardar duas consultas de estado. O campo stepsJson recebe uma lista de etapas; cada etapa indica o nome de uma ferramenta e seus argumentos. Este é apenas um exemplo desse campo, não uma solicitação completa para salvar um Workflow:

[
  {
    "toolName":
    "device_battery_status",
    "arguments": {}
  },
  {
    "toolName":
    "device_memory_status",
    "arguments": {}
  }
]

A primeira ferramenta retorna o estado da bateria e da economia de energia; a segunda retorna informações compactas de memória. Os objetos vazios em arguments indicam que este exemplo não fornece parâmetros adicionais. Ambas são consultas de leitura: executar essa sequência não ajusta bateria nem memória.

Salvar a sequência usa a ação de Workflow da FoneClaw e as aprovações aplicáveis. Depois, confira se o item aparece entre os Workflows salvos. Ao executá-lo, examine separadamente os resultados retornados por cada consulta; um passo salvo não é prova de que ambos foram concluídos. O agendamento é outra configuração: apenas guardar esses passos não define horário de execução. Automações agendadas têm regras próprias de acionamento e tratamento de execuções perdidas.

Se a intenção for apenas começar essa verificação com facilidade, escolha um Shortcut. Um atalho de pedido pode enviar ao agente uma frase como “Mostre o estado da bateria e da memória”, após você confirmar título, descrição e comportamento. Para um atalho de ferramenta direta, as duas consultas precisam estar mapeadas como ações conhecidas com os parâmetros exigidos. Salvar qualquer um desses atalhos não inicia a consulta naquele momento.

Confira as aprovações e resolva uma etapa que falhou

Antes de executar uma rotina, veja se cada ferramenta está habilitada, se o Android concedeu o acesso necessário e qual regra de aprovação está ativa. Na FoneClaw, o modo global e os ajustes por ferramenta determinam a solicitação efetiva; uma orientação da Skill ou um Workflow salvo não substitui esses controles. Se o usuário recusar uma ação, a rotina deve respeitar a decisão.

Quando faltar uma capacidade, confira primeiro a lista de ferramentas e o estado do Plugin correspondente. Se uma Skill não estiver sendo aplicada, verifique se ela passou da prévia ao rascunho e se foi ativada. Se o Android negar acesso, reveja somente a permissão necessária para aquela tarefa. Não é preciso ampliar o acesso do telefone para fazer funcionar uma sequência de consultas simples.

Uma falha de escrita exige outra cautela: confira no aplicativo de destino se a alteração ocorreu antes de repetir o passo. Na sequência de bateria e memória, basta distinguir qual consulta retornou informação e qual falhou; em mensagens, arquivos ou calendário, uma nova tentativa pode duplicar um resultado. A página de recursos da FoneClaw apresenta as capacidades disponíveis, enquanto o resultado de cada execução deve ser conferido no contexto da tarefa.