Documentation

AgentWorx operations docs

AI worker를 실험에서 운영 가능한 workflow로 바꾸기 위한 핵심 개념, quick start, self-hosted 운영 방향을 정리합니다.

agentworx.yamlreference

agent: research-worker
objective: "collect market signals and draft summary"
tools:
  - web.search
  - browser.review
  - github.issue
approval_gates:
  - before: deploy.production
  - before: send.customer_email
observability:
  audit_log: true
  cost_tracking: true
  notify: discord

Quick start

운영 가능한 agent workflow의 기본 흐름

1. Define the worker

목표, 입력 데이터, 사용할 도구, 권한 범위, 사람이 승인해야 하는 단계를 선언합니다.

2. Run with guardrails

브라우저, 터미널, 파일, API 도구를 제한된 권한으로 실행하고 모든 step을 감사 가능한 로그로 남깁니다.

3. Review and approve

배포, 결제, 고객 데이터 접근처럼 위험도가 높은 액션은 human approval gate를 통과시킵니다.

4. Scale as playbooks

반복 가능한 workflow를 팀 playbook으로 저장하고 스케줄링, 재시도, 알림, 운영 대시보드로 확장합니다.

Core concepts

AgentWorx에서 자주 쓰는 용어

Agent

특정 목표를 수행하는 AI worker입니다. 모델, 시스템 지침, 도구, 실행 정책을 포함합니다.

Tool

Agent가 사용할 수 있는 제한된 capability입니다. 예: web search, browser QA, terminal, GitHub, Coolify deploy.

Approval Gate

위험한 작업 전 사람에게 맥락, diff, 예상 영향, rollback 방법을 보여주고 승인을 받는 단계입니다.

Run Log

누가, 언제, 어떤 agent를 실행했고 어떤 도구를 호출했는지 추적하는 감사 로그입니다.

Playbook

반복 업무를 재사용 가능한 workflow 템플릿으로 만든 것입니다. 팀 단위 공유와 버전 관리가 가능합니다.

Self-hosted Runtime

Coolify, Docker, PostgreSQL, Cloudflare Tunnel 같은 자체 인프라 위에서 실행되는 AgentWorx 운영 환경입니다.

Platform

What the platform ships today

1Waitlist and admin dashboard

2DB-backed dashboard and control plane with account login

3Agent and playbook builder

4Human approval gates

5Run timelines, logs, cost tracking, and retry history

6Self-hosted deployment templates

7Integrations: GitHub, Slack/Discord, browser QA, terminal workers