NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Keen.io connects to a Nagent workspace with an API key. Once it is connected, agents can call 6 Keen.io actions, such as "List Cached Dataset Definitions", "Inspect All Event Collections" and "Inspect Collection Property". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Keen.io, with input parameters and output schema.
KEEN_IO_INSPECT_ALL_EVENT_COLLECTIONSRetrieve schema information for all event collections in a Keen.io project. Use this tool to: - List all event collection names in a project - Discover the schema (property names and types) for each collection - Explore available data before running queries Returns up to 5000 event collections with their names, URLs, and optional property schemas.
Input parameters
If true, include inferred property schema in response
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KEEN_IO_INSPECT_COLLECTION_PROPERTYTool to return details for a specific property in an event collection. Use when you need to inspect a property's inferred type and resource URL.
Input parameters
The property name within the event collection to retrieve details for (e.g., 'keen.id', 'user.email', 'item.price'). Use dot notation for nested properties.
The name of the event collection to inspect (e.g., 'purchases', 'pageviews', 'signups'). Must be an existing collection in your project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KEEN_IO_INSPECT_SINGLE_EVENT_COLLECTIONRetrieve schema information for a single Keen.io event collection. Returns the inferred property types for all fields in the specified collection, useful for understanding data structure before running queries. Property types include 'num' (numbers), 'string' (text), 'bool' (booleans), and 'datetime' (timestamps). Use this tool when you need to: - Understand the structure of a specific event collection - Verify property names and types before building queries - Debug data type mismatches in analytics queries
Input parameters
The name of the event collection to inspect (e.g., 'purchases', 'pageviews', 'signups'). Must be an existing collection in your project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KEEN_IO_LIST_CACHED_DATASETSList all cached dataset definitions for a Keen.io project. Returns paginated results of pre-computed dataset definitions including their query configuration, status, and timing information. Use limit and after_name parameters to page through large result sets. Cached datasets allow pre-computing analytics for hundreds or thousands of entities at once, enabling instant retrieval of results for any indexed entity.
Input parameters
Maximum number of dataset definitions to return per page (1-100). If not specified, defaults to the API default.
Pagination cursor; use the last dataset_name from previous page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KEEN_IO_SELECT_UNIQUETool to return unique values for a target property. Use when distinct property values are required for matching events with optional filters and timeframe constraints.
Input parameters
Optional array of filter objects to refine which events are analyzed.
Property or list of properties to group results by. Returns unique values for each group.
Time interval for bucketing results (e.g., 'hourly', 'daily', 'weekly', 'monthly', 'yearly').
Timezone for interpreting relative timeframes. Either an offset in seconds (e.g., -28800 for PST) or IANA timezone name (e.g., 'US/Pacific').
Time range to analyze. Use either a relative timeframe string (e.g., 'this_7_days', 'previous_30_days', 'this_month') or an absolute timeframe object with 'start' and 'end' keys containing ISO-8601 timestamps.
The property name whose unique (distinct) values will be returned. Supports nested properties using dot notation (e.g., 'user.id', 'item.category').
Name of the event collection to query for unique values (e.g., 'purchases', 'page_views').
If true, include execution metadata in the response
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
KEEN_IO_UNREVOKE_ACCESS_KEYReactivate a previously revoked Keen.io access key. Use this tool when you need to restore access for a key that was previously revoked but not deleted. A revoked key has its 'active' flag set to false; this operation sets it back to true, allowing the key to be used for API authentication again. Note: This operation requires a Master API Key for authentication. The key must have been previously revoked (not deleted) to be unrevoked.
Input parameters
The Access Key string to reactivate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 6 Keen.io actions on Nagent, including "List Cached Dataset Definitions", "Inspect All Event Collections" and "Inspect Collection Property". List Cached Dataset Definitions: List all cached dataset definitions for a Keen.io project. Each action is listed on this page with its input parameters and its output.
Keen.io connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 2 optional inputs: limit and after_name. It returns data, error and successful.