Equinix Agent Factory

• search_routers: Searches for an existing fabric cloud router.
• get_stream_alert_rule_details : Searches for an existing alert rule.
• get_next_available_router_package : Fetches the next available Fabric Cloud Router package based on a package input.
• update_router: Update router. Used to upgrade the fabric cloud router.

It identifies every connection sharing the alerting metro pair, of any connection type. For the subset whose A-side is a Fabric Cloud Router (FCR), it runs a targeted live ping for connectivity readings; other connection types (for example port-to-port or IPWAN-to-port) have no BGP peer to ping and are skipped for this check, with the gap noted in the brief. Bandwidth/utilization headroom is checked for every connection in the blast radius regardless of type. From those per-connection signals, weighed against the shared metro-latency backdrop, it classifies whether the spike is isolated to one connection or metro-wide. It then emails a one-page incident brief with a clearly-labeled likely contributing factor and a recommended next-best action. This agent is diagnostic only. It never modifies a connection, route, or bandwidth setting, and recommendations are for the NOC to action manually.

• get_timestamps: Generates from and to UTC timestamps (ISO 8601) from a duration string (e.g. "1h", "6h"). Used to establish the recent lookback window for this agent.
• get_stream_alert_rule_details: Fetches the full details of an alert rule (thresholds, window size). Takes the stream UUID and the alert-rule UUID as two separate arguments — both are parsed from data.alertRule on the event.
• search_connections: Searches for connections by A-side/Z-side metro code to resolve the blast radius, and resolves provisioned bandwidth and A-side router UUID per connection.
• list_routing_protocols: Fetches routing protocols for a connection; used to read the BGP customerPeerIp as the default FCR ping destination.
• create_router_commands: Initiates a PING command on a Fabric Cloud Router by UUID.
• search_router_commands: Searches for commands (e.g. PING) on a Fabric Cloud Router.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• search_metrics: Retrieves connection bandwidth-usage and metro-latency time series over the lookback window.
• get_metric: Retrieves a single metric series when a targeted lookup is needed.
• send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.

This agent only executes once.

• search_connections: Searches for an existing connection `.
• get_stream_alert_rule_details : Searches for an existing alert rule.
• update_connection: Update connection. Used to upgrade bandwidth.
• get_next_available_bandwidth_tier : Fetches the next available billing tier based on a bandwidth input.

This agent only executes once.

• search_connections: Searches for an existing connection.
• get_stream_alert_rule_details: Searches for an existing alert rule.
• update_connection: Update connection. Used to upgrade bandwidth.
• get_next_available_bandwidth_tier: Fetches the next available billing tier based on a bandwidth input.

When bandwidth utilization on a primary connection reaches a configured threshold, the agent automatically upgrades the secondary connection to match the primary connection's bandwidth, ensuring consistent performance across the redundant pair. This agent only executes once.

• search_connections: Searches for an existing connection.
• get_stream_alert_rule_details: Searches for an existing alert rule.
• update_connection: Update connection. Used to upgrade bandwidth.

Differs from asset-pending-state-tracker and connection-pending-state-tracker: this agent applies separate configurable timeouts for PROVISIONING vs. DEPROVISIONING, and enriches each stuck connection/port with its most recent related cloud event for extra context.

• search_routers: Searches for fabric cloud routers.
• search_ports: Searches for ports.
• search_cloud_events_by_asset: Retrieves recent cloud events for a given connection or port UUID. Not supported for routers.
• get_timestamps: Generates from and to UTC timestamps based on a duration string (e.g., "24h"). Use the to field as the current UTC time reference for calculating elapsed minutes. Do not compute or hardcode the current time manually.
• wait: Wait for a while before retrying a failed search call. An optional parameter can be provided to specify the wait time in milliseconds.
• send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.

• search_routers: Searches for existing provisioned Fabric Cloud Routers with pagination support.
• list_streams: Lists all streams available in the account.
• search_attached_assets: Returns all routers attached to a given stream UUID.
• attach_stream_asset: Attaches a router to a stream by asset UUID and stream UUID with "metrics_enabled": false.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification to a list of recipients with an optional PDF attachment.

This agent runs once immediately by default unless scheduled by user.

• search_connections: Searches for provisioned FCR connections filtered by bandwidth.
• list_routing_protocols: Lists all routing protocols for a given connection.
• replace_routing_protocol: Replaces a routing protocol configuration; used here to enable BFD on an existing BGP session while preserving all other fields.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification with an optional PDF report.

The agent is set up BGP routing protocol using ASN, BFD enabled, or MD5 authentication. This agent runs once immediately by default unless scheduled by user.

• search_connections: Retrieves connection details.
• list_routing_protocols: Retrieves existing routing protocols for a connection.
• create_routing_protocol: Creates a routing protocol for the target connection.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification.

This run is initiated by schedule and discovers unhealthy sessions from live API state rather than from a triggering BGP status event.

Because BGP is a self-healing protocol, the agent first waits and observes for a bounded grace period before attempting any restart. It attempts exactly one remediation tier per affected session/address family: a soft restart by toggling the routing protocol address family's enabled flag (disable, then re-enable). It never retries this toggle in the same run, never performs peer reset, and never performs path failover.

This agent runs once immediately by default unless scheduled by the user. It sends at most one batched email report at the end of a run: always when unhealthy BGP sessions are detected, and optionally on clean runs when send_email_on_clean_run is enabled.

All tool-facing request details that matter for execution — including the search_connections filter shape, the search_cloud_events filter operators, and the HTML report template — are intentionally kept explicit below and should be preserved.

• search_connections: Finds connections by UUID or by scoped filter and reads connection state.
• list_routing_protocols: Reads routing protocols for a connection, including state, family enabled, and operation status fields.
• get_timestamps: Produces UTC from/to timestamps from a duration (for flap-storm lookback).
• search_cloud_events: Counts recent BGP status events for a connection to detect flap storms. Use /equinixproject with = plus /subject with IN and /type with LIKE.
• update_routing_protocol: Applies JSON Patch operations for enabled toggles.
• wait: Sleeps between checks and restart phases.
• send_email_notification: Sends exactly one batched email report with attached PDF.

This agent runs once immediately by default unless scheduled by user.

• search_routers: Searches for existing cloud routers. Used to check for duplicates and to confirm post-creation status.
• create_router: Creates a new Fabric Cloud Router with the specified configuration.

Once the PING operation is completed, the resulting output is collected and used to generate an email notification. The email is then sent to the specified recipient, ensuring that the results of the connectivity test are communicated clearly and promptly. This agent runs once immediately by default unless scheduled by user.

• search_routers: Searches for an existing fabric cloud router.
• search_connections: Searches for an existing connection.
• create_router_commands: Initiate a PING command on a Fabric Cloud Router by UUID.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• search_router_commands: Search for commands (e.g., PING) on a Fabric Cloud Router.
• send_email_notification: Sends an email notification given a list email of addresses and email body.

The agent analyzes the router's active route table entries and suggests an optimized set of aggregate (supernet) IPv4 routes to simplify route advertisement and reduce route table size. A router UUID is required, and a connection UUID is optional but recommended for more accurate, connection-scoped aggregation. This agent runs once immediately by default unless scheduled by user.

• search_routers: Searches for an existing Fabric Cloud Router. Used to confirm the router UUID before generating recommendations.
• search_routes: Searches the routing table of a Fabric Cloud Router. Use route_type = active to retrieve the router's active route table entries, optionally scoped to a connection via connection_uuid. Each returned route exposes a prefix field (the CIDR entry) to feed into aggregation.
• recommend_route_aggregation: Recommends or suggests aggregate routes. Given a list of route prefixes (routePrefixes) and an optional connectionUuid, it excludes IPv6 prefixes, performs deterministic CIDR aggregation on the IPv4 prefixes, and returns the recommended aggregate IPv4 routes.

Once the TRACEROUTE operation is completed, the resulting output is collected and used to generate an email notification. The email is then sent to the specified recipient, ensuring that the results of the connectivity test are communicated clearly and promptly. This agent runs once immediately by default unless scheduled by user.

• search_routers: Searches for an existing fabric cloud router.
• search_connections: Searches for an existing connection.
• create_router_commands: Initiate a TRACEROUTE command on a Fabric Cloud Router by UUID.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• search_router_commands: Search for commands (e.g., TRACEROUTE) on a Fabric Cloud Router.
• send_email_notification: Sends an email notification given a list email of addresses and email body.

When the route usage exceeds a predefined threshold, the agent automatically upgrades the Fabric Cloud Router package to ensure sufficient capacity and uninterrupted operation. This agent runs once immediately by default unless scheduled by user.

• search_routers: Searches for an existing fabric cloud router.
• get_next_available_router_package : Fetches the next available Fabric Cloud Router package based on a package input.
• update_router: Update router. Used to upgrade the fabric cloud router.

• search_connections: Searches for existing provisioned Fabric Connections with pagination support.
• list_streams: Lists all streams available in the account.
• search_attached_assets: Returns all connections attached to a given stream UUID.
• attach_stream_asset: Attaches a connection to a stream by asset UUID and stream UUID with "metrics_enabled": true.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification to a list of recipients with an optional PDF attachment.

This agent helps troubleshooting effort so it can be prioritized where it matters most. The result is delivered as a PDF scorecard via email. This agent is advisory only. It reads telemetry and writes recommendations into a report; it never modifies a connection, its bandwidth, or its rate limit. This agent runs once immediately by default unless scheduled by user.

• get_timestamps: Generates from and to UTC timestamps (ISO 8601) from a duration string (e.g. "24h", "7d").
• search_connections: Enumerates PROVISIONED connections and resolves per-connection context (A-side and Z-side port UUIDs, provisioned bandwidth).
• search_metrics: Retrieves connection and port metrics over the scoring window.
• get_metric: Retrieves a single metric series when a targeted lookup is needed.
• send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.

This agent runs once immediately by default unless scheduled by user. Recommended schedule: every 4 hours. Only sends email if connections exceed the timeout threshold.

• get_timestamps: Generates from and to UTC timestamps based on a required duration string (e.g., "24h", "7d"). to is always the current UTC time; from is to minus the duration. Use the to field as the current UTC time reference for calculating time-in-state. Do not compute or hardcode the current time manually.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.

This agent runs once immediately by default unless scheduled by user.

• search_connections: Searches for an existing connection.
• update_connection: Update connection. Used to upgrade bandwidth.
• get_next_available_bandwidth_tier : Fetches the next available billing tier based on a bandwidth input.

• create_network: Creates a Fabric Network. Accepts name, type (IPWAN), scope (REGIONAL or GLOBAL), location (region or metro code), notifications (mandatory), and project UUID.
• search_networks: Searches for existing Fabric Networks by filter.
• create_router: Creates a Fabric Cloud Router. Accepts name, location (metro code), package, billing account number, notifications (mandatory), and project UUID.
• search_routers: Searches for existing Fabric Cloud Routers by filter to check provisioning state.
• create_connection: Creates a connection. Used to create IPWAN connections between a Cloud Router and a Network. Accepts notifications.
• search_connections: Searches for existing connections to verify provisioning state.
• get_stream_details: Fetches stream details given a stream UUID.
• create_stream: Creates a new stream given a name and project UUID.
• attach_stream_asset: Attaches a resource (router or connection) to a stream by UUID. Networks cannot be attached to a stream.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification to a list of recipients with an optional PDF attachment.

• search_ports: Searches for existing provisioned Fabric Ports with pagination support.
• list_streams: Lists all streams available in the account.
• search_attached_assets: Returns all ports attached to a given stream UUID.
• attach_stream_asset: Attaches a port to a stream by asset UUID and stream UUID with "metrics_enabled": true.
• wait: Waits for a specified number of milliseconds before the next action.
• send_email_notification: Sends an email notification to a list of recipients with an optional PDF attachment.

This agent runs once immediately by default unless scheduled by user. Recommended schedule: every 4 hours. Only sends email if ports exceed the timeout threshold.

• get_timestamps: Generates from and to UTC timestamps based on a required duration string (e.g., "24h", "7d"). to is always the current UTC time; from is to minus the duration. Use the to field as the current UTC time reference for calculating time-in-state. Do not compute or hardcode the current time manually.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.

• search_connections: Searches for an existing connection.
• get_stream_details: Fetches stream details given a stream uuid.
• create_stream: Create a stream.
• attach_stream_asset: Attach a resource to a stream.
• create_stream_alert_rule: Create an alert rule given a stream uuid.
• wait: Wait for a while. An optional parameter can be provided to specify the wait time in milliseconds.
• send_email_notification: Sends an email notification given an email address and email body.