Registering an agent
Agent registration captures the agent’s metadata and intent. This step does not include credentials or runtime configuration.
Registration captures metadata only. Runtime configuration (LLM, connections, and credentials) is defined later during deployment.
Interaction modes
You can choose to integrate agents that are native to the platform or use external ones. It also helps you manage, govern, and clearly find and execute your agents.
- Define the interaction model of the agent:
- Conversational Agents: Designed for user interaction via prompts/questions
- Non‑Conversational Agents: Created for background workflows, automation, or API-triggered execution; this is not directly accessible to end users in conversational interfaces.
- Define where the agent executes:
- Bridge-hosted agents
- External-hosted agents (executed via external APIs like WatsonX or others)
Registering and agent from an existing repository
Upload a file for bulk agent registration. Use file upload for registering multiple agents at once.
- Locate the manifest.json file within your repository. This file typically contains essential metadata and configuration details for the agent you wish to import.
Source: GitHub kyndryl-agentic-ai org → bdg-sw-agents--base repo → config/ directory
- Review the file and update account-specific fields:
- tenant_id — the account's Bridge tenant ID
- connection_ids — map to the connections created
- access_group_id — map to the access group
- service_id — map to the Service ID
- knowledge_base_id — map to the knowledge base (if applicable)
- llm_api_key_id — map to the API key
- Once the information is correct, go to the Agent Library page, and select Register
- Select the File Upload option
- Select the manifest.json file from your local system
- Click Upload
After uploading, the system will process the file, extracting the necessary information to integrate the agent into the library seamlessly.
Manual registration
Single registration is the manual process to register an agent.
- From the Agent Library page, select Register
- Select Single Registration
Basic information
- Type: Select Agent or Agentic Solution
- Name: Enter a unique name for the agent
- Version: Enter the version number
- Description: Add a short description
- Owner: Enter the agent owner
- Maintaining Team: Enter the team responsible for updates
- Tags: Add tags separated by a comma.
- Technology Framework: Select the framework used
- Summary: Enter a summary of the agent’s purpose.
Select Next to continue.
Skills
- Skill Name: Enter a unique skill name.
- Skill Description: Add a short description.
Select Add Skill to add more or Next to continue.
Configurations
- LLM
- Configuration: Select LLM configuration
- LLM Model: Select model
- Knowledge Base
- Configuration: Select Global or Private
- Knowledge Base: Select a knowledge base
- MCP
- MCP Server: Select MCP server
- MCP Tool: Select MCP tool
- Connector
- Type: Select connector type
Select Next to continue.
Schema
- Enter input and output schema
- Or select Default
Select Next to continue
Source of agent
- GitHub Repository URL: Enter GitHub repository URL
- Branch: Enter repository branch
- Manifest Path: Enter manifest path.
Select Next to continue.
Flow configuration
Agentic Solution only
- Enter JSON or YAML flow.
Select Next to continue.
Review and submit
Review all information and select Submit.