Página Inicial>Relacionado com a programação>Código-Fonte de IA
Baixar

? Aisyah ai?

Avatar

Aisyah AI é um poderoso bot de telegrama construído com trabalhadores de CloudFlare que combina várias capacidades de IA. Ele pode navegar na web, definir lembretes, falar, prever clima, analisar imagens e entender mensagens de voz. O bot mantém o contexto nas conversas através do Redis, tornando -o perfeito para bate -papos privados e interações em grupo.

? Capturas de tela e demonstração

bater papoGrupo-ChatModelo de configurações-llmConfigurações-persona

Características

  • ? Recursos avançados de IA

    • Entendimento de linguagem natural com modelos GPT
    • Análise de imagem e reconhecimento de objetos
    • Conversão de fala para texto e texto em fala
    • Conversas com conhecimento de contexto em bate-papos privados e em grupo

  • Ferramentas inteligentes

    • Navegação da web e recuperação de informações
    • Previsões meteorológicas em tempo real
    • Lembretes e notificações de tarefas
    • Suporte de bate -papo em grupo com retenção de contexto

  • ☁️ Arquitetura moderna

    • Construído nos trabalhadores da CloudFlare para alta escalabilidade
    • Arquitetura de microsserviços para modularidade
    • Histórico de bate-papo de Redis
    • Implantação sem servidor econômica

  • ? Integrações da API

    • OpenAI GPT para processamento de idiomas
    • Pesquisa personalizada do Google por navegação na web
    • OpenWeathermap para dados climáticos
    • API do BOT do Telegram para mensagens
    • Supabase para armazenamento de arquivos
    • Serviços adicionais para recursos aprimorados

? Por que apenas opera?

Optamos por apoiar exclusivamente os modelos OpenAI (particularmente GPT-3.5-Turbo e GPT-4o-Mini) por vários motivos:

  1. Consistência do modelo : os modelos OpenAI fornece as respostas mais consistentes e de alta qualidade em diferentes idiomas e casos de uso.
  2. Eficácia da relação : O GPT-4O-Mini oferece um excelente equilíbrio entre qualidade da produção e preços.
  3. Capacidade multilíngue : Após testes extensos, os modelos OpenAI demonstraram desempenho superior ao lidar com vários idiomas naturalmente.
  4. Implementação Simplicidade : Embora serviços como o OpenRouter ofereçam acesso a vários modelos, o suporte a eles introduzia complexidade adicional nos mapeamentos de nomes do modelo e manuseio de respostas.

NOTA: Entendemos o interesse em modelos e fornecedores alternativos (como o OpenRouter, Antrópico, etc.). No entanto, para manter a simplicidade do código e garantir um comportamento de bot consistente, decidimos nos concentrar nas ofertas do OpenAI. Se você precisar usar modelos diferentes, você precisará gastar o projeto e modificar as configurações do modelo de acordo.

Uso

Comandos básicos

  • /start - BEGIN Interação com o Bot
  • /settings - Configurar configurações de bot (modelo LLM, Persona, Voice, etc.)
  • /help - obtenha ajuda sobre os comandos disponíveis

Nota : Este é um projeto pessoal projetado para fins de aprendizado e experimentação.

Estrutura do projeto

O projeto está organizado em vários microsserviços:

  • aisyah-ai-telegraph : Orquestrador principal que lida com interações do telegrama
  • aisyah-ai-agent : Core AI Agent que processa solicitações
  • aisyah-ai-explorer : capacidade de navegação na web
  • aisyah-ai-reminder : Gerenciamento de lembrete
  • aisyah-ai-sonata : serviço de texto em fala
  • aisyah-ai-storm : Previsão do tempo
  • aisyah-ai-vision : Análise de imagem
  • aisyah-ai-whisper : Serviço de fala para texto

Início rápido

Pré -requisitos

  • Node.js (versão LTS recomendada)
  • Fio (v4.3.1 ou mais tarde)
  • Conta Cloudflare (Funcionários gratuitos de camada)
  • Token de bot de telegrama
  • Chave da API OpenAI
  • Redis Instância para o histórico de bate -papo (você pode usar o Upstash Free Tier)

Instalação

  1. Clone o repositório: 

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

  2. Instale dependências: 

    yarn install

  3. Configurar CloudFlare: Primeiro, obtenha seu token da API CloudFlare:

    1. Vá para https://dash.cloudflare.com/profile/api-tokens
    2. Localize "Editar Cloudflare Workers" e "Use Modelo"
    3. Preencha as regras
    4. Clique em "Continue para resumo" e crie o token
    5. Exportar o token como uma variável de ambiente: 
       export CLOUDFLARE_API_TOKEN=your_api_token_here
    6. Para configuração persistente, adicione -a ao seu perfil de shell (~/.zshrc, ~/.bashrc, etc.): 
       echo ' export CLOUDFLARE_API_TOKEN=your_api_token_here ' >> ~ /.zshrc

    Nota: Não use wrangler login , pois ele entra em conflito com o método de autenticação do token da API.

  4. Configure arquivos de ambiente: 

     # 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. Configurar configurações específicas do pacote:

    Namespaces de nuvem KV

    Crie os namespaces KV necessários e anote seus IDs: 

     # 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

    Configurações específicas do pacote

    aisyah-ai-telegraph (bot principal) 

     # 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 (núcleo 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 (análise de imagem) 

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

    Aisyah-Ai-Whisper (fala para texto) 

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

    aisyah-ai-sonata (texto em fala) 

     # 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 (clima) 

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

    Aisyah-AI-Explorer (navegador da web) 

     # 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 (lembretes) 

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

    Atualize os arquivos wrangler.toml

    Atualize o wrangler.toml de cada pacote com os IDs de namespace KV correspondentes da etapa anterior: 

     # 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. Implantar os trabalhadores: 

    yarn deploy

  7. Configure seu bot de telegrama:

    • Crie um novo bot com @botfather
    • Defina o URL da WebHook para o seu terminal do CloudFlare Worker
    • Definir as configurações de bot através da interface de bate -papo do Telegram

Desenvolvimento

Scripts disponíveis

  • yarn w : Execute comandos específicos da área de trabalho
  • yarn deploy : implante todos os trabalhadores
  • yarn types : gerar tipos de texto datilografado
  • yarn format : código de formato usando o bioma

Adicionando novos recursos

  1. Crie um novo pacote no diretório packages
  2. Implemente seu recurso usando os trabalhadores do CloudFlare
  3. Adicionar configuração em wrangler.toml
  4. Registre a nova capacidade em aisyah-ai-agent

? Configuração adicional

Redis Configuration

  1. Configure uma instância Redis:

    • Crie um banco de dados Redis gratuito no Upstash
    • Obtenha seu URL de conexão Redis e detalhes de autenticação

  2. Configure redis em seu ambiente: 

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

Chaves de API necessárias

Certifique -se de obter e configurar essas chaves da API:

  • Chave da API OpenAI para LLM e recursos de visão
  • Chave da API de Langchain para processamento de linguagem aprimorado
  • Chave da API OpenWeatherMap para previsões meteorológicas
  • Supabase Project and Storage Keys para manuseio de arquivos

Adicione -os aos respectivos arquivos .dev.vars em cada pacote.

❗ Solução de problemas

Questões comuns

  1. A implantação do trabalhador falha

    • Verifique se o token da API CloudFlare tem permissões corretas
    • Verifique se os nomes dos trabalhadores em wrangler.toml são únicos
    • Verifique as ligações de namespace KV estão corretas

  2. Bot não responder

    • Confirme o URL do webhook está definido corretamente
    • Verifique a validade do token do Telegram Bot
    • Verificar Redis A conexão está funcionando

  3. Recursos não funcionando

    • Verifique se todas as teclas de API necessárias são válidas e configuradas adequadamente
    • Verifique os logs do trabalhador correspondentes no painel Cloudflare
    • Verifique as variáveis ​​de ambiente são definidas corretamente

Modo de depuração

Ativar modo de depuração configurando: 

 # Add to .dev.vars
DEBUG_MODE=true

Isso fornecerá logs mais detalhados no console de trabalhadores.

Obtendo ajuda

Se você encontrar problemas:

  1. Verifique a página de problemas
  2. Revise os logs dos trabalhadores do CloudFlare
  3. Ativar modo de depuração para um registro mais detalhado

Licença

Este projeto está licenciado sob a licença do MIT - consulte o arquivo de licença para obter detalhes.

Expandir
Informações adicionais
Aplicativos Relacionados
Recomendado para você
Informações Relacionadas Todos