Corpitall Agents API

Docs ReDoc Health Check

🧪 Test Arayüzleri

▼
API'yi test etmek için kullanabileceğiniz arayüzler

💬 CorpAI Test UI

Ana sohbet ajanı için test arayüzü

🎓 Learning Agent Test UI

Öğrenme ajanı için test arayüzü

🏢 Branch Center Agent Test UI

Dal merkezi ajanı için test arayüzü

📝 Feedback Management UI

Feedback yönetimi için CRUD arayüzü

📋 Diğer Endpointler

▼

💬 Chat Endpoints

▼
🤖 CorpAI

POST /conversation/create

Yeni bir konuşma thread'i oluşturur

Response: { "thread_id": "thread_abc123" }

POST /conversation/{thread_id}

Belirli bir thread'de mesaj gönderir ve yanıt alır (streaming ve non-streaming destekler)

Request: { "message": "Merhaba", "stream": true, "user": { "id": "user123", "name": "John", "surname": "Doe" } }

GET /conversation/messages/{thread_id}

Belirli bir thread'in konuşma geçmişini getirir

Response: { "messages": [{ "role": "user", "content": "..." }], "thread_id": "thread_abc123" }
🎓 Learning Agent

POST /learning_agent/conversation/create

Yeni bir öğrenme konuşması thread'i oluşturur

Response: { "thread_id": "thread_abc123" }

POST /learning_agent/conversation/{thread_id}

Öğrenme ajanı ile mesaj gönderir ve yanıt alır (streaming ve non-streaming destekler)

Request: { "message": "Merhaba", "stream": true, "context": { "user": {...}, "company": {...}, "course": {...} } }

GET /learning_agent/conversation/messages/{thread_id}

Öğrenme konuşmasının geçmişini getirir

Response: { "messages": [{ "role": "user", "content": "..." }], "thread_id": "thread_abc123" }
🎤 Voice

POST /voice/stt

Sesi metne çevirir (Speech-to-Text). Query params: thread_id, language (optional). Body: file (multipart/form-data)

Query: ?thread_id=thread_abc123&language=tr
Body: file (audio file: m4a, mp3, webm)

POST /voice/tts

Metni sese çevirir (Text-to-Speech)

Request: { "thread_id": "thread_abc123", "text": "Merhaba dünya", "voice": "ash", "language": "tr" }
Response: { "thread_id": "...", "text": "...", "audio": "base64_encoded_audio", "voice": "ash" }

📊 Report Endpoints

▼

POST /reports/create

Yeni bir rapor oluşturur. Desteklenen rapor tipleri: cv_analysis, pi_report, sfa_report, esa_report, cda_report, csa_report, cma_report, cla_report, esg_report, swot_report, doctor_questions_report, service_recommendation_report, fmcl_report, cdr_report

Request: { "report_type": "cv_analysis", "report_input": { "pdf_url": "...", "profile_info": {...}, "case_study": {...} } }

GET /reports/check/{response_id}

Raporun durumunu kontrol eder (queued, completed, failed)

Response: { "status": "completed", "message": "...", "response_id": "...", "metadata": {...}, "output": {...} }

POST /reports/webhook

OpenAI webhook'larını işler (response.completed event'lerini dinler)

⚙️ System Endpoints

▼

GET /system/get_feedbacks

Feedback'leri getirir (filtreleme: type, category, status, before, after, limit, page)

Query: ?type=bug&status=pending&limit=10&page=1

GET /system/get_feedback/{feedback_id}

Belirli bir feedback'i ID ile getirir

POST /system/create_feedback

Yeni bir feedback oluşturur

Request: { "type": "bug", "category": "ui", "content": "...", "user_id": "...", "user_name": "...", "user_surname": "..." }

PUT /system/update_feedback/{feedback_id}

Mevcut bir feedback'i günceller

PATCH /system/update_feedback_status/{feedback_id}

Feedback'in sadece status'unu günceller (pending, in_progress, fixed, ignored)

Request: { "status": "fixed" }

DELETE /system/delete_feedback/{feedback_id}

Bir feedback'i siler

GET /health

API sağlık durumunu kontrol eder

Response: { "status": "healthy", "vercel": true, "version": "..." }

📜 Legacy Endpoints

▼
📄 CV Analysis

POST /cv_analysis/analyze

CV dosyasını analiz eder ve detaylı rapor döndürür

Request: { "pdf_url": "https://...", "profile_info": { "user_id": "...", "name": "...", "surname": "..." }, "case_study": {...} }

POST /cv_analysis/from_logs/{user_id}

Kullanıcının son CV analiz sonucunu loglardan getirir

🏢 MDA Report

POST /mda_analysis/start-report/

MDA raporu oluşturma işlemini başlatır

Request: { "report_input": {...} }

POST /mda_analysis/check-report-status/

MDA raporunun durumunu kontrol eder

Request: { "ids": { "run_id": "...", "thread_id": "..." } }

POST /mda_analysis/get-report/

MDA raporunu getirir

Request: { "ids": { "run_id": "...", "thread_id": "..." } }

POST /mda_analysis/get-full-report/

Tam MDA raporunu getirir

Request: { "ids": { "run_id": "...", "thread_id": "..." } }

POST /mda_analysis/get-full-report-text/

MDA raporunu düz metin formatında getirir

Request: { "ids": { "run_id": "...", "thread_id": "..." } }
🔍 PI Report (Preliminary Intelligence)

POST /pi_report/create

Şirket için ön istihbarat raporu oluşturur

Request: { "company_name": "Corpitall", "company_website": "https://corpitall.com" }

GET /pi_report/check/{response_id}

Ön istihbarat raporunun durumunu kontrol eder