[Security Assistant] EIS usage callout (elastic#221566)

elastic/security-team#12656
https://github.com/elastic/kibana/pull/220782/files#

To test:
1.
https://p.elstc.co/paste/w06HF7Yw#2tr6JjZXmUbjQ6TQdpgdenH4YOjiWdAoHCZ3OpRi5JG
2. locally:

```
export VAULT_ADDR=https://secrets.elastic.co:8200/
vault login --method=oidc
node scripts/eis.js
```

Callouts will not appear again once dismissed. Please clear the local
storage if you want them to show up again.

<img width="2557" alt="Screenshot 2025-05-29 at 15 53 21"
src="https://github.com/user-attachments/assets/506925cb-5bce-4a66-918e-cd9e000c7088"
/>

onboarding hub:
<img width="2559" alt="Screenshot 2025-05-29 at 09 32 14"
src="https://github.com/user-attachments/assets/4c8b99e5-156e-4062-95a9-fa45c101b858"
/>

Assistant:
<img width="1282" alt="Screenshot 2025-06-11 at 15 16 09"
src="https://github.com/user-attachments/assets/30d47a05-ded1-4c3e-9540-6ad97fda0a8b"
/>

Conversation:
<img width="674" alt="452997822-5c0b3933-b253-474e-92a5-d8793ebff819"
src="https://github.com/user-attachments/assets/97506996-9a85-45bb-a728-79df37bd592e"
/>

Integration:
<img width="2559" alt="Screenshot 2025-05-28 at 21 28 11"
src="https://github.com/user-attachments/assets/ec564dac-2aed-4ac5-ad2c-67728d6f3eda"
/>

Attack Discovery:
<img width="2560" alt="Screenshot 2025-06-11 at 15 35 08"
src="https://github.com/user-attachments/assets/9816fc43-0e6e-40b2-862b-82673330c4da"
/>

```
feature_flags.overrides:
  securitySolution.attackDiscoveryAlertsEnabled: true
  securitySolution.assistantAttackDiscoverySchedulingEnabled: true
```
<img width="2560" alt="Screenshot 2025-06-11 at 15 30 53"
src="https://github.com/user-attachments/assets/7089626f-a416-4260-92f0-1be3f06cf5d3"
/>

Connectors:
<img width="2559" alt="Screenshot 2025-06-10 at 11 15 41"
src="https://github.com/user-attachments/assets/74773473-ff1c-41c1-bdd5-fe6e64b9a497"
/>

Check the PR satisfies following conditions.

Reviewers should verify this PR satisfies this list as well.

- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: kibanamachine <[email protected]>
Co-authored-by: florent-leborgne <[email protected]>
Co-authored-by: Viduni Wickramarachchi <[email protected]>
(cherry picked from commit ed9f4e9)

Author: 4 people

src/platform/packages/shared/kbn-doc-links/src/get_doc_links.ts

@@ -430,6 +430,7 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
       avcResults: `https://www.elastic.co/blog/elastic-security-av-comparatives-business-test`,
       bidirectionalIntegrations: `${ELASTIC_DOCS}solutions/security/endpoint-response-actions/third-party-response-actions`,
       trustedApps: `${ELASTIC_DOCS}solutions/security/manage-elastic-defend/trusted-applications`,
+      elasticAiFeatures: `${ELASTIC_DOCS}solutions/security/ai`,
       eventFilters: `${ELASTIC_DOCS}solutions/security/manage-elastic-defend/event-filters`,
       blocklist: `${ELASTIC_DOCS}solutions/security/manage-elastic-defend/blocklist`,
       threatIntelInt: `${ELASTIC_DOCS}solutions/security/get-started/enable-threat-intelligence-integrations`,
@@ -457,6 +458,7 @@ export const getDocLinks = ({ kibanaBranch, buildFlavor }: GetDocLinkOptions): D
         : `https://www.elastic.co/blog/security-prebuilt-rules-editing`,
       createEsqlRuleType: `${ELASTIC_DOCS}solutions/security/detect-and-alert/create-detection-rule#create-esql-rule`,
       ruleUiAdvancedParams: `${ELASTIC_DOCS}solutions/security/detect-and-alert/create-detection-rule#rule-ui-advanced-params`,
+      thirdPartyLlmProviders: `${ELASTIC_DOCS}solutions/security/ai/set-up-connectors-for-large-language-models-llm`,
       entityAnalytics: {
         riskScorePrerequisites: `${ELASTIC_DOCS}solutions/security/advanced-entity-analytics/entity-risk-scoring-requirements`,
         entityRiskScoring: `${ELASTIC_DOCS}solutions/security/advanced-entity-analytics/entity-risk-scoring`,

src/platform/packages/shared/kbn-doc-links/src/types.ts

@@ -290,7 +290,9 @@ export interface DocLinks {
     readonly artifactControl: string;
     readonly avcResults: string;
     readonly bidirectionalIntegrations: string;
+    readonly thirdPartyLlmProviders: string;
     readonly trustedApps: string;
+    readonly elasticAiFeatures: string;
     readonly eventFilters: string;
     readonly eventMerging: string;
     readonly blocklist: string;

x-pack/platform/packages/shared/kbn-elastic-assistant/impl/assistant/assistant_conversation_banner/elastic_llm_callout.test.tsx

@@ -0,0 +1,69 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import React from 'react';
+import { render } from '@testing-library/react';
+import useLocalStorage from 'react-use/lib/useLocalStorage';
+import { ElasticLlmCallout } from './elastic_llm_callout';
+import { TestProviders } from '../../mock/test_providers/test_providers';
+
+jest.mock('react-use/lib/useLocalStorage');
+
+describe('ElasticLlmCallout', () => {
+  const defaultProps = {
+    showEISCallout: true,
+  };
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    (useLocalStorage as jest.Mock).mockReturnValue([false, jest.fn()]);
+  });
+
+  it('should not render when showEISCallout is false', () => {
+    const { queryByTestId } = render(<ElasticLlmCallout showEISCallout={false} />, {
+      wrapper: ({ children }) => <TestProviders>{children}</TestProviders>,
+    });
+    expect(queryByTestId('elasticLlmCallout')).not.toBeInTheDocument();
+  });
+
+  it('should not render when tour is completed', () => {
+    (useLocalStorage as jest.Mock).mockReturnValue([true, jest.fn()]);
+    const { queryByTestId } = render(
+      <TestProviders>
+        <ElasticLlmCallout {...defaultProps} />
+      </TestProviders>,
+      {
+        wrapper: ({ children }) => <TestProviders>{children}</TestProviders>,
+      }
+    );
+
+    expect(queryByTestId('elasticLlmCallout')).not.toBeInTheDocument();
+  });
+
+  it('should render links', () => {
+    const { queryByTestId } = render(
+      <TestProviders>
+        <ElasticLlmCallout {...defaultProps} />
+      </TestProviders>,
+      { wrapper: ({ children }) => <TestProviders>{children}</TestProviders> }
+    );
+    expect(queryByTestId('elasticLlmUsageCostLink')).toHaveTextContent('additional costs incur');
+    expect(queryByTestId('elasticLlmConnectorLink')).toHaveTextContent('connector');
+  });
+
+  it('should show callout when showEISCallout changes to true', () => {
+    const { rerender, queryByTestId } = render(
+      <TestProviders>
+        <ElasticLlmCallout showEISCallout={false} />
+      </TestProviders>,
+      { wrapper: ({ children }) => <TestProviders>{children}</TestProviders> }
+    );
+    expect(queryByTestId('elasticLlmCallout')).not.toBeInTheDocument();
+
+    rerender(<ElasticLlmCallout showEISCallout={true} />);
+    expect(queryByTestId('elasticLlmCallout')).toBeInTheDocument();
+  });
+});

x-pack/platform/packages/shared/kbn-elastic-assistant/impl/assistant/assistant_conversation_banner/elastic_llm_callout.tsx

@@ -0,0 +1,104 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import React, { useCallback, useEffect, useState } from 'react';
+import useLocalStorage from 'react-use/lib/useLocalStorage';
+
+import { css } from '@emotion/react';
+import { i18n } from '@kbn/i18n';
+import { FormattedMessage } from '@kbn/i18n-react';
+import { EuiCallOut, EuiLink, useEuiTheme } from '@elastic/eui';
+import { useAssistantContext } from '../../assistant_context';
+import { NEW_FEATURES_TOUR_STORAGE_KEYS } from '../../tour/const';
+import { useTourStorageKey } from '../../tour/common/hooks/use_tour_storage_key';
+
+export const ElasticLlmCallout = ({ showEISCallout }: { showEISCallout: boolean }) => {
+  const {
+    getUrlForApp,
+    docLinks: {
+      links: {
+        observability: { elasticManagedLlmUsageCost: ELASTIC_LLM_USAGE_COST_LINK },
+      },
+    },
+  } = useAssistantContext();
+  const { euiTheme } = useEuiTheme();
+  const tourStorageKey = useTourStorageKey(
+    NEW_FEATURES_TOUR_STORAGE_KEYS.CONVERSATION_CONNECTOR_ELASTIC_LLM
+  );
+  const [tourCompleted, setTourCompleted] = useLocalStorage<boolean>(tourStorageKey, false);
+  const [showCallOut, setShowCallOut] = useState<boolean>(showEISCallout);
+
+  const onDismiss = useCallback(() => {
+    setShowCallOut(false);
+    setTourCompleted(true);
+  }, [setTourCompleted]);
+
+  useEffect(() => {
+    if (showEISCallout && !tourCompleted) {
+      setShowCallOut(true);
+    } else {
+      setShowCallOut(false);
+    }
+  }, [showEISCallout, tourCompleted]);
+
+  if (!showCallOut) {
+    return;
+  }
+
+  return (
+    <EuiCallOut
+      data-test-subj="elasticLlmCallout"
+      onDismiss={onDismiss}
+      iconType="iInCircle"
+      title={i18n.translate('xpack.elasticAssistant.assistant.connectors.elasticLlmCallout.title', {
+        defaultMessage: 'You are now using the Elastic Managed LLM connector',
+      })}
+      size="s"
+      css={css`
+        padding: ${euiTheme.size.s} !important;
+      `}
+    >
+      <p>
+        <FormattedMessage
+          id="xpack.elasticAssistant.assistant.connectors.tour.elasticLlmDescription"
+          defaultMessage="Elastic AI Assistant and other AI features are powered by an LLM. The Elastic Managed LLM connector is used by default ({costLink}) when no custom connectors are available. You can configure a {customConnector} if you prefer."
+          values={{
+            costLink: (
+              <EuiLink
+                data-test-subj="elasticLlmUsageCostLink"
+                href={ELASTIC_LLM_USAGE_COST_LINK}
+                target="_blank"
+                rel="noopener noreferrer"
+                external
+              >
+                <FormattedMessage
+                  id="xpack.elasticAssistant.assistant.eisCallout.extraCost.label"
+                  defaultMessage="additional costs incur"
+                />
+              </EuiLink>
+            ),
+            customConnector: (
+              <EuiLink
+                data-test-subj="elasticLlmConnectorLink"
+                href={getUrlForApp('management', {
+                  path: `/insightsAndAlerting/triggersActionsConnectors/connectors`,
+                })}
+                target="_blank"
+                rel="noopener noreferrer"
+                external
+              >
+                <FormattedMessage
+                  id="xpack.elasticAssistant.assistant.eisCallout.connector.label"
+                  defaultMessage="custom connector"
+                />
+              </EuiLink>
+            ),
+          }}
+        />
+      </p>
+    </EuiCallOut>
+  );
+};

x-pack/platform/packages/shared/kbn-elastic-assistant/impl/assistant/assistant_conversation_banner/index.test.tsx

@@ -0,0 +1,89 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import React from 'react';
+import { render, screen } from '@testing-library/react';
+import { AssistantConversationBanner } from '.';
+import { AIConnector, Conversation, useAssistantContext } from '../../..';
+import { customConvo } from '../../mock/conversation';
+
+jest.mock('../../..');
+
+jest.mock('../../connectorland/connector_missing_callout', () => ({
+  ConnectorMissingCallout: () => <div data-test-subj="connector-missing-callout" />,
+}));
+
+jest.mock('./elastic_llm_callout', () => ({
+  ElasticLlmCallout: () => <div data-test-subj="elastic-llm-callout" />,
+}));
+
+describe('AssistantConversationBanner', () => {
+  const setIsSettingsModalVisible = jest.fn();
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('renders ConnectorMissingCallout when shouldShowMissingConnectorCallout is true', () => {
+    (useAssistantContext as jest.Mock).mockReturnValue({ inferenceEnabled: true });
+
+    render(
+      <AssistantConversationBanner
+        isSettingsModalVisible={false}
+        setIsSettingsModalVisible={setIsSettingsModalVisible}
+        shouldShowMissingConnectorCallout={true}
+        currentConversation={undefined}
+        connectors={[]}
+      />
+    );
+
+    expect(screen.getByTestId('connector-missing-callout')).toBeInTheDocument();
+  });
+
+  it('renders ElasticLlmCallout when Elastic LLM is enabled', () => {
+    (useAssistantContext as jest.Mock).mockReturnValue({ inferenceEnabled: true });
+    const mockConnectors = [
+      { id: 'mockLLM', actionTypeId: '.inference', isPreconfigured: true },
+    ] as AIConnector[];
+
+    const mockConversation = {
+      ...customConvo,
+      id: 'mockConversation',
+      apiConfig: {
+        connectorId: 'mockLLM',
+        actionTypeId: '.inference',
+      },
+    } as Conversation;
+
+    render(
+      <AssistantConversationBanner
+        isSettingsModalVisible={false}
+        setIsSettingsModalVisible={setIsSettingsModalVisible}
+        shouldShowMissingConnectorCallout={false}
+        currentConversation={mockConversation}
+        connectors={mockConnectors}
+      />
+    );
+
+    expect(screen.getByTestId('elastic-llm-callout')).toBeInTheDocument();
+  });
+
+  it('renders nothing when no conditions are met', () => {
+    (useAssistantContext as jest.Mock).mockReturnValue({ inferenceEnabled: false });
+
+    const { container } = render(
+      <AssistantConversationBanner
+        isSettingsModalVisible={false}
+        setIsSettingsModalVisible={setIsSettingsModalVisible}
+        shouldShowMissingConnectorCallout={false}
+        currentConversation={undefined}
+        connectors={[]}
+      />
+    );
+
+    expect(container).toBeEmptyDOMElement();
+  });
+});

x-pack/platform/packages/shared/kbn-elastic-assistant/impl/assistant/assistant_conversation_banner/index.tsx

@@ -0,0 +1,57 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import React, { useMemo } from 'react';
+import { AIConnector, Conversation, useAssistantContext } from '../../..';
+import { isElasticManagedLlmConnector } from '../../connectorland/helpers';
+import { ConnectorMissingCallout } from '../../connectorland/connector_missing_callout';
+import { ElasticLlmCallout } from './elastic_llm_callout';
+
+export const AssistantConversationBanner = React.memo(
+  ({
+    isSettingsModalVisible,
+    setIsSettingsModalVisible,
+    shouldShowMissingConnectorCallout,
+    currentConversation,
+    connectors,
+  }: {
+    isSettingsModalVisible: boolean;
+    setIsSettingsModalVisible: React.Dispatch<React.SetStateAction<boolean>>;
+    shouldShowMissingConnectorCallout: boolean;
+    currentConversation: Conversation | undefined;
+    connectors: AIConnector[] | undefined;
+  }) => {
+    const { inferenceEnabled } = useAssistantContext();
+    const showEISCallout = useMemo(() => {
+      if (inferenceEnabled && currentConversation && currentConversation.id !== '') {
+        if (currentConversation?.apiConfig?.connectorId) {
+          return connectors?.some(
+            (c) =>
+              c.id === currentConversation.apiConfig?.connectorId && isElasticManagedLlmConnector(c)
+          );
+        }
+      }
+    }, [inferenceEnabled, currentConversation, connectors]);
+    if (shouldShowMissingConnectorCallout) {
+      return (
+        <ConnectorMissingCallout
+          isConnectorConfigured={(connectors?.length ?? 0) > 0}
+          isSettingsModalVisible={isSettingsModalVisible}
+          setIsSettingsModalVisible={setIsSettingsModalVisible}
+        />
+      );
+    }
+
+    if (showEISCallout) {
+      return <ElasticLlmCallout showEISCallout={showEISCallout} />;
+    }
+
+    return null;
+  }
+);
+
+AssistantConversationBanner.displayName = 'AssistantConversationBanner';

x-pack/platform/packages/shared/kbn-elastic-assistant/impl/assistant/assistant_header/index.tsx

@@ -26,6 +26,8 @@ import { AssistantSettingsModal } from '../settings/assistant_settings_modal';
 import { AIConnector } from '../../connectorland/connector_selector';
 import { SettingsContextMenu } from '../settings/settings_context_menu/settings_context_menu';
 import * as i18n from './translations';
+import { ElasticLLMCostAwarenessTour } from '../../tour/elastic_llm';
+import { NEW_FEATURES_TOUR_STORAGE_KEYS } from '../../tour/const';
 
 interface OwnProps {
   selectedConversation: Conversation | undefined;
@@ -166,12 +168,18 @@ export const AssistantHeader: React.FC<Props> = ({
           <EuiFlexItem grow={false}>
             <EuiFlexGroup gutterSize="xs" alignItems={'center'}>
               <EuiFlexItem>
-                <ConnectorSelectorInline
-                  isDisabled={isDisabled || selectedConversation === undefined}
+                <ElasticLLMCostAwarenessTour
+                  isDisabled={isDisabled}
                   selectedConnectorId={selectedConnectorId}
-                  selectedConversation={selectedConversation}
-                  onConnectorSelected={onConversationChange}
-                />
+                  storageKey={NEW_FEATURES_TOUR_STORAGE_KEYS.ELASTIC_LLM_USAGE_ASSISTANT_HEADER}
+                >
+                  <ConnectorSelectorInline
+                    isDisabled={isDisabled || selectedConversation === undefined}
+                    selectedConnectorId={selectedConnectorId}
+                    selectedConversation={selectedConversation}
+                    onConnectorSelected={onConversationChange}
+                  />
+                </ElasticLLMCostAwarenessTour>
               </EuiFlexItem>
               <EuiFlexItem id={AI_ASSISTANT_SETTINGS_MENU_CONTAINER_ID}>
                 <SettingsContextMenu