Referência
Ferramentas
O que um agente pode chamar. O SPREVA lista 49 ferramentas, e as do Studio e das imagens com IA precisam de um plano que inclua o Studio.
Todas as ferramentas
searchBuscar no espaço de trabalho
Encontra publicações, arquivos, campanhas, contas, filas, roteiros, projetos do Studio e estilos, por palavras ou pelo que uma imagem ou um vídeo mostra. Um nome escrito de forma aproximada também é encontrado (maiúsculas, acentos, traços, espaços, sem extensão) e, quando nada corresponde, responde com os nomes mais parecidos.
- Risco
- Baixo
Só leiturafetchLer um item por completo
Lê uma publicação, um arquivo, uma campanha, uma fila, uma conta ou um projeto do Studio a partir do link ou do id, ou uma página da referência do SPREVA.
- Risco
- Baixo
Só leituraoverviewVisão geral do espaço de trabalho
A primeira chamada de uma conversa: o fuso horário e o relógio, o que precisa de atenção, o que sai em seguida, as contas, filas e campanhas e o que o plano permite.
- Risco
- Baixo
Só leituralist_workspacesSeus espaços de trabalho
Lista os espaços de trabalho em que esta conexão pode atuar, com sua função e o fuso horário de cada um, e indica em qual as chamadas são feitas agora.
- Risco
- Baixo
Só leituraswitch_workspaceTrocar de espaço de trabalho
Leva a conversa para outro dos seus espaços de trabalho, por nome ou link, quando a conexão foi permitida em todos. As chamadas seguintes usam as contas, os arquivos e as permissões de agente desse espaço.
- Risco
- Baixo
save_workspaceMudar as configurações do espaço de trabalho
Muda o nome do espaço de trabalho, o fuso horário, o idioma em que as descrições dos arquivos são escritas e se os arquivos novos são descritos automaticamente. O Proprietário e os Administradores podem fazer isso. Um novo fuso horário não muda as publicações já agendadas.
- Risco
- Médio
list_membersAs pessoas do espaço de trabalho
Lista os membros com o e-mail e a função, e os convites ainda pendentes, com a data em que cada link expira.
- Risco
- Baixo
Só leiturainvite_memberConvidar alguém
Convida uma pessoa por e-mail com uma função, sempre depois de uma prévia para confirmar, porque envia um e-mail a ela e pode ocupar uma vaga do plano. Quem já tem uma conta SPREVA nesse endereço entra na hora. O Proprietário e os Administradores podem fazer isso; um Administrador não pode convidar um Proprietário.
- Risco
- Alto
save_postCriar ou editar uma publicação
Escreve uma publicação para uma ou mais contas, com o que muda em cada conta, e define quando ela sai: em um horário, no próximo espaço de uma fila ou como rascunho. Em um espaço de trabalho que exige aprovação, um horário ou uma fila envia a publicação para revisão, e ela sai quando uma pessoa aprovar.
- Risco
- Médio, Alto quando sai em menos de uma hora.
publish_postPublicar uma publicação agora
Publica uma publicação em todas as contas dela, ou de novo só onde falhou. O que já saiu nunca é publicado duas vezes. Em um espaço de trabalho que exige aprovação, uma publicação que ninguém aprovou é recusada: envie para revisão com save_post e um horário ou uma fila.
- Risco
- Alto
delete_postExcluir uma publicação
Remove do SPREVA um rascunho, uma publicação agendada ou uma já publicada. Uma publicação publicada continua no ar nas redes.
- Risco
- Médio, Alto para uma publicação já publicada.
import_mediaImportar um arquivo para a biblioteca
Traz uma imagem ou um vídeo para a biblioteca a partir de um link público ou de bytes que o agente envia.
- Risco
- Médio
update_mediaRenomear, marcar, organizar ou descrever um arquivo da biblioteca
Muda o nome, as tags, a pasta ou o texto alternativo de um arquivo e pode escrever o texto alternativo a partir do que a imagem mostra.
- Risco
- Médio, Alto quando escreve o texto alternativo com IA.
delete_mediaExcluir arquivos da biblioteca
Exclui um ou mais arquivos (imagens, vídeos, áudio) da biblioteca, depois de uma prévia e uma confirmação que mostram onde cada um é usado e o espaço que libera. Arquivos usados por publicações não publicadas ou por projetos do Studio são recusados, a menos que o agente force a exclusão.
- Risco
- Alto
save_campaignCriar ou editar uma campanha
Cria ou muda uma campanha e adiciona ou tira publicações dela.
- Risco
- Médio
save_queueCriar ou editar uma fila
Cria ou muda uma agenda de publicação: o nome, o fuso horário e os espaços semanais.
- Risco
- Médio
analyticsComo as publicações se saíram
Totais em relação ao período anterior, as melhores publicações, a divisão por rede e comparações com o tamanho das amostras, para o espaço de trabalho, uma campanha, uma conta ou uma publicação.
- Risco
- Baixo
Só leiturarefresh_metricsAtualizar os números
Lê agora nas redes os números de uma publicação ou os seguidores de uma conta, sem esperar pelo calendário habitual, e deixa esse calendário como está. A mesma publicação ou conta pode ser atualizada de novo após cinco minutos.
- Risco
- Baixo
list_clippersSeus clipadores e as visualizações deles
As contas associadas ao seu programa de clipadores, ordenadas por visualizações em um período, com a rede, o @handle e o link de cada uma, e primeiro as que esperam a sua decisão.
- Risco
- Baixo
Só leituraclipper_postsAs publicações da conta de um clipador
O que uma conta associada publicou desde que entrou, da mais recente para a mais antiga, com visualizações, links e datas. Aceita o nome, o @handle, o link ou o id da conta.
- Risco
- Baixo
Só leituraclipper_calendarO que seus clipadores têm agendado
As publicações que seus clipadores agendaram no SPREVA para os próximos dias, e as que saíram assim, da mais próxima para a mais distante, com a conta, a rede e o link depois que saem. As publicações feitas direto em uma rede não aparecem aqui.
- Risco
- Baixo
Só leituracreate_videoCriar um vídeo no Studio
Começa um projeto vazio do Studio em um formato, que o agente depois monta. Se já existir um projeto com esse nome, responde com ele em vez de criar uma cópia.
- Risco
- Médio
Precisa de um plano que inclua o Studionarrate_videoNarrar um vídeo do Studio
Dá voz ao roteiro que o agente escreveu e posiciona cada palavra na linha do tempo. Usa créditos de IA, 1 a cada 100 caracteres.
- Risco
- Alto
Precisa de um plano que inclua o Studiocompose_videoCriar um vídeo do Studio a partir de um roteiro em markdown
Cria um vídeo explicativo completo a partir de um roteiro em markdown: o que é dito e o que aparece na tela em cada palavra. A narração ganha voz, o estilo define as cores, as entradas, as transições e os sons, a câmera se aproxima do que entra e são adicionadas legendas e música. O resultado é um projeto normal e editável do Studio. Usa créditos de IA, 1 a cada 100 caracteres de narração, e responde primeiro com uma prévia. Ao reconstruir um projeto com um roteiro alterado, só dá voz de novo se a narração mudou.
- Risco
- Alto
Precisa de um plano que inclua o Studiomatch_mediaCombinar arquivos da biblioteca com um roteiro
Para cada linha de um roteiro, lista os arquivos da biblioteca que combinam melhor com ela, pelo que mostram, pelas palavras que têm, pelo que se fala neles e pela qualidade, com o momento de um clipe que encaixa. Não altera nada nem gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturafind_sfxEncontrar um efeito sonoro pelo que ele faz
Lista os três melhores efeitos sonoros da biblioteca para um momento de um vídeo, por intenção, emoção e energia em vez do nome do arquivo, com o motivo de cada um e o mais suave primeiro. Quando nada serve bem, ou quando for pedido, cria um som novo com o sintetizador do Spreva, salva na biblioteca e lista em primeiro lugar. Não gasta créditos de IA.
- Risco
- Baixo
Precisa de um plano que inclua o Studiofind_musicEncontrar música pelo clima, variando entre vídeos
Lista as três melhores faixas de música da biblioteca para um vídeo, por clima, gênero, energia e o quanto ficam bem sob uma voz em vez do nome do arquivo, com o motivo de cada uma. As faixas usadas pelos vídeos recentes do espaço de trabalho ficam mais abaixo e as que o projeto já tem são deixadas de fora, para que os vídeos não dividam a mesma música. As faixas ainda não classificadas entram na fila de classificação. Não altera nada e não gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturafind_iconEncontrar um ícone pelo que ele significa
Lista os ícones da Lucide que melhor correspondem a algumas palavras em inglês, como phone, security ou growth chart, com as tags deles e a melhor correspondência primeiro, e indica como colocar um em um gráfico animado: o bloco icon, que se desenha sozinho, ou nós de caminho em uma cena bruta. Não altera nada e não gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leituracreate_sfxCriar um efeito sonoro
Cria um efeito sonoro novo com o sintetizador do próprio Spreva, a partir de poucas palavras em inglês ou português, ou de uma receita que o agente escreve para ter controle total. Fica salvo na biblioteca, na pasta “Generated sounds”, e é classificado como qualquer outro som, então pode ser encontrado e colocado em um vídeo. Não gasta créditos de IA.
- Risco
- Médio
Precisa de um plano que inclua o Studioscore_videoCompor a trilha de um vídeo do Studio
Compõe uma trilha instrumental feita sob medida para o vídeo: uma introdução calma, uma subida, o "drop" exatamente na revelação e um final. Ela entra na biblioteca como música e vai por baixo do projeto como fundo, abaixando sob a voz. Usa créditos de IA, 30 a cada 30 segundos de vídeo iniciados, e responde primeiro com uma prévia.
- Risco
- Alto
Precisa de um plano que inclua o Studioplan_editPlanejar a edição de um vídeo do Studio
Lê um vídeo do Studio (o que é dito, os planos e os cortes, o que já está lá) e os sons classificados da biblioteca, escolhe a receita do tipo de vídeo (teoria, lista, notícia, tutorial, anúncio, podcast, vlog, história, melhores momentos) e aplica uma edição completa de uma só vez, como uma única versão salva: cada corte seco ou com uma transição e o seu som, o visual, legendas, um gancho, música que abaixa sob a voz, zooms, texto e B-roll. Recortar o fundo de uma imagem usa créditos de IA, então ela é oferecida e nunca aplicada sozinha. Sem aplicar, não altera nada e só descreve o plano.
- Risco
- Baixo
Precisa de um plano que inclua o Studiofind_momentsEncontrar momentos em um vídeo longo
Mostra o que um vídeo longo diz, frase por frase com os tempos, onde ele fica mais alto, o que a imagem mostra e os clipes que sugere, para o agente escolher as partes que valem o corte. Não altera nada nem gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o Studioread_transcriptLer um arquivo palavra por palavra
Lê a transcrição de um arquivo de vídeo ou áudio como um editor: frases com os tempos e os falantes, hesitações (hum, é) mantidas e marcadas, e os silêncios listados. Vários arquivos podem ser lidos juntos para comparar takes, e um trecho pode ser listado palavra por palavra, com o início e o fim de cada uma. Não altera nada e não gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leituramake_clipsCriar clipes curtos de um vídeo longo
Corta as partes escolhidas de um vídeo longo em projetos verticais curtos do Studio, um por parte, com legendas a partir do que é falado. Cada um é um projeto para editar e exportar.
- Risco
- Médio
Precisa de um plano que inclua o Studioclips_from_linkCriar clipes curtos a partir do link de um vídeo longo
Recebe o link de um vídeo longo (YouTube, Twitch, Kick, Vimeo, X, TikTok ou qualquer página pública), pede que a pessoa confirme que pode usá-lo e inicia um lote que baixa o vídeo, lê o que é dito, encontra os melhores momentos e cria um projeto vertical do Studio de cada um. Responde na hora com o link do lote; o fetch mostra o progresso e depois cada clipe com a pontuação e o motivo. Usa minutos de transcrição e pode usar créditos de IA.
- Risco
- Alto
Precisa de um plano que inclua o Studioedit_videoAlterar um vídeo do Studio
Edita texto, tempos, cortes, imagens, clipes, efeitos e som, e adiciona elementos novos, com as próprias operações de edição do Studio.
- Risco
- Médio
Precisa de um plano que inclua o Studiosave_videoRenomear ou arquivar um projeto do Studio
Renomeia um projeto e/ou o arquiva em uma pasta do Studio, ou o tira da pasta; vários projetos podem ser arquivados de uma vez. Renomear exige a revisão do projeto; arquivar não altera o vídeo. Também pode copiar um projeto para outro dos seus espaços de trabalho: os arquivos são compartilhados com esse espaço somente para leitura e as fontes da marca são adicionadas lá.
- Risco
- Médio
Precisa de um plano que inclua o Studiodelete_videoExcluir projetos do Studio
Exclui um ou mais projetos do Studio, depois de uma prévia e de uma confirmação. Os arquivos exportados deles continuam na biblioteca.
- Risco
- Alto
Precisa de um plano que inclua o Studiopreview_videoVer quadros de um vídeo do Studio
Desenha os quadros nos momentos que o agente indica, exatamente como a exportação vai desenhar, para conferir o que cobre o quê antes de exportar. Não altera nada nem gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturainspect_mediaVer um trecho de um arquivo original
Desenha uma imagem de um trecho de um vídeo ou áudio enviado: quadros distribuídos por igual, a onda do som com as pausas sombreadas e as palavras ditas onde são ditas. Não altera nada nem gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leituracompare_videoComparar duas versões de um vídeo do Studio
Lista o que mudou entre duas versões de um projeto: cada elemento adicionado, removido ou alterado, e o que mudou nele. Também pode mostrar as duas versões no mesmo momento. Não altera nada.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturarestore_videoRestaurar uma versão de um vídeo do Studio
Leva um projeto de volta para uma das versões dele. O resultado fica salvo como uma nova versão, então a restauração também pode ser desfeita.
- Risco
- Médio
Precisa de um plano que inclua o Studioreview_videoRevisar um vídeo do Studio
Verifica um projeto do mesmo jeito que o editor de IA do próprio Studio verifica o trabalho dele e lista o que corrigir, do mais grave para o menos grave. Marca o que a exportação corrige por conta própria.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturarender_videoExportar um vídeo do Studio
Exporta um projeto para um MP4 ou um PNG na biblioteca, pronto para entrar em uma publicação. Antes leva o projeto ao nível mínimo de qualidade por conta própria (legendas, um gancho, a música sob a voz, transições dentro dos limites) e guarda isso como uma versão chamada Quality pass; nunca mexe no que você fez à mão.
- Risco
- Alto
Precisa de um plano que inclua o Studiogenerate_imageGerar uma imagem
Cria uma imagem nova a partir de uma descrição, em um dos estilos do espaço de trabalho se for pedido. Usa 10 créditos de IA. Se o pedido for sobre imagens que a biblioteca já tem, lista elas primeiro e não gasta nada.
- Risco
- Alto
Precisa de um plano que inclua o StudiomascotEscolher a mascote
Lê ou define a mascote do espaço de trabalho: um apresentador em SVG animado que fala, pisca e faz poses num vídeo. Grátis, sem créditos de IA. Escolha uma pronta, pinte com as cores da marca ou use o seu desenho.
- Risco
- Médio
Precisa de um plano que inclua o Studiouse_skillLer as habilidades de edição do espaço de trabalho
Lista as habilidades de edição do espaço de trabalho (os guias de um criador: um visual, um ritmo, uma receita) ou lê uma inteira, para o agente seguir quando cria ou edita um vídeo.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturasave_skillSalvar uma habilidade de edição
Cria, muda, importa de um SKILL.md ou exclui uma habilidade de edição do espaço de trabalho. A descrição decide quando ela é usada.
- Risco
- Médio
Precisa de um plano que inclua o Studio
O caminho de sempre
Um agente começa com overview para ter o fuso horário, o relógio e as contas, encontra itens com search, lê um por completo com fetch e faz alterações com save_post ou outra ferramenta. Toda resposta diz o que dá para fazer em seguida.
Nomes, não ids
As ferramentas recebem o que uma pessoa diria: o nome exato de um arquivo, um @usuário, o nome de uma campanha ou um link para qualquer coisa no SPREVA, colado do navegador ou de uma resposta anterior. A busca é tolerante e a alteração não é: um nome que corresponde a várias coisas volta como uma escolha, e nada é salvo até que uma seja escolhida.
Referência para agentes
Um agente lê a referência do SPREVA com fetch quando precisa, em vez de carregar tudo em cada chamada:
spreva://docs/platforms/tiktok, e uma página por rede: o que ela aceita, tamanhos e opções.spreva://docs/queues: horários, fusos horários e filas.spreva://docs/agent-permissions: níveis de risco, confirmações, revisões e ids de requisição.spreva://docs/studio/makingespreva://docs/studio/editing: como montar um vídeo, só no SPREVA.