Skip to content

Commit 8a4c52c

Browse files
(fix): update AssistantEnd (#52)
1 parent 2829c63 commit 8a4c52c

File tree

12 files changed

+550
-471
lines changed

12 files changed

+550
-471
lines changed

.mock/definition/empathic-voice/__package__.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -963,7 +963,7 @@ types:
963963
docs: When provided, the output is an assistant end message.
964964
properties:
965965
type:
966-
type: literal<"assistant_message">
966+
type: literal<"assistant_end">
967967
docs: >-
968968
The type of message sent through the socket; for an Assistant End
969969
message, this must be `assistant_end`.

.mock/definition/empathic-voice/chat.yml

+81-4
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,100 @@ channel:
44
query-parameters:
55
config_id:
66
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).
819
config_version:
920
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.
1134
resumed_chat_group_id:
1235
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.
1478
access_token:
1579
type: optional<string>
1680
docs: >-
1781
Access token used for authenticating the client. If not provided, an
1882
`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).
1992
api_key:
2093
type: optional<string>
2194
docs: >-
2295
API key used for authenticating the client. If not provided, an
2396
`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).
24101
messages:
25102
subscribe:
26103
origin: server
@@ -36,7 +113,7 @@ channel:
36113
data: data
37114
- type: subscribe
38115
body:
39-
type: assistant_message
116+
type: assistant_end
40117
imports:
41118
root: __package__.yml
42119
types:

package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "hume",
3-
"version": "0.8.1-beta3",
3+
"version": "0.8.1-beta4",
44
"private": false,
55
"repository": "https://github.com/HumeAI/hume-typescript-sdk",
66
"main": "./index.js",

0 commit comments

Comments
 (0)