ha-text-ai/custom_components/ha_text_ai/services.yaml

ask_question:
  name: 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:
    question:
      name: Question
      description: Your question or prompt for the AI assistant.
      required: true
      selector:
        text:
          multiline: true
          type: text

    model:
      name: Model
      description: "Select AI model to use (optional, overrides default setting)."
      required: false
      selector:
        text:
          multiline: false

    temperature:
      name: Temperature
      description: Controls response creativity (0.0-2.0).
      required: false
      default: 0.7
      selector:
        number:
          min: 0.0
          max: 2.0
          step: 0.1
          mode: slider

    max_tokens:
      name: Max Tokens
      description: Maximum length of the response (1-4096 tokens).
      required: false
      default: 1000
      selector:
        number:
          min: 1
          max: 4096
          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: {}

get_history:
  name: Get History
  description: Retrieve recent conversation history.
  target:
    entity:
      domain: sensor
      integration: ha_text_ai
  fields:
    limit:
      name: Limit
      description: Number of most recent conversations to return (1-100).
      required: false
      default: 10
      selector:
        number:
          min: 1
          max: 100
          step: 1
          mode: box

    start_date:
      name: Start Date
      description: Optional start date for filtering history.
      required: false
      selector:
        datetime:

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
  fields:
    prompt:
      name: System Prompt
      description: Instructions that define how the AI should behave and respond.
      required: true
      selector:
        text:
          multiline: true