# [Experiment](https://docs.gitlab.com/ee/policy/alpha-beta-support.html#experiment) _This section should be completed prior to beginning work on the Experiment._ ## Problem to be solved ### User problem _What user problem will this solve?_ ### Solution hypothesis _Why do you believe this AI solution is a good way to solve this problem?_ ### Assumption _What assumptions are you making about this problem and the solution?_ ### Personas _What [personas](https://handbook.gitlab.com/handbook/product/personas/#list-of-user-personas) have this problem, who is the intended user?_ ## Proposal ### Success _How will you measure whether this experiment is a success?_ **UX maturity requirements** _[Experiment to Beta](https://about.gitlab.com/handbook/product/ai/ux-maturity/#criteria-and-requirements)_ | Criteria | Minimum Requirement | Assessment for Beta | | -------- | ------------------- | ------------------- | | [Problem validation](https://about.gitlab.com/handbook/product/ai/ux-maturity/#validation-problem-validation)
How well do we understand the problem? | [Mix of evidence and assumptions](https://about.gitlab.com/handbook/product/ai/ux-maturity/#questions-to-ask) | | | [Solution validation](https://about.gitlab.com/handbook/product/ai/ux-maturity/#validation-solution-validation)
How usable is the solution? | [Usability testing](https://about.gitlab.com/handbook/product/ux/ux-scorecards/#option-b-perform-a-formative-evaluation), Grade C | | | [Improve](https://about.gitlab.com/handbook/product/ai/ux-maturity/#build-improve)
How successful is the solution? | Quality goals set by the team are reached. | | | [Design standards](https://about.gitlab.com/handbook/product/ai/ux-maturity/#design-standards) adherence
How compliant is the solution with our design standards? | Should adhere to ([Pajamas](https://design.gitlab.com/), [checklist](https://docs.gitlab.com/ee/development/contributing/design.html#checklist)) | | # [Beta](https://docs.gitlab.com/ee/policy/alpha-beta-support.html#beta) _This section should be completed prior to beginning work on the Beta experience._ ### [Main Job story](https://about.gitlab.com/handbook/product/ux/jobs-to-be-done/#how-to-write-a-jtbd) _What job to be done will this solve?_ ##### [Small Jobs](https://about.gitlab.com/handbook/product/ux/jobs-to-be-done/#small-jobs) _What are the small jobs this feature is solving for?_ ### Assumption _What assumptions are you making about this problem and the solution?_ ### Proposal updates/additions ### Problem validation _What validation exists that customers have this problem?_ ### Business objective _What business objective will be achieved with this proposal?_ ### Requirements _What tasks or actions should the user be capable of performing with this feature?_ ### The user needs to be able to: - ... - ... #### Success _How will you measure whether this Beta is a success?_ **UX maturity requirements** _[Beta to GA](https://about.gitlab.com/handbook/product/ai/ux-maturity/#criteria-and-requirements)_ | Criteria | Minimum Requirement | Assessment for GA | | -------- | ------------------- | ------------------- | | [Problem validation](https://about.gitlab.com/handbook/product/ai/ux-maturity/#validation-problem-validation)
How well do we understand the problem? | [Mix of evidence and assumptions](https://about.gitlab.com/handbook/product/ai/ux-maturity/#questions-to-ask) | | | [Solution validation](https://about.gitlab.com/handbook/product/ai/ux-maturity/#validation-solution-validation)
How usable is the solution? | [Usability testing](https://about.gitlab.com/handbook/product/ux/ux-scorecards/#option-b-perform-a-formative-evaluation) and [Heuristic evaluation](https://about.gitlab.com/handbook/product/ux/ux-scorecards/#option-a-conduct-a-heuristic-evaluation), Avg. task pass rate >80%, Grade B | | | [Improve](https://about.gitlab.com/handbook/product/ai/ux-maturity/#build-improve)
How successful is the solution? | Quality goals set by the team are reached. | | | [Design standards](https://about.gitlab.com/handbook/product/ai/ux-maturity/#design-standards) adherence
How compliant is the solution with our design standards? | Should adhere to ([Pajamas](https://design.gitlab.com/), [checklist](https://docs.gitlab.com/ee/development/contributing/design.html#checklist)) | | # [Generally Available](https://docs.gitlab.com/ee/policy/alpha-beta-support.html#generally-available-ga) ### Assumption _What assumptions are you making about this problem and the solution?_ ### Proposal updates/additions ### Problem validation _What validation exists that customers have this problem?_ ### Requirements _What tasks or actions should the user be capable of performing with this feature?_ > ⚠️ Related feature and research issues should be linked in the related issues section (Delete this line when this is done) #### The user needs to be able to: - ... - ... ## Checklist ### Experiment
Issue information - [ ] Add information to the issue body about: - [ ] The user problem being solved - [ ] Why the solution hypothesis solves this problem - [ ] Your assumptions have been defined - [ ] Who it's for, list of personas impacted - [ ] Your proposal has been defined - [ ] Your success metrics have been defined - [ ] UX maturity requirements have been measured - [ ] Add relevant designs to the Design Management area of the issue if available - [ ] Confirm that an unexpected outage of this feature will not negatively impact the application or other features - [ ] Add a feature flag so that this feature can be quickly disabled if/when needed - [ ] If this experiment introduces a new service or data store, ensure it is not processing or storing [red data](https://about.gitlab.com/handbook/security/data-classification-standard.html#data-classification-levels) without a security and if needed legal review - *NOTE*: We recommend using one of the already adopted models or data stores. If you need to use something else, be aware that using other models or data stores will require additional review during the feature stage for operational fitness and compliance. - [ ] Completed the necessary steps to move from Experiment to Beta - [ ] Ensure this issue has the ~wg-ai-integration label to ensure visibility to various teams working on this
### Beta
Issue information - [ ] Add information to the issue body about: - [ ] The Main Job story and Small Jobs it's expected to satisfy have been stated - [ ] Your assumptions have been defined - [ ] Proposal has been updated as necessary - [ ] Problem validation inforamtion has been added - [ ] Business objective has been defined - [ ] Requirements have been defined - [ ] Success metrics have been defined - [ ] UX maturity requirements have been measured - [ ] Add all related feature issues to the Linked items section - [ ] Add all relevant solution validation issues to the Linked items section that shows this proposal will solve the customer problem, or details explaining why it's not possible to provide that validation. - [ ] Add relevant designs to the Design Management area of the issue. - [ ] You have adhered to our [Definition of Done](https://docs.gitlab.com/ee/development/contributing/merge_request_workflow.html#definition-of-done) standards - [ ] Completed the necessary steps to move from Beta to GA
#### Generally available
Issue information - [ ] Add information to the issue body about: - [ ] Your assumptions have been defined - [ ] Your proposal has been defined - [ ] Problem validation inforamtion has been added - [ ] Business objective has been defined - [ ] Confidence about this feature has been assessed and defined - [ ] Requirements have been defined - [ ] Add all relevant solution validation issues to the Linked items section that shows this proposal will solve the customer problem, or details explaining why it's not possible to provide that validation. - [ ] Add relevant designs to the Design Management area of the issue. - [ ] You have adhered to our [Definition of Done](https://docs.gitlab.com/ee/development/contributing/merge_request_workflow.html#definition-of-done) standards - [ ] Ensure this issue has the ~wg-ai-integration label to ensure visibility to various teams working on this
Technical needs - [ ] Please consider the operational aspects of the feature you are creating. A list of things to think about is in: https://gitlab.com/gitlab-org/gitlab/-/issues/403859. We will be improving this process in the future: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/117637#note_1353253349. - [ ] @ mention your [AppSec Stable Counterpart](https://about.gitlab.com/handbook/product/categories/) and read the [AI secure coding guidelines](https://docs.gitlab.com/ee/development/secure_coding_guidelines.html#artificial-intelligence-ai-features) 1. Work estimate and skills needs to build an ML viable feature: To build any ML feature depending on the work, there are many personas that contribute including Data Scientist, NLP engineer, ML Engineer, MLOps Engineer, ML Infra engineers, Fullstack engineer to integrate the ML Services with Gitlab. Post-prototype we would assess the skills needed to build a production-grade ML feature for the prototype. 2. Data Limitation: We would like to upfront validate if we have viable data for the feature including whether we can use the DataOps pipeline of ModelOps or create a custom one. We would want to understand the training data, test data, and feedback data to dial up the accuracy and the limitations of the data. 3. Model Limitation: We would want to understand if we can use an open-source pre-trained model, tune and customize it or start a model from scratch as well. Further, we would assess based on the ModelOps model evaluation framework which would be the right model to use based on the use case. 4. Cost, Scalability, Reliability: We would want to estimate the cost of hosting, serving, inference of the model, and the full end-to-end infrastructure including monitoring and observability. 5. Legal and Ethical Framework: We would want to align with legal and ethical framework like any other ModelOps features to cover the nine principles of responsible ML and any legal support needed.
Dependency needs - [ ] Please consider the operational aspects of the service you are creating. A list of things to think about is in: https://gitlab.com/gitlab-org/gitlab/-/issues/403859. We will be improving this process in the future: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/117637#note_1353253349.
Legal needs - [ ] TBD
## Additional resources - If you'd like help with technical validation, or would like to discuss UX considerations for AI mention the AI Assisted group using `@gitlab-org/modelops/applied-ml`. - Read about our [AI Integration strategy](https://internal-handbook.gitlab.io/handbook/product/ai-strategy/ai-integration-effort/) - [AI-human interaction guidelines](https://design.gitlab.com/usability/ai-human-interaction) - [Highlighting feature versions guidelines](https://design.gitlab.com/usability/feature-management#highlighting-feature-versions) - [UX maturity requirements](https://about.gitlab.com/handbook/product/ai/ux-maturity/) - **Slack channels** - `#wg_ai_integration` - Slack channel for the working group and the high-level alignment on getting AI ready for Production (Development, Product, UX, Legal, etc.) But from the other channels feel free to reach out and post progress here - `#ai_integration_dev_lobby` - Channel for all implementation-related topics and discussions of actual AI features (e.g. explain the code) - `#ai_enablement_team` - Channel for the AI Enablement Team which is building the base for all features (experimentation API, Abstraction Layer, Embeddings, etc.) /label ~"AI Feature Proposal" ~"AI-Seeking community feedback" /cc @tmccaslin @hbenson @pedroms @jmandell /parent_epic &9997