Release v2.0.0

custom_components/ha_text_ai/services.yaml

@@ -3,23 +3,36 @@ ask_question:
   description: >-
     Send a question to the AI model and receive a detailed response.
     The response will be stored in the conversation history and can be retrieved later.
-  target:
-    entity:
-      domain: sensor
-      integration: ha_text_ai
   fields:
+    instance:
+      name: Instance
+      description: Name of the HA Text AI instance to use
+      required: true
+      selector:
+        entity:
+          integration: ha_text_ai
+          domain: sensor
+
     question:
       name: Question
-      description: Your question or prompt for the AI assistant.
+      description: Your question or prompt for the AI assistant
       required: true
       selector:
         text:
           multiline: true
           type: text
 
+    system_prompt:
+      name: System Prompt
+      description: Optional system prompt to set context for this specific question
+      required: false
+      selector:
+        text:
+          multiline: true
+
     model:
       name: Model
-      description: "Select AI model to use (optional, overrides default setting)."
+      description: "Select AI model to use (optional, overrides default setting)"
       required: false
       selector:
         text:
@@ -27,7 +40,7 @@ ask_question:
 
     temperature:
       name: Temperature
-      description: Controls response creativity (0.0-2.0).
+      description: Controls response creativity (0.0-2.0)
       required: false
       default: 0.7
       selector:
@@ -39,7 +52,7 @@ ask_question:
 
     max_tokens:
       name: Max Tokens
-      description: Maximum length of the response (1-4096 tokens).
+      description: Maximum length of the response (1-4096 tokens)
       required: false
       default: 1000
       selector:
@@ -49,34 +62,35 @@ ask_question:
           step: 1
           mode: box
 
-    system_prompt:
-      name: System Prompt
-      description: Optional system prompt to set context for this specific question.
-      required: false
-      selector:
-        text:
-          multiline: true
-
 clear_history:
   name: Clear History
-  description: Delete all stored questions and responses from the conversation history.
-  target:
-    entity:
-      domain: sensor
-      integration: ha_text_ai
-  fields: {}
+  description: Delete all stored questions and responses from the conversation history
+  fields:
+    instance:
+      name: Instance
+      description: Name of the HA Text AI instance to clear history for
+      required: true
+      selector:
+        entity:
+          integration: ha_text_ai
+          domain: sensor
 
 get_history:
   name: Get History
-  description: Retrieve recent conversation history.
-  target:
-    entity:
-      domain: sensor
-      integration: ha_text_ai
+  description: Retrieve conversation history with optional filtering and sorting
   fields:
+    instance:
+      name: Instance
+      description: Name of the HA Text AI instance to get history from
+      required: true
+      selector:
+        entity:
+          integration: ha_text_ai
+          domain: sensor
+
     limit:
       name: Limit
-      description: Number of most recent conversations to return (1-100).
+      description: Number of conversations to return (1-100)
       required: false
       default: 10
       selector:
@@ -86,24 +100,58 @@ get_history:
           step: 1
           mode: box
 
+    filter_model:
+      name: Filter Model
+      description: Filter conversations by specific AI model
+      required: false
+      selector:
+        text:
+          multiline: false
+
     start_date:
       name: Start Date
-      description: Optional start date for filtering history.
+      description: Filter conversations starting from this date/time
       required: false
       selector:
         datetime:
 
+    include_metadata:
+      name: Include Metadata
+      description: Include additional information like tokens used, response time, etc.
+      required: false
+      default: false
+      selector:
+        boolean:
+
+    sort_order:
+      name: Sort Order
+      description: Sort order for results (newest or oldest first)
+      required: false
+      default: "desc"
+      selector:
+        select:
+          options:
+            - label: "Newest First"
+              value: "desc"
+            - label: "Oldest First"
+              value: "asc"
+
 set_system_prompt:
   name: Set System Prompt
-  description: Set default system behavior instructions for all future conversations.
-  target:
-    entity:
-      domain: sensor
-      integration: ha_text_ai
+  description: Set default system behavior instructions for all future conversations
   fields:
+    instance:
+      name: Instance
+      description: Name of the HA Text AI instance to set system prompt for
+      required: true
+      selector:
+        entity:
+          integration: ha_text_ai
+          domain: sensor
+
     prompt:
       name: System Prompt
-      description: Instructions that define how the AI should behave and respond.
+      description: Instructions that define how the AI should behave and respond
       required: true
       selector:
         text: