Files
genai-toolbox/docs/en/resources/tools/cloudsql/cloudsqlmysqlcreateinstance.md
prernakakkar-google 15b628d2d2 feat(prebuilt/cloud-sql-mysql): add create instance tool for Cloud SQ… (#1434)
## 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>
2025-09-16 06:34:04 +00:00

2.8 KiB

title, type, weight, description
title type weight description
cloud-sql-mysql-create-instance docs 2 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:

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.