MicroGPT Agent SDK（软件开发工具包）
适用于构建具备高级记忆功能、多智能体协同管理和全面测试能力的AI代理的生产级TypeScript SDK。
为何选择MicroGPT Agent SDK？
构建生产级AI代理不仅仅需要API调用。您还需要：
- 持久内存跨会话记忆对话的代理
- 多智能体协调协调由专业人员组成的团队
- 生产测试在部署前，使用真实人类反馈测试代理
- 协议灵活性支持MCP、ACP及其他代理协议
- 与提供商无关（或：不依赖于特定提供商）与OpenAI、Anthropic、Ollama等合作
MicroGPT Agent SDK 提供了经过实战检验的基础设施，让您能够专注于构建智能代理的行为，而无需重复造轮子。
主要特点
🧠 高级记忆系统
- 混合内存结合使用Redis（短期）、Supabase（长期）和向量数据库（语义）
- 自动上下文管理代理在跨对话中记住相关信息
- 分布式内存在多个代理实例之间共享内存
🤝 多智能体协同调度
- 消息总线代理之间的事件驱动通信
- 分布式锁定防止多智能体系统中的竞态条件
- 共享上下文代理通过共享状态进行协作
- 工作流程协调将代理链接成复杂的工作流程
🧪 人机交互测试（或：人类在环测试）
- HITL框架在生产前，使用真实的人类反馈测试代理
- 测试编排协调复杂的测试场景
- 性能基准测试测量延迟、成本和质量
- 集成测试测试整个代理工作流
🔌 协议支持
- MCP适配器模型上下文协议集成
- ACP适配器代理通信协议
- FIPA适配器FIPA代理标准
- 自定义协议使用您自己的协议进行扩展
🎯 提供商灵活性
- OpenAI（一家人工智能研究实验室）GPT-4，GPT-3.5-turbo，函数调用
- Anthropic（公司名，可译为“安萨提克”或根据具体语境保留原名）Claude 3 Opus、Sonnet、Haiku（注：这些可能是特定的模型或版本名称，直接翻译为中文即保持原样，因为它们可能代表特定的技术或产品名称，没有直接的中文对应词）
- Ollama（注：Ollama是一个用于本地运行大型语言模型的工具，直接翻译可能无法准确传达其含义，因此在此保留原英文名称）本地模型支持
- 统一界面无需代码更改即可切换提供商
快速入门
安装
npm install microgpt-agent-sdk基本代理
import { AgentSDK } from 'microgpt-agent-sdk';
const sdk = new AgentSDK({
provider: 'openai',
apiKey: process.env.OPENAI_API_KEY
});
const agent = sdk.createAgent({
name: 'assistant',
systemPrompt: 'You are a helpful assistant.'
});
const response = await agent.chat('Hello!');
console.log(response);具有记忆功能的代理
import { AgentSDK, MemoryConfig } from 'microgpt-agent-sdk';
const sdk = new AgentSDK({
provider: 'openai',
apiKey: process.env.OPENAI_API_KEY,
memory: {
shortTerm: {
type: 'redis',
url: process.env.REDIS_URL
},
longTerm: {
type: 'supabase',
url: process.env.SUPABASE_URL,
key: process.env.SUPABASE_KEY
}
}
});
const agent = sdk.createAgent({
name: 'assistant',
systemPrompt: 'You are a helpful assistant with memory.',
memoryEnabled: true
});
// Agent remembers context across sessions
await agent.chat('My name is Alice');
// Later...
await agent.chat('What is my name?'); // "Your name is Alice"多智能体系统
import { Orchestrator } from 'microgpt-agent-sdk';
const orchestrator = new Orchestrator();
// Create specialized agents
const researcher = orchestrator.createAgent({
name: 'researcher',
systemPrompt: 'You research topics thoroughly.'
});
const writer = orchestrator.createAgent({
name: 'writer',
systemPrompt: 'You write clear, engaging content.'
});
// Coordinate workflow
const workflow = orchestrator.createWorkflow()
.step('research', researcher, { task: 'Research AI safety' })
.step('write', writer, {
task: 'Write article',
context: (results) => results.research
});
const result = await workflow.execute();人机交互测试（或“环路中包含人类的测试”）
import { TestFramework } from 'microgpt-agent-sdk';
const testFramework = new TestFramework();
// Create test suite
const suite = testFramework.createSuite({
name: 'Customer Support Agent',
agent: customerSupportAgent
});
// Add test scenarios
suite.addScenario({
name: 'Handle refund request',
input: 'I want a refund for order #12345',
expectedBehavior: 'Agent should verify order and process refund',
humanReviewer: true // Request human review
});
// Run tests
const results = await suite.run();
console.log(`Pass rate: ${results.passRate}%`);建筑
┌─────────────────────────────────────────────────────────────┐
│ MicroGPT Agent SDK │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Memory │ │ Orchestration│ │ Testing │ │
│ │ │ │ │ │ │ │
│ │ • Short-term │ │ • Message Bus│ │ • HITL │ │
│ │ • Long-term │ │ • Workflows │ │ • Integration│ │
│ │ • Semantic │ │ • Locking │ │ • Performance│ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Protocols │ │ Providers │ │ Learning │ │
│ │ │ │ │ │ │ │
│ │ • MCP │ │ • OpenAI │ │ • Patterns │ │
│ │ • ACP │ │ • Anthropic │ │ • Optimization│ │
│ │ • FIPA │ │ • Ollama │ │ • Analytics │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘文档
示例
查看一下 示例 包含完整工作示例的目录：
贡献；做出贡献
我们欢迎投稿！请参阅 CONTRIBUTING.md 翻译为中文是：“贡献指南.md” 或 “如何贡献.md”（具体翻译可能根据上下文略有调整，但核心意思是指向一个关于如何为项目做出贡献的指南文件）。在这里，“.md”表示这是一个Markdown格式的文件 作为指南。
许可证
MIT 许可证 - 详见 许可证
💬 社区
加入我们的社区，提出问题、分享想法，并与其他开发生产就绪AI代理的开发者建立联系！
- **** - 提出问题，分享你的工作，并讨论最佳实践
- **** - 错误报告和功能请求
- 电子邮件dev@cogniolab.com（可翻译为）：dev@认知实验室.com（注：实际翻译时，通常会保留原邮箱地址不变，因为邮箱地址本身是国际化域名，直接翻译域名部分并无实际意义，此处仅为说明其结构，实际使用中无需翻译）
我们正在构建一个互助的社区，让开发者们相互帮助，共同打造稳健、可投入生产的AI代理。无论你是初出茅庐还是正在扩展至生产环境，你的问题和贡献都受到欢迎！
______________________________________________________________________
由...用心打造 ❤️ Cognio实验室
*MicroGPT Agent SDK 由 Cognio Lab 构建并维护，Cognio Lab 是生产级 AI 代理基础设施的创造者。*