개요

ElizaOS가 어떤 프레임워크인지 분석하고 간단히 코드 단까지 분석해보는 스터디입니다.

https://github.com/elizaOS/eliza

어떤 프레임워크인가?

한마디로, AI agent를 만들고 다양한 LLM 서비스와 여러 SNS(트위터, 텔레그램, 디스코드 등)를 연동할 수 있는 프레임워크입니다.

• Typescript
• Pnpm

아키텍처

• 전체적인 아키텍처는 간단한, Agent, Characeters, Client 모듈 정도로 구성돼있다고 보면 되고, 각 역할은 아래와 같다.
• Agent : Eliza의 본체. LLM provider(OpenAI 등의 AI Service Provider)와 API key등을 통해 연결하여 agent가 텍스트나 보이스를 만들어 낼 수 있고, X, Discord 등의 SNS와 연동하여 에이전트가 자동으로 글을 쓰고 댓글을 다는 등 상호작용을 할 수 있음
• Characets : Agent가 어떤 성격을 가질지 json파일을 통해 설정하는 패키지. Json 파일에 어떤 내용들이 들어가는지는 하단에 계속 설명
• Client : 프론트엔드 클라이언트
• AI provier api key, sns account id, password와 같은 정보는 모두 환경변수(.env)를 통해 관리한다.

Character JSON

• 내 agent의 성격이나 말투 등을 입히는 설정 파일. JSON으로 구성
• 형식

{
	"name": "character_name",
	"clients": ["twitter", "discord", ...],
	"modelProvider": "openai", # or other model provider
	"settings": {
		"voice": {
			"model": "" # video model
		}
	},
	"plugin": [], # describe more
	"bio": [
		"you are agent for blah blah...",
	],
	"lore": [
		"you are ciborg...",
	], # Lore는 작품 내부 설정을 말하는 단어
	"knowledge": [
		"Cultural customs",
	],
	"messageExamples": [],
	"postExamples": [],
	"topics": [],
	"style": {
		// 각 항목에 대한 대화 스타일을 지정. 단어로 정의하듯이
		"all": [
			"Proper",
			"Formal",
			"Slightly anxious"
		],
		"chat": [...],
		"post": [...],
	},
	"adjectives": [
		"Proper",
		"Meticulous",
		...
	]
}