DASHSCOPE_SETUP_GUIDE.md•8.92 kB
# 📘 Подробная инструкция по настройке Alibaba Cloud DashScope API
## 🎯 Цель
Активировать доступ к моделям Qwen через DashScope API для использования в автономном агенте.
---
## 📋 ШАГ 1: Регистрация/Вход в Alibaba Cloud
### 1.1. Откройте сайт DashScope
Перейдите по адресу: **https://dashscope.console.aliyun.com/**
### 1.2. Вход в систему
- Если у вас **НЕТ** аккаунта:
- Нажмите **"Sign Up"** или **"Регистрация"**
- Заполните форму (email, пароль)
- Подтвердите email
- Войдите в систему
- Если у вас **ЕСТЬ** аккаунт:
- Нажмите **"Sign In"** или **"Вход"**
- Введите email и пароль
- Войдите в систему
---
## 🔑 ШАГ 2: Получение API ключа
### 2.1. Переход в раздел API Keys
После входа в консоль DashScope:
1. Найдите в меню слева раздел **"API Keys"** или **"API密钥"**
2. Или перейдите напрямую: **https://dashscope.console.aliyun.com/apiKey**
### 2.2. Создание нового API ключа
1. Нажмите кнопку **"Create API Key"** или **"创建API密钥"**
2. Введите название ключа (например: "Trader Agent")
3. Нажмите **"Create"** или **"创建"**
4. **ВАЖНО:** Скопируйте ключ сразу! Он показывается только один раз!
- Формат ключа: `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
### 2.3. Если у вас уже есть ключ
- Проверьте что ключ активен (Status: Active)
- Если ключ неактивен, активируйте его
- Скопируйте ключ для использования
---
## 💳 ШАГ 3: Активация доступа к моделям (КРИТИЧНО!)
### 3.1. Проверка баланса и подписки
1. В консоли DashScope найдите раздел **"Billing"** или **"计费"**
2. Или перейдите: **https://dashscope.console.aliyun.com/billing**
### 3.2. Активируйте бесплатный tier (если доступен)
1. Найдите раздел **"Free Tier"** или **"免费额度"**
2. Нажмите **"Activate"** или **"激活"**
3. Следуйте инструкциям для активации
### 3.3. Проверьте доступные модели
1. Перейдите в раздел **"Models"** или **"模型"**
2. Или: **https://dashscope.console.aliyun.com/models**
3. Найдите модели:
- `qwen-turbo` (обычно бесплатная)
- `qwen-plus` (может требовать подписку)
- `qwen-max` (обычно платная)
### 3.4. Если модели недоступны
**Вариант А: Активировать бесплатный tier**
- В разделе Billing найдите "Free Tier"
- Активируйте его
- Обычно даётся $5-10 бесплатных кредитов
**Вариант Б: Пополнить баланс**
- В разделе Billing нажмите "Recharge" или "充值"
- Пополните баланс минимум на $5-10
- После пополнения модели станут доступны
**Вариант В: Проверить регион**
- Убедитесь что вы используете правильный регион
- Некоторые модели доступны только в определённых регионах
---
## 🧪 ШАГ 4: Тестирование API ключа
### 4.1. Установите переменную окружения
Откройте терминал и выполните:
```bash
export QWEN_API_KEY="sk-ваш-ключ-здесь"
```
### 4.2. Запустите тест
```bash
cd /Users/Gyber/GYBERNATY-ECOSYSTEM/TRADER-AGENT
source venv/bin/activate
python test_qwen_simple.py
```
### 4.3. Проверьте результат
- ✅ Если видите **"✅ УСПЕХ!"** - всё работает!
- ❌ Если видите **"403 Unpurchased"** - вернитесь к ШАГУ 3
---
## 🔍 ШАГ 5: Решение проблем
### Проблема 1: "AccessDenied.Unpurchased"
**Решение:**
1. Проверьте баланс в разделе Billing
2. Активируйте бесплатный tier или пополните баланс
3. Подождите 5-10 минут после пополнения
4. Попробуйте снова
### Проблема 2: "Invalid API Key"
**Решение:**
1. Проверьте что ключ скопирован полностью (начинается с `sk-`)
2. Убедитесь что нет лишних пробелов
3. Создайте новый ключ если старый не работает
### Проблема 3: Модель недоступна
**Решение:**
1. Попробуйте другую модель (`qwen-turbo` обычно самая доступная)
2. Проверьте что модель доступна в вашем регионе
3. Проверьте баланс (некоторые модели требуют минимальный баланс)
### Проблема 4: Не могу найти разделы в консоли
**Решение:**
1. Убедитесь что вы на правильном сайте: **dashscope.console.aliyun.com**
2. Проверьте что вы вошли в правильный аккаунт
3. Попробуйте переключить язык интерфейса (EN/CN)
---
## 📞 ШАГ 6: Получение помощи
### Если ничего не помогает:
1. **Официальная документация:**
- https://help.aliyun.com/product/2400179.html
- https://dashscope.aliyun.com/docs
2. **Поддержка Alibaba Cloud:**
- В консоли найдите раздел "Support" или "支持"
- Откройте тикет поддержки
- Опишите проблему на английском или китайском
3. **Сообщество:**
- GitHub: https://github.com/QwenLM/Qwen
- Форумы Alibaba Cloud
---
## ✅ Чеклист готовности
Проверьте что у вас есть:
- [ ] Аккаунт Alibaba Cloud создан и подтверждён
- [ ] API ключ создан и скопирован (формат: `sk-...`)
- [ ] Бесплатный tier активирован ИЛИ баланс пополнен
- [ ] Модель `qwen-turbo` доступна в консоли
- [ ] Тест `test_qwen_simple.py` проходит успешно
- [ ] Переменная `QWEN_API_KEY` установлена
---
## 🚀 После успешной настройки
Когда всё заработает:
1. **Обновите GitHub Secrets:**
```bash
# В GitHub репозитории:
# Settings → Secrets and variables → Actions
# Обновите QWEN_API_KEY
```
2. **Запустите полный тест:**
```bash
python -m autonomous_agent.main
```
3. **Проверьте публикацию в Telegram:**
- Убедитесь что `TELEGRAM_BOT_TOKEN` и `TELEGRAM_CHAT_IDS` установлены
- Проверьте что сообщения приходят в канал
---
## 📝 Важные замечания
1. **API ключ показывается только один раз** - сохраните его сразу!
2. **Бесплатный tier может иметь лимиты** - проверьте квоты
3. **Некоторые модели платные** - `qwen-turbo` обычно самая доступная
4. **Баланс может обновляться с задержкой** - подождите 5-10 минут после пополнения
---
## 🎓 Альтернативные варианты (если DashScope не работает)
Если по каким-то причинам DashScope не подходит, можно использовать:
1. **OpenRouter** (поддерживает Qwen):
- https://openrouter.ai/
- Регистрация проще
- Есть бесплатный tier
2. **Другие AI сервисы:**
- OpenAI API (если есть доступ)
- Anthropic Claude API
- Google Gemini API
---
**Удачи с настройкой! 🚀**
Если возникнут вопросы на каком-то шаге - напишите, помогу разобраться!