You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Visualization tool
Introduced 2.13
Use the VisualizationTool
to find visualizations relevant to a question.
Step 1: Register a flow agent that will run the VisualizationTool
A flow agent runs a sequence of tools in order and returns the last tool’s output. To create a flow agent, send the following register agent request:
POST /_plugins/_ml/agents/_register
{
"name": "Test_Agent_For_Visualization_tool",
"type": "flow",
"description": "this is a test agent for the VisuailizationTool",
"tools": [
{
"type": "VisualizationTool",
"name": "DemoVisualizationTool",
"parameters": {
"index": ".kibana",
"input": "${parameters.question}",
"size": 3
}
}
]
}
For parameter descriptions, see Register parameters.
OpenSearch responds with an agent ID:
{
"agent_id": "9X7xWI0Bpc3sThaJdY9i"
}
Step 2: Run the agent
Before you run the agent, make sure that you add the sample OpenSearch Dashboards Sample eCommerce orders
dataset. To learn more, see Adding sample data.
Then, run the agent by sending the following request:
POST /_plugins/_ml/agents/9X7xWI0Bpc3sThaJdY9i/_execute
{
"parameters": {
"question": "what's the revenue for today?"
}
}
By default, OpenSearch returns the top three matching visualizations. You can use the size
parameter to specify the number of results returned. The output is returned in CSV format. The output includes two columns: Title
(the visualization title displayed in OpenSearch Dashboards) and Id
(a unique ID for this visualization):
{
"inference_results": [
{
"output": [
{
"name": "response",
"result": """Title,Id
[eCommerce] Total Revenue,10f1a240-b891-11e8-a6d9-e546fe2bba5f
"""
}
]
}
]
}
Register parameters
The following table lists all tool parameters that are available when registering an agent.
Parameter | Type | Required/Optional | Description |
---|---|---|---|
input | String | Required | The user input used to match visualizations. |
index | String | Optional | The index to search. Default is .kibana (the system index for OpenSearch Dashboards data). |
size | Integer | Optional | The number of visualizations to return. Default is 3 . |
Execute parameters
The following table lists all tool parameters that are available when running the agent.
Parameter | Type | Required/Optional | Description |
---|---|---|---|
question | String | Required | The natural language question to send to the LLM. |