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. Kognitos offers a variety of Books for automating tasks with HTTP, connecting to Microsoft Excel, working with databases, and more. Explore our reference guides to discover all available Books:

Book Library

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"