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.