nora actions

Action 이 Agent 결정 후 발화. Tool (Agent 가 실행 중 선택) 과 달리 Action 은 와이어링 기반 실행: Flow 가 발화 여부 결정, Agent 출력이 무엇 전달할지 결정. Tool 과 같은 명령 모양, 파라미터 제외 (Action 은 LLM 선택 인자 없음).

명령

명령	설명
`actions create --name <n>`	Action 블록 추가.
`actions update <action-id>`	필드 패치.
`actions edit <action-id>`	`$EDITOR` 에 열기.
`actions delete <action-id>`	Action 제거.
`actions headers list <action-id>`	HTTP 헤더 인쇄.
`actions headers add <action-id>`	헤더 추가.
`actions headers remove <action-id>`	헤더 제거.

`actions create`

nora actions create \
  --name notify_slack \
  --description "Agent 요약을 Slack 메시지로 게시" \
  --runtime '{"kind":"http","method":"POST","url":"https://hooks.slack.com/services/xxx"}'

플래그:

--name <n> (필수).
--description <d>.
--runtime <json> — HTTP 나 인라인 런타임 스펙 (Tool 과 같은 모양).
--x <n>, --y <n> — 캔버스 위치.

`actions update`

nora actions update ac_notify \
  --set-approval on \
  --set-http-url https://hooks.slack.com/services/new-url

Update 플래그

정체성

--set-name <n>
--set-description <d>
--set-icon <name>

승인

--set-approval on|off — 발화 전 승인 요구.

HTTP 런타임

--set-runtime-kind http|inline
--set-http-method <m>
--set-http-url <url>
--set-http-auth-kind <k>
--set-http-auth-header <name>
--set-http-auth-value <v>

Inline 런타임

--set-inline-lang <lang>
--set-inline-code <text> / --set-inline-code-file <path>

위치/크기

--set-x <n>, --set-y <n>, --set-width <n>

벌크

--patch <json>

`actions edit`

nora actions edit ac_notify

`actions delete`

nora actions delete ac_notify

Action 제거; 와이어 가지치기.

`actions headers`

Tool 과 같은 모양:

nora actions headers list ac_notify
nora actions headers add ac_notify --name Authorization --value 'secrets://slack_bot_token'
nora actions headers remove ac_notify --name X-Old-Header

시크릿 값은 secrets://<ref> 로. 인터랙티브는 --value ?. 파이핑·시크릿 참고.

Tool vs. Action — 빠른 상기

	Tool	Action
호출 시점 결정	Agent (LLM 통해)	Flow (와이어링 통해)
인자 선택	Agent	Agent 출력에서 매핑
추론 중 실행	예	후
Agent 의 다음 스텝에 영향	예	아니오

법칙: Agent 가 결과로 더 추론해야 할 수 있으면 Tool. 답변 후 fire-and-forget 이면 Action.

레시피

승인 게이트 있는 Slack 알림 추가

AC=$(nora actions create \
  --name notify_slack \
  --description "Slack 요약 게시" \
  --runtime '{"kind":"http","method":"POST","url":"'$SLACK_WEBHOOK'"}' \
  | jq -r '.id')

nora actions update $AC --set-approval on

이제 모든 Slack 게시가 승인 기다림.

헤더 로테이션 마이그레이션

new_token='secrets://slack_bot_token_v2'
for id in $(nora flows get support | jq -r '.blocks[] | select(.kind=="action").id'); do
  nora actions headers remove $id --name Authorization 2>/dev/null
  nora actions headers add $id --name Authorization --value "$new_token"
done

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

nora actions

명령

`actions create`

`actions update`

Update 플래그

`actions edit`

`actions delete`

`actions headers`

Tool vs. Action — 빠른 상기

레시피

승인 게이트 있는 Slack 알림 추가

헤더 로테이션 마이그레이션

​명령

​actions create

​actions update

​Update 플래그

​actions edit

​actions delete

​actions headers

​Tool vs. Action — 빠른 상기

​레시피

​승인 게이트 있는 Slack 알림 추가

​헤더 로테이션 마이그레이션

명령

`actions create`

`actions update`

Update 플래그

`actions edit`

`actions delete`

`actions headers`

Tool vs. Action — 빠른 상기

레시피

승인 게이트 있는 Slack 알림 추가

헤더 로테이션 마이그레이션