---
title: "Transcrições para DeepSeek Harness"
description: "Adicione ao DeepSeek Harness ferramentas de transcrição para vídeos públicos, descoberta no YouTube e exportações em lote com o plugin da transcript.im."
canonical: "https://transcript.im/pt-BR/deepseek-harness"
markdown: "https://transcript.im/pt-BR/deepseek-harness.md"
---

# Transcrições para DeepSeek Harness

Adicione ao DeepSeek Harness ferramentas de transcrição para vídeos públicos, descoberta no YouTube e exportações em lote com o plugin da transcript.im.

## Links

- [HTML canônico](https://transcript.im/pt-BR/deepseek-harness)
- [Markdown](https://transcript.im/pt-BR/deepseek-harness.md)


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.

Comece com a URL de um vídeo público ou descubra fontes no YouTube. O plugin pode inspecionar os metadados da transcrição, obter o texto e devolver dados estruturados que o agente pode usar na próxima etapa. As opções de marcas de tempo ajudam a vincular uma citação ou observação à sua fonte. A descrição de um vídeo não substitui a transcrição: obter as palavras faladas dá ao seu agente material que ele pode realmente citar.

O plugin fornece ferramentas de extração e descoberta. Seu agente decide como usar os resultados, seja para preparar notas de pesquisa, comparar várias palestras ou esboçar um artigo novo. Os prompts de resumo e tradução rodam no fluxo de trabalho do seu agente; não são ferramentas de IA separadas oferecidas por este plugin.

## 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.

- [Crie uma chave de API de desenvolvedor](/app/account/api-keys)
- [Leia a documentação da API](/docs)

Instale o plugin no perfil que seu agente usa. O exemplo adiciona um pacote de plugin a partir de um arquivo na sua máquina e não baixa nada da transcript.im; substitua o nome do perfil e o caminho pelos seus próprios valores.

### Instale o plugin em um perfil do Harness

```
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgz
```

Crie uma chave de API de desenvolvedor da transcript.im na sua conta e deixe-a disponível para o processo que inicia o Harness. A variável de ambiente evita colocar a credencial em uma conversa. Um apiKey explícito na configuração do plugin tem precedência sobre a variável de ambiente, então remova um valor configurado obsoleto se pretende usar o ambiente.

### Configure a credencial e inicie seu perfil

```
export TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile research
```

Comece com um vídeo público e peça ao agente que inspecione as informações da transcrição. Isso verifica a credencial e a fonte antes de você montar um fluxo de trabalho mais longo. Se o plugin informar missing_api_key, verifique o ambiente do processo real do Harness, não apenas o de outra janela de terminal.

## Escolha 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

- [Documentação da API](/docs)
- [API REST da Transcript](/pt-BR/api)
- [Servidor MCP da Transcript](/pt-BR/mcp)
- [Transcript Skills](/pt-BR/skills)
- [Gerador de transcrições do YouTube](/pt-BR/youtube-transcript)
- [Resumidor de vídeos do YouTube](/pt-BR/youtube-video-summarizer)
- [Gerador de legendas do YouTube](/pt-BR/youtube-subtitle-generator)
- [Baixar legendas do YouTube](/pt-BR/youtube-subtitle-downloader)
- [Transcrições de canais do YouTube](/pt-BR/youtube-channel-transcript)
- [Transcrição de playlists do YouTube](/pt-BR/youtube-playlist-transcript)
## 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.

- [Criar uma chave de API](/app/account/api-keys)
- [Ler a documentação da API](/docs)