Creating a Custom Tool

UCL lets you easily build your own custom tool groups using natural language.

Step 1: Start from UCL Setup

• Go to the Connect section in your UCL Workspace.

• Click “Define a Custom App” to launch the App Builder Assistant chat.

Step 2: Create a Tool via Prompt

Type a natural language prompt like:

“Create a tool for Google Cloud Storage.”

The assistant may detect existing tooland ask where to add this app. For example:

Would you like to add the Google Cloud Storage tool under one of these, or shall I create a new group (e.g., “GoogleCloudStorage” with OAuth2 authentication)?

You respond:

“Create a new group.”

ℹ️ Want to add to an existing tool instead? Click “Add to Existing Tool” and select the tool you'd like to edit or extend with new toolkits.

Step 3: Confirm OAuth2 Authentication Setup

The assistant will suggest an OAuth2 setup for the new tool:

{
  "baseUrl": "https://accounts.google.com/o/oauth2/auth",
  "clientId": "",
  "secret": "",
  "params": {
    "scope": "https://www.googleapis.com/auth/devstorage.read_write",
    "response_type": "code",
    "access_type": "offline",
    "prompt": "consent"
  },
  "requiredAttributes": [],
  "tenantId": "default",
  "authorization": {
    "oauthGrantType": "authCodeGrantWithGrantType",
    "accessTokenUrl": "https://oauth2.googleapis.com/token",
    "refreshTokenGrantType": "refreshTokenWithAccessType"
  }
}

Confirm when prompted:

“Yes.”

The assistant will respond:

“The ‘GoogleCloudStorage’ group is ready.”

Step 4: Add Actions to the Tool

The assistant will suggest actions to expose:

Which GCS operation would you like to expose first as a tool? For example:

• listBuckets

• getBucketMetadata

• createBucket

• deleteBucket

• listObjects

• uploadObject

• downloadObject

• deleteObject

You can respond:

“Add createBucket and listObjects.”

You’ll then receive:

The tools “createBucket” and “listObjects” have been created successfully in the “GoogleCloudStorage” group. You can now use them in your workflows.

Step 5: Finalize Setup in the Tools Section

• Navigate to the Tools section in your UCL project.

• Under Workspace Tools, find the newly created GoogleCloudStorage group.

• Click the three dots menu > Edit, and fill in the clientId and secret using your Google Cloud credentials.

• Save the configuration.

Step 6: Connect and Test with AI Agent

• Now go back to the Setup section.

• Search for your GoogleCloudStorage tool group and Connect the app by authenticating your Google account.

• Once connected, select any of the added actions (like createBucket or listObjects).

• Use the AI Agent to test your tool with a natural command:

  “Create a bucket in my Google Cloud Storage.”

Additional Prompt Ideas for creating Custom Tool

• “Create a tool for a fitness tracking app like Strava.”

• “Build a tool that pulls ticket data from our in-house Jira instance.”

• “Set up a custom tool for a REST API with POST and GET methods.”