aisyah ai

? Aisyah AI?

Aisyah AI는 여러 AI 기능을 결합한 CloudFlare 작업자로 제작 된 강력한 Telegram Bot입니다. 웹을 탐색하고, 알림을 설정하고, 말하고, 날씨를 예측하고, 이미지를 분석하고, 음성 메시지를 이해할 수 있습니다. 봇은 Redis를 통한 대화에서 컨텍스트를 유지하므로 개인 채팅과 그룹 상호 작용에 적합합니다.

? 스크린 샷 및 데모

특징

• ? 고급 AI 기능

  • GPT 모델에 대한 자연어 이해
  • 이미지 분석 및 객체 인식
  • 음성-텍스트 및 텍스트 음성 연설 전환
  • 개인 및 그룹 채팅에서 상황을 인식하는 대화

• 스마트 도구

  • 웹 브라우징 및 정보 검색
  • 실시간 일기 예보
  • 작업 알림 및 알림
  • 컨텍스트 유지를 통한 그룹 채팅 지원

• ☁️ 현대 건축

  • 높은 확장 성을 위해 CloudFlare 작업자를 기반으로합니다
  • 모듈성을위한 마이크로 서비스 아키텍처
  • Redis 기반 채팅 기록
  • 비용 효율적인 서버리스 배포

• ? API 통합

  • 언어 처리를위한 Openai Gpt
  • 웹 브라우징을위한 Google 사용자 정의 검색
  • 날씨 데이터에 대한 OpenWeathermap
  • 메시징을위한 Telegram Bot API
  • 파일 스토리지를위한 supabase
  • 향상된 기능을위한 추가 서비스

? 왜 Openai 만?

우리는 여러 가지 이유로 OpenAI 모델 (특히 GPT-3.5-Turbo 및 GPT-4O-MINI)을 독점적으로 지원하기로 선택했습니다.

1. 모델 일관성 : OpenAI 모델은 다양한 언어 및 사용 사례에서 가장 일관되고 고품질 응답을 제공합니다.
2. 비용 효율성 : GPT-4O-MINI는 출력 품질과 가격 간의 균형을 제공합니다.
3. 다국어 기능 : 광범위한 테스트 후 OpenAI 모델은 여러 언어를 자연스럽게 처리하는 데있어 우수한 성능을 보여주었습니다.
4. 구현 단순성 : OpenRouter와 같은 서비스는 다양한 모델에 대한 액세스를 제공하지만이를 지원하면 모델 이름 매핑 및 응답 처리에 추가 복잡성을 제공합니다.

참고 : 대체 모델 및 제공자 (Openrouter, Anthropic 등)에 대한 관심을 이해합니다. 그러나 코드 단순성을 유지하고 일관된 봇 동작을 보장하기 위해 OpenAI의 오퍼링에 중점을두기로 결정했습니다. 다른 모델을 사용해야하는 경우 프로젝트를 포크하고 그에 따라 모델 구성을 수정해야합니다.

용법

기본 명령

• /start - 봇과의 상호 작용을 시작하십시오
• /settings - 봇 설정 구성 (LLM 모델, 페르소나, 음성 등)
• /help - 사용 가능한 명령에 대한 도움을 받으십시오

참고 : 이것은 학습 및 실험 목적으로 설계된 개인 프로젝트입니다.

프로젝트 구조

이 프로젝트는 여러 마이크로 서비스로 구성됩니다.

• aisyah-ai-telegraph : 전보 상호 작용을 처리하는 메인 오케스트레이터
• aisyah-ai-agent : 요청을 처리하는 Core AI 에이전트
• aisyah-ai-explorer : 웹 브라우징 기능
• aisyah-ai-reminder : 알림 관리
• aisyah-ai-sonata : 텍스트 음성 보석 서비스
• aisyah-ai-storm : 날씨 예측
• aisyah-ai-vision : 이미지 분석
• aisyah-ai-whisper : Speech-to-Text 서비스

빠른 시작

전제 조건

• node.js (LTS 버전 권장)
• 원사 (v4.3.1 이상)
• CloudFlare 계정 (무료 계층 작품)
• Telegram Bot Token
• Openai API 키
• 채팅 기록을위한 Redis 인스턴스 (USTASH FREE TIER를 사용할 수 있음)

설치

1. 저장소 복제 :

   git clone https://github.com/husniadil/aisyah-ai.git
   cd aisyah-ai

2. 종속성 설치 :

   yarn install

3. CloudFlare 설정 : 먼저 CloudFlare API 토큰을 얻으십시오.

   1. https://dash.cloudflare.com/profile/api-tokens로 이동하십시오
   2. "CloudFlare Workers 편집"을 찾은 다음 "템플릿 사용"
   3. 규칙을 작성하십시오
   4. "요약 계속"을 클릭하고 토큰을 만듭니다
   5. 토큰을 환경 변수로 내 보냅니다.

       export CLOUDFLARE_API_TOKEN=your_api_token_here

   6. 영구 구성의 경우 쉘 프로파일 (~/.zshrc, ~/.bashrc 등)에 추가하십시오.

       echo ' export CLOUDFLARE_API_TOKEN=your_api_token_here ' >> ~ /.zshrc

   참고 : API 토큰 인증 방법과 충돌하므로 wrangler login 사용하지 마십시오.

4. 환경 파일 구성 :

    # Copy Cloudflare configuration files
   cp packages/aisyah-ai-agent/wrangler.toml.example packages/aisyah-ai-agent/wrangler.toml
   cp packages/aisyah-ai-explorer/wrangler.toml.example packages/aisyah-ai-explorer/wrangler.toml
   cp packages/aisyah-ai-reminder/wrangler.toml.example packages/aisyah-ai-reminder/wrangler.toml
   cp packages/aisyah-ai-sonata/wrangler.toml.example packages/aisyah-ai-sonata/wrangler.toml
   cp packages/aisyah-ai-storm/wrangler.toml.example packages/aisyah-ai-storm/wrangler.toml
   cp packages/aisyah-ai-telegraph/wrangler.toml.example packages/aisyah-ai-telegraph/wrangler.toml
   cp packages/aisyah-ai-vision/wrangler.toml.example packages/aisyah-ai-vision/wrangler.toml
   cp packages/aisyah-ai-whisper/wrangler.toml.example packages/aisyah-ai-whisper/wrangler.toml
   
   # Copy environment variables
   cp packages/aisyah-ai-agent/.dev.vars.example packages/aisyah-ai-agent/.dev.vars
   cp packages/aisyah-ai-explorer/.dev.vars.example packages/aisyah-ai-explorer/.dev.vars
   cp packages/aisyah-ai-reminder/.dev.vars.example packages/aisyah-ai-reminder/.dev.vars
   cp packages/aisyah-ai-sonata/.dev.vars.example packages/aisyah-ai-sonata/.dev.vars
   cp packages/aisyah-ai-storm/.dev.vars.example packages/aisyah-ai-storm/.dev.vars
   cp packages/aisyah-ai-telegraph/.dev.vars.example packages/aisyah-ai-telegraph/.dev.vars
   cp packages/aisyah-ai-vision/.dev.vars.example packages/aisyah-ai-vision/.dev.vars
   cp packages/aisyah-ai-whisper/.dev.vars.example packages/aisyah-ai-whisper/.dev.vars

5. 패키지 별 설정 구성 :

   CloudFlare KV 네임 스페이스

   필요한 KV 네임 스페이스를 작성하고 ID를 기록하십시오.

    # For settings storage
   yarn w aisyah-ai-agent wrangler kv:namespace create SETTINGS
   
   # For chat history
   yarn w aisyah-ai-telegraph wrangler kv:namespace create CHAT_HISTORY
   
   # For reminders
   yarn w aisyah-ai-reminder wrangler kv:namespace create REMINDERS

   패키지 별 구성

   aisyah-ai-telegraph (메인 봇)

    # In packages/aisyah-ai-telegraph/.dev.vars
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

   aisyah-ai-agent (핵심 AI)

    # In packages/aisyah-ai-agent/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   LANGCHAIN_API_KEY=your_langchain_api_key
   CLOUDFLARE_SUBDOMAIN=your_subdomain
   AGENT_PERSONA_AISYAH_DEFAULT=your_system_prompt_for_persona_default
   AGENT_PERSONA_AISYAH_JAWIR=your_system_prompt_for_persona_jawir
   AGENT_PERSONA_PERSONAL_ASSISTANT=your_system_prompt_for_persona_personal_assistant

   aisyah-ai-vision (이미지 분석)

    # In packages/aisyah-ai-vision/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   aisyah-ai-whisper (speech-to-text)

    # In packages/aisyah-ai-whisper/.dev.vars
   OPENAI_API_KEY=your_openai_api_key

   aisyah-ai-sonata (텍스트 음성)

    # In packages/aisyah-ai-sonata/.dev.vars
   OPENAI_API_KEY=your_openai_api_key
   # Get from https://supabase.io
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_KEY=your_supabase_storage_key
   # Get from https://elevenlabs.io
   ELEVENLABS_API_KEY=your_elevenlabs_api_key

   Aisyah-ai-storm (날씨)

    # In packages/aisyah-ai-storm/.dev.vars
   OPEN_WEATHER_MAP_API_KEY=your_openweathermap_api_key

   aisyah-ai-explorer (웹 브라우저)

    # In packages/aisyah-ai-explorer/.dev.vars
   # Get from https://programmablesearchengine.google.com/
   GOOGLE_SEARCH_API_KEY=your_google_api_key
   GOOGLE_SEARCH_ENGINE_ID=your_search_engine_id

   aisyah-ai-reminder (알림)

    # In packages/aisyah-ai-reminder/.dev.vars
    REMINDERS_APP_ID=your_reminders_app_id
    REMINDERS_API_KEY=your_reminders_api_key

   wrangler.toml 파일을 업데이트하십시오

   이전 단계에서 해당 KV 네임 스페이스 ID로 각 패키지의 wrangler.toml 업데이트하십시오.

    # In packages/aisyah-ai-telegraph/wrangler.toml
   kv_namespaces = [
     { binding = " CHAT_HISTORY " , id = " your_chat_history_namespace_id " }
   ]
   
   # In packages/aisyah-ai-agent/wrangler.toml
   kv_namespaces = [
     { binding = " SETTINGS " , id = " your_settings_namespace_id " }
   ]
   
   # In packages/aisyah-ai-reminder/wrangler.toml
   kv_namespaces = [
     { binding = " REMINDERS " , id = " your_reminders_namespace_id " }
   ]

6. 근로자 배포 :

   yarn deploy

7. Telegram BOT 설정 :

   • @botfather로 새 봇을 만듭니다
   • WebHook URL을 CloudFlare 작업자 엔드 포인트로 설정하십시오
   • Telegram Chat 인터페이스를 통해 봇 설정을 구성하십시오

개발

사용 가능한 스크립트

• yarn w : 작업 공간 별 명령을 실행하십시오
• yarn deploy : 모든 작업자를 배포합니다
• yarn types : 타이프 스크립트 유형을 생성합니다
• yarn format : Biome을 사용한 형식 코드

새로운 기능 추가

1. packages 디렉토리에서 새 패키지를 만듭니다
2. CloudFlare Workers를 사용하여 기능을 구현하십시오
3. wrangler.toml 에 구성을 추가하십시오
4. aisyah-ai-agent 에 새로운 기능을 등록하십시오

? 추가 설정

Redis 구성

1. Redis 인스턴스 설정 :

   • Opdsash에서 무료 Redis 데이터베이스를 만듭니다
   • Redis 연결 URL 및 인증 세부 사항을 가져옵니다

2. 환경에서 Redis 구성 :

    # Add to packages/aisyah-ai-telegraph/.dev.vars
   UPSTASH_REDIS_REST_URL=your_redis_rest_url
   UPSTASH_REDIS_REST_TOKEN=your_redis_rest_token

필요한 API 키

이러한 API 키를 얻고 구성하십시오.

• LLM 및 비전 기능을위한 OpenAI API 키
• 강화 된 언어 처리를위한 Langchain API 키
• 일기 예보를위한 OpenWeatherMap API 키
• 파일 처리를위한 Supabase 프로젝트 및 스토리지 키

각 패키지의 각 .dev.vars 파일에 추가하십시오.

❗ 문제 해결

일반적인 문제

1. 작업자 배포가 실패합니다

   • CloudFlare API 토큰에 올바른 권한이 있는지 확인하십시오
   • wrangler.toml 의 작업자 이름이 고유한지 확인하십시오
   • KV 네임 스페이스 바인딩이 올바른지 확인하십시오

2. 봇은 응답하지 않습니다

   • WebHook URL이 올바르게 설정되었는지 확인하십시오
   • Telegram Bot 토큰 유효성을 확인하십시오
   • Redis 연결이 작동하는지 확인하십시오

3. 기능이 작동하지 않습니다

   • 필요한 모든 API 키가 유효하고 올바르게 구성되었는지 확인하십시오.
   • CloudFlare 대시 보드에서 해당 작업자 로그를 확인하십시오
   • 환경 변수가 올바르게 설정되어 있는지 확인하십시오

디버그 모드

설정하여 디버그 모드 활성화 :

 # Add to .dev.vars
DEBUG_MODE=true

이것은 작업자 콘솔에서보다 자세한 로그를 제공합니다.

도움을 받고 있습니다

문제가 발생하면 :

1. 문제 페이지를 확인하십시오
2. CloudFlare Workers Logs를 검토하십시오
3. 보다 자세한 로깅을 위해 디버그 모드를 활성화하십시오

특허

이 프로젝트는 MIT 라이센스에 따라 라이센스가 부여됩니다. 자세한 내용은 라이센스 파일을 참조하십시오.