Assistente de IA

O Assistente de IA permite descrever o trabalho em linguagem comum e deixar o TikMatrix enfileirá-lo para você. Ele lê seus dispositivos, contas e histórico de tarefas, mostra exatamente o que criaria e espera sua aprovação antes de gravar qualquer coisa.

Requer Pro

O assistente está disponível no plano Pro ou superior, o mesmo requisito da API local de automação.

O que é (e o que não é)

O assistente não toca nos seus telefones diretamente. Ele trabalha como você: olha o que você tem e então enfileira tarefas, que o executor de tarefas normal pega e roda. Tudo o que ele cria aparece na lista de tarefas como qualquer outra, marcado com a origem assistant.

Ele também não pode gravar nada por conta própria. Toda ação que muda estado interrompe a conversa e pergunta antes — veja Nada roda sem a sua aprovação.

Configuração

O modelo é você quem fornece. O TikMatrix não traz um e não intermedeia suas requisições — o app fala com o endpoint que você configurar, direto da sua máquina.

1. Clique em Assistente na barra de navegação à esquerda.
2. Clique em Configurações do modelo.
3. Preencha:

Campo	O que colocar
Endpoint	A URL completa de chat-completions, ex.: https://api.openai.com/v1/chat/completions
Modelo	O id do modelo, ex.: gpt-4o ou claude-sonnet-4-5
Chave de API	Sua chave para esse provedor
Formato da API	Deixe em Detectar pelo endpoint, a menos que ele erre
Limite de tarefas por confirmação	O máximo de tarefas que uma aprovação pode criar (padrão 200)

4. Clique em Salvar.

A linha de status no topo do painel mostra o modelo em uso assim que as configurações são aceitas, então dá para ver de relance para qual endpoint a conversa vai.

Quais endpoints funcionam

Dois formatos são suportados:

• Compatível com OpenAI — qualquer endpoint que fale POST /v1/chat/completions. Isso cobre a própria OpenAI e a maioria dos servidores auto-hospedados: vLLM, LocalAI, a camada compatível com OpenAI do Ollama, DeepSeek, OpenRouter e similares.
• Anthropic — endpoints que falam POST /v1/messages.

Formato da API normalmente fica em Detectar pelo endpoint: uma URL contendo api.anthropic.com ou /v1/messages é tratada como Anthropic, o resto como compatível com OpenAI. Defina explicitamente só quando você usa um proxy cuja URL não revela o dialeto.

Escolha um modelo que saiba usar ferramentas

O assistente funciona inteiramente por chamadas de ferramentas. Um modelo sem suporte confiável a ferramentas vai conversar com você, mas nunca conseguirá planejar nada.

Como escolher um modelo

Se você quer	Use
O planejamento mais confiável, com menos babá	Um modelo de topo atual da OpenAI ou da Anthropic
Menor custo no trabalho rotineiro de "enfileira isso no rack inteiro"	Um modelo intermediário dos mesmos provedores
Nada saindo da sua máquina	Um servidor local (Ollama, vLLM, LocalAI) com um modelo sólido em chamadas de ferramentas

Modelos locais pequenos são a causa comum de "ele conversa mas nunca planeja". Antes de concluir que o assistente está quebrado, tente a mesma solicitação uma vez contra um modelo hospedado — se lá funcionar, o problema era o modelo, não a configuração.

Onde as configurações ficam

Seu endpoint e sua chave são gravados em assistant_settings.json, no diretório de dados do app, e lidos pelo backend na hora de fazer a requisição. Eles não são enviados a lugar nenhum além do endpoint que você configurou.

Uma configuração existe apenas nesse arquivo: max_tokens, o orçamento de resposta enviado ao modelo. O padrão é 8192, limitado à faixa 1024–64000. Aumente à mão se respostas longas estiverem sendo cortadas.

Pedindo trabalho

Escreva o que você quer em linguagem comum. Alguns exemplos:

• Aqueça todas as contas por 20 minutos
• Por que minhas últimas tarefas falharam?
• Publique em todos os dispositivos amanhã às 09:00
• Siga estas cinco contas pelos telefones do grupo Marketing

Uma solicitação normalmente passa por três etapas:

1. Ele consulta. Quais dispositivos estão on-line, quais contas estão logadas, quais parâmetros o script aceita.
2. Ele planeja. Calcula exatamente quantas tarefas a solicitação produz e mostra os totais — quantas tarefas, em quantos dispositivos e contas.
3. Você confirma. Só então as tarefas são gravadas.

Se uma solicitação for ambígua de um jeito que muda quantas tarefas serão criadas, o assistente pergunta em vez de adivinhar.

Como é uma solicitação do início ao fim

Você: aqueça todas as contas logadas por 20 minutos, começando amanhã às 9

Assistente: (chama get_script_schema, list_devices, list_accounts e então plan_tasks) 34 tarefas de aquecimento em 12 dispositivos e 34 contas, 20 minutos cada, começando em 2026-08-27 09:00. Duas contas não estão logadas e ficaram de fora.

Aparece um cartão de confirmação listando cada linha que ele vai criar — dispositivo, conta e alvo quando o script aceita um — mais o script_config exato que será gravado. Você aperta Confirmar e 34 tarefas aparecem na lista.

Dizendo quando

Tarefas podem ser enfileiradas para depois: mencione um horário e o assistente o coloca no plano como horário de início da tarefa, que o cartão mostra antes de você aprovar. Essa também é a resposta certa quando a solicitação é grande — espalhar os follows de um rack inteiro ao longo do dia parece bem menos automatizado do que disparar tudo de uma vez, e o assistente sugere isso por conta própria em pedidos que pareçam arriscados.

Em builds que dirigem os dois apps

Um build do TikMatrix configurado para TikTok e Instagram não vai adivinhar a qual você se refere, e nem tenta — uma solicitação sem plataforma volta perguntando. Diga "publique no TikTok no grupo Marketing" em vez de "publique no grupo Marketing" e ele vai direto ao planejamento. Builds de plataforma única nunca perguntam.

Nada roda sem a sua aprovação

Isso é imposto no código, não pedindo educadamente ao modelo.

Quando o assistente vai fazer algo que muda estado, a conversa para e aparece um cartão de confirmação mostrando o que está prestes a acontecer. A chamada só roda depois que você aperta o botão de confirmar.

Quatro ações são protegidas assim:

Ação	O que faz
create_tasks	Enfileira as tarefas planejadas
stop_task	Para uma tarefa em execução
retry_task	Reenfileira uma tarefa que falhou
create_custom_script	Grava e registra um novo arquivo de script

A criação de tarefas tem uma segunda tranca em cima disso: o botão de confirmar só pode executar o plano que foi mostrado a você. O assistente não consegue revisar os parâmetros entre a prévia e a sua aprovação — um plano é de uso único e expira depois de 15 minutos, então uma prévia da qual você se afastou não pode ser confirmada mais tarde contra uma lista de dispositivos que já mudou.

O cartão também não é um resumo escrito pelo modelo. Ele desenha as linhas reais do plano e o script_config real, então o que você aprova é o que é gravado.

Recusar é uma resposta normal, não um erro: o modelo é informado de que você disse não e pode oferecer outra coisa em vez de repetir a mesma chamada.

O teto de tarefas

Uma confirmação pode criar no máximo 200 tarefas por padrão. É um freio contra uma solicitação mal interpretada — evitar que "aqueça minhas contas" vire mil tarefas que você descobre de manhã. Execuções maiores continuam possíveis: o assistente as divide em lotes que você confirma um de cada vez.

Você pode mudar o limite em Configurações do modelo → Limite de tarefas por confirmação. Valores acima de 2000 são cortados.

O que o assistente consegue ver

Isto ele usa livremente, sem perguntar:

Ferramenta	O que lê
list_devices	Dispositivos conectados, se estão on-line ou ocupados, grupos a que pertencem
list_accounts	Contas, o dispositivo de cada uma e se está logada
list_groups	Grupos de dispositivos e seus tamanhos
get_script_schema	Todos os scripts que este build roda e os parâmetros exatos de cada um
list_tasks	A lista de tarefas, filtrável por status, dispositivo ou script
get_task_log	O log de uma tarefa — normalmente onde a falha se explica
get_activity_log	Atividade recente das contas
device_screenshot	O que está na tela de um dispositivo agora
list_custom_scripts	Seus scripts personalizados registrados
get_custom_script_guide	Como escrever um script personalizado
plan_tasks	Calcula o que uma solicitação criaria, sem criar

Capturas de tela vão para o seu provedor de modelo

device_screenshot envia uma imagem da tela do telefone ao endpoint que você configurou. Se uma tela pode mostrar algo que você preferiria não enviar a um provedor externo, evite pedir capturas ou aponte o assistente para um modelo hospedado por você.

O que sai da sua máquina

Tudo o que o assistente lê é enviado ao seu endpoint de modelo como parte da conversa — é assim que o modelo enxerga. Na prática isso significa números de série de dispositivos e nomes de grupos, nomes de usuário das contas e seu estado de login, linhas de tarefas e logs de tarefas, e qualquer captura de tela que você pedir. Chaves de API, credenciais de proxy e senhas de contas não estão entre as coisas que ele pode ler, então nunca aparecem no payload.

Se essa lista for mais do que você quer entregar a um provedor externo, aponte o endpoint para um modelo que você mesmo roda; nada mais muda no recurso.

Escrevendo scripts personalizados

Se nenhum script integrado cobre o que você precisa, o assistente pode escrever um. Descreva o trabalho em linguagem comum; ele lê o guia de scripting, redige um programa e mostra a você.

O cartão de confirmação desta ação deixa isso explícito: o script é gravado em disco e registrado para poder ser executado como qualquer integrado. Leia antes de aprovar. Os scripts vão para uma pasta assistant_scripts no diretório de dados do app, então tudo o que ele escreveu pode ser auditado, editado ou apagado em um só lugar.

Alguns limites que o app impõe ao que o modelo propõe:

• Só podem ser registrados como interpretador python, python3, node, bun e deno — nada que rode um shell com uma carga logo depois.
• O nome do arquivo tem que ser um nome simples: sem separadores de caminho, sem .., sem ponto inicial, no máximo 64 caracteres.
• O código-fonte é limitado a 200 KB e a plataforma tem que ser generic, tiktok ou instagram.

A partir daí, um script registrado é um script personalizado comum: você pode abri-lo em Dispositivos → Scripts personalizados, editar o comando, mudar o tempo limite ou desabilitá-lo. Veja Scripts personalizados para o que um script pode fazer depois de registrado.

Limites que vale conhecer

• Uma solicitação, doze passos. Se o assistente não terminar em doze chamadas de ferramenta, ele para e relata o que ficou sem resolver, em vez de gastar seus tokens em um laço.
• A conversa não é um arquivo histórico. Ela vive na memória — as oito conversas mais recentes e os últimos 120 turnos de cada uma — e se perde quando o app reinicia. O que vale a pena guardar acaba virando tarefa, e tarefas ficam no banco de dados.
• Sair da tela é seguro. A conversa e qualquer confirmação pendente são restauradas quando você volta.
• Parar encerra o laço no próximo ponto de verificação. Não dá para interromper uma chamada ao modelo já em voo, então o passo atual termina primeiro.
• Os tokens são pagos por você. Cada requisição carrega o catálogo de scripts e a conversa até ali, então uma conversa longa custa mais por mensagem do que uma nova. Para um trabalho sem relação, começar uma conversa nova sai mais barato do que continuar uma antiga.

Solução de problemas

API access requires Pro or higher plan Sua licença é Starter ou está inativa. Verifique Configurações → Licença.

The app is still starting up. Try again in a moment. O painel abriu antes de os serviços de segundo plano terminarem de subir. Espere alguns segundos e envie de novo.

No model endpoint configured / No API key configured / No model configured Abra Configurações do modelo e preencha os três: endpoint, modelo e chave de API.

Could not reach the model endpoint O app não conseguiu abrir uma conexão. Confira a URL e se um endpoint local está de fato escutando naquela porta.

O modelo responde mas nunca planeja nada Provavelmente ele não está chamando ferramentas. Tente um modelo com bom suporte a uso de ferramentas e confira se Formato da API bate com o dialeto do seu endpoint.

Toda resposta vem cortada Alguns servidores compatíveis com OpenAI limitam bastante a saída por padrão. Aumente o limite no servidor ou aumente max_tokens em assistant_settings.json.

Ele fica perguntando qual plataforma Este build dirige TikTok e Instagram. Diga qual você quer na solicitação.

Um cartão de confirmação não confirma Planos expiram em 15 minutos. Peça a mesma coisa de novo para obter um novo.

As tarefas foram criadas mas nada roda Provavelmente o Auto WakeUp Agent está desligado — o assistente avisa sobre isso antes de você confirmar. Religue em Configurações.

Próximos passos

• Scripts personalizados — escreva e registre automação que os scripts integrados não cobrem
• Visão geral da API local — controle a mesma fila de tarefas pelos seus próprios programas
• Configurações de tarefas — como as tarefas enfileiradas são pegas e executadas