Skip to content

Commit 9212be3

Browse files
bsmthbsmth
authored
feat(docs): Add AIControls policy (#103)
* feat(docs): Add AIControls policy * Apply suggestion from @bsmth
1 parent de2e8d6 commit 9212be3

2 files changed

Lines changed: 153 additions & 2 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,13 @@
1616

1717
- `SitePolicies`: Defines policies scoped to specific sites. ([#82](https://github.com/mozilla/enterprise-admin-reference/pull/82))
1818

19-
### ent-150.0.0
19+
### ent-149.0.0
2020

2121
#### Added
2222

23-
- `Sync` policy [#70](https://github.com/mozilla/enterprise-admin-reference/pull/70)
23+
- `AIControls` policy: Configure AI controls. [#103](https://github.com/mozilla/enterprise-admin-reference/pull/103)
2424
- `CrashReportsSubmit` policy: Configure crash report submission settings. [#86](https://github.com/mozilla/enterprise-admin-reference/pull/86)
25+
- `Sync` policy [#70](https://github.com/mozilla/enterprise-admin-reference/pull/70)
2526

2627
## fx-150.0.0
2728

‎src/content/docs/reference/policies/AIControls.mdx‎

Lines changed: 150 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,150 @@
1+
---
2+
title: "AIControls"
3+
description: "Configure AI controls."
4+
category: "Miscellaneous"
5+
---
6+
7+
Configure AI controls.
8+
For more information, see [Block generative AI features with Firefox AI controls](https://support.mozilla.org/en-US/kb/firefox-ai-controls) on support.mozilla.org.
9+
10+
**Compatibility:** Firefox Enterprise 149.0.0\
11+
**CCK2 Equivalent:** N/A\
12+
**Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.chat.page`, `browser.ai.control.sidebarChatbot`, `browser.translations.enable`, `browser.ai.control.translations`, `pdfjs.enableAltText`, `browser.ai.control.pdfjsAltText`, `browser.ml.linkPreview.enabled`, `browser.ai.control.linkPreviewKeyPoints`, `browser.tabs.groups.smart.userEnabled`, `browser.ai.control.smartTabGroups`, `browser.ai.control.smartWindow`
13+
14+
## Values
15+
16+
Each key controls the availability of a specific AI feature.
17+
The following AI feature keys are available:
18+
19+
- `Default`: Controls the default state for AI features listed below, unless they are explicitly configured in the policy.
20+
- `Translations`: Controls AI-powered page translations.
21+
- `PDFAltText`: Controls AI-generated alt text for images in PDF documents.
22+
- `SmartTabGroups`: Controls AI-powered tab grouping suggestions.
23+
- `LinkPreviewKeyPoints`: Controls AI-generated key point summaries shown in link previews.
24+
- `SidebarChatbot`: Controls the AI chatbot panel in the Firefox sidebar.
25+
- `SmartWindow`: Controls AI-powered window arrangement features.
26+
27+
All keys accept the following sub-keys:
28+
29+
- `Value`:
30+
- `available` makes the feature accessible to users and it can be enabled or disabled.
31+
- `blocked` the feature is disabled and users won't see the feature.
32+
For on-device AI, any models already downloaded are removed.
33+
- `Locked`: if `true`, the user cannot change the setting.
34+
35+
## Windows (GPO)
36+
37+
```
38+
Software\Policies\Mozilla\Firefox\AIControls\Default\Value = "available" | "blocked"
39+
Software\Policies\Mozilla\Firefox\AIControls\Default\Locked = 0x1 | 0x0
40+
Software\Policies\Mozilla\Firefox\AIControls\Translations\Value = "available" | "blocked"
41+
Software\Policies\Mozilla\Firefox\AIControls\Translations\Locked = 0x1 | 0x0
42+
Software\Policies\Mozilla\Firefox\AIControls\PDFAltText\Value = "available" | "blocked"
43+
Software\Policies\Mozilla\Firefox\AIControls\PDFAltText\Locked = 0x1 | 0x0
44+
Software\Policies\Mozilla\Firefox\AIControls\SmartTabGroups\Value = "available" | "blocked"
45+
Software\Policies\Mozilla\Firefox\AIControls\SmartTabGroups\Locked = 0x1 | 0x0
46+
Software\Policies\Mozilla\Firefox\AIControls\LinkPreviewKeyPoints\Value = "available" | "blocked"
47+
Software\Policies\Mozilla\Firefox\AIControls\LinkPreviewKeyPoints\Locked = 0x1 | 0x0
48+
Software\Policies\Mozilla\Firefox\AIControls\SidebarChatbot\Value = "available" | "blocked"
49+
Software\Policies\Mozilla\Firefox\AIControls\SidebarChatbot\Locked = 0x1 | 0x0
50+
Software\Policies\Mozilla\Firefox\AIControls\SmartWindow\Value = "available" | "blocked"
51+
Software\Policies\Mozilla\Firefox\AIControls\SmartWindow\Locked = 0x1 | 0x0
52+
```
53+
54+
## macOS
55+
56+
```xml
57+
<dict>
58+
<key>AIControls</key>
59+
<dict>
60+
<key>Default</key>
61+
<dict>
62+
<key>Value</key>
63+
<string>available | blocked</string>
64+
<key>Locked</key>
65+
<true/> | <false/>
66+
</dict>
67+
<key>Translations</key>
68+
<dict>
69+
<key>Value</key>
70+
<string>available | blocked</string>
71+
<key>Locked</key>
72+
<true/> | <false/>
73+
</dict>
74+
<key>PDFAltText</key>
75+
<dict>
76+
<key>Value</key>
77+
<string>available | blocked</string>
78+
<key>Locked</key>
79+
<true/> | <false/>
80+
</dict>
81+
<key>SmartTabGroups</key>
82+
<dict>
83+
<key>Value</key>
84+
<string>available | blocked</string>
85+
<key>Locked</key>
86+
<true/> | <false/>
87+
</dict>
88+
<key>LinkPreviewKeyPoints</key>
89+
<dict>
90+
<key>Value</key>
91+
<string>available | blocked</string>
92+
<key>Locked</key>
93+
<true/> | <false/>
94+
</dict>
95+
<key>SidebarChatbot</key>
96+
<dict>
97+
<key>Value</key>
98+
<string>available | blocked</string>
99+
<key>Locked</key>
100+
<true/> | <false/>
101+
</dict>
102+
<key>SmartWindow</key>
103+
<dict>
104+
<key>Value</key>
105+
<string>available | blocked</string>
106+
<key>Locked</key>
107+
<true/> | <false/>
108+
</dict>
109+
</dict>
110+
</dict>
111+
```
112+
113+
## policies.json
114+
115+
```json
116+
{
117+
"policies": {
118+
"AIControls": {
119+
"Default": {
120+
"Value": "available" | "blocked",
121+
"Locked": true | false
122+
},
123+
"Translations": {
124+
"Value": "available" | "blocked",
125+
"Locked": true | false
126+
},
127+
"PDFAltText": {
128+
"Value": "available" | "blocked",
129+
"Locked": true | false
130+
},
131+
"SmartTabGroups": {
132+
"Value": "available" | "blocked",
133+
"Locked": true | false
134+
},
135+
"LinkPreviewKeyPoints": {
136+
"Value": "available" | "blocked",
137+
"Locked": true | false
138+
},
139+
"SidebarChatbot": {
140+
"Value": "available" | "blocked",
141+
"Locked": true | false
142+
},
143+
"SmartWindow": {
144+
"Value": "available" | "blocked",
145+
"Locked": true | false
146+
}
147+
}
148+
}
149+
}
150+
```

0 commit comments

Comments
 (0)