Saltar para o conteúdo

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

  • fetch

    Ler 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ó leitura
  • overview

    Visã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ó leitura
  • list_workspaces

    As 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ó leitura
  • switch_workspace

    Mudar 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_workspace

    Alterar 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_members

    As 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ó leitura
  • invite_member

    Convidar 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_post

    Criar 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_post

    Publicar 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_post

    Eliminar 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_media

    Importar 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_media

    Mudar 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_media

    Eliminar 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
  • share_media

    Partilhar um ficheiro ou uma pasta com outras áreas de trabalho

    Empresta um ficheiro da biblioteca ou uma pasta inteira às suas outras áreas de trabalho como referências só de leitura: nada é copiado, e podem usá-lo em vídeos e publicações, mas não alterá-lo nem eliminá-lo. Retirá-lo pede confirmação quando há vídeos ou publicações que o usam.

    Risco
    Médio, Alto ao retirar um ficheiro que vídeos ou publicações de outra área de trabalho usam.
  • save_campaign

    Criar ou editar uma campanha

    Cria ou altera uma campanha e adiciona-lhe publicações ou retira-as.

    Risco
    Médio
  • save_queue

    Criar 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
  • analytics

    Como 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ó leitura
  • refresh_metrics

    Actualizar 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_clippers

    Os 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ó leitura
  • clipper_posts

    As 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ó leitura
  • clipper_calendar

    O 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ó leitura
  • create_video

    Criar 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 Studio
  • narrate_video

    Narrar 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 Studio
  • compose_video

    Criar 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 Studio
  • match_media

    Associar 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 Studio
    Só leitura
  • find_sfx

    Encontrar 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 Studio
  • find_music

    Encontrar 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 Studio
    Só leitura
  • find_icon

    Encontrar 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 Studio
    Só leitura
  • create_sfx

    Criar 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 Studio
  • score_video

    Compor 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 Studio
  • plan_edit

    Planear 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 Studio
  • find_moments

    Encontrar 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 Studio
  • read_transcript

    Ler 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 Studio
    Só leitura
  • make_clips

    Criar 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 Studio
  • edit_video

    Alterar 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 Studio
  • save_video

    Mudar 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 Studio
  • delete_video

    Eliminar 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 Studio
  • preview_video

    Ver 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 Studio
    Só leitura
  • inspect_media

    Ver 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 Studio
    Só leitura
  • compare_video

    Comparar 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 Studio
    Só leitura
  • restore_video

    Restaurar 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 Studio
  • review_video

    Rever 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 Studio
    Só leitura
  • render_video

    Exportar 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 Studio
  • generate_image

    Gerar 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 Studio
  • mascot

    Escolher 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 Studio
  • use_skill

    Ler 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 Studio
    Só leitura
  • save_skill

    Guardar 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/making e spreva://docs/studio/editing: construir um vídeo, só no SPREVA.