desktop: add ask gordon page

Signed-off-by: David Karlsson <[email protected]>

Author: dvdksn

content/manuals/desktop/features/gordon.md

@@ -0,0 +1,274 @@
+---
+title: Ask Gordon
+description: Learn how to streamline your workflow with Docker's AI-powered assistant.
+weight: 10
+params:
+  sidebar:
+    badge:
+      color: blue
+      text: Beta
+---
+
+{{% restricted title=Beta %}}
+Ask Gordon is a Beta feature. Features, user interface, and behavior are
+subject to change in future releases.
+{{% /restricted %}}
+
+Ask Gordon is your personal AI assistant embedded in Docker Desktop and the
+Docker CLI. It's designed to streamline your workflow and help you make the
+most of the Docker ecosystem.
+
+### What is Ask Gordon?
+
+Ask Gordon is a suite of AI-powered capabilities integrated into Docker's
+tools. These features, currently in Beta, are not enabled by default, and are
+not production-ready. You may also encounter the term "Docker AI" as a broader
+reference to this technology.
+
+The goal of Ask Gordon is to make Docker's tools for managing images and
+containers more intuitive and accessible. It provides contextual assistance
+tailored to your local environment, including Dockerfiles, containers, and
+applications.
+
+Ask Gordon integrates directly with Docker's tools to help you perform specific
+tasks. It understands your local setup, such as your local source code and
+images. For example, you can ask Gordon to help you identify vulnerabilities in
+your project or how to optimize a Dockerfile in your local repository. This
+tight integration ensures responses are practical and actionable.
+
+> [!NOTE]
+> Ask Gordon is powered by Large Language Models (LLMs). Like all LLM-based
+> tools, its responses may sometimes be inaccurate. Always verify the
+> information provided.
+
+### What data can Gordon access?
+
+When you use Ask Gordon, you can ask questions about files on your local
+computer, such as local Dockerfiles or Compose files. If you use Ask Gordon
+through the `docker ai` command, Gordon can access the files and directories in
+the current working directory where you executed the command. If you ask a
+question about a specific file or directory in the **Ask Gordon** view in
+Docker Desktop, Gordon will prompt you to select a context for the question.
+
+Because Ask Gordon integrates directly with Docker Desktop, it can also see all
+of the images you have in your local image store. That is, images you have
+built, or pulled from a registry.
+
+Local files and images are sent to the Gordon backend over the network,
+together with your query, if needed for Gordon to answer your question. This
+information is never persistently stored or shared with anyone. It is only used
+by Gordon to formulate a response.
+
+All data is encrypted in transit.
+
+### How your data is used
+
+Docker anonymizes your interactions with Ask Gordon to improve the service.
+This includes your questions, Gordon's responses, and your feedback (for
+example, thumbs-up or thumbs-down ratings). Docker collects this data with the
+following safeguards:
+
+- Data is anonymized and cannot be linked back to you.
+- Human reviewers analyze interactions to refine responses for similar queries.
+- Docker does not use your data to train AI models or share it with others.
+
+By using Ask Gordon, you help improve Docker AI's accuracy and reliability,
+contributing to a better experience for all users.
+
+## Setup
+
+Ask Gordon is not enabled by Default for your Docker Desktop installation.
+Before you can use Ask Gordon, you must:
+
+- Sign in to your Docker account.
+- Enable the feature in the Docker Desktop settings.
+- Accept the terms of service.
+
+### Sign in
+
+1. Open Docker Desktop.
+2. Select the **Sign in** button.
+3. Complete the sign-in process in your web browser.
+
+### Enable the feature
+
+After signing in to your Docker Account, enable the Docker AI feature:
+
+1. Open the **Settings** view in Docker Desktop.
+2. Navigate to **Features in development**.
+3. Check the **Enable Docker AI** checkbox.
+4. Select **Apply & restart**.
+
+### Accept the terms of service
+
+To start using Docker AI, you need to accept the terms of service. You can do
+this in one of two ways:
+
+- Open the **Ask Gordon** view in Docker Desktop and ask a question.
+- Use the `docker ai` CLI command to issue a query.
+
+The first time you interact with Docker AI, you'll see a prompt to accept the
+terms of service. For example:
+
+```console
+$ docker ai what can you do?
+
+  Before using Gordon, please accept the terms of service
+```
+
+After accepting the terms, you can begin using Ask Gordon.
+
+## Using Ask Gordon
+
+The primary interfaces to Docker's AI capabilities are through the **Ask
+Gordon** view in Docker Desktop, or if you prefer to use the CLI: the `docker
+ai` CLI command.
+
+If you've used an AI chatbot before, these interfaces will be pretty familiar
+to you. You can chat with the Docker AI to get help with your Docker tasks.
+
+### Contextual help
+
+Once you've enabled the Docker AI features, you'll also find references to
+**Ask Gordon** in various other places throughout the Docker Desktop user
+interface. Whenever you encounter a button with the "sparkles" (✨) icon in the
+user interface, you can use the button to get contextual support from Ask
+Gordon.
+
+## Example workflows
+
+Ask Gordon is a general-purpose AI assistant created to help you with all your
+Docker-related tasks and workflows. If you need some inspiration, here are a
+few ways things you can try:
+
+- [Troubleshoot a crashed container](#troubleshoot-a-crashed-container)
+- [Get help with running a container](#get-help-with-running-a-container)
+- [Improve a Dockerfile](#improve-a-dockerfile)
+
+For more examples, try asking Gordon directly. For example:
+
+```console
+$ docker ai "What can you do?"
+```
+
+### Troubleshoot a crashed container
+
+If you try to start a container with an invalid configuration or command, you
+can use Ask Gordon to troubleshoot the error. For example, try starting a
+Postgres container without specifying a database password:
+
+```console
+$ docker run postgres
+Error: Database is uninitialized and superuser password is not specified.
+       You must specify POSTGRES_PASSWORD to a non-empty value for the
+       superuser. For example, "-e POSTGRES_PASSWORD=password" on "docker run".
+
+       You may also use "POSTGRES_HOST_AUTH_METHOD=trust" to allow all
+       connections without a password. This is *not* recommended.
+
+       See PostgreSQL documentation about "trust":
+       https://www.postgresql.org/docs/current/auth-trust.html
+```
+
+In the **Containers** view in Docker Desktop, select the ✨ icon next to the
+container's name, or inspect the container and open the **Ask Gordon** tab.
+
+### Get help with running a container
+
+If you want to run a specific image but you're not sure how, Gordon might be
+able to help you get set up:
+
+1. Pull an image from Docker Hub (for example, `postgres`).
+2. Open the **Images** view in Docker Desktop and select the image.
+3. Select the **Run** button
+
+In the _Run a new container_ dialog that opens, you should see a message about
+**Ask Gordon**.
+
+![Ask Gordon hint in Docker Desktop](../images/gordon-run-ctr.png)
+
+The linked text in the hint is a suggested prompt to start a conversation with
+Ask Gordon.
+
+### Improve a Dockerfile
+
+Gordon can analyze your Dockerfile and suggest improvements. To have Gordon
+evaluate your Dockerfile using the `docker ai` command:
+
+1. Navigate to your project directory:
+
+   ```console
+   $ cd path/to/my/project
+   ```
+
+2. Use the `docker ai` command to rate your Dockerfile:
+
+   ```console
+   $ docker ai rate my Dockerfile
+   ```
+
+Gordon will analyze your Dockerfile and identify opportunities for improvement
+across several dimensions:
+
+- Build cache optimization
+- Security
+- Image size efficiency
+- Best practices compliance
+- Maintainability
+- Reproducibility
+- Portability
+- Resource efficiency
+
+## Disable Ask Gordon
+
+If you've enabled Ask Gordon and you want to disable it again:
+
+1. Open the **Settings** view in Docker Desktop.
+2. Navigate to **Features in development**.
+3. Clear the **Enable Docker AI** checkbox.
+4. Select **Apply & restart**.
+
+If you want to disable Ask Gordon for your entire Docker organization, using
+[Settings Management](/manuals/security/for-admins/hardened-desktop/settings-management/_index.md),
+add the following property to your `admin-settings.json` file:
+
+```json
+{
+  "enableDockerAI": {
+    "value": false,
+    "locked": true
+  }
+}
+```
+
+Alternatively, you can disable all Beta features by setting `allowBetaFeatures` to false:
+
+```json
+{
+  "allowBetaFeatures": {
+    "value": false,
+    "locked": true
+  }
+}
+```
+
+## Feedback
+
+<!-- vale Docker.We = NO -->
+
+We value your input on Ask Gordon and encourage you to share your experience.
+Your feedback helps us improve and refine Ask Gordon for all users. If you
+encounter issues, have suggestions, or simply want to share what you like,
+here's how you can get in touch:
+
+- Thumbs-up and thumbs-down buttons
+
+  Rate Ask Gordon's responses using the thumbs-up or thumbs-down buttons in the
+  response.
+
+- Feedback survey
+
+  You can access the Ask Gordon survey by following the _Give feedback_ link in
+  the **Ask Gordon** view in Docker Desktop.
+
+Thank you for helping us improve Ask Gordon.