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
searchPesquisar na área de trabalho
Encontra publicações, ficheiros, campanhas, contas, filas, guiões, 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 elemento na íntegra
Lê uma publicação, um ficheiro, uma campanha, uma fila, uma conta ou um projeto do Studio a partir da ligação ou do id, ou uma página da referência do SPREVA.
- Risco
- Baixo
Só leituraoverviewVisão geral da área de trabalho
A primeira chamada de uma conversa: o fuso horário e a hora, o que precisa de atenção, o que sai a seguir, as contas, filas e campanhas, e o que o plano permite.
- Risco
- Baixo
Só leituralist_workspacesAs suas áreas de trabalho
Lista as áreas de trabalho em que esta ligação pode atuar, com a sua função e o fuso horário de cada uma, e indica em qual são feitas agora as chamadas.
- Risco
- Baixo
Só leituraswitch_workspaceMudar de área de trabalho
Passa a conversa para outra das suas áreas de trabalho, por nome ou ligação, quando a ligação foi permitida em todas. As chamadas seguintes usam as contas, os ficheiros e as permissões de agente dessa área.
- Risco
- Baixo
save_workspaceAlterar as definições da área de trabalho
Muda o nome da área de trabalho, o fuso horário, o idioma em que são escritas as descrições dos ficheiros e se os ficheiros novos são descritos automaticamente. Podem fazê-lo o Proprietário e os Administradores. Um novo fuso horário não mexe nas publicações já agendadas.
- Risco
- Médio
list_membersAs pessoas da área de trabalho
Lista os membros com o email e a função, e os convites ainda pendentes, com a data em que cada ligação expira.
- Risco
- Baixo
Só leiturainvite_memberConvidar alguém
Convida uma pessoa por email com uma função, sempre depois de uma pré-visualização a confirmar, porque lhe envia um email e pode ocupar um lugar do plano. Quem já tem uma conta SPREVA nesse endereço entra de imediato. Podem fazê-lo o Proprietário e os Administradores; 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 sai: a uma hora, no próximo espaço de uma fila ou como rascunho. Numa área de trabalho que exige aprovação, uma hora ou uma fila envia-a para revisão, e sai quando uma pessoa a aprovar.
- Risco
- Médio, Alto quando sai em menos de uma hora.
publish_postPublicar uma publicação de imediato
Publica uma publicação em todas as suas contas, ou de novo só onde falhou. O que já saiu nunca é publicado duas vezes. Numa área de trabalho que exige aprovação, uma publicação que ninguém aprovou é recusada: envie-a para revisão com save_post e uma hora ou uma fila.
- Risco
- Alto
delete_postEliminar uma publicação
Remove do SPREVA um rascunho, uma publicação agendada ou uma já publicada. Uma publicação já publicada continua visível nas redes.
- Risco
- Médio, Alto para uma publicação já publicada.
import_mediaImportar um ficheiro para a biblioteca
Traz uma imagem ou um vídeo para a biblioteca a partir de uma ligação pública ou de bytes que o agente carrega.
- Risco
- Médio
update_mediaMudar o nome, etiquetar, mover para uma pasta ou descrever um ficheiro da biblioteca
Altera o nome, as etiquetas, a pasta ou o texto alternativo de um ficheiro, 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_mediaEliminar ficheiros da biblioteca
Elimina um ou mais ficheiros (imagens, vídeos, áudio) da biblioteca, depois de uma pré-visualização e de uma confirmação que mostram onde cada um é usado e o espaço que liberta. Os ficheiros usados por publicações ainda não publicadas ou por projetos do Studio são recusados, a menos que o agente force a eliminação.
- Risco
- Alto
save_campaignCriar ou editar uma campanha
Cria ou altera uma campanha e adiciona-lhe publicações ou retira-as.
- Risco
- Médio
save_queueCriar ou editar uma fila
Cria ou altera um horário de publicação: o nome, o fuso horário e os espaços semanais.
- Risco
- Médio
analyticsComo correram as publicações
Totais comparados com o período anterior, as melhores publicações, a divisão por rede e comparações com a dimensão das amostras, para a área de trabalho, uma campanha, uma conta ou uma publicação.
- Risco
- Baixo
Só leiturarefresh_metricsActualizar 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 actualizada de novo passados cinco minutos.
- Risco
- Baixo
list_clippersOs seus clippers e as suas visualizações
As contas associadas ao seu programa de clippers, ordenadas por visualizações num período, com a rede, o @handle e a ligação de cada uma, e primeiro as que esperam a sua decisão.
- Risco
- Baixo
Só leituraclipper_postsAs publicações da conta de um clipper
O que uma conta associada publicou desde que aderiu, da mais recente para a mais antiga, com visualizações, ligações e datas. Aceita o nome, o @handle, a ligação ou o id da conta.
- Risco
- Baixo
Só leituraclipper_calendarO que os seus clippers têm agendado
As publicações que os seus clippers 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 a ligação depois de saírem. As publicações feitas diretamente numa rede não aparecem aqui.
- Risco
- Baixo
Só leituracreate_videoCriar um vídeo no Studio
Inicia um projeto vazio do Studio num formato, que o agente depois constrói. Se já existir um projeto com esse nome, responde com esse 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 coloca cada palavra na linha de tempo. Usa créditos de IA, 1 por 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
Constrói um vídeo explicativo completo a partir de um roteiro em markdown: o que se diz e o que aparece no ecrã em cada palavra. A narração ganha voz, o estilo define as cores, as entradas, as transições e os sons, a câmara aproxima-se do que entra e juntam-se legendas e música. O resultado é um projeto normal e editável do Studio. Usa créditos de IA, 1 por cada 100 caracteres de narração, e responde primeiro com uma pré-visualização. Ao reconstruir um projeto com um roteiro alterado, só volta a dar voz se a narração tiver mudado.
- Risco
- Alto
Precisa de um plano que inclua o Studiomatch_mediaAssociar ficheiros da biblioteca a um guião
Para cada linha de um guião, lista os ficheiros da biblioteca que melhor lhe correspondem, pelo que mostram, pelas palavras que têm, pelo que se diz neles e pela qualidade, com o momento de um clip 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 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 ficheiro, com o motivo de cada um e o mais suave primeiro. Quando nada serve bem, ou quando é pedido, cria um som novo com o sintetizador do Spreva, guarda-o na biblioteca e lista-o em primeiro lugar. Não gasta créditos de IA.
- Risco
- Baixo
Precisa de um plano que inclua o Studiofind_musicEncontrar música pelo ambiente, variando entre vídeos
Lista as três melhores faixas de música da biblioteca para um vídeo, por ambiente, género, energia e pelo quão bem ficam sob uma voz em vez do nome do ficheiro, 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 postas de parte, para que os vídeos não partilhem 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 significa
Lista os ícones da Lucide que melhor correspondem a algumas palavras em inglês, como phone, security ou growth chart, com as suas etiquetas e a melhor correspondência primeiro, e indica como colocar um num gráfico animado: o bloco icon, que se desenha sozinho, ou nós de caminho numa cena em bruto. 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 controlo total. Fica guardado na biblioteca, na pasta “Generated sounds”, e é classificado como qualquer outro som, por isso pode ser encontrado e colocado num vídeo. Não gasta créditos de IA.
- Risco
- Médio
Precisa de um plano que inclua o Studioscore_videoCompor a música de um vídeo do Studio
Compõe música instrumental feita à medida do vídeo: uma introdução calma, uma subida, o "drop" exatamente na revelação e um final. Fica na biblioteca como música e vai por baixo do projeto como fundo, baixando sob a voz. Usa créditos de IA, 30 por cada 30 segundos de vídeo iniciados, e responde primeiro com uma pré-visualização.
- Risco
- Alto
Precisa de um plano que inclua o Studioplan_editPlanear a edição de um vídeo do Studio
Lê um vídeo do Studio (o que se diz, os planos e os cortes, o que já lá está) 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 guardada: cada corte seco ou com uma transição e o seu som, o visual, legendas, um gancho, música que baixa sob a voz, zooms, texto e B-roll. Recortar o fundo de uma imagem usa créditos de IA, por isso é oferecido e nunca aplicado sozinho. Sem aplicar, não altera nada e só descreve o plano.
- Risco
- Baixo
Precisa de um plano que inclua o Studiofind_momentsEncontrar momentos num vídeo longo
Mostra o que um vídeo longo diz, frase a frase com os tempos, onde fica mais alto, o que a imagem mostra e os clips que sugere, para o agente escolher as partes que vale a pena cortar. Não altera nada nem gasta nada.
- Risco
- Baixo
Precisa de um plano que inclua o Studioread_transcriptLer um ficheiro palavra a palavra
Lê a transcrição de um ficheiro 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. Podem ler-se vários ficheiros em conjunto para comparar takes, e um intervalo pode ser listado palavra a 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 clips curtos a partir 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 é dito. Cada um é um projeto para editar e exportar.
- Risco
- Médio
Precisa de um plano que inclua o Studioclips_from_linkCriar clips 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 à pessoa que confirme que o pode usar e inicia um lote que o descarrega, lê o que é dito, encontra os melhores momentos e cria um projeto vertical do Studio de cada um. Responde logo com o link do lote; o fetch mostra o progresso e depois cada clip com a sua 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, clips, efeitos e som, e adiciona novos elementos, com as próprias operações de edição do Studio.
- Risco
- Médio
Precisa de um plano que inclua o Studiosave_videoMudar o nome ou arquivar um projeto do Studio
Muda o nome de um projeto e/ou arquiva-o numa pasta do Studio, ou tira-o da pasta; vários projetos podem ser arquivados de uma vez. Mudar o nome exige a revisão do projeto; arquivar não altera o vídeo. Também pode copiar um projeto para outra das suas áreas de trabalho: os ficheiros são partilhados com essa área só para leitura e os tipos de letra da marca são lá adicionados.
- Risco
- Médio
Precisa de um plano que inclua o Studiodelete_videoEliminar projetos do Studio
Elimina um ou mais projetos do Studio, depois de uma pré-visualização e de uma confirmação. Os ficheiros exportados deles ficam na biblioteca.
- Risco
- Alto
Precisa de um plano que inclua o Studiopreview_videoVer fotogramas de um vídeo do Studio
Desenha os fotogramas nos momentos que o agente indica, tal como a exportação os vai desenhar, para verificar o que tapa 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 troço de um ficheiro original
Desenha uma imagem de um troço de um vídeo ou áudio carregado: fotogramas repartidos 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 a uma das suas versões. O resultado fica guardado como uma nova versão, por isso o restauro também pode ser desfeito.
- Risco
- Médio
Precisa de um plano que inclua o Studioreview_videoRever um vídeo do Studio
Verifica um projeto da mesma forma que o editor de IA do próprio Studio verifica o seu trabalho e lista o que corrigir, do mais grave para o menos grave. Marca o que a exportação corrige por si.
- 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 a entrar numa publicação. Antes leva o projeto ao nível mínimo de qualidade por si (legendas, um gancho, a música por baixo da voz, transições dentro dos limites) e guarda isso como uma versão chamada Quality pass; nunca mexe no que fez à mão.
- Risco
- Alto
Precisa de um plano que inclua o Studiogenerate_imageGerar uma imagem
Cria uma nova imagem a partir de uma descrição, num dos estilos da área de trabalho se for pedido. Usa 10 créditos de IA. Se o pedido for sobre imagens que a biblioteca já tem, lista-as primeiro e não gasta nada.
- Risco
- Alto
Precisa de um plano que inclua o StudiomascotEscolher a mascote
Lê ou define a mascote da área de trabalho: um apresentador em SVG animado que fala, pisca e faz poses num vídeo. Grátis, sem créditos de IA. Escolhe uma pronta, pinta-a com as cores da marca ou usa o teu desenho.
- Risco
- Médio
Precisa de um plano que inclua o Studiouse_skillLer as competências de edição da área de trabalho
Lista as competências de edição da área de trabalho (os guias de um criador: um visual, um ritmo, uma receita) ou lê uma por inteiro, para o agente a seguir quando cria ou edita um vídeo.
- Risco
- Baixo
Precisa de um plano que inclua o StudioSó leiturasave_skillGuardar uma competência de edição
Cria, altera, importa de um SKILL.md ou elimina uma competência de edição da área de trabalho. A descrição decide quando é usada.
- Risco
- Médio
Precisa de um plano que inclua o Studio
O percurso habitual
Um agente começa com overview para saber o fuso horário, a hora e as contas, encontra o que procura com search, lê um elemento na íntegra com fetch e altera-o com save_post ou outra ferramenta. Cada resposta diz o que se pode fazer a seguir.
Nomes, não ids
As ferramentas aceitam o que uma pessoa diria: o nome exato de um ficheiro, um @nome de utilizador, o nome de uma campanha ou uma ligação para qualquer coisa no SPREVA, colada do navegador ou de uma resposta anterior. A pesquisa é tolerante e a alteração não: um nome que corresponde a várias coisas volta como uma escolha, e nada é guardado até que uma seja escolhida.
Referência para agentes
Um agente lê a referência do SPREVA com fetch quando precisa dela, em vez de a levar em cada chamada:
spreva://docs/platforms/tiktok, e uma página por rede: o que aceita, comprimentos e opções.spreva://docs/queues: horas, fusos horários e filas.spreva://docs/agent-permissions: níveis de risco, confirmações, revisões e ids de pedido.spreva://docs/studio/makingespreva://docs/studio/editing: construir um vídeo, só no SPREVA.