Sunday, 9 August 2026

The Agent Loop in Cisco ACI: How AI Agents Can Troubleshoot, Automate and Safely Operate Networks

 Artificial intelligence is changing the way network engineers approach monitoring, troubleshooting, and automation.

Traditionally, a network engineer might receive an alert, log in to Cisco APIC, check faults, inspect endpoint information, verify contracts or routing, perform troubleshooting commands, and then decide what action should be taken.

Now imagine an AI agent that can perform many of these activities automatically.

Instead of simply answering:

"What is wrong with my ACI fabric?"

an AI agent could investigate the problem, collect information, analyze the results, decide what to do next, and continue until the problem is resolved—or until it determines that a human engineer needs to take over.

This is where the concept of an Agent Loop becomes important.

The basic idea is simple:

Observe → Think → Act → Evaluate → Continue or Stop

For network engineers, this concept is particularly interesting because Cisco ACI already provides APIs, telemetry, faults, endpoint information, fabric health data, and policy objects that an AI agent could potentially use as tools.

Let's understand the concept using a Cisco ACI troubleshooting example.


1. What Is an Agent Loop?

An Agent Loop is the repeated process through which an AI agent works toward a specific goal.

A simplified version looks like this:

Goal

Understand the situation

Take an action

Observe the result

Reflect on the result

Decide whether to continue

Repeat or terminate

This is different from a traditional chatbot.

A chatbot generally provides an answer based on the information available to it.

An agent is designed to work toward an objective by taking multiple steps.

Simple networking example

Suppose an application team reports:

"The application server cannot communicate with the database server."

A traditional troubleshooting process might involve a network engineer checking:

  • Endpoint learning
  • Bridge Domain
  • EPG membership
  • Contracts
  • Routing
  • L3Out
  • Firewall path
  • APIC faults
  • Interface status

An AI agent could potentially perform these checks sequentially.

For example:

Agent: Check whether the source endpoint is learned.

Result: Endpoint found.

Agent: Check destination endpoint.

Result: Destination endpoint found.

Agent: Check contract between the EPGs.

Result: No applicable contract.

Agent: This could explain the connectivity problem.

Decision: Recommend or request approval for a contract change.

This repeated process is the essence of an agent loop.


2. The Basic ReAct Model

A commonly used way of thinking about agent behavior is:

Think → Act → Observe

The agent first determines what it needs to do, performs an action using an available tool, and then observes the result.

For example:

Think

"I need to determine whether the destination endpoint is actually present in the ACI fabric."

Act

Query APIC for the endpoint information.

Observe

"The endpoint is not currently learned."

The agent now has new information.

It can decide what to investigate next.

For example:

"If the endpoint isn't learned, I should check the connected leaf interface and endpoint attachment information."

This is much closer to how an experienced network engineer troubleshoots a problem.


3. The Complete Agent Loop Adds Reflection

The basic Think → Act → Observe process is not enough for a reliable autonomous system.

After performing an action, the agent needs to evaluate the result.

This is the Reflection step.

The agent essentially asks:

  • Did my action succeed?
  • Did I get useful information?
  • Am I closer to the objective?
  • Should I investigate another area?
  • Should I stop?

The source material identifies reflection and termination as important additions to the basic agent loop.

For network automation, this is extremely useful.

Imagine an AI agent checking why a Cisco ACI endpoint cannot communicate.

It might perform:

Step 1: Check endpoint learning.

Result: Endpoint learned.

Reflection: Endpoint learning is not the problem.

Step 2: Check EPG membership.

Result: Correct EPG.

Reflection: EPG assignment appears correct.

Step 3: Check contract.

Result: Required contract is missing.

Reflection: This is a possible policy issue.

Now the agent has narrowed down the problem.

This is much more useful than blindly running a fixed list of commands.


4. Agent Loop Example: Troubleshooting Cisco ACI

Let's make this more realistic.

Imagine the following environment:

Web EPG → Application EPG → Database EPG

Users report that the application cannot reach the database.

An AI network agent receives the objective:

"Investigate database connectivity failure."

The agent could follow a process such as:

Step 1 – Check Fabric Health

The agent checks whether the ACI fabric has major faults.

Result: Fabric health is normal.

The agent continues.

Step 2 – Check Source Endpoint

The agent checks whether the application server is learned.

Result: Endpoint is learned on Leaf-101.

Continue.

Step 3 – Check Destination Endpoint

The agent checks whether the database endpoint is learned.

Result: Database endpoint is learned on Leaf-102.

Continue.

Step 4 – Check EPG Membership

The agent verifies that both endpoints belong to the expected EPGs.

Result: Correct.

Continue.

Step 5 – Check Contract

The agent checks whether the required communication is permitted.

Result: Required contract is missing.

The agent now has a strong candidate explanation.

But should it automatically create or modify the contract?

Not necessarily.

This is where another important concept appears.


5. Human-in-the-Loop: The Network Engineer Still Matters

One of the most important concepts in autonomous network operations is Human-in-the-Loop (HITL).

The idea is straightforward:

The AI can investigate, but a human may need to approve important actions.

This is especially important in production networks.

The source material describes HITL as an escape mechanism when an agent is uncertain or when an action has significant consequences.

Consider our ACI example.

The agent concludes:

"The application-to-database communication appears to be blocked because the required contract is missing."

It could then propose:

Recommended action: Create or modify the required contract.

Instead of immediately changing production policy, the agent pauses.

HITL checkpoint

AI Agent:

"I identified a possible policy issue. A contract allowing the required application-to-database communication is missing.

Do you want me to proceed?"

The engineer can:

Approve → Agent performs the approved action.

Reject → Agent stops.

Modify → Engineer changes the proposed action.

This approach combines automation with engineering judgment.


6. Why HITL Is Important in Cisco ACI

ACI is policy-driven.

A single policy change can potentially affect many endpoints or applications.

Therefore, an autonomous agent should be particularly careful before performing actions such as:

  • Modifying contracts
  • Changing EPG configuration
  • Changing Bridge Domain settings
  • Modifying L3Out configuration
  • Changing routing policy
  • Moving endpoints
  • Changing interface policies
  • Applying production configuration

The source material specifically identifies production configuration changes, sensitive operations, uncertainty, and organizational approval policies as situations where human involvement may be required.

A useful design principle is:

Let the AI investigate aggressively, but execute production changes cautiously.


7. Termination Conditions: When Should the Agent Stop?

An agent loop needs a clear stopping point.

Otherwise, the agent could continue running unnecessarily.

For example:

Check APIC → timeout

Retry APIC → timeout

Retry APIC → timeout

Retry APIC → timeout

And the process could continue indefinitely.

The source material identifies several common termination triggers, including task completion, maximum iterations, confidence thresholds, human handoff, and error conditions.

For network automation, these can be translated into practical conditions.


8. Termination Condition #1 – Problem Solved

The simplest condition is:

Task completed.

For example:

The agent was asked to determine why an endpoint cannot communicate.

After investigation:

  • Endpoint is learned
  • EPG membership is correct
  • Contract exists
  • Routing is correct
  • Required policy is present

The agent has completed its investigation.

It can provide the final result.


9. Termination Condition #2 – Maximum Number of Attempts

Every autonomous agent should have a maximum iteration limit.

For example:

Maximum troubleshooting steps = 10

If the agent reaches step 10 without finding a reliable explanation, it stops.

This prevents an uncontrolled troubleshooting loop.

The source material describes maximum iterations as a safety mechanism that prevents an agent from running forever.

For example:

Attempt 1: Check endpoint

Attempt 2: Check EPG

Attempt 3: Check contract

...

Attempt 10: No conclusive result

Agent: "I could not determine the root cause within the configured troubleshooting limit. Human investigation is required."

That is much safer than allowing the agent to continue indefinitely.


10. Termination Condition #3 – Error State

Sometimes the problem isn't the network.

The tool itself may be unavailable.

For example:

Agent → APIC API

Result → Authentication failure

The agent should not continuously retry without limits.

Another example:

Agent → APIC

Result → API unavailable

The agent should recognize the error state and stop or switch to an approved fallback.

The source material describes error states as situations where required systems or dependencies fail and the agent should stop trying and report the problem.


11. Termination Condition #4 – Human Approval Required

Sometimes the agent reaches a point where it knows what should happen but does not have authority to perform it.

For example:

Agent diagnosis:

"Traffic is being denied because the required contract is missing."

Proposed action:

"Create contract allowing TCP/443 between the application and database EPGs."

At this point, the agent can request approval.

If the engineer approves:

Continue → Execute approved action

If the engineer rejects:

Stop → Report

This creates a controlled automation boundary.


12. What Happens When an Agent Gets Stuck?

Autonomous systems don't always fail in obvious ways.

Sometimes an agent continues working but isn't actually making progress.

These are called stuck states.

The source material highlights four important examples:

  1. Loop
  2. Oscillation
  3. Dead end
  4. Hallucination

Let's translate these into networking terms.


13. Stuck State #1 – Loop

A loop occurs when the agent repeatedly performs the same action without progress.

For example:

Check APIC endpoint → timeout

Check APIC endpoint → timeout

Check APIC endpoint → timeout

Check APIC endpoint → timeout

Nothing changes.

A good agent should recognize the repeated pattern.

It should either:

  • Try an approved alternative
  • Wait and retry within limits
  • Escalate
  • Stop

It should not continue forever.


14. Stuck State #2 – Oscillation

Oscillation is slightly different.

The agent changes between two approaches but doesn't make meaningful progress.

For example:

Check endpoint → no result

Check contract → no result

Check endpoint → no result

Check contract → no result

Check endpoint → no result

The agent is changing tactics, but it is effectively going around in circles.

Action-history tracking can help detect this behavior.


15. Stuck State #3 – Dead End

A dead end occurs when all available options fail.

For example:

  • APIC API unavailable
  • CLI access unavailable
  • Telemetry unavailable
  • Required monitoring system unavailable

The agent has no useful path forward.

A well-designed system should recognize this situation and escalate rather than inventing an answer.


16. Stuck State #4 – Hallucination

Hallucination is particularly important when AI interacts with network automation tools.

An agent may attempt to call a tool that does not exist or provide an invalid input.

For example, imagine the agent assumes an API endpoint exists when it doesn't.

Instead of recognizing the limitation, it repeatedly tries variations of the same invalid request.

That is dangerous in automation.

The source material describes hallucination as an agent attempting to use nonexistent tools or invalid inputs.

This is why tool validation and strict API permissions are important.


17. How Can We Prevent Agents From Getting Stuck?

A reliable network automation agent should have multiple protection mechanisms.

The source material recommends a layered approach involving iteration limits, action-history tracking, fallback strategies, and human escalation.

For Cisco ACI automation, we can think about it like this:

1. Set an iteration limit

Don't allow unlimited troubleshooting steps.

2. Maintain action history

Record what the agent already checked.

3. Detect repeated actions

If the same API call or troubleshooting operation repeatedly produces the same result, flag it.

4. Define fallback paths

If the preferred data source is unavailable, use an approved alternative.

5. Escalate to a network engineer

When automation reaches its boundary, stop and request human assistance.

This is essentially applying good network engineering practices to AI systems.


18. Example: AI Agent Troubleshooting an ACI Endpoint

Let's put everything together.

User Request

"Investigate why Server-A cannot communicate with Server-B."

Agent Loop

Goal: Determine the connectivity issue.

Check Server-A endpoint

Result: Learned.

Reflect

Server-A is present in the fabric.

Check Server-B endpoint

Result: Learned.

Reflect

Both endpoints are present.

Check EPG membership

Result: Correct.

Check contract

Result: Required communication is not permitted.

Reflect

Potential policy issue identified.

Propose action

"Create or modify the required contract."

HITL checkpoint

Engineer approval required.

Engineer approves

Agent performs approved change

Verify connectivity

Result: Connectivity restored.

Termination

Task completed.

This is a simple example of how an AI agent could combine investigation, reasoning, automation, verification, and human oversight.


19. The Difference Between Automation and Agentic Automation

This distinction is important for network engineers.

Traditional automation

You define exactly what should happen.

For example:

If interface goes down → send alert.

Or:

Run this Python script → configure these interfaces.

The workflow is largely predetermined.

Agentic automation

The system receives a goal and determines the next appropriate step based on observations.

For example:

Goal: Investigate connectivity failure.

The agent might determine:

  1. Check endpoint.
  2. Check EPG.
  3. Check contract.
  4. Check routing.
  5. Check external connectivity.
  6. Form a hypothesis.
  7. Verify the hypothesis.
  8. Request approval if configuration changes are required.

This is why agentic AI is particularly interesting for network operations.


20. Where Cisco ACI Fits Into Agentic AI

Cisco ACI provides a policy-driven environment with centralized management through APIC.

That makes it an interesting platform for experimenting with AI-assisted network operations.

An AI agent could potentially use approved interfaces to:

Read

  • Fabric health
  • Faults
  • Endpoint information
  • EPG information
  • Bridge Domain information
  • Contracts
  • Routing information
  • Interface status
  • Operational statistics

Analyze

  • Identify patterns
  • Correlate multiple faults
  • Compare expected and actual behavior
  • Generate troubleshooting hypotheses

Recommend

  • Possible root cause
  • Next troubleshooting step
  • Configuration change
  • Verification procedure

Execute

Only where the required authorization and safeguards exist.

This last point is critical.

Read-only automation is significantly different from autonomous production configuration.


21. A Practical AI + ACI Architecture

A conceptual architecture could look like this:

Network Engineer

AI Agent

Reasoning / Decision Engine

Policy & Safety Layer

ACI API / Approved Tools

Cisco APIC

ACI Fabric

Telemetry / Faults / Operational Data

AI Agent

The agent receives information from the environment, analyzes it, decides what should happen next, and continues the loop.

For production environments, the Policy & Safety Layer should sit between the agent and configuration-changing operations.


22. Read-Only vs Change-Enabled AI Agents

A useful maturity model for network teams is to start small.

Level 1 – AI Assistant

The engineer asks questions.

Example:

"Why might an ACI endpoint not be learned?"

The AI provides possible causes.

Level 2 – Read-Only Agent

The AI can retrieve information from approved systems.

Example:

"Investigate Server-A connectivity."

The agent collects APIC information but does not modify anything.

Level 3 – Recommendation Agent

The agent investigates and proposes remediation.

Example:

"The contract appears to be missing. I recommend validating the required filter and contract."

Level 4 – Human-Approved Automation

The agent proposes a change and waits for approval.

Approve → Execute

Reject → Stop

Level 5 – Controlled Autonomous Operations

Certain low-risk actions can be performed automatically under predefined policies.

This should only be considered after extensive testing, logging, validation, and governance.


23. Safety: Never Trust an AI Agent Blindly

One of the most important lessons from agentic AI is that confidence does not automatically equal correctness.

An AI agent can produce an incorrect conclusion with a high level of confidence.

The source material specifically highlights overconfidence, silent failures, context loss, and automation bias as important safety concerns.

For network engineers, this means:

AI recommendation ≠ network truth

Always validate critical conclusions.

For production changes, consider:

  • Change approval
  • RBAC
  • Audit logging
  • Rollback capability
  • Maximum iterations
  • Tool restrictions
  • Human approval
  • Post-change verification

24. Logging Is Extremely Important

Every agent action should ideally be traceable.

For example:

09:10:01 – Task received

09:10:03 – Queried endpoint

09:10:04 – Endpoint found

09:10:06 – Checked EPG

09:10:07 – EPG valid

09:10:09 – Checked contract

09:10:10 – Contract missing

09:10:15 – Proposed remediation

09:10:30 – Human approval received

09:10:35 – Change executed

09:10:40 – Connectivity verified

This creates an audit trail.

If something goes wrong, the network engineer can understand what the agent attempted and why.


25. ACI Engineers Should Think in Terms of Guardrails

When building AI-based network automation, don't start with:

"How much can the AI automate?"

Start with:

"What should the AI never be allowed to do?"

For example, an organization might define:

Automatically allowed

  • Read APIC faults
  • Read endpoint information
  • Read interface status
  • Generate troubleshooting reports
  • Recommend configuration changes

Human approval required

  • Contract changes
  • EPG changes
  • Routing changes
  • L3Out modifications
  • Production interface changes

Never allowed without additional controls

  • Broad production configuration changes
  • Changes outside an approved change window
  • Actions affecting critical applications

This approach makes AI adoption much more controlled.


26. A Simple Mental Model for Network Engineers

If you are new to agentic AI, remember this:

Traditional script

Do A → Do B → Do C → Finish

Automation workflow

If A → Do B → If C → Do D

AI Agent

Goal → Investigate → Act → Observe → Reflect → Decide → Repeat → Stop

Safe AI Agent

Goal → Investigate → Act → Observe → Reflect → Safety Check → Human Approval if Required → Verify → Stop

That last model is particularly relevant to production network operations.


27. Key Takeaways

The Agent Loop provides a useful way to understand how AI can move from simple question answering toward autonomous problem solving.

For Cisco ACI engineers, the most important concepts are:

1. Think → Act → Observe

The agent performs actions and learns from the results.

2. Reflection

After every important action, the agent evaluates whether it made progress.

3. Termination

Every agent needs clear conditions for stopping.

4. Stuck-state detection

The system should detect loops, oscillation, dead ends, and invalid tool usage.

5. Human-in-the-Loop

Critical production changes should have an appropriate human approval mechanism.

6. Guardrails

Limit what the agent can access and what it can change.

7. Logging

Record actions, results, decisions, and termination reasons.

8. Verification

After an automated change, verify that the expected outcome actually occurred.


28. Final Thoughts

Cisco ACI changed the traditional networking mindset from configuring individual devices toward defining application and network policy.

Agentic AI could take this concept one step further.

Instead of asking a network engineer to manually investigate every alert, an AI agent could potentially collect information, correlate events, investigate the problem, propose a solution, and—in carefully controlled situations—execute an approved action.

But the objective should not be to remove the network engineer from the process.

The better objective is to make the network engineer more productive.

Think of the AI agent as a junior engineer that can work continuously, collect information quickly, perform repetitive investigations, and prepare recommendations.

The experienced network engineer remains responsible for judgment, architecture, risk, and production decisions.

The future of network operations may therefore not be:

Human OR AI

but rather:

Human + AI + Automation + Guardrails

And Cisco ACI provides an excellent environment for network engineers to start exploring this new model of intelligent network operations.


Related Cisco ACI Articles

If you are learning Cisco ACI, you may also find these articles useful:

Cisco ACI Explained: Concepts, Learning Prerequisites, Benefits, and Limitations
Read the Cisco ACI fundamentals guide

Cisco ACI vPC Explained: Architecture, Working, Configuration, Traffic Flow & Interview Questions
Read the Cisco ACI vPC guide

Why Service Graphs Matter in Cisco ACI — Complete Guide with Configuration Examples
Read the Cisco ACI Service Graph guide

L3Out Subnet Scope Options in Cisco ACI
Read the Cisco ACI L3Out guide

Understanding Domain Types in Cisco ACI
Read the Cisco ACI Domain Types guide

Understanding VLAN Pool Roles in Cisco ACI
Read the Cisco ACI VLAN Pool guide

Cisco ACI Leaf Node ID Swap on vPC Pairs
Read the Cisco ACI Leaf Node ID Swap guide

Wednesday, 5 August 2026

How AI Memory Can Transform Cisco SD-WAN Operations: Working Memory, Long-Term Memory & RAG Explained with Real Examples

 Enterprise WAN networks are becoming increasingly complex. A modern Cisco SD-WAN deployment may include hundreds of branch locations, multiple transport circuits, cloud connectivity, SaaS applications, and centralized policy management.

While Cisco SD-WAN simplifies operations through centralized control, troubleshooting issues across multiple sites can still consume significant time.

Imagine receiving alerts that twenty branch offices have simultaneously lost connectivity to Microsoft Azure. Instead of manually checking control connections, OMP routes, TLOC status, application-aware routing policies, and tunnel health, an AI-powered assistant could analyze the entire environment in seconds.

But how does an AI assistant remember previous troubleshooting steps, understand your SD-WAN architecture, and retrieve your organization's deployment standards?

The answer lies in AI Memory.

Just as an experienced SD-WAN engineer relies on operational knowledge, design documentation, and previous incidents, AI agents use different types of memory to provide intelligent, context-aware assistance.

In this article, we'll explore how AI memory works using practical Cisco SD-WAN examples.


Why Memory Matters in Cisco SD-WAN

Consider a large enterprise with:

  • Two vManage controllers
  • Two vBond orchestrators
  • Three vSmart controllers
  • 400 WAN Edge routers
  • MPLS, Internet, and 5G transports
  • Hundreds of VPNs
  • Thousands of OMP routes

Now imagine that users across multiple branches report poor Microsoft Teams performance.

Without memory, an AI assistant would repeatedly ask:

  • Which sites are affected?
  • Which transport is failing?
  • What policies are configured?
  • Are control connections established?
  • Has any template changed recently?

An experienced engineer already understands much of this context. AI memory enables an intelligent assistant to retain relevant information, retrieve documentation, and build on previous investigations instead of starting from scratch.


Understanding AI Memory

AI memory can be compared to how an experienced Cisco SD-WAN administrator manages information.

AI MemoryCisco SD-WAN Example
Working MemoryCurrent WAN outage investigation
Long-Term MemorySD-WAN design guides and runbooks
Episodic MemoryPrevious outages and administrator preferences

Together, these memory types help AI provide faster and more accurate recommendations.


Working Memory – Understanding the Current Incident

Working memory contains the information the AI agent is actively using during the current troubleshooting session. It is temporary and focused on the ongoing investigation.

Cisco SD-WAN Example

An engineer reports:

"Branch-105 cannot access Azure."

The AI assistant remembers:

  • Branch name
  • WAN Edge router
  • VPN ID
  • Transport circuits
  • TLOC status
  • OMP advertisements
  • BFD session state
  • Application-aware routing policy
  • Results from previous commands

Instead of requesting the same details repeatedly, it builds on the existing context to accelerate troubleshooting.


Long-Term Memory – Your Enterprise SD-WAN Knowledge Base

Working memory disappears after the session ends.

Long-term memory stores persistent information that the AI can retrieve whenever needed. This may include architecture documents, operational procedures, and deployment standards.

For Cisco SD-WAN, this could include:

  • WAN architecture diagrams
  • Controller deployment standards
  • VPN segmentation guidelines
  • Application-aware routing policies
  • Security policies
  • Template standards
  • Branch deployment procedures
  • Change management documentation

Cisco SD-WAN Example

An engineer asks:

"What is our standard QoS policy for Microsoft Teams?"

Instead of generating a generic answer, the AI retrieves the organization's approved policy documentation and provides guidance that aligns with internal standards.

This ensures consistency across every branch deployment.


What is RAG?

RAG (Retrieval-Augmented Generation) allows AI to retrieve trusted documentation before generating an answer. Rather than relying only on its training data, the AI searches your organization's SD-WAN knowledge base, such as deployment guides, runbooks, and design documents, to produce responses grounded in your own environment.

Cisco SD-WAN Example

An engineer asks:

"How do we normally configure Direct Internet Access for branch offices?"

The AI retrieves the organization's approved deployment guide and recommends the documented configuration instead of offering generic internet advice.


Episodic Memory – Learning from Previous Outages

Episodic memory stores previous interactions and user preferences, allowing the AI to personalize future assistance.

Cisco SD-WAN Example

Suppose that three months ago you resolved an issue where unstable BFD sessions over the broadband circuit caused intermittent application failures.

When a similar pattern appears again, the AI highlights the previous incident and suggests checking BFD stability before exploring more complex causes.

It may also remember that you prefer CLI commands alongside vManage workflows, tailoring its recommendations to your working style.


How AI Memory Helps During a WAN Outage

Imagine a global outage affecting dozens of branch offices.

An AI assistant can:

  1. Use Working Memory to track the current investigation, including affected sites and diagnostic results.
  2. Use Long-Term Memory to retrieve SD-WAN design standards, routing policies, and operational runbooks.
  3. Use Episodic Memory to compare the current symptoms with previous incidents and recommend proven remediation steps.

This combination reduces Mean Time to Resolution (MTTR) and helps engineers resolve issues more efficiently.


Benefits for Cisco SD-WAN Engineers

AI memory can significantly improve daily operations by:

  • Reducing repetitive troubleshooting tasks
  • Accelerating root cause analysis
  • Retrieving internal documentation instantly
  • Preserving operational knowledge
  • Supporting junior engineers with guided diagnostics
  • Standardizing troubleshooting procedures
  • Improving consistency across large-scale SD-WAN deployments
  • Enabling AI-assisted network operations

Real-World Use Cases

AI memory can support many common Cisco SD-WAN tasks, including:

  • Diagnosing OMP route advertisement issues
  • Troubleshooting BFD session flaps
  • Investigating TLOC extension failures
  • Validating centralized and localized policies
  • Checking application-aware routing decisions
  • Reviewing controller certificate and control connection issues
  • Verifying software upgrade procedures
  • Assisting with Zero-Touch Provisioning (ZTP)
  • Troubleshooting SaaS connectivity
  • Supporting cloud on-ramp deployments

Frequently Asked Questions

Can AI remember my Cisco SD-WAN deployment?

Yes, if it is connected to persistent knowledge sources and designed to retain relevant operational context.

How does RAG improve SD-WAN troubleshooting?

It enables AI to retrieve approved runbooks, design guides, and operational documentation before generating recommendations.

Can AI replace Cisco SD-WAN engineers?

No. AI enhances productivity by accelerating troubleshooting and surfacing relevant information, while engineers remain responsible for design, validation, and operational decisions.


How AI Memory Can Revolutionize Cisco ACI Operations

Cisco ACI has transformed data center networking by introducing policy-based automation, centralized management, and application-centric networking. However, as enterprise fabrics grow, troubleshooting becomes increasingly challenging.

Imagine receiving multiple faults from different leaf switches after a maintenance window. Instead of manually checking APIC health, interface counters, contracts, endpoint learning, and event logs one by one, an AI assistant could analyze everything in seconds.

But how can an AI assistant remember previous troubleshooting steps, understand your fabric, and retrieve your organization's deployment standards?

The answer lies in AI Memory.

Just like an experienced Cisco ACI engineer relies on operational knowledge, design documents, and previous troubleshooting experience, AI agents use different types of memory to provide intelligent assistance.

In this article, we'll explore how AI memory works using real Cisco ACI scenarios.


Why Memory Matters in Cisco ACI

Suppose your production ACI fabric consists of:

  • Three APIC controllers
  • Two Spine switches
  • Twenty Leaf switches
  • Hundreds of EPGs
  • Multiple VRFs
  • External L3Out connections
  • VMware VMM integration

Now imagine that an application suddenly loses connectivity.

Without memory, an AI assistant would ask the same questions every time:

  • Which tenant is affected?
  • Which EPGs are involved?
  • What contracts exist?
  • Which leaf switch hosts the endpoint?
  • Was any policy recently modified?

An experienced engineer already remembers much of this context. Likewise, AI memory allows an intelligent assistant to retain relevant information, retrieve documentation, and personalize future troubleshooting.


The Three Types of AI Memory

Think of AI memory as the way a senior Cisco ACI architect organizes information.

AI MemoryCisco ACI Example
Working MemoryCurrent APIC fault investigation
Long-Term MemoryACI design documents and runbooks
Episodic MemoryPrevious incidents and administrator preferences

Together, these memory types help AI solve problems faster and more accurately.


Working Memory – The Current Troubleshooting Session

Working memory contains information that the AI agent is actively processing during the current investigation. It is temporary and limited to the ongoing session.

Cisco ACI Example

An engineer asks:

"Why are endpoints in EPG-Web unable to communicate with EPG-App?"

The AI assistant keeps track of:

  • Tenant name
  • VRF
  • Bridge Domain
  • EPG names
  • Applied contracts
  • Recent APIC fault messages
  • Results of previous checks

Instead of asking for the same information repeatedly, it builds on the conversation until the issue is resolved.


Long-Term Memory – Your Cisco ACI Knowledge Base

Long-term memory stores persistent information that does not disappear after the conversation ends. In AI systems, this often includes documentation and runbooks that can be retrieved when needed.

For Cisco ACI, this could include:

  • Fabric architecture diagrams
  • Tenant standards
  • Naming conventions
  • Interface policies
  • L3Out design guides
  • APIC backup procedures
  • Security policies
  • Change management documents

Cisco ACI Example

An engineer asks:

"What is our standard configuration for external routed networks?"

Instead of relying on generic knowledge, the AI searches your organization's approved ACI design guide and provides recommendations based on your own standards.

This improves consistency and reduces the risk of configuration drift.


What is RAG?

RAG (Retrieval-Augmented Generation) allows an AI assistant to retrieve relevant documentation before generating a response. Rather than guessing, it searches trusted sources such as your ACI runbooks, design guides, and operational procedures.

Cisco ACI Example

You ask:

"How do we normally configure BGP authentication on our L3Outs?"

The AI retrieves the organization's approved implementation guide and answers using that document rather than generic internet advice.


Episodic Memory – Learning from Previous Incidents

Episodic memory records previous interactions and user preferences so future assistance can be more personalized.

Cisco ACI Example

Suppose that last month you resolved a fault caused by a missing contract between two EPGs.

Months later, a similar fault occurs.

The AI recognizes the similarity and suggests checking contracts early in the troubleshooting process, saving valuable time.

It may also remember that you prefer CLI outputs alongside APIC GUI navigation, allowing responses to match your working style.


Bringing It All Together

Imagine a production outage affecting application connectivity.

An AI assistant could:

  1. Use Working Memory to keep track of the current troubleshooting session.
  2. Use Long-Term Memory to retrieve your organization's ACI standards and runbooks.
  3. Use Episodic Memory to recognize similar past incidents and apply successful troubleshooting patterns.

This combination provides faster diagnostics, more consistent recommendations, and reduced troubleshooting time.


Benefits for Cisco ACI Engineers

By combining AI memory with Cisco ACI, organizations can:

  • Accelerate root cause analysis.
  • Reduce repetitive troubleshooting.
  • Retrieve design documentation instantly.
  • Improve adherence to operational standards.
  • Preserve knowledge from experienced engineers.
  • Shorten onboarding time for new team members.
  • Enable more intelligent AI-driven network operations.

Key Takeaways

  • Working Memory manages the current troubleshooting context.
  • Long-Term Memory stores ACI documentation, standards, and runbooks.
  • Episodic Memory captures previous incidents and user preferences.
  • RAG connects AI to trusted enterprise documentation instead of relying only on model training.
  • Together, these capabilities can significantly improve Cisco ACI operations and troubleshooting efficiency.

Frequently Asked Questions

Can AI remember my Cisco ACI fabric permanently?
Only if the AI platform is designed to store and retrieve persistent knowledge such as documentation and previous interactions.

How does RAG help Cisco ACI administrators?
It allows AI to search approved ACI documentation and generate answers based on your organization's standards instead of generic information.

Can AI replace Cisco ACI engineers?
No. AI augments engineers by reducing repetitive tasks and surfacing relevant information, while design decisions and operational oversight remain with experienced professionals.


Related Articles to add to "How AI Memory Can Revolutionize Cisco ACI Operations":

Need help with Cisco ACI, Nexus, data center networking, or network automation?

I am a CCIE Data Center engineer with 18+ years of enterprise networking experience.

Contact me for consulting, troubleshooting, design reviews, and project support.


Tuesday, 4 August 2026

How AI Agents Actually "Touch" Your SD-WAN Overlay: Tools, Schemas, and Guardrails Explained

 An AI agent that can only talk isn't much use to an SD-WAN operations team. It can summarize a wall of syslog you paste in, sure — but it can't tell you a branch's current BFD state right now, and it definitely shouldn't be pushing a centralized policy change just because it "reasoned" its way there. What separates a chatbot from something you'd actually let near vManage is tools — the functions an agent is allowed to call to read from, act on, or talk about your overlay.

This post breaks down how tools work in an AI agent, using SD-WAN as the running example throughout, so the concepts map directly onto things you already manage — tunnels, SLA classes, device templates, and centralized policy.


Why "Just Talking" Isn't Enough on SD-WAN

Picture an agent with no tools at all:

Agent: "I think Branch-42's MPLS tunnel might be down, but I have no way to check."

Not useful. Now give it a single tool that can query vManage's device API:

Agent: [calls get_tunnel_status(branch="Branch-42", transport="MPLS")] → "Branch-42's MPLS tunnel is down. BFD lost sync 4 minutes ago; the branch has failed over to Internet transport."

Same question, completely different value. That's the entire point of tools — they turn an agent from something that speculates into something that can actually verify against the overlay's real state.


The Four Tool Categories, Mapped to SD-WAN

Every tool an SD-WAN-aware agent might use falls into one of four buckets. Knowing which bucket a task belongs to tells you immediately how much oversight it needs.

1. Retrieval Tools — Read-Only Lookups

These pull information without changing anything: tunnel status, SLA performance, control-connection state, transport in use.

SD-WAN examples:

  • get_tunnel_status(branch, transport) — pull current BFD/session state for a specific tunnel
  • get_sla_performance(tunnel, app_class) — loss/latency/jitter for a given app class
  • get_control_connections(device) — check a device's control-plane state to vSmart
  • get_active_transport(branch, app) — which underlay path an app is currently steered over

Retrieval tools are the safest category — an agent can call these freely without much risk, which is exactly why they're the easiest place to start trusting AI in SD-WAN operations.

2. Execution Tools — Tools That Change the Overlay

These make actual changes: pushing a centralized data policy, updating a device template, restarting a tunnel, triggering a software upgrade. Because SD-WAN policy is orchestrated centrally, execution tools deserve the most design care of any category — a bad push doesn't stay local, it propagates to every site attached to that policy or template.

SD-WAN examples:

  • deploy_data_policy(site_list, app_class, sla_class, mode)
  • update_device_template(device, template, mode)
  • trigger_software_upgrade(device, target_version, mode)

Notice the repeated mode parameter — more on that below. It's the single most important detail in an SD-WAN execution tool's design.

3. Communication Tools — Looping in Humans

These don't touch the overlay at all — they notify people. Sending a Slack alert about a degraded transport, opening a ServiceNow ticket for a recurring BFD flap, paging the on-call engineer when a regional hub loses reachability.

SD-WAN examples:

  • send_slack_alert(channel, message) — e.g., posting when an SLA class breaches threshold on a tunnel
  • create_servicenow_ticket(summary, severity, affected_site)
  • page_oncall(team, reason) — for something like a vSmart cluster losing quorum

These tools are how an agent stays useful even when it shouldn't act on its own — escalating to a human is often the correct behavior, not a fallback.

4. Perception Tools — Making Sense of Raw Data

These interpret information rather than fetch or change it: parsing a flood of BFD flap events into a plain-English summary, correlating a voice-quality complaint with a recent policy push, summarizing a week of vManage audit logs.

SD-WAN examples:

  • summarize_alarms(site, time_range) — turn 150 raw alarms into three actionable findings
  • correlate_app_degradation(app, time_range) — check if a slowdown lines up with a recent policy or template change
  • parse_audit_log(controller, time_range) — extract what actually changed and who changed it

Perception tools are what let an agent reason well before it decides whether a retrieval or execution tool is even needed.


How the Agent Actually Picks a Tool

The agent doesn't understand SD-WAN the way you do — it reads tool descriptions and matches them against the question. This is why the wording of a tool's description matters as much as the code behind it.

Say someone asks: "Is the voice traffic class healthy on the Chicago-to-DC tunnel right now?"

The agent scans its available tools and finds get_sla_performance described as "Retrieve current loss, latency, and jitter for a given tunnel and application class." That's a strong match — it extracts the tunnel and the voice class as inputs and calls it.

A vague description like "Gets SD-WAN stuff" would leave the agent guessing between three different tools that all sound plausible. A precise description — naming exactly what the tool returns and for what object type — is what makes tool selection reliable instead of a coin flip.


Anatomy of an SD-WAN Tool Schema

Take deploy_data_policy as a worked example of what a well-designed execution tool schema looks like:

  • Name: deploy_data_policy — the unique identifier the agent calls
  • Description: "Push a centralized data policy affecting application routing for a site list. Warning: makes real overlay-wide changes." — the explicit warning matters; it tells the agent (and anyone reviewing its plan) that this isn't a harmless lookup
  • Input schema:
    • site_list — which sites this policy scope applies to
    • app_class — the application or traffic match criteria
    • sla_class — which SLA class the traffic should be pinned to
    • mode — constrained to an enum of "preview" or "apply", defaulting to "preview"

That last field is the load-bearing detail. A default of preview means the agent's first call only shows what would happen — the policy doesn't actually get activated and pushed to vSmart until a human (or a separate, explicit step) chooses apply.

Schema design principles worth carrying into any SD-WAN tool you build:

  • Write descriptions specific enough that two tools never sound interchangeable
  • Type every input (don't let a site list or device ID be passed as a free-text string with no validation)
  • Use enums to constrain choices like mode, severity, or scope
  • Default to the safe option, never the destructive one
  • Mark required fields so the agent can't fire a call with the site list or app class left blank

Safety Considerations for SD-WAN-Facing Tools

A tool that can act on a centrally orchestrated overlay needs guardrails baked in from the start — not bolted on after the first incident.

Destructive actions. A tool like deploy_data_policy can affect application routing across every branch in the site list. Mitigation: default to preview mode, require explicit confirmation before applying, and never let an agent's very first call against a tool be a live push.

Credential exposure. If a tool logs its inputs and one of those inputs happens to include a vManage API token or a RADIUS credential passed through for auth, that's a real exposure. Mitigation: never log sensitive fields — scrub credentials before anything gets written to a log or a transcript.

Ineffective guardrails. A tool scoped to "manage the entire overlay" is too broad — it hands an agent far more blast radius than any single task requires. Mitigation: scope each tool tightly — a policy-deployment tool shouldn't also be able to touch device templates or controller certificates.

Cascading failures. SD-WAN workflows chain tool calls — the output of a tunnel-health check might feed into whether a firmware upgrade proceeds. If one tool returns bad or stale data, a downstream tool can act on it. Mitigation: build rollback into any tool that changes state, and don't let a single failed check silently get treated as a pass.


The Validation Pipeline Before Anything Executes

Before an execution tool is allowed to actually touch vManage or vSmart, three checks should pass, in order:

  1. Schema compliance — Are all required fields present and correctly typed? If site_list is missing or mode isn't one of the allowed enum values, reject the call before it goes anywhere near the overlay.
  2. Authorization — Does this user or agent identity actually have permission to call this tool? An agent scoped to read-only monitoring shouldn't be able to invoke deploy_data_policy at all, regardless of what it "decides" to do.
  3. Safety checks — Is this action allowed right now? A change-freeze window, an active P1 incident, or an in-progress controller upgrade are all reasons to block an otherwise-valid call.

Only after all three pass should the tool actually run against the controllers.


Quick Reference: Tool Category vs. Oversight Needed

CategorySD-WAN ExampleOversight Level
Retrievalget_tunnel_status, get_sla_performanceMinimal — safe to run freely
Executiondeploy_data_policy, update_device_templateHigh — preview mode, confirmation, rollback
Communicationsend_slack_alert, page_oncallLow — but should avoid alert fatigue
Perceptionsummarize_alarms, correlate_app_degradationLow — but accuracy matters, since downstream decisions rely on it

Final Thoughts

Tools are what make an AI agent useful on a real SD-WAN overlay instead of just a chatbot that can describe what an SLA class is. The four categories — retrieval, execution, communication, perception — map cleanly onto operations work you already do every day. The schema design determines whether tool selection is reliable or a guessing game. And the safety layer — preview-by-default execution, tight scoping, credential hygiene, and a validation pipeline before anything runs — is what determines whether you'd actually trust an agent near production vManage.

None of this replaces your judgment. It's what lets an agent earn a little bit of it, one well-scoped tool at a time.


FAQ

Q: Should an AI agent ever have direct, unsupervised write access to vManage? A: Generally no. Execution tools should default to preview mode and require explicit confirmation before applying, with authorization and safety checks run before every call — the same discipline you'd want from any junior engineer making overlay-wide changes.

Q: What's the biggest mistake in designing SD-WAN tool schemas for an agent? A: Vague tool descriptions. If two tools' descriptions sound interchangeable, the agent will eventually pick the wrong one — and on SD-WAN, the wrong tool call can mean a fleet-wide policy change instead of a simple status check.

Q: Are perception tools (like alarm summarization) risky the same way execution tools are? A: Not in the same way — they don't change the overlay — but their accuracy still matters, because a bad summary can lead a human or a downstream tool call to the wrong conclusion.


Related Reading on Networklearner:


Need help with SD-WAN, Cisco ACI, Nexus, data center networking, or network automation?

I am a CCIE Data Center engineer with 18+ years of enterprise networking experience, working hands-on with production SD-WAN and ACI environments.

Contact me for consulting, troubleshooting, design reviews, and project support: rockingoa@gmail.com