mirror of
https://github.com/home-assistant/core.git
synced 2025-04-26 10:17:51 +00:00
1db5da4037
* Create a stateless assist API for MCP server * Update stateless API * Fix areas in exposed entity fields * Add tests that verify areas are returned * Revert the getstate intent * Revert whitespace change * Revert whitespace change * Revert method name changes to avoid breaking openai and google tests
49 lines
1.6 KiB
Python
49 lines
1.6 KiB
Python
"""LLM API for MCP Server."""
|
|
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers import llm
|
|
from homeassistant.util import yaml as yaml_util
|
|
|
|
from .const import LLM_API, LLM_API_NAME
|
|
|
|
EXPOSED_ENTITY_FIELDS = {"name", "domain", "description", "areas", "names"}
|
|
|
|
|
|
def async_register_api(hass: HomeAssistant) -> None:
|
|
"""Register the LLM API."""
|
|
llm.async_register_api(hass, StatelessAssistAPI(hass))
|
|
|
|
|
|
class StatelessAssistAPI(llm.AssistAPI):
|
|
"""LLM API for MCP Server that provides the Assist API without state information in the prompt.
|
|
|
|
Syncing the state information is possible, but may put unnecessary load on
|
|
the system so we are instead providing the prompt without entity state. Since
|
|
actions don't care about the current state, there is little quality loss.
|
|
"""
|
|
|
|
def __init__(self, hass: HomeAssistant) -> None:
|
|
"""Initialize the StatelessAssistAPI."""
|
|
super().__init__(hass)
|
|
self.id = LLM_API
|
|
self.name = LLM_API_NAME
|
|
|
|
@callback
|
|
def _async_get_exposed_entities_prompt(
|
|
self, llm_context: llm.LLMContext, exposed_entities: dict | None
|
|
) -> list[str]:
|
|
"""Return the prompt for the exposed entities."""
|
|
prompt = []
|
|
|
|
if exposed_entities:
|
|
prompt.append(
|
|
"An overview of the areas and the devices in this smart home:"
|
|
)
|
|
entities = [
|
|
{k: v for k, v in entity_info.items() if k in EXPOSED_ENTITY_FIELDS}
|
|
for entity_info in exposed_entities.values()
|
|
]
|
|
prompt.append(yaml_util.dump(list(entities)))
|
|
|
|
return prompt
|