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

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

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

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

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

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

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

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

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

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

    Renomear, 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_media

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

    Compartilhar um arquivo ou uma pasta com outros espaços de trabalho

    Empresta um arquivo da biblioteca ou uma pasta inteira para os seus outros espaços de trabalho como referências somente leitura: nada é copiado, e eles podem usá-lo em vídeos e publicações, mas não alterá-lo nem excluí-lo. Retirá-lo pede confirmação quando há vídeos ou publicações que o usam.

    Risco
    Médio, Alto ao retirar um arquivo que vídeos ou publicações de outro espaço de trabalho usam.
  • save_campaign

    Criar ou editar uma campanha

    Cria ou muda uma campanha e adiciona ou tira publicações dela.

    Risco
    Médio
  • save_queue

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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