dark/auto_agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
auto_agent/backend/README.md

3.1 KiB
Raw Blame History

Smart Deploy Agent Demo Backend

Setup

python -m venv .venv
.venv\\Scripts\\python -m pip install -e backend

Run

.venv\\Scripts\\python -m uvicorn app.main:app --reload --app-dir backend

Test

The lightweight API verification can run with in-memory SQLite:

set PYTHONPATH=backend
set DATABASE_URL=sqlite:///:memory:
.venv\\Scripts\\python -m pytest backend/tests -q -p no:cacheprovider

Runtime Notes

This repo currently defaults to:

  1. database: sqlite:///./data/agent_demo.db
  2. demo cache / queue: no Redis dependency
  3. edge defaults: edge_id=edge-shanghai-001 tool_name=http_health_check
  4. demo operator defaults: alice(u1001) for task execution bob(u2001) for approval

In the current sandbox, file-based SQLite may fail with disk I/O error. For tests and local verification here, use:

set DATABASE_URL=sqlite:///:memory:

Implemented API Scope

Current backend includes:

  1. agent task POST /api/agent/tasks POST /api/agent/tasks/{task_id}/confirm POST /api/agent/tasks/{task_id}/cancel GET /api/agent/tasks/{task_id} GET /api/agent/tasks/{task_id}/report
  2. demo identity POST /api/demo/identity/login GET /api/demo/identity/me GET /api/demo/identity/users/{user_id}/permissions POST /api/demo/identity/token/introspect
  3. demo approval POST /api/demo/approval/requests GET /api/demo/approval/requests/{approval_id} POST /api/demo/approval/requests/{approval_id}/decision GET /api/demo/approval/requests
  4. demo software-a POST /api/demo/software-a/deploy-tasks GET /api/demo/software-a/deploy-tasks/{software_a_task_id} POST /api/demo/software-a/permissions/check
  5. edge POST /api/agent/edge/heartbeat POST /api/agent/edge/tasks/pull POST /api/agent/edge/tasks/report POST /api/agent/edge/events

Current execution flow:

  1. create task
  2. confirm task
  3. high-risk task enters approval flow
  4. check software-a demo permission
  5. create software-a demo deploy task
  6. create default edge verification step
  7. edge pulls and reports verification result
  8. task reaches SUCCEEDED / FAILED / CANCELLED
  9. task detail/report returns software-a status, approval trace, tool trace, verification trace and audit trace

Demo failure semantics currently include:

  1. if app_code or version contains fail, software-a demo returns a failed deploy task
  2. approval rejection moves task to CANCELLED
  3. failed edge report moves task to FAILED

Current Verification Baseline

Automated tests currently cover:

  1. create / confirm / get task
  2. high-risk approval path
  3. identity and software-a demo APIs
  4. edge heartbeat / pull / report
  5. edge event report
  6. task report trace aggregation
  7. cancel running task

Current baseline: 14 passed

Next Focus

Recommended next implementation steps:

  1. compute and persist duration_ms
  2. refine richer result summaries and audit details
  3. add more idempotency and rollback tests
  4. then continue with local edge-agent bootstrap and second-batch OpenAPI