Content
# 🚀 TRTC AI Build Quickly
<div align="center">
[](https://cloud.tencent.com/product/trtc)
[](https://cloud.tencent.com/document/product/647/110584)
[](https://nodejs.org/)
[](LICENSE)
[](CONTRIBUTING.md)
</div>
<div align="center">
<img src="docs/images/logo.png" alt="logo" width="200"/>
</div>
## ✨ Product Introduction
TRTC AI Build Quickly is a rapid AI application development platform based on Tencent Cloud TRTC, allowing you to easily create intelligent voice interaction applications. With simple configurations, you can implement various AI dialogue scenarios, such as intelligent customer service, voice assistants, emotional companionship, and more.
[Deepwiki for TRTC AI Build Quickly](https://deepwiki.com/chicogong/trtc-ai-build-quickly)
## 🌟 Core Features
- 🎯 **Quick Integration**: Quickly implement audio and video call functionalities based on the TRTC SDK.
- 🤖 **Rich AI Capabilities**: Integrate various AI capabilities to meet different scenario needs.
- ⚙️ **Flexible Configuration**: Support custom Agent configurations, making it easy to expand new features.
- 🛡️ **Stable and Reliable**: Relying on TRTC's powerful audio and video capabilities to ensure call quality.
- 🎨 **Simple and Easy to Use**: Provide a concise API interface to lower the development threshold.
- 🌐 **Multi-Agent Support**: Support various types of Agents to meet different scenario needs.
## 🎮 Agent Card Showcase
Our platform supports various types of Agents, each with its unique application scenarios:
<div align="center">
| Agent Type | Core Functionality | Applicable Scenarios | Implementation Status |
|------------|--------------------|----------------------|-----------------------|
| Outbound Customer Service Agent | Automatic outbound calls, intelligent scripts, quality monitoring | Marketing, customer follow-up | ✅ Implemented |
| Sweet Girl Companion Agent | Natural interaction, emotionally hyper-personalized dialogue, personalized companionship | Social, entertainment | ✅ Implemented |
| Voiceprint Lock Agent | Voiceprint locking, filtering surrounding voices, ensuring high-quality calls | Noisy scenarios like offices, streets | ✅ Implemented |
| MCP Agent | Access to [MCP](https://github.com/modelcontextprotocol) for extended tool calls | More convenient tool calls | ✅ Implemented |
| A2A Agent | Access to [A2A](https://github.com/google/A2A) protocol | Multi-Agent dialogue | 🔄 In Development |
| Coze Agent | Access to [Coze](https://www.coze.com) platform capabilities | Rapidly build intelligent dialogue applications | 🔄 In Development |
| Dify Agent | Access to [Dify](https://dify.ai) platform capabilities | Enterprise-level AI application development | 🔄 In Development |
| Knowledge Engine Agent | Access to [Tencent Cloud Knowledge Engine](https://cloud.tencent.com/product/lke) enterprise-level knowledge base solutions | Intelligent Q&A, knowledge base queries | 🔄 In Development |
</div>
If you need a specific Agent, please leave a message, and we will provide it for you as soon as possible.
Of course, you can also create your own Agent based on your needs.
You can also contribute your Agent Card to this project, allowing more people to use your Agent.
## 🚀 Quick Start
### 1. Install Dependencies
```bash
npm install
```
### 2. Configure Agent
Select or create a configuration file in the `agent_cards` directory. The required configuration items are as follows:
| Configuration Item | Required Fields | Access Link |
|--------------------|-----------------|--------------|
| apiConfig | secretId, secretKey | [Tencent Cloud API Keys](https://console.cloud.tencent.com/cam/capi) |
| trtcConfig | sdkAppId, secretKey | [TRTC Console](https://console.cloud.tencent.com/trtc/app) |
| LLMConfig | APIKey, APIUrl | Obtain from your LLM service provider |
| TTSConfig | Choose one of the following:<br>• Tencent Cloud TTS:<br> - AppId: [TTS Console](https://console.cloud.tencent.com/tts)<br> - SecretId, SecretKey: [Tencent Cloud API Keys](https://console.cloud.tencent.com/cam/capi)<br>• Minimax TTS:<br> - GroupId, APIKey, VoiceType: Obtain from Minimax Console |
For detailed guidance on activation, access, and deployment: [中文](./docs/README_zh.md) | [English](./docs/README.md)
### 3. Start the Application
```bash
# Start with default configuration
npm start
# Or start with specified configuration
node server.js [agent_type]
```
Supported agent_type parameters:
| Agent Type | Start Command | Description |
|------------|---------------|-------------|
| Default Agent | `node server.js default` | Default Agent |
| Sweet Girl | `node server.js sweet_girl` | Sweet Girl Companion Agent |
| MCP Tencent Map | `node server.js mcp_tencent_map` | MCP Tencent Map Agent |
## 📦 Project Structure
```
trtc-ai-build-quickly/
├── agent_cards/ # Agent configuration files
│ ├── index.js # Agent configuration entry
│ ├── assets/ # Static resources/Agent Card images
│ ├── sweet_girl.js # Sweet Girl Companion Agent configuration
│ ├── mcp_tencent_map.js # MCP Tencent Map Agent configuration
│ └── default.js # Default Agent configuration
├── ai_gen_servers/ # AI generation module for voice dialogue integration (optional)
│ ├── llm/ # LLM proxy service implementation, custom function calls, etc.
│ └── ... # MCP/A2A and other server implementations
├── css/ # Style files
├── docs/ # Documentation
│ └── images/ # Image resources
├── js/ # Frontend JS files
├── templates/ # Template files
│ ├── dialogue.html # Simple dialogue interface template
│ └── dialogue_text.html # Simple dialogue + text input interface template
├── Dockerfile # Docker file
├── index.html # Dialogue interface
├── server.js # Server entry
├── package.json # Project dependencies
└── README.md # Project description
```
## 🤝 Contribution Guidelines
We welcome contributions of any kind! Please check our [Contribution Guidelines](CONTRIBUTING.md) for more information.
## 📄 License
This project is licensed under the [MIT License](LICENSE).
## 📞 Contact Us
- Email: chicogong@tencent.com
- Documentation: [Product Documentation](https://cloud.tencent.com/document/product/647/110584)
- Issue Feedback: [GitHub Issues](https://github.com/yourusername/trtc-ai-build-quickly/issues)
- Submit a Ticket: [Submit a Ticket](https://cloud.tencent.com/online-service?from=doc_647)
## 🙏
Thank you for using TRTC-AI!!
<div align="center">
<sub>Built with ❤️ by TRTC AI Team</sub>
</div>
