Tools

Extend your Teammate's abilities with Tools

Tools are atomic actions or functionalities that can be connected to Kubiya Teammates. Teammates are able to execute the tools that they are connected to.

About Tools

Tools are stateless services built upon docker containers and leverage Kubiya's tool schema. A tool's execution environment is the Kubiya Teammate that's executing it. Therefore, the Teammate should have any secrets, environment variables, and knowledge needed for the tool to run successfully.

Kubiya has a library of popular tools you can use out-of-the-box (Kubiya Community Tools). You can also build your own.

Kubiya Community Tools

In the Kubiya Community Tools repository, you can discover useful tools that can be connected to your Teammates. You can also use the get inspiration for other tools. To us

Build Your Own Tools

There are 2 options for building tools: in YAML or in Python using Kubiya's SDK.

Which to use is simply a matter of preference. If you're more comfortable in YAML, go ahead. If you prefer to use a programming language, then opt for Python using the Kubiya SDK.

Testing Tools

1. Test locally – To do so...

   1. Make sure you have the necessary environment variables, secrets, and file paths

2. Test via Kubiya Teammate – To do this...

   1. Add the repo containing your tool to Kubiya as a source

   2. Connect that source to a Kubiya Teammate (Important: make sure this Teammate has the necessary environment variable, secrets, and knowledge if applicable)

   3. In Slack, instruct your Teammate to use that tool

Since your tool is stateless, once you get it to work in the environment once, it will work every time (all else equal).