GAI
Godot 게임 개발을 위한 올인원 AI 작업 공간: 데스크톱 에이전트를 사용하여 코드를 구축하고 검증한 다음, 시각적 워크플로우를 통해 오디오, 이미지, 비디오 도구를 연결합니다.
GAI는 코딩 에이전트, 재사용 가능한 스킬, 커맨드라인 도구, 그리고 가벼운 Godot 프레임워크를 하나의 저장소에 통합합니다. 에이전트에게 프로젝트 검사, 파일 편집, 명령어 실행, 테스트 수행을 요청하거나, 처리 노드를 시각적으로 연결하여 반복 가능한 에셋 파이프라인을 구축할 수 있습니다.
데스크톱 코딩 에이전트
GAI desktop coding agent
요청부터 검증까지의 전체 루프를 네이티브 Godot 데스크톱 인터페이스에서 완료합니다:
- 응답, 명령어 출력 및 파일 변경 사항을 실시간으로 스트리밍
- 내장된
read, write, edit, delete, list_dir, glob, grep, bash, web_search, 그리고 web_fetch 도구 사용
- 도구를 호출하고, 그 결과를 모델에 다시 공급하며, 더 이상 도구가 필요하다고 묻거나 실행을 종료할 때까지 반복하는 모델 루프 실행
- 여러 독립적인 세션을 실행하고 에이전트가 작업하는 동안 그 사이를 전환
- 대화 기록 보존 및 자주 사용되는 세션 고정
- 변경 사항 전에 워크스페이스 체크포인트 생성, 대화 및 파일 되돌리기 지원
- 구성 가능한 모델, 엔드포인트, 프록시를 가진 OpenAI 호환 API에 연결
시각적 워크플로우 에디터
GAI visual workflow editor
워크플로우 에디터는 저장소 스킬을 연결 가능한 노드로 노출합니다. 입력(Input)을 선택하고, 처리 단계를 연결한 다음, 전체 파이프라인을 한 번에 실행할 수 있습니다:
- Input, Audio, Image, Video 및 기타 카테고리로 그룹화된 스킬 노드 탐색
- 타입 안전성이 보장되는
audio, image, video, text, 및 folder 포트 연결
- 배치 반복(batch iteration)과 glob 매칭을 사용하여 전체 폴더 처리
- 진행 상황과 로그를 모니터링하면서 종속성 순서로 노드 실행
- 워크플로우를
.workflow.json 파일로 저장하고 나중에 다시 열기
- 영어와 중국어 인터페이스 간 전환
위 스크린샷은 다음 오디오 파이프라인을 보여줍니다:
Input folder
→ Batch for each
→ Convert to WAV
...
기능
빠른 시작 (Quick Start)
요구 사항 (Requirements)
- Godot 4.6 또는 호환 버전
- 코딩 에이전트를 위한 OpenAI 호환 API 키
- 사용하려는 스킬에 필요한 런타임 및 도구; 모든 종속성은
.dependency/ 아래 격리되어 있으며 각 스킬의 SKILL.md에 문서화되어 있습니다.
코딩 에이전트 실행 (Run the Coding Agent)
- Godot에서 루트
project.godot 파일을 엽니다.
OPENAI_API_KEY를 설정하거나, 에이전트 툴바에서 API 연결을 구성합니다.
agent/Agent.tscn을 열고 F6을 눌러 현재 씬을 실행합니다.
대안으로, 메인 씬을 일시적으로 다음으로 설정할 수 있습니다:
run/main_scene="res://agent/Agent.tscn"
워크플로우 에디터 실행 (Run the Workflow Editor)
- Godot에서 이 프로젝트를 엽니다.
agent/app/workflow/Workflow.tscn을 엽니다.
- F6을 누른 다음, 스킬 라이브러리에서 노드를 더블클릭하고 캔버스에 연결합니다.
- 필요한 입력 경로를 제공하고 실행(Run) 버튼을 클릭합니다.
자세한 내용은 워크플로우 문서를 참조하세요.
스킬 및 CLI (Skills and CLI)
각 스킬은 두 부분으로 구성됩니다:
모든 스크립트는 리포지토리 루트에서 실행합니다. 소스 파일은 기본적으로 덮어쓰기되지 않습니다. 명령어, 플래그, 종속성 및 출력 규칙에 대해서는 해당 SKILL.md를 참조하세요.
예를 들어, 오디오 파일을 WAV로 변환하려면:
.dependency/python/python .ai/audio-to-wav/convert.py --audio path/to/audio.mp3
스킬은 데스크톱 에이전트에서 호출되거나, 명령줄에서 직접 실행되거나, 재사용 가능한 시각적 워크플로우로 결합될 수 있습니다.
에이전트 호환성 (Agent Compatibility)
루트 디렉터리AGENTS.md는 공유 프로젝트 컨벤션을 정의합니다. 스킬은 또한 프로젝트 지침이나 스킬 패키지를 지원하는 다른 코딩 에이전트와 재사용할 수 있습니다.
Godot Framework
zfoo/는 GAI를 구동하는 재사용 가능한 Godot 프레임워크입니다. 이 프레임워크는 OpenAI와 호환되는 채팅, HTTP, TCP 및 WebSocket 네트워킹, 비동기 리소스 로딩, 오디오 재생, 씬 전환, 로깅, 영구 설정, 현지화(localization), 컬렉션 유틸리티, 그리고 테스트 프레임워크를 제공합니다.
다른 Godot 프로젝트에서 재사용하려면:
zfoo/를 대상 프로젝트에 복사합니다.
- Project → Project Settings → Autoload 아래에 다음 항목을 등록합니다:
| Name | Path |
|---|
GodotFramework | res://zfoo/GodotFramework.tscn |
Autoload는 전역 클래스 이름 gdf를 노출합니다.
Repository Structure
gai/
├── agent/ # 데스크톱 코딩 에이전트 및 시각적 워크플로우 에디터
├── cli/ # 개별 스킬에 대한 커맨드라인 예제
...
빌드 및 사용 세부 정보는 cpp/README.md를 참조하십시오.
License
이 프로젝트는 LICENSE에 설명된 조건 하에 공개되었습니다.