Herramientas nativas para DeepSeek Harness
Transcripciones para DeepSeek Harness
Dale a tu agente de DeepSeek Harness el texto fuente que hay detrás de un vídeo. El complemento de transcript.im añade la obtención de transcripciones, el descubrimiento en YouTube y herramientas por lotes directamente a tu perfil de Harness, para que el agente reúna pruebas antes de escribir, comparar o responder.
- 11 herramientas registradas directamente en DeepSeek Harness
- Transcripciones de vídeos públicos con opciones de marcas de tiempo
- Búsqueda en YouTube, canales, listas de reproducción y descubrimiento de subtítulos
- Resultados estructurados para los flujos de trabajo de tu agente

Fuentes de vídeo listas para tu agente
Transcripciones para DeepSeek Harness conecta tu agente a la API de transcript.im mediante un complemento nativo. Le da al agente herramientas invocables en lugar de pedirte que copies texto entre un navegador y una conversación.
De un enlace a una fuente de trabajo
Mantén la recopilación de fuentes y el siguiente paso de la investigación en la misma sesión de DeepSeek Harness.

1. Elige la fuente
Dale al agente el enlace de un vídeo público o pídele que busque en YouTube un tema concreto. Para trabajar con canales y listas de reproducción, haz que enumere los vídeos relevantes antes de elegir qué fuentes procesar. Las herramientas de descubrimiento de YouTube cubren búsqueda, canales, listas de reproducción y metadatos de subtítulos.
2. Obtén la transcripción
Usa get_transcript_info para inspeccionar los idiomas disponibles y, después, get_transcript para obtener la fuente. Pide marcas de tiempo y metadatos cuando la siguiente tarea necesite citas. La solicitud puede indicar una preferencia de idioma y pedir reconocimiento de voz a través de la API.
3. Trabaja a partir del resultado
Pide a tu agente que extraiga citas, compare argumentos o prepare notas a partir del texto devuelto. Conserva la URL de origen y las marcas de tiempo junto al resultado. Para una colección, crea un lote, consulta su estado y exporta los resultados completados.
Lo que puedes crear
Usa el mismo complemento para una sola fuente o para un flujo de trabajo repetible con colecciones.
Investigación con fuentes trazables
Reúne transcripciones para una pregunta concreta y pide a tu agente que separe las citas directas de la interpretación. Mantén los enlaces de origen y las marcas de tiempo junto a cada afirmación para poder comprobar la grabación original antes de fiarte del resultado.
Compara un canal o una lista de reproducción
Enumera los vídeos de un canal o una lista de reproducción de YouTube, elige un conjunto relevante y envía un lote. Cuando termine el procesamiento, compara temas recurrentes o explicaciones cambiantes entre los resultados en lugar de tratar un solo clip como toda la historia.
Prepara contenido a partir de grabaciones
Dale al agente una transcripción como material de origen para notas, un esquema o un borrador. Revisa nombres, citas y contexto contra la grabación. El agente hace la redacción; transcript.im aporta el texto con el que trabaja.
Automatiza la recopilación de transcripciones
Usa los resultados JSON canónicos en un flujo de trabajo mayor. Consulta el estado del lote antes de exportar, conserva los tokens de paginación cuando reúnas más fuentes y comprueba el uso con el mismo conjunto de herramientas en lugar de mantener un cliente de descubrimiento aparte.
Once herramientas, un complemento
El complemento nativo expone las mismas capacidades REST que usan los flujos de trabajo para desarrolladores de transcript.im. La obtención admite URL de vídeos públicos de YouTube, TikTok, Instagram, LinkedIn y Twitter/X; el descubrimiento es específico de YouTube.

| Tarea | Herramientas | Resultado |
|---|---|---|
| Leer un vídeo | get_transcript, get_transcript_info | Texto o segmentos de la transcripción, metadatos e información sobre los idiomas disponibles. |
| Procesar una colección | create_batch, get_batch, export_batch | Un lote que monitorizar y resultados completados que exportar. |
| Encontrar fuentes en YouTube | search_video, get_channel | Resultados de búsqueda e información del canal para elegir fuentes. |
| Explorar colecciones de YouTube | list_channel_video, list_playlist_item, list_caption | Listas de vídeos, entradas de listas de reproducción, metadatos de subtítulos y tokens de paginación cuando estén disponibles. list_caption lee las pistas de subtítulos que expone YouTube y el texto de subtítulos que transcript.im puede servir; no inicia el reconocimiento de voz. |
| Consultar el uso | get_usage | La información de uso de la API asociada a tu credencial. |
Conecta tu perfil de Harness
El complemento registra las herramientas de transcript.im dentro de un perfil de DeepSeek Harness y llama a la API REST con una clave de API para desarrolladores de tu cuenta de transcript.im.
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgzexport TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile researchElige la conexión adecuada
Usa la conexión que encaje con el entorno donde ya trabaja tu agente. El complemento nativo de Harness no necesita el servidor MCP de transcript.im como paso intermedio.
| Conexión | Cuándo elegirla | Cómo encaja |
|---|---|---|
| Complemento de DeepSeek Harness | Ejecutas un agente en DeepSeek Harness. | Registra herramientas nativas en el perfil de Harness y llama a la API REST. |
| Servidor MCP de Transcript | Tu cliente conecta herramientas mediante MCP. | Expone operaciones de transcripción y descubrimiento a través del protocolo MCP. |
| Transcript Skills | Tu entorno carga instrucciones desde paquetes de skills. | Aporta guía de tareas y flujos de trabajo para el agente. |
| API de Transcript | Controlas tú mismo la aplicación o el script. | Permite que tu código llame directamente a los endpoints REST. |
Conserva el resultado original
El contexto del modelo y los datos de origen almacenados cumplen funciones distintas. Usa el resultado adecuado en cada paso.
- El texto largo de la transcripción que se muestra al modelo está limitado por maxTranscriptChars, que por defecto son 20.000 caracteres. Un marcador de truncado indica al agente cuándo solo tiene un fragmento; el resultado JSON canónico se conserva intacto.
- La exportación de un lote de texto puede presentarse en línea. La exportación ZIP es binaria, así que la respuesta orientada al modelo la describe en lugar de insertar el archivo en la conversación.
- Las respuestas de descubrimiento de YouTube conservan nextPageToken cuando la API lo facilita. Pasa ese token en la siguiente solicitud para continuar una colección en lugar de repetir la primera página.
- El complemento envía solicitudes a https://api.transcript.im de forma predeterminada. baseUrl, timeoutMs y maxTranscriptChars son configurables; el tiempo de espera predeterminado de la solicitud es de 30.000 milisegundos.
- La disponibilidad de la fuente y la calidad de la transcripción dependen del vídeo. Pide al agente que informe explícitamente de los errores de obtención y del material que falte, y verifica las citas contra la grabación original.
Relacionado
- Documentación de la API
- API REST de Transcript
- Servidor MCP de Transcript
- Transcript Skills
- Generador de transcripciones de YouTube
- Resumidor de vídeos de YouTube
- Generador de subtítulos de YouTube
- Descargador de subtítulos de YouTube
- Transcripciones de canales de YouTube
- Transcripción de listas de reproducción de YouTube
Preguntas frecuentes sobre DeepSeek Harness
¿Qué son las Transcripciones para DeepSeek Harness?
Transcripciones para DeepSeek Harness es el complemento de transcript.im que ofrece herramientas nativas de transcripción de vídeo y de descubrimiento en YouTube. Registra 11 herramientas en un perfil de Harness y llama a la API REST de transcript.im.
¿Cómo conecto el complemento de transcript.im a DeepSeek Harness?
Instala el paquete del complemento en el perfil de Harness que usa tu agente, crea una clave de API para desarrolladores en tu cuenta de transcript.im y facilítala al proceso de Harness como TRANSCRIPT_API_KEY o en la configuración del complemento. La sección de conexión muestra ambos pasos.
¿Qué plataformas de vídeo puede leer el complemento de Harness?
Las herramientas de obtención de transcripciones aceptan URL de vídeos públicos de YouTube, TikTok, Instagram, LinkedIn y Twitter/X. Las herramientas de búsqueda, canales, listas de reproducción y metadatos de subtítulos se centran en YouTube.
¿El complemento de DeepSeek Harness necesita un servidor MCP?
El complemento de DeepSeek Harness llama directamente a la API REST, así que esta conexión no necesita el servidor MCP de transcript.im. Usa el servidor MCP cuando tu cliente prefiera herramientas MCP.
¿Cómo se pasa la clave de API al complemento?
El complemento lee TRANSCRIPT_API_KEY del entorno de su proceso salvo que se defina un apiKey explícito en la configuración del complemento. El valor configurado tiene prioridad; la credencial debe estar en ese entorno o configuración, no en un prompt.
¿Puede el complemento de Harness devolver marcas de tiempo e información de idioma?
Usa get_transcript_info para inspeccionar los idiomas de transcripción disponibles y define includeTimestamp al obtener una transcripción. El parámetro language acepta una lista de prioridad, incluidas las preferencias de reconocimiento de voz que admite la API.
¿Puede DeepSeek Harness procesar una lista de reproducción como lote?
El complemento ofrece descubrimiento de listas de reproducción además de create_batch, get_batch y export_batch. Pide al agente que identifique la colección de origen, cree el lote, consulte su estado y exporte los resultados completados en lugar de dar por hecho que enviarlo significa terminarlo.
¿El complemento resume o traduce vídeos por sí mismo?
El complemento ofrece herramientas de obtención, descubrimiento, lotes y uso. Tu agente puede usar la transcripción devuelta en una tarea de resumen o traducción, pero el complemento no registra herramientas independientes de resumen o traducción con IA.
¿Por qué una transcripción larga muestra un marcador de truncado?
El complemento limita con maxTranscriptChars el texto de la transcripción que se incorpora al contexto del modelo. El marcador identifica un fragmento, mientras que el resultado JSON canónico permanece intacto; un agente no debería afirmar que leyó el material omitido.
¿Cómo soluciono missing_api_key en Harness?
Comprueba que el proceso que ejecuta el perfil seleccionado tenga TRANSCRIPT_API_KEY o un apiKey configurado. Si hay un valor configurado, cambiar solo la variable de entorno no lo sustituirá.
¿Puedo apuntar el complemento a otro origen de API?
Define baseUrl en la configuración del complemento cuando tu despliegue necesite un origen distinto de la API de transcript.im. El valor predeterminado es https://api.transcript.im; mantén una credencial adecuada para el destino que configures.
¿En qué se diferencia de Transcript Skills?
Transcript Skills describe tareas y flujos de trabajo que un agente compatible puede seguir. El complemento de DeepSeek Harness registra herramientas invocables en el entorno; elígelo cuando tu agente necesite la conexión nativa de Harness.
Dale a tu agente de Harness la fuente
Crea una clave de API para desarrolladores y lleva transcripciones de vídeo a tu próximo flujo de trabajo de investigación.