Agentify Components

🚀 Agentify 代理化

Agentify 是一款强大的工具，能将组件转化为智能代理。只需为组件添加配置，就能让它们理解自身、上下文和操作目标，实现智能化交互。

🚀 快速开始

Agentify 可助力组件实现智能化，通过简单配置让组件具备智能交互能力，以下是快速使用的指引。

✨ 主要特性

• 可将普通组件转化为智能代理，使其具备理解自身、上下文和操作目标的能力。
• 提供三种为组件添加代理化配置的方式，灵活满足不同开发需求。
• 能自动生成 MCP 协议兼容服务器，实现代理化组件与支持 MCP 协议系统的无缝集成。

📦 安装指南

安装步骤

1. 使用 npm 或 yarn 安装：

npm install agentify
# 或者
yarn add agentify

2. 在项目中引入 Agentify 并初始化：

import { AgentComponent } from 'agentify';

💻 使用示例

基础用法

Agentify 提供了三种方式来为组件添加代理化配置，以下是具体示例：

1. 使用装饰器模式

import { AgentConfig } from 'agentify';

@AgentConfig({
  type: 'greeting',
  behavior: {
    sayHello: () => console.log('你好！'),
    greetUser: (name: string) => `欢迎，${name}！`
  }
})
export class GreetingComponent extends React.Component {
  render() {
    return <div>问候组件</div>;
  }
}

2. 使用高阶组件模式

import { withAgentConfig } from 'agentify';

const WelcomeButton = () => <button>欢迎点击</button>;

export const AgentifiedWelcomeButton = withAgentConfig({
  type: 'greeting',
  behavior: {
    sayHello: () => console.log('你好！'),
    greetUser: (name: string) => `欢迎，${name}！`
  }
})(WelcomeButton);

3. 直接赋值配置属性

import { AgentComponent } from 'agentify';

const LoginButton = () => <button>登录</button>;

LoginButton.agentConfig = {
  type: 'auth',
  behavior: {
    authenticateUser: async (username: string, password: string) => {
      // 登录逻辑
    }
  };

高级用法

生成 MCP 服务器

Agentify 提供了自动生成 MCP（Microservices Communication Protocol）协议兼容服务器的功能，以下是实现步骤：

1. 创建 generate.ts 文件并添加以下代码：

import { generateMCPServer } from 'agentify';
import * as components from './components/ButtonExample';

const componentList = Object.values(components);

console.log(componentList);
generateMCPServer(componentList, './mcpServer');

2. 更新项目根目录下的 package.json 文件，添加以下脚本：

{
  "scripts": {
    "build:mcp": "ts-node ./generate.ts",
    "deploy:mcp": "echo \"尚未实现部署脚本\""
  }
}

📚 详细文档

• 组件配置选项：详细的组件配置指南请参阅 组件配置文档。
• 文档资源：
  • 项目概述
  • 开发者文档
  • API 参考

🤝 贡献指南

欢迎贡献！请先阅读我们的 贡献规范，了解如何参与项目开发。

📄 许可证

该项目采用 MIT 许可证。详细内容见 LICENSE 文件。