nico f703c04687 add mute neuron mute mute control from api il y a 7 ans
..
tests 7b099ab8fd signals refactoring il y a 7 ans
README.md 3c4dc010a0 add mqtt doc il y a 7 ans
__init__.py 7b099ab8fd signals refactoring il y a 7 ans
order.py f703c04687 add mute neuron mute mute control from api il y a 7 ans

README.md

Order

Synopsis

An order signal is a word, or a sentence caught by the microphone and processed by the STT engine.

Options

parameter required default choices comment
order YES The order is passed directly without any parameters

Values sent to the synapse

None

Synapses example

Simple order

Syntax:

signals:
    - order: "<sentence>"

Example:

signals:
    - order: "please do this action"

Important note: SST engines can misunderstand what you say, or translate your sentence into text containing some spelling mistakes. For example, if you say "Kalliope please do this", the SST engine can return "caliope please do this". So, to be sure that your speaking order will be correctly caught and executed, we recommend you to test your STT engine by using the Kalliope GUI and check the returned text for the given order.

Important note: STT engines don't know the context. Sometime they will return an unexpected word. For example, "the operation to perform is 2 minus 2" can return "two", "too", "to" or "2" in english.

Important note: Kalliope will try to match the order in each synapse of its brain. So, if an order of one synapse is included in another order of another synapse, then both synapses tasks will be started by Kalliope.

For example, you have "test my umbrella" in a synapse A and "test" in a synapse B. When you'll say "test my umbrella", both synapse A and B will be started by Kalliope. So keep in mind that the best practice is to use really different sentences with more than one word for your order.

Order with arguments

You can add one or more arguments to an order by adding bracket to the sentence.

Syntax:

signals:
    - order: "<sentence> {{ arg_name }}"
    - order: "<sentence> {{ arg_name }} <sentence>"
    - order: "<sentence> {{ arg_name }} <sentence> {{ arg_name }}"

Example:

signals:
    - order: "I want to listen {{ artist_name }}"
    - order: "start the {{ episode_number }} episode"
    - order: "give me the weather at {{ location }} for {{ date }}"

Here, an example order would be speaking out loud the order: "I want to listen Amy Winehouse" In this example, both word "Amy" and "Winehouse" will be passed as an unique argument called artist_name to the neuron.

If you want to send more than one argument, you must split your argument with a word that Kalliope will use to recognise the start and the end of each arguments. For example: "give me the weather at {{ location }} for {{ date }}" And the order would be: "give me the weather at Paris for tomorrow" And so, it will work too with: "give me the weather at St-Pierre de Chartreuse for tomorrow"

See the input values section of the neuron documentation to know how to send arguments to a neuron.

Important note: The following syntax cannot be used: " {{ arg_name }} {{ arg_name2 }}" as Kalliope cannot know when a block starts and when it finishes.