Agents 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:
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.
Using the following Tools, you can create and interact with Google Docs and upload images to Google Drive through your personal Google Account. Each user will be prompted to complete the OAuth authorization flow at the time of interaction with the Agent.
- com.globant.geai.gdrive.create_docs_post: Creates a new Google Docs document with specified content.
- com.globant.geai.gdrive.upload_image: Uploads an image to Google Drive.
- com.globant.geai.gdrive.fill_blanks_google_docs: Fills out templates by replacing blank fields or marked keywords with given values.
- com.globant.geai.gdrive.read_google_docs: Reads and extracts text from an existing Google Docs document.
Login will be required interactively when chatting with the Agent:
Before configuring these Tools, you must set up the OAuth 2.0 authorization flow in your Google Cloud Project.
- Click on the project selector (top-left).
- Select an existing project or click "New Project" to create one.
- Provide a name and click "Create".
Go to APIs & Services > Library, and enable the following APIs:
* Google Drive API
* Google Docs API
- Navigate to APIs & Services > OAuth consent screen.
- Choose "External" (or "Internal" for organization-only use).
- Fill out:
- App name
- User support email
- Developer contact information
-
Under Scopes, click "Add or Remove Scopes" and add:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/documents
-
Save and finish the configuration. You may keep it in Testing mode.
- Go to APIs & Services > Credentials.
- Click "Create Credentials" > OAuth client ID.
- Choose Web application.
- Provide:
- Name: e.g., GoogleDrive OAuth 2.0 Web App - geai-app
- Authorized redirect URIs:
https://console.domain/oauth_tool_login_callback
e.g., https://console.saia.ai/oauth_tool_login_callback
- Click "Create" and save the Client ID and Client Secret.
After completing the OAuth setup, you must register the credentials in your Project inside Globant Enterprise AI.
Create a new Secret in your Project with the following content, replacing values with the ones you received:
{
"id": "globant-enterprise-ai-dev",
"name": "Gmail OAuth 2.0 Web App - globant-enterprise-ai-dev",
"type": "oauth2",
"provider": "google",
"oAuth": {
"clientId": "_INSERT YOUR CLIENT ID_",
"clientSecret": "_INSERT YOUR CLIENT SECRET_",
"authorizationUrl": "https://accounts.google.com/o/oauth2/auth",
"redirectUri": "https://console.saia.ai/oauth_tool_login_callback",
"tokenUrl": "https://oauth2.googleapis.com/token",
"scopes":
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/drive"
}
}
Notes
redirectUri must be set with the same URI that you provided in the GCP Project.
Complete your clientId and ClientSecret from the information provided in the GCP Project.
* You can also adjust the scopes in order to require less permissions.
- 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 tools.credential_oauth parameter of the Tool.
- In the Value field of the Secret, paste the full content of the JSON created above. Confirm to save the Secret.
- 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. Also, click on the Tool in the left pane to see the required Parameters. Proceed to fill the values in the Parameters column.
Both Google Drive tools require you to complete the following parameters (in the Parameters column):
- tools.credentials_oauth: The name of the Secret that stores the Oauth Credential information
- email: The email address to which the Google Drive file generated by the Tool will be sent.
Through the following Tools you can create and interact with Google Docs and upload images to Google Drive:
- com.globant.geai.gdrive_create_docs_post: Creates a new Google Docs document with specified content.
- com.globant.geai.gdrive_upload_image: Uploads an image to Google Drive.
- com.globant.geai.gdrive_fill_blanks_google_docs: Fills out templates by replacing blank fields or marked keywords with given values.
- com.globant.geai.gdrive_read_google_docs: Reads and extracts text from an existing Google Docs document.
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:
- Log in to the Google Cloud Console.
- Create a new project or select an existing one.
- Activate the following APIs for that project:
- Google Drive API
- Google Docs API
- From the side menu, go to IAM & Admin > Service Accounts and create a new service account.
- Grant the necessary roles (for example, Editor).
- 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:
- 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.
- 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.
- 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. Also, click on the Tool in the left pane to see the required Parameters. Proceed to fill the values in the Parameters column.
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.
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.
- Create an API Token, name it (for example: “Jira Tool”), and copy the token generated.
Once the previous steps have been carried out from Atlassian:
- Go to the Globant Enterprise AI Backoffice to create a Secret.
- Enter a descriptive name in the Name field. This name will be used later in the token parameter of the Tool.
- In the Value field, paste the API token value previously obtained.
- Save the secret.
- 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.
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.
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:
- Go to the Globant Enterprise AI Backoffice to create a Secret.
- Enter a descriptive name in the Name field. This name will be used later in the credentials parameter of the Tool.
- In the Value field, paste the folder path where the file will be saved in SharePoint.
- Save the secret.
- Enter Agents 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.
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).
com.globant.geai.arxiv_search: Searches for research papers on arXiv.org, an open-access repository for fields such as physics, mathematics, computer science, and more.
com.globant.geai.chat_with_rag: Allows an Agent to interact directly with one or more RAG Assistants configured in the same Project. For more information, see RAG Tool.
com.globant.geai.code_interpreter: Execute and interpret code snippets, providing immediate feedback on code execution. It is specifically tailored for Python, allowing users to input Python code and receive outputs or error messages in real-time.
com.globant.geai.create_artifact: This tool is used in a Process. It can write some generated content into an artifact (file). It returns the file-path where the artifact was stored.
com.globant.geai.create_image: Creates unique images based on text descriptions. Just type what you want, and the tool will generate an original image.
com.globant.geai.get_user_feedback: Request feedback from the user about your work. This tool is used only in Processes.
com.globant.geai.pubmed_fetch: Retrieves detailed information about research papers in PubMed using a list of paper IDs (PMIDs). It provides key details such as title, authors, abstract, publication date, and journal information. It is recommended to use it with com.globant.geai.pubmed_search.
com.globant.geai.pubmed_search: Searches for research papers in PubMed, the leading database for biomedical and life sciences literature. It returns a list of paper IDs (PMIDs) that match your query, which you can then use to fetch detailed information. It is recommended to use it in conjunction with com.globant.geai.pubmed_fetch.
com.globant.geai.read_process_artifact: This tool is used in a Process. It can read the content of a artifact (file). These files can be PDFs of plain texts.
com.globant.geai.web_scraper_httpx: Extracts information from websites. Instead of manually copying data, this tool fetches it for you and presents it in an organized format. You must provide a URL or you can use it in conjunction with com.globant.geai.web_search.
com.globant.geai.web_search: Searches the Internet for real-time information. It is useful for accessing current news, discovering events, finding local information, researching topics, and more. It is recommended to use it in conjunction with the tool com.globant.geai.web_scraper_httpx.