使用 OpenAI Assistants API 构建多 AI 智能体系统 (Experts.js)

Experts.js 是创建和部署 OpenAI Assistants 并将其链接为“工具”（Tools）的最简方案，旨在构建具有扩展记忆和高度专注力的“专家小组”（Panel of Experts）系统。

由 Custom Ink | Tech 提供支持 ❤️

概览

OpenAI 推出的全新 Assistants API 设定了行业新标准，在广泛采用的 Chat Completions API 基础上取得了显著进步。它代表了 AI 智能体可用性以及工程师与 LLM 交互方式的一次重大飞跃。配合尖端的 GPT-4o mini 模型，Assistants 现在可以在名为 Thread 的托管上下文窗口中引用附件文件和图像作为知识源。与 Custom GPTs 不同，Assistants 支持长达 256,000 个字符的指令，可集成 128 种工具，并利用创新的 Vector Store API 实现每个智能体支持多达 10,000 个文件的高效检索。

Experts.js 旨在简化此 API 的使用，省去了管理 Run 对象的复杂性，并允许将 Assistants 链接在一起作为工具使用。

import { Assistant, Thread } from "experts";

const thread = await Thread.create();
const assistant = await Assistant.create();
const output = await assistant.ask("Say hello.", thread.id);
console.log(output) // Hello

更重要的是，Experts.js 引入了将 Assistants 作为 Tools 的概念，从而能够创建 多 AI 智能体系统 (Multi AI Agent Systems)。每个工具都是一个由 LLM 驱动的 Assistant，可以担任专业角色，或代表其父级 Assistant 或工具执行复杂的任务。这使得复杂的编排工作流或一系列紧密耦合的任务协同成为可能。下图展示了一个带有产品目录工具的公司助手示例，该工具本身带有一个由 LLM 驱动的工具来创建 OpenSearch 查询。

安装

通过 npm 安装。用法非常简单，只需导入三个对象即可。

npm install experts

Experts.js 同时支持 ES6 import 语法和 CommonJS require 语句。

import { Assistant, Tool, Thread } from "experts";

• Assistants - 代表 AI 智能体的主对象。
• Tools - 可以被其他 Assistant 使用的 Assistant。
• Threads - 为你的智能体提供的托管上下文窗口。

Assistants

我们的 Assistant 外观对象的构造函数需要名称、描述和指令。第三个参数是一组选项，它直接映射到 create assistant 文档中列出的所有请求体选项。为了简单起见，Experts.js 中的所有示例均使用 ES6 类编写。默认模型为 gpt-4o-mini。

class MyAssistant extends Assistant {
  constructor() {
    super({
      name: "My Assistant",
      instructions: "...",
      model: "gpt-4o-mini",
      tools: [{ type: "file_search" }],
      temperature: 0.1,
      tool_resources: {
        file_search: {
          vector_store_ids: [process.env.VECTOR_STORE_ID],
        },
      },
    });
  }
}

const assistant = await MyAssistant.create();

Experts.js 的异步 Assistant.create() 基础工厂函数是一种使用相同构造函数选项创建 Assistant 的简单方法。

const assistant = Assistant.create({
  name: "My Assistant",
  instructions: "...",
  model: "gpt-4o-mini",
});

[!IMPORTANT]
在没有 id 参数的情况下创建 Assistant 总是会创建一个新的 Assistant。更多信息请参阅我们的 部署 (deployments) 部分。

简单的 Ask 接口

ask() 函数是询问或指示你的 Assistant 的简单接口。它需要一条消息和一个线程标识符。关于 Threads 的更多信息见下文。消息可以是字符串或原生的 OpenAI 消息对象。这就是 Experts.js 的精髓所在——你永远不必手动管理 Run 对象或其 Run Steps 对象。