neurotimer

Run a synapse after a delay.

Input parameters

parameter	required	type	choices	comment
seconds	NO	int	value > 0	Number of second to wait before running the synapse
minutes	NO	int	value > 0	Number of minutes to wait before running the synapse
hours	NO	int	value > 0	Number of hours to wait before running the synapse
synapse	YES	string		Name of the synapse to run after the selected delay
forwarded_parameters	NO	dict		dict of parameters that will be passed to the called synapse

Returned values

None

Synapses example

Scenario: You are used to make a tea and want to know when it's time to remove the bag.

You: remember me to remove the bag of my tea
Kalliope: Alright
3 minutes later..
Kalliope: your tea is ready

- name: "tea-bag"
  signals:
    - order: "remember me to remove the bag of my tea"
  neurons:
    - neurotimer:
        minutes: 3
        synapse: "time-over"
    - say:
        message:
          - "Alright"

- name: "time-over"
  signals:
     - order: "no-order-for-this-synapse"
  neurons:
    - say:
        message:
          - "your tea is ready"

Scenario: You are starting to cook something

You: notify me in 10 minutes
Kalliope: I'll notify you in 10 minutes
10 minutes later..
Kalliope: You asked me to notify you

If your STT engine return integer when capturing a spoken order, you can set the time on the fly.

- name: "timer2"
    signals:
      - order: "notify me in {{ time }} minutes"
    neurons:
      - neurotimer:
          minutes: "{{ time }}"
          synapse: "notify"
      - say:
          message:
            - "I'll notify you in {{ time }} minutes"

- name: "notify"
  signals:
     - order: "no-order-for-this-synapse"
  neurons:
    - say:
        message:
          - "You asked me to notify you"

Scenario: You want to remember to do something

You: remind me to call mom in 15 minutes
Kalliope: I'll notify you in 15 minutes
15 minutes later..
Kalliope: You asked me to remind you to call mom 15 minutes ago

Passing argument to the called synapse with the forwarded_parameters.

- name: "remember-synapse"
  signals:
    - order: "remind me to {{ remember }} in {{ time }} minutes"
  neurons:
    - neurotimer:
        minutes: "{{ time }}"
        synapse: "remember-todo"
        forwarded_parameters:
          remember: "{{ remember }}"
          time: "{{ time }}"
    - say:
        message:
          - "I'll remind you in {{ time }} minutes"

- name: "remember-todo"
  signals:
    - order: "no-order-for-this-synapse"
  neurons:
    - say:
        message:
          - "You asked me to remind you to {{ remember }} {{ time }} minutes ago"

Note: You can still use the kalliope_memory instead of forwarded_parameters but your value will be overridden if you call the same synapse a multiple time.

Notes

Note: When used from the API, returned value from the launched synapse are lost

Note: Not all STT engine return integer.

Note: You must set at least one timer parameter (seconds or minutes or hours). You can also set them all.