커스텀 플로 YAML 스키마
GitLab Duo Agent Platform의 커스텀 플로에서 사용하는 YAML 스키마 구조와 제한된 필드를 설명합니다.
커스텀 플로 YAML 스키마 # - Tier: [Free](/19.1/subscriptions/gitlab_credits/#for-the-free-tier), Premium, Ultimate - Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated # Status: Beta 커스텀 플로는 flow registry v1 사양 구문을 사용합니다. v1 사양은 version , environment , components , prompts , routers , flow 등의 필드를 포함한 전체 YAML 구조를 정의합니다. v1 사양의 일부 필드는 커스텀 플로에서 제한됩니다. 자세한 내용은 제한된 필드 를 참조하세요. 트리거 유형별 goal 값 # 커스텀 플로를 설계할 때 goal 값은 플로를 시작하는 트리거 유형에 따라 달라집니다. 플로에는 여러 트리거 유형을 설정할 수 있으며, 각 트리거 유형은 context:goal 로 서로 다른 값을 전달합니다. 플로는 설정한 각 트리거 유형에 맞는 goal 형식을 처리해야 합니다. 트리거 유형에 대한 자세한 내용은 트리거 를 참조하세요. 컴포넌트는 inputs 필드를 통해 goal에 접근합니다: components: - name: "my_agent" type: AgentComponent prompt_id: "my_prompt" inputs: - from: "context:project_id" as: "project_id" - "context:goal" Mention 이벤트 # 사용자가 댓글에서 플로 서비스 계정을 멘션하면, 전체 댓글 텍스트와 리소스 컨텍스트가 goal로 전달됩니다. goal의 형식은 다음과 같습니다: Input: <comment_text> Context: {<resource_type> IID: <iid>} 예를 들어, 사용자가 이슈 #2 에 @ai-my-flow Can you work on this? 라고 작성하면 goal은 다음과 같습니다: Input: @ai-my-flow Can you work on this? Context: {Issue IID: 2} Assign 및 Assign reviewer 이벤트 # 플로 서비스 계정이 이슈 또는 머지 리퀘스트에 담당자로 지정되거나 리뷰어로 지정되면, 해당 리소스의 IID가 goal로 전달됩니다. 예를 들어, 플로 서비스 계정이 머지 리퀘스트 !10 의 리뷰어로 지정되면 context:goal 값은 10 이 됩니다. IID와 context:project_id 를 함께 사용하여 리소스를 읽을 수 있습니다: components: - name: "review_mr" type: AgentComponent prompt_id: "review_mr_prompt" inputs: - from: "context:project_id" as: "project_id" - from: "context:goal" as: "mr_iid" Pipeline 이벤트 # 파이프라인 이벤트가 플로를