커스텀 플로 YAML 스키마
GitLab Duo Agent Platform의 커스텀 플로에서 사용하는 YAML 스키마 구조와 제한된 필드를 설명합니다.
히스토리 GitLab 19.2에서 일반 공급 으로 변경되었습니다. 커스텀 플로는 flow registry v1 사양 구문을 사용합니다. v1 사양은 version , environment , components , prompts , routers , flow 등의 필드를 포함한 전체 YAML 구조를 정의합니다. GitLab은 커스텀 플로 정의를 AI 카탈로그 flow_v2.json 스키마에 대해 검증합니다. flow registry v1 사양의 필드 중 flow_v2.json 에 정의되지 않은 필드는 사용할 수 없습니다. 이러한 필드를 사용하면 GitLab은 해당 필드를 허용되지 않는 추가 속성으로 거부합니다. 지원되지 않는 필드 목록은 AgentComponent 필드 를 참고합니다. v1 사양의 일부 필드는 커스텀 플로에서 제한됩니다. 자세한 내용은 제한된 필드 를 참고합니다. YAML 구성에는 최대 크기도 있습니다. 자세한 내용은 구성 크기 제한 을 참고합니다. 이벤트 유형별 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 이벤트 # 히스토리 유형이 지정된 리소스 참조가 GitLab 19.6에서 ai_flow_trigger_typed_resource_goal 이라는 플래그와 함께 도입 되었습니다. 기본적으로 비활성화되어 있습니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다. 플로 서비스 계정이 이슈 또는 머지 리퀘스트의 담당자 또는 검토자로 추가되면 리소스 유형과 URL이 goal로 전달됩니다. Context: <resource_type>: <resour