AstrBot: WebUI가 포함된 AI 챗봇 액세스 플랫폼

653 0

일반 소개

AstrBot은 오픈 소스 챗봇 개발 프레임워크로, QQ, Telegram, WeChat 및 기타 메시징 플랫폼을 지원하며 OpenAI, DeepSeek, Google 쌍둥이자리 AstrBot은 대규모 언어 모델(LLM)과 같은 지능형 챗봇을 개발하기 위한 프레임워크입니다. 이 프레임워크는 플러그인 시스템, 시각적 관리 패널, 이미지 이해 및 음성 텍스트 변환과 같은 멀티모달 기능을 제공하며, 사용자가 지능형 챗봇을 빠르게 구축할 수 있도록 설계되어 개발자와 기술 애호가에게 적합합니다. AGPL-v3 라이선스를 사용하며, 오픈 코드와 활발한 커뮤니티를 보유하고 있습니다.

기능 목록

QQ, QQ 채널, 텔레그램, 위챗(개인 및 기업용 위챗), 플라이북, 네일 등 멀티 플랫폼 메시징 액세스를 지원합니다.
OpenAI, 구글 제미니, 딥서치, 클로드, 올라마 등과 같은 여러 빅 언어 모델을 통합하고 로컬 모델을 지원하세요.
개성을 설정할 수 있는 여러 대화 라운드, 그림 이해 및 음성-텍스트 변환 지원(Whisper 기반) 기능을 제공합니다.
봇 구성, 로그 보기, 플러그인 관리를 위한 시각적 관리자 패널이 내장되어 있습니다.
플러그인 확장이 지원되며 사용자는 체크인 또는 코드 실행과 같은 사용자 지정 기능을 개발할 수 있습니다.
웹 검색, 자연어 할 일 목록 및 도킹을 포함한 에이전트 기능 제공 Dify 플랫폼.
키워드 필터링 및 Baidu 콘텐츠 감사와 같은 콘텐츠 보안 관리가 포함됩니다.
사용자가 웹 페이지를 통해 로봇과 직접 대화할 수 있도록 웹 UI가 제공됩니다.

도움말 사용

AstrBot의 설치 및 사용 과정은 명확하며, 공식 문서에서 다양한 배포 방법을 제공합니다. 다음은 설치 단계와 작동의 주요 기능에 대한 자세한 설명입니다.

설치 프로세스

AstrBot은 소스 코드 배포, Docker 배포, Windows 원클릭 설치, Pagoda 패널 배포 등을 지원합니다. 다음은 소스 코드 배포 및 Docker 배포의 예입니다.

소스 코드 배포

환경 준비하기
Git과 Python 3.11 이상이 설치되어 있는지 확인합니다(Windows 사용자는 공식 Python 웹사이트에서, Linux 사용자는 공식 Python 웹사이트에서 Python을 다운로드할 수 있습니다). sudo apt install python3 설치.
코드 다운로드
터미널에서 실행됩니다:

git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot

또는 GitHub에서 ZIP 파일을 다운로드하여 압축을 풉니다.

종속성 설치
추천 uv 도구:

pip install uv
uv run main.py

또는 전통적인 방식으로도 가능합니다:

pip install -r requirements.txt
python main.py

트리거 절차
실행 후 터미널에 다음과 같은 관리 패널 주소가 표시됩니다. http://localhost:6185. 기본 계정 사용 astrbot 및 비밀번호 astrbot 로그인합니다.

도커 배포

Docker 설치
Docker가 설치되어 있고 사용 가능한지 확인 docker --version 확인.
이미지를 가져와 실행
터미널에 입력합니다:

docker run -d -p 6185:6185 -v astrbot-data:/app/data soulter/astrbot:latest

-p 6185:6185 매핑 포트.-v 데이터 볼륨을 생성하여 구성을 저장합니다.

액세스 패널
브라우저를 열고 다음을 입력합니다. http://localhost:6185를 클릭하고 기본 계정 비밀번호로 로그인합니다.

주요 기능

빅 언어 모델 구성

관리자 패널에 로그인하고 공급자 설정을 클릭합니다.
모델 유형을 선택합니다(예 openai_chat_completion.
API 키(OpenAI 등의 플랫폼에서 얻은)와 주소(기본값)를 입력합니다. https://api.openai.com/v1).
특정 모델을 선택합니다(예 gpt-3.5-turbo)를 클릭하고 저장하면 적용됩니다.

멀티 플랫폼 액세스

관리자 패널의 메시징 플랫폼 옵션에서 텔레그램과 같은 플랫폼을 선택합니다.
필요한 정보(예: 봇파더에서 받은 텔레그램의 봇 토큰)를 입력합니다.
구성을 저장하면 봇이 해당 플랫폼에서 메시지에 응답할 수 있습니다. 예를 들어, 텔레그램에서 다음과 같이 입력합니다. /start를 입력하면 로봇이 응답합니다.

플러그인 사용

플러그인(예: 텔레그램 어댑터)을 다운로드하여 <AstrBot目录>/data/plugins.
AstrBot을 다시 시작하면 플러그인이 자동으로 로드됩니다.
관리자 패널에서 플러그인을 활성화하고 메시지 전송률 제한 설정과 같은 매개변수를 구성합니다.

멀티모달 기능

그림 이해력봇에게 프롬프트(예: "이 사진 설명해줘")와 함께 사진을 보내면 봇이 이를 분석하여 응답합니다.
음성-텍스트 변환음성 파일을 보내려면 공급자 설정에서 귓속말을 사용 설정하면 봇이 이를 텍스트로 변환하여 응답합니다.

에이전트 기능

웹 검색"일기 예보 검색"을 보내면 봇이 결과를 반환합니다.
코드 실행코드 스니펫(예: Python)을 보내려면 봇이 실행하고 결과를 반환하는 샌드박스 코드 실행기를 사용하도록 설정해야 합니다.

주의

서버를 배포하려면 localhost 를 서버 IP로 설정합니다.
Gewechat을 사용하여 WeChat 개인 번호에 액세스하는 경우 차단을 피하기 위해 대체 계정을 사용하는 것이 좋습니다.
Docker 배포에는 매핑이 필요합니다. /var/run/docker.sock그렇지 않으면 코드 실행기를 사용할 수 없습니다.
첫 번째 실행은 구성 파일을 생성합니다. <AstrBot目录>/data/config.json를 클릭하고 수동으로 편집할 수 있습니다.

이 단계를 통해 사용자는 AstrBot을 쉽게 배포하고 사용할 수 있습니다.

애플리케이션 시나리오

개인 비서
AstrBot으로 텔레그램에서 알림을 설정하고, 메시지를 확인하고, 도움을 받을 준비를 하세요.
그룹 채팅 관리
QQ 그룹이나 플라이북에서는 로봇이 자동으로 질문에 답하고 체크인을 관리하며 효율성을 개선할 수 있습니다.
학습 도구
학생들은 AstrBot을 사용하여 그림 공식을 분석하거나 음성 메모를 필사하여 학습을 도울 수 있습니다.
개발 테스트
개발자는 LLM 대화창의 효과를 테스트하거나 새로운 플러그인 확장 기능을 개발할 수 있습니다.

QA

이미 지원되는 플랫폼은 무엇인가요?
QQ(공식 및 원봇), QQ 채널, 텔레그램, 위챗(개인 및 기업용 위챗), 플라이북, 네일은 이미 지원되고 있으며, 디스코드 등은 개발 중입니다.
새 모델을 추가하려면 어떻게 하나요?
관리자 패널 "공급자"에 추가합니다(예: 다음과 같이 입력). Ollama 모델의 로컬 주소와 모델 이름이면 충분합니다.
시작이 실패하면 어떻게 되나요?
터미널 로그를 확인하면 누락된 종속성이나 사용 중인 포트가 있을 수 있습니다. 다음 사항을 확인하세요. requirements.txt 설치가 완료되었습니다.
플러그인은 어떻게 개발되나요?
공식 문서 참조 <https://astrbot.app/dev/plugin.html>에 코드를 넣으려면 data/plugins 재부팅한 후 재시작합니다.