Dashview Docs

Autoflow guide

Workflow, testen en AI flow generatie

Deze pagina beschrijft het dagelijkse gebruik van Autoflow: van flow aanmaken en connecten tot testen, opslaan en AI-gegenereerde flows corrigeren.

Permissies Builder lifecycle Trigger modes Testen AI flow generatie Troubleshooting

1. Toegang en permissies

Run-rechten

  • allow_agent_run is nodig om flows te laden en te testen.
  • Zonder run-rechten blokkeert de backend op /automations en /automations/{id}/test.

Edit-rechten

  • allow_agent_edit is nodig voor create/update/delete.
  • Zonder edit-rechten blijft de builder in view-only mode.

2. Builder lifecycle

  1. Kies een bestaande flow via Load automation of klik New.
  2. Voeg nodes toe met de knoppen boven de canvas.
  3. Verbind nodes met drag-to-connect of Add connection.
  4. Selecteer een node om instellingen in de rechter editor aan te passen.
  5. Klik Test voor pad/evaluatie resultaten.
  6. Klik Save om op te slaan; Delete verwijdert de huidige flow.
Autoflow bovenbalk met acties
Bovenbalk met New, Ask AI, Test, Save en Delete.
Autoflow canvas
Canvas, connectors en node editor workflow.

3. Trigger modes en scheduling

Trigger ondersteunt twee modes: schedule en event.

Mode Velden Gedrag
schedule scheduleMode, scheduleTime, scheduleWeekday, scheduleMonthDay, schedule UI genereert cron op basis van preset, of gebruikt custom cron.
event eventType, minSeverity Gebruikt event-gedreven start (bijv. alert met minimum severity).

Schedule presets in editor

  • manual, daily, weekdays, weekly, selectedDays, monthly, custom.
  • Bij custom blijft het cron veld handmatig bewerkbaar.
  • Bij manual wordt schedule op Manual gezet.

4. Testen en resultinterpretatie

Wat Test doet

  • Voert de actieve definitie uit via POST /automations/{id}/test.
  • Markeert succesvolle nodes en connecties op de canvas.
  • Toont evaluaties voor condition-nodes (left/right/operator/passed).
  • Bewaart LLM traces en route-uitkomsten per LLM node.

Belangrijke outputs

  • context.values bevat metric/math/llm/element outputs voor templates.
  • context.evaluations bevat condition-resultaten.
  • context.filters laat toegepaste filterregels zien.
  • Action-resultaten bevatten path en executedAt.
Test altijd na wijzigingen in branches, metric keys of template-velden. De meeste regressies ontstaan door niet-bestaande keys in condition/action templates.

5. AI flow generatie met Ask AI

Ask AI gebruikt de streaming route /agents/createflow/streaming met je datasource context, schema's en palette-schema.

Prompt richtlijnen voor stabiele output

  • Noem exacte datasource-ID's en veldnamen.
  • Vraag expliciet om id op elke node.
  • Vraag expliciet om sourceId/targetId op elke connection.
  • Vraag voor condition/llmcondition altijd if en else branch-connecties.
  • Beperk de flow eerst tot een minimale werkende versie, breid daarna uit.
Maak een Autoflow met:
- trigger: dagelijks 08:00
- datasource: testdata
- filters: huidige week en vorige week
- metrics: sum(line_total) per filter
- condition: huidig < vorig
- action if: Notification naar all severity warn
- action else: Notification naar all severity info

Belangrijk:
- gebruik unieke node id's
- gebruik connections met sourceId en targetId
- condition moet if + else branch output hebben

6. Troubleshooting

Veelvoorkomende validatiefouten

  • connections.*.sourceId: Field required: connection gebruikt verkeerd veld (zoals source).
  • connections.*.targetId: Field required: connection gebruikt verkeerd veld (zoals target).
  • nodes.*.id: Field required: node bevat alleen key maar geen id.
  • node 'x' (...) is missing outgoing branch connections: if, else: condition node heeft geen volledige branching.

Runtime fouten

  • Unable to determine an entry node: flow heeft geen logische startnode.
  • Automation traversal exceeded safety limit: meestal een cycle in connecties.
  • Metric node ... requires a data source context: ontbrekende datasource upstream.
  • Connections must include both sourceId and targetId: ongeldig connection object.