skills.rest
freshworks-developers
freshworks-developersOFFICIAL
Explore all skills by this author →
WebsiteGitHub

fw-ai-actions-app

Create Freshworks Platform 3.0 AI actions with flat JSON request schemas.

5|2|Updated Feb 16, 2026
Search Tags:#serverless#validation#schema#api integration#fdk#ai actions#request templates
One-click install
npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-ai-actions-app
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fw-ai-actions-app
Source: https://github.com/freshworks-developers/fw-dev-tools/tree/main/skills/fw-ai-actions-app
Command: npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-ai-actions-app

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires $request, fdk, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a structured approach to implementing AI Actions on Freshworks Platform 3.0, ensuring request schemas are flat, responses are well-structured, and integrations are secure and validated, streamlining the development process.

Core Features & Use Cases

  • Schema Enforcement: Ensures request parameters are flat and responses are nested appropriately.
  • Function Consistency: Maintains exact match between actions.json function names and server.js handlers.
  • API Integration: Utilizes request templates for external API calls to enforce secure, declarative HTTP interactions.
  • Validation & Testing: Supports fdk validate, error sanitization, and test data management for robust deployments.
  • Use Case: Develop a REST API connector that accepts simple parameters, calls third-party services, and outputs minimal structured responses for downstream automation.

Quick Start

Use the fw-ai-actions-app to create an actions.json with flat request parameters, implement handlers with $request.invokeTemplate, and run fdk validate to ensure correctness.

Frequently Asked Questions about fw-ai-actions-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build AI actions with flat JSON request schemas on Freshworks Platform 3.0?▼

To build AI actions with flat JSON request schemas, define parameters in an `actions.json` file and implement corresponding handlers in `server.js` using `$request.invokeTemplate` for external API calls. This ensures platform-compliant, structured request and response handling.

Why does my fdk validation fail for AI actions with mismatched function names?▼

Fdk validation fails when function names in `actions.json` do not exactly match the handler names in `server.js`. Maintaining strict naming consistency between the configuration and implementation files is required for secure, validated deployments.

What is the best way to call external APIs from Freshworks AI actions?▼

The best way to call external APIs from Freshworks AI actions is by using request templates with `$request.invokeTemplate`. This declarative method enforces secure HTTP interactions and simplifies integration with third-party services.

Does Freshworks AI actions support nested JSON response schemas?▼

Yes, Freshworks AI actions support nested JSON response schemas. While request parameters must remain flat, the response structure can be nested appropriately to provide well-structured outputs for downstream automation.

How do I sanitize error responses in serverless AI action integrations?▼

To sanitize error responses in serverless AI action integrations, use this structured approach to process and clean error outputs before deployment. This ensures safe API interactions and prevents raw external errors from disrupting automation workflows.

Can I use OAuth and iparams for secure key management in Freshworks AI actions?▼

Yes, you can use OAuth and iparams for secure key management in Freshworks AI actions. This approach supports secure API integration and request handling while maintaining validation workflows for robust deployments.

Related Skills

Explore More Product & Management Skills→
yu13130122297yu13130122297

scout

Identify uncertainties in research framing, datasets, metrics, and baselines.

Community
Intermediate
valentinmatheyvalentinmathey

bb-tech-error-handling

Standardize Express error handling with custom classes and sanitized client responses.

Community
Advanced
metaloozeemetaloozee
2

convex-http-actions

Create and manage custom HTTP endpoints and webhook handlers in Convex applications.

Community
Advanced
willyu1007willyu1007

validate-backend-inputs

Validate backend HTTP request inputs against defined schemas.

Community
Intermediate