Skip to main content
Com a integração de YouTube, você pode transformar qualquer vídeo em conhecimento pesquisável para o seu agente. A Timely.ai extrai a transcrição do vídeo automaticamente, processa o texto em chunks e gera os embeddings — sem que você precise transcrever nada manualmente.
Gerenciador de videos do YouTube

​
Como funciona

O pipeline segue estas etapas internamente:
1

Validacao da URL

Você informa a URL do vídeo. O sistema valida se é um link de YouTube válido e busca os metadados públicos do vídeo (título, canal, thumbnail).
2

Confirmacao pelo usuario

Os dados do vídeo são exibidos para confirmação antes de iniciar o processamento — título, canal e thumbnail — para garantir que é o vídeo correto.
3

Extracao da transcricao

O youtube-processor busca a transcrição automática ou as legendas do vídeo via API do YouTube.
4

Chunking e embeddings

O texto da transcrição é dividido em chunks (seguindo o mesmo pipeline de documentos) e vetorizado pela OpenAI.
5

Disponibilizacao na base

Os chunks ficam disponíveis imediatamente para busca semântica pelo agente.

​
Adicionando um vídeo

1

Abra a secao YouTube

No agente, acesse Knowledge Base > YouTube.
2

Cole a URL do video

Informe a URL completa do vídeo do YouTube. Formatos aceitos:
  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
3

Confirme o video

Verifique o título e canal exibidos. Clique em Confirmar e processar.
4

Aguarde o processamento

O status muda para processing e, em seguida, para success quando concluído. O tempo varia de acordo com a duração do vídeo.
O vídeo precisa ter transcrição ou legenda disponível publicamente. Vídeos sem legendas automáticas ou manuais habilitadas não podem ser processados.

​
Limitações importantes

LimitaçãoDetalhe
Máximo de caracteres indexados1.028 caracteres por chunk (tamanho máximo configurado no processador)
Suporte a idiomasDepende das legendas disponíveis no YouTube
Vídeos privadosNão suportados — apenas vídeos públicos
Lives e streamsTranscrições ao vivo podem ter qualidade reduzida

​
Gerenciando vídeos indexados

A lista de vídeos indexados exibe para cada item:
InformaçãoDescrição
ThumbnailMiniatura do vídeo
TítuloTítulo do vídeo no YouTube
CanalNome do canal que publicou o vídeo
Total de chunksNúmero de trechos gerados da transcrição
Data de indexaçãoQuando o vídeo foi processado
Para remover um vídeo da base, clique no menu de ações e selecione Excluir. Todos os chunks e embeddings do vídeo são deletados.
A exclusão de um vídeo indexado remove permanentemente todos os chunks associados. O agente deixa de ter acesso ao conteúdo desse vídeo imediatamente após a exclusão.

​
Casos de uso recomendados

Treinamentos e tutoriais

Indexe vídeos de onboarding ou treinamentos internos para que o agente responda perguntas sobre o conteúdo.

Webinars e palestras

Torne acessível o conhecimento compartilhado em eventos gravados sem transcrever manualmente.

Demonstracoes de produto

Vídeos de demo do produto permitem que o agente explique funcionalidades específicas com base no que foi dito no vídeo.

FAQ em video

Se sua equipe gravou respostas para perguntas frequentes em vídeo, indexe-as e o agente saberá o que foi explicado.
Vídeos com legendas manuais (criadas por humanos) geram transcrições de qualidade muito superior às legendas automáticas geradas pelo YouTube. Prefira vídeos com legenda manual para tópicos críticos.