feat(tool/looker): add conversation CRUD tools

cmd/internal/imports.go

@@ -119,11 +119,13 @@ import (
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookeradddashboardfilter"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerconversationalanalytics"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreateagent"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreateconversation"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreategitbranch"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreateprojectdirectory"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreateprojectfile"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookercreateviewfromtable"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerdeleteagent"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerdeleteconversation"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerdeletegitbranch"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerdeleteprojectdirectory"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerdeleteprojectfile"
@@ -135,6 +137,7 @@ import (
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetconnectionschemas"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetconnectiontablecolumns"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetconnectiontables"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetconversation"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetdashboards"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetdimensions"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookergetexplores"
@@ -153,6 +156,7 @@ import (
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerhealthpulse"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerhealthvacuum"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerlistagents"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerlistconversations"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerlistgitbranches"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookermakedashboard"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookermakelook"
@@ -164,6 +168,7 @@ import (
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerrunlookmltests"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerswitchgitbranch"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerupdateagent"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerupdateconversation"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookerupdateprojectfile"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/looker/lookervalidateproject"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/mindsdb/mindsdbexecutesql"

docs/en/integrations/looker/tools/looker-create-conversation.md

@@ -0,0 +1,49 @@
+---
+title: "looker-create-conversation Tool"
+type: docs
+weight: 1
+description: >
+  "looker-create-conversation" tool starts a new conversation session with an AI agent.
+
+---
+
+## About
+
+The `looker-create-conversation` tool initiates a new conversation session
+associated with a specific Looker AI agent.
+
+Creating a conversation is the first step in interacting with an AI agent.
+The tool returns a conversation object, including a `conversation_id` which
+is required for subsequent messages and chat interactions.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+- `agent_id` (required): The unique ID of the AI agent to associate with the conversation.
+- `name` (optional): A descriptive name for the conversation.
+
+## Example
+
+```yaml
+kind: tool
+name: create_conversation
+type: looker-create-conversation
+source: looker-source
+description: |
+  Start a new conversation session with an AI agent.
+  Required Parameter:
+  - agent_id: The ID of the agent to use.
+  Optional Parameter:
+  - name: A name to identify this conversation.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-create-conversation"               |
+| source      |  string  |     true     | Name of the Looker source to use.                  |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-delete-conversation.md

@@ -0,0 +1,44 @@
+---
+title: "looker-delete-conversation Tool"
+type: docs
+weight: 1
+description: >
+  "looker-delete-conversation" tool deletes a conversation session.
+
+---
+
+## About
+
+The `looker-delete-conversation` tool removes a conversation session.
+
+Once deleted, the conversation and its message history are no longer
+accessible via the API.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+- `conversation_id` (required): The unique ID of the conversation to delete.
+
+## Example
+
+```yaml
+kind: tool
+name: delete_conversation
+type: looker-delete-conversation
+source: looker-source
+description: |
+  Delete a conversation and its history.
+  Required Parameter:
+  - conversation_id: The ID of the conversation.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-delete-conversation"               |
+| source      |  string  |     true     | Name of the Looker source to use.                  |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-get-conversation.md

@@ -0,0 +1,45 @@
+---
+title: "looker-get-conversation Tool"
+type: docs
+weight: 1
+description: >
+  "looker-get-conversation" tool retrieves detailed information about a specific conversation.
+
+---
+
+## About
+
+The `looker-get-conversation` tool retrieves details for a single conversation
+by its ID.
+
+This is useful for checking the current status or metadata of a
+conversation before interacting with it.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+- `conversation_id` (required): The unique ID of the conversation to retrieve.
+
+## Example
+
+```yaml
+kind: tool
+name: get_conversation
+type: looker-get-conversation
+source: looker-source
+description: |
+  Retrieve detailed information about a single conversation.
+  Required Parameter:
+  - conversation_id: The ID of the conversation to get.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-get-conversation"                  |
+| source      |  string  |     true     | Name of the Looker source to use.                  |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-list-conversations.md

@@ -0,0 +1,49 @@
+---
+title: "looker-list-conversations Tool"
+type: docs
+weight: 1
+description: >
+  "looker-list-conversations" tool lists existing conversation sessions.
+
+---
+
+## About
+
+The `looker-list-conversations` tool retrieves a list of previously
+created conversation sessions.
+
+Users can optionally filter the results by `agent_id` or use `limit` and
+`offset` for pagination.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+- `agent_id` (optional): Filter conversations by a specific AI agent ID.
+- `limit` (optional): The maximum number of conversations to fetch. Default is 100.
+- `offset` (optional): The number of conversations to skip before fetching. Default is 0.
+
+## Example
+
+```yaml
+kind: tool
+name: list_conversations
+type: looker-list-conversations
+source: looker-source
+description: |
+  Search for existing conversation sessions.
+  Optional Parameters:
+  - agent_id: Filter by agent ID.
+  - limit: Pagination limit.
+  - offset: Pagination offset.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-list-conversations"                |
+| source      |  string  |     true     | Name of the Looker source to use.                  |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-update-conversation.md

@@ -0,0 +1,46 @@
+---
+title: "looker-update-conversation Tool"
+type: docs
+weight: 1
+description: >
+  "looker-update-conversation" tool updates an existing conversation's attributes.
+
+---
+
+## About
+
+The `looker-update-conversation` tool modifies attributes of an
+existing conversation.
+
+Common uses include renaming a conversation to better reflect its content.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+- `conversation_id` (required): The unique ID of the conversation to update.
+- `name` (required): The new name for the conversation.
+
+## Example
+
+```yaml
+kind: tool
+name: update_conversation
+type: looker-update-conversation
+source: looker-source
+description: |
+  Update an existing conversation's name.
+  Required Parameters:
+  - conversation_id: The ID of the conversation.
+  - name: The new name.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-update-conversation"               |
+| source      |  string  |     true     | Name of the Looker source to use.                  |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |