Connector tools can be used by an agent to perform actions using your
Connections configured in
[Integration Connectors](https://docs.cloud.google.com/integration-connectors/docs/overview.md.txt).
Each connector tool is configured with a single Connection and one or more
actions. If needed, multiple tools can be created for a single Connection to
group different actions together for your agent to use.

The connector tool supports the following
[Connector types](https://docs.cloud.google.com/integration-connectors/docs/all-integration-connectors.md.txt):

- [AlloyDB](https://docs.cloud.google.com/integration-connectors/docs/connectors/alloydb/configure.md.txt)
- [Asana](https://docs.cloud.google.com/integration-connectors/docs/connectors/asana/configure.md.txt)
- [Azure AD (Entra ID)](https://docs.cloud.google.com/integration-connectors/docs/connectors/azuread/configure.md.txt)
- [BigQuery](https://docs.cloud.google.com/integration-connectors/docs/connectors/bigquery/configure.md.txt)
- [Box](https://docs.cloud.google.com/integration-connectors/docs/connectors/box/configure.md.txt)
- [Cloud Search](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_cloud_search/configure.md.txt)
- [Cloud Spanner](https://docs.cloud.google.com/integration-connectors/docs/connectors/cloudspanner/configure.md.txt)
- [Cloud SQL - MySQL](https://docs.cloud.google.com/integration-connectors/docs/connectors/cloudsqlformysql/configure.md.txt)
- [Cloud SQL - PostgreSQL](https://docs.cloud.google.com/integration-connectors/docs/connectors/cloudsqlforpostgresql/configure.md.txt)
- [Cloud SQL - SQL Server](https://docs.cloud.google.com/integration-connectors/docs/connectors/cloudsqlforsqlserver/configure.md.txt)
- [Cloud Storage](https://docs.cloud.google.com/integration-connectors/docs/connectors/cloudstorage/configure.md.txt)
- [Cloud Translation](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_translate/configure.md.txt)
- [Confluence](https://docs.cloud.google.com/integration-connectors/docs/connectors/confluence/configure.md.txt)
- [Couchbase](https://docs.cloud.google.com/integration-connectors/docs/connectors/couchbase/configure.md.txt)
- [DocuSign](https://docs.cloud.google.com/integration-connectors/docs/connectors/docusign/configure.md.txt)
- [Dropbox](https://docs.cloud.google.com/integration-connectors/docs/connectors/dropbox/configure.md.txt)
- [Dynamics 365](https://docs.cloud.google.com/integration-connectors/docs/connectors/dynamics365/configure.md.txt)
- [Elasticsearch](https://docs.cloud.google.com/integration-connectors/docs/connectors/elasticsearch/configure.md.txt)
- [Email](https://docs.cloud.google.com/integration-connectors/docs/connectors/email/configure.md.txt)
- [Enterprise License Manager](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_enterprise_license_manager/configure.md.txt)
- [Firestore](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_firestore/configure.md.txt)
- [FreshBooks](https://docs.cloud.google.com/integration-connectors/docs/connectors/freshbooks/configure.md.txt)
- [FTP](https://docs.cloud.google.com/integration-connectors/docs/connectors/ftp/configure.md.txt)
- [GitHub](https://docs.cloud.google.com/integration-connectors/docs/connectors/github/configure.md.txt)
- [Gmail](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_gmail/configure.md.txt)
- [Google Analytics](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_analytics/configure.md.txt)
- [Google Calendar](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_calendar/configure.md.txt)
- [Google Classroom](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_classroom/configure.md.txt)
- [Google Cloud Natural Language](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_natural_language/configure.md.txt)
- [Google Contacts](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_contacts/configure.md.txt)
- [Google Docs](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_docs/configure.md.txt)
- [Google Forms](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_forms/configure.md.txt)
- [Google Sheets](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_sheets/configure.md.txt)
- [Google Slides](https://docs.cloud.google.com/integration-connectors/docs/connectors/gsc_google_slides/configure.md.txt)
- [Greenplum](https://docs.cloud.google.com/integration-connectors/docs/connectors/greenplum/configure.md.txt)
- [Instagram](https://docs.cloud.google.com/integration-connectors/docs/connectors/instagram/configure.md.txt)
- [Jira Cloud](https://docs.cloud.google.com/integration-connectors/docs/connectors/jiracloud/configure.md.txt)
- [Jira Service Management](https://docs.cloud.google.com/integration-connectors/docs/connectors/jiraservicemanagement/configure.md.txt)
- [Kintone](https://docs.cloud.google.com/integration-connectors/docs/connectors/kintone/configure.md.txt)
- [Magento](https://docs.cloud.google.com/integration-connectors/docs/connectors/magento/configure.md.txt)
- [Mailchimp](https://docs.cloud.google.com/integration-connectors/docs/connectors/mailchimp/configure.md.txt)
- [MariaDB](https://docs.cloud.google.com/integration-connectors/docs/connectors/mariadb/configure.md.txt)
- [Meta Ads](https://docs.cloud.google.com/integration-connectors/docs/connectors/metaads/configure.md.txt)
- [Microsoft Teams](https://docs.cloud.google.com/integration-connectors/docs/connectors/msteams/configure.md.txt)
- [Monday](https://docs.cloud.google.com/integration-connectors/docs/connectors/monday/configure.md.txt)
- [MongoDB (version 2)](https://docs.cloud.google.com/integration-connectors/docs/connectors/mongodb/configure.md.txt)
- [Neo4j](https://docs.cloud.google.com/integration-connectors/docs/connectors/neo4j/configure.md.txt)
- [OneDrive](https://docs.cloud.google.com/integration-connectors/docs/connectors/onedrive/configure.md.txt)
- [Oracle DB (version 2](https://docs.cloud.google.com/integration-connectors/docs/connectors/oracledb/configure.md.txt)
- [PayPal](https://docs.cloud.google.com/integration-connectors/docs/connectors/paypal/configure.md.txt)
- [PostgreSQL](https://docs.cloud.google.com/integration-connectors/docs/connectors/postgresql/configure.md.txt)
- [Salesforce](https://docs.cloud.google.com/integration-connectors/docs/connectors/salesforce/configure.md.txt)
- [Salesforce Marketing Cloud](https://docs.cloud.google.com/integration-connectors/docs/connectors/salesforcemarketingcloud/configure.md.txt)
- [SAP HANA](https://docs.cloud.google.com/integration-connectors/docs/connectors/saphana/configure.md.txt)
- [SAP SuccessFactors](https://docs.cloud.google.com/integration-connectors/docs/connectors/sapsuccessfactors/configure.md.txt)
- [ServiceNow](https://docs.cloud.google.com/integration-connectors/docs/connectors/servicenow/configure.md.txt)
- [SharePoint](https://docs.cloud.google.com/integration-connectors/docs/connectors/sharepoint/configure.md.txt)
- [Shopify (version 1](https://docs.cloud.google.com/integration-connectors/docs/connectors/shopify/configure.md.txt)
- [Slack](https://docs.cloud.google.com/integration-connectors/docs/connectors/slack/configure.md.txt)
- [Stripe](https://docs.cloud.google.com/integration-connectors/docs/connectors/stripe/configure.md.txt)
- [Trello](https://docs.cloud.google.com/integration-connectors/docs/connectors/trello/configure.md.txt)
- [WordPress](https://docs.cloud.google.com/integration-connectors/docs/connectors/wordpress/configure.md.txt)
- [Workday](https://docs.cloud.google.com/integration-connectors/docs/connectors/workday/configure.md.txt)
- [Zendesk](https://docs.cloud.google.com/integration-connectors/docs/connectors/zendesk/configure.md.txt)

## Create a connection

To create a connection:

- Navigate from the agent builder to the **Tools** \> **Create**
- Select the **Integration connector** tool type
- Select your chosen connector type
- Use the **Create Connection** button.

This will navigate you
to Integration Connectors creation with a number of fields pre-filled.

Alternatively, you can navigate to Integration Connectors and follow the
[instructions to create a connection](https://docs.cloud.google.com/integration-connectors/docs/createconnection.md.txt).

> [!NOTE]
> **Note:** Connections must be in the same location as your agent in order to use them to create a connector tool.

## Connector actions

For each connector tool, there are two types of actions that can be made
available to your agent (see
[Entities, operations, and actions](https://docs.cloud.google.com/integration-connectors/docs/entities-operation-action.md.txt)
for more information):

1. **Entity CRUD operations**   


   Each of your Connections have "entities" corresponding to the objects of that
   data source (for BigQuery, these are tables; for Salesforce, these are objects,
   like 'Order' or 'Case').  


   You can perform CRUD operations on each entity:  

   - **Create** : creates an entity with specified field values  
   - **List** : filter-based search of entity instances  
   - **Update** : filter-based method for altering entity field values  
   - **Delete** : deletes an entity  
   - **Get** retrieves a single entity using the entityId  

   > [!NOTE]
   > **Note:** The Get operation can only be used to fetch a single record from an entity that has a primary key. It is often more practical to use the List operation with a [filterClause](https://docs.cloud.google.com/application-integration/docs/connectors-task#filter) to retrieve an entity.

   Learn more about entity CRUD operations details in the
   [Connectors docs](https://docs.cloud.google.com/application-integration/docs/configure-connectors-task.md.txt#config-prop).
2. **Connector-specific actions**   


   Many Connectors support an
   ['ExecuteCustomQuery'](https://docs.cloud.google.com/integration-connectors/docs/examples/execute-custom-query.md.txt)
   action, which allows for executing a SQL query against the data source, where
   each of the data source entities can be referenced as tables. See this list for
   [supported connectors](https://docs.cloud.google.com/integration-connectors/docs/examples/execute-custom-query.md.txt).  


   Additional actions differ based on the connector type - for example, see the
   [BigQuery connector actions](https://docs.cloud.google.com/integration-connectors/docs/connectors/bigquery/configure.md.txt#actions)
   or the
   [Salesforce connector actions](https://docs.cloud.google.com/integration-connectors/docs/connectors/salesforce/configure.md.txt#actions).

## Configuring input / output fields for CRUD operations

By selecting specific input or output fields for your connector tool action to
use, you can limit the complexity of these actions for the agent.

For example, if you only need to create an entity with a subset of its fields,
configuring this set of fields in your action simplifies the action for the
agent.

Specifying a set of output fields reduces the tool response size (helpful if
token limits are a concern) and simplifies the agent's handling of the output by
exposing only the relevant fields.

## Authentication

If the connection you're using is configured to allow
[authentication override](https://docs.cloud.google.com/application-integration/docs/configure-connectors-task.md.txt#configure-authentication-override),
then the tool can be configured to pass through credentials from specified
session parameters.

You as the agent builder are responsible for how these credentials are populated
to the session parameters and the tool will automatically pass them through to
the data source to use for authentication when the tool's actions are called.