워크플로 구축

일상적인 요청을 자동화로 전환하고, 미리 보기, 테스트, 전달 채널을 설정합니다

자동화를 어디서 시작해야 할지 모르겠다면 여기서 시작하세요. 아래 예시는 실제 사용자가 묻는 방식 그대로 작성되었으며, 각 예시는 현재 지원되는 워크플로 제품 화면에 직접 연결됩니다.

처음으로 자금을 입금한 세션이라면 처음 설정을 먼저 진행하세요.

💡 로컬 워크플로는 배포 전에 workflow_test를 지원합니다. 메시지 기반 워크플로의 경우, 테스트 시 설정된 플랫폼으로 실제 메시지를 발송하여 채널이 정상 작동하는지 확인할 수 있습니다. 대상 플랫폼이 아직 연결되지 않은 경우, 어떤 제공자를 연결해야 하는지 안내하며 사전에 테스트를 거부합니다.

자동화 개념 이해

워크플로는 내장 워크플로 엔진에서 실행됩니다. 예약된 브리핑, 알림, 모니터링에 사용하세요. 워크플로는 도구 핸들러를 직접 호출하며, LLM 노드가 명시적으로 포함되지 않는 한 token을 소비하지 않습니다.

자율 거래 전략은 Autopilot에서 다룹니다. 별도의 섹션입니다.

🟢 에이전트 워크플로

가장 안전한 자동화 진입점입니다. 감시, 요약, 알림을 수행하며 자금은 이동하지 않습니다.

1. 텔레그램 가격 알림

프롬프트

Alert me on Telegram if ETH trades below $3000.

Agent 응답:

가격 임계값 워크플로를 생성합니다.

자산: ETH

트리거: 최근 가격이 $3,000 미만

전달: 텔레그램

쿨다운: 알림 간 15분

생성하시겠습니까? yes 또는 no로 답해 주세요.

채널이 아직 설정되지 않은 경우, Minara는 메시징 페이지로 안내합니다.

2. 아침 시장 브리핑

프롬프트

Send me a BTC, ETH, and SOL market brief every day at 8am Shanghai time.

Agent 응답:

예약된 로컬 워크플로를 생성합니다.

일정: 매일 08:00 Asia/Shanghai

자산: BTC, ETH, SOL

출력: 야간 변동, 주요 가격대, 추세, 위험 플래그

전달: 채팅 및 설정된 메시징 채널

생성하시겠습니까? yes 또는 no로 답해 주세요.

3. 커스텀 모니터링 워크플로

프롬프트

Create a workflow that emails me if BTC moves 5% in a day or if NVDA gaps more than 4% at the open.

Agent 응답:

로컬 모니터링 워크플로를 구축합니다.

트리거 A: BTC 24h 변동 >= 5%

트리거 B: NVDA 시가 갭 >= 4%

채널: 이메일

실행 모드: 모니터링 전용, 거래 실행 없음

생성하시겠습니까? yes 또는 no로 답해 주세요.

4. 고빈도 관심 목록 스캔

프롬프트

Watch the top 20 tokens by 24h volume and alert me every 15 minutes if any move more than 5%.

Agent 응답:

로컬 모니터링 워크플로를 준비합니다.

일정: 15분마다

대상: 24h 거래량 기준 상위 20개 토큰

트리거: 절대 변동 > 5%

전달: 채팅 및 설정된 알림 채널

허용 도구: 읽기, 메모리, 메시징

생성하시겠습니까? yes 또는 no로 답해 주세요.

배포 전 로컬 워크플로 테스트

로컬 워크플로의 경우, Minara는 운영 배포 전에 테스트 실행을 수행할 수 있습니다.

workflow_test는 수동 테스트 실행을 생성하고, 샘플 입력 또는 자동 생성된 트리거 페이로드로 DAG 전체를 실행합니다.
메시징 단계는 실제로 발송됩니다. 텔레그램, Slack, 이메일에 실제로 알림이 도착하는지 확인할 수 있습니다. 페이로드 형식뿐 아니라 채널 자체가 정상 작동하는지 검증합니다.
자금 이동 도구 및 기타 파괴적 도구는 여전히 시뮬레이션됩니다. 미리 보기 구조에는 실제로 어떤 일이 일어났을지 기록되며, 실제 디스패치는 이루어지지 않습니다.
아직 연결되지 않은 플랫폼을 대상으로 워크플로를 지정하면, 테스트는 사전에 거부되며 누락된 제공자를 안내합니다. REPL에서 /connect <platform>, 웹 UI에서 Settings → Messaging으로 연결한 후 다시 실행하세요.
운영 일정 및 definition.active 상태는 변경되지 않습니다. 테스트는 원하는 만큼 반복 실행해도 안전합니다.

이를 통해 워크플로가 실제로 가동되기 전에, 수신자가 보게 될 내용을 종단간으로 검증할 수 있습니다.

일회성 알림

"X가 발생하면 알려줘"와 같은 알림은 한 번만 발송된 후 자동으로 중지되어야 합니다. GOOGL이 $340을 돌파한 후 한 달 동안 15분마다 텔레그램 메시지를 받고 싶지는 않을 것입니다. send_message와 deactivate 단계를 함께 사용하세요.

{
  "entry": "fetch_quote",
  "trigger": { "type": "interval", "interval_ms": 900000 },
  "steps": {
    "fetch_quote": {
      "kind": "tool_call",
      "tool": "yahoo_finance_stock",
      "args": { "kind": "quote", "symbol": "GOOGL" },
      "next": "check"
    },
    "check": {
      "kind": "condition",
      "condition": "fetch_quote.price <= 340",
      "next": { "on_success": "alert", "on_failure": null }
    },
    "alert": {
      "kind": "send_message",
      "provider": "telegram",
      "text": "GOOGL hit $340",
      "next": "stop"
    },
    "stop": { "kind": "deactivate" }
  }
}

가격 조건이 처음으로 충족되면 send_message가 알림을 전달하고, deactivate가 워크플로의 active = false로 전환합니다. 트리거 매니저가 비활성 플래그를 인식하므로 다음 인터벌 틱은 건너뛰어, 알림은 정확히 한 번만 발송됩니다.

재활성화하려면, 웹 UI의 Schedule on 버튼, REPL의 /workflows activate <id> 명령, 또는 채팅에서 Agent에게 직접 요청하세요 ("GOOGL 알림 다시 활성화해줘").

자금을 이동하는 일정 켜기

스왑, 매수, 매도, 자금 이동 등의 단계를 포함하는 워크플로의 일정을 켜면, Minara는 실행할 때마다 "확인하시겠습니까?"라고 묻지 않습니다. 일정의 목적이 바로 그것이기 때문입니다. 자동으로 실행됩니다.

주의: 자금 이동 워크플로에서 Schedule on을 클릭하는 것은 이후 모든 실행에 대한 일괄 동의입니다. 일정을 켜기 전에, 웹 UI는 자금을 이동하는 단계, 워크플로 실행 빈도를 정확히 표시하고, "이해합니다"를 체크해야 진행할 수 있습니다. 취소하면 일회성 지금 실행 모드로 돌아가며, 각 실행마다 거래 확인이 요청됩니다.

안전 검사가 내부적으로 어떻게 동작하는지 알고 싶다면 자금 이동 확인을 참조하세요.

워크플로와 다른 기능의 구분

알림, 예약 요약, 모니터링에는 워크플로를 사용하세요.
한도, 킬 조건, 지속적인 전략 검토를 갖춘 자동 퀀트 거래 전략에는 Autopilot을 사용하세요.
미리 보기와 확인을 포함하는 일회성 대화형 거래에는 첫 거래를 사용하세요.

다음 단계

로컬 워크플로의 실행 방식을 이해하고 싶다면 기능 → 워크플로를 참조하세요.
알림을 설정하고 싶다면 메시징을 참조하세요.
자율 전략 실행을 원한다면 Autopilot을 참조하세요.

목차