Sherpa Digital (anteprima)

Sherpa Digital Connector consente la trascrizione automatica da audio a testo all'interno dell'automazione del flusso di lavoro e della compilazione di app. Elimina la trascrizione manuale e aiuta gli utenti a sfruttare l'intelligenza artificiale più velocemente, ad esempio durante i training. Presto saranno disponibili altri connettori.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Sherpa Digital Connector

Informazioni generali

Il connettore Sherpa Digital consente di trascrivere file audio in testo usando una tecnologia avanzata di sintesi vocale. Caricare i file audio e ricevere trascrizioni accurate in olandese, perfetto per note riunione, registrazioni vocali ed elaborazione di contenuti audio.

Funzionalità

• trascrizioneHigh-Quality: convertire i file audio in trascrizioni di testo accurate
• Formati audio multipli: supporta formati MP3, WAV, M4A, MP4, FLAC, OGG e WebM
• Elaborazione asincrona: polling automatico per il completamento della trascrizione (fino a 10 minuti)
• Supporto file di grandi dimensioni: gestire file audio fino a 500 MB
• Supporto per la lingua olandese: trascrizione ottimizzata per l'olandese (nl-NL)
• Archiviazione organizzata: prefisso di cartella facoltativo per organizzare le trascrizioni
• Copilot Studio Optimized: l'azione TranscribeFile usa il formato flat name e contentBytes per Power Automate/Copilot Studio

Come iniziare

Prerequisiti

Per usare il connettore Sherpa Digital, è necessario:

1. Una chiave API di Sherpa Digital
2. Un file audio in un formato supportato (MP3, WAV, M4A, MP4, FLAC, OGG o WebM)

Recupero della chiave API

1. Contattare Sherpa Digital per richiedere una chiave API
2. Posta elettronica: thierry.hubar@sherpadigital.nl
3. Visita: https://sherpaplatform.eu

Dopo aver ottenuto la chiave API, è possibile configurarla nelle impostazioni del connettore.

Authentication

Il connettore Sherpa Digital usa l'autenticazione con chiave API. Quando si configura il connettore:

1. Immettere la chiave API nelle impostazioni di connessione
2. La chiave API verrà archiviata e usata in modo sicuro per tutte le richieste API
3. Includere la chiave API nell'intestazione X-API-Key per tutte le richieste

Nota: questo connettore non usa l'autenticazione OAuth. È sufficiente specificare la chiave API durante la configurazione della connessione.

Usage

Trascrivere file

L'azione principale trascrive un file audio in testo. Ottimizzato per Copilot Studio e Power Automate.

Formato richiesta:

• Corpo JSON con struttura piatta: name e contentBytes a livello radice
• Il file audio deve essere codificato in base64 nel contentBytes campo
• Includere il nome file nel name campo (estensione facoltativa; il formato viene rilevato automaticamente dal contenuto del file se mancante)

Corpo della richiesta:

{
  "name": "meeting_recording.mp3",
  "contentBytes": "UklGRiQAAABXQVZFZm10...",
  "prefix": "meetings/2024"
}

Risposta:

{
  "job_id": "uuid",
  "filename": "meeting_recording_uuid.mp3",
  "transcription": "Dit is de getranscribeerde tekst uit het audio bestand.",
  "transcription_filename": "transcription_meeting_recording.txt",
  "blob_name": "...",
  "duration_seconds": 120.5,
  "status": "completed"
}

Parametri

• name (obbligatorio): nome del file audio (estensione facoltativa; rilevato automaticamente dai byte magic se mancanti)
• contentBytes (obbligatorio): contenuto di file audio con codifica Base64
• prefisso (facoltativo): prefisso della cartella per organizzare le trascrizioni (ad esempio, "riunioni/2024")

Campi di risposta

• trascrizione: testo trascritto dal file audio
• transcription_filename: nome del file di trascrizione
• job_id: identificatore univoco del processo
• filename: nome file archiviato (con UUID)
• duration_seconds: durata audio in secondi
• status: stato di elaborazione ("completato" o "elaborazione")

Formati audio supportati

• MP3 (.mp3)
• WAV (.wav)
• M4A (.m4a)
• MP4 (.mp4)
• FLAC (.flac)
• OGG (.ogg)
• WebM (.webm)

Limitazioni

• Dimensioni file: massimo 500 MB per file audio
• Lingua: attualmente supporta solo olandese (nl-NL)
• Tempo di elaborazione: tempo di attesa massimo di 10 minuti per il completamento della trascrizione
• Timeout: se la trascrizione richiede più di 10 minuti, si riceverà una risposta di timeout e sarà possibile eseguire il controllo in un secondo momento tramite l'endpoint di trascrizione get

Gestione degli errori

Il connettore restituisce i codici di stato HTTP appropriati. Le risposte di errore includono un error campo con un messaggio:

• 200: Trascrizione completata
• 400: Richiesta non valida - File mancante o tipo di file non valido
  • {"error": "JSON body required"}
  • {"error": "Missing 'name' field in request body"}
  • {"error": "Missing 'contentBytes' field in request body"}
  • {"error": "Failed to decode file content: ..."}
  • {"error": "Unsupported file type '.xyz'. Allowed: mp3, wav, m4a, ..."}
• 401: Chiave API non autorizzata o mancante
  • {"error": "Missing X-API-Key header"}
  • {"error": "Invalid or expired API key"}
• 408: Timeout della richiesta - Trascrizione ancora in corso
  • {"error": "Transcription timeout. File may still be processing.", "status": "processing", "message": "Please try again later or use /api/get-transcription endpoint"}
• 429: Limite di frequenza o limite di utilizzo superato
  • {"error": "Rate limit exceeded"}
  • {"error": "Monthly usage limit exceeded"}
• 500: Errore interno del server
  • {"error": "...", "details": "..."}

Support

Per domande, problemi o per richiedere una chiave API:

• Indirizzo di posta elettronica: thierry.hubar@sherpadigital.nl
• Sito Web: https://sherpaplatform.eu
• API: https://api.sherpaplatform.eu

Casi d'uso

• Trascrizione riunione: trascrivere automaticamente le registrazioni delle riunioni
• Note vocali: convertire memo vocali in testo per facilitare la ricerca e la condivisione
• Elaborazione del contenuto: estrarre testo dal contenuto audio per l'analisi
• Accessibilità: creare versioni di testo del contenuto audio per l'accessibilità

Migliori pratiche

1. Preparazione file: assicurarsi che la qualità audio sia chiara per una migliore accuratezza della trascrizione
2. Dimensioni file: mantenere i file sotto i 400 MB per un'elaborazione ottimale
3. Selezione formato: usare formati MP3, M4A o WAV per garantire la migliore compatibilità
4. Organizzazione: usare il parametro prefisso per organizzare le trascrizioni in base a progetto, data o categoria

Operazioni supportate

• TranscribeFile: Trascrivere audio dal file con codifica base64 (Copilot Studio/Power Automate ottimizzato)

Limitazioni note

N/A

Aggiorna sequenza temporale

V1.0: prima versione del connettore V1.1: aggiornamento della funzione di trascrizione che consente di usare gli agenti negli strumenti + aggiornamento logo.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Limiti per la limitazione delle richieste

Azioni

Trascrivere file in testo