Quy trình phát triển Pi

Hướng dẫn này tóm tắt quy trình hợp lý để làm việc với tích hợp pi trong Mayros.

Kiểm tra kiểu và Linting

  • Kiểm tra kiểu và build: pnpm build
  • Lint: pnpm lint
  • Kiểm tra format: pnpm format
  • Gate đầy đủ trước khi push: pnpm lint && pnpm build && pnpm test

Chạy test Pi

Sử dụng script chuyên dụng cho bộ test tích hợp pi:

bash
scripts/pi/run-tests.sh

Để bao gồm test live thực thi hành vi provider thực:

bash
scripts/pi/run-tests.sh --live

Script chạy tất cả test đơn vị liên quan đến pi qua các glob này:

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

Test thủ công

Quy trình được khuyến nghị:

  • Chạy gateway trong chế độ dev:
    • pnpm gateway:dev
  • Kích hoạt agent trực tiếp:
    • pnpm mayros agent --message "Xin chào" --thinking low
  • Sử dụng TUI để debug tương tác:
    • pnpm tui

Đối với hành vi gọi công cụ, nhắc nhở một hành động read hoặc exec để bạn có thể thấy streaming công cụ và xử lý payload.

Reset bảng sạch

Trạng thái nằm dưới thư mục trạng thái Mayros. Mặc định là ~/.mayros. Nếu MAYROS_STATE_DIR được đặt, sử dụng thư mục đó thay thế.

Để reset mọi thứ:

  • mayros.json cho cấu hình
  • credentials/ cho profile xác thực và token
  • agents/<agentId>/sessions/ cho lịch sử phiên agent
  • agents/<agentId>/sessions.json cho chỉ mục phiên
  • sessions/ nếu đường dẫn cũ tồn tại
  • workspace/ nếu bạn muốn workspace trống

Nếu bạn chỉ muốn reset phiên, xóa agents/<agentId>/sessions/ và agents/<agentId>/sessions.json cho agent đó. Giữ credentials/ nếu bạn không muốn xác thực lại.

Tham khảo