agent-orchestrator-test

Files (19)

• SKILL.md
• openai.yaml · agents/
• package.json
• flow.md · references/
• openclaw-config-template.json · references/
• media_video.SOUL.md · runtime-prompts/
• be-client.js · scripts/
• content_agent.js · scripts/
• intent_parser.js · scripts/
• logger.js · scripts/
• media_agent.js · scripts/
• memory.js · scripts/
• orchestrator.js · scripts/
• orchestrator.test.js · scripts/
• prompt_agent.js · scripts/
• publisher.js · scripts/
• transport.js · scripts/
• transport.test.js · scripts/
• video_agent.js · scripts/

SKILL.md (first lines)

# Agent Orchestrator Test

## Overview

Workflow hien tai:

1. `pho_phong` nhan brief.
2. `nv_content` research va viet content.
3. User duyet content.
4. `nv_prompt` viet image prompt.
5. `nv_media` tao anh bang prompt duoc giao va bat buoc gui:
   - anh san pham goc
   - logo cong ty trong `.openclaw/assets/logos`
6. User duyet anh va doc duoc prompt da dung.
7. `pho_phong` hoi dang ngay / hen gio, dong thoi goi y tao them video quang cao.
8. Neu user dong y tao video:
   - `media_video` tong hop brief video
   - `nv_prompt` viet VIDEO prompt
   - `media_video` dung `generate_veo_video` tao video bang anh goc san pham + logo cong ty
   - User duyet video va doc duoc video prompt da dung
9. Sau khi user duyet xong media can thiet, `pho_phong` moi dang bai hoac hen gio.

## Runtime requirements

- Can co 5 agent: `pho_phong`, `nv_content`, `nv_prompt`, `nv_media`, `media_video`.
- Neu co nhieu tai khoan/instance pho_phong, moi lan goi CLI phai truyen `--manager-instance-id <manager-instance-code>` de tach state, conversation, va worker session theo tung pho_phong.
- Ba manager instance mac dinh de test song song: `mgr_pho_phong_A`, `mgr_pho_phong_B`, `mgr_pho_phong_C`; ca ba dung chung worker templates `nv_content`, `nv_prompt`, `nv_media`.
- `pho_phong.subagents.allowAgents` phai co `nv_prompt`.
- `nv_prompt` dung workspace `C:/Users/PHAMDUCLONG/.openclaw/workspace_prompt`.
- `nv_media` dung prompt package tu `nv_prompt`, khong con mac dinh background-only.
- `media_video` dung workspace `C:/Users/PHAMDUCLONG/.openclaw/workspace_media_video`.
- `media_video` phai goi `generate_veo_video` voi:
  - `prompt`
  - `reference_image = anh san pham goc`
  - `logo_paths = tat ca logo cong ty`
  - `output_dir = workspace_media_video/artifacts/videos`

## Human-in-the-loop

- User luon duyet content truoc khi sang media.
- User luon duyet anh truoc khi dang bai.
- Neu tao them video, user luon duyet video truoc khi dang bai.
- Khi `pho_phong` goi entry point orchestrator, phai cho lenh chay xong va lay ket qua cuoi cung roi moi tra loi user.
- QUY TAC CUNG: Pho phong khong duoc tu ý viet content nháp. Neu nhận yêu cầu viết bài, BAT BUOC phai goi orchestrator de nv_content thuc hien.
- Khong duoc dung o trang thai `Process still running` trong luc dang cho `nv_content`; buoc nay bat buoc phai doi den khi co ban content de trinh duyet.
- `pho_phong` khong duoc gui thong bao kieu "da nhan brief", "dang giao viec", "dang kiem tra", "dang render" truoc khi da chay entry point orchestrator cho tin nhan hien tai va da xac minh state that.
- Khong gui thong bao tien do tam thoi cho buoc content/media/video trong chat root; phai tiep tuc cho/poll cho toi khi co checkpoint that hoac loi that tu orchestrator.
- Neu `current-workflow.json` da sang `awaiting_content_approval`, `awaiting_media_approval`, `awaiting_video_approval`, hoac `awaiting_publish_decision`, `pho_phong` phai trinh ngay checkpoint do, khong duoc tiep tuc noi "dang xu ly".
- Neu `nv_content` dang research web hoac `nv_media` / `media_video` dang render, `pho_phong` phai tiep tuc theo doi dung state that; khong duoc tu y bao loi neu chua co bang chung loi ro rang tu orchestrator hoac artifact.
- Summary media approval phai co:
  - preview media thuc te trong chat
  - prompt da dung
  - anh san pham goc da dung
  - danh sach logo da dung
- O buoc `awaiting_publish_decision`, `pho_phong` phai goi y:
  - `Co muon tao them video quang cao san pham tren roi dang len page khong?`
  - Neu user dong y, phai chuyen sang nhanh video thay vi publish ngay.
- Khi orchestrator tra ve truong `human_message`, `pho_phong` phai uu tien chuyen nguyen van truong nay cho user.
- Neu `human_message` co cac dong `MEDIA: "..."`, phai giu nguyen de gateway chat render anh; khong duoc doi sang duong dan text thuong.
- O buoc tao media, neu lenh chay tra ve `Command still running`, `pho_phong` phai tiep tuc `process poll` thay vi dung lai sau lan poll dau.

- Truoc khi gui thong bao tien do tam thoi, can kiem tra `workspace_phophong/agent-orchestrator-test/current-workflow.json`; neu da sang `awaiting_media_approval` thi phai trinh ngay media cho user duyet.
- Khong dung thong bao tam thoi lam ket qua cua workflow; neu tien trinh con chay, agent phai tiep tuc poll va chi tra checkpoint hoac loi that.


## Progress protocol

- Mac dinh, `pho_phong` chi tra lai checkpoint that cua orchestrator, khong tu viet thong bao tien do.
- Neu process van dang chay va chua co checkpoint duyet:
  - phai tiep tuc `process poll`;
  - phai kiem tra `agent-orchestrator-test/managers/<manager-instance-id>/current-workflow.json`;
  - neu state da doi sang checkpoint duyet thi trinh ngay checkpoint do.
- Khong gui thong bao tam thoi trong chat root; tiep tuc poll cho toi khi co checkpoint hoac loi that.
- Khong duoc rerun entry point chi vi PowerShell in ra log giua chung hoac `NativeCommandError` neu state file va checkpoint cho thay workflow van dang tien trien.

## Learning

- Feedback media: `nv_media` hoc vao `rules.json`.
- Feedback prompt: `nv_prompt` hoc vao `rules.json`.
- Knowledge base prompt co the bo sung them file vao:
  - `workspace_prompt/prompt-library.md`
  - `workspace_prompt/knowledge/*`

## Entry point

Dung OpenClaw home trung voi workspace/session hien tai. Tren may test nay la `C:/Users/PHAMDUCLONG/.openclaw`; khong dung home cua user khac.

Neu session key hien tai co segment `mgr_pho_phong_A`, `mgr_pho_phong_B`, hoac `mgr_pho_phong_C`, phai dung dung segment do cho `--manager-instance-id`. Neu khong co segment manager trong session key, suy ra theo tai khoan dang nhap: `pho_phong_a` dung `mgr_pho_phong_A`, `pho_phong_b` dung `mgr_pho_phong_B`, `pho_phong_c` dung `mgr_pho_phong_C`.

Moi manager phai dung file brief rieng trong `workspace_phophong/tmp/` de tranh 2 luong song song ghi de nhau.

```bash
node D:/openclaw/skills/agent-orchestrator-test/scripts/orchestrator.js --json --openclaw-home C:/Users/PHAMDUCLONG/.openclaw --from pho_phong --manager-instance-id mgr_pho_phong_A --message-file C:/Users/PHAMDUCLONG/.openclaw/workspace_phophong/tmp/workflow-brief-A.txt
```

Test manager B song song bang cung worker agents:

```bash
node D:/openclaw/skills/agent-orchestrator-test/scripts/orchestrator.js --json --openclaw-home C:/Users/PHAMDUCLONG/.openclaw --from pho_phong --manager-instance-id mgr_pho_phong_B --message-file C:/Users/PHAMDUCLONG/.openclaw/workspace_phophong/tmp/workflow-brief-B.txt
```

Test manager C song song bang cung worker agents:

```bash
node D:/openclaw/skills/agent-orchestrator-test/scripts/orchestrator.js --json --openclaw-home C:/Users/PHAMDUCLONG/.openclaw --from pho_phong --manager-instance-id mgr_pho_phong_C --message-file C:/Users/PHAMDUCLONG/.openclaw/workspace_phophong/tmp/workflow-brief-C.txt
```

State files duoc tach rieng:

- `workspace_phophong/agent-orchestrator-test/managers/mgr_pho_phong_A/current-workflow.json`
- `workspace_phophong/agent-orchestrator-test/managers/mgr_pho_phong_B/current-workflow.json`
- `workspace_phophong/agent-orchestrator-test/managers/mgr_pho_phong_C/current-workflow.json`

## Bat buoc cho `pho_phong`

- Khi user gui BAT KY tin nhan nao lien quan den workflow, `pho_phong` BAT BUOC phai:
  1. ghi nguyen van tin nhan do vao file tam;
  2. chay dung entry point orchestrator o tren;
  3. doi den khi lenh tra JSON ket qua hoac loi that;

From Nongcode/TPE_OpenClaw, MIT.

More from Nongcode/TPE_OpenClaw