70 lines
3.7 KiB
Markdown
Executable file
70 lines
3.7 KiB
Markdown
Executable file
# مشکلات و وضعیت بخش چت AI
|
||
|
||
این سند مشکلات شناسایی‌شده و وضعیت رفع آن‌ها را فهرست می‌کند.
|
||
|
||
ممیزی زندهٔ کل سیستم ایجنت (اولویت، معیار پذیرش سطح جهانی، و آیتم‌های باز): [`AI_AGENT_SYSTEM_AUDIT.md`](AI_AGENT_SYSTEM_AUDIT.md).
|
||
|
||
## ✅ رفع‌شده (۲۰۲۶)
|
||
|
||
| موضوع | وضعیت |
|
||
|--------|--------|
|
||
| تأخیر `done` به‌خاطر `generate_chat_title` | عنوان در پس‌زمینه؛ `done` بلافاصله پس از commit |
|
||
| بارگذاری prompt همه‌یا‌هیچ | trace هر loader به‌محض اتمام؛ RAG با timeout و intent |
|
||
| `checkAvailability` قبل از هر پیام | کش ۲ دقیقه‌ای در Flutter |
|
||
| نبود بازخورد قبل از اولین chunk SSE | رویدادهای `status` + `heartbeat` + UI optimistic |
|
||
| برچسب‌های تکراری ابزار (FA hardcoded) | `ai_tool_keys.py` + کلیدهای l10n در Flutter |
|
||
| Function calls sequential | `asyncio.gather` + `run_in_executor` |
|
||
| Timeout کوتاه stream | `receiveTimeout` ۱۰ دقیقه در `AIService` |
|
||
| Progress فقط spinner | نوار وضعیت + **تایم‌لاین Agent Trace** (زنجیره مراحل) |
|
||
| لغو بدون ذخیره partial | ذخیره محتوای نیمه‌کاره + trace در `_stopGenerating` |
|
||
| نبود زنجیره تفکر مرئی | `trace_step` SSE + `AIAgentTraceTimeline` + ذخیره در `_agent_trace` |
|
||
| Exploration | `explore` / `explored` / `thought` trace + `ai_exploration_service` + `mode=explore\|auto\|off` |
|
||
|
||
## 🟡 باقی‌مانده (متوسط)
|
||
|
||
### DB همچنان sync
|
||
- عملیات SQLAlchemy در `run_in_executor` اجرا می‌شود؛ migration به async DB در صورت نیاز مقیاس بالا.
|
||
|
||
### ~~بدون retry LLM~~ (بهبود ۲۰۲۶-۰۵)
|
||
- retry خودکار در `ai_retry_policy` + OpenAI provider (۳ بار، backoff)
|
||
- trace `kind=system` + بنر بازیابی Flutter
|
||
|
||
### Anthropic / Local provider
|
||
- map خطای ضعیف‌تر؛ Ollama tools ناقص در streaming.
|
||
|
||
### Operator/Admin tools
|
||
- `_register_operator_functions` و admin هنوز خالی (`pass`).
|
||
|
||
### CRM / تیکت / workflow
|
||
- پیشنهاد تیکت و خلاصهٔ CRM با `?stream=true` استریم می‌شوند (ویجت متن زنده + وضعیت + توقف).
|
||
- مسیر JSON قبلی برای سازگاری و پاسخ خودکار تیکت مانده است.
|
||
|
||
## 🔵 پیشنهاد بعدی
|
||
|
||
- Refactor state چت به Riverpod/Bloc برای تست‌پذیری
|
||
- `trace_id` در SSE برای دیباگ
|
||
- planning_tools زودتر (روی اولین delta ابزار از provider)
|
||
- i18n کامل سایر متن‌های hardcoded در `ai_chat_dialog.dart`
|
||
|
||
## قرارداد SSE (خلاصه)
|
||
|
||
| type | معنی |
|
||
|------|------|
|
||
| `status` | `phase`, `step?`, `tool_key?` |
|
||
| `trace_step` | گام تایم‌لاین: `kind`, `state`, `title_key`, `body_markdown?`, `tool?` |
|
||
| `heartbeat` | `elapsed_ms` |
|
||
| `tool_start` / `tool_end` | اجرای function |
|
||
| `content` | delta متن |
|
||
| `done: true` | پایان + usage + `agent_trace` |
|
||
|
||
انواع `kind` در trace: `context`, `explore`, `explored`, `thought`, `narrative`, `plan`, `tool`, `observation`, `plan_next`, `answer`
|
||
|
||
### حالت Exploration
|
||
|
||
| پارامتر | معنی |
|
||
|---------|------|
|
||
| `mode=auto` (پیش‌فرض) | برای سوال medium/complex فعال می‌شود |
|
||
| `mode=explore` | همیشه + Thought با LLM برای bundleهای ≥۲ ابزار |
|
||
| `mode=off` | فقط حلقهٔ agent کلاسیک |
|
||
|
||
فیلدهای اضافه در `trace_step`: `bundle_id`, `explore_target`, `entity_refs`, `findings_count`, `hypothesis`, `confidence`
|