diff --git a/explore-analyze/ai-features/agent-builder/agent-builder-agents.md b/explore-analyze/ai-features/agent-builder/agent-builder-agents.md index bb90c5aa0b..fd82add36b 100644 --- a/explore-analyze/ai-features/agent-builder/agent-builder-agents.md +++ b/explore-analyze/ai-features/agent-builder/agent-builder-agents.md @@ -39,11 +39,13 @@ The **Agents** page provides a centralized view of all your agents. From this pa - Start chatting with an agent or perform other actions: - **Elastic AI Agent**: you can **chat** or **clone** the default agent using the chat or clone buttons. The default agent cannot be edited directly. :::{image} images/chat-and-clone-buttons.png + :screenshot: :alt: Chat with agent and clone agent buttons :width: 120px ::: - **Custom agents**: You can **chat**, **edit**, **clone**, or **delete** an agent from the management overview. :::{image} images/chat-edit-clone-delete.png + :screenshot: :alt: Agent context menu showing Chat, Edit, Clone, and Delete options :width: 130px ::: @@ -64,6 +66,7 @@ Navigate to the **Agents** page to access the agent management interface. Select the **New agent** button to being creating a new agent. :::{image} images/new-agent-button.png +:screenshot: :alt: Select the New agent button to create a new agent :width: 150px ::: @@ -108,6 +111,7 @@ Optionally customize the agent's appearance and organization: Select **Save** to create your agent, or **Save and chat** to create the agent and immediately begin a conversation with it. :::{image} images/save-and-chat-buttons.png +:screenshot: :alt: Save and Save and chat buttons :width: 270px ::: diff --git a/explore-analyze/ai-features/agent-builder/chat.md b/explore-analyze/ai-features/agent-builder/chat.md index b547c691b1..d33a9ac886 100644 --- a/explore-analyze/ai-features/agent-builder/chat.md +++ b/explore-analyze/ai-features/agent-builder/chat.md @@ -14,6 +14,13 @@ applies_to: The chat GUI and programmatic interfaces enable real-time communication where you can ask questions, request data analysis, and receive immediate responses from your configured agents. + + ## Get started :::{tip} @@ -26,8 +33,9 @@ You can also search for **Agent Builder** in the [global search bar](/explore-an This takes you to the chat GUI: :::{image} images/agent-builder-chat-UI-get-started.png -::: +:screenshot: :alt: The main Agent Chat GUI showing the chat window, message input box, and agent selection panel +::: ## Agent Chat GUI @@ -35,33 +43,87 @@ This takes you to the chat GUI: Use the text input area to chat with an agent in real time. By default, you chat with the built-in Elastic AI Agent. -:::{note} -Conversations with agents consume tokens. To understand how usage is calculated, refer to [Token usage in Elastic Agent Builder](monitor-usage.md). -::: - :::{image} images/agent-builder-chat-input.png +:screenshot: :alt: Text input area for chatting with agents -:width: 850px +:width: 650px ::: -#### Agent selector +:::{note} +Conversations with agents consume tokens. To understand how usage is calculated, refer to [Token usage in Elastic Agent Builder](monitor-usage.md). +::: + +#### Select a different agent +```{applies_to} +stack: ga 9.3+ +``` -Use the agent selector to switch agents, to navigate to the agent management section, or to create a new agent. +Use the agent selector to switch agents, to navigate to the agent management section, or to create a new agent. An agent's behavior is defined by its custom instructions and available tools. Switch agents when you need different capabilities for your tasks. :::{image} images/agent-builder-agent-selector.png +:screenshot: :alt: Agent selector dropdown and message input field -:width: 850px +:width: 650px +::: + +#### Select a different model +```{applies_to} +stack: ga 9.3+ +``` + +Use the model selector to switch the underlying [model](models.md) the agent uses to generate responses. Switch models to prioritize faster responses, lower costs, or more complex reasoning, depending on your use case. + +:::{image} images/model-selector.png +:alt: Image description +:width: 650px +:screenshot: +::: + +### Access key actions +```{applies_to} +stack: ga 9.3+ +``` + +This menu is your hub for key management actions. You can quickly access important pages from here. + +:::{image} images/more-actions.png +:screenshot: +:alt: More actions menu button +:width: 150px +::: + +This opens a panel with links to key actions and management pages including agent, tool, and settings management. + +:::{image} images/more-actions-menu-options.png +:screenshot: +:alt: The expanded more options menu panel +:width: 250px ::: ### Find conversation history -Use the left sidebar to access previous conversations. +Use the chat history panel to access previous conversations. :::{image} images/agent-builder-chat-history.png +:screenshot: :alt: Chat history panel showing conversation list -:width: 250px +:width: 450px ::: +### Inspect tool calls and reasoning + +Expand the **Reasoning** section to see how the agent handles your request. This provides a detailed breakdown of the agent's reasoning steps, the tool calls it makes, and the responses it receives. The agent runs tools in a loop until it achieves its goal or [exceeds the maximum conversation length](limitations-known-issues.md#conversation-length-exceeded). + +:::{image} images/reasoning-steps.png +:screenshot: +:alt: Reasoning panel showing tool calls and execution steps +:width: 650px +::: + +Select **Inspect response** to view detailed information about individual tool calls and responses. + +Select **View JSON** to view the full raw response data. For more information, refer to [Monitor token usage](monitor-usage.md). + ## Agent Chat API The Agent Chat API provides programmatic access to chat functionality through REST endpoints. @@ -72,7 +134,7 @@ For a quick overview of the REST API for conversations, refer to [Chat and conve ### API reference -For the complete API reference, refer to the [Kibana API reference](https://www.elastic.co/docs/api/doc/kibana/operation/operation-get-agent-builder-conversations). +For the complete API reference, refer to the [{{kib}} API reference](https://www.elastic.co/docs/api/doc/kibana/operation/operation-get-agent-builder-conversations). diff --git a/explore-analyze/ai-features/agent-builder/images/agent-builder-agent-selector.png b/explore-analyze/ai-features/agent-builder/images/agent-builder-agent-selector.png index f50463d38e..fc8ab161c9 100644 Binary files a/explore-analyze/ai-features/agent-builder/images/agent-builder-agent-selector.png and b/explore-analyze/ai-features/agent-builder/images/agent-builder-agent-selector.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-UI-get-started.png b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-UI-get-started.png index 5f2fb30255..cc97830e94 100644 Binary files a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-UI-get-started.png and b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-UI-get-started.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-history.png b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-history.png index eb6f189912..0d0f00ae73 100644 Binary files a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-history.png and b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-history.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-input.png b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-input.png index d449c894ff..61df137516 100644 Binary files a/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-input.png and b/explore-analyze/ai-features/agent-builder/images/agent-builder-chat-input.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/model-selector.png b/explore-analyze/ai-features/agent-builder/images/model-selector.png new file mode 100644 index 0000000000..4d13038a1d Binary files /dev/null and b/explore-analyze/ai-features/agent-builder/images/model-selector.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/more-actions-menu-options.png b/explore-analyze/ai-features/agent-builder/images/more-actions-menu-options.png new file mode 100644 index 0000000000..deb1fe0e7b Binary files /dev/null and b/explore-analyze/ai-features/agent-builder/images/more-actions-menu-options.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/more-actions.png b/explore-analyze/ai-features/agent-builder/images/more-actions.png new file mode 100644 index 0000000000..3edcfba7e3 Binary files /dev/null and b/explore-analyze/ai-features/agent-builder/images/more-actions.png differ diff --git a/explore-analyze/ai-features/agent-builder/images/reasoning-steps.png b/explore-analyze/ai-features/agent-builder/images/reasoning-steps.png new file mode 100644 index 0000000000..1813a9dbee Binary files /dev/null and b/explore-analyze/ai-features/agent-builder/images/reasoning-steps.png differ diff --git a/explore-analyze/ai-features/agent-builder/tools.md b/explore-analyze/ai-features/agent-builder/tools.md index 238a7a9d3d..9fae5fe562 100644 --- a/explore-analyze/ai-features/agent-builder/tools.md +++ b/explore-analyze/ai-features/agent-builder/tools.md @@ -104,6 +104,7 @@ You can create custom tools to help agents interact with your data in specific w 2. Click **New tool**. :::{image} images/new-tool-button.png + :screenshot: :alt: New tool button for creating custom tools :width: 150px ::: @@ -119,6 +120,7 @@ You can create custom tools to help agents interact with your data in specific w - Select **Save and test** to create the tool and immediately open the testing interface :::{image} images/tool-save-save-and-test-buttons.png + :screenshot: :alt: Save and Save and test buttons for tool creation :width:250px ::: @@ -133,6 +135,7 @@ If you didn't select **Save and test** immediately: 2. Click the test icon (play button) associated with your tool. :::{image} images/test-icon.png +:screenshot: :alt: Test icon (play button) for running tool tests :width: 150px ::: @@ -164,6 +167,7 @@ If you didn't select **Save and test** immediately: Find the list of available tools on the **Tools** landing page in the UI, or use [Tools API](kibana-api.md#tools). :::{image} images/tools-overview.png +:screenshot: :alt: Tools landing page showing the list of available tools with their descriptions and actions :width:800px ::: @@ -208,6 +212,7 @@ Tools can also be accessed through the Model Context Protocol (MCP) server, whic The **Tools** UI provides a **Copy your MCP server URL** button for easy access. :::{image} images/copy-mcp-server-url-button.png +:screenshot: :alt: Copy MCP server URL button for easy configuration of external clients :width: 250px ::: diff --git a/explore-analyze/ai-features/agent-builder/tools/esql-tools.md b/explore-analyze/ai-features/agent-builder/tools/esql-tools.md index 2a82027b4e..d726e88836 100644 --- a/explore-analyze/ai-features/agent-builder/tools/esql-tools.md +++ b/explore-analyze/ai-features/agent-builder/tools/esql-tools.md @@ -63,7 +63,8 @@ FROM books You can ask the LLM to infer the parameters for the query or add them manually. -:::{image} ../images/create-esql-tool-query.png +:::{image} ../images/create-esql-tool-query.png +:screenshot: :alt: Creating an ES|QL tool with a parameterized query :::