Overview

The AI Agent SDK allows developers to quickly integrate AI conversation functionality into their own mini-programs, enabling developers to focus on implementing their business logic without wasting time on technical details.

Use the SmartLife App (version 6.0.0 and above) to scan the QR code below to experience the AI conversation functionality:

ray-ai-agent-chat

Quick Start

Version Notice

⚠️ Important Notice: @ray-js/t-agent-plugin-assistant has been deprecated, please use @ray-js/t-agent-plugin-aistream instead.

Install Dependencies

Add the following dependencies to your project's package.json:

{
  "dependencies": {
    "@ray-js/t-agent": "^0.2.0",
    "@ray-js/t-agent-plugin-aistream": "^0.2.0",
    "@ray-js/t-agent-ui-ray": "^0.2.0"
  }
}

Ensure that @ray-js/t-agent, @ray-js/t-agent-plugin-aistream, and @ray-js/t-agent-ui-ray versions are consistent.

Run yarn install to install the dependencies.

Mini-Program Kit Requirements

{
  "dependencies": {
    "BaseKit": "3.12.0",
    "BizKit": "4.10.0",
    "DeviceKit": "4.6.1",
    "HomeKit": "3.4.0",
    "MiniKit": "3.12.1",
    "AIStreamKit": "1.0.0"
  },
  "baseversion": "2.21.10"
}

Basic Example

Here is a minimal code example for integrating an AI conversation interface in a mini-program:

import React from 'react';
import { View } from '@ray-js/components';
import { createChatAgent, withDebug, withUI } from '@ray-js/t-agent';
import { ChatContainer, MessageInput, MessageList, MessageActionBar } from '@ray-js/t-agent-ui-ray';
import { withAIStream, withBuildIn } from '@ray-js/t-agent-plugin-aistream';

const createAgent = () => {
  const agent = createChatAgent(
    withUI(), // The first plugin withUI provides some default UI behaviors, required
    withAIStream({
      // withAIStream plugin connects to the mini-program AI agent platform, required in mini-programs
      earlyStart: true, // Whether to establish connection during onAgentStart phase
      agentId: '[your_agent_id]', // Enter your agent ID
    }),
    withDebug(), // withDebug prints logs in console
    withBuildIn() // withBuildIn plugin provides some built-in features
  );
  
  return agent;
};

export default function Home() {
  return (
    <View style={{ height: '100vh' }}>
      <ChatContainer createAgent={createAgent}>
        <MessageList />
        <MessageInput />
        <MessageActionBar />
      </ChatContainer>
    </View>
  );
}

Replace [your_agent_id] with your Agent ID, which can be obtained from the Tuya AI Tuya Developer Platform.

Advanced Configuration

Custom History Message Size

withAIStream({
  agentId: '[your_agent_id]',
  historySize: 500, // History message size, default 1000
})

For more detailed instructions and advanced usage, please refer to the T-Agent SDK Development Guide.

#Overview

#Quick Start

#Version Notice

#Install Dependencies

#Mini-Program Kit Requirements

#Basic Example

#Advanced Configuration

#Custom History Message Size