Skip to content

Agentic Flows: the field guide

A practical handbook for website teams

One helpful assistant—or a small team with clearly divided jobs?

Agentic Flows lets SmartSite Assistant choose a specialist for the visitor’s current need, give that specialist only the relevant instructions and capabilities, and move the conversation when the need changes. The feature is powerful when your customer journey has genuinely different jobs. It is unnecessary when one well-written Assistant can already do the work.

Visitor asksSmartSite routesBest-fit specialist answersTools act safely

Advanced is not automatically better. A larger flow introduces more instructions, more routing decisions, more testing, and more ways to create overlapping responsibilities. The reward is stronger separation of duties: a booking specialist can collect appointment details, a returns specialist can follow a returns policy, and a de-escalation specialist can slow down an emotionally difficult exchange.

Choose Basic

One assistant, one coherent voice

Best for general website questions, modest knowledge bases, a few tools, and sites where most conversations follow the same rules.

  • Fewer settings to maintain
  • No specialist-routing ambiguity
  • The existing Assistant and Tools behavior
Choose Advanced

Several jobs, deliberately separated

Best when visitor goals need meaningfully different instructions, tools, risk controls, or conversational styles.

  • Specialists with bounded responsibilities
  • Explicit routes and handoffs
  • Per-run traces, approvals, revisions, and rollback
A decision table for real websites
SituationUsually the better fitWhy
A brochure site answers opening-hours, service, and contact questions Basic Assistant Those requests share the same knowledge and conversational rules. Splitting them into agents adds little value.
A clinic handles general information, appointment intake, billing questions, and distressed visitors Advanced Agents The jobs have different boundaries, tools, tones, and escalation needs.
A shop has one order-status lookup tool and otherwise answers product FAQs Start with Basic One Assistant can call a well-described tool. Add specialists only if support and sales behavior genuinely diverge.
A membership organization serves several departments with distinct policies and forms Advanced Agents Separate scopes can reduce instruction conflicts and attach each capability to its responsible specialist.
The team has not defined ownership, success criteria, or safe action rules Basic for now Agentic routing cannot repair an unclear business process. Design the process first.
1

Base Assistant

Your normal selected Assistant. It handles greetings, broad website questions, and general knowledge. It is also the safe place to return when no specialist clearly owns the request.

2

Specialist agent

A focused role with its own description, instructions, model settings, knowledge access, and assigned tools. Visitors should experience a seamless answer—not an announcement about internal agents.

3

Tool

A capability, such as looking up information, sending an email, or calling a webhook. A tool is not a specialist. It does one defined thing on behalf of the specialist that owns it.

4

Handoff

An explicit permission and rule for moving from one conversational owner to another. It defines where the conversation may go and the visitor intent that justifies the move.

The visitor does not select an agent from a menu. SmartSite considers the newest message, current conversational owner, specialist scopes, explicit handoff conditions, and the workflow routing policy. It then starts or continues the appropriate owner. When an agent needs a capability, the model may request an enabled tool assigned to that agent. Protected actions pause for confirmation before execution.

This follows the established agent-design idea of combining a model, instructions, and tools, then using orchestration to assign work among specialists. OpenAI’s general Agents overview describes the same high-level building blocks. SmartSite implements its own WordPress workflow runtime using a PHP agent package; it does not embed the official OpenAI Agents SDK. The reference is included to explain the wider concept, not to claim the products are identical.

Find the switch at AI Website Chat → API Settings → Advanced Agents.

When Enable Advanced Agents runtime is off:

  • Visitor requests use the Basic Assistant and its normal Tools path.
  • Agent Flows stays visible in the plugin menu, but the page is locked. Admins see a clear disabled-feature explanation instead of being able to change or test flows.
  • Existing flows remain stored. Turning the runtime off does not delete their agents, tools, handoffs, drafts, or published versions.
  • A published flow is not used for visitor replies while the switch is off.

When the switch is on:

  • SmartSite tries the Advanced runtime for chat requests.
  • The active published workflow supplies the specialist configuration. Draft edits do not silently affect visitors.
  • If no workflow is published, the Base Assistant remains available.
  • If Advanced is unavailable or fails before it has committed an external action, SmartSite can fall back to the Basic runtime. After an uncertain or committed action, it avoids a blind retry because that could duplicate an email, webhook, or other side effect.

What “agentic” should feel like to a visitor

Section titled “What “agentic” should feel like to a visitor”

A well-designed flow is invisible. The visitor receives one continuous conversation in their language. They should not be told “I am transferring you to the Billing Agent,” see an internal agent key, or need to repeat details that were already collected. The internal team structure exists to improve the answer—not to make the chat feel like a telephone switchboard.

Consider this appointment conversation:

VisitorI need to move my appointment from Tuesday.

Appointments specialistOf course. What name and contact detail was the appointment booked under, and which day would suit you instead?

VisitorBefore that—will I lose my deposit?

Appointments specialistThe answer should come from the published cancellation policy or the appropriate billing scope, not from a guess.

The good experience is not “more agents.” It is correct ownership, remembered context, grounded facts, and an explicit pause before any real-world action.

Use Agentic Flows for bounded business journeys such as:

  • appointment intake, rescheduling, and preparation;
  • product advice separated from existing-order support;
  • lead qualification followed by a confirmed submission;
  • triage across services, departments, languages, or policy areas;
  • a calm de-escalation path for clearly frustrated visitors;
  • controlled transitions between information gathering and an external action.

Do not use Agentic Flows as a substitute for:

  • accurate website content and a synchronized Knowledge Base;
  • properly configured and tested SmartSite Tools;
  • human support for emergencies, regulated professional advice, complaints requiring formal review, or situations the website must not automate;
  • clear privacy notices and data-minimization decisions;
  • a business process that staff themselves cannot explain consistently.

Do

  • Give one agent one recognizable job.
  • Keep Base Assistant as the owner of broad questions.
  • Use explicit entry handoffs for important specialist paths.
  • Require human confirmation before consequential actions.
  • Test topic changes, corrections, anger, ambiguity, and cancellation—not only happy paths.

Do not

  • Create a specialist for every page or product.
  • Copy the same broad instructions into every agent.
  • Give every tool to every specialist.
  • Assume a polished answer proves the route or action was correct.
  • Publish because Flow Checks are green without running realistic conversations.

This section is deliberately a handbook rather than a repeated settings-page template:

  1. Design a flow people can trust turns a customer journey into a small map.
  2. Write specialists that know their job explains every Agent field and provides instruction patterns.
  3. Give agents capabilities—and safe exits covers Tool and Handoff fields, confirmation, and unsafe HTTP.
  4. Tune routing without creating chaos explains route decisions, starts, switching, confidence, stickiness, and fallback.
  5. Test, publish, observe, improve covers the simulator, readiness checks, versions, rollback, health, and trace interpretation.
Advanced Agents switch and disabled Agent Flows state
Capture
Capture the Advanced Agents setting enabled in one synthetic environment. If practical, compose it beside the Agent Flows disabled screen from a second capture.
Show
Advanced Agents toggle, Beta label, explanatory copy, Agent Flows disabled state, and link back to API Settings
Viewport
Desktop, 1440 × 1000
Annotate
Label ‘Basic runtime’ and ‘Advanced runtime’; do not annotate unrelated API credentials.
Redact
API keys, private URLs, personal data, real visitor messages, and production action details

Further reading, without the developer jargon

Section titled “Further reading, without the developer jargon”
  • OpenAI’s Agents overview explains why specialist instructions, tools, handoffs, approvals, and tracing belong together in an agent system.
  • OpenAI’s Using tools explains the broader principle that tools extend what a model can do beyond writing text.
  • OpenAI’s observability guide explains why traces matter: they let teams inspect what actually happened before turning individual examples into repeatable evaluations.

These sources describe OpenAI’s platform and SDK concepts. For exact SmartSite behavior and controls, use this handbook and the current plugin interface.