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 them to get inspiration for other tools.
To use them in Kubiya, add the Community Tools repo URL – or a specific directory's URL – to Kubiya as a source. Then connect them to the Teammates you want to execute those tools.
Tip: Add the URL of a specific directory of the Community Tools repo for better visibility and management of Teammate-Source connections.
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
Test locally – To do so...
Make sure you have the necessary environment variables, secrets, and file paths
Test via Kubiya Teammate – To do this...
Add the repo containing your tool to Kubiya as a source
Connect that source to a Kubiya Teammate (Important: make sure this Teammate has the necessary environment variable, secrets, and knowledge if applicable)
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).
Last updated