diff --git a/pyproject.toml b/pyproject.toml index 2bd5c3e..521f572 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,9 +1,8 @@ [project] name = "hume" - [tool.poetry] name = "hume" -version = "0.7.6" +version = "0.7.7" description = "A Python SDK for Hume AI" readme = "README.md" authors = [] diff --git a/reference.md b/reference.md index db64b7f..84e4ab7 100644 --- a/reference.md +++ b/reference.md @@ -1,6 +1,6 @@ # Reference -## ExpressionMeasurement Batch -
client.expression_measurement.batch.list_jobs(...) +## EmpathicVoice Tools +
client.empathic_voice.tools.list_tools(...)
@@ -12,7 +12,9 @@
-Sort and filter jobs. +Fetches a paginated list of **Tools**. + +Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -32,7 +34,15 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.expression_measurement.batch.list_jobs() +response = client.empathic_voice.tools.list_tools( + page_number=0, + page_size=2, +) +for item in response: + yield item +# alternatively, you can paginate page-by-page +for page in response.iter_pages(): + yield page ``` @@ -48,33 +58,11 @@ client.expression_measurement.batch.list_jobs()
-**limit:** `typing.Optional[int]` — The maximum number of jobs to include in the response. - -
-
- -
-
- -**status:** `typing.Optional[typing.Union[Status, typing.Sequence[Status]]]` - -Include only jobs of this status in the response. There are four possible statuses: - -- `QUEUED`: The job has been received and is waiting to be processed. - -- `IN_PROGRESS`: The job is currently being processed. - -- `COMPLETED`: The job has finished processing. - -- `FAILED`: The job encountered an error and could not be completed successfully. - -
-
+**page_number:** `typing.Optional[int]` -
-
+Specifies the page number to retrieve, enabling pagination. -**when:** `typing.Optional[When]` — Specify whether to include jobs created before or after a given `timestamp_ms`. +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.
@@ -82,11 +70,11 @@ Include only jobs of this status in the response. There are four possible status
-**timestamp_ms:** `typing.Optional[int]` +**page_size:** `typing.Optional[int]` -Provide a timestamp in milliseconds to filter jobs. +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. -When combined with the `when` parameter, you can filter jobs before or after the given timestamp. Defaults to the current Unix timestamp if one is not provided. +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10.
@@ -94,15 +82,7 @@ When combined with the `when` parameter, you can filter jobs before or after the
-**sort_by:** `typing.Optional[SortBy]` - -Specify which timestamp to sort the jobs by. - -- `created`: Sort jobs by the time of creation, indicated by `created_timestamp_ms`. - -- `started`: Sort jobs by the time processing started, indicated by `started_timestamp_ms`. - -- `ended`: Sort jobs by the time processing ended, indicated by `ended_timestamp_ms`. +**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false.
@@ -110,13 +90,7 @@ Specify which timestamp to sort the jobs by.
-**direction:** `typing.Optional[Direction]` - -Specify the order in which to sort the jobs. Defaults to descending order. - -- `asc`: Sort in ascending order (chronological, with the oldest records first). - -- `desc`: Sort in descending order (reverse-chronological, with the newest records first). +**name:** `typing.Optional[str]` — Filter to only include tools with name.
@@ -136,7 +110,7 @@ Specify the order in which to sort the jobs. Defaults to descending order.
-
client.expression_measurement.batch.start_inference_job(...) +
client.empathic_voice.tools.create_tool(...)
@@ -148,7 +122,9 @@ Specify the order in which to sort the jobs. Defaults to descending order.
-Start a new measurement inference job. +Creates a **Tool** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). + +Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -168,9 +144,12 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.expression_measurement.batch.start_inference_job( - urls=["https://hume-tutorials.s3.amazonaws.com/faces.zip"], - notify=True, +client.empathic_voice.tools.create_tool( + name="get_current_weather", + parameters='{ "type": "object", "properties": { "location": { "type": "string", "description": "The city and state, e.g. San Francisco, CA" }, "format": { "type": "string", "enum": ["celsius", "fahrenheit"], "description": "The temperature unit to use. Infer this from the users location." } }, "required": ["location", "format"] }', + version_description="Fetches current weather and uses celsius or fahrenheit based on location of user.", + description="This tool is for getting the current weather.", + fallback_content="Unable to fetch current weather.", ) ``` @@ -187,19 +166,7 @@ client.expression_measurement.batch.start_inference_job(
-**models:** `typing.Optional[Models]` - -Specify the models to use for inference. - -If this field is not explicitly set, then all models will run by default. - -
-
- -
-
- -**transcription:** `typing.Optional[Transcription]` +**name:** `str` — Name applied to all versions of a particular Tool.
@@ -207,11 +174,11 @@ If this field is not explicitly set, then all models will run by default.
-**urls:** `typing.Optional[typing.Sequence[str]]` +**parameters:** `str` -URLs to the media files to be processed. Each must be a valid public URL to a media file (see recommended input filetypes) or an archive (`.zip`, `.tar.gz`, `.tar.bz2`, `.tar.xz`) of media files. +Stringified JSON defining the parameters used by this version of the Tool. -If you wish to supply more than 100 URLs, consider providing them as an archive (`.zip`, `.tar.gz`, `.tar.bz2`, `.tar.xz`). +These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format.
@@ -219,7 +186,7 @@ If you wish to supply more than 100 URLs, consider providing them as an archive
-**text:** `typing.Optional[typing.Sequence[str]]` — Text supplied directly to our Emotional Language and NER models for analysis. +**version_description:** `typing.Optional[str]` — An optional description of the Tool version.
@@ -227,7 +194,7 @@ If you wish to supply more than 100 URLs, consider providing them as an archive
-**callback_url:** `typing.Optional[str]` — If provided, a `POST` request will be made to the URL with the generated predictions on completion or the error message on failure. +**description:** `typing.Optional[str]` — An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function.
@@ -235,7 +202,7 @@ If you wish to supply more than 100 URLs, consider providing them as an archive
-**notify:** `typing.Optional[bool]` — Whether to send an email notification to the user upon job completion/failure. +**fallback_content:** `typing.Optional[str]` — Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors.
@@ -255,7 +222,7 @@ If you wish to supply more than 100 URLs, consider providing them as an archive
-
client.expression_measurement.batch.get_job_details(...) +
client.empathic_voice.tools.list_tool_versions(...)
@@ -267,7 +234,9 @@ If you wish to supply more than 100 URLs, consider providing them as an archive
-Get the request details and state of a given job. +Fetches a list of a **Tool's** versions. + +Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -287,8 +256,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.expression_measurement.batch.get_job_details( - id="job_id", +client.empathic_voice.tools.list_tool_versions( + id="00183a3f-79ba-413d-9f3b-609864268bea", ) ``` @@ -305,7 +274,39 @@ client.expression_measurement.batch.get_job_details(
-**id:** `str` — The unique identifier for the job. +**id:** `str` — Identifier for a Tool. Formatted as a UUID. + +
+
+ +
+
+ +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. + +
+
+ +
+
+ +**page_size:** `typing.Optional[int]` + +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. + +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
+ +
+
+ +**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false.
@@ -325,7 +326,7 @@ client.expression_measurement.batch.get_job_details(
-
client.expression_measurement.batch.get_job_predictions(...) +
client.empathic_voice.tools.create_tool_version(...)
@@ -337,7 +338,9 @@ client.expression_measurement.batch.get_job_details(
-Get the JSON predictions of a completed inference job. +Updates a **Tool** by creating a new version of the **Tool**. + +Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -357,8 +360,12 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.expression_measurement.batch.get_job_predictions( - id="job_id", +client.empathic_voice.tools.create_tool_version( + id="00183a3f-79ba-413d-9f3b-609864268bea", + parameters='{ "type": "object", "properties": { "location": { "type": "string", "description": "The city and state, e.g. San Francisco, CA" }, "format": { "type": "string", "enum": ["celsius", "fahrenheit", "kelvin"], "description": "The temperature unit to use. Infer this from the users location." } }, "required": ["location", "format"] }', + version_description="Fetches current weather and uses celsius, fahrenheit, or kelvin based on location of user.", + fallback_content="Unable to fetch current weather.", + description="This tool is for getting the current weather.", ) ``` @@ -375,7 +382,43 @@ client.expression_measurement.batch.get_job_predictions(
-**id:** `str` — The unique identifier for the job. +**id:** `str` — Identifier for a Tool. Formatted as a UUID. + +
+
+ +
+
+ +**parameters:** `str` + +Stringified JSON defining the parameters used by this version of the Tool. + +These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format. + +
+
+ +
+
+ +**version_description:** `typing.Optional[str]` — An optional description of the Tool version. + +
+
+ +
+
+ +**description:** `typing.Optional[str]` — An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function. + +
+
+ +
+
+ +**fallback_content:** `typing.Optional[str]` — Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors.
@@ -395,7 +438,7 @@ client.expression_measurement.batch.get_job_predictions(
-
client.expression_measurement.batch.start_inference_job_from_local_file(...) +
client.empathic_voice.tools.delete_tool(...)
@@ -407,7 +450,9 @@ client.expression_measurement.batch.get_job_predictions(
-Start a new batch inference job. +Deletes a **Tool** and its versions. + +Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -427,7 +472,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.expression_measurement.batch.start_inference_job_from_local_file() +client.empathic_voice.tools.delete_tool( + id="00183a3f-79ba-413d-9f3b-609864268bea", +) ``` @@ -443,17 +490,7 @@ client.expression_measurement.batch.start_inference_job_from_local_file()
-**file:** `from __future__ import annotations - -typing.List[core.File]` — See core.File for more documentation - -
-
- -
-
- -**json:** `typing.Optional[InferenceBaseRequest]` — Stringified JSON object containing the inference job configuration. +**id:** `str` — Identifier for a Tool. Formatted as a UUID.
@@ -473,8 +510,7 @@ typing.List[core.File]` — See core.File for more documentation
-## EmpathicVoice Tools -
client.empathic_voice.tools.list_tools(...) +
client.empathic_voice.tools.update_tool_name(...)
@@ -486,7 +522,7 @@ typing.List[core.File]` — See core.File for more documentation
-Fetches a paginated list of **Tools**. +Updates the name of a **Tool**. Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -508,15 +544,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -response = client.empathic_voice.tools.list_tools( - page_number=0, - page_size=2, +client.empathic_voice.tools.update_tool_name( + id="00183a3f-79ba-413d-9f3b-609864268bea", + name="get_current_temperature", ) -for item in response: - yield item -# alternatively, you can paginate page-by-page -for page in response.iter_pages(): - yield page ```
@@ -532,39 +563,15 @@ for page in response.iter_pages():
-**page_number:** `typing.Optional[int]` +**id:** `str` — Identifier for a Tool. Formatted as a UUID. + +
+
-Specifies the page number to retrieve, enabling pagination. +
+
-This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. - -
-
- -
-
- -**page_size:** `typing.Optional[int]` - -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. - -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. - -
-
- -
-
- -**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false. - -
-
- -
-
- -**name:** `typing.Optional[str]` — Filter to only include tools with name. +**name:** `str` — Name applied to all versions of a particular Tool.
@@ -584,7 +591,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.tools.create_tool(...) +
client.empathic_voice.tools.get_tool_version(...)
@@ -596,7 +603,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Creates a **Tool** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). +Fetches a specified version of a **Tool**. Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -618,12 +625,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.create_tool( - name="get_current_weather", - parameters='{ "type": "object", "properties": { "location": { "type": "string", "description": "The city and state, e.g. San Francisco, CA" }, "format": { "type": "string", "enum": ["celsius", "fahrenheit"], "description": "The temperature unit to use. Infer this from the users location." } }, "required": ["location", "format"] }', - version_description="Fetches current weather and uses celsius or fahrenheit based on location of user.", - description="This tool is for getting the current weather.", - fallback_content="Unable to fetch current weather.", +client.empathic_voice.tools.get_tool_version( + id="00183a3f-79ba-413d-9f3b-609864268bea", + version=1, ) ``` @@ -640,19 +644,7 @@ client.empathic_voice.tools.create_tool(
-**name:** `str` — Name applied to all versions of a particular Tool. - -
-
- -
-
- -**parameters:** `str` - -Stringified JSON defining the parameters used by this version of the Tool. - -These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format. +**id:** `str` — Identifier for a Tool. Formatted as a UUID.
@@ -660,23 +652,13 @@ These parameters define the inputs needed for the Tool’s execution, including
-**version_description:** `typing.Optional[str]` — An optional description of the Tool version. - -
-
- -
-
+**version:** `int` -**description:** `typing.Optional[str]` — An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function. - -
-
+Version number for a Tool. -
-
+Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. -**fallback_content:** `typing.Optional[str]` — Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors. +Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
@@ -696,7 +678,7 @@ These parameters define the inputs needed for the Tool’s execution, including
-
client.empathic_voice.tools.list_tool_versions(...) +
client.empathic_voice.tools.delete_tool_version(...)
@@ -708,7 +690,7 @@ These parameters define the inputs needed for the Tool’s execution, including
-Fetches a list of a **Tool's** versions. +Deletes a specified version of a **Tool**. Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -730,8 +712,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.list_tool_versions( +client.empathic_voice.tools.delete_tool_version( id="00183a3f-79ba-413d-9f3b-609864268bea", + version=1, ) ``` @@ -756,31 +739,13 @@ client.empathic_voice.tools.list_tool_versions(
-**page_number:** `typing.Optional[int]` - -Specifies the page number to retrieve, enabling pagination. - -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. - -
-
- -
-
- -**page_size:** `typing.Optional[int]` - -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. +**version:** `int` -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. - -
-
+Version number for a Tool. -
-
+Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. -**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false. +Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
@@ -800,7 +765,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.tools.create_tool_version(...) +
client.empathic_voice.tools.update_tool_description(...)
@@ -812,7 +777,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Updates a **Tool** by creating a new version of the **Tool**. +Updates the description of a specified **Tool** version. Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI.
@@ -834,12 +799,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.create_tool_version( +client.empathic_voice.tools.update_tool_description( id="00183a3f-79ba-413d-9f3b-609864268bea", - parameters='{ "type": "object", "properties": { "location": { "type": "string", "description": "The city and state, e.g. San Francisco, CA" }, "format": { "type": "string", "enum": ["celsius", "fahrenheit", "kelvin"], "description": "The temperature unit to use. Infer this from the users location." } }, "required": ["location", "format"] }', - version_description="Fetches current weather and uses celsius, fahrenheit, or kelvin based on location of user.", - fallback_content="Unable to fetch current weather.", - description="This tool is for getting the current weather.", + version=1, + version_description="Fetches current temperature, precipitation, wind speed, AQI, and other weather conditions. Uses Celsius, Fahrenheit, or kelvin depending on user's region.", ) ``` @@ -864,27 +827,13 @@ client.empathic_voice.tools.create_tool_version(
-**parameters:** `str` - -Stringified JSON defining the parameters used by this version of the Tool. - -These parameters define the inputs needed for the Tool’s execution, including the expected data type and description for each input field. Structured as a stringified JSON schema, this format ensures the Tool receives data in the expected format. - -
-
- -
-
+**version:** `int` -**version_description:** `typing.Optional[str]` — An optional description of the Tool version. - -
-
+Version number for a Tool. -
-
+Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. -**description:** `typing.Optional[str]` — An optional description of what the Tool does, used by the supplemental LLM to choose when and how to call the function. +Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number.
@@ -892,7 +841,7 @@ These parameters define the inputs needed for the Tool’s execution, including
-**fallback_content:** `typing.Optional[str]` — Optional text passed to the supplemental LLM in place of the tool call result. The LLM then uses this text to generate a response back to the user, ensuring continuity in the conversation if the Tool errors. +**version_description:** `typing.Optional[str]` — An optional description of the Tool version.
@@ -912,7 +861,8 @@ These parameters define the inputs needed for the Tool’s execution, including
-
client.empathic_voice.tools.delete_tool(...) +## EmpathicVoice Prompts +
client.empathic_voice.prompts.list_prompts(...)
@@ -924,9 +874,9 @@ These parameters define the inputs needed for the Tool’s execution, including
-Deletes a **Tool** and its versions. +Fetches a paginated list of **Prompts**. -Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI. +See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -946,9 +896,15 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.delete_tool( - id="00183a3f-79ba-413d-9f3b-609864268bea", +response = client.empathic_voice.prompts.list_prompts( + page_number=0, + page_size=2, ) +for item in response: + yield item +# alternatively, you can paginate page-by-page +for page in response.iter_pages(): + yield page ``` @@ -964,7 +920,39 @@ client.empathic_voice.tools.delete_tool(
-**id:** `str` — Identifier for a Tool. Formatted as a UUID. +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. + +
+
+ +
+
+ +**page_size:** `typing.Optional[int]` + +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. + +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
+ +
+
+ +**restrict_to_most_recent:** `typing.Optional[bool]` — Only include the most recent version of each prompt in the list. + +
+
+ +
+
+ +**name:** `typing.Optional[str]` — Filter to only include prompts with name.
@@ -984,7 +972,7 @@ client.empathic_voice.tools.delete_tool(
-
client.empathic_voice.tools.update_tool_name(...) +
client.empathic_voice.prompts.create_prompt(...)
@@ -996,9 +984,9 @@ client.empathic_voice.tools.delete_tool(
-Updates the name of a **Tool**. +Creates a **Prompt** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). -Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI. +See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1018,9 +1006,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.update_tool_name( - id="00183a3f-79ba-413d-9f3b-609864268bea", - name="get_current_temperature", +client.empathic_voice.prompts.create_prompt( + name="Weather Assistant Prompt", + text="You are an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.", ) ``` @@ -1037,7 +1025,7 @@ client.empathic_voice.tools.update_tool_name(
-**id:** `str` — Identifier for a Tool. Formatted as a UUID. +**name:** `str` — Name applied to all versions of a particular Prompt.
@@ -1045,7 +1033,21 @@ client.empathic_voice.tools.update_tool_name(
-**name:** `str` — Name applied to all versions of a particular Tool. +**text:** `str` + +Instructions used to shape EVI’s behavior, responses, and style. + +You can use the Prompt to define a specific goal or role for EVI, specifying how it should act or what it should focus on during the conversation. For example, EVI can be instructed to act as a customer support representative, a fitness coach, or a travel advisor, each with its own set of behaviors and response styles. + +For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice-interface-evi/prompting). + +
+
+ +
+
+ +**version_description:** `typing.Optional[str]` — An optional description of the Prompt version.
@@ -1065,7 +1067,7 @@ client.empathic_voice.tools.update_tool_name(
-
client.empathic_voice.tools.get_tool_version(...) +
client.empathic_voice.prompts.list_prompt_versions(...)
@@ -1077,9 +1079,9 @@ client.empathic_voice.tools.update_tool_name(
-Fetches a specified version of a **Tool**. +Fetches a list of a **Prompt's** versions. -Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI. +See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1099,9 +1101,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.get_tool_version( - id="00183a3f-79ba-413d-9f3b-609864268bea", - version=1, +client.empathic_voice.prompts.list_prompt_versions( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", ) ``` @@ -1118,7 +1119,7 @@ client.empathic_voice.tools.get_tool_version(
-**id:** `str` — Identifier for a Tool. Formatted as a UUID. +**id:** `str` — Identifier for a Prompt. Formatted as a UUID.
@@ -1126,13 +1127,11 @@ client.empathic_voice.tools.get_tool_version(
-**version:** `int` - -Version number for a Tool. +**page_number:** `typing.Optional[int]` -Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. +Specifies the page number to retrieve, enabling pagination. -Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number. +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.
@@ -1140,33 +1139,53 @@ Version numbers are integer values representing different iterations of the Tool
-**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. - -
-
- -
+**page_size:** `typing.Optional[int]` +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + -
-
client.empathic_voice.tools.delete_tool_version(...)
-#### 📝 Description +**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each prompt. To include all versions of each prompt in the list, set `restrict_to_most_recent` to false. + +
+
+ +
+
+ +**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. + +
+
+ + + + + + +
+
client.empathic_voice.prompts.create_prompt_verison(...)
+#### 📝 Description +
-Deletes a specified version of a **Tool**. +
+
-Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI. +Updates a **Prompt** by creating a new version of the **Prompt**. + +See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1186,9 +1205,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.delete_tool_version( - id="00183a3f-79ba-413d-9f3b-609864268bea", - version=1, +client.empathic_voice.prompts.create_prompt_verison( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", + text="You are an updated version of an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.", + version_description="This is an updated version of the Weather Assistant Prompt.", ) ``` @@ -1205,7 +1225,7 @@ client.empathic_voice.tools.delete_tool_version(
-**id:** `str` — Identifier for a Tool. Formatted as a UUID. +**id:** `str` — Identifier for a Prompt. Formatted as a UUID.
@@ -1213,13 +1233,21 @@ client.empathic_voice.tools.delete_tool_version(
-**version:** `int` +**text:** `str` -Version number for a Tool. +Instructions used to shape EVI’s behavior, responses, and style for this version of the Prompt. -Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. +You can use the Prompt to define a specific goal or role for EVI, specifying how it should act or what it should focus on during the conversation. For example, EVI can be instructed to act as a customer support representative, a fitness coach, or a travel advisor, each with its own set of behaviors and response styles. -Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number. +For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice-interface-evi/prompting). + +
+
+ +
+
+ +**version_description:** `typing.Optional[str]` — An optional description of the Prompt version.
@@ -1239,7 +1267,7 @@ Version numbers are integer values representing different iterations of the Tool
-
client.empathic_voice.tools.update_tool_description(...) +
client.empathic_voice.prompts.delete_prompt(...)
@@ -1251,9 +1279,9 @@ Version numbers are integer values representing different iterations of the Tool
-Updates the description of a specified **Tool** version. +Deletes a **Prompt** and its versions. -Refer to our [tool use](/docs/empathic-voice-interface-evi/tool-use#function-calling) guide for comprehensive instructions on defining and integrating tools into EVI. +See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1273,10 +1301,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.tools.update_tool_description( - id="00183a3f-79ba-413d-9f3b-609864268bea", - version=1, - version_description="Fetches current temperature, precipitation, wind speed, AQI, and other weather conditions. Uses Celsius, Fahrenheit, or kelvin depending on user's region.", +client.empathic_voice.prompts.delete_prompt( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", ) ``` @@ -1293,29 +1319,7 @@ client.empathic_voice.tools.update_tool_description(
-**id:** `str` — Identifier for a Tool. Formatted as a UUID. - -
-
- -
-
- -**version:** `int` - -Version number for a Tool. - -Tools, Configs, Custom Voices, and Prompts are versioned. This versioning system supports iterative development, allowing you to progressively refine tools and revert to previous versions if needed. - -Version numbers are integer values representing different iterations of the Tool. Each update to the Tool increments its version number. - -
-
- -
-
- -**version_description:** `typing.Optional[str]` — An optional description of the Tool version. +**id:** `str` — Identifier for a Prompt. Formatted as a UUID.
@@ -1335,8 +1339,7 @@ Version numbers are integer values representing different iterations of the Tool
-## EmpathicVoice Prompts -
client.empathic_voice.prompts.list_prompts(...) +
client.empathic_voice.prompts.update_prompt_name(...)
@@ -1348,7 +1351,7 @@ Version numbers are integer values representing different iterations of the Tool
-Fetches a paginated list of **Prompts**. +Updates the name of a **Prompt**. See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1370,15 +1373,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -response = client.empathic_voice.prompts.list_prompts( - page_number=0, - page_size=2, +client.empathic_voice.prompts.update_prompt_name( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", + name="Updated Weather Assistant Prompt Name", ) -for item in response: - yield item -# alternatively, you can paginate page-by-page -for page in response.iter_pages(): - yield page ```
@@ -1394,31 +1392,7 @@ for page in response.iter_pages():
-**page_number:** `typing.Optional[int]` - -Specifies the page number to retrieve, enabling pagination. - -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. - -
-
- -
-
- -**page_size:** `typing.Optional[int]` - -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. - -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. - -
-
- -
-
- -**restrict_to_most_recent:** `typing.Optional[bool]` — Only include the most recent version of each prompt in the list. +**id:** `str` — Identifier for a Prompt. Formatted as a UUID.
@@ -1426,7 +1400,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**name:** `typing.Optional[str]` — Filter to only include prompts with name. +**name:** `str` — Name applied to all versions of a particular Prompt.
@@ -1446,7 +1420,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.prompts.create_prompt(...) +
client.empathic_voice.prompts.get_prompt_version(...)
@@ -1458,7 +1432,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Creates a **Prompt** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). +Fetches a specified version of a **Prompt**. See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1480,9 +1454,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.create_prompt( - name="Weather Assistant Prompt", - text="You are an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.", +client.empathic_voice.prompts.get_prompt_version( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", + version=0, ) ``` @@ -1499,7 +1473,7 @@ client.empathic_voice.prompts.create_prompt(
-**name:** `str` — Name applied to all versions of a particular Prompt. +**id:** `str` — Identifier for a Prompt. Formatted as a UUID.
@@ -1507,21 +1481,13 @@ client.empathic_voice.prompts.create_prompt(
-**text:** `str` - -Instructions used to shape EVI’s behavior, responses, and style. - -You can use the Prompt to define a specific goal or role for EVI, specifying how it should act or what it should focus on during the conversation. For example, EVI can be instructed to act as a customer support representative, a fitness coach, or a travel advisor, each with its own set of behaviors and response styles. +**version:** `int` -For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice-interface-evi/prompting). - -
-
+Version number for a Prompt. -
-
+Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. -**version_description:** `typing.Optional[str]` — An optional description of the Prompt version. +Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number.
@@ -1541,7 +1507,7 @@ For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice
-
client.empathic_voice.prompts.list_prompt_versions(...) +
client.empathic_voice.prompts.delete_prompt_version(...)
@@ -1553,7 +1519,7 @@ For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice
-Fetches a list of a **Prompt's** versions. +Deletes a specified version of a **Prompt**. See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1575,8 +1541,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.list_prompt_versions( +client.empathic_voice.prompts.delete_prompt_version( id="af699d45-2985-42cc-91b9-af9e5da3bac5", + version=1, ) ``` @@ -1601,31 +1568,13 @@ client.empathic_voice.prompts.list_prompt_versions(
-**page_number:** `typing.Optional[int]` - -Specifies the page number to retrieve, enabling pagination. - -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. - -
-
- -
-
- -**page_size:** `typing.Optional[int]` - -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. +**version:** `int` -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. - -
-
+Version number for a Prompt. -
-
+Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. -**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each prompt. To include all versions of each prompt in the list, set `restrict_to_most_recent` to false. +Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number.
@@ -1645,7 +1594,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.prompts.create_prompt_verison(...) +
client.empathic_voice.prompts.update_prompt_description(...)
@@ -1657,7 +1606,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Updates a **Prompt** by creating a new version of the **Prompt**. +Updates the description of a **Prompt**. See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt.
@@ -1679,10 +1628,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.create_prompt_verison( +client.empathic_voice.prompts.update_prompt_description( id="af699d45-2985-42cc-91b9-af9e5da3bac5", - text="You are an updated version of an AI weather assistant providing users with accurate and up-to-date weather information. Respond to user queries concisely and clearly. Use simple language and avoid technical jargon. Provide temperature, precipitation, wind conditions, and any weather alerts. Include helpful tips if severe weather is expected.", - version_description="This is an updated version of the Weather Assistant Prompt.", + version=1, + version_description="This is an updated version_description.", ) ``` @@ -1707,13 +1656,13 @@ client.empathic_voice.prompts.create_prompt_verison(
-**text:** `str` +**version:** `int` -Instructions used to shape EVI’s behavior, responses, and style for this version of the Prompt. +Version number for a Prompt. -You can use the Prompt to define a specific goal or role for EVI, specifying how it should act or what it should focus on during the conversation. For example, EVI can be instructed to act as a customer support representative, a fitness coach, or a travel advisor, each with its own set of behaviors and response styles. +Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. -For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice-interface-evi/prompting). +Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number.
@@ -1741,7 +1690,8 @@ For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice
-
client.empathic_voice.prompts.delete_prompt(...) +## EmpathicVoice CustomVoices +
client.empathic_voice.custom_voices.list_custom_voices(...)
@@ -1753,9 +1703,9 @@ For help writing a system prompt, see our [Prompting Guide](/docs/empathic-voice
-Deletes a **Prompt** and its versions. +Fetches a paginated list of **Custom Voices**. -See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt. +Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice.
@@ -1775,9 +1725,7 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.delete_prompt( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", -) +client.empathic_voice.custom_voices.list_custom_voices() ``` @@ -1793,7 +1741,31 @@ client.empathic_voice.prompts.delete_prompt(
-**id:** `str` — Identifier for a Prompt. Formatted as a UUID. +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. + +
+
+ +
+
+ +**page_size:** `typing.Optional[int]` + +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. + +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
+ +
+
+ +**name:** `typing.Optional[str]` — Filter to only include custom voices with name.
@@ -1813,7 +1785,7 @@ client.empathic_voice.prompts.delete_prompt(
-
client.empathic_voice.prompts.update_prompt_name(...) +
client.empathic_voice.custom_voices.create_custom_voice(...)
@@ -1825,9 +1797,9 @@ client.empathic_voice.prompts.delete_prompt(
-Updates the name of a **Prompt**. +Creates a **Custom Voice** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). -See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt. +Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice.
@@ -1847,9 +1819,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.update_prompt_name( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", - name="Updated Weather Assistant Prompt Name", +client.empathic_voice.custom_voices.create_custom_voice( + name="name", + base_voice="ITO", ) ``` @@ -1866,7 +1838,7 @@ client.empathic_voice.prompts.update_prompt_name(
-**id:** `str` — Identifier for a Prompt. Formatted as a UUID. +**name:** `str` — The name of the Custom Voice. Maximum length of 75 characters. Will be converted to all-uppercase. (e.g., "sample voice" becomes "SAMPLE VOICE")
@@ -1874,7 +1846,19 @@ client.empathic_voice.prompts.update_prompt_name(
-**name:** `str` — Name applied to all versions of a particular Prompt. +**base_voice:** `PostedCustomVoiceBaseVoice` — Specifies the base voice used to create the Custom Voice. + +
+
+ +
+
+ +**parameters:** `typing.Optional[PostedCustomVoiceParameters]` + +The specified attributes of a Custom Voice. + +If no parameters are specified then all attributes will be set to their defaults, meaning no modfications will be made to the base voice.
@@ -1894,7 +1878,7 @@ client.empathic_voice.prompts.update_prompt_name(
-
client.empathic_voice.prompts.get_prompt_version(...) +
client.empathic_voice.custom_voices.get_custom_voice(...)
@@ -1906,9 +1890,9 @@ client.empathic_voice.prompts.update_prompt_name(
-Fetches a specified version of a **Prompt**. +Fetches a specific **Custom Voice** by ID. -See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt. +Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice.
@@ -1928,9 +1912,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.get_prompt_version( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", - version=0, +client.empathic_voice.custom_voices.get_custom_voice( + id="id", ) ``` @@ -1947,21 +1930,7 @@ client.empathic_voice.prompts.get_prompt_version(
-**id:** `str` — Identifier for a Prompt. Formatted as a UUID. - -
-
- -
-
- -**version:** `int` - -Version number for a Prompt. - -Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. - -Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number. +**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID.
@@ -1981,7 +1950,7 @@ Version numbers are integer values representing different iterations of the Prom
-
client.empathic_voice.prompts.delete_prompt_version(...) +
client.empathic_voice.custom_voices.create_custom_voice_version(...)
@@ -1993,9 +1962,9 @@ Version numbers are integer values representing different iterations of the Prom
-Deletes a specified version of a **Prompt**. +Updates a **Custom Voice** by creating a new version of the **Custom Voice**. -See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt. +Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice.
@@ -2015,9 +1984,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.delete_prompt_version( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", - version=1, +client.empathic_voice.custom_voices.create_custom_voice_version( + id="id", + name="name", + base_voice="ITO", ) ``` @@ -2034,7 +2004,7 @@ client.empathic_voice.prompts.delete_prompt_version(
-**id:** `str` — Identifier for a Prompt. Formatted as a UUID. +**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID.
@@ -2042,13 +2012,27 @@ client.empathic_voice.prompts.delete_prompt_version(
-**version:** `int` +**name:** `str` — The name of the Custom Voice. Maximum length of 75 characters. Will be converted to all-uppercase. (e.g., "sample voice" becomes "SAMPLE VOICE") + +
+
-Version number for a Prompt. +
+
-Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. +**base_voice:** `PostedCustomVoiceBaseVoice` — Specifies the base voice used to create the Custom Voice. + +
+
-Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number. +
+
+ +**parameters:** `typing.Optional[PostedCustomVoiceParameters]` + +The specified attributes of a Custom Voice. + +If no parameters are specified then all attributes will be set to their defaults, meaning no modfications will be made to the base voice.
@@ -2068,7 +2052,7 @@ Version numbers are integer values representing different iterations of the Prom
-
client.empathic_voice.prompts.update_prompt_description(...) +
client.empathic_voice.custom_voices.delete_custom_voice(...)
@@ -2080,9 +2064,9 @@ Version numbers are integer values representing different iterations of the Prom
-Updates the description of a **Prompt**. +Deletes a **Custom Voice** and its versions. -See our [prompting guide](/docs/empathic-voice-interface-evi/phone-calling) for tips on crafting your system prompt. +Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice.
@@ -2102,10 +2086,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.prompts.update_prompt_description( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", - version=1, - version_description="This is an updated version_description.", +client.empathic_voice.custom_voices.delete_custom_voice( + id="id", ) ``` @@ -2122,29 +2104,7 @@ client.empathic_voice.prompts.update_prompt_description(
-**id:** `str` — Identifier for a Prompt. Formatted as a UUID. - -
-
- -
-
- -**version:** `int` - -Version number for a Prompt. - -Prompts, Configs, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine prompts and revert to previous versions if needed. - -Version numbers are integer values representing different iterations of the Prompt. Each update to the Prompt increments its version number. - -
-
- -
-
- -**version_description:** `typing.Optional[str]` — An optional description of the Prompt version. +**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID.
@@ -2164,8 +2124,8 @@ Version numbers are integer values representing different iterations of the Prom
-## EmpathicVoice CustomVoices -
client.empathic_voice.custom_voices.list_custom_voices(...) +## EmpathicVoice Configs +
client.empathic_voice.configs.list_configs(...)
@@ -2177,9 +2137,9 @@ Version numbers are integer values representing different iterations of the Prom
-Fetches a paginated list of **Custom Voices**. +Fetches a paginated list of **Configs**. -Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice. +For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -2199,7 +2159,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.custom_voices.list_custom_voices() +client.empathic_voice.configs.list_configs( + page_number=0, + page_size=1, +) ``` @@ -2239,7 +2202,15 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**name:** `typing.Optional[str]` — Filter to only include custom voices with name. +**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false. + +
+
+ +
+
+ +**name:** `typing.Optional[str]` — Filter to only include configs with this name.
@@ -2259,7 +2230,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.custom_voices.create_custom_voice(...) +
client.empathic_voice.configs.create_config(...)
@@ -2271,9 +2242,9 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Creates a **Custom Voice** that can be added to an [EVI configuration](/reference/empathic-voice-interface-evi/configs/create-config). +Creates a **Config** which can be applied to EVI. -Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice. +For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -2289,13 +2260,47 @@ Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for detai ```python from hume import HumeClient +from hume.empathic_voice import ( + PostedConfigPromptSpec, + PostedEventMessageSpec, + PostedEventMessageSpecs, + PostedLanguageModel, + PostedVoice, +) client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.custom_voices.create_custom_voice( - name="name", - base_voice="ITO", +client.empathic_voice.configs.create_config( + name="Weather Assistant Config", + prompt=PostedConfigPromptSpec( + id="af699d45-2985-42cc-91b9-af9e5da3bac5", + version=0, + ), + evi_version="2", + voice=PostedVoice( + provider="HUME_AI", + name="SAMPLE VOICE", + ), + language_model=PostedLanguageModel( + model_provider="ANTHROPIC", + model_resource="claude-3-5-sonnet-20240620", + temperature=1.0, + ), + event_messages=PostedEventMessageSpecs( + on_new_chat=PostedEventMessageSpec( + enabled=False, + text="", + ), + on_inactivity_timeout=PostedEventMessageSpec( + enabled=False, + text="", + ), + on_max_duration_timeout=PostedEventMessageSpec( + enabled=False, + text="", + ), + ), ) ``` @@ -2312,7 +2317,7 @@ client.empathic_voice.custom_voices.create_custom_voice(
-**name:** `str` — The name of the Custom Voice. Maximum length of 75 characters. Will be converted to all-uppercase. (e.g., "sample voice" becomes "SAMPLE VOICE") +**evi_version:** `str` — Specifies the EVI version to use. Use `"1"` for version 1, or `"2"` for the latest enhanced version. For a detailed comparison of the two versions, refer to our [guide](/docs/empathic-voice-interface-evi/evi-2).
@@ -2320,7 +2325,7 @@ client.empathic_voice.custom_voices.create_custom_voice(
-**base_voice:** `PostedCustomVoiceBaseVoice` — Specifies the base voice used to create the Custom Voice. +**name:** `str` — Name applied to all versions of a particular Config.
@@ -2328,11 +2333,7 @@ client.empathic_voice.custom_voices.create_custom_voice(
-**parameters:** `typing.Optional[PostedCustomVoiceParameters]` - -The specified attributes of a Custom Voice. - -If no parameters are specified then all attributes will be set to their defaults, meaning no modfications will be made to the base voice. +**version_description:** `typing.Optional[str]` — An optional description of the Config version.
@@ -2340,71 +2341,47 @@ If no parameters are specified then all attributes will be set to their defaults
-**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. +**prompt:** `typing.Optional[PostedConfigPromptSpec]`
- -
- - - - -
-
client.empathic_voice.custom_voices.get_custom_voice(...)
-#### 📝 Description +**voice:** `typing.Optional[PostedVoice]` — A voice specification associated with this Config. + +
+
-
-
+**language_model:** `typing.Optional[PostedLanguageModel]` -Fetches a specific **Custom Voice** by ID. +The supplemental language model associated with this Config. -Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice. -
-
+This model is used to generate longer, more detailed responses from EVI. Choosing an appropriate supplemental language model for your use case is crucial for generating fast, high-quality responses from EVI. +
-#### 🔌 Usage -
-
-
- -```python -from hume import HumeClient +**ellm_model:** `typing.Optional[PostedEllmModel]` -client = HumeClient( - api_key="YOUR_API_KEY", -) -client.empathic_voice.custom_voices.get_custom_voice( - id="id", -) +The eLLM setup associated with this Config. -``` -
-
+Hume's eLLM (empathic Large Language Model) is a multimodal language model that takes into account both expression measures and language. The eLLM generates short, empathic language responses and guides text-to-speech (TTS) prosody. +
-#### ⚙️ Parameters -
-
-
- -**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID. +**tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedUserDefinedToolSpec]]]` — List of user-defined tools associated with this Config.
@@ -2412,73 +2389,7 @@ client.empathic_voice.custom_voices.get_custom_voice(
-**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. - -
-
-
-
- - - - -
- -
client.empathic_voice.custom_voices.create_custom_voice_version(...) -
-
- -#### 📝 Description - -
-
- -
-
- -Updates a **Custom Voice** by creating a new version of the **Custom Voice**. - -Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice. -
-
-
-
- -#### 🔌 Usage - -
-
- -
-
- -```python -from hume import HumeClient - -client = HumeClient( - api_key="YOUR_API_KEY", -) -client.empathic_voice.custom_voices.create_custom_voice_version( - id="id", - name="name", - base_voice="ITO", -) - -``` -
-
-
-
- -#### ⚙️ Parameters - -
-
- -
-
- -**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID. +**builtin_tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedBuiltinTool]]]` — List of built-in tools associated with this Config.
@@ -2486,7 +2397,7 @@ client.empathic_voice.custom_voices.create_custom_voice_version(
-**name:** `str` — The name of the Custom Voice. Maximum length of 75 characters. Will be converted to all-uppercase. (e.g., "sample voice" becomes "SAMPLE VOICE") +**event_messages:** `typing.Optional[PostedEventMessageSpecs]`
@@ -2494,7 +2405,7 @@ client.empathic_voice.custom_voices.create_custom_voice_version(
-**base_voice:** `PostedCustomVoiceBaseVoice` — Specifies the base voice used to create the Custom Voice. +**timeouts:** `typing.Optional[PostedTimeoutSpecs]`
@@ -2502,11 +2413,7 @@ client.empathic_voice.custom_voices.create_custom_voice_version(
-**parameters:** `typing.Optional[PostedCustomVoiceParameters]` - -The specified attributes of a Custom Voice. - -If no parameters are specified then all attributes will be set to their defaults, meaning no modfications will be made to the base voice. +**webhooks:** `typing.Optional[typing.Sequence[typing.Optional[PostedWebhookSpec]]]` — Webhook config specifications for each subscriber.
@@ -2526,7 +2433,7 @@ If no parameters are specified then all attributes will be set to their defaults
-
client.empathic_voice.custom_voices.delete_custom_voice(...) +
client.empathic_voice.configs.list_config_versions(...)
@@ -2538,9 +2445,9 @@ If no parameters are specified then all attributes will be set to their defaults
-Deletes a **Custom Voice** and its versions. +Fetches a list of a **Config's** versions. -Refer to our [voices guide](/docs/empathic-voice-interface-evi/voices) for details on creating a custom voice. +For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -2560,8 +2467,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.custom_voices.delete_custom_voice( - id="id", +client.empathic_voice.configs.list_config_versions( + id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", ) ``` @@ -2578,76 +2485,10 @@ client.empathic_voice.custom_voices.delete_custom_voice(
-**id:** `str` — Identifier for a Custom Voice. Formatted as a UUID. - -
-
- -
-
- -**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. +**id:** `str` — Identifier for a Config. Formatted as a UUID.
- -
- - - - -
- -## EmpathicVoice Configs -
client.empathic_voice.configs.list_configs(...) -
-
- -#### 📝 Description - -
-
- -
-
- -Fetches a paginated list of **Configs**. - -For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration). -
-
-
-
- -#### 🔌 Usage - -
-
- -
-
- -```python -from hume import HumeClient - -client = HumeClient( - api_key="YOUR_API_KEY", -) -client.empathic_voice.configs.list_configs( - page_number=0, - page_size=1, -) - -``` -
-
-
-
- -#### ⚙️ Parameters - -
-
@@ -2676,15 +2517,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each tool. To include all versions of each tool in the list, set `restrict_to_most_recent` to false. - -
-
- -
-
- -**name:** `typing.Optional[str]` — Filter to only include configs with this name. +**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each config. To include all versions of each config in the list, set `restrict_to_most_recent` to false.
@@ -2704,7 +2537,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.configs.create_config(...) +
client.empathic_voice.configs.create_config_version(...)
@@ -2716,7 +2549,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Creates a **Config** which can be applied to EVI. +Updates a **Config** by creating a new version of the **Config**. For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -2736,6 +2569,7 @@ For more details on configuration options and how to configure EVI, see our [con from hume import HumeClient from hume.empathic_voice import ( PostedConfigPromptSpec, + PostedEllmModel, PostedEventMessageSpec, PostedEventMessageSpecs, PostedLanguageModel, @@ -2745,22 +2579,26 @@ from hume.empathic_voice import ( client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.create_config( - name="Weather Assistant Config", +client.empathic_voice.configs.create_config_version( + id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", + version_description="This is an updated version of the Weather Assistant Config.", + evi_version="2", prompt=PostedConfigPromptSpec( id="af699d45-2985-42cc-91b9-af9e5da3bac5", version=0, ), - evi_version="2", voice=PostedVoice( provider="HUME_AI", - name="SAMPLE VOICE", + name="ITO", ), language_model=PostedLanguageModel( model_provider="ANTHROPIC", model_resource="claude-3-5-sonnet-20240620", temperature=1.0, ), + ellm_model=PostedEllmModel( + allow_short_responses=True, + ), event_messages=PostedEventMessageSpecs( on_new_chat=PostedEventMessageSpec( enabled=False, @@ -2791,7 +2629,7 @@ client.empathic_voice.configs.create_config(
-**evi_version:** `str` — Specifies the EVI version to use. Use `"1"` for version 1, or `"2"` for the latest enhanced version. For a detailed comparison of the two versions, refer to our [guide](/docs/empathic-voice-interface-evi/evi-2). +**id:** `str` — Identifier for a Config. Formatted as a UUID.
@@ -2799,7 +2637,7 @@ client.empathic_voice.configs.create_config(
-**name:** `str` — Name applied to all versions of a particular Config. +**evi_version:** `str` — The version of the EVI used with this config.
@@ -2823,7 +2661,7 @@ client.empathic_voice.configs.create_config(
-**voice:** `typing.Optional[PostedVoice]` — A voice specification associated with this Config. +**voice:** `typing.Optional[PostedVoice]` — A voice specification associated with this Config version.
@@ -2833,7 +2671,7 @@ client.empathic_voice.configs.create_config( **language_model:** `typing.Optional[PostedLanguageModel]` -The supplemental language model associated with this Config. +The supplemental language model associated with this Config version. This model is used to generate longer, more detailed responses from EVI. Choosing an appropriate supplemental language model for your use case is crucial for generating fast, high-quality responses from EVI. @@ -2845,7 +2683,7 @@ This model is used to generate longer, more detailed responses from EVI. Choosin **ellm_model:** `typing.Optional[PostedEllmModel]` -The eLLM setup associated with this Config. +The eLLM setup associated with this Config version. Hume's eLLM (empathic Large Language Model) is a multimodal language model that takes into account both expression measures and language. The eLLM generates short, empathic language responses and guides text-to-speech (TTS) prosody. @@ -2855,7 +2693,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-**tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedUserDefinedToolSpec]]]` — List of user-defined tools associated with this Config. +**tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedUserDefinedToolSpec]]]` — List of user-defined tools associated with this Config version.
@@ -2863,7 +2701,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-**builtin_tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedBuiltinTool]]]` — List of built-in tools associated with this Config. +**builtin_tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedBuiltinTool]]]` — List of built-in tools associated with this Config version.
@@ -2907,7 +2745,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-
client.empathic_voice.configs.list_config_versions(...) +
client.empathic_voice.configs.delete_config(...)
@@ -2919,7 +2757,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-Fetches a list of a **Config's** versions. +Deletes a **Config** and its versions. For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -2941,7 +2779,7 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.list_config_versions( +client.empathic_voice.configs.delete_config( id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", ) @@ -2967,38 +2805,6 @@ client.empathic_voice.configs.list_config_versions(
-**page_number:** `typing.Optional[int]` - -Specifies the page number to retrieve, enabling pagination. - -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. - -
-
- -
-
- -**page_size:** `typing.Optional[int]` - -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. - -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. - -
-
- -
-
- -**restrict_to_most_recent:** `typing.Optional[bool]` — By default, `restrict_to_most_recent` is set to true, returning only the latest version of each config. To include all versions of each config in the list, set `restrict_to_most_recent` to false. - -
-
- -
-
- **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
@@ -3011,7 +2817,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.configs.create_config_version(...) +
client.empathic_voice.configs.update_config_name(...)
@@ -3023,7 +2829,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Updates a **Config** by creating a new version of the **Config**. +Updates the name of a **Config**. For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -3041,52 +2847,13 @@ For more details on configuration options and how to configure EVI, see our [con ```python from hume import HumeClient -from hume.empathic_voice import ( - PostedConfigPromptSpec, - PostedEllmModel, - PostedEventMessageSpec, - PostedEventMessageSpecs, - PostedLanguageModel, - PostedVoice, -) client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.create_config_version( +client.empathic_voice.configs.update_config_name( id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", - version_description="This is an updated version of the Weather Assistant Config.", - evi_version="2", - prompt=PostedConfigPromptSpec( - id="af699d45-2985-42cc-91b9-af9e5da3bac5", - version=0, - ), - voice=PostedVoice( - provider="HUME_AI", - name="ITO", - ), - language_model=PostedLanguageModel( - model_provider="ANTHROPIC", - model_resource="claude-3-5-sonnet-20240620", - temperature=1.0, - ), - ellm_model=PostedEllmModel( - allow_short_responses=True, - ), - event_messages=PostedEventMessageSpecs( - on_new_chat=PostedEventMessageSpec( - enabled=False, - text="", - ), - on_inactivity_timeout=PostedEventMessageSpec( - enabled=False, - text="", - ), - on_max_duration_timeout=PostedEventMessageSpec( - enabled=False, - text="", - ), - ), + name="Updated Weather Assistant Config Name", ) ``` @@ -3111,7 +2878,7 @@ client.empathic_voice.configs.create_config_version(
-**evi_version:** `str` — The version of the EVI used with this config. +**name:** `str` — Name applied to all versions of a particular Config.
@@ -3119,71 +2886,72 @@ client.empathic_voice.configs.create_config_version(
-**version_description:** `typing.Optional[str]` — An optional description of the Config version. +**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
+
+
-
-
-**prompt:** `typing.Optional[PostedConfigPromptSpec]` -
+
+
client.empathic_voice.configs.get_config_version(...)
-**voice:** `typing.Optional[PostedVoice]` — A voice specification associated with this Config version. - -
-
+#### 📝 Description
-**language_model:** `typing.Optional[PostedLanguageModel]` +
+
-The supplemental language model associated with this Config version. +Fetches a specified version of a **Config**. -This model is used to generate longer, more detailed responses from EVI. Choosing an appropriate supplemental language model for your use case is crucial for generating fast, high-quality responses from EVI. - +For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
+
+
+ +#### 🔌 Usage
-**ellm_model:** `typing.Optional[PostedEllmModel]` +
+
-The eLLM setup associated with this Config version. +```python +from hume import HumeClient -Hume's eLLM (empathic Large Language Model) is a multimodal language model that takes into account both expression measures and language. The eLLM generates short, empathic language responses and guides text-to-speech (TTS) prosody. - +client = HumeClient( + api_key="YOUR_API_KEY", +) +client.empathic_voice.configs.get_config_version( + id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", + version=1, +) + +```
- -
-
- -**tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedUserDefinedToolSpec]]]` — List of user-defined tools associated with this Config version. -
+#### ⚙️ Parameters +
-**builtin_tools:** `typing.Optional[typing.Sequence[typing.Optional[PostedBuiltinTool]]]` — List of built-in tools associated with this Config version. - -
-
-
-**event_messages:** `typing.Optional[PostedEventMessageSpecs]` +**id:** `str` — Identifier for a Config. Formatted as a UUID.
@@ -3191,15 +2959,13 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-**timeouts:** `typing.Optional[PostedTimeoutSpecs]` - -
-
+**version:** `int` -
-
+Version number for a Config. -**webhooks:** `typing.Optional[typing.Sequence[typing.Optional[PostedWebhookSpec]]]` — Webhook config specifications for each subscriber. +Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. + +Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number.
@@ -3219,7 +2985,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-
client.empathic_voice.configs.delete_config(...) +
client.empathic_voice.configs.delete_config_version(...)
@@ -3231,7 +2997,7 @@ Hume's eLLM (empathic Large Language Model) is a multimodal language model that
-Deletes a **Config** and its versions. +Deletes a specified version of a **Config**. For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -3253,8 +3019,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.delete_config( +client.empathic_voice.configs.delete_config_version( id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", + version=1, ) ``` @@ -3279,6 +3046,20 @@ client.empathic_voice.configs.delete_config(
+**version:** `int` + +Version number for a Config. + +Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. + +Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number. + +
+
+ +
+
+ **request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
@@ -3291,7 +3072,7 @@ client.empathic_voice.configs.delete_config(
-
client.empathic_voice.configs.update_config_name(...) +
client.empathic_voice.configs.update_config_description(...)
@@ -3303,7 +3084,7 @@ client.empathic_voice.configs.delete_config(
-Updates the name of a **Config**. +Updates the description of a **Config**. For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration).
@@ -3325,9 +3106,10 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.update_config_name( +client.empathic_voice.configs.update_config_description( id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", - name="Updated Weather Assistant Config Name", + version=1, + version_description="This is an updated version_description.", ) ``` @@ -3352,7 +3134,21 @@ client.empathic_voice.configs.update_config_name(
-**name:** `str` — Name applied to all versions of a particular Config. +**version:** `int` + +Version number for a Config. + +Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. + +Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number. + +
+
+ +
+
+ +**version_description:** `typing.Optional[str]` — An optional description of the Config version.
@@ -3372,7 +3168,8 @@ client.empathic_voice.configs.update_config_name(
-
client.empathic_voice.configs.get_config_version(...) +## EmpathicVoice Chats +
client.empathic_voice.chats.list_chats(...)
@@ -3384,9 +3181,7 @@ client.empathic_voice.configs.update_config_name(
-Fetches a specified version of a **Config**. - -For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration). +Fetches a paginated list of **Chats**.
@@ -3406,10 +3201,16 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.get_config_version( - id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", - version=1, +response = client.empathic_voice.chats.list_chats( + page_number=0, + page_size=1, + ascending_order=True, ) +for item in response: + yield item +# alternatively, you can paginate page-by-page +for page in response.iter_pages(): + yield page ``` @@ -3425,7 +3226,11 @@ client.empathic_voice.configs.get_config_version(
-**id:** `str` — Identifier for a Config. Formatted as a UUID. +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.
@@ -3433,13 +3238,27 @@ client.empathic_voice.configs.get_config_version(
-**version:** `int` +**page_size:** `typing.Optional[int]` -Version number for a Config. +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. -Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
-Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number. +
+
+ +**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true. + +
+
+ +
+
+ +**config_id:** `typing.Optional[str]` — Filter to only include chats that used this config.
@@ -3459,7 +3278,7 @@ Version numbers are integer values representing different iterations of the Conf
-
client.empathic_voice.configs.delete_config_version(...) +
client.empathic_voice.chats.list_chat_events(...)
@@ -3471,9 +3290,7 @@ Version numbers are integer values representing different iterations of the Conf
-Deletes a specified version of a **Config**. - -For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration). +Fetches a paginated list of **Chat** events.
@@ -3493,10 +3310,17 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.delete_config_version( - id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", - version=1, +response = client.empathic_voice.chats.list_chat_events( + id="470a49f6-1dec-4afe-8b61-035d3b2d63b0", + page_number=0, + page_size=3, + ascending_order=True, ) +for item in response: + yield item +# alternatively, you can paginate page-by-page +for page in response.iter_pages(): + yield page ``` @@ -3512,7 +3336,7 @@ client.empathic_voice.configs.delete_config_version(
-**id:** `str` — Identifier for a Config. Formatted as a UUID. +**id:** `str` — Identifier for a Chat. Formatted as a UUID.
@@ -3520,13 +3344,31 @@ client.empathic_voice.configs.delete_config_version(
-**version:** `int` +**page_size:** `typing.Optional[int]` -Version number for a Config. +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. -Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
-Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number. +
+
+ +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. + +
+
+ +
+
+ +**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.
@@ -3546,7 +3388,7 @@ Version numbers are integer values representing different iterations of the Conf
-
client.empathic_voice.configs.update_config_description(...) +
client.empathic_voice.chats.get_audio(...)
@@ -3558,9 +3400,7 @@ Version numbers are integer values representing different iterations of the Conf
-Updates the description of a **Config**. - -For more details on configuration options and how to configure EVI, see our [configuration guide](/docs/empathic-voice-interface-evi/configuration). +Fetches the audio of a previous **Chat**. For more details, see our guide on audio reconstruction [here](/docs/empathic-voice-interface-evi/faq#can-i-access-the-audio-of-previous-conversations-with-evi).
@@ -3580,10 +3420,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.configs.update_config_description( - id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", - version=1, - version_description="This is an updated version_description.", +client.empathic_voice.chats.get_audio( + id="470a49f6-1dec-4afe-8b61-035d3b2d63b0", ) ``` @@ -3600,29 +3438,7 @@ client.empathic_voice.configs.update_config_description(
-**id:** `str` — Identifier for a Config. Formatted as a UUID. - -
-
- -
-
- -**version:** `int` - -Version number for a Config. - -Configs, Prompts, Custom Voices, and Tools are versioned. This versioning system supports iterative development, allowing you to progressively refine configurations and revert to previous versions if needed. - -Version numbers are integer values representing different iterations of the Config. Each update to the Config increments its version number. - -
-
- -
-
- -**version_description:** `typing.Optional[str]` — An optional description of the Config version. +**id:** `str` — Identifier for a chat. Formatted as a UUID.
@@ -3642,8 +3458,8 @@ Version numbers are integer values representing different iterations of the Conf
-## EmpathicVoice Chats -
client.empathic_voice.chats.list_chats(...) +## EmpathicVoice ChatGroups +
client.empathic_voice.chat_groups.list_chat_groups(...)
@@ -3655,7 +3471,7 @@ Version numbers are integer values representing different iterations of the Conf
-Fetches a paginated list of **Chats**. +Fetches a paginated list of **Chat Groups**.
@@ -3675,16 +3491,12 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -response = client.empathic_voice.chats.list_chats( +client.empathic_voice.chat_groups.list_chat_groups( page_number=0, page_size=1, ascending_order=True, + config_id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", ) -for item in response: - yield item -# alternatively, you can paginate page-by-page -for page in response.iter_pages(): - yield page ``` @@ -3732,7 +3544,11 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**config_id:** `typing.Optional[str]` — Filter to only include chats that used this config. +**config_id:** `typing.Optional[str]` + +The unique identifier for an EVI configuration. + +Filter Chat Groups to only include Chats that used this `config_id` in their most recent Chat.
@@ -3752,7 +3568,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-
client.empathic_voice.chats.list_chat_events(...) +
client.empathic_voice.chat_groups.get_chat_group(...)
@@ -3764,7 +3580,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-Fetches a paginated list of **Chat** events. +Fetches a **ChatGroup** by ID, including a paginated list of **Chats** associated with the **ChatGroup**.
@@ -3784,17 +3600,12 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -response = client.empathic_voice.chats.list_chat_events( - id="470a49f6-1dec-4afe-8b61-035d3b2d63b0", +client.empathic_voice.chat_groups.get_chat_group( + id="697056f0-6c7e-487d-9bd8-9c19df79f05f", page_number=0, - page_size=3, + page_size=1, ascending_order=True, ) -for item in response: - yield item -# alternatively, you can paginate page-by-page -for page in response.iter_pages(): - yield page ``` @@ -3810,7 +3621,7 @@ for page in response.iter_pages():
-**id:** `str` — Identifier for a Chat. Formatted as a UUID. +**id:** `str` — Identifier for a Chat Group. Formatted as a UUID.
@@ -3862,7 +3673,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-
client.empathic_voice.chats.get_audio(...) +
client.empathic_voice.chat_groups.list_chat_group_events(...)
@@ -3874,7 +3685,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-Fetches the audio of a previous **Chat**. For more details, see our guide on audio reconstruction [here](/docs/empathic-voice-interface-evi/faq#can-i-access-the-audio-of-previous-conversations-with-evi). +Fetches a paginated list of **Chat** events associated with a **Chat Group**.
@@ -3894,8 +3705,11 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.chats.get_audio( - id="470a49f6-1dec-4afe-8b61-035d3b2d63b0", +client.empathic_voice.chat_groups.list_chat_group_events( + id="697056f0-6c7e-487d-9bd8-9c19df79f05f", + page_number=0, + page_size=3, + ascending_order=True, ) ``` @@ -3912,7 +3726,39 @@ client.empathic_voice.chats.get_audio(
-**id:** `str` — Identifier for a chat. Formatted as a UUID. +**id:** `str` — Identifier for a Chat Group. Formatted as a UUID. + +
+
+ +
+
+ +**page_size:** `typing.Optional[int]` + +Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. + +For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + +
+
+ +
+
+ +**page_number:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. + +
+
+ +
+
+ +**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.
@@ -3932,8 +3778,7 @@ client.empathic_voice.chats.get_audio(
-## EmpathicVoice ChatGroups -
client.empathic_voice.chat_groups.list_chat_groups(...) +
client.empathic_voice.chat_groups.get_audio(...)
@@ -3945,7 +3790,7 @@ client.empathic_voice.chats.get_audio(
-Fetches a paginated list of **Chat Groups**. +Fetches a paginated list of audio for each **Chat** within the specified **Chat Group**. For more details, see our guide on audio reconstruction [here](/docs/empathic-voice-interface-evi/faq#can-i-access-the-audio-of-previous-conversations-with-evi).
@@ -3965,11 +3810,11 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.chat_groups.list_chat_groups( +client.empathic_voice.chat_groups.get_audio( + id="369846cf-6ad5-404d-905e-a8acb5cdfc78", page_number=0, - page_size=1, + page_size=10, ascending_order=True, - config_id="1b60e1a0-cc59-424a-8d2c-189d354db3f3", ) ``` @@ -3986,11 +3831,7 @@ client.empathic_voice.chat_groups.list_chat_groups(
-**page_number:** `typing.Optional[int]` - -Specifies the page number to retrieve, enabling pagination. - -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. +**id:** `str` — Identifier for a Chat Group. Formatted as a UUID.
@@ -3998,7 +3839,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-**page_size:** `typing.Optional[int]` +**page_number:** `typing.Optional[int]` Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. @@ -4010,7 +3851,11 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true. +**page_size:** `typing.Optional[int]` + +Specifies the page number to retrieve, enabling pagination. + +This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.
@@ -4018,11 +3863,7 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**config_id:** `typing.Optional[str]` - -The unique identifier for an EVI configuration. - -Filter Chat Groups to only include Chats that used this `config_id` in their most recent Chat. +**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.
@@ -4042,7 +3883,8 @@ Filter Chat Groups to only include Chats that used this `config_id` in their mos
-
client.empathic_voice.chat_groups.get_chat_group(...) +## ExpressionMeasurement Batch +
client.expression_measurement.batch.list_jobs(...)
@@ -4054,7 +3896,7 @@ Filter Chat Groups to only include Chats that used this `config_id` in their mos
-Fetches a **ChatGroup** by ID, including a paginated list of **Chats** associated with the **ChatGroup**. +Sort and filter jobs.
@@ -4074,12 +3916,7 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.chat_groups.get_chat_group( - id="697056f0-6c7e-487d-9bd8-9c19df79f05f", - page_number=0, - page_size=1, - ascending_order=True, -) +client.expression_measurement.batch.list_jobs() ``` @@ -4095,7 +3932,7 @@ client.empathic_voice.chat_groups.get_chat_group(
-**id:** `str` — Identifier for a Chat Group. Formatted as a UUID. +**limit:** `typing.Optional[int]` — The maximum number of jobs to include in the response.
@@ -4103,11 +3940,17 @@ client.empathic_voice.chat_groups.get_chat_group(
-**page_size:** `typing.Optional[int]` +**status:** `typing.Optional[typing.Union[Status, typing.Sequence[Status]]]` -Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. +Include only jobs of this status in the response. There are four possible statuses: -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. +- `QUEUED`: The job has been received and is waiting to be processed. + +- `IN_PROGRESS`: The job is currently being processed. + +- `COMPLETED`: The job has finished processing. + +- `FAILED`: The job encountered an error and could not be completed successfully.
@@ -4115,11 +3958,19 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**page_number:** `typing.Optional[int]` +**when:** `typing.Optional[When]` — Specify whether to include jobs created before or after a given `timestamp_ms`. + +
+
-Specifies the page number to retrieve, enabling pagination. +
+
-This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. +**timestamp_ms:** `typing.Optional[int]` + +Provide a timestamp in milliseconds to filter jobs. + +When combined with the `when` parameter, you can filter jobs before or after the given timestamp. Defaults to the current Unix timestamp if one is not provided.
@@ -4127,7 +3978,29 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true. +**sort_by:** `typing.Optional[SortBy]` + +Specify which timestamp to sort the jobs by. + +- `created`: Sort jobs by the time of creation, indicated by `created_timestamp_ms`. + +- `started`: Sort jobs by the time processing started, indicated by `started_timestamp_ms`. + +- `ended`: Sort jobs by the time processing ended, indicated by `ended_timestamp_ms`. + +
+
+ +
+
+ +**direction:** `typing.Optional[Direction]` + +Specify the order in which to sort the jobs. Defaults to descending order. + +- `asc`: Sort in ascending order (chronological, with the oldest records first). + +- `desc`: Sort in descending order (reverse-chronological, with the newest records first).
@@ -4147,7 +4020,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-
client.empathic_voice.chat_groups.list_chat_group_events(...) +
client.expression_measurement.batch.start_inference_job(...)
@@ -4159,7 +4032,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-Fetches a paginated list of **Chat** events associated with a **Chat Group**. +Start a new measurement inference job.
@@ -4179,11 +4052,9 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.chat_groups.list_chat_group_events( - id="697056f0-6c7e-487d-9bd8-9c19df79f05f", - page_number=0, - page_size=3, - ascending_order=True, +client.expression_measurement.batch.start_inference_job( + urls=["https://hume-tutorials.s3.amazonaws.com/faces.zip"], + notify=True, ) ``` @@ -4200,7 +4071,11 @@ client.empathic_voice.chat_groups.list_chat_group_events(
-**id:** `str` — Identifier for a Chat Group. Formatted as a UUID. +**models:** `typing.Optional[Models]` + +Specify the models to use for inference. + +If this field is not explicitly set, then all models will run by default.
@@ -4208,11 +4083,19 @@ client.empathic_voice.chat_groups.list_chat_group_events(
-**page_size:** `typing.Optional[int]` +**transcription:** `typing.Optional[Transcription]` + +
+
-Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. +
+
-For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. +**urls:** `typing.Optional[typing.Sequence[str]]` + +URLs to the media files to be processed. Each must be a valid public URL to a media file (see recommended input filetypes) or an archive (`.zip`, `.tar.gz`, `.tar.bz2`, `.tar.xz`) of media files. + +If you wish to supply more than 100 URLs, consider providing them as an archive (`.zip`, `.tar.gz`, `.tar.bz2`, `.tar.xz`).
@@ -4220,11 +4103,15 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**page_number:** `typing.Optional[int]` +**text:** `typing.Optional[typing.Sequence[str]]` — Text supplied directly to our Emotional Language and NER models for analysis. + +
+
-Specifies the page number to retrieve, enabling pagination. +
+
-This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. +**callback_url:** `typing.Optional[str]` — If provided, a `POST` request will be made to the URL with the generated predictions on completion or the error message on failure.
@@ -4232,7 +4119,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true. +**notify:** `typing.Optional[bool]` — Whether to send an email notification to the user upon job completion/failure.
@@ -4252,7 +4139,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-
client.empathic_voice.chat_groups.get_audio(...) +
client.expression_measurement.batch.get_job_details(...)
@@ -4264,7 +4151,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-Fetches a paginated list of audio for each **Chat** within the specified **Chat Group**. For more details, see our guide on audio reconstruction [here](/docs/empathic-voice-interface-evi/faq#can-i-access-the-audio-of-previous-conversations-with-evi). +Get the request details and state of a given job.
@@ -4284,11 +4171,8 @@ from hume import HumeClient client = HumeClient( api_key="YOUR_API_KEY", ) -client.empathic_voice.chat_groups.get_audio( - id="369846cf-6ad5-404d-905e-a8acb5cdfc78", - page_number=0, - page_size=10, - ascending_order=True, +client.expression_measurement.batch.get_job_details( + id="job_id", ) ``` @@ -4305,7 +4189,7 @@ client.empathic_voice.chat_groups.get_audio(
-**id:** `str` — Identifier for a Chat Group. Formatted as a UUID. +**id:** `str` — The unique identifier for the job.
@@ -4313,11 +4197,69 @@ client.empathic_voice.chat_groups.get_audio(
-**page_number:** `typing.Optional[int]` +**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. + +
+
+ +
-Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive. -For example, if `page_size` is set to 10, each page will include up to 10 items. Defaults to 10. + + +
+ +
client.expression_measurement.batch.get_job_predictions(...) +
+
+ +#### 📝 Description + +
+
+ +
+
+ +Get the JSON predictions of a completed inference job. +
+
+
+
+ +#### 🔌 Usage + +
+
+ +
+
+ +```python +from hume import HumeClient + +client = HumeClient( + api_key="YOUR_API_KEY", +) +client.expression_measurement.batch.get_job_predictions( + id="job_id", +) + +``` +
+
+
+
+ +#### ⚙️ Parameters + +
+
+ +
+
+ +**id:** `str` — The unique identifier for the job.
@@ -4325,11 +4267,69 @@ For example, if `page_size` is set to 10, each page will include up to 10 items.
-**page_size:** `typing.Optional[int]` +**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration. + +
+
+
+
-Specifies the page number to retrieve, enabling pagination. -This parameter uses zero-based indexing. For example, setting `page_number` to 0 retrieves the first page of results (items 0-9 if `page_size` is 10), setting `page_number` to 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page. +
+
+
+ +
client.expression_measurement.batch.start_inference_job_from_local_file(...) +
+
+ +#### 📝 Description + +
+
+ +
+
+ +Start a new batch inference job. +
+
+
+
+ +#### 🔌 Usage + +
+
+ +
+
+ +```python +from hume import HumeClient + +client = HumeClient( + api_key="YOUR_API_KEY", +) +client.expression_measurement.batch.start_inference_job_from_local_file() + +``` +
+
+
+
+ +#### ⚙️ Parameters + +
+
+ +
+
+ +**file:** `from __future__ import annotations + +typing.List[core.File]` — See core.File for more documentation
@@ -4337,7 +4337,7 @@ This parameter uses zero-based indexing. For example, setting `page_number` to 0
-**ascending_order:** `typing.Optional[bool]` — Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true. +**json:** `typing.Optional[InferenceBaseRequest]` — Stringified JSON object containing the inference job configuration.
diff --git a/src/hume/base_client.py b/src/hume/base_client.py index d293f18..889ec35 100644 --- a/src/hume/base_client.py +++ b/src/hume/base_client.py @@ -4,11 +4,11 @@ from .environment import HumeClientEnvironment import httpx from .core.client_wrapper import SyncClientWrapper -from .expression_measurement.client import ExpressionMeasurementClient from .empathic_voice.client import EmpathicVoiceClient +from .expression_measurement.client import ExpressionMeasurementClient from .core.client_wrapper import AsyncClientWrapper -from .expression_measurement.client import AsyncExpressionMeasurementClient from .empathic_voice.client import AsyncEmpathicVoiceClient +from .expression_measurement.client import AsyncExpressionMeasurementClient class BaseHumeClient: @@ -69,8 +69,8 @@ def __init__( else httpx.Client(timeout=_defaulted_timeout), timeout=_defaulted_timeout, ) - self.expression_measurement = ExpressionMeasurementClient(client_wrapper=self._client_wrapper) self.empathic_voice = EmpathicVoiceClient(client_wrapper=self._client_wrapper) + self.expression_measurement = ExpressionMeasurementClient(client_wrapper=self._client_wrapper) class AsyncBaseHumeClient: @@ -131,8 +131,8 @@ def __init__( else httpx.AsyncClient(timeout=_defaulted_timeout), timeout=_defaulted_timeout, ) - self.expression_measurement = AsyncExpressionMeasurementClient(client_wrapper=self._client_wrapper) self.empathic_voice = AsyncEmpathicVoiceClient(client_wrapper=self._client_wrapper) + self.expression_measurement = AsyncExpressionMeasurementClient(client_wrapper=self._client_wrapper) def _get_base_url(*, base_url: typing.Optional[str] = None, environment: HumeClientEnvironment) -> str: