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

tim bozeman created an issue. See original summary.

  • tim bozeman committed e7cbc509 on 1.0.x
    task: #3595051 Rename AI tool function names to the eb_ prefix
    
    By: tim...
tim bozeman’s picture

Status: Reviewed & tested by the community » Fixed

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.