Skip to content

equinix/agent-factory

Repository files navigation

Equinix Agent Factory

Equinix published md agents

Definitive "source of truth" for the Equinix Agent Factory

Equinix Agent Factory in this repository

The following md files are supported for Equinix Agent Factory


Equinix Fabric On-Event

Equinix Fabric Agent Factory Event-Driven Scenarios

Name Overview Capabilities Agent Tools Release Status
Cloud Router Monitoring and Upgrade Package Agent
[cloud-router-upgrade-package.md]
An Equinix agent that continuously monitors route usage on a Fabric Cloud Router. 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 only executes once. - Continuously monitor real-time network event streams to maintain visibility into network activity and performance.
- Detect and evaluate alerts triggered when route usage reaches or exceeds defined threshold limits.
- Automatically upgrade Fabric Cloud Router packages as needed to ensure adequate capacity and prevent service disruption.
- Record and log all actions, decisions, and system events for auditing, troubleshooting, and analysis purposes.
- Send timely notifications for critical events to ensure stakeholders are informed and can respond promptly.
This skill can use the following tools:
  • 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.
preview
Connection Packet Drop Monitoring and Upgrade Agent
[connection-upgrade-bw-on-packet-drop-alert.md]
An Equinix agent that automatically boosts connection bandwidth to mitigate traffic-induced packet loss.

This agent only executes once.

- Monitor real-time network event streams
- Detect packet drop alerts
- Analyze connection utilization patterns
- Automatically upgrade connection bandwidth
- Log all actions and decisions
- Send notifications for critical events
This skill can use the following tools:

  • 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.
preview
Connection Bandwidth Monitoring and Upgrade Agent
[connection-upgrade-bw-primary.md]
An Equinix agent that automatically upgrades the bandwidth of a connection when usage reaches a certain threshold.

This agent only executes once.

- Monitor real-time network event streams
- Detect bandwidth threshold alerts
- Analyze connection utilization patterns
- Automatically upgrade connection bandwidth
- Log all actions and decisions
- Send notifications for critical events
This skill can use the following tools:

  • 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.
preview
Connection Bandwidth Monitoring and Upgrade Redundant Connection Agent
[connection-upgrade-bw-secondary.md]
This automated agent monitors Equinix Fabric connections and maintains bandwidth parity between redundant connection pairs.

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.

- Monitor real-time network event streams
- Detect bandwidth threshold alerts
- Analyze connection utilization patterns
- Automatically upgrade connection bandwidth
- Log all actions and decisions
- Send notifications for critical events
This skill can use the following tools:

  • 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.
preview
Metro Latency Spikes and Connections Over Metros Report Agent
[metro-latency-notify.md]
An Equinix agent that automatically email a list of connections that are over the metros where latency spike. - Detect metro latency alerts
- Identify the source and destination metros
- Identify the active connections over the metros
- Email notification with the connections list
- Log all actions and decisions
This skill can use the following tools:
  • search_connections: Searches for active connections with aside and zside metro codes
  • send_email_notification: Sends an email notification given an email address and email body.
  • preview

    Equinix Fabric On-Schedule

    Equinix Fabric Agent Factory On Schedule and On Demand Scenarios

    Name Overview Capabilities Agent Tools Release Status
    Alert Rule Manager Agent
    [alert-rule-management.md]
    An Equinix agent that sets up an alert rule for a connection. This agent runs once immediately by default unless scheduled by user. - Automatically creates an alert rule based on user-defined parameters
    - Instantly creates a stream if one does not exist and attaches the resource to it
    - Log all actions and decisions
    This skill can use the following tools:
    • 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.
    preview
    Daily Asset Change Report Agent
    [asset-change-daily-logger.md]
    Identify connections, ports, cloud routers, networks, internet access, and network edge change events in past 24 hours; compile change summary with owners and distribute a daily report. - Analyze all cloud events within a given Equinix Fabric project over the past 24 hours
    - Deliver a plain-English daily report for changed assets summary via email as a summarized report in PDF format
    - **`get_timestamps`**: Generates `from` and `to` UTC timestamps based on a duration string (e.g., `"24h"`, `"7d"`, `"1M"`). Returns a JSON object with `from` and `to` as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
    • search_cloud_events: Searches Equinix Fabric cloud events. Use /equinixproject = with /time >= and <= to scope by project and time window.
    • send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.
    preview
    Daily Asset Creation Report Agent
    [asset-create-daily-report.md]
    Identify connections, ports, cloud routers, networks, internet access, and network edge creation events in past 24 hours; compile creation summary with owners and distribute a daily report. - Analyze all cloud events within a given Equinix Fabric project over the past 24 hours
    - Deliver a plain-English daily report for created assets summary via email as a summarized report in PDF format
    - **`get_timestamps`**: Generates `from` and `to` UTC timestamps based on a duration string (e.g., `"24h"`, `"7d"`, `"1M"`). Returns a JSON object with `from` and `to` as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
  • search_cloud_events: Searches Equinix Fabric cloud events. Use /equinixproject = with /time >= and <= to scope by project and time window.
  • send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.
  • preview
    Asset Pending State Tracker Agent
    [asset-pending-state-tracker.md]
    This agent actively analyzes the lifecycle state of Equinix Fabric assets to identify those stuck in provisioning or deprovisioning phases for an extended period, proactively notifying user.

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

    - Analyze all pending connections, ports, and routers over a specified time range
    - Deliver a plain-English summary via email as a PDF report
    - search_connections: Searches for connections.

    • search_routers: Searches for fabric cloud routers.
    • search_ports: Searches for ports.
    • send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.
    preview
    Cloud Router BGP Bootstrap Provisioner Agent
    [cloud-router-bgp-boostrap-provisioner.md]
    This agent targets a connection that is pending interface configuration, sets up a standard BGP routing protocol (ASN, BFD enabled, MD5 authentication), and sends a completion notification with final execution outcome.

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

    - Detect new or updated connections missing routing protocol configuration
    - Create a baseline BGP routing protocol with required defaults
    - Enable BFD as part of the standard BGP profile
    - Configure MD5 authentication for BGP sessions
    - Send completion notifications with success/failure outcomes
    This skill can use the following tools:

    • 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.
    preview
    Cloud Router Ping and Report Agent
    [cloud-router-ping-and-notify.md]
    An Equinix agent that initiates a PING command on a Fabric Cloud Router in order to perform a network connectivity check.

    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.

    - PING command on Fabric Cloud Router
    - Email notification with PING results
    - Log all actions and decisions
    This skill can use the following tools:

    • 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.
    preview
    Cloud Router Route Aggregation Recommendation Agent
    [cloud-router-route-aggregation-recommendation.md]
    This definition sets up and activates an Equinix agent that recommends, or suggests, aggregate routes for a Fabric Cloud Router (also referred to as FCR or router).

    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.

    - Recommend an optimized set of aggregate (supernet) IPv4 routes for a Fabric Cloud Router based on its active route table entries.
    - Optionally scope the recommendation to a specific connection on the router for higher accuracy.
    - Record and log all actions, decisions, and system events for auditing, troubleshooting, and analysis purposes.
    This skill can use the following tools:

    • 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.
    preview
    Cloud Router Traceroute and Report Agent
    [cloud-router-traceroute-and-notify.md]
    An Equinix agent that initiates a TRACEROUTE command on a Fabric Cloud Router in order to perform a network connectivity check.

    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.

    - TRACEROUTE command on Fabric Cloud Router
    - Email notification with TRACEROUTE results
    - Log all actions and decisions
    This skill can use the following tools:

    • 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.
    preview
    Cloud Router Upgrade Package Agent
    [cloud-router-upgrade-package.md]
    This definition sets up and activates an Equinix agent that upgrades the package of a Fabric Cloud Router.

    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.

    - Automatically upgrade Fabric Cloud Router packages as needed to ensure adequate capacity and prevent service disruption.
    - Record and log all actions, decisions, and system events for auditing, troubleshooting, and analysis purposes.
    This skill can use the following tools:

    • 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.
    preview
    Connection Health Scorecard Agent
    [connection-health-scorecard.md]
    This agent gives operators a single-pane health view across Equinix Fabric connections. It collects per-connection performance metrics, computes a composite 0–100 health score for each connection, ranks them, flags any connection with an obvious measurable issue, and recommends remediation for every flagged connection — so troubleshooting effort can be prioritized where it matters most. The result is delivered as a PDF scorecard via email.

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

    - Enumerate all PROVISIONED connections (or a user-specified subset)
    - Collect rate-exceeded packet drops, packet errors, utilization, and latency metrics per connection
    - Compute a reproducible composite 0–100 health score per connection
    - Rank all connections and flag any with an obvious measurable issue
    - Recommend concrete remediation for every flagged connection
    - Deliver a prioritized scorecard as a PDF report via email
    This skill can use the following tools:

    • 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 connection context (A/Z ports, A/Z metro codes, provisioned bandwidth).
    • search_metrics: Retrieves connection, port, and metro 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.
    preview
    Connection Pending State Tracker Agent
    [connection-pending-state-tracker.md]
    This agent analyzes the lifecycle state of Equinix Fabric connections to identify those stuck in provisioning or deprovisioning state longer than a configured threshold, proactively notifying the user when action may be needed.

    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.

    - Search for all connections currently in a pending (provisioning or deprovisioning) state
    - Deliver a plain-English summary via email
    - search_connections: Searches for connections.

    • 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.
    preview
    Connection Bandwidth Upgrade Agent
    [connection-upgrade-bw-primary.md]
    An Equinix agent that upgrades the bandwidth of a connection.

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

    - Automatically upgrade connection bandwidth
    - Log all actions and decisions
    This skill can use the following tools:

    • 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.
    preview
    GCP Monitoring Agent
    [gcp-monitoring.md]
    An Equinix agent that sends gcp monitoring metrics to an email.

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

    - An automated monitoring solution utilizing an Equinix-hosted agent to track and transmit real-time GCP performance metrics.
    - This system is designed to provide stakeholders with regular visibility into cloud health by delivering comprehensive metric reports directly to designated email recipients.
    This skill can use the following tools:

    • list_timeseries: Lists time series data from the Google Cloud Monitoring API.
    • send_email_notification: Sends an email notification given a list email of addresses and email body.
    preview
    Project Lifecycle Activities Insight Report Agent
    [project-lifecycle-activities.md]
    This reporting agent analyzes all cloud events within a given Equinix Fabric project over a specified time range and delivers a plain-English operational health summary report via email. This agent runs once immediately by default unless scheduled by user. - Analyze all cloud events within a given Equinix Fabric project over a specified time range
    - Detect BGP/routing instability, provisioning churn, and critical events
    - Deliver a plain-English operational health summary via email as a summarized report in PDF format
    - **`get_timestamps`**: Generates `from` and `to` UTC timestamps based on a duration string (e.g., `"24h"`, `"7d"`, `"1M"`). Returns a JSON object with `from` and `to` as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
    • search_cloud_events: Searches Equinix Fabric cloud events. Use /equinixproject = with /time >= and <= to scope by project and time window.
    • send_email_notification: Sends an email. Pass pdfTitle and pdfContent (plain text) to auto-generate and attach a PDF.
    preview
    Stream Attachment Connection Finder Agent
    [stream-attachment-connection-finder.md]
    An Equinix agent that automatically detects new connections older than a certain amount of time and ensures they are at least connected to the default stream. - Detect older connections that are not attached to any stream
    - Attach such connections to the default stream
    - Email notification of this action to the user
    - Log all actions and decisions
    This skill can use the following tools:
    • get_timestamps: Generates from and to UTC timestamps based on a duration string (e.g., "24h", "7d", "1M"). Returns a JSON object with from and to as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
    • search_connections: Search for any connections that are already provisioned.
    • search_attached_assets: Search for any streams which may be attached to a given connection.
    • attach_stream_asset: Attach the connection to the default stream.
    • send_email_notification: Sends an email notification given an email address and email body.
    preview
    Stream Attachment Port Finder Agent
    [stream-attachment-port-finder.md]
    An Equinix agent that automatically detects new ports older than a certain amount of time and ensures they are at least connected to the default stream. - Detect older ports that are not attached to any stream
    - Attach such ports to the default stream
    - Email notification of this action to the user
    - Log all actions and decisions
    This skill can use the following tools:
  • get_timestamps: Generates from and to UTC timestamps based on a duration string (e.g., "24h", "7d", "1M"). Returns a JSON object with from and to as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
  • search_ports: Search for any ports that are already provisioned.
  • search_attached_assets: Search for any streams which may be attached to a given port.
  • attach_stream_asset: Attach the port to the default stream.
  • send_email_notification: Sends an email notification given an email address and email body.
  • preview
    Stream Attachment Cloud Router Finder Agent
    [stream-attachment-router-finder.md]
    An Equinix agent that automatically detects new routers older than a certain amount of time and ensures they are at least connected to the default stream. - Detect older routers that are not attached to any stream
    - Attach such routers to the default stream
    - Email notification of this action to the user
    - Log all actions and decisions
    This skill can use the following tools:
  • get_timestamps: Generates from and to UTC timestamps based on a duration string (e.g., "24h", "7d", "1M"). Returns a JSON object with from and to as ISO 8601 UTC strings. Always call this in Step 1 to obtain the reporting window.
  • search_routers: Search for any routers that are already provisioned.
  • search_attached_assets: Search for any streams which may be attached to a given router.
  • attach_stream_asset: Attach the router to the default stream.
  • send_email_notification: Sends an email notification given an email address and email body.
  • preview

    About

    No description, website, or topics provided.

    Resources

    License

    Code of conduct

    Contributing

    Stars

    1 star

    Watchers

    1 watching

    Forks

    Packages

     
     
     

    Contributors

    Languages