Kaizen

Kaizen Similar

Find similar todos or similar buckets for discovery and recommendations

The Kaizen Similar block finds similar todos or similar buckets using hybrid scoring. It accepts an array of todo IDs or bucket IDs, fetches similar items for each, then merges and filters by similarity. Use it for discovery, related-content suggestions, and content workflows.

Block Type

kaizen_similar

Input Fields

Entity Type

FieldOptionsDescription
entityTypetodo, bucketFind similar todos or similar buckets

Source Selection (array of IDs)

FieldDescription
todoIdsWhen entity type is todo. Todo IDs to use as sources. Multi-select or reference like <kaizen_todos_1.todoIds>
bucketIdsWhen entity type is bucket. Bucket IDs to use as sources. Multi-select or reference like <kaizen_buckets_1.bucketIds>

For "Similar todos", use an array of todo IDs (e.g. from Kaizen Todos: <kaizen_todos_1.todoIds>). For "Similar buckets", use an array of bucket IDs from Kaizen Buckets: <kaizen_buckets_1.bucketIds>. The block finds similar items for each ID, then merges and filters by similarity score.

Options

FieldDefaultDescription
limit10Max results (1–50)
minSimilarity0.3Minimum similarity score 0–1
includeFromSameBuckettrueTodo-only. Include todos from the same bucket

Outputs

OutputTypeDescription
successbooleanWhether the request succeeded
dataarraySimilar todos or buckets with embedded similarity metadata
totalCountnumberNumber of results
sourceIdsarrayIDs used as sources (todo or bucket IDs)
todoIdsarrayTodo IDs when entity type was todo; else empty
bucketIdsarrayBucket IDs when entity type was bucket; else empty

Common Use Cases

Similar Todos for Given Todos

inputs:
  entityType: todo
  todoIds: "<kaizen_todos_1.todoIds>"
  limit: 5
  minSimilarity: 0.3
  includeFromSameBucket: true

Use todoIds from the block output (e.g. <kaizen_similar_1.todoIds>) in downstream blocks like Update Todo or Manage Todo-Buckets.

Similar Buckets for Given Buckets

inputs:
  entityType: bucket
  bucketIds: "<kaizen_buckets_1.bucketIds>"
  limit: 10
  minSimilarity: 0.3

Discovery Workflow: Todos → Similar → Downstream

# 1. Fetch todos
- type: kaizen_todos
  name: Fetch Todos
  inputs:
    collectionFilter: library
    completionStatus: NOT_COMPLETED
    limit: 1

# 2. Get similar todos
- type: kaizen_similar
  name: Similar Todos
  inputs:
    entityType: todo
    todoIds: "<fetch_todos.todoIds>"
    limit: 5
    includeFromSameBucket: true

# 3. Use similar todo IDs downstream (e.g. add to bucket, update, etc.)
# Reference: <similar_todos.todoIds>

Referencing Outputs

  • Similar todos: Use <kaizen_similar_1.todoIds> or <block_id.todoIds> in blocks that accept todo IDs (Update Todo, Manage Todo-Buckets, etc.).
  • Similar buckets: Use <kaizen_similar_1.bucketIds> or <block_id.bucketIds> where bucket IDs are needed.

Complete Workflow Example

# 1. Fetch one incomplete todo
- type: kaizen_todos
  name: Fetch One Todo
  inputs:
    collectionFilter: library
    completionStatus: NOT_COMPLETED
    limit: 1

# 2. Find similar todos
- type: kaizen_similar
  name: Get Similar
  inputs:
    entityType: todo
    todoIds: "<fetch_one_todo.todoIds>"
    limit: 5
    minSimilarity: 0.3
    includeFromSameBucket: true

# 3. Add similar todos to a bucket (example)
- type: kaizen_manage_todo_buckets
  name: Add Similar to Bucket
  inputs:
    operation: add
    bucketId: "<your_bucket_id>"
    todoIds: "<get_similar.todoIds>"
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started