Connections
Learn how to add, manage, and switch connections for books.
What is a Connection?
A connection is a book that's added to an agent with a set of authentication credentials. While some books can be installed without credentials, those that integrate with an external service or API may require authentication, so Kognitos can securely access and interact with the service.
Connect in Multiple Ways
Certain books can be connected using more than one set of credentials. For example, the GitHub book can be configured to access multiple organizations, or the Excel book can connect to workbooks from different accounts.
You can switch between API keys, access tokens, or login details by creating separate connections for each supported authentication method. This provides flexible access to the same book in multiple ways.
Managing Connections
To view and manage your connections:
Navigate to Books → Connections.
You'll see a list of all configured connections, including:
Connection name
Book name
Book version
Authentication method
Connection status
This page makes it easy to monitor, update, and troubleshoot your connections in one place.

Adding a New Connection
You can add a connection either from All Books or directly from the Connections section.
Navigate to Books → All Books.
Find the book you'd like to add and click on it.
On the Book Details page, click Add Connection.
Configure the connection by providing the name and authentication details, then click Connect.
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 "<connection name>"
Replace book name with the name of the Book, and connection name with the name given to your credentials or connection. In the example below, the credentials are switched to those for the secondary GitHub organization.
switch github to "Secondary Org"
Last updated
Was this helpful?