diff --git a/README.md b/README.md
index d9634ad..3bc9c50 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
  [](https://opensource.org/licenses/MIT) [](https://github.com/hacs/integration)   
-
+
### Advanced AI Integration for Home Assistant with LLM multi-provider support
@@ -143,20 +143,61 @@ To be compatible, a provider should support:
4. Follow the configuration steps
### Via YAML
+
+### Platform Configuration (Global Settings)
+
```yaml
ha_text_ai:
- api_provider: openai # or anthropic
- api_key: !secret ai_api_key
- model: gpt-4o-mini
- temperature: 0.7
- max_tokens: 1000
- request_interval: 1.0
- api_endpoint: https://api.openai.com/v1 # optional, for custom endpoints
- system_prompt: |
+ api_provider: openai # Required
+ api_key: !secret ai_api_key # Required
+ model: gpt-4o-mini # Optional
+ temperature: 0.7 # Optional
+ max_tokens: 1000 # Optional
+ request_interval: 1.0 # Optional
+ api_endpoint: https://api.openai.com/v1 # Optional
+ system_prompt: | # Optional
You are a home automation expert assistant.
Focus on practical and efficient solutions.
```
+### Sensor Configuration
+
+```yaml
+sensor:
+ - platform: ha_text_ai
+ name: "My AI Assistant" # Required, unique identifier
+ api_provider: openai # Optional (inherits from platform)
+ model: "gpt-4o-mini" # Optional
+ temperature: 0.7 # Optional
+ max_tokens: 1000 # Optional
+```
+
+### 📋 Configuration Parameters
+
+#### Platform Configuration
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `api_provider` | String | ✅ | - | AI service provider (openai, anthropic) |
+| `api_key` | String | ✅ | - | Authentication key for AI service |
+| `model` | String | ❌ | Provider default | Specific AI model to use |
+| `temperature` | Float | ❌ | 0.7 | Response creativity level (0.0-2.0) |
+| `max_tokens` | Integer | ❌ | 1000 | Maximum response length |
+| `request_interval` | Float | ❌ | 1.0 | Delay between API requests |
+| `api_endpoint` | URL | ❌ | Provider default | Custom API endpoint |
+| `system_prompt` | String | ❌ | - | Default context for AI interactions |
+
+#### Sensor Configuration
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `platform` | String | ✅ | - | Must be `ha_text_ai` |
+| `name` | String | ✅ | - | Unique sensor identifier |
+| `api_provider` | String | ❌ | Platform setting | Override global provider |
+| `model` | String | ❌ | Platform setting | Override global model |
+| `temperature` | Float | ❌ | Platform setting | Override global temperature |
+| `max_tokens` | Integer | ❌ | Platform setting | Override global max tokens |
+
## 🛠️ Available Services
### ask_question