Fixes #1086 - Add AI provider toggle to provider configuration

Author: ralf401

ai/provider.rst

@@ -2,10 +2,11 @@ Provider
 ========
 
 Zammad offers AI-powered features to support your agents!
-To use AI features in Zammad, you have to configure an AI provider which handles
-the requests first. Add your provider in Zammad's admin settings under
-*AI > Provider*. To access this page, the ``admin.ai_provider`` permission is
-required.
+To use AI features in Zammad, you must first configure and enable an AI
+provider. Such an AI provider processes all your AI requests and is required for
+any AI functionality. Add your provider in Zammad's admin settings
+under *AI > Provider* and make sure to activate the toggle. This setting
+requires ``admin.ai_provider`` permission to access it.
 
 .. note:: Zammad's AI feature is completely optional and requires a
    configuration before any AI request is made. However, if you don't want to

images/ai/ai-provider.png

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Zammad Admin Documentation pre-release\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-03-13 12:59+0100\n"
+"POT-Creation-Date: 2026-03-17 10:13+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -134,19 +134,19 @@ msgid "This AI agent is capable of rephrasing the ticket title based on the cont
 msgstr ""
 
 #: ../ai/provider.rst:2
-#: ../ai/provider.rst:39
+#: ../ai/provider.rst:40
 msgid "Provider"
 msgstr ""
 
 #: ../ai/provider.rst:4
-msgid "Zammad offers AI-powered features to support your agents! To use AI features in Zammad, you have to configure an AI provider which handles the requests first. Add your provider in Zammad's admin settings under *AI > Provider*. To access this page, the ``admin.ai_provider`` permission is required."
+msgid "Zammad offers AI-powered features to support your agents! To use AI features in Zammad, you must first configure and enable an AI provider. Such an AI provider processes all your AI requests and is required for any AI functionality. Add your provider in Zammad's admin settings under *AI > Provider* and make sure to activate the toggle. This setting requires ``admin.ai_provider`` permission to access it."
 msgstr ""
 
-#: ../ai/provider.rst:10
+#: ../ai/provider.rst:11
 msgid "Zammad's AI feature is completely optional and requires a configuration before any AI request is made. However, if you don't want to see the settings at all, read about :docs:`how to hide it in the system docs </admin/console/other-useful-commands.html#remove-ai-feature>`."
 msgstr ""
 
-#: ../ai/provider.rst:16
+#: ../ai/provider.rst:17
 #: ../channels/email/settings.rst:2
 #: ../channels/form.rst:28
 #: ../channels/email/settings.rst:2
@@ -163,187 +163,187 @@ msgstr ""
 msgid "Screenshot shows configuration of AI provider in Zammad"
 msgstr ""
 
-#: ../ai/provider.rst:23
+#: ../ai/provider.rst:24
 msgid "You can choose from different supported providers:"
 msgstr ""
 
-#: ../ai/provider.rst:25
-#: ../ai/provider.rst:87
+#: ../ai/provider.rst:26
+#: ../ai/provider.rst:88
 msgid "Zammad AI"
 msgstr ""
 
-#: ../ai/provider.rst:26
+#: ../ai/provider.rst:27
 msgid "OpenAI"
 msgstr ""
 
-#: ../ai/provider.rst:27
-#: ../ai/provider.rst:117
+#: ../ai/provider.rst:28
+#: ../ai/provider.rst:118
 msgid "Ollama"
 msgstr ""
 
-#: ../ai/provider.rst:28
+#: ../ai/provider.rst:29
 msgid "Anthropic"
 msgstr ""
 
-#: ../ai/provider.rst:29
+#: ../ai/provider.rst:30
 msgid "Azure AI"
 msgstr ""
 
-#: ../ai/provider.rst:30
+#: ../ai/provider.rst:31
 msgid "Mistral AI"
 msgstr ""
 
-#: ../ai/provider.rst:31
+#: ../ai/provider.rst:32
 msgid "Custom (OpenAI Compatible)"
 msgstr ""
 
-#: ../ai/provider.rst:33
+#: ../ai/provider.rst:34
 msgid "Depending on which provider you choose, Zammad displays different fields you can configure."
 msgstr ""
 
-#: ../ai/provider.rst:36
+#: ../ai/provider.rst:37
 msgid "The AI service you have subscribed to is not available? This is just the first step. We are going to add more providers soon! If you want to support us or need the provider as soon as possible, just let our `sales department <https://zammad.com/en/company/contact>`_ know!"
 msgstr ""
 
-#: ../ai/provider.rst:44
+#: ../ai/provider.rst:45
 msgid "Token"
 msgstr ""
 
-#: ../ai/provider.rst:42
+#: ../ai/provider.rst:43
 msgid "Add your API token which you got from your provider here. Don't confuse it with the tokens a large language model (LLM) is dealing with when processing a request."
 msgstr ""
 
-#: ../ai/provider.rst:48
+#: ../ai/provider.rst:49
 #: ../manage/knowledge-base.rst:151
 #: ../system/integrations/elasticsearch.rst:57
 msgid "URL"
 msgstr ""
 
-#: ../ai/provider.rst:47
+#: ../ai/provider.rst:48
 msgid "Provide the URL or IP address of your provider. This is required for Ollama and OpenAI compatible providers."
 msgstr ""
 
-#: ../ai/provider.rst:52
+#: ../ai/provider.rst:53
 msgid "URL (Completions)"
 msgstr ""
 
-#: ../ai/provider.rst:51
+#: ../ai/provider.rst:52
 msgid "Only for Azure AI as provider. Add the endpoint where your text generation model is available."
 msgstr ""
 
-#: ../ai/provider.rst:57
+#: ../ai/provider.rst:58
 msgid "Model"
 msgstr ""
 
-#: ../ai/provider.rst:55
+#: ../ai/provider.rst:56
 msgid "Enter the exact name of the model here. This model has to be available on your provider's side. Leave it empty (if not mandatory) to use the default which is shown as a placeholder."
 msgstr ""
 
-#: ../ai/provider.rst:65
+#: ../ai/provider.rst:66
 msgid "Recognize Image Text (OCR)"
 msgstr ""
 
-#: ../ai/provider.rst:60
+#: ../ai/provider.rst:61
 msgid "Zammad allows you to use optical character recognition (OCR) to extract text from images. This can be useful if you often get error messages or other important information, which is only present in images."
 msgstr ""
 
-#: ../ai/provider.rst:64
+#: ../ai/provider.rst:65
 msgid "Simply switch the toggle on or off. Be aware that using this feature can cause a high consumption of tokens."
 msgstr ""
 
-#: ../ai/provider.rst:72
+#: ../ai/provider.rst:73
 msgid "OCR Model"
 msgstr ""
 
-#: ../ai/provider.rst:68
+#: ../ai/provider.rst:69
 msgid "Specify a model to use for the OCR feature. Leave it empty to use the default model of your provider."
 msgstr ""
 
-#: ../ai/provider.rst:71
+#: ../ai/provider.rst:72
 msgid "Note: the field is called **URL (OCR)** for Azure AI and expects a URL where the OCR model is available instead of a model itself."
 msgstr ""
 
-#: ../ai/provider.rst:74
+#: ../ai/provider.rst:75
 msgid "After providing the information, make sure to click the ``Save`` button and activate AI features."
 msgstr ""
 
-#: ../ai/provider.rst:78
+#: ../ai/provider.rst:79
 msgid "Excursion"
 msgstr ""
 
-#: ../ai/provider.rst:80
+#: ../ai/provider.rst:81
 msgid "In case you want to know more about Zammad AI or Ollama, read on here. Otherwise, head over to :ref:`feedback-logs` or check out the AI-powered features and how to use them."
 msgstr ""
 
-#: ../ai/provider.rst:89
+#: ../ai/provider.rst:90
 msgid "Using Zammad AI as a provider is the easiest way you can get started with Zammad's AI features. It has some big advantages like:"
 msgstr ""
 
-#: ../ai/provider.rst:92
+#: ../ai/provider.rst:93
 msgid "You don't have to take care of the setup of an AI system and its configuration."
 msgstr ""
 
-#: ../ai/provider.rst:94
+#: ../ai/provider.rst:95
 msgid "Hosted in the EU and compliant with GDPR."
 msgstr ""
 
-#: ../ai/provider.rst:95
+#: ../ai/provider.rst:96
 msgid "No configuration in Zammad needed (for SaaS customers) or only an API key required (for self-hosted customers)."
 msgstr ""
 
-#: ../ai/provider.rst:97
+#: ../ai/provider.rst:98
 msgid "Your requests with sensitive information aren't used for training."
 msgstr ""
 
-#: ../ai/provider.rst:98
+#: ../ai/provider.rst:99
 msgid "If something isn't working as expected, you just have one place where you get support."
 msgstr ""
 
-#: ../ai/provider.rst:108
+#: ../ai/provider.rst:109
 msgid "SaaS Customers"
 msgstr ""
 
-#: ../ai/provider.rst:102
+#: ../ai/provider.rst:103
 msgid "Using Zammad AI requires a \"V2\" plan. Check your :doc:`subscription settings </system/subscription>` and consider to switch your plan. If a \"V2\" plan is active, you can buy AI calls for AI processing. After doing so, Zammad AI is automatically configured as AI provider and you can activate and configure AI features as you like. Check your remaining AI calls from time to time or activate the notification to be alerted when few calls remain."
 msgstr ""
 
-#: ../ai/provider.rst:114
+#: ../ai/provider.rst:115
 msgid "Self-Hosted Customers"
 msgstr ""
 
-#: ../ai/provider.rst:111
+#: ../ai/provider.rst:112
 msgid "Please `get in touch with our sales department <https://zammad.com/en/company/contact>`_ to obtain a Zammad AI API key and to buy AI calls. After receiving your API key, simply add and save it. Then you are ready to activate and configure AI features as you like."
 msgstr ""
 
-#: ../ai/provider.rst:119
+#: ../ai/provider.rst:120
 msgid "`Ollama <https://ollama.com/>`_ is an AI tool that allows you to set up your own AI server on a machine you control. That means your data is not transferred to a third party. Be aware that this only makes sense if you have a powerful GPU in your system!"
 msgstr ""
 
-#: ../ai/provider.rst:124
+#: ../ai/provider.rst:125
 msgid "If you don't have an Ollama running already, their `documentation <https://docs.ollama.com/>`_ is a good starting point. You can find the available models in `Ollama's model library <https://ollama.com/library>`_ and useful information and additional links in the `Ollama Github repository <https://github.com/ollama/ollama>`_."
 msgstr ""
 
-#: ../ai/provider.rst:134
+#: ../ai/provider.rst:135
 msgid "Feedback & Logs"
 msgstr ""
 
-#: ../ai/provider.rst:136
+#: ../ai/provider.rst:137
 msgid "At the top of the settings page, you can switch to the **Feedback & Logs** tab."
 msgstr ""
 
 #: ../ai/provider.rst:None
 msgid "Screenshot shows AI provider settings with activated \"Feedback & Logs\" tab"
 msgstr ""
 
-#: ../ai/provider.rst:144
+#: ../ai/provider.rst:145
 msgid "Downloads"
 msgstr ""
 
-#: ../ai/provider.rst:146
+#: ../ai/provider.rst:147
 msgid "Your agents can provide feedback like thumbs up or down and leave a comment in case they gave thumbs down. You can download this feedback as well as error logs. Both downloads provide an Excel file (.xlsx) with the requested information."
 msgstr ""
 
-#: ../ai/provider.rst:152
+#: ../ai/provider.rst:153
 #: ../system/integrations/checkmk/admin-panel-reference.rst:35
 #: ../system/integrations/cti/includes/recent-logs.include.rst:2
 #: ../system/integrations/cti/includes/recent-logs.include.rst:2
@@ -354,7 +354,7 @@ msgstr ""
 msgid "Recent Logs"
 msgstr ""
 
-#: ../ai/provider.rst:154
+#: ../ai/provider.rst:155
 msgid "Zammad shows the last requests and responses in the UI as well. So in case something isn't working, have a look there. When you open an entry, you can find the request as well as the response from your AI provider."
 msgstr ""