Problem/Motivation
The AI tools shipped by entity_blueprint_ai and entity_blueprint_config_ai used verbose, module-prefixed function names such as entity_blueprint_config_manage_plugin_collection. These names are LLM-facing: they are the identifiers a model calls and the strings that appear in every tool schema and in inter-tool guidance text. The long names cost tokens, read inconsistently, and make cross-references in tool descriptions harder to scan.
Proposed resolution
Move every tool function_name into a short, consistent eb_ namespace (eb_ for content tools, eb_config_ for config tools), and update tool descriptions and the EntityBlueprintToolBase guidance message to reference the new names and the eb_skill / eb_list_bundles discovery workflow.
Old function_name |
New function_name |
|---|---|
entity_blueprint_add_element |
eb_add_element |
entity_blueprint_batch_operations |
eb_batch_operations |
entity_blueprint_create_entity |
eb_create_entity |
entity_blueprint_read_element |
eb_read_element |
entity_blueprint_read_entity |
eb_read_entity |
entity_blueprint_read_schema |
eb_read_schema |
entity_blueprint_remove_element |
eb_remove_element |
entity_blueprint_reorder_field |
eb_reorder_field |
entity_blueprint_restructure_layout |
eb_restructure_layout |
entity_blueprint_update_element |
eb_update_element |
entity_blueprint_validate_blueprint |
eb_validate |
entity_blueprint_config_create_config |
eb_config_create |
entity_blueprint_config_manage_plugin_collection |
eb_config_manage_plugins |
entity_blueprint_config_read_config |
eb_config_read |
entity_blueprint_config_read_config_schema |
eb_config_read_schema |
Plugin IDs (the id: key, e.g. entity_blueprint:create_entity) are unchanged; only the LLM-facing function_name values change.
API changes
Backward-incompatible. The function_name is the identifier exposed to the model and the string by which ai_agents.ai_agent.* and ai_assistant_api.ai_assistant.* tool allow-lists reference these tools. Any agent/assistant configuration that enables these tools by name must be updated to the new eb_ names, or the tools will no longer be available to that agent. The module is lifecycle: experimental, so the rename ships without a deprecation path.
Comments
Comment #3
tim bozeman commented