@sisense/sdk-ui 1.3.0 → 1.4.1

package/dist/ai/use-get-query-recommendations.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Parameters for {@link useGetQueryRecommendations} hook.
+ */
+export interface UseGetQueryRecommendationsParams {
+    /** Data model title or perspective title */
+    contextTitle: string;
+    /**
+     * Number of recommendations that should be returned
+     *
+     * If not specified, the default value is `4`
+     */
+    count?: number;
+}
+export declare const useGetQueryRecommendationsInternal: (params: UseGetQueryRecommendationsParams) => {
+    data: import(".").QueryRecommendationResponse;
+    isLoading: boolean;
+};
+/**
+ * React hook that fetches recommended questions for a data model or perspective.
+ *
+ * This hook includes the same code that fetches the initial suggested questions in the chatbot.
+ *
+ * ::: warning Note
+ * This hook is currently under private beta for selected customers and is subject to change as we make fixes and improvements.
+ * :::
+ *
+ * @example
+ * ```tsx
+ * import { SisenseContextProvider } from '@sisense/sdk-ui';
+ * import { AiContextProvider, useGetQueryRecommendations } from '@sisense/sdk-ui/ai';
+ *
+ * function Page() {
+ *   const { data } = useGetQueryRecommendations({
+ *     contextTitle: 'Sample ECommerce',
+ *   });
+ *
+ *   if (!data) {
+ *     return <div>Loading recommendations</div>;
+ *   }
+ *
+ *   return (
+ *     <ul>
+ *       {data.map((item, index) => (
+ *         <li key={index}>{item.nlqPrompt}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ *
+ * function App() {
+ *   return (
+ *     <SisenseContextProvider {...sisenseContextProps}>
+ *       <AiContextProvider>
+ *         <Page />
+ *       </AiContextProvider>
+ *     </SisenseContextProvider>
+ *   );
+ * }
+ * ```
+ * @param params - {@link UseGetQueryRecommendationsParams}
+ * @returns An array of objects, each containing recommended question text and its corresponding JAQL
+ * @beta
+ */
+export declare const useGetQueryRecommendations: (params: UseGetQueryRecommendationsParams) => {
+    data: import(".").QueryRecommendationResponse;
+    isLoading: boolean;
+};