Vai al contenuto principale

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.

sf-voice media è un livello API e SDK per rendere ricercabili audio e video. Tu ci invii i contenuti multimediali, mantieni i tuoi ID di asset, scegli quali superfici indicizzare e interroghi i contenuti indicizzati in linguaggio naturale.

Ingerire contenuti multimediali

Invia video o audio da un URL, una chiave S3 o caricando un file.

Indicizzare le superfici utili

Scegli se indicizzare video, audio, trascrizione o una loro combinazione.

Cercare con contesto

Cerca per cliente, workspace, progetto o ID di asset espliciti.

Cosa puoi costruire con questo

sf-voice media è pensato per i team di prodotto che necessitano di ricerca e recupero di contenuti multimediali all’interno della propria applicazione. Casi d’uso comuni:
  • Cercare nelle chiamate dei clienti per argomento, obiezione, richiesta di funzionalità o difetto.
  • Cercare nelle demo di prodotto e nei video di supporto in base a ciò che è stato detto o mostrato.
  • Permettere a ogni cliente finale di cercare solo i propri contenuti caricati.
  • Costruire workflow di revisione media, compliance, QA o knowledge base.

Il modello principale

Ogni asset inizia con ID e ambito che provengono dal tuo sistema.
ConcettoSignificato
asset_idIl tuo ID univoco per un asset multimediale. Obbligatorio in fase di ingestione.
asset_classUn raggruppamento logico per gli asset, come un cliente, workspace, progetto o repository.
typesLe superfici multimediali da indicizzare o cercare: video, audio e transcript.
metadataMetadati piatti chiave/valore opzionali per correlazione e visualizzazione.
L’API pubblica usa la terminologia sf-voice. Gli ID specifici del provider backend e le mappature non fanno parte del contratto dell’SDK.

Ciclo di vita

1

Invia il contenuto multimediale

Invia un URL, una chiave S3 o un caricamento di file con il tuo asset_id.
2

Esegui il polling del task di indicizzazione

L’API restituisce immediatamente un task_id. Esegui il polling finché il task diventa ready o failed.
3

Cerca negli asset con ambito definito

Cerca per asset_class, per asset_ids espliciti o per scope: "all" quando la ricerca globale è intenzionale.

Inizia qui

Avvio rapido

Ingerisci un asset, attendi l’indicizzazione ed esegui la tua prima ricerca.

SDK TypeScript

Usa @sf-voice/media da un’applicazione TypeScript.