Общие модули для TypeScript агентов

Эта директория содержит общие модули, которые могут использоваться всеми TypeScript агентами в agent-toolkit.

Структура

• checkpointers/ - Реализации checkpointers для TypeScript агентов
  • agw.ts - AGW (Agent Gateway) checkpointer
  • createCheckpointer.ts - Утилита для автоматического создания checkpointer
  • index.ts - Экспорты модуля

Использование

В TypeScript агенте

import { createCheckpointer } from "../../common/checkpointers/createCheckpointer.js";
import { StateGraph } from "@langchain/langgraph";

const builder = new StateGraph(StateAnnotation)
  .addNode("myNode", myNode);

// Автоматически создаст AGW checkpointer, если настроен, иначе MemorySaver
const checkpointer = createCheckpointer("my-graph-id");
export const graph = builder.compile({ checkpointer });

Зависимости

Общий модуль требует следующие зависимости:

• @langchain/core - ^0.3.2
• @langchain/langgraph - ^0.2.5
• @langchain/langgraph-checkpoint - ^1.0.0

Эти зависимости должны быть установлены в каждом TypeScript агенте, который использует общий модуль.

Конфигурация TypeScript

Для использования общего модуля в вашем агенте, убедитесь, что tsconfig.json включает файлы из common/:

{
  "compilerOptions": {
    "module": "NodeNext",
    "moduleResolution": "nodenext",
    "skipLibCheck": true,
    ...
  },
  "include": ["src/**/*", "../common/checkpointers/**/*"]
}

Примечание: Ошибки TypeScript о невозможности найти модули в common/ можно игнорировать - при выполнении зависимости будут разрешены из node_modules вашего агента.

Преимущества

• Единая реализация: Не нужно дублировать код в каждом агенте
• Легкое обновление: Изменения в общем модуле автоматически применяются ко всем агентам
• Консистентность: Все агенты используют одинаковую логику checkpointing