Defining the product details of your agent

This tutorial walks you through the steps for defining specific details about your agent in Partner Center. By completing this tutorial, you accept the required agreement for agents, create your product, confirm your programmatic name, and define your catalog entry and support experience.

This tutorial is one of six in a series that demonstrates how to onboard and publish an agent to the watsonx Orchestrate and IBM Cloud catalogs. It uses a fictitious company that's called Example Corp. As you complete the tutorial, adapt each step to fit your product's needs.

Before you begin

Before you can start defining your agent details, complete the following step.

Accept the WXO CLA agreement

As a third-party provider offering an agent with a free or usage-based pricing plan, you are required to review and accept the WXO Contributor License Agreement (CLA). This agreement sets the terms under which your agent can be listed in the IBM Cloud catalog.

  1. In the IBM Cloud console, click the Navigation menu icon Navigation Menu icon > Partner Center > My company.
  2. In the Your company information section, enable the Free and usage-based agents toggle.
  3. In the Agreement section, select I have read and agree to the standard Catalog Listing Agreement.
  4. Click Save.

If your company has a custom agreement that has already been approved by IBM, select I will provide a custom agreement already approved by IBM instead.

Provide your agent name and type

To start the onboarding process, create a new product entry in Partner Center and select the agent product type.

  1. From the My products page, click Create.

  2. Select Create a product, and click Next.

  3. Click Start now.

  4. Select Agent as the product type, and click Next.

    The product type is used for tax assessment purposes. For more information, see Selling on IBM Cloud.

  5. Enter the display name of your agent, for example, Example Corp Agent 1.0.0. Make sure that the name you enter meets the following requirements:

    • Use 60 characters or less.
    • Don't include "IBM Cloud".
    • Don't include the name of your company, former product names, or pricing details.

  6. Review the programmatic name that is automatically generated based on your company name and display name. You can clear this field and enter a custom value if you prefer. Click Next.

    The programmatic name is the unique ID used to identify your agent within IBM Cloud services and tools. You can edit it until you submit your product for approval.

  7. Review your product details and click Create.

Confirm your programmatic name

After your product is created, you are prompted to confirm your programmatic name before you can proceed with the onboarding tasks. You can still edit the name at this point. After confirmation, you cannot change it.

For agents, your programmatic name is automatically approved after you confirm it. No manual review by IBM is required.

  1. From the Product details page, review the programmatic name shown in the notification banner.
  2. If you want to make changes, click Edit, update the name, and click Save.
  3. Click Confirm.
  4. In the confirmation dialog, review the programmatic name and click Confirm.

Note your IAM service ID

After you confirm your programmatic name, an operator IAM service ID is automatically generated for your agent. This service ID is used to authenticate and authorize your agent when it communicates with other IBM Cloud services, for example, when submitting metering usage data.

You are also required to create an API key for your IAM service ID. To create your API key, see Creating an API key for a service ID.

Define your catalog entry and product page

Provide details that are displayed on your catalog entry and product page when your agent is published in the IBM Cloud catalog.

  1. Click Catalog entry > Add logo, and enter the URL to your company or product logo, for example, https://svgur.com/i/TTP.svg.

  2. Provide a short description of your agent, which is displayed on your catalog entry. For example, This agent is a watsonx Orchestrate AI product offering that automates complex workflows across your enterprise tools.

  3. From the Category list, select AI / Machine Learning. Categories are used to organize products in the catalog based on common solutions, function, or use.

  4. Review the pre-seeded ai_agent keyword and add any additional keywords that users might use when searching the catalog for your agent, for example, automation, watsonx, orchestrate.

  5. Provide the URL to the end user license agreement (EULA) that users must agree to before using your agent, for example, https://examplecorp.com/legal/agent-eula.

  6. Provide a detailed description of your agent that explains its value and what users gain by using it. The detailed description is displayed at the beginning of your product page in the catalog. You can expand on the short description, but don't simply repeat it. For example, The Example Corp Agent is a watsonx Orchestrate AI product. It connects to your existing enterprise tools to automate multi-step workflows without manual intervention. By integrating with platforms such as Salesforce, ServiceNow, and Slack, the agent handles tasks like processing requests, generating reports, and routing approvals end-to-end. Designed for business and operations teams, it reduces repetitive work, improves response times, and lets your team focus on higher-value activities.

  7. Provide a list of features that highlights your agent's attributes and benefits for users.

    Use a descriptive title and 1 - 2 sentences for each feature. You want the information to be visually scannable for users.

    For the purposes of this tutorial, you can add the following example features:

    • End-to-end workflow automation: Automates complex, multi-step business processes across your connected enterprise tools, reducing manual effort and minimizing errors.
    • Pre-built integrations: Connects out of the box with popular platforms like Salesforce, ServiceNow, and Slack, so you can get started quickly without custom development.

  8. Provide links to high-quality images or videos to help illustrate what your agent does, its value, and user benefits. The supported media types are images, videos in MP4 or WebM format, and videos hosted on YouTube or Vimeo.

  9. Provide the URL to your product's documentation.

The product code and product code type fields are provided to you by your IBM Cloud onboarding specialist. Contact your onboarding specialist if you have not received these values.

Define your support experience

Provide details that help users understand how to get support if they encounter issues when they use your agent.

  1. Click Support.

  2. Select who provides support for your product: Third party or Community.

  3. Add a statement of support that describes the support you offer.

  4. Provide the URL to your support site where users can learn more about your product and get support information.

  5. Provide the URL to your service status page where customers can find information about key product events, such as planned maintenance windows.

  6. From the Add support contact methods menu, select the ways users can contact you for support.

  7. Add the locations and languages in which you provide support.

  8. For Support escalation process, provide the number of hours that customers need to wait before escalating a case, and the minimum number of hours it takes to update customers about a support escalation.

  9. For Support contacts, add the direct contact information for IBM Cloud support leaders to communicate with your product's support leaders.

    The contact information that you provide in this section is not displayed on your product's details page in the catalog.

Next steps

Onboard a broker for your agent.