@ray-js/t-agent 0.0.8-beta-2 → 0.0.8-beta-3

package/README-zh_CN.md

@@ -1,5 +1,3 @@
-[English](./README.md) | 简体中文
-
 # AI 智能体 SDK
 
 ## 安装（ray 小程序）
@@ -1175,7 +1173,7 @@ const MyTilePart = () => {
 
 ### 替换或新增 tile
 
-如果你需要将某个 tile 替换成自己的实现，或者新增一个 tile，可以复写 `renderTileAs`，例如：
+如果你需要将某个 tile 替换成自己的实现，或者新增一个 tile，可以覆写 `renderTileAs`，例如：
 
 ```tsx
 import { ImageTileData } from '@ray-js/t-agent';
@@ -1348,3 +1346,45 @@ const renderOptions = {
 - `video:upload` 视频上传
 - `videoThumb:view` 视频缩略图查看
 - `videoThumb:upload` 视频缩略图上传
+
+### 自定义多语言
+
+如果你需要自定义 t-agent 里的多语言，可以覆写 `i18nTranslate` 函数，例如：
+
+```tsx
+import { defaultRenderOptions } from '@ray-js/t-agent-ui-ray';
+
+const renderOptions = {
+  ...defaultRenderOptions,
+  i18nTranslate: (key: string) => {
+    if (key === 'hello') {
+      return '你好';
+    }
+    // 使用默认的多语言
+    return I18n.t(key);
+  },
+};
+```
+
+以下是内置的多语言 key：
+
+| key                                                | 使用场景                  | 含义                 |
+| -------------------------------------------------- | ------------------------- | -------------------- |
+| t-agent.build-in.button.create_scene_manually      | ButtonTile 内置按钮       | 手动创建场景         |
+| t-agent.build-in.button.enter_home_manage          | ButtonTile 内置按钮       | 进入“家庭管理”       |
+| t-agent.build-in.button.enter_room_manage          | ButtonTile 内置按钮       | 进入“房间管理”       |
+| t-agent.build-in.button.enter_alarm_message        | ButtonTile 内置按钮       | 进入“告警消息列表”   |
+| t-agent.build-in.button.enter_home_message         | ButtonTile 内置按钮       | 进入“家庭消息列表”   |
+| t-agent.build-in.button.enter_bulletin             | ButtonTile 内置按钮       | 进入“通知消息列表”   |
+| t-agent.build-in.button.enter_notification_setting | ButtonTile 内置按钮       | 进入“消息推送设置”   |
+| t-agent.build-in.button.enter_personal_information | ButtonTile 内置按钮       | 进入“个人资料”       |
+| t-agent.build-in.button.enter_account_security     | ButtonTile 内置按钮       | 进入“账号与安全”     |
+| t-agent.build-in.button.enter_setting              | ButtonTile 内置按钮       | 进入“通用设置”       |
+| t-agent.build-in.button.enter_paring               | ButtonTile 内置按钮       | 进入“设备配网”       |
+| t-agent.build-in.button.enter_share_device         | ButtonTile 内置按钮       | 进入“设备分享”       |
+| t-agent.build-in.button.enter_faq_feedback         | ButtonTile 内置按钮       | 进入“常见问题与反馈” |
+| t-agent.build-in.button.questionnaire_take         | ButtonTile 内置按钮       | 填写问卷             |
+| t-agent.build-in.button.set_home_location          | ButtonTile 内置按钮       | 设置家庭位置         |
+| t-agent.input.voice.require-permission             | MessageInput 切换语音输入 | 需要授权录音权限     |
+| t-agent.input.upload.failed                        | MessageInput 上传文件     | 文件上传失败         |
+| t-agent.message.feedback.success                   | BubbleTile 消息评价       | 反馈成功             |

package/README.md

@@ -1,5 +1,3 @@
-English | [简体中文](./README-zh_CN.md)
-
 # AI Intelligent Agent SDK
 
 ## Installation (ray mini-program)
@@ -84,7 +82,7 @@ const createAgent = () => {
     hello.bubble.setText('Hello, world!');
     result.messages.push(hello);
     // Persist message for display upon next entry
-    await hello.persist('createText');
+    await hello.persist();
   });
 
   // Message upon chat resume
@@ -661,7 +659,7 @@ const createAgent = () => {
     withUI(), // Typically, the withUI plugin is necessary
     withAssistant({
       channel: 'your-channel-id', // Provide your agent ID
-      multiModal: false, // Enable multi-modal? Defaults to true
+      multiModal: false, // Enable multi-modal? Defaults to false
     }),
     withBuildIn()
   );
@@ -733,7 +731,7 @@ mock.hooks.hook('sendToAssistant', context => {
     context.responseText = 'Hello, who are you?';
   }
 
-  if (context.options.block?.includes('卡片')) {
+  if (context.options.block?.includes('card')) {
     context.responseText = 'This is a card example';
     context.responseExtensions = {
       aiCards: [
@@ -751,7 +749,7 @@ mock.hooks.hook('sendToAssistant', context => {
     };
   }
 
-  if (context.options.block?.includes('工作流')) {
+  if (context.options.block?.includes('workflow')) {
     context.responseText = 'This is a workflow';
     context.responseExtensions = {
       workflowAskOptions: {
@@ -1343,3 +1341,45 @@ The built-in `scene` includes the following:
 - `video:upload` Video uploading
 - `videoThumb:view` Video thumbnail viewing
 - `videoThumb:upload` Video thumbnail uploading
+
+### Custom Multilingual Support
+
+If you need to customize multilingual support, you can override the `i18nTranslate` function, for example:
+
+```tsx
+import { defaultRenderOptions } from '@ray-js/t-agent-ui-ray';
+
+const renderOptions = {
+  ...defaultRenderOptions,
+  i18nTranslate: (key: string) => {
+    if (key === 'hello') {
+      return 'Bonjour';
+    }
+    // Use default multilingual settings
+    return I18n.t(key);
+  },
+};
+```
+
+Below are the built-in multilingual keys:
+
+| key                                                | Usage Context                      | Meaning                            |
+| -------------------------------------------------- | ---------------------------------- | ---------------------------------- |
+| t-agent.build-in.button.create_scene_manually      | Built-in ButtonTile button         | Manually create scene              |
+| t-agent.build-in.button.enter_home_manage          | Built-in ButtonTile button         | Enter _"Home Management"_          |
+| t-agent.build-in.button.enter_room_manage          | Built-in ButtonTile button         | Enter _"Room Management"_          |
+| t-agent.build-in.button.enter_alarm_message        | Built-in ButtonTile button         | Enter _"Alarm Message List"_       |
+| t-agent.build-in.button.enter_home_message         | Built-in ButtonTile button         | Enter _"Home Message List"_        |
+| t-agent.build-in.button.enter_bulletin             | Built-in ButtonTile button         | Enter _"Bulletin Message List"_    |
+| t-agent.build-in.button.enter_notification_setting | Built-in ButtonTile button         | Enter _"Notification Settings"_    |
+| t-agent.build-in.button.enter_personal_information | Built-in ButtonTile button         | Enter _"Personal Information"_     |
+| t-agent.build-in.button.enter_account_security     | Built-in ButtonTile button         | Enter _"Account and Security"_     |
+| t-agent.build-in.button.enter_setting              | Built-in ButtonTile button         | Enter _"General Settings"_         |
+| t-agent.build-in.button.enter_paring               | Built-in ButtonTile button         | Enter _"Device Pairing"_           |
+| t-agent.build-in.button.enter_share_device         | Built-in ButtonTile button         | Enter _"Share Device"_             |
+| t-agent.build-in.button.enter_faq_feedback         | Built-in ButtonTile button         | Enter _"FAQs and Feedback"_        |
+| t-agent.build-in.button.questionnaire_take         | Built-in ButtonTile button         | Take the questionnaire             |
+| t-agent.build-in.button.set_home_location          | Built-in ButtonTile button         | Set home location                  |
+| t-agent.input.voice.require-permission             | MessageInput switch to voice input | Need to grant recording permission |
+| t-agent.input.upload.failed                        | MessageInput file upload           | File upload failed                 |
+| t-agent.message.feedback.success                   | BubbleTile message feedback        | Feedback successful                |

package/dist/chat/types.d.ts

@@ -26,6 +26,7 @@ export interface ButtonsTileData {
     buttons: Array<{
         text: string;
         type?: string;
+        [key: string]: any;
         clickPayload: any;
     }>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/t-agent",
-  "version": "0.0.8-beta-2",
+  "version": "0.0.8-beta-3",
   "author": "Tuya.inc",
   "license": "MIT",
   "private": false,
@@ -26,5 +26,5 @@
     "build": "ray build --type=component --output dist",
     "clean": "rimraf ./dist"
   },
-  "gitHead": "0fe6e7c1daafbeffd1394a7ee85ab4ae86d8f93e"
+  "gitHead": "686e9d17bd1a96074d3ac16ac2a3d73e1aa17f8f"
 }