@@ -4,23 +4,100 @@ channel:
4
4
query-parameters :
5
5
config_id :
6
6
type : optional<string>
7
- docs : The unique identifier for the EVI configuration to be used.
7
+ docs : >-
8
+ The unique identifier for an EVI configuration.
9
+
10
+
11
+ Include this ID in your connection request to equip EVI with the Prompt,
12
+ Language Model, Voice, and Tools associated with the specified
13
+ configuration. If omitted, EVI will apply [default configuration
14
+ settings](/docs/empathic-voice-interface-evi/configuration#default-configuration).
15
+
16
+
17
+ For help obtaining this ID, see our [Configuration
18
+ Guide](/docs/empathic-voice-interface-evi/configuration).
8
19
config_version :
9
20
type : optional<integer>
10
- docs : The version number of the specified EVI configuration to be used.
21
+ docs : >-
22
+ The version number of the EVI configuration specified by the
23
+ `config_id`.
24
+
25
+
26
+ Configs, as well as Prompts, Tools, and Language Models, are versioned.
27
+ This versioning system supports iterative development, allowing you to
28
+ progressively refine configurations and revert to previous versions if
29
+ needed.
30
+
31
+
32
+ Include this parameter to apply a specific version of an EVI
33
+ configuration. If omitted, the latest version will be applied.
11
34
resumed_chat_group_id :
12
35
type : optional<string>
13
- docs : The unique identifier for a chat group. Used to resume a previous chat.
36
+ docs : >-
37
+ The unique identifier for a Chat Group. Use this field to preserve
38
+ context from a previous Chat session.
39
+
40
+
41
+ A Chat represents a single session from opening to closing a WebSocket
42
+ connection. In contrast, a Chat Group is a series of resumed Chats that
43
+ collectively represent a single conversation spanning multiple sessions.
44
+ Each Chat includes a Chat Group ID, which is used to preserve the
45
+ context of previous Chat sessions when starting a new one.
46
+
47
+
48
+ Including the Chat Group ID in the `resumed_chat_group_id` query
49
+ parameter is useful for seamlessly resuming a Chat after unexpected
50
+ network disconnections and for picking up conversations exactly where
51
+ you left off at a later time. This ensures preserved context across
52
+ multiple sessions.
53
+
54
+
55
+ There are three ways to obtain the Chat Group ID:
56
+
57
+
58
+ - [Chat
59
+ Metadata](/reference/empathic-voice-interface-evi/chat/chat#receive.Chat%20Metadata.type):
60
+ Upon establishing a WebSocket connection with EVI, the user receives a
61
+ Chat Metadata message. This message contains a `chat_group_id`, which
62
+ can be used to resume conversations within this chat group in future
63
+ sessions.
64
+
65
+
66
+ - [List Chats
67
+ endpoint](/reference/empathic-voice-interface-evi/chats/list-chats): Use
68
+ the GET `/v0/evi/chats` endpoint to obtain the Chat Group ID of
69
+ individual Chat sessions. This endpoint lists all available Chat
70
+ sessions and their associated Chat Group ID.
71
+
72
+
73
+ - [List Chat Groups
74
+ endpoint](/reference/empathic-voice-interface-evi/chat-groups/list-chat-groups):
75
+ Use the GET `/v0/evi/chat_groups` endpoint to obtain the Chat Group IDs
76
+ of all Chat Groups associated with an API key. This endpoint returns a
77
+ list of all available chat groups.
14
78
access_token :
15
79
type : optional<string>
16
80
docs : >-
17
81
Access token used for authenticating the client. If not provided, an
18
82
`api_key` must be provided to authenticate.
83
+
84
+
85
+ The access token is generated using both an API key and a Secret key,
86
+ which provides an additional layer of security compared to using just an
87
+ API key.
88
+
89
+
90
+ For more details, refer to the [Authentication Strategies
91
+ Guide](/docs/introduction/api-key#authentication-strategies).
19
92
api_key :
20
93
type : optional<string>
21
94
docs : >-
22
95
API key used for authenticating the client. If not provided, an
23
96
`access_token` must be provided to authenticate.
97
+
98
+
99
+ For more details, refer to the [Authentication Strategies
100
+ Guide](/docs/introduction/api-key#authentication-strategies).
24
101
messages :
25
102
subscribe :
26
103
origin : server
@@ -36,7 +113,7 @@ channel:
36
113
data : data
37
114
- type : subscribe
38
115
body :
39
- type : assistant_message
116
+ type : assistant_end
40
117
imports :
41
118
root : __package__.yml
42
119
types :
0 commit comments