From d62eb6a2458752740b758602aecc57072f488576 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Wed, 5 Nov 2025 11:29:00 +0100 Subject: [PATCH 1/4] Delete MCP server API and A2A task examples ^ --- solutions/search/agent-builder/kibana-api.md | 64 +------------------- 1 file changed, 1 insertion(+), 63 deletions(-) diff --git a/solutions/search/agent-builder/kibana-api.md b/solutions/search/agent-builder/kibana-api.md index 51c1fc5b1e..ffa6a277cd 100644 --- a/solutions/search/agent-builder/kibana-api.md +++ b/solutions/search/agent-builder/kibana-api.md @@ -677,30 +677,6 @@ curl -X DELETE "https://${KIBANA_URL}/api/agent_builder/conversations/{conversat :::: -### MCP server API - -Refer to [](mcp-server.md) for more information. - -Communicate with the MCP server using JSON-RPC 2.0. - -```bash -curl -X POST "https://${KIBANA_URL}/api/agent_builder/mcp" \ - -H "Authorization: ApiKey ${API_KEY}" \ - -H "Content-Type: application/json" \ - -H "Accept: application/json" \ - -H "kbn-xsrf: true" \ - -d '{ - "jsonrpc": "2.0", - "id": 1, - "method": "tools/list" - }' -``` -If you're using Spaces, you need to prefix `/api/agent_builder` with `/s/`. Refer to [Working with Spaces](#working-with-spaces). - -:::{note} -This endpoint uses the JSON-RPC protocol. The MCP server is used by AI clients like Claude Desktop, Cursor, and VS Code extensions to access your Elastic tools. Use this {{kib}} API endpoint for testing MCP connectivity or debugging protocol communication. This endpoint requires JSON-RPC formatting and does not work from the Dev Tools Console. -::: - ### A2A protocol Refer to [](a2a-server.md) for more information. @@ -732,47 +708,9 @@ curl -X GET "https://${KIBANA_URL}/api/agent_builder/a2a/{agentId}.json" \ :::: -% TODO: Execute A2A agent task section - commented out until ready -% Execute A2A agent task -% ::::{tab-set} -% :group: api-examples -% -% :::{tab-item} Console -% :sync: console -% :::{note} -% This endpoint uses the JSON-RPC protocol, which cannot be executed in the Dev Tools Console. -% Use curl or another HTTP client. -% ::: -% -% :::{tab-item} curl -% :sync: curl -% ```bash -% curl -X POST "https://${KIBANA_URL}/api/agent_builder/a2a/{agentId}" \ -% -H "Authorization: ApiKey ${API_KEY}" \ -% -H "kbn-xsrf: true" \ -% -H "Content-Type: application/json" \ -% -d '{ -% "jsonrpc": "2.0", -% "method": "complete", -% "params": { -% "messages": [ -% { -% "role": "user", -% "content": "Hello from A2A protocol" -% } -% ] -% }, -% "id": "task-123" -% }' -% ``` -% ::: -% -% :::: - - ## API reference -For the full API documentation, refer to the [{{kib}} API reference](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-agent-builder). \ No newline at end of file +For the full API documentation, refer to the [{{kib}} API reference](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-agent-builder). From 67c7497cdc0aa5372116d7b221bf9cf3d6878520 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Wed, 5 Nov 2025 11:39:29 +0100 Subject: [PATCH 2/4] Revise A2A protocol section to Get A2A agent card configuration Updated section title and removed link to generated reference --- solutions/search/agent-builder/kibana-api.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/solutions/search/agent-builder/kibana-api.md b/solutions/search/agent-builder/kibana-api.md index ffa6a277cd..1418467ead 100644 --- a/solutions/search/agent-builder/kibana-api.md +++ b/solutions/search/agent-builder/kibana-api.md @@ -677,14 +677,12 @@ curl -X DELETE "https://${KIBANA_URL}/api/agent_builder/conversations/{conversat :::: -### A2A protocol +### Get A2A agent card configuration Refer to [](a2a-server.md) for more information. **Example:** Get A2A agent card configuration -This example uses the [get A2A agent card API](https://www.elastic.co/docs/api/doc/kibana/operation/operation-get-agent-builder-a2a-agentid-json). - ::::{tab-set} :group: api-examples From 04e2f5e3bbf005c920bda4556332112a4df45ac2 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Wed, 5 Nov 2025 11:42:04 +0100 Subject: [PATCH 3/4] add note --- solutions/search/agent-builder/kibana-api.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/solutions/search/agent-builder/kibana-api.md b/solutions/search/agent-builder/kibana-api.md index 1418467ead..573d7ee90c 100644 --- a/solutions/search/agent-builder/kibana-api.md +++ b/solutions/search/agent-builder/kibana-api.md @@ -679,7 +679,10 @@ curl -X DELETE "https://${KIBANA_URL}/api/agent_builder/conversations/{conversat ### Get A2A agent card configuration -Refer to [](a2a-server.md) for more information. +:::{note} +You shouldn't use the REST APIs to interact with the A2A endpoint, apart from getting the A2A agent card configuration. +Refer to [](a2a-server.md) for more information about using the A2A protocol. +::: **Example:** Get A2A agent card configuration From 76981b4aba2eff00893dac927fa17b558be07ef6 Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Wed, 5 Nov 2025 11:43:02 +0100 Subject: [PATCH 4/4] Change note to important Updated note to important and removed unnecessary lines. --- solutions/search/agent-builder/kibana-api.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/solutions/search/agent-builder/kibana-api.md b/solutions/search/agent-builder/kibana-api.md index 573d7ee90c..ddfe4ef52e 100644 --- a/solutions/search/agent-builder/kibana-api.md +++ b/solutions/search/agent-builder/kibana-api.md @@ -679,7 +679,7 @@ curl -X DELETE "https://${KIBANA_URL}/api/agent_builder/conversations/{conversat ### Get A2A agent card configuration -:::{note} +:::{important} You shouldn't use the REST APIs to interact with the A2A endpoint, apart from getting the A2A agent card configuration. Refer to [](a2a-server.md) for more information about using the A2A protocol. ::: @@ -709,9 +709,6 @@ curl -X GET "https://${KIBANA_URL}/api/agent_builder/a2a/{agentId}.json" \ :::: - - - ## API reference For the full API documentation, refer to the [{{kib}} API reference](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-agent-builder).