python task v2

Python Task V2: Posting dan Komentar API Manajemen dengan AI Moderasi

Daftar isi

1. Deskripsi proyek
2. Fitur
3. Struktur proyek
4. Instalasi
5. Menjalankan API
6. Menjalankan bot
7. Pengaturan API AI
8. Menjalankan tes
9. Berkontribusi

Deskripsi proyek

Proyek ini adalah API sederhana untuk mengelola posting dan komentar dengan AI Moderation. API dibangun menggunakan Fastapi dan Pydantic, dan termasuk fitur untuk pendaftaran pengguna, login, manajemen pos dan komentar, moderasi konten bertenaga AI, dan analitik. Selain itu, bot disertakan untuk menghasilkan posting dan komentar menggunakan AI dan berinteraksi dengan API.

Fitur

• Pendaftaran dan Login Pengguna : Otentikasi Pengguna Aman dengan JWT.
• Posting dan Manajemen Komentar : Buat, baca, perbarui, dan hapus posting dan komentar.
• AI Moderasi : Deteksi otomatis dan pemblokiran bahasa kotor dan penghinaan dalam posting dan komentar.
• Analytics : Dapatkan analitik tentang jumlah komentar yang ditambahkan ke posting selama periode tertentu.
• Bot : Bot sederhana untuk menghasilkan dan memposting konten menggunakan AI.

Struktur proyek

 .
├── alembic/
├── app/
│   ├── __pycache__/
│   ├── auth.py
│   ├── crud.py
│   ├── database.py
│   ├── deps.py
│   ├── main.py
│   ├── models.py
│   ├── moderation.py
│   ├── schemas.py
├── bot/
│   ├── __pycache__/
│   ├── bot.py
│   ├── config.py
│   ├── template_config.py
├── venv/
├── tests/
│   ├── test_main.py
│   ├── test_post.py
├── .gitignore
├── alembic.ini
├── init_db.py
├── readme
├── requirements.txt
└── test.db

Instalasi

1. Mengatur lingkungan virtual

Buat dan aktifkan lingkungan virtual Python:

Di Windows:

python -m venv venv
venv S cripts a ctivate

Di macOS/linux:

python3 -m venv venv
source venv/bin/activate

2. Pasang dependensi

Pasang paket Python yang diperlukan:

pip install -r requirements.txt

3. Mengatur kredensial Google Cloud

Pastikan Anda memiliki file Key Account (JSON) Google Cloud Service dan atur variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS .

Di Windows:

 set GOOGLE_APPLICATION_CREDENTIALS=C: p ath t o y our s ervice-account-file.json

Di macOS/linux:

 export GOOGLE_APPLICATION_CREDENTIALS= " /path/to/your/service-account-file.json "

4. Terapkan migrasi

Gunakan Alembic untuk menerapkan migrasi basis data:

alembic upgrade head

5. Inisialisasi database

Jalankan skrip berikut untuk menginisialisasi database:

python init_db.py

6. Variabel Lingkungan

Buat file .env di root proyek dan tambahkan variabel berikut:

GOOGLE_APPLICATION_CREDENTIALS= " /path/to/your/service-account-file.json "

Tambahkan variabel khusus lingkungan lainnya yang Anda butuhkan untuk pengaturan FASTAPI Anda.

Menjalankan API

Mulai server API

Untuk memulai server FASTAPI, jalankan:

uvicorn app.main:app --reload

API akan dapat diakses di http://127.0.0.1:8000 .

Titik akhir API

• Root Endpoint : GET /
  Mengembalikan pesan selamat datang.

• Pendaftaran Pengguna : POST /register/
  Daftarkan pengguna baru.

• Login Pengguna : POST /login/
  Dapatkan token akses untuk pengguna yang diautentikasi.

• Buat Posting : POST /posts/
  Buat posting baru.

• Buat Komentar : POST /posts/{post_id}/comments/
  Tambahkan komentar ke posting.

• Dapatkan Analytics : GET /api/comments-daily-breakdown?date_from=<YYYY-MM-DD>&date_to=<YYYY-MM-DD>
  Dapatkan data komentar agregat harian dalam kisaran tanggal.

• Respons Otomatis terhadap Komentar : /comments/auto-response/
  Titik akhir dan logika untuk mengaktifkan respons otomatis terhadap komentar setelah penundaan.

Menjalankan bot

Konfigurasikan bot

Pengaturan bot dapat disesuaikan dalam file bot/config.py , termasuk:

• Jumlah pengguna untuk membuat dan meniru
• Jenis Komentar untuk Dibuat (positif/negatif)
• Jumlah posting dan komentar untuk dibuat untuk setiap pengguna

Mulai bot

Untuk menjalankan bot dan mulai menghasilkan posting dan komentar, jalankan:

python bot/bot.py

Pengaturan API AI

Untuk mengaktifkan bot untuk menghasilkan konten teks menggunakan AI generatif Google, ikuti langkah -langkah ini:

1. Buat Proyek Google Cloud :

   • Pergi ke Google Cloud Console.
   • Klik pada dropdown proyek dan pilih "Proyek Baru".
   • Masukkan nama untuk proyek Anda dan klik "Buat".
   • Setelah proyek dibuat, pastikan itu dipilih.

2. Aktifkan API AI generatif :

   • Di Google Cloud Console, navigasikan ke "API & Services"> "Library".
   • Cari "API AI Generatif" dan klik di atasnya.
   • Klik "Aktifkan" untuk mengaktifkan API untuk proyek Anda.

3. Dapatkan kredensial API :

   • Pergi ke "APIS & Services"> "Kredensial".
   • Klik "Buat Kredensial" dan pilih "Kunci API".
   • Salin kunci API yang disediakan. Anda akan membutuhkan ini untuk aplikasi Anda.

4. Instal Perpustakaan Klien API :

   • Instal Google Cloud Generative AI Python Client Library menggunakan PIP:

     pip install google-generativeai

5. Konfigurasikan aplikasi :

   • Simpan kunci API Anda di bot/config.py :

      # bot/config.py
     class Config :
        API_URL = "http://localhost:8000"  # URL of your FastAPI app
        AI_API_URL = "https://ai.google.dev/generate-text"  # Google's AI API endpoint
        AI_API_KEY = "your_ai_key"  # Replace with your Google AI API key

   • Pastikan bot Anda dikonfigurasi untuk menggunakan tombol API ini saat menghasilkan konten teks.

Menjalankan tes

Jalankan Test Suite

Tes disediakan untuk fungsi Post Creation dan Analytics. Untuk menjalankan tes, jalankan:

pytest

Ini akan menjalankan tes untuk pembuatan pasca, analitik, dan aspek lain dari aplikasi.

Berkontribusi

1. Garpu repositori.
2. Buat Cabang Fitur ( git checkout -b feature-branch ).
3. Komit perubahan Anda ( git commit -m 'Add some feature' ).
4. Dorong ke cabang ( git push origin feature-branch ).
5. Buka permintaan tarik.

Informasi tambahan

Untuk pertanyaan tambahan atau pemecahan masalah, silakan merujuk ke dokumentasi resmi untuk Fastapi, Sqlalchemy, dan Google Generative AI API. ``