744c149300
Some checks failed
Build and Deploy Docs / build-and-deploy (push) Has been cancelled
- Created logs/ structure (sessions, operations, incidents) - Added session-start/log/end scripts - Installed Git hooks for auto-logging commits/pushes - Added shell integration for zsh - Created CHANGELOG.md - Documented today's session (2026-01-10)
168 lines
2.7 KiB
Markdown
168 lines
2.7 KiB
Markdown
# ⚡ QUICKSTART: Phase 2 Agent Integration
|
|
|
|
**5-минутний старт**
|
|
|
|
---
|
|
|
|
## 🚀 One-Command Start
|
|
|
|
```bash
|
|
cd /Users/apple/github-projects/microdao-daarion
|
|
./scripts/start-phase2.sh
|
|
```
|
|
|
|
Це запустить:
|
|
- ✅ agent-filter (port 7005)
|
|
- ✅ router (port 8000)
|
|
- ✅ agent-runtime (port 7006)
|
|
|
|
---
|
|
|
|
## 🧪 Test Everything
|
|
|
|
```bash
|
|
./scripts/test-phase2-e2e.sh
|
|
```
|
|
|
|
Очікуваний результат:
|
|
```
|
|
✅ PASS: agent-filter is healthy
|
|
✅ PASS: router is healthy
|
|
✅ PASS: agent-runtime is healthy
|
|
✅ PASS: messaging-service is healthy
|
|
✅ PASS: agent-filter allows message
|
|
✅ PASS: agent-filter targets correct agent
|
|
✅ PASS: router creates invocation
|
|
✅ PASS: router sets correct entrypoint
|
|
```
|
|
|
|
---
|
|
|
|
## 💬 Test in UI
|
|
|
|
1. **Відкрий Messenger:**
|
|
```
|
|
http://localhost:8899/messenger
|
|
```
|
|
|
|
2. **Вибери канал:**
|
|
"DAARION City General"
|
|
|
|
3. **Напиши:**
|
|
```
|
|
Hello Sofia!
|
|
```
|
|
|
|
4. **Чекай 3-5 секунд**
|
|
|
|
5. **Побачиш відповідь агента:**
|
|
```
|
|
Привіт! Я Sofia, асистент команди DAARION. Як можу допомогти?
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Check Status
|
|
|
|
```bash
|
|
# Services
|
|
docker ps | grep -E '(agent-filter|router|agent-runtime)'
|
|
|
|
# Logs (real-time)
|
|
docker logs -f agent-filter
|
|
docker logs -f router
|
|
docker logs -f agent-runtime
|
|
|
|
# Health
|
|
curl http://localhost:7005/health
|
|
curl http://localhost:8000/health
|
|
curl http://localhost:7006/health
|
|
```
|
|
|
|
---
|
|
|
|
## 🐛 If Something Wrong
|
|
|
|
### Services not running?
|
|
|
|
```bash
|
|
# Restart
|
|
./scripts/stop-phase2.sh
|
|
./scripts/start-phase2.sh
|
|
```
|
|
|
|
### NATS not connected?
|
|
|
|
```bash
|
|
# Check NATS
|
|
docker ps | grep nats
|
|
docker logs nats
|
|
|
|
# Restart NATS
|
|
docker restart nats
|
|
|
|
# Restart agents
|
|
./scripts/stop-phase2.sh
|
|
./scripts/start-phase2.sh
|
|
```
|
|
|
|
### Agent not replying?
|
|
|
|
```bash
|
|
# Check logs step-by-step
|
|
docker logs agent-filter | grep "Decision"
|
|
docker logs router | grep "invocation"
|
|
docker logs agent-runtime | grep "replied"
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 What to Try
|
|
|
|
### Test Keywords:
|
|
|
|
- "Привіт" → Greeting
|
|
- "Hello" → Greeting
|
|
- "Допоможи" → Help menu
|
|
- "Phase 2" → Phase 2 explanation
|
|
- "Дякую" → Thanks acknowledgment
|
|
- Any question with "?" → Smart response
|
|
|
|
---
|
|
|
|
## 📚 Documentation
|
|
|
|
- [PHASE2_COMPLETE.md](PHASE2_COMPLETE.md) — Full guide
|
|
- [IMPLEMENTATION_SUMMARY.md](IMPLEMENTATION_SUMMARY.md) — What was built
|
|
- `services/agent-filter/README.md` — agent-filter docs
|
|
- `services/agent-runtime/README.md` — agent-runtime docs
|
|
- `services/router/README.md` — router docs
|
|
|
|
---
|
|
|
|
## 🎉 Success!
|
|
|
|
If agent replies, **Phase 2 works!** 🚀
|
|
|
|
**Next:** Check [PHASE3_ROADMAP.md](docs/tasks/PHASE3_ROADMAP.md) for what's next.
|
|
|
|
---
|
|
|
|
**Questions?** Check logs or documentation above.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|