Freddy AI Agent
Customer-facing AI agent in Freshdesk Omni, configured and deployed through AI Agent Studio, that answers from approved knowledge and executes administrator-configured workflows, including chained authenticated API actions against external systems.
Recorded characteristics
- Function
- Freshworks documents a structured execution sequence: the agent receives a message from a supported channel; interprets intent using approved knowledge sources and approved business policies; executes configured workflows with conditional logic, Actions Library integrations and confidence-based escalation, working alongside Freshdesk routing, priority and queue management; generates a response governed by configured behavioural instructions covering tone, formatting, compliance language and response boundaries; and either responds automatically or escalates to a human agent while preserving context. Two agent types share this architecture: a chat AI agent for real-time conversations on the web widget, WhatsApp, Instagram, Messenger, LINE and other Freshchat channels, and an email AI agent that answers inbound support email in Freshdesk mailboxes, portals and web forms. Workflows are built from six modular blocks: Trigger, Collect info, Condition path, API action, Custom response and Agent handoff. Workflows can be started by a customer message or by AI Agent events (conversation start, positive or negative feedback, fallback, transfer to a human agent, and out-of-business-hours transfer). An API action sends a request to a configured REST endpoint or MCP server, receives a response and exposes selected fields as workflow variables; GET, POST, PUT, PATCH and DELETE are supported, request bodies and URL path parameters can reference workflow variables, and the output of one API action can be used as the input to a subsequent API action in the same workflow. Freshworks' documented worked example chains Fetch Order Details into a condition on order status and then Initiate Refund using customer, total and payment-method values taken from the prior response. Deployed agents can also interpret customer-sent images (.png, .jpg, .jpeg) and respond with troubleshooting steps or policy links.
- Data access
- Knowledge grounding is administrator-configured: solution articles, uploaded files (.txt, .docx, .pdf, maximum 35MB, not password-protected), publicly accessible URLs and custom Q&As. Freshworks states the agent cannot learn from private URLs and learns only from static text, not video, animation or screenshots. Documented limits include a maximum of 200 files per agent and per account, a maximum of 10 URLs per agent and 25 per account, and learning up to 3,000 pages from a website; the AI Agent Studio limits table separately lists 50 parent URLs and 3,000 child links per parent, so exact current URL limits differ between Freshworks pages. Operational data access is separate and occurs only through workflows: the Collect info block gathers structured customer input, Condition path rules can reference contact and ticket properties, and API actions retrieve data from the specific endpoints an administrator has configured. Freshworks does not document arbitrary access to account or external data outside configured knowledge sources and configured API actions.
- Actions
- Can take actions
- External actions
- Conditional
- Human confirmation
- Conditional
- Permission basis
- Separate permissions
- Administrative control
- Documented administrator controls include: creating, testing, previewing, deploying, archiving and restoring AI agents (archiving a published agent unpublishes and unmaps it); selecting chat or email agent type; name, avatar and primary language; knowledge sources and their removal, restoration and performance review; business context and custom instructions; multilingual support; conversation behaviour (introductory message, tone, response length, fallback handling, feedback, user-detail collection); handover settings covering conversation closure, transfer to a human agent, auto-resolution timing and out-of-business-hours transfer; workflow creation by visual builder or natural-language authoring, workflow drafts, versioning, cloning, deletion and library management; mapping workflows to AI Agent events, with validations that block deleting or unlinking workflows still mapped to events; the API Actions library, including creating, editing, cloning and deleting actions, defining input and output variables, and testing an action against the live endpoint; reusable Authentication configurations; channel mapping and deployment, and for email agents deployment to specific mailboxes, portals and web forms; single-query preview and bulk evaluation testing; and session consumption, performance dashboards, conversation logs and recommended fixes.
- Default state
- Disabled
- Availability
- Freshworks documents Freddy AI Agent Studio as Freddy AI functionality in Freshdesk Omni. The API actions documentation states the account must be on Freshdesk Omni or have AI Agent Studio enabled, that administrator access is required, and that at least one AI agent must exist. Chat AI agent setup lists a Freshdesk Omni plan with AI Agent Studio enabled as a prerequisite. Documented system limits include 50 AI agents in total across chat and email per account, 150 workflows per account, 20 workflows per AI agent and 100 nodes per workflow. Natural Language Workflows are documented as available through an Early Access Program requiring Customer Success Manager approval; the rest of the capability is documented as generally available functionality.
- Licensing
- Freshworks documents AI Agent usage as session-based: a chat session covers all interactions between a customer and the agent within a 24-hour window, and an email session is a 72-hour window from the customer's first email. Session packs are sold in units of 100 sessions for $49 through the billing page, and session consumption is shown in AI Agent Studio. Freshworks also documents Freddy AI as an add-on in the Freshdesk Omni getting-started guide.
- External model or provider
- Not established. The current Freshdesk AI Agent Studio documentation reviewed does not identify an underlying model provider, model family, model version or any model-selection or routing control available to administrators.
- Limitations and uncertainty
- Authority exists only where an administrator has configured it: the agent can call only the specific endpoints defined as API actions, using credentials stored in a reusable Authentication configuration (API key, bearer token, basic auth or OAuth 2.0), so this is configured integration authority rather than arbitrary external access or the customer's own permissions. Freshworks lists an integration catalogue spanning payments, e-commerce, shipping, CRM, support and ITSM, project management, HR, identity, messaging, marketing, scheduling, finance and travel, but that catalogue describes what workflows can be built to do rather than proving each operation exists by default. The documented refund example demonstrates configured refund authority in one workflow; it does not establish universal payment or refund authority. Confirmation before sensitive actions is an available workflow design pattern, not a platform-wide guarantee, and Freshworks states that confirmation blocks are skipped for email agents because there is no live conversation, advising safeguards at the API layer instead. Failure behaviour is documented only for chat: an API timeout or failure routes the workflow to the fallback path; no retry, rollback or transaction guarantee is documented. Freshworks states the Trigger block cannot act on system events or detect sentiment. Confidence-based escalation is documented in the architecture description, but a configurable confidence threshold is not established in the pages reviewed. Session history, conversation logs and performance analytics are documented for administrators, but they are not described as immutable audit logs. Freshworks' statements about customer data and AI model training were not established from the primary support documentation reviewed. This record covers the Freshdesk Omni customer-support agent only; Freshservice AI agents, Freddy AI Copilot, Freddy AI Insights and Freshdesk chatbots are separate and are not represented here. MCP is listed as a supported connection option for API actions, but the exact scope of MCP support for this capability is not fully established.
Evidence
- Create and manage AI agents
Supports: Function · Data access · Admin controls · Default state · Limitations · General · Primary source
Documents image-based query resolution for .png, .jpg and .jpeg images sent by customers on deployed channels.
Documents supported knowledge types and limits: file formats and 35MB size, 200 files per agent and per account, 10 URLs per agent and 25 per account, learning up to 3,000 pages from a website, public URLs only, and static text only.
Documents agent creation, knowledge, workflows, instructions, configurations, handover settings, testing, preview, deployment, performance analysis and archive or restore.
Documents that an agent must be created, configured with knowledge, tested and deployed to a channel, and that archiving a published agent unpublishes and unmaps it.
States the agent cannot learn from private URLs and does not learn from video, animation or screenshots.
Documents performance dashboards, deflection rate, topic distribution, recommended fixes and conversation logs available to administrators.
- Introduction to AI Agent Studio
Supports: Function · Data access · Availability · Licensing · Primary source
Documents the AI agent architecture and operational flow (message received, intent interpreted using approved knowledge and business policies, configured workflows executed with conditional logic and Actions Library integrations, response generated under behavioural instructions, then automatic response or escalation preserving context) and the two supported agent types, chat and email.
Lists knowledge sources (files, articles, FAQs, workflows) as prerequisites for agent configuration and lists further AI Agent Studio limits including 50 parent URLs and 3,000 child links per parent.
Documents AI Agent usage limits including 50 agents across chat and email, 150 workflows per account, 20 per agent and 100 nodes per workflow.
Documents the session model, session consumption display and purchase of session packs of 100 sessions for $49.
- Workflows for AI Agents
Supports: Function · Data access · Actions · External actions · Human confirmation · Admin controls · Primary source
Documents the six modular workflow blocks and the use of workflows to collect data, branch on conditions, call APIs, respond and hand off.
Documents the Collect info block storing customer input as workflow variables and Condition path rules referencing contact and ticket properties.
Documents workflows driving backend actions such as creating or updating tickets, updating records and triggering downstream processes, and the Agent handoff block transferring a conversation to a group of human agents.
Lists the integration catalogue available to workflows across payments, e-commerce, shipping, CRM, support and ITSM, project management, HR, identity, messaging, marketing, scheduling, finance and travel.
Documents the Agent handoff block being used where a condition determines the issue exceeds AI scope or where compliance requires human review before an action.
Documents mapping workflows to AI Agent events and the validations blocking deletion or removal of workflows still mapped to events.
- Build workflows: no code agentic workflows
Supports: Function · Limitations · Primary source
Documents the workflow builder blocks as the mechanism by which the AI agent collects information, evaluates conditions, takes action and hands off.
States the Trigger block responds only to customer queries and cannot act on system events or detect sentiment.
- Write AI Agent workflows with Natural Language Workflows
Supports: Function · Availability · Primary source
Documents natural-language authoring of workflows on the same workflow platform and lifecycle as builder workflows, as an authoring method rather than a separate runtime.
States Natural Language Workflows are currently available through an Early Access Program requiring Customer Success Manager approval.
- Connect to external systems using API actions
Supports: Data access · Actions · External actions · Human confirmation · Permission basis · Admin controls · Availability · Limitations · Primary source
Documents output variables mapped from API responses by JSON path and made available to later workflow blocks.
States that when a workflow runs an API action it sends a request to an external system, receives a response and allows the agent to perform real operations including fetching data, triggering actions and orchestrating multi-step processes; documents GET, POST, PUT, PATCH and DELETE, request bodies and path parameters referencing workflow variables, output of one API action used as input to a subsequent action, and the worked example chaining Fetch Order Details, a condition on order status and Initiate Refund.
States the account needs access to a REST API endpoint or a configured MCP server, that workflows can connect securely to Freshworks and third-party systems using MCP, and that test requests use real values and may affect the external system, advising a sandbox for write operations such as order cancellations or refunds.
States that workflows can ask customers for confirmation before executing sensitive actions, as an available configuration rather than a platform-wide requirement, and that for email agents confirmation blocks are skipped because there is no live conversation, with safeguards advised at the API layer.
Documents reusable Authentication configurations using API key, bearer token, basic auth or OAuth 2.0 credentials, stored securely and selected per API action so the external system trusts the request, and states administrator access is required to create and manage API actions, separating administrator configuration from the credentials used at runtime.
Documents the API Actions library, action creation, editing, cloning, deletion, input and output variables and live testing.
States the account must be on Freshdesk Omni or have AI Agent Studio enabled and that at least one AI agent must exist.
States that in chat, API action blocks execute synchronously and a timeout or failure routes the workflow to the fallback path.
- AI Actions overview (Freshworks developer documentation)
Supports: Actions · Primary source
Documents custom AI Actions apps that expose typed operations, such as updating a record or applying business logic, which the workflow API action block invokes.
- Chat AI Agent setup and channels
Supports: Permission basis · Admin controls · Primary source
States administrator access to AI Agent Studio is required to create and configure chat AI agents.
Documents multilingual support, conversation behaviour, handover settings and agent identity configuration.
- Workflow library in AI Agent Studio
Supports: Admin controls · Primary source
Documents the workflow library, cloning, workflow states and versioning so an active version keeps running while a draft is prepared.
- Email AI Agent setup and configuration
Supports: Default state · Primary source
States prerequisites for deployment including administrator role, at least one configured mailbox and at least one knowledge source.
- Getting Started with Freshdesk Omni
Supports: Licensing · Primary source
Documents Freshdesk Omni product scope and Freddy AI as an add-on covering AI Agent Studio, Copilot and Insights.