🤖 Agenite

🤖 Agenite

Agenite 是什么？

Agenite 是一个功能强大的 TypeScript 框架，专为构建复杂的 AI Agent 而设计。它提供模块化、类型安全且灵活的架构，让你可以轻松创建、组合和控制具备高级能力的 AI Agent。

✨ 主要功能

• 类型安全与开发体验

  • 从头开始使用 TypeScript 构建
  • 对工具和 Agent 配置进行可靠的类型检查
  • 出色的 IDE 支持和自动补全

• 工具集成

  • 一流的函数调用支持
  • 内置 JSON Schema 验证
  • 结构化错误处理
  • 轻松集成 API

• 不依赖特定提供商

  • 支持 OpenAI、Anthropic、AWS Bedrock 和 Ollama
  • 各提供商使用一致的接口
  • 轻松扩展以支持新提供商

• 高级架构

  • 使用 JavaScript 生成器实现双向流程
  • 基于步骤的执行模型
  • 使用 reducer 实现内置状态管理
  • 灵活的中间件系统

• 模型上下文协议（MCP）

  • 用于将大模型连接到数据源的标准化协议
  • 用于与 MCP 服务交互的客户端实现
  • 可访问 Web 内容、文件系统、数据库等

📦 可用的软件包

软件包	描述	安装
核心软件包
@agenite/agent	核心 Agent 编排框架，用于管理大模型交互、工具执行和状态管理	npm install @agenite/agent
@agenite/tool	工具定义框架，提供类型安全、模式验证和错误处理	npm install @agenite/tool
@agenite/llm	基础提供商接口层，可抽象不同的大模型提供商	npm install @agenite/llm
提供商软件包
@agenite/openai	集成 OpenAI API，为 GPT 模型提供函数调用支持	npm install @agenite/openai
@agenite/anthropic	集成 Anthropic API，以使用 Claude 模型	npm install @agenite/anthropic
@agenite/bedrock	AWS Bedrock 集成，支持 Claude 和其他模型	npm install @agenite/bedrock
@agenite/ollama	集成 Ollama，以便在本地运行模型	npm install @agenite/ollama
MCP 软件包
@agenite/mcp	Model Context Protocol 客户端，用于连接标准化的数据源和工具	npm install @agenite/mcp
中间件软件包
@agenite/pretty-logger	彩色控制台日志中间件，用于调试 Agent 执行过程	npm install @agenite/pretty-logger

对于典型配置，你需要核心软件包和至少一个提供商：

# Install core packages
npm install @agenite/agent @agenite/tool @agenite/llm

# Install your preferred provider
npm install @agenite/openai
# OR
npm install @agenite/bedrock

🚀 快速开始

import { Agent } from '@agenite/agent';
import { Tool } from '@agenite/tool';
import { BedrockProvider } from '@agenite/bedrock';
import { prettyLogger } from '@agenite/pretty-logger';

// Create a calculator tool
const calculatorTool = new Tool<{ expression: string }>({
  name: 'calculator',
  description: 'Perform basic math operations',
  inputSchema: {
    type: 'object',
    properties: {
      expression: { type: 'string' },
    },
    required: ['expression'],
  },
  execute: async ({ input }) => {
    try {
      const result = new Function('return ' + input.expression)();
      return { isError: false, data: result.toString() };
    } catch (error) {
      if (error instanceof Error) {
        return { isError: true, data: error.message };
      }
      return { isError: true, data: 'Unknown error' };
    }
  },
});

// Create an agent
const agent = new Agent({
  name: 'math-buddy',
  provider: new BedrockProvider({
    model: 'anthropic.claude-3-5-sonnet-20240620-v1:0',
  }),
  tools: [calculatorTool],
  instructions: 'You are a helpful math assistant.',
  middlewares: [prettyLogger()],
});

// Example usage
const result = await agent.execute({
  messages: [
    {
      role: 'user',
      content: [{ type: 'text', text: 'What is 1234 * 5678?' }],
    },
  ],
});

🏗️ 核心概念

Agent

Agent 是 Agenite 的核心构建模块。一个 Agent：

• 编排大模型与工具之间的交互
• 管理对话状态和上下文
• 处理工具执行及其结果
• 支持复杂工作流的嵌套执行
• 提供实时交互所需的流式处理能力

工具

工具通过提供特定功能来扩展 Agent 的能力：

• 使用 TypeScript 实现强类型安全
• 对输入进行 JSON Schema 验证
• 灵活的错误处理
• 轻松集成 API

提供商

目前支持的 LLM 提供商：

• OpenAI API（GPT 模型）
• Anthropic API（Claude 模型）
• AWS Bedrock（Claude、Titan 模型）
• 通过 Ollama 使用本地模型

模型上下文协议（MCP）

MCP 是一种用于将 LLM 连接到数据源的标准化协议：

• 用于与 MCP 服务交互的客户端实现
• 可访问网页内容、文件系统、数据库等
• 类似于 USB-C 提供通用硬件连接

🔄 高级功能

多 Agent 系统

// Create specialist agents
const calculatorAgent = new Agent({
  name: 'calculator-specialist',
  provider,
  tools: [calculatorTool],
  description: 'Specializes in mathematical calculations',
});

const weatherAgent = new Agent({
  name: 'weather-specialist',
  provider,
  tools: [weatherTool],
  description: 'Provides weather information',
});

// Create a coordinator agent
const coordinatorAgent = new Agent({
  name: 'coordinator',
  provider,
  agents: [calculatorAgent, weatherAgent],
  instructions: 'Coordinate between specialist agents to solve complex problems.',
});

分步执行

// Create an iterator for fine-grained control
const iterator = agent.iterate({
  messages: [{ role: 'user', content: [{ type: 'text', text: 'Calculate 25 divided by 5, then multiply by 3' }] }],
  stream: true,
});

// Process the stream with custom handling
for await (const chunk of iterator) {
  switch (chunk.type) {
    case 'agenite.llm-call.streaming':
      console.log(chunk.content);
      break;
    case 'agenite.tool-call.params':
      console.log('Using tool:', chunk.toolUseBlocks);
      break;
    case 'agenite.tool-result':
      console.log('Tool result:', chunk.result);
      break;
  }
}

📚 文档

如需完整文档，请访问 docs.agenite.com：

• 简介
• 快速入门指南
• 核心概念
• 示例
• API 参考

🤝 社区

• GitHub 讨论区
• Discord 社区

🛠️ 开发

git clone https://github.com/subeshb1/agenite.git
cd agenite
pnpm install
pnpm build

📄 许可证

MIT

🌟 Star 历史