使用 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 实现每个 Assistant 最多 10,000 个文件的高效搜索。

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

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)。每个 Tool 都是一个由 LLM 支持的 Assistant，可以代表其父 Assistant 或 Tool 担任专门角色或执行复杂任务。这支持了复杂的编排工作流或一系列紧密耦合的任务协同。下图展示了一个企业助理的示例，它拥有一个产品目录工具，该工具本身又有一个基于 LLM 的工具来创建 OpenSearch 查询。

安装

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

npm install experts

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

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

• Assistants - 代表 AI 智能体的主对象。
• Tools - 可被其他 Assistants 使用的 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(s) 的简单接口。它需要一条消息和一个线程标识符。更多关于 Threads 的内容见下文。消息可以是字符串或原生的 OpenAI 消息对象。这就是 Experts.js 的真正闪光点。你无需手动管理 Run 对象或其 Run Steps。