LogoLogo
About
  • Home
  • Guides
  • BDK
  • REST API
  • Release Notes
  • Getting Started
    • What is Kognitos?
    • Logging In
    • Account Setup
    • Quick Start Guide
    • Core Concepts
  • Writing Automations
    • Automation Basics
      • Defining Data
      • Comments
      • Conditionals
      • Keywords
      • Loops
    • Calling Other Processes
      • Calling A Subprocess
      • Invoking a Subprocess
      • Starting Parallel Runs
    • Validating Data
    • Context Based Learning
    • Using the Debugger
  • Books
  • Automation Management
    • Scheduled Processes
    • Email Triggers
  • Enterprise Dashboard
  • Exception Handling
    • Providing Guidance
    • Resolving Common Exceptions
    • Learnings
  • Account Management
    • API Keys
    • User Roles & Permissions
Powered by GitBook
On this page
  • What is a Book?
  • How to Learn a Book
  • Using Multiple Credentials
  • Adding Extra Credentials
  • Switching Credentials

Was this helpful?

Export as PDF

Books

Learn Books to expand your automation's capabilities.

Last updated 25 days ago

Was this helpful?

What is a Book?

A Book is a set of related automation . 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:

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

  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"

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

learned
Book Library
procedures