Elasticsearch connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Elasticsearch actions, such as "Get Index Schema", "List Indices" and "Ping Cluster". 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 Elasticsearch, with input parameters and output schema.
ELASTICSEARCH_GET_INDEX_SCHEMATool to get the complete schema/mapping of a specific Elasticsearch index. Use when you need to understand the structure, field types, and mappings of an index.
Input parameters
The name of the index to get schema information for.
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
ELASTICSEARCH_LIST_INDICESTool to list all available Elasticsearch indices. Use when you need to get a list of indices in your Elasticsearch cluster, optionally filtering by pattern, health status, or other criteria.
Input parameters
A comma-separated string of index names or wildcard expressions to limit the returned information. For example, 'my-index-*,another-index'. If not provided, information for all indices is returned.
The health status to filter indices by (green, yellow, or red).
A comma-separated string of column names to sort by. For example, 'index,health'.
Type of index that wildcard patterns can match. Supports comma-separated values, e.g., 'open,hidden'. 'all' matches all indices by default.
If true, only shows information about primary shards.
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
ELASTICSEARCH_PING_CLUSTERTool to ping the Elasticsearch cluster and check if it is running. Use when you need to verify cluster connectivity and health status before performing operations.
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
ELASTICSEARCH_QUERY_INDEXTool to query an Elasticsearch index with various filters, time ranges, and pagination support. Use when you need to search for documents in an index with complex filtering criteria.
Input parameters
Starting offset for pagination (default: 0)
Number of results to return (default: 10, max: 1000 to prevent context overload)
Sort order for results
Free text search query (uses query_string query)
Specific fields to return (if not specified, returns all fields)
Enable highlighting for search terms
The name of the index to query. Must be a non-empty string.
Time-based filter for timestamp fields
Exact term filters for specific field values
Range filters for numeric or date fields
Include aggregations 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
Agents can call 4 Elasticsearch actions on Nagent, including "Get Index Schema", "List Indices" and "Ping Cluster". Get Index Schema: Get the complete schema/mapping of a specific Elasticsearch index. Each action is listed on this page with its input parameters and its output.
Elasticsearch 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.
Get Index Schema takes 1 required input: index_name. It returns data, error and successful.