sf-voice media es una capa de API y SDK para hacer que el audio y el vídeo sean buscables. Nos envías el contenido multimedia, mantienes tus propios ID de recursos, eliges las superficies que quieres indexar y consultas el contenido indexado en lenguaje natural.Documentation Index
Fetch the complete documentation index at: https://docs.sf-voice.sh/llms.txt
Use this file to discover all available pages before exploring further.
Ingerir contenido multimedia
Envía vídeo o audio desde una URL, una clave de S3 o subiendo un archivo.
Indexar superficies útiles
Elige si indexar vídeo, audio, transcripción o una combinación de ellos.
Buscar con contexto
Busca por cliente, workspace, proyecto o ID de recursos explícitos.
Para qué construirlo
sf-voice media está dirigido a equipos de producto que necesitan buscar y recuperar contenido multimedia dentro de su propia aplicación. Casos de uso comunes:- Buscar en llamadas de clientes por tema, objeción, solicitud de funcionalidad o defecto.
- Buscar en demos de producto y vídeos de soporte por lo que se dijo o se mostró.
- Permitir que cada cliente final busque únicamente su propio contenido subido.
- Construir flujos de revisión de medios, cumplimiento, QA o base de conocimiento.
El modelo central
Cada recurso comienza con los ID y el ámbito que provienen de tu sistema.| Concepto | Significado |
|---|---|
asset_id | Tu ID único para un recurso multimedia. Obligatorio al ingerir. |
asset_class | Un grupo lógico para los recursos, como un cliente, workspace, proyecto o repositorio. |
types | Las superficies multimedia a indexar o buscar: video, audio y transcript. |
metadata | Metadatos opcionales planos de clave/valor para correlación y visualización. |
La API pública usa términos de sf-voice. Los ID específicos del proveedor backend y los mapeos no forman parte del contrato del SDK.
Ciclo de vida
Sondear la tarea de indexación
La API devuelve un
task_id inmediatamente. Sondea hasta que la tarea pase a ready
o failed.Empieza aquí
Guía rápida
Ingiere un recurso, espera la indexación y ejecuta tu primera búsqueda.
SDK de TypeScript
Usa
@sf-voice/media desde una aplicación TypeScript.