Books

Learn Books to expand your automation's capabilities.

What is a Book?

A Book is a set of related automation procedures. Books can be added to an agent to expand automation functionality and integrate with external tools.

What Books Does Kognitos Offer?

Kognitos offers a range of Books to help you extend your automations. To see what’s available, visit the Books section in the platform or explore our reference documentation guides below.

Book Library

All available Books in Kognitos.

First Edition Books

Reference guides for First Edition (v1) Books.

BDK Books

Reference guides for BDK Books (newest).

How to Learn a Book

Before using a Book’s procedures in an automation, you must learn the Book in your agent. Here’s how:

1. In the left navigation bar, click on Books.

2. Click on + New Book.

3. Search for the name of the Book you'd like to add and click on it.

Note: All versions of a Book appear in search results. Look for the bdk tag to identify the newer version built with the Book Development Kit.

1. If the Book requires configuration, you will be prompted to provide configuration details.

2. Click Add to finish adding your Book.

3. Publish your agent.

After learning a Book, be sure to create a new Playground.

Playgrounds that were created before a Book was added will not be able to recognize it.

---

Using Multiple Credentials

In certain cases, you may need to connect the same Book to multiple accounts or organizations. For example, if you're using GitHub, you might need to connect to two GitHub organizations to access different repositories or teams. When using Microsoft Excel, you may want to connect to workbooks from different accounts — one for internal data and another for external reports.

With BDK Books, you can connect to a Book using more than one set of authentication details. This enables you to connect and switch between different API keys, access tokens, or login details without reconfiguring the Book.

Note: This feature is only supported for BDK Books and is not available for First Edition Books.

Adding Extra Credentials

To add additional credentials to a Book your agent has already learned:

1. Go to Books from the left navigation menu.

2. Click on the ⋮ next to the desired bdk Book and select Add Credentials.

3. Name your credentials, provide the configuration details, and click Add.

The credentials provided when initially configuring the Book will be the Default credentials. Kognitos will use the name given to your additional credentials to identify them.

Switching Credentials

You can switch credentials when you need to switch between accounts or organizations. To do so, use the following syntax in your Playground or Process:

switch {book name} to "{credential name}"

Replace book name with the name of the Book, and credential name with the name given to your credentials. In the example below, the credentials are switched to those for the secondary GitHub organization.

switch github to "Secondary Org"