Skip to content

Flow YAML Editor: Add templates and Duo-powered documentation assistance

Summary

Enhance the Flow YAML editor with two key features to improve the user experience:

  1. Template selection system - Allow users to choose from pre-built flow templates
  2. Duo-powered documentation assistant - Provide contextual help without requiring users to leave the editor

Proposed Features

1. Template Selection System

Similar to issue and MR templates, provide users with a list of flow templates to choose from when creating a new flow.

Benefits:

  • Faster onboarding for new users
  • Real-world examples for common use cases
  • Reduces the learning curve for flow creation

Potential Templates:

  • Basic MyAgent - Simple placeholder skeleton with detailed comments
  • IssueSummarizer - Multi-step flow that fetches, summarizes, and posts issue summaries
  • Additional templates as use cases emerge

2. Duo-Powered Documentation Assistant

Add a button in the YAML editor that opens Duo Chat with relevant context to help users build their flows.

How It Would Work:

  1. User clicks "Ask Duo about flows" button in the editor
  2. Opens Duo Chat in the side panel with pre-loaded context (current YAML, Flow Registry docs, examples)
  3. User can ask questions like "How do I add a variable?" or "What tools are available?"

Benefits:

  • Reduces context switching to external documentation
  • Provides personalized help based on current work
  • Makes documentation more accessible and interactive

Related Discussion

These ideas emerged from !211607:

Edited by 🤖 GitLab Bot 🤖