Skip to content

Reference

Node types

Node type ID Label Executor plugin
flowdrop_ai_context_injector AI Context Item flowdrop_ai_context:ai_context_injector
flowdrop_ai_context_dynamic_selector AI Context flowdrop_ai_context:ai_context_dynamic_selector

Both belong to the ai_context node category.

AI Context Item parameters

Parameter Type Config panel Connectable Required
context_id string (UUID, or legacy entity ID) yes no yes

AI Context parameters

Parameter Type Default Config panel Connectable Required
task string no yes yes
agent_id string '' yes no no
scope_subscriptions object, {scope_id: [value, ...]} {} yes no no
entity_type string '' no yes no
entity_id string (numeric) '' no yes no
always_include array of item IDs [] no yes no
never_include array of item IDs [] no yes no
selection_mode '', minimal, relevant, broad '' yes no no
max_tokens integer, minimum 0 0 yes no no

The Config panel and Connectable columns show the shipped node type config. Sites can change them.

Outputs

See the output tables on the AI Context Item and AI Context pages.

Editor field formats

The module registers three field widgets with the FlowDrop field registry. A parameter uses one when its schema format matches.

Schema format Widget
ai_context_item_selector Context item search with preview.
ai_context_scope_subscriptions Scope and value picker.
ai_context_agent_selector Agent picker with a link to the agent's context settings.

The widgets load in the FlowDrop editor, the playground and standalone schema forms.

Editor endpoints

The widgets call these endpoints. All are GET, uncached, and require the administer flowdrop permission. They serve the module's own widgets and are not a public API.

Path Returns
/api/flowdrop/ai-context/autocomplete?q= Up to 50 published, viewable items whose label contains q, as {value: uuid, label, type}, plus the URL to add an item.
/api/flowdrop/ai-context/{context_id} One item's ID, label, type, purpose, first 300 characters of content and edit URL. Accepts a UUID or an entity ID.
/api/flowdrop/ai-context-scopes Enabled scopes that support subscriptions, with their values.
/api/flowdrop/ai-context-agent/{agent_id}/context-url The agent's context settings URL (empty for agents without a config entity) and whether the agent has saved context configuration.

The agent list in the agent picker comes from /api/flowdrop/ai-agents/autocomplete, provided by FlowDrop Agents.