Create an agent
- Base URL
-
https://{kibana_url}
- POST /api/agent_builder/agents
- POST /s/{space_id}/api/agent_builder/agents
Refer to Spaces for more information.
Create a new agent. Use this endpoint to define the agent's behavior, appearance, and capabilities through comprehensive configuration options. To learn more about agents, refer to the agents documentation.
Required authorization
- Privileges agentBuilder:manageAgents
Request body
-
configurationobjectrequired -
Configuration settings for the agent.
-
approvalsobject -
Auto-approval defaults applied to every run of this agent.
-
auto_approved_apisobject -
Destructive Elasticsearch or Kibana APIs this agent may call without a user confirmation, keyed by backend.
-
elasticsearchstring · max items: 100 -
Elasticsearch APIs pre-approved for every run of this agent. Each entry is an exact identifier formed from the namespace and name (for example
indices.create), a namespace wildcard (for exampleindices.*), or*for every Elasticsearch API. Entries are not checked against the known APIs, and one that matches no API has no effect. -
kibanastring · max items: 100 -
Kibana APIs pre-approved for every run of this agent. Each entry is an exact identifier formed from the namespace and name (for example
alerting.delete-alerting-rule-id), a namespace wildcard (for examplealerting.*), or*for every Kibana API. Entries are not checked against the known APIs, and one that matches no API has no effect.
Response
Indicates a successful response