mirror of
https://github.com/googleapis/genai-toolbox.git
synced 2026-02-04 04:05:22 -05:00
15b628d2d2
## Description --- This pull request introduces a new tool, `cloud-sql-mysql-create-instance`, which allows users to create Cloud SQL MySQL instances directly from the toolbox. The tool is designed to simplify the instance creation process by providing sensible defaults while still offering flexibility for advanced configurations. Key Features of the New Tool: Simplified Instance Creation: The tool introduces an editionPreset parameter that can be set to either "Production" or "Development". This allows users to easily create instances with appropriate settings for their environment without needing to specify low-level configuration details. Production Preset: Configures a high-availability, performance-optimized instance. Development Preset: Configures a cost-effective, general-purpose instance suitable for testing and development. ## PR Checklist --- > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [ ] Ensure the tests and linter pass - [ ] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here>
49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
---
|
|
title: cloud-sql-mysql-create-instance
|
|
type: docs
|
|
weight: 2
|
|
description: "Create a Cloud SQL for MySQL instance."
|
|
---
|
|
|
|
The `cloud-sql-mysql-create-instance` tool creates a new Cloud SQL for MySQL instance in a specified Google Cloud project.
|
|
|
|
{{< notice info >}}
|
|
This tool uses the `cloud-sql-admin` source.
|
|
{{< /notice >}}
|
|
|
|
## Configuration
|
|
|
|
Here is an example of how to configure the `cloud-sql-mysql-create-instance` tool in your `tools.yaml` file:
|
|
|
|
```yaml
|
|
sources:
|
|
my-cloud-sql-admin-source:
|
|
kind: cloud-sql-admin
|
|
|
|
tools:
|
|
create_my_mysql_instance:
|
|
kind: cloud-sql-mysql-create-instance
|
|
source: my-cloud-sql-admin-source
|
|
description: "Creates a MySQL instance using `Production` and `Development` presets. For the `Development` template, it chooses a 2 vCPU, 16 GiB RAM, 100 GiB SSD configuration with Non-HA/zonal availability. For the `Production` template, it chooses an 8 vCPU, 64 GiB RAM, 250 GiB SSD configuration with HA/regional availability. The Enterprise Plus edition is used in both cases. The default database version is `MYSQL_8_4`. The agent should ask the user if they want to use a different version."
|
|
```
|
|
|
|
## Parameters
|
|
|
|
The `cloud-sql-mysql-create-instance` tool has the following parameters:
|
|
|
|
| **field** | **type** | **required** | **description** |
|
|
| --------------- | :------: | :----------: | --------------------------------------------------------------------------------------------------------------- |
|
|
| project | string | true | The Google Cloud project ID. |
|
|
| name | string | true | The name of the instance to create. |
|
|
| databaseVersion | string | false | The database version for MySQL. If not specified, defaults to the latest available version (e.g., `MYSQL_8_4`). |
|
|
| rootPassword | string | true | The root password for the instance. |
|
|
| editionPreset | string | false | The edition of the instance. Can be `Production` or `Development`. Defaults to `Development`. |
|
|
|
|
## Reference
|
|
|
|
| **field** | **type** | **required** | **description** |
|
|
| ----------- | :------: | :----------: | -------------------------------------------------------------- |
|
|
| kind | string | true | Must be `cloud-sql-mysql-create-instance`. |
|
|
| source | string | true | The name of the `cloud-sql-admin` source to use for this tool. |
|
|
| description | string | false | A description of the tool that is passed to the agent. |
|