agentconnect.core.registry.registry_base module¶

Agent registry for the AgentConnect framework.

This module provides the AgentRegistry class for agent registration, discovery, and capability matching.

class AgentRegistry(vector_search_config=None)¶

Bases: object

Central registry for agent registration and discovery.

This class provides methods for registering agents, discovering agents by capability, and verifying agent identities.

Parameters:

vector_search_config (Dict[str, Any])

async register(registration)¶

Register a new agent with verification.

Parameters:

registration (AgentRegistration) – Registration information for the agent

Return type:

bool

Returns:

True if registration was successful, False otherwise

async unregister(agent_id)¶

Remove agent from registry.

Parameters:

agent_id (str) – ID of the agent to unregister

Return type:

bool

Returns:

True if unregistration was successful, False otherwise

async get_by_capability(capability_name, limit=10, similarity_threshold=0.1)¶

Find agents by capability name.

Parameters:

• capability_name (str) – Name of the capability to search for

• limit (int) – Maximum number of results to return (default: 10)

• similarity_threshold (float) – Minimum similarity score for semantic fallback search (default: 0.1)

Return type:

List[AgentRegistration]

Returns:

List of agent registrations with the specified capability

async get_by_capability_semantic(capability_description, limit=10, similarity_threshold=0.1)¶

Find agents by capability description using semantic search.

Parameters:

• capability_description (str) – Description of the capability to search for

• limit (int) – Maximum number of results to return (default: 10)

• similarity_threshold (float) – Minimum similarity score to include in results (default: 0.1)

Return type:

List[Tuple[AgentRegistration, float]]

Returns:

List of tuples containing agent registrations and similarity scores

async get_all_capabilities()¶

Get a list of all unique capability names registered in the system.

Return type:

List[str]

Returns:

List of all capability names

async get_all_agents()¶

Get a list of all agents registered in the system.

Return type:

List[AgentRegistration]

Returns:

List of all agent registrations

async get_agent_type(agent_id)¶

Get the type of an agent.

Parameters:

agent_id (str) – ID of the agent

Return type:

AgentType

Returns:

Type of the agent

Raises:

KeyError – If the agent is not found

async get_by_interaction_mode(mode)¶

Find agents by interaction mode.

Parameters:

mode (InteractionMode) – Interaction mode to search for

Return type:

List[AgentRegistration]

Returns:

List of agent registrations with the specified interaction mode

async get_registration(agent_id)¶

Get agent registration details.

Parameters:

agent_id (str) – ID of the agent

Return type:

Optional[AgentRegistration]

Returns:

Agent registration if found, None otherwise

async get_by_organization(organization_id)¶

Find agents by organization.

Parameters:

organization_id (str) – ID of the organization

Return type:

List[AgentRegistration]

Returns:

List of agent registrations in the specified organization

async get_verified_agents()¶

Get all verified agents.

Return type:

List[AgentRegistration]

Returns:

List of verified agent registrations

async verify_agent(agent_id)¶

Verify an agent’s identity.

Parameters:

agent_id (str) – ID of the agent to verify

Return type:

bool

Returns:

True if verification was successful, False otherwise

async update_registration(agent_id, updates)¶

Update agent registration details.

Parameters:

• agent_id (str) – ID of the agent to update

• updates (Dict) – Dictionary of updates to apply

Return type:

Optional[AgentRegistration]

Returns:

Updated agent registration if successful, None otherwise

async get_by_owner(owner_id)¶

Find agents by owner.

Parameters:

owner_id (str) – ID of the owner

Return type:

List[AgentRegistration]

Returns:

List of agent registrations owned by the specified owner

async verify_owner(agent_id, owner_id)¶

Verify if a user owns an agent.

Parameters:

• agent_id (str) – ID of the agent

• owner_id (str) – ID of the owner

Return type:

bool

Returns:

True if the user owns the agent, False otherwise