Ferramentas nativas para o DeepSeek Harness
Transcrições para DeepSeek Harness
Dê ao seu agente do DeepSeek Harness o texto-fonte por trás de um vídeo. O plugin da transcript.im adiciona a extração de transcrições, a descoberta no YouTube e ferramentas de lote diretamente ao seu perfil do Harness, para que o agente reúna evidências antes de escrever, comparar ou responder.
- 11 ferramentas registradas diretamente no DeepSeek Harness
- Transcrições de vídeos públicos com opções de marcas de tempo
- Busca no YouTube, canais, playlists e descoberta de legendas
- Resultados estruturados para os fluxos de trabalho do seu agente
Fontes de vídeo prontas para o seu agente
Transcrições para DeepSeek Harness conecta seu agente à API da transcript.im por meio de um plugin nativo. Ele dá ao agente ferramentas que podem ser chamadas em vez de pedir que você copie texto entre um navegador e uma conversa.
De um link a uma fonte de trabalho
Mantenha a coleta de fontes e a próxima etapa da pesquisa na mesma sessão do DeepSeek Harness.
1. Escolha a fonte
Dê ao agente o link de um vídeo público ou peça que ele pesquise no YouTube um tema específico. Para trabalhar com canais e playlists, faça-o enumerar os vídeos relevantes antes de escolher quais fontes processar. As ferramentas de descoberta do YouTube cobrem busca, canais, playlists e metadados de legendas.
2. Obtenha a transcrição
Use get_transcript_info para inspecionar os idiomas disponíveis e depois get_transcript para obter a fonte. Peça marcas de tempo e metadados quando a próxima tarefa precisar de citações. A solicitação pode indicar uma preferência de idioma e pedir reconhecimento de fala pela API.
3. Trabalhe a partir do resultado
Peça ao seu agente que extraia citações, compare argumentos ou prepare notas a partir do texto retornado. Mantenha a URL de origem e as marcas de tempo junto do resultado. Para uma coleção, crie um lote, verifique o status e exporte os resultados concluídos.
O que você pode construir
Use o mesmo plugin para uma única fonte ou para um fluxo de trabalho repetível com coleções.
Pesquisa com fontes rastreáveis
Reúna transcrições para uma pergunta específica e peça ao agente que separe as citações diretas da interpretação. Mantenha os links de origem e as marcas de tempo ao lado de cada afirmação para conferir a gravação original antes de confiar no resultado.
Compare um canal ou uma playlist
Liste os vídeos de um canal ou de uma playlist do YouTube, escolha um conjunto relevante e envie um lote. Quando o processamento terminar, compare temas recorrentes ou explicações que mudam entre os resultados, em vez de tratar um único clipe como a história inteira.
Prepare conteúdo a partir de gravações
Dê ao agente uma transcrição como material de origem para notas, um roteiro ou um rascunho. Revise nomes, citações e contexto em relação à gravação. O agente faz a redação; a transcript.im fornece o texto com que ele trabalha.
Automatize a coleta de transcrições
Use os resultados JSON canônicos em um fluxo de trabalho maior. Verifique o status do lote antes de exportar, preserve os tokens de paginação ao reunir mais fontes e confira o uso com o mesmo conjunto de ferramentas, em vez de manter um cliente de descoberta separado.
Onze ferramentas, um plugin
O plugin nativo expõe as mesmas capacidades REST usadas pelos fluxos de trabalho de desenvolvedores da transcript.im. A extração aceita URLs de vídeos públicos do YouTube, TikTok, Instagram, LinkedIn e Twitter/X; a descoberta é específica do YouTube.
| Tarefa | Ferramentas | Resultado |
|---|---|---|
| Ler um vídeo | get_transcript, get_transcript_info | Texto ou segmentos da transcrição, metadados e informações sobre os idiomas disponíveis. |
| Processar uma coleção | create_batch, get_batch, export_batch | Um lote para monitorar e resultados concluídos para exportar. |
| Encontrar fontes no YouTube | search_video, get_channel | Resultados de busca e informações do canal para escolher fontes. |
| Explorar coleções do YouTube | list_channel_video, list_playlist_item, list_caption | Listas de vídeos, itens de playlists, metadados de legendas e tokens de paginação quando disponíveis. list_caption lê as faixas de legendas que o YouTube expõe e o texto de legenda que a transcript.im pode servir; ele não inicia o reconhecimento de fala. |
| Consultar o uso | get_usage | As informações de uso da API associadas à sua credencial. |
Conecte seu perfil do Harness
O plugin registra as ferramentas da transcript.im dentro de um perfil do DeepSeek Harness e chama a API REST com uma chave de API de desenvolvedor da sua conta transcript.im.
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgzexport TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile researchEscolha a conexão certa
Use a conexão que se encaixa no ambiente onde seu agente já trabalha. O plugin nativo do Harness não exige o servidor MCP da transcript.im como etapa intermediária.
| Conexão | Quando escolher | Como se encaixa |
|---|---|---|
| Plugin do DeepSeek Harness | Você executa um agente no DeepSeek Harness. | Registra ferramentas nativas no perfil do Harness e chama a API REST. |
| Servidor MCP da Transcript | Seu cliente conecta ferramentas via MCP. | Expõe operações de transcrição e descoberta pelo protocolo MCP. |
| Transcript Skills | Seu ambiente carrega instruções de pacotes de skills. | Fornece orientação de tarefas e fluxos de trabalho para o agente. |
| API da Transcript | Você mesmo controla o aplicativo ou o script. | Permite que seu código chame os endpoints REST diretamente. |
Preserve o resultado original
O contexto do modelo e os dados de origem armazenados têm finalidades diferentes. Use o resultado certo em cada etapa.
- O texto longo da transcrição mostrado ao modelo é limitado por maxTranscriptChars, que por padrão tem 20.000 caracteres. Um marcador de truncamento avisa o agente quando ele tem apenas um trecho; o resultado JSON canônico é mantido intacto.
- A exportação de um lote de texto pode ser apresentada em linha. A exportação ZIP é binária, então a resposta voltada ao modelo a descreve em vez de inserir o arquivo na conversa.
- As respostas de descoberta do YouTube preservam nextPageToken quando a API o fornece. Passe esse token na próxima solicitação para continuar uma coleção em vez de repetir a primeira página.
- O plugin envia solicitações para https://api.transcript.im por padrão. baseUrl, timeoutMs e maxTranscriptChars são configuráveis; o tempo limite padrão da solicitação é de 30.000 milissegundos.
- A disponibilidade da fonte e a qualidade da transcrição dependem do vídeo. Peça ao agente que informe explicitamente os erros de extração e o material ausente, e verifique as citações na gravação original.
Relacionado
Perguntas frequentes sobre o DeepSeek Harness
O que são as Transcrições para DeepSeek Harness?
Transcrições para DeepSeek Harness é o plugin da transcript.im com ferramentas nativas de transcrição de vídeo e descoberta no YouTube. Ele registra 11 ferramentas em um perfil do Harness e chama a API REST da transcript.im.
Como conecto o plugin da transcript.im ao DeepSeek Harness?
Instale o pacote do plugin no perfil do Harness que seu agente usa, crie uma chave de API de desenvolvedor na sua conta transcript.im e forneça-a ao processo do Harness como TRANSCRIPT_API_KEY ou na configuração do plugin. A seção de conexão mostra os dois passos.
Quais plataformas de vídeo o plugin do Harness consegue ler?
As ferramentas de extração de transcrição aceitam URLs de vídeos públicos do YouTube, TikTok, Instagram, LinkedIn e Twitter/X. As ferramentas de busca, canais, playlists e metadados de legendas focam no YouTube.
O plugin do DeepSeek Harness precisa de um servidor MCP?
O plugin do DeepSeek Harness chama a API REST diretamente, então esta conexão não exige o servidor MCP da transcript.im. Use o servidor MCP quando seu cliente preferir ferramentas MCP.
Como a chave de API é passada ao plugin?
O plugin lê TRANSCRIPT_API_KEY do ambiente do processo, a menos que um apiKey explícito seja definido na configuração do plugin. O valor configurado tem precedência; a credencial pertence a esse ambiente ou configuração, não a um prompt.
O plugin do Harness pode retornar marcas de tempo e informações de idioma?
Use get_transcript_info para inspecionar os idiomas de transcrição disponíveis e defina includeTimestamp ao obter uma transcrição. O parâmetro language aceita uma lista de prioridade, incluindo preferências de reconhecimento de fala compatíveis com a API.
O DeepSeek Harness pode processar uma playlist como lote?
O plugin oferece descoberta de playlists além de create_batch, get_batch e export_batch. Peça ao agente que identifique a coleção de origem, crie o lote, verifique o status e exporte os resultados concluídos, em vez de presumir que enviar significa concluir.
O plugin resume ou traduz vídeos por conta própria?
O plugin fornece ferramentas de extração, descoberta, lote e uso. Seu agente pode usar a transcrição retornada em uma tarefa de resumo ou tradução, mas o plugin não registra ferramentas separadas de resumo ou tradução com IA.
Por que uma transcrição longa mostra um marcador de truncamento?
O plugin limita com maxTranscriptChars o texto da transcrição inserido no contexto do modelo. O marcador identifica um trecho, enquanto o resultado JSON canônico permanece intacto; um agente não deve afirmar que leu o material omitido.
Como soluciono missing_api_key no Harness?
Verifique se o processo que executa o perfil selecionado tem TRANSCRIPT_API_KEY ou um apiKey configurado. Se houver um valor configurado, mudar apenas a variável de ambiente não o substituirá.
Posso apontar o plugin para outra origem de API?
Defina baseUrl na configuração do plugin quando sua implantação precisar de uma origem diferente da API da transcript.im. O padrão é https://api.transcript.im; mantenha uma credencial adequada ao destino que você configurar.
Como isso se diferencia do Transcript Skills?
Transcript Skills descreve tarefas e fluxos de trabalho que um agente compatível pode seguir. O plugin do DeepSeek Harness registra ferramentas que podem ser chamadas no ambiente; escolha-o quando seu agente precisar da conexão nativa do Harness.
Dê ao seu agente do Harness a fonte
Crie uma chave de API de desenvolvedor e leve transcrições de vídeo para o seu próximo fluxo de trabalho de pesquisa.