Activate agents

Edit online

After deploying the agents, activate the foundational agents to make them available for managing conversations in the chat interface.

Procedure

  1. Log in to the watsonx Assistant for Z Management Console.
  2. From the Chat interface, click the three vertical dots in the upper-right corner, then select Agents.
    The Agent Registrations page is displayed, showing all the registered agents.
  3. Locate the agent you want to activate and select the Configure icon on its card.
    The Agent Configuration appears.
  4. Activate the agent by providing the required details in the Agent Configuration window.
    IBM Z Upgrade agent
    Follow these steps for the IBM Z Upgrade agent.
    1. Create a new connection by following the steps described in Configure agent connection.
    2. Connection: Click the edit icon and select the connection you created.
    3. Endpoint: The URL through which the agent is accessed.
    4. API Key: The authentication key used to securely connect to the agent.
    5. Status: Activates or deactivates the agent. Set to Active to make the agent available for use.
    zRAG agent
    Follow these steps for the zRAG agent:
    1. Connection: Ensure that zRAG Retriever Connection is selected.
    2. Endpoint: The URL through which the agent is accessed.
    3. API Key: The authentication key used to securely connect to the agent.
    4. Status: Activates or deactivates the agent. Set to Active to make the agent available for use.
    Other agents
    Follow these steps for the rest of the agents:
    1. Endpoint: The URL through which the agent is accessed.
    2. API Key: The authentication key used to securely connect to the agent.
    3. Status: Activates or deactivates the agent. Set to Active to make the agent available for use.
    The following table lists the endpoints for each agent.
    Agent name Endpoint

    URL format: http://<container-name>:<container-port>/<sub-urls>

    		 Is the API key mandatory? Connection required?
    IBM Z Support http://wxa4z-support-agent:8000/v1/tls_chat Yes Optional
    IBM Z Workload Scheduler Insights http://wxa4z-workload-scheduler-agent:8050/v1/aiops_chat Yes Optional
    IBM Z OMEGAMON Insights http://wxa4z-omegamon-insight-agent:8050/v1/aiops_chat Yes Optional
    IBM Z Upgrade http://wxa4z-upgrade-agent-mcp-client:8000/v1/upgrade_chat Yes Yes

    (Follow the steps for the IBM Z Upgrade agent in Step 4)
    BM Z Automation Insights http://wxa4z-automation-insight-agent:8050/v1/aiops_chat Yes Not applicable
    zRAG http://wxa4z-zrag-external-agent:8000/v1/chat/completions Yes Yes

    (Follow the steps for the zRAG agent in Step 4)
    Important:
    • The API key must match the AGENT_AUTH_TOKEN defined in the respective .env file for each agent.
    • The agent must be activated before performing any chat operations.
    • The endpoints are default system URLs and must not be modified.
  5. Click Save to apply the configuration and activate the agent.