UserConversationSimulationConfiguration Class
Configures the number, length, audio effects, and simulated user behavior of conversations.
Constructor
UserConversationSimulationConfiguration(*args: Any, **kwargs: Any)
Variables
| Name | Description |
|---|---|
|
max_num_turns
|
Hard limit on turns in each conversation. When omitted, the service defaults to 20. |
|
conversation_repetitions
|
Number of independent conversation repetitions for each test case. Defaults to 1 when not specified at either the data-source or test-case level. |
|
desired_num_turns
|
Target number of turns in each conversation. The effective value
cannot exceed the effective |
|
audio_effects
|
Audio effects applied to voice conversation simulations. This property is ignored for text-only simulations. |
|
user_behavior
|
Conversation behavior of the simulated user. |
Methods
| as_dict |
Return a dict that can be turned into json using json.dump. |
| clear |
Remove all items from the dictionary. |
| copy | |
| get |
Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: The value for key if key is in the dictionary, else default. :rtype: any |
| items | |
| keys | |
| pop |
Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given. |
| popitem |
Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if the dictionary is empty. |
| setdefault |
Return the value for key if key is in the dictionary; otherwise set the key to default and return default. :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: The value for key if key is in the dictionary, else default. :rtype: any |
| update |
Update the dictionary from a mapping or an iterable of key-value pairs. :param any args: Either a mapping object or an iterable of key-value pairs. |
| values |
as_dict
Return a dict that can be turned into json using json.dump.
as_dict(*, exclude_readonly: bool = False) -> dict[str, Any]
Keyword-Only Parameters
| Name | Description |
|---|---|
|
exclude_readonly
|
Whether to remove the readonly properties. Default value: False
|
Returns
| Type | Description |
|---|---|
|
A dict JSON compatible object |
clear
Remove all items from the dictionary.
clear() -> None
copy
copy() -> Model
get
Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: The value for key if key is in the dictionary, else default. :rtype: any
get(key: str, default: Any = None) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
Default value: None
|
items
items() -> ItemsView[str, Any]
Returns
| Type | Description |
|---|---|
|
a set-like object providing a view on the mapping's items |
keys
keys() -> KeysView[str]
Returns
| Type | Description |
|---|---|
|
a set-like object providing a view on the mapping's keys |
pop
Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given.
pop(key: str, default: ~typing.Any = <object object>) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
|
popitem
Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if the dictionary is empty.
popitem() -> tuple[str, Any]
setdefault
Return the value for key if key is in the dictionary; otherwise set the key to default and return default. :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: The value for key if key is in the dictionary, else default. :rtype: any
setdefault(key: str, default: ~typing.Any = <object object>) -> Any
Parameters
| Name | Description |
|---|---|
|
key
Required
|
|
|
default
|
|
update
Update the dictionary from a mapping or an iterable of key-value pairs. :param any args: Either a mapping object or an iterable of key-value pairs.
update(*args: Any, **kwargs: Any) -> None
values
values() -> ValuesView[Any]
Returns
| Type | Description |
|---|---|
|
an object providing a view on the mapping's values |
Attributes
audio_effects
Audio effects applied to voice conversation simulations. This property is ignored for text-only simulations.
audio_effects: _models.UserConversationSimulationAudioEffectsConfiguration | None
conversation_repetitions
Number of independent conversation repetitions for each test case. Defaults to 1 when not specified at either the data-source or test-case level.
conversation_repetitions: int | None
desired_num_turns
Target number of turns in each conversation. The effective value cannot exceed the effective
max_num_turns. When omitted, no target is set and the simulation model determines the
conversation length dynamically from the scenario.
desired_num_turns: int | None
max_num_turns
Hard limit on turns in each conversation. When omitted, the service defaults to 20.
max_num_turns: int | None
user_behavior
Conversation behavior of the simulated user.
user_behavior: _models.UserConversationSimulationUserBehaviorConfiguration | None