AG3NT은(는) 무엇을 하나요?
로컬 AI 에이전트를 구축하고 실행하여 다중 모델 지원, 모듈식 스킬, 보안 제어 및 다중 채널 접근을 통해 개인 자동화 작업을 수행합니다.
개요
AG3NT는 개인 작업 자동화를 위해 설계된 경량 로컬 AI 에이전트 플랫폼입니다. 이 플랫폼을 사용하면 여러 LLM 백엔드, 사용자 정의 스킬, 안전한 샌드박스 실행 및 다양한 상호작용 채널을 지원하는 에이전트를 빠르게 구축할 수 있습니다.
기능
- 다중 모델 지원: Ollama, OpenAI, Anthropic 등 다양한 LLM 제공자를 원활하게 통합합니다.
- 모듈식 스킬 시스템: 미리 만들어진 스킬을 사용하거나 자신만의 스킬을 만들어 에이전트 기능을 확장하세요.
- 보안 제어: 샌드박스 실행 및 권한 관리를 통해 시스템 자원을 안전하게 보호합니다.
- 다중 채널 접근: CLI, REST API, Discord 봇 등 다양한 방식으로 에이전트와 상호작용할 수 있습니다.
- 경량 및 로컬: 완전히 로컬에서 실행되며, 최소한의 종속성으로 가볍게 동작합니다.
시작하기
설치
pip install ag3nt
또는 소스에서 직접 설치:
git clone https://github.com/desy-design/AG3NT.git
cd AG3NT
pip install -r requirements.txt
기본 사용법
.env파일을 생성하고 API 키를 설정하세요 (선택 사항):
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
- 에이전트를 실행하세요:
ag3nt run --model ollama/llama3
- 질문을 입력하거나 작업을 할당하세요:
> 웹사이트에서 최신 헤드라인을 스크랩하여 요약해 줘.
스킬 시스템
스킬은 에이전트가 사용할 수 있는 재사용 가능한 기능 모듈입니다. 기본 스킬은 skills/ 디렉토리에서 찾을 수 있습니다.
내장 스킬
| 스킬 이름 | 설명 | 명령어 |
|---|---|---|
web_scraper | URL에서 콘텐츠를 스크랩 | scrape <url> |
file_manager | 파일 읽기, 쓰기, 관리 | read <path>, write <path> |
email_sender | SMTP를 통해 이메일 전송 | email <to> <subject> |
사용자 정의 스킬 생성
사용자 정의 스킬을 생성하려면 skills/custom/ 디렉토리에 Python 함수를 정의하세요:
# skills/custom/my_skill.py
def run(params):
"""내 사용자 정의 스킬 설명"""
# 여기에 로직 구현
return {"status": "success", "result": "작업 완료"}
구성
주요 구성 옵션:
| 옵션 | 설명 | 기본값 |
|---|---|---|
model | 사용할 LLM 모델 | ollama/llama3 |
max_tokens | 응답당 최대 토큰 수 | 2048 |
temperature | 생성 다양성 (0.0–1.0) | 0.7 |
sandbox | 명령 실행에 샌드박스 사용 | true |
API 참조
REST API를 통해 에이전트를 프로그래밍 방식으로 제어할 수 있습니다:
# 서버 시작
ag3nt serve --port 8080
# 요청 보내기
curl -X POST http://localhost:8080/run \
-H "Content-Type: application/json" \
-d '{"input": "hello"}'
보안
- 모든 명령은 선택적 샌드박스 내에서 실행됩니다.
- 민감한 작업에는 사용자 확인이 필요합니다.
- API 키는 안전한 환경 변수에 저장됩니다.
기여하기
기여는 환영합니다! 개선 사항이 있으면 이슈를 열거나 풀 리퀘스트를 제출해 주세요.
라이선스
MIT 라이선스.