Camel.toolkits.audio analysis toolkit

​

download_file

def download_file(url: str, cache_dir: str):

Download a file from a URL to a local cache directory.

Parameters:

• url (str): The URL of the file to download.
• cache_dir (str): The directory to save the downloaded file.

Returns:

str: The path to the downloaded file.

Raises:

• Exception: If the download fails.

​

AudioAnalysisToolkit

class AudioAnalysisToolkit(BaseToolkit):

​

init

def __init__(
    self,
    cache_dir: Optional[str] = None,
    transcribe_model: Optional[BaseAudioModel] = None,
    audio_reasoning_model: Optional[BaseModelBackend] = None,
    timeout: Optional[float] = None
):

A toolkit for audio processing and analysis. This class provides methods for processing, transcribing, and extracting information from audio data, including direct question answering about audio content.

Parameters:

• cache_dir (Optional[str]): Directory path for caching downloaded audio files. If not provided, ‘tmp/’ will be used. (default: :obj:None)
• transcribe_model (Optional[BaseAudioModel]): Model used for audio transcription. If not provided, OpenAIAudioModels will be used. (default: :obj:None)
• audio_reasoning_model (Optional[BaseModelBackend]): Model used for audio reasoning and question answering. If not provided, uses the default model from ChatAgent. (default: :obj:None)
• timeout (Optional[float]): The timeout value for API requests in seconds. If None, no timeout is applied. (default: :obj:None)

​

audio2text

def audio2text(self, audio_path: str):

Transcribe audio to text.

Parameters:

• audio_path (str): The path to the audio file or URL.

Returns:

str: The transcribed text.

​

ask_question_about_audio

def ask_question_about_audio(self, audio_path: str, question: str):

Ask any question about the audio and get the answer using multimodal model.

Parameters:

• audio_path (str): The path to the audio file.
• question (str): The question to ask about the audio.

Returns:

str: The answer to the question.

​

get_tools

def get_tools(self):

Returns:

List[FunctionTool]: A list of FunctionTool objects representing the functions in the toolkit.