Using Takumi Slack Commands
The English user guide is currently in beta preview. Most of the documents have been automatically translated from the Japanese version. Should you find any inaccuracies, please reach out to Flatt Security.
This feature is currently available only to selected organizations.
Command Types
After inviting Takumi to your Slack workspace, in addition to directly requesting tasks to Takumi, you can use the following Slack commands:
takumi-scopes: Manage the codebases Takumi can access.takumi-tasks: Manage Takumi's current one-shot and recurring tasks.takumi-knowledge: Manage the knowledge Takumi retains across tasks.
1. Managing Accessible Codebases with takumi-scopes
As scope configuration controls what repositories Takumi is able to access, repositories must be registered within the scope before requesting tasks related to it.
By entering /takumi-scopes in a Slack channel, you can view the repositories Takumi can currently access. Select Edit to add a new repository.
Takumi will display the repositories it's currently permitted to access. Select the repositories you want Takumi to access.
After selecting, confirm with Submit.
If you encounter an error such as "App took too long to respond," please wait a few seconds and try again (it may take time to fetch the list of repositories).
Reducing the number of repositories selected during GitHub integration may help mitigate this issue.
If the issue persists, please contact customer support.
By entering the /takumi-scopes command again, you can confirm and modify the added scopes.
2. Task Management with takumi-tasks
While scheduling tasks is possible with the following command, note that when requesting a task to Takumi immediately, you may also directly mention Takumi in slack with your request content.
By entering /takumi-tasks in a Slack channel, you can view the tasks currently assigned to Takumi, and buttons to assign recurring tasks (Cron Tasks) and one-shot tasks.
If you encounter an error such as "App took too long to respond," please wait a few seconds and try again. If the issue persists, please contact customer support.
Registering a One-Shot Task
Select Add One-Shot Task to display the one-shot task assignment form. Enter the task title, execution date and time, task details, and reporting destination (channel and mentioned users), and then click Submit to register.
After configuration, execute the /takumi-tasks command again to confirm currently scheduled one-shot tasks. These tasks can be modified or canceled as needed.
At the specified time, Takumi will create a thread within the channel and execute the task.
Please note that when scheduling a task, specifying a time before, or the same as when you submit the task, will cause the task to not be submitted properly.
Registering a Recurring Task (Cron Task)
Select Add Cron Task to display the recurring task assignment form. Similar to one-shot tasks, fill in the required fields and register with Submit. The timing in which to execute these tasks are to be specified in cron format.
After configuration, you can confirm and modify currently configured recurring tasks by executing the /takumi-tasks command again.
Takumi will execute the specified task at each specified time with a new thread within the channel.
3. Knowledge Management with takumi-knowledge
By entering /takumi-knowledge in a Slack channel, you can view and register the knowledge Takumi currently retains across tasks.
Select Add to manually register knowledge.
Execute the /takumi-knowledge command again to view and modify the added knowledge.
Select Delete to remove the registered knowledge.
