골든 커맨드로 액션 만들기

골든 커맨드를 적으면 구축 에이전트가 시스템 API를 살펴 액션을 만듭니다. 액션이 무엇으로 이루어져 있는지 — 단계, 인자 매핑, 보상, 정책 — 를 예제 액션으로 뜯어봅니다.

액션이란#

액션은 온톨로지의 클래스에 붙은 “할 수 있는 일”입니다. 예제의 Shipment 클래스에는 expediteShipment(긴급 출하 처리)가 붙어 있습니다. 액션은 다음을 담고 있습니다.

정의를 뜯어보기#

예제 액션의 정의입니다(설명을 줄였습니다).

class_name = "Shipment", action_name = "expediteShipment", key_property = "shipment_no"
parameters = {"reason": {"type": "string", "description": "긴급 처리 사유"}}   # 필수
steps = [
  {"name": "wms", "system": "sample-wms", "operation_id": "setShipmentPriority",
   "arg_mapping": {"path.shipment_no": "$this.shipment_no", "body.priority": "URGENT",
                   "body.reason": "$params.reason", "body.requestedBy": "$actor.sub"},
   "compensation": {"system": "sample-wms", "operation_id": "setShipmentPriority",
                    "arg_mapping": {"path.shipment_no": "$this.shipment_no",
                                    "body.priority": "$before.priority",
                                    "body.reason": "$cancel.reason"}}},
  {"name": "erp", "system": "sample-erp", "operation_id": "createExpediteRequest",
   "arg_mapping": {"body.poId": "$this.ref_po_no", "body.reason": "$params.reason"},
   "compensation": {"system": "sample-erp", "operation_id": "withdrawExpediteRequest",
                    "arg_mapping": {"path.request_id": "$steps.erp.response.id",
                                    "body.reason": "$cancel.reason"}}},
]
policy = [{"roles": ["scm_operator"], "when": "target.ship_status != 'DELIVERED'"}]
writeback_property = "priority"

인자 매핑 — 값은 어디서 오나#

arg_mapping의 왼쪽은 API 요청의 자리(path.…는 URL 경로, body.…는 본문), 오른쪽은 값의 출처입니다.

$before와 $steps가 보상을 가능하게 합니다. 우선순위를 되돌리려면 “원래 값이 무엇이었는지”를, 납기 독촉을 철회하려면 “어느 독촉을 보냈는지”를 알아야 하기 때문입니다. 지워 버리는 것이 아니라 원래 상태로 되돌리는 것이 보상입니다.

정책 — 누가, 무엇에#

정책은 규칙의 목록입니다. 규칙마다 역할(roles)과 조건(when)이 있고, 하나라도 맞으면 허용, 하나도 맞지 않으면 거부합니다(기본 거부). 조건은 CEL이라는 작은 표현식 언어로 씁니다.

정책은 대상마다 판정됩니다. 계획을 세우면 대상 하나하나에 허용/거부와 사유가 붙습니다(16장). 그리고 실행 직전에 한 번 더 판정합니다 — 계획 뒤에 데이터가 바뀌었을 수 있으니까요.

따라 하기 — 골든 커맨드로 액션 만들기#

예제에는 액션이 이미 세 개 있습니다. 시연에서는 그중 「발주 보류」를 지운 뒤, 골든 커맨드로 에이전트가 다시 만들게 했습니다. 여러분은 새 골든 커맨드로 따라 해 봅시다.

1. 「온톨로지 구축」을 열고 소스에서 시스템 sample-erp를 고릅니다. 문서도 데이터베이스도 아닌, 시스템의 API가 이번 구축의 재료입니다.
2. 대상에서 기존 스키마 「공급망 운영 (예제)」를 고릅니다(추가 인제스천). 개념은 이미 있으니, 할 수 있는 일만 더합니다.
3. 의도의 Golden Command에 새 지시를 적습니다. 예: 한빛정밀의 미결 발주를 모두 보류해 줘 (사유: 단가 재협상)
4. 「이 브리프로 구축 시작」.

에이전트는 등록된 시스템의 API를 살핍니다. 발주를 보류하는 API와 보류를 푸는 API가 있다는 것을 찾아, 보류를 단계로, 해제를 보상으로 묶고, 정책을 붙입니다(시연 실측 약 4분 반).

끝으로 실제로 실행하지 않고 계획만 세워 보는 드라이런으로 골든 커맨드를 검증합니다. 대상이 몇 건이고, 정책을 통과했는지, 승인이 필요한지가 보고서에 남습니다.

어떤 액션이 있는지 확인하기#

질의·액션 탭에서 이렇게 물어보면 됩니다.

어떤 액션을 쓸 수 있어?

에이전트가 지금 쓸 수 있는 액션(여러분의 역할로 허용된 것만)과 각 액션의 대상·입력·단계를 알려 줍니다.