Table of contents
Official Content
  • This documentation is valid for:

Globant Enterprise AI Lab provides Public Tools in every project. These Public Tools are preconfigured and available by default for use when defining Agents.

Refer to the following dialog:

AI Lab Public Tools

You can access this dialog from the AI & Tools Tab of an Agent by going to the Agents & Tools to use section and clicking on + Add.

In this specific case, a filter has been applied to display only Public Tools. Therefore, in the left pane, you can see the list of tools starting with com.globant.geai, which correspond to Public Tools.

Some Public Tools require custom configuration to work properly. These tools are marked with a warning icon, indicating that setup is required before they can be used.

Below is a list of Public Tools that require configuration, along with the specific settings needed for each.

Google Drive Tools

Through the following Tools you can create Google Docs and upload images to Google Drive:

  • com.globant.geai.gdrive_create_docs_post
  • com.globant.geai.gdrive_upload_image

Before configuring these Tools, you have to go to the Google Cloud Platform to get a JSON file that stores the service account credentials. To achieve this, proceed as follows:

  1. Log in to the Google Cloud Console.
  2. Create a new project or select an existing one.
  3. Activate the following APIs for that project:
    • Google Drive API
    • Google Docs API
  4. From the side menu, go to IAM & Admin > Service Accounts and create a new service account.
  5. Grant the necessary roles (for example, Editor).
  6. In the created service account, go to the Keys tab and create a new key in JSON format and download the file. This file contains the credentials needed to authenticate requests.

This JSON file will be used later.

Once the previous steps have been carried out from the Google Cloud Platform:

  1. Go to the Globant Enterprise AI Backoffice to create a Secret. Enter a descriptive name in the Name field (for example 'gdrives'). This name is the one that will be later referenced in the credentials parameter of the Tool.
  2. In the Value field of the Secret, paste the full content of the JSON file downloaded from Google Cloud Platform (containing the service account credentials). Confirm to save the Secret.
  3. Inside the Agent you are creating, go to the AI & Tools Tab, select the Agents & Tools to use section and click on + Add. In the left pane, select the desired Tool (com.globant.geai.gdrive_create_docs_post or com.globant.geai.gdrive_upload_image). Also, click on the Tool in the left pane to see the required Parameters. Proceed to fill the values in the Parameters column.

Parameters

Both Google Drive tools require you to complete the following parameters (in the Parameters column):

  • credentials: The name of the Secret that stores the service account credentials in JSON format (in this example, the Secret name is 'gdrives').
  • email: The email address to which the Google Drive file generated by the Tool will be sent.

Jira Tool

Through the following Tool you can create Jira tickets:

  • com.globant.geai.jira_ticket_insert

Before configuring this Tool, you have to get required information from the Atlassian platform. To do so, follow the steps below:

  • Go to Atlassian API Tokens and log in.
  • Click on Create a classic API Token, name it (for example: “Jira Tool”), and copy the token generated.

Once the previous steps have been carried out from Atlassian:

  1. Go to the Globant Enterprise AI Backoffice to create a Secret.
  2. Enter a descriptive name in the Name field. This name will be used later in the token parameter of the Tool.
  3. In the Value field, paste the API token value previously obtained.
  4. Save the secret.
  5. Inside the Agent you are creating, go to the AI & Tools Tab, select the Agents & Tools to use section and click on + Add. In the left pane, check the desired tool (com.globant.geai.jira_ticket_insert). Also, click on the Tool in the left pane to see the required Parameters, and proceed to fill in the values in the Parameters column.

Parameters

This Tool requires you to complete the following parameters (in the Parameters column):

  • url: Your Jira workspace URL (for example: https://genexus-team.atlassian.net/).
  • username: The email address you use to access your Jira account.
  • token: The name of the Secret that stores the API token you generated in Atlassian.
  • projectKey: To find your Jira project key (needed to create tickets), follow the steps below:

    • Go to: https://organization.atlassian.net/jira/projects/
      • Replace organization with the name of your Jira workspace or company account.
    • You’ll see a list of all your Jira projects.
    • Look for the "Key" column, this shows the project key you need.
      • Note: The project name is not the same as the project key, so make sure you're using the correct one.

SharePoint Tools

Through the following Tools you can create a Word document and upload images in SharePoint:

  • com.globant.geai.sharepoint_create_word
  • com.globant.geai.sharepoint_upload_image

Before configuring the Tool, make sure to prepare the required credentials in JSON format. The structure should look as follows:

{
"client_id": "your-microsoft-email",
"client_secret": "your-password",
"sharepoint_url": "https://your-domain.sharepoint.com/sites/your-site"
}

Note that "client_id" and "client_secret" values correspond to the SharePoint user credentials. Remember to indicate your-domain and your-site for the "sharepoint_url" value.

Once the previous steps have been carried out:

  1. Go to the Globant Enterprise AI Backoffice to create a Secret.
  2. Enter a descriptive name in the Name field. This name will be used later in the credentials parameter of the Tool.
  3. In the Value field, paste the folder path where the file will be saved in SharePoint.
  4. Save the secret.
  5. Enter Globant Enterprise AI Lab and inside the Agent you are creating, go to the AI & Tools Tab, select the Agents & Tools to use section and click on + Add. In the left pane, select the desired Tool (com.globant.geai.sharepoint_create_word or com.globant.geai.sharepoint_upload_image). Also, click on the Tool in the left pane to see the required Parameters. Proceed to fill the values in the Parameters column.

Parameters

Both SharePoint Tools require you to complete the following parameters (in the Parameters column):

  • credentials: Name of the Secret that stores the SharePoint access data in JSON format.
  • path: Folder structure where the file will be saved in SharePoint (for example, /sites/your-site/Shared Documents/your_folder/another_folder).

Availability

Since April 2025 release.

Last update: March 2025 | © GeneXus. All rights reserved. GeneXus Powered by Globant