AntoniRomera/ai-agents-framework

ai-agents-framework은(는) 무엇을 하나요?

모듈형 멀티 프로바이더 AI 에이전트 프레임워크 (Gemini · Claude · Ollama) - 플러그형 스킬 및 영구 메모리 지원

개요

이 프레임워크는 여러 AI 공급자를 지원하는 모듈형 에이전트 시스템을 제공합니다. Gemini, Claude, Ollama를 단일 인터페이스로 통합하여 사용할 수 있으며, 플러그형 스킬 아키텍처와 영구 메모리 기능을 갖추고 있습니다.

주요 기능

• 멀티 프로바이더 지원: Gemini, Claude, Ollama 등 다양한 AI 모델을 동시에 사용
• 플러그형 스킬: 필요에 따라 스킬을 추가/제거하여 에이전트 기능 확장
• 영구 메모리: 대화 컨텍스트와 학습 데이터를 지속적으로 저장 및 활용
• 모듈형 설계: 각 컴포넌트가 독립적으로 동작하며 교체 가능

설치 방법

npm install @antoniromera/ai-agents-framework

또는

yarn add @antoniromera/ai-agents-framework

빠른 시작

import { AgentFramework } from '@antoniromera/ai-agents-framework';

const agent = new AgentFramework({
  provider: 'gemini',  // 'claude' 또는 'ollama'로 변경 가능
  apiKey: process.env.GEMINI_API_KEY,
  skills: ['./skills/custom-skill.js'],
  memory: true
});

await agent.start();

설정 옵션

옵션	타입	기본값	설명
provider	string	'gemini'	사용할 AI 공급자 (gemini, claude, ollama)
apiKey	string	null	API 키 (환경 변수로 설정 권장)
skills	string[]	[]	추가할 스킬 파일 경로 목록
memory	boolean	true	영구 메모리 활성화 여부

환경 변수

• GEMINI_API_KEY: Gemini API 키
• CLAUDE_API_KEY: Claude API 키
• OLLAMA_HOST: Ollama 호스트 주소 (기본값: http://localhost:11434)

플러그형 스킬 사용법

스킬 디렉토리에 JavaScript 파일을 생성하고 다음과 같이 내보냅니다:

// skills/my-skill.js
export default {
  name: 'my-skill',
  description: '내 사용자 정의 스킬',
  async execute(context, args) {
    // 스킬 로직 구현
    return `결과: ${args.input}`;
  }
};

라이선스

MIT