0 / 0

Managing agents and tools in the governed agentic catalog

Last updated: Jul 17, 2025
Managing agents and tools in the governed agentic catalog

You can share agents and tools that you create, or for which you have endpoints, by adding them to the governed agentic catalog. You can manage your agents and tools by updating them or removing them from the catalog.

Requirements

Prerequisite
The default inventory must be created by an IBM Cloud administrator. See Setting up the default inventory.
Required permissions
You must have the Admin or Editor role in the default inventory to manage agents and tools in the catalog.

Adding an agent or tool to the catalog

You can add an agent or tool to the catalog with either of these methods:

  • Add the code for the agent or tool
  • Add the endpoint for an agent or tool that is deployed on another system

Adding code for an agent or tool

You can add code for an agent or tool that other people can include in their AI service asset and deploy with watsonx.ai.

You must include the following information for the agent or tool:

Source code
Must be Python code.
Runtime engine name
Must be Python.
Framework
Must be LangGraph.
Schema
Schema format must be in JSON.

To add code for an agent or tool from the UI:

  1. From the navigation menu, go to: AI Governance > Governed Agentic Catalog, then click New Tool/Agent.
  2. Fill out the fields and click Create.

To add code for an agent or tool with the watsonx.governance API, call the register_agent() or register_tool() API. See register_agent() or register_tool().

You can edit the entry to add information, for example, benchmark metrics.

Adding an endpoint for an agent or tool

You can add an endpoint for an agent or tool that other people can include in their AI service asset and deploy with watsonx.ai.

You must include the following information for the agent or tool:

Endpoint
Enter the URL to be used for the endpoint.
Runtime engine name
Must be Python.
Framework
Must be LangGraph.
HTTP Method
Choose the type of call that you use for the endpoint.
Headers
Define the key-pair values needed for the endpoint.
Schema
Schema format must be in JSON.

To add an endpoint for an agent or tool from the UI:

  1. From the navigation menu, go to: AI Governance > Governed Agentic Catalog, then click New Tool/Agent.
  2. Fill out the fields and click Create.

Editing an agent and tool

Update the details of an existing agent or tool in the watsonx.governance UI:

  1. Select AI Governance > Governed Agentic Catalog.

  2. Select the agent and tool that you want to update and click the arrow icon to open the details page.

  3. Click the edit icon next to any editable field. You can update:

    • Summary and Description under the Overview section
    • Runtime packages and Remote services under the Dependencies section
    • Tool code, Environment variables, and Framework under the Code section

  4. Click Add Benchmark Metrics to add or modify and update the benchmarking details:

    • Benchmark datasets
    • Metrics
    • Cost (if applicable)

  5. Save the updates.

Deleting an agent or tools

You will not be able to delete an agent or tool that is currently in use. If you attempt to delete an agent or tool that is currently being used, you will receive an error message.

To delete an agent or tool in the UI::

  1. Select AI Governance > Governed Agentic Catalog.

  2. Click the three-dot menu (⋮) on the tool tile and select Delete.

  3. Type the agent and tool name and click Delete to confirm.

Note: If you delete a tool from a notebook, the agent associated with the notebook will stop working.

Parent topic: Governed agentic catalog