Conversation Type (Speech Type)

Enable this model configuration to distinguish between speech type and capture actionable notes during your conversation

Overview

Conversation Type (Speech Type) model helps you understand the type of conversation at any given time. Every phone call, online or offline conversation can be broadly classified into four categories - Statement, Command, Action Item, or a Question.

NOTE: You can also enable Action Items & Follow-ups to get more actionable and comprehensive Action Items

NOTE: You can also enable Questions & Responses to get more actionable and comprehensive Action Items

Speech Type

Type	Description
Statement	a definite or clear expression of something in chat
Command	an authoritative or peremptory order
Action Item	a chat worded or expressed regarding an event, task, activity, or action that needs to take place
Question	a chat worded or expressed so as to elicit information

modelTypeConfiguration

Keys	Value
modelType	speech_type_analysis
modelConfig	Model Configuration object for speech_type_analysis (No configurations)

Example Request

Curl

curl --location --request POST 'https://api.marsview.ai/cb/v1/conversation/compute' \
--header 'Content-Type: application/json' \
--header "Authorization: {{Insert Auth Token}}" \
--data-raw '{
        "txnId": "{{Insert txn ID}}",
        "enableModels":[
            {
            "modelType":"speech_to_text",
                "modelConfig":{
                    "automatic_punctuation" : true,
                    "custom_vocabulary":["Marsview", "Communication"],
                    "speaker_seperation":{
                        "num_speakers":2
                    },
                    "enableKeywords":true,
                    "enableTopics":false
                    }
            },
            {
            "modelType":"speech_type_analysis"
            }
        ]
}'

Python

import requests
auth_token = "replace this with your auth token"
txn_id =  "Repalce this with your txn id"
request_url = "https://api.marsview.ai/cb/v1/conversation/compute"


def get_speech_type_analysis():
  payload={
        "txnId": txn_id,
        "enableModels":[
            {
            "modelType":"speech_to_text",
                "modelConfig":{
                    "automatic_punctuation" : True,
                    "custom_vocabulary":["Marsview", "Communication"],
                    "speaker_seperation":{
                        "num_speakers":2
                    },
                    "enableKeywords":True,
                    "enableTopics":False
                }
            },
            {
                "modelType":"speech_type_analysis"
            }
            ]
        }
  headers = {'authorization': '{}'.format(auth_token)}
  
  response = requests.request("POST", headers=headers, json=payload)
  print(response.text)
  if response.status_code == 200 and response.json()["status"] == "true":
    return response.json()["data"]["enableModels"]["state"]["status"]
  else:
    raise Exception("Custom exception")

if __name__ == "__main__": 
    get_speech_type_analysis()

Example Response

"data": {
    "speechType": [
        {
            "sentence": "Good evening teresa.",
            "startTime": 1390,
            "endTime": 2690,
            "speaker": "1",
            "type": "statement",
            "confidence": 0.9962469935417175
        },
    ]
}

Response Object

Field	Description
speechType	A list of speechType objects
sentence	A sentence identified by the model in the given time frame.
startTime	Start time of the sentence in the input Video/Audio in milliseconds.
endTime	End time of the sentence in the input Video/Audio in miliseconds.
speaker	Id of the speaker whose voice is identified in the given time frame.
type	Type of speech in the given time frame.
confidence	Value indicating the models confidence in the predicted speech type.