Showing posts with label Generative AI. Show all posts
Showing posts with label Generative AI. Show all posts

Sunday, 9 August 2026

The Agent Loop in Cisco SD-WAN: How AI Can Automate Network Troubleshooting

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

Traditionally, a network engineer might receive an alert, log in to the Cisco SD-WAN management platform, check device health, investigate WAN links, examine tunnel status, review application performance, and then decide what action should be taken.

Now imagine an AI agent performing many of these activities automatically.

It could collect SD-WAN information, analyze the results, decide what to investigate next, evaluate whether its findings make sense, and continue until it identifies the likely problem.

If a production configuration change is required, it could stop and request approval from the network engineer.

This is the idea behind the Agent Loop.

For network engineers, the concept can be summarized as:

Understand → Act → Observe → Reflect → Decide → Repeat or Stop

The source material describes the complete agent loop as an extension of the basic Think → Act → Observe cycle, adding reflection and a termination decision.

1. What Is an Agent Loop?

An Agent Loop is a continuous cycle in which an AI agent works toward a defined objective.

A simplified workflow looks like this:

                 Network Problem
                       ↓
                Understand Goal
                       ↓
                     Think
                       ↓
                      Act
                       ↓
                   Observe
                       ↓
                   Reflect
                       ↓
                Should I Stop?
                  ↙         ↘
                Yes          No
                 ↓            ↓
              Result       Next Action
                              ↓
                           Repeat

The important part is that the agent doesn't necessarily follow one fixed sequence.

The result of one action can influence the next action.

This makes the concept particularly interesting for SD-WAN troubleshooting.

For example, an agent might initially decide to check WAN connectivity. If the WAN links are healthy, it may decide that checking path performance or application routing is more useful than repeating the same connectivity check.

The source material describes reflection as an evaluation performed after an action, including questions about whether the action succeeded, whether the agent is closer to its goal, whether it should try something different, and whether it is time to stop.

2. Why Is Agentic AI Interesting for Cisco SD-WAN?

SD-WAN environments generate a large amount of operational information.

A network engineer may need to investigate:

  • WAN connectivity
  • Transport availability
  • Tunnel status
  • Latency
  • Jitter
  • Packet loss
  • Application performance
  • Routing
  • Device health
  • Policy behavior
  • Control-plane information
  • Security events

A human engineer can investigate these individually.

An AI agent could potentially correlate multiple pieces of information and determine what to investigate next.

For example:

Problem: Users report that an application is slow.

The agent could investigate:

WAN health → path performance → application traffic path → policy → routing → possible remediation

The important concept is that the next step can be influenced by the result of the previous step.

That is what makes an agent different from a simple fixed automation script.

3. The Basic Think → Act → Observe Model

A useful way to understand agent behavior is:

Think → Act → Observe

Let's apply this to a Cisco SD-WAN troubleshooting scenario.

Think

The agent receives:

"The ERP application is slow for users at the branch."

The agent decides that it needs to investigate whether WAN performance is affecting the application.

Act

The agent collects WAN performance information.

Observe

The agent discovers that one transport has elevated latency and packet loss.

Now the agent has new information.

It can decide what to investigate next.

For example:

"I found a degraded transport. I should determine whether ERP traffic is currently using this transport."

This is the beginning of an agent loop.

4. Reflection: The Step That Makes the Agent Adaptive

Reflection is one of the most important parts of the complete Agent Loop.

After an action, the agent evaluates the result.

It can ask:

  • Did my action succeed?
  • Did I receive useful information?
  • Am I closer to the objective?
  • Should I investigate something else?
  • Should I change my approach?
  • Is there enough evidence to continue?
  • Should I stop?

The source material identifies reflection as a self-assessment step after each action.

For SD-WAN troubleshooting, this can prevent the agent from blindly following a predefined checklist.

For example:

Check WAN transport

Result:

Both transports are operational.

The agent should not necessarily conclude:

"WAN is healthy, therefore WAN is not the problem."

Instead, it can reflect:

"Transport availability is normal. I should investigate latency, packet loss, application path selection, or policy behavior."

It then performs the next appropriate investigation.

5. Cisco SD-WAN Troubleshooting Example

Let's consider a practical example.

A branch office reports:

"The corporate ERP application is very slow."

The AI agent receives the objective:

Investigate the cause of ERP performance degradation.

The agent starts investigating.

Step 1 – Check Device Health

The agent checks the branch SD-WAN device.

Result: Device is operational.

The agent continues.

Step 2 – Check WAN Transports

The agent checks the available WAN transports.

Result: Both transports are available.

The agent continues.

Step 3 – Check Performance

The agent checks latency, jitter, and packet loss.

Result: Transport A has elevated latency and packet loss.

Step 4 – Reflect

The agent evaluates the result:

"Transport A is degraded. I need to determine whether the affected application is using this transport."

Step 5 – Check Application Path

The agent investigates the path being used by the application.

Result: ERP traffic is using Transport A.

Step 6 – Reflect Again

The agent now has stronger evidence:

"The application is using a transport that is experiencing performance degradation."

The agent can now investigate whether an alternate transport is available and whether the configured policy allows the traffic to use it.

This is a practical example of:

Think → Act → Observe → Reflect → Act Again

6. Agent Loop vs Traditional SD-WAN Automation

This distinction is important for network engineers.

Traditional AutomationAgentic Automation
Predefined workflowGoal-oriented workflow
Fixed sequenceDynamic next step
Engineer defines each stepAgent can select the next investigation
Usually predictableContext-dependent
Rule-based decisionsObservation-based decisions
Limited decision-makingReflection after actions
Fixed stopping pointDynamic termination

Traditional automation remains extremely useful.

For repetitive and predictable tasks, a script or predefined workflow may actually be preferable.

Agentic AI becomes more interesting when the problem requires investigation and the next step depends on what was discovered previously.

7. The Most Important Question: When Should the Agent Stop?

An autonomous system should not continue forever.

Imagine an agent repeatedly checking the same WAN path:

Check Path
   ↓
Timeout
   ↓
Check Path
   ↓
Timeout
   ↓
Check Path
   ↓
Timeout
   ↓
Repeat...

This wastes resources and does not solve the problem.

Every agent therefore needs termination conditions.

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

For network automation, these termination conditions are extremely important.

8. Termination Condition #1 – Task Completed

The simplest condition is:

The objective has been achieved.

For example, the agent was asked to investigate why ERP traffic is slow.

After investigation, it identifies the degraded transport and the application path.

If the problem has been safely resolved and verified, the agent can stop.

A final response could be:

"The application was using a WAN transport experiencing packet loss. Traffic was moved to the healthy path and application performance was verified."

The task is complete.

9. Termination Condition #2 – Maximum Iterations

Every autonomous troubleshooting workflow should have a maximum number of attempts.

For example:

Maximum iterations = 10

If the agent reaches ten meaningful actions without reaching a conclusion, it stops.

This prevents an uncontrolled troubleshooting loop.

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

A good response could be:

"I could not determine the root cause within the configured investigation limit. Human investigation is recommended."

10. Termination Condition #3 – Confidence Threshold

An agent may also evaluate its confidence in a particular diagnosis.

For example:

"There is strong evidence that Transport A is responsible for the application performance problem."

However, network engineers should be careful with confidence scores.

An AI system can be confident and still be wrong.

Therefore:

AI confidence should support a decision, not replace engineering validation.

The source material specifically highlights the risk of agent overconfidence and recommends human validation for critical actions.

11. Termination Condition #4 – Human Handoff

Sometimes the agent identifies the likely solution but should not execute it automatically.

For example:

"Transport A is degraded and ERP traffic is using it. I recommend changing the traffic policy to prefer Transport B."

At this point, the agent can request approval.

The workflow becomes:

AI Investigation
       ↓
Diagnosis
       ↓
Recommended Change
       ↓
Human Approval
       ↓
Execute
       ↓
Verify

This is called Human-in-the-Loop, or HITL.

The source material describes HITL as a mechanism where the agent pauses and requests human input when the action is high-stakes or outside its authority.

12. Termination Condition #5 – Error State

Sometimes the problem isn't the network itself.

The management system or required tool may be unavailable.

For example:

Agent
 ↓
Query Management Platform
 ↓
API Unavailable
 ↓
Retry
 ↓
API Unavailable
 ↓
Retry Limit Reached
 ↓
Stop

The agent should report the issue instead of pretending that the investigation was completed.

The source material describes an error state as a situation where a required system is unreachable, a tool repeatedly fails, or a dependency does not respond.

13. What Happens When an AI Agent Gets Stuck?

An AI agent can get stuck even when the network itself is operational.

The source material identifies four important stuck states:

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

Let's translate these concepts into SD-WAN troubleshooting.

14. Stuck State #1 – Loop

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

For example:

Check Tunnel
   ↓
Timeout
   ↓
Check Tunnel
   ↓
Timeout
   ↓
Check Tunnel
   ↓
Timeout

The agent is not learning anything new.

A properly designed system should detect the repeated operation and either try an approved alternative, escalate, or stop.

15. Stuck State #2 – Oscillation

Oscillation occurs when the agent keeps switching between approaches without making progress.

For example:

Check Transport A
       ↓
No conclusion
       ↓
Check Transport B
       ↓
No conclusion
       ↓
Check Transport A
       ↓
Check Transport B
       ↓
Repeat

The agent is changing tactics but not actually moving closer to the objective.

Action-history tracking can help identify this behavior.

16. Stuck State #3 – Dead End

A dead end occurs when all useful investigation paths fail.

For example:

  • Management API unavailable
  • Device access unavailable
  • Performance data unavailable
  • Monitoring data unavailable

The agent has no reliable path forward.

At this point, the safest action is to stop and escalate to a network engineer.

17. Stuck State #4 – Hallucination

Hallucination is particularly important when AI is connected to network automation tools.

An AI agent could potentially assume that a tool or API exists when it does not.

For example, it might attempt to call an invalid API endpoint or provide an incorrect input format.

The source material describes hallucination as attempting to call tools that do not exist or passing invalid inputs.

This is why tool validation and restricted permissions are important when building AI-powered network automation.

18. How Can We Prevent an Agent From Getting Stuck?

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

For SD-WAN automation, we can apply the same principles.

18.1 Set Iteration Limits

Define the maximum number of actions the agent can perform.

18.2 Track Action History

Record what the agent has already checked.

For example:

Action 1: Check device health
Action 2: Check transport
Action 3: Check latency
Action 4: Check application path

The agent can use this information to avoid repeating the same investigation.

18.3 Detect Repeated Actions

If the same operation repeatedly produces the same result, the agent should recognize the pattern.

18.4 Provide Fallback Strategies

If the primary information source is unavailable, use an approved alternative.

For example:

Primary:
Management API

Fallback:
Approved telemetry source

Fallback:
Monitoring platform

Final:
Human escalation

18.5 Escalate to a Human

If all approved automated strategies are exhausted, the agent should involve a network engineer.

The objective isn't to keep the agent autonomous at all costs.

The objective is to solve the problem safely.

19. Human-in-the-Loop in Cisco SD-WAN

HITL becomes particularly important when an agent wants to modify production network behavior.

Imagine the agent determines:

"Transport A has high packet loss. ERP traffic would perform better over Transport B."

The agent can recommend a policy change.

Instead of immediately making the change:

AI Agent
   ↓
Analyze
   ↓
Recommend Change
   ↓
HITL Checkpoint
   ↓
Engineer Approval
   ↓
Execute
   ↓
Verify

The engineer can:

Approve → Agent executes the approved change.

Reject → Agent stops.

Modify → Engineer adjusts the proposed action.

The source material identifies these approval outcomes and emphasizes HITL for important production decisions.

20. When Should Human Approval Be Required?

For SD-WAN automation, human approval can be appropriate for actions such as:

  • Changing traffic policies
  • Modifying routing behavior
  • Changing path preferences
  • Modifying security policies
  • Changing production configuration
  • Actions affecting critical applications
  • Actions outside an approved change window

The source material identifies destructive actions, sensitive operations, uncertainty, policy requirements, and learning-mode deployments as situations where HITL may be required.

A good principle is:

Let AI investigate, but make production changes subject to appropriate controls.

21. Example: AI Agent Troubleshooting a Cisco SD-WAN Branch

Let's put everything together.

Imagine a branch office is experiencing poor ERP application performance.

Objective

"Investigate ERP performance from the branch."

Step 1 – Check Device Health

Result:

Device operational.

Step 2 – Check WAN Transports

Result:

Both transports are available.

Step 3 – Check Performance

Result:

Transport A has elevated packet loss and latency.

Step 4 – Reflect

The agent determines:

"Transport A is degraded. I need to determine whether ERP traffic is using this path."

Step 5 – Check Application Path

Result:

ERP traffic is using Transport A.

Step 6 – Reflect

The agent concludes:

"The degraded transport may be contributing to the application performance problem."

Step 7 – Check Alternate Path

Result:

Transport B is healthy and available.

Step 8 – Generate Recommendation

"Recommend moving ERP traffic to Transport B."

Step 9 – Human Approval

The agent waits for the network engineer.

Step 10 – Execute

The engineer approves the change.

The agent performs the approved action.

Step 11 – Verify

The agent checks the application performance again.

Step 12 – Terminate

The issue is resolved.

This is a complete Agent Loop:

Think → Act → Observe → Reflect → Act → Verify → Stop

22. What Should the Agent Log?

For production SD-WAN environments, logging is extremely important.

A useful agent trace might look like:

Incident ID: INC-10234

09:10 - Task received
09:11 - Branch health checked
09:12 - WAN transports checked
09:13 - Transport A degradation detected
09:14 - Application path analyzed
09:15 - ERP traffic found on Transport A
09:16 - Alternate transport validated
09:17 - Recommendation generated
09:20 - Human approval received
09:21 - Approved action executed
09:22 - Application performance verified
09:23 - Task completed

This creates an audit trail.

If something goes wrong, the engineer can understand:

  • What the agent attempted
  • What it observed
  • Why it made the decision
  • What action was performed
  • Why the agent stopped

The source material emphasizes that termination reasons should be recorded because silent failures make diagnosis and accountability difficult.

23. Why Network Engineers Should Care About Agentic AI

SD-WAN already provides significant automation.

Agentic AI potentially adds another layer.

Traditional SD-WAN

Provides automated connectivity, routing, policy enforcement, and path selection.

AI-Assisted SD-WAN

Helps engineers understand network behavior and investigate problems.

Agentic SD-WAN

Could potentially investigate a problem, collect evidence, determine the next troubleshooting step, recommend remediation, and execute approved actions.

This is why network engineers should understand Agentic AI.

You don't necessarily need to become an AI researcher.

But understanding concepts such as:

  • AI agents
  • Agent loops
  • APIs
  • Tool calling
  • Reflection
  • Termination
  • Human-in-the-Loop
  • Guardrails
  • Automation
  • Observability

can become increasingly valuable.

24. Automation vs Agentic Automation

A simple way to remember the difference is:

Traditional Automation

IF condition
     ↓
Perform predefined action

Agentic Automation

Goal
 ↓
Observe
 ↓
Reason
 ↓
Act
 ↓
Evaluate
 ↓
Select Next Action
 ↓
Repeat

Safe Agentic Automation

Goal
 ↓
Observe
 ↓
Reason
 ↓
Act
 ↓
Evaluate
 ↓
Safety Check
 ↓
Human Approval if Required
 ↓
Verify
 ↓
Terminate

For production networking, the third model is the most useful mental model.

25. Cisco SD-WAN + AI: A Possible Architecture

A conceptual architecture could look like this:

                 Network Engineer
                       │
                       ↓
                  AI Agent
                       │
                       ↓
              Reasoning / Planning
                       │
                       ↓
                Safety Layer
                       │
             ┌─────────┴─────────┐
             ↓                   ↓
       Read Operations      Change Operations
             │                   │
             ↓                   ↓
     SD-WAN Information     HITL Approval
             │                   │
             └─────────┬─────────┘
                       ↓
                  SD-WAN Network
                       │
                       ↓
                Telemetry / Data
                       │
                       └────→ AI Agent

The key component is the Safety Layer.

An AI agent should not have unrestricted access to a production network.

26. Read-Only vs Change-Enabled AI Agents

Network teams can approach AI adoption gradually.

Level 1 – AI Assistant

The engineer asks:

"Why is this SD-WAN path being selected?"

The AI provides an explanation.

Level 2 – Read-Only Agent

The agent can collect operational information such as:

  • Device health
  • Transport status
  • Performance
  • Routing information

But it cannot modify the network.

Level 3 – Investigation Agent

The agent investigates an incident and provides a likely root cause.

For example:

"The application is using a transport experiencing high packet loss."

Level 4 – Recommendation Agent

The agent proposes remediation.

For example:

"Recommend moving the application to the alternate transport."

Level 5 – Human-Approved Automation

The agent proposes the change.

The engineer approves it.

The agent executes it.

Level 6 – Controlled Autonomous Operations

Selected low-risk actions can potentially be automated under strict policies and guardrails.

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

27. Safety: Never Trust an AI Agent Blindly

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

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

The source material highlights several safety considerations, including silent failures, overconfidence, context loss during human handoffs, and automation bias.

For network engineers, remember:

AI recommendation ≠ Network Truth

Critical conclusions should be validated.

For production changes, consider:

  • Change approval
  • RBAC
  • Audit logging
  • Rollback capability
  • Iteration limits
  • Tool restrictions
  • Human approval
  • Post-change verification

28. The Importance of Verification

The agent should not simply perform an action and assume that the problem is solved.

For example:

Agent: Move traffic to Transport B.

That is not the end of the workflow.

The agent should verify:

  • Is traffic now using the expected path?
  • Has packet loss improved?
  • Has latency improved?
  • Is the application responding normally?
  • Did the change introduce another problem?

The complete workflow should therefore be:

Diagnose → Change → Verify → Terminate

This is a familiar concept to network engineers.

After all, we rarely make a production change without checking whether the expected result occurred.

29. The Golden Rules for AI-Based SD-WAN Automation

If you are designing an AI agent for SD-WAN operations, remember these principles:

Rule 1 – Define the Goal

The agent needs a clear objective.

Rule 2 – Limit Iterations

Never allow unlimited execution.

Rule 3 – Track History

Know what the agent has already attempted.

Rule 4 – Detect Loops

Repeated actions should trigger investigation or escalation.

Rule 5 – Provide Fallback Paths

Don't depend on one data source.

Rule 6 – Use Human Approval

High-impact production changes should have appropriate approval.

Rule 7 – Log Important Actions

Maintain a useful audit trail.

Rule 8 – Don't Trust AI Confidence Blindly

Validate important conclusions.

Rule 9 – Verify the Result

After an action, confirm that the expected outcome occurred.

Rule 10 – Define When to Stop

Every agent needs a clear termination strategy.

30. How This Applies to FortiGate SD-WAN

The same Agent Loop methodology can also be applied to FortiGate SD-WAN environments.

The vendor terminology, management interfaces, APIs, and available operational data will be different, but the basic methodology remains the same.

For example:

Application Performance Problem
            ↓
       Understand Goal
            ↓
      Check SD-WAN Health
            ↓
       Observe SLA Status
            ↓
       Analyze Path Choice
            ↓
          Reflect
            ↓
     Identify Likely Cause
            ↓
    Recommend Remediation
            ↓
       Human Approval
            ↓
     Apply Approved Change
            ↓
        Verify Result
            ↓
          Stop

This demonstrates an important point:

The Agent Loop is a methodology rather than a vendor-specific feature.

It can be applied to Cisco SD-WAN, FortiGate SD-WAN, Cisco ACI, and other network platforms when appropriate data and controlled automation interfaces are available.

31. A Simple Mental Model for Network Engineers

If Agentic AI terminology seems complicated, think about how you already troubleshoot a network.

When an application is slow, you don't normally execute commands randomly.

You:

  1. Understand the problem.
  2. Form a hypothesis.
  3. Collect information.
  4. Analyze the result.
  5. Change the hypothesis if necessary.
  6. Investigate another area.
  7. Identify the likely cause.
  8. Apply a controlled fix.
  9. Verify the result.
  10. Close the incident.

This is remarkably similar to an Agent Loop.

The major difference is that an AI agent attempts to automate portions of this reasoning and execution process.

32. Final Thoughts

SD-WAN has already changed the way organizations design and operate WAN infrastructure.

The next evolution could be the combination of:

SD-WAN + APIs + Automation + AI Agents

For network engineers, the most important concept is not simply learning how to build an AI agent.

It is learning how to build an agent that operates safely.

Remember the complete loop:

Think → Act → Observe → Reflect → Decide → Repeat or Stop

Then add the production safeguards:

Iteration Limits + Action History + Fallback Strategies + Logging + Guardrails + Human-in-the-Loop

This combination can turn an AI agent from an interesting experiment into a potentially useful network operations assistant.

The future network engineer may not be the person who manually performs every troubleshooting step.

Instead, it may be the engineer who understands:

What should be automated, what should be delegated to AI, what must be validated, and what should always require human approval.

That is where Agentic AI becomes particularly interesting for Cisco SD-WAN and modern network operations.

33. Frequently Asked Questions

What is an Agent Loop in networking?

An Agent Loop is a process where an AI agent investigates a network objective, performs actions, observes results, reflects on the findings, and decides whether to continue or stop.

Can AI troubleshoot Cisco SD-WAN?

AI agents can potentially assist with SD-WAN troubleshooting by collecting operational information, analyzing performance data, identifying patterns, and recommending the next troubleshooting steps.

Can an AI agent automatically change SD-WAN policies?

An agent can potentially be connected to automation interfaces capable of making configuration changes. However, production changes should be protected by authorization, policy controls, validation, and appropriate human approval.

What is Human-in-the-Loop in SD-WAN?

Human-in-the-Loop means that the AI agent pauses and requests an engineer's approval before performing a decision or action that requires human judgment or carries significant operational risk.

What happens if an AI network agent gets stuck?

The agent should detect repeated actions, oscillation, dead ends, or tool failures and either use an approved fallback strategy, escalate to a human, or terminate.

Is Agentic AI the same as network automation?

No. Traditional automation generally follows predefined workflows, while an AI agent can evaluate observations and dynamically determine the next step within its defined boundaries.

34. Related Articles From Netterrene

Generative AI Fundamentals for Beginners
https://netterrene.blogspot.com/2026/06/generative-ai-fundamentals-for-beginners.html

Agentic AI for Network Engineers
https://netterrene.blogspot.com/2026/07/agentic-ai-for-network-engineers-guide.html

Cisco ACI Explained
https://netterrene.blogspot.com/2026/04/cisco-aci-explained-concepts-learning.html

Cisco ACI vPC Explained
https://netterrene.blogspot.com/2026/06/cisco-aci-vpc-explained-architecture_01563772518.html

Cisco ACI Service Graphs
https://netterrene.blogspot.com/2026/05/why-service-graphs-matter-in-cisco-aci.html

Understanding L3Out Subnet Scope Options in Cisco ACI
https://netterrene.blogspot.com/2025/08/l3out-subnet-scope-options-in-cisco-aci.html

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.


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