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
  fields:
    question:
      name: Question
      description: Your question or prompt for the AI assistant
      required: true
      example: "What automations would you recommend for a smart kitchen?"
      selector:
        text:
          multiline: true

    model:
      name: Model
      description: Select an AI model to use (optional, overrides default setting)
      required: false
      example: "gpt-3.5-turbo"
      default: "gpt-3.5-turbo"
      selector:
        select:
          options:
            - label: "GPT-3.5 Turbo"
              value: "gpt-3.5-turbo"
            - label: "GPT-4"
              value: "gpt-4"
            - label: "GPT-4 32K"
              value: "gpt-4-32k"

    temperature:
      name: Temperature
      description: "Controls response creativity (0-2): Lower values for focused responses, higher for creative ones"
      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
      required: false
      default: 1000
      selector:
        number:
          min: 1
          max: 4096
          step: 1
          mode: box

clear_history:
  name: Clear History
  description: Delete all stored questions and responses
  fields: {}

get_history:
  name: Get History
  description: Retrieve recent conversation history
  fields:
    limit:
      name: Limit
      description: Number of most recent conversations to return
      required: false
      default: 10
      selector:
        number:
          min: 1
          max: 100
          step: 1
          mode: box

set_system_prompt:
  name: Set System Prompt
  description: Configure the AI's behavior by setting a system prompt
  fields:
    prompt:
      name: System Prompt
      description: Instructions that define how the AI should behave and respond
      required: true
      example: "You are a home automation expert assistant. Provide practical advice focused on smart home technology."
      selector:
        text:
          multiline: true