4.3.1 Create an Internal Tool Configuration

Create an internal tool configuration to register an internal MicroTx Workflows tool, so that you can reuse the tool in agentic workflows and AI agent profiles.

Each tool configuration stores the runtime settings needed to invoke a tool, such as the tool's endpoint URL, credentials, profile references, or tool-specific options.

Prerequisites

Before you begin creating a tool configuration, ensure the required dependencies for that category are available.

  • For Database tool, ensure that either a database profile with the required details already exists or create a new one. You will need to provide the name of the database profile while creating a database tool. See Create a Database Profile.
  • For Workflow tool, identify the list of allowed workflow names.
  • For Agent tool, define the target agent execution settings in an Agent profile. See Create an Agent Profile.
  • For RAG search tool, prepare the required RAG retrieval settings.
  • For API (HTTP) tool, ensure that the endpoint URL and required authentication details are available. For example, API key.
To create a tool configuration:
  1. Open the navigation menu and click Connectors.
  2. Click Internal Tools.

    The Internal Tools list page opens. All the internal tool configurations that you have defined are displayed in a table.

  3. Click add a new building block.
    The New Tools Config dialog box appears.
  4. In the Name box, enter a unique and descriptive name to identify this tool configuration in workflows and tasks. The name can be up to 128-characters long. Use only letters, numbers, underscores (_), and hyphens (-). Spaces and other special characters are not supported.
  5. Optional. In the Description box, provide a brief summary about the intended use of the tool configuration or any relevant details that will help others understand its purpose.
  6. In the Category drop-down list, select one of the following options to specify an appropriate category for the tool.
    • API: Select this option when an agent must call external HTTP endpoints.
      • Type: Select HTTP.
      • URL: Optional. Enter the endpoint or base URL required to access this tool. This is typically the address used for API calls or service requests.

      • API Key: Optional. If the tool requires authorization using an API key, provide the bearer token value. MicroTx Workflows encrypts and stores the provided API key. Ensure that you follow your organization's security guidelines for handling and storing sensitive credentials.

    • Database: Select this option when agent must run database operations. In the Database Profile drop-down list, select a database profile that you have created earlier to securely provide the database connection details.
    • Agent: Select this option when one agent or tool should invoke another agent profile. This is mainly used by conversational agents to invoke sub-agents as part of agent chat. In the Agent Profile drop-down list, select the target agent profile that you have created earlier. In the Input Data (JSON) field, provide the input parameters if the target agent requires any.
    • Workflow: Select this option when the tool should start the selected workflows. This is mainly used by conversational agents to invoke workflows through the tool. In the Workflow Name field, select the names of the workflows.
    • DateTime
    • Calculator
    • File: When you select this option, files are selected from the local file storage of MicroTx Workflows. The default base path of the local file storage is the value specified in the conductor.connector.storage-path property in the application.properties file.
    • RAG search: Select this option when agent must retrieve knowledge from vector or RAG store. The information for the various parameters is the same as the GENAI Retrieve Parameters. See GenAI Retrieve Task.
  7. Click Submit.
Your new tool configuration appears in the list of available tools configurations. You can reference this tool by its tool configuration name in agentic planner tasks and in agent profiles for agentic task and conversational agent.

Parent topic: Manage Internal Tool Configurations