diff --git a/apps/web/data/tools-export.json b/apps/web/data/tools-export.json new file mode 100644 index 0000000..1f6cf17 --- /dev/null +++ b/apps/web/data/tools-export.json @@ -0,0 +1,844696 @@ +{ + "metadata": { + "exportedAt": "2026-01-01T06:06:02.809Z", + "count": 10000, + "minQuality": 0.5, + "excludeNonsensical": false + }, + "tools": [ + { + "name": "infrastructure-management.generateMarkdown", + "description": "Generates a detailed markdown report summarizing the configuration, status, and metadata of specified cloud or physical infrastructure resources. Accepts structured input describing infrastructure components and outputs a human-readable markdown document suitable for documentation or auditing.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "infrastructureData", + "type": "object", + "description": "Structured object containing details about the infrastructure components, including types, configurations, statuses, and metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title to display at the top of the markdown report.", + "required": false, + "defaultValue": "Infrastructure Report" + }, + { + "name": "includeStatus", + "type": "boolean", + "description": "Whether to include the current operational status of infrastructure elements in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include additional metadata and tags associated with the infrastructure components.", + "required": false, + "defaultValue": "true" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Preferred date format string to display timestamps within the report (e.g., YYYY-MM-DD).", + "required": false, + "defaultValue": "YYYY-MM-DD" + }, + { + "name": "sectionOrder", + "type": "array", + "description": "Array specifying order of sections such as ['Overview', 'Details', 'Status', 'Metadata']. If empty or omitted, default order is used.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated markdown string under the key 'markdownContent'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce comprehensive markdown documentation from infrastructure configuration data. Ideal for generating README files, audit reports, or status summaries that make complex infrastructure details accessible and easy to share with stakeholders.", + "limitations": "This tool does not perform live querying or validation of infrastructure states; it relies solely on provided input data. It also does not convert markdown to other document formats.", + "examples": [ + "Generate a markdown report from JSON describing a multi-cloud environment setup with statuses and metadata.", + "Create a summary markdown document for on-premise server racks including configurations and tags.", + "Produce an infrastructure documentation markdown section with custom title and date format." + ] + }, + "tags": [ + "infrastructure", + "markdown", + "documentation", + "reporting", + "cloud", + "physical", + "status", + "metadata" + ], + "examples": [ + { + "inputJson": "{\"infrastructureData\":{\"servers\":[{\"name\":\"web01\",\"type\":\"VM\",\"os\":\"Ubuntu 20.04\",\"status\":\"running\",\"metadata\":{\"location\":\"datacenter1\",\"owner\":\"teamA\"}},{\"name\":\"db01\",\"type\":\"Database\",\"engine\":\"PostgreSQL\",\"status\":\"stopped\",\"metadata\":{\"location\":\"datacenter2\",\"owner\":\"teamB\"}}],\"networks\":[{\"name\":\"internal-net\",\"cidr\":\"10.0.0.0/24\",\"status\":\"active\"}]},\"title\":\"Weekly Infrastructure Report\",\"includeStatus\":true,\"includeMetadata\":true,\"dateFormat\":\"YYYY-MM-DD\",\"sectionOrder\":[\"Overview\",\"Details\",\"Status\",\"Metadata\"]}", + "description": "Generate a markdown infrastructure summary including servers and networks with status and metadata in a custom section order." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Markdown", + "context": null + } + }, + { + "name": "etl-processes.generateHeading", + "description": "Generates a formatted heading string for use in ETL reports or data processing logs. Accepts a base title, optional subtitle, heading level, and formatting options, then outputs a properly formatted heading text suitable for display or inclusion in ETL documentation or data pipelines.", + "category": "etl-processes", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main text for the heading to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "subtitle", + "type": "string", + "description": "An optional subtitle to appear below the main heading.", + "required": false, + "defaultValue": "" + }, + { + "name": "headingLevel", + "type": "number", + "description": "Level of the heading from 1 to 6, determining its importance/format style.", + "required": false, + "defaultValue": "1" + }, + { + "name": "useMarkdown", + "type": "boolean", + "description": "Whether to format the heading using Markdown syntax.", + "required": false, + "defaultValue": "true" + }, + { + "name": "uppercase", + "type": "boolean", + "description": "If true, converts the heading texts to uppercase.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted heading string under key 'headingText'." + }, + "aiAgent": { + "useCase": "Use this tool when constructing ETL process documentation, logs, or generated reports that require clear hierarchical headings with optional formatting. It helps generate consistent, styled headings for step indications or section titles in ETL pipelines or extracted data summaries.", + "limitations": "This tool only generates text headings and does not produce styled HTML or rich text formats beyond markdown. It does not create multi-language headings or perform text translations.", + "examples": [ + "Generate a level 2 markdown heading with a subtitle for an ETL extraction step.", + "Create an uppercase level 1 heading without markdown formatting.", + "Produce a simple level 3 heading as plain text." + ] + }, + "tags": [ + "etl", + "heading", + "generate", + "formatting", + "documentation", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Data Extraction Step\",\"subtitle\":\"Extracting user data from API\",\"headingLevel\":2,\"useMarkdown\":true,\"uppercase\":false}", + "description": "Generate a markdown level 2 heading with a subtitle for an ETL extraction step." + }, + { + "inputJson": "{\"title\":\"FINAL REPORT\",\"subtitle\":\"Summary of Process\",\"headingLevel\":1,\"useMarkdown\":false,\"uppercase\":true}", + "description": "Create an uppercase level 1 heading without markdown formatting." + }, + { + "inputJson": "{\"title\":\"Transformation Details\",\"headingLevel\":3,\"useMarkdown\":false,\"uppercase\":false}", + "description": "Produce a simple level 3 heading as plain text with no subtitle." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "model-management.generateHeading", + "description": "Generates a concise, informative heading or title for an AI model training, deployment, or management report or document. Accepts input parameters describing the model type, purpose, and context to produce a clear heading string suitable for documentation or summaries.", + "category": "model-management", + "parameters": [ + { + "name": "modelType", + "type": "string", + "description": "Type or name of the AI model (e.g., 'Transformer', 'CNN', 'Recommendation Engine').", + "required": true, + "defaultValue": "" + }, + { + "name": "taskDomain", + "type": "string", + "description": "The application domain or problem area the model addresses (e.g., 'image classification', 'natural language processing').", + "required": true, + "defaultValue": "" + }, + { + "name": "action", + "type": "string", + "description": "The main action or focus related to the model lifecycle (e.g., 'training', 'deployment', 'evaluation').", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Intended audience for the heading, such as 'data scientists', 'project stakeholders', or 'developers'.", + "required": false, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The tone or style of the heading: 'formal', 'concise', 'informative', or 'creative'.", + "required": false, + "defaultValue": "concise" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading string ready for use in reports or UI." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to produce clear and context-aware headings or titles for documents or reports pertaining to AI model lifecycle stages, such as summarizing model training results, deployment status, or evaluation findings. It helps maintain consistency and professionalism in generated content.", + "limitations": "The tool cannot generate lengthy summaries or detailed content beyond the heading. It relies on accurate input parameters; insufficient or vague inputs may yield generic or less relevant headings.", + "examples": [ + "Generate a heading for a CNN model used in image classification during deployment for developers.", + "Create an informative heading for a Transformer model training report targeting data scientists.", + "Produce a concise title for evaluation results of a recommendation engine for stakeholders." + ] + }, + "tags": [ + "model-management", + "generate", + "heading", + "AI documentation", + "reporting", + "title generation" + ], + "examples": [ + { + "inputJson": "{\"modelType\":\"Transformer\",\"taskDomain\":\"natural language processing\",\"action\":\"training\",\"audience\":\"data scientists\",\"style\":\"informative\"}", + "description": "Generate an informative heading for training a Transformer model in NLP targeted at data scientists." + }, + { + "inputJson": "{\"modelType\":\"CNN\",\"taskDomain\":\"image classification\",\"action\":\"deployment\",\"audience\":\"developers\",\"style\":\"concise\"}", + "description": "Create a concise heading for deploying a CNN model for image classification aimed at developers." + }, + { + "inputJson": "{\"modelType\":\"Recommendation Engine\",\"taskDomain\":\"e-commerce personalization\",\"action\":\"evaluation\",\"audience\":\"project stakeholders\",\"style\":\"formal\"}", + "description": "Produce a formal heading for evaluation results of a recommendation engine targeting project stakeholders." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "infrastructure-management.sendNotification", + "description": "Sends notifications to specified recipients regarding infrastructure events or alerts. Accepts message content, recipient details, notification channels (such as email, SMS, or Slack), and priority settings. Processes the inputs to dispatch messages via the chosen channels and returns the delivery status and any error messages.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "messageContent", + "type": "string", + "description": "The main content text of the notification message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient identifiers such as email addresses, phone numbers, or user IDs for messaging platforms.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "Channels to send notifications through; supported options include 'email', 'sms', 'slack'.", + "required": true, + "defaultValue": "[\"email\"]" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification such as 'low', 'normal', or 'high'.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for the notification if applicable (e.g., for email notifications).", + "required": false, + "defaultValue": "" + }, + { + "name": "sendTime", + "type": "string", + "description": "ISO 8601 timestamp string specifying scheduled send time; sends immediately if empty.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the overall status of the send operation, a breakdown of results per channel and recipient, and any error messages encountered." + }, + "aiAgent": { + "useCase": "Use this tool to notify infrastructure teams or automated systems about critical events, maintenance windows, status updates, or alerts needing immediate attention. It supports different communication channels and allows scheduling or prioritization to manage notifications effectively.", + "limitations": "Cannot generate message content automatically; requires preformatted message input. Limited to predefined channels and requires valid recipient identifiers. Does not guarantee delivery confirmation beyond channel receipt acknowledgement.", + "examples": [ + "Send a high-priority email alert to the on-call team about a server outage.", + "Dispatch SMS and Slack notifications to multiple recipients about maintenance schedule.", + "Schedule a low-priority notification email with a subject about upcoming infrastructure upgrades." + ] + }, + "tags": [ + "notification", + "infrastructure", + "alerts", + "communication", + "email", + "sms", + "slack", + "priority" + ], + "examples": [ + { + "inputJson": "{\"messageContent\":\"Server cluster 5 is down. Immediate action required.\",\"recipients\":[\"oncall@example.com\",\"ops-team@example.com\"],\"channels\":[\"email\"],\"priority\":\"high\",\"subject\":\"URGENT: Server Outage Alert\",\"sendTime\":\"\"}", + "description": "Send a high-priority email notification to on-call and ops team about a critical server outage." + }, + { + "inputJson": "{\"messageContent\":\"Scheduled maintenance tonight from 10pm to 1am.\",\"recipients\":[\"+1234567890\",\"+1987654321\"],\"channels\":[\"sms\",\"slack\"],\"priority\":\"normal\",\"subject\":\"\",\"sendTime\":\"\"}", + "description": "Send SMS and Slack notifications about scheduled maintenance to a list of phone numbers and Slack users." + }, + { + "inputJson": "{\"messageContent\":\"Infrastructure upgrade next week.\",\"recipients\":[\"infra-team@example.com\"],\"channels\":[\"email\"],\"priority\":\"low\",\"subject\":\"Upcoming Upgrade\",\"sendTime\":\"2024-06-15T08:00:00Z\"}", + "description": "Schedule a low priority email notification about an upcoming infrastructure upgrade to be sent on a specific date and time." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "legal-tools.createDocument", + "description": "Creates a customizable legal document based on user-provided specifications, such as document type, parties involved, key terms, and governing law. Processes inputs to generate a draft legal contract or agreement in a structured text format, ready for review and further legal refinement.", + "category": "legal-tools", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of legal document to create (e.g., 'NDA', 'Service Agreement', 'Employment Contract').", + "required": true, + "defaultValue": "" + }, + { + "name": "parties", + "type": "array", + "description": "List of parties involved in the document, each with a name and role.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "keyTerms", + "type": "object", + "description": "Key terms and clauses to include in the document, provided as a dictionary of term names to definitions or values.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "governingLaw", + "type": "string", + "description": "The jurisdiction or governing law to which the document is subject.", + "required": false, + "defaultValue": "" + }, + { + "name": "effectiveDate", + "type": "string", + "description": "The effective date of the document in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "includeConfidentialityClause", + "type": "boolean", + "description": "Whether to include a confidentiality clause in the document.", + "required": false, + "defaultValue": "false" + }, + { + "name": "additionalClauses", + "type": "array", + "description": "List of additional custom clauses or provisions as free text to append to the document.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns the generated legal document including a structured text draft and metadata such as summary and included clauses." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a draft legal document tailored to specific details like parties, key terms, and governing law for contracts, agreements, or other legal instruments. It supports creating initial drafts before review by legal professionals.", + "limitations": "The tool generates drafts based on templates and provided inputs but cannot provide legal advice or guarantee compliance with all local laws or regulations. Review by a qualified attorney is necessary before final use.", + "examples": [ + "Create a non-disclosure agreement between Company A and Company B with confidentiality clause included.", + "Generate a service agreement effective 2024-07-01 governing law California, involving two companies and standard payment terms.", + "Draft an employment contract with customized benefits and termination clauses." + ] + }, + "tags": [ + "legal", + "document-creation", + "contract", + "compliance", + "drafting" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"NDA\",\"parties\":[{\"name\":\"Alpha Corp\",\"role\":\"Disclosing Party\"},{\"name\":\"Beta LLC\",\"role\":\"Receiving Party\"}],\"keyTerms\":{\"duration\":\"2 years\",\"scope\":\"Confidential information exchange\"},\"governingLaw\":\"Delaware\",\"effectiveDate\":\"2024-06-01\",\"includeConfidentialityClause\":true,\"additionalClauses\":[]}", + "description": "Generate a 2-year NDA between Alpha Corp and Beta LLC under Delaware law including confidentiality clause." + }, + { + "inputJson": "{\"documentType\":\"Service Agreement\",\"parties\":[{\"name\":\"Gamma Solutions\",\"role\":\"Provider\"},{\"name\":\"Delta Industries\",\"role\":\"Client\"}],\"keyTerms\":{\"paymentTerms\":\"Net 30\",\"services\":\"IT consulting and support\"},\"governingLaw\":\"New York\",\"effectiveDate\":\"2024-07-15\",\"includeConfidentialityClause\":false,\"additionalClauses\":[\"Service level agreement attached as annex.\"]}", + "description": "Create a service agreement for IT consulting with payment terms and additional SLA clause." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Document", + "context": null + } + }, + { + "name": "marketing-automation.composeWord", + "description": "Generates a creative marketing word or short phrase optimized for campaign themes based on input keywords, tone preference, and target audience. Accepts an array of keywords and outputs a compelling word or phrase that fits marketing contexts such as branding, slogans, or product naming.", + "category": "marketing-automation", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "An array of strings representing key themes, concepts, or product features to inspire the generated word or phrase.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the word phrase, e.g., 'professional', 'playful', 'innovative'. Guides the style of the generated output.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word or phrase, including spaces, to ensure suitability for marketing materials.", + "required": false, + "defaultValue": "20" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience descriptor, such as 'tech-savvy millennials' or 'small business owners'. Helps tailor the wording to audience preferences.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing word or phrase as a string, plus metadata like tone used and keywords reference." + }, + "aiAgent": { + "useCase": "Use this tool when needing creative single words or short phrases as branding elements, slogans, or campaign titles derived from given keywords and tone preferences. It aids in rapid ideation tailored to audience and style requirements.", + "limitations": "Cannot create long marketing copy or full sentences; focuses only on succinct words or brief phrases. May not capture extremely niche jargon accurately without proper keywords.", + "examples": [ + "Generate a playful brand name for an eco-friendly apparel line using keywords 'green','style','comfort'.", + "Create a professional product slogan word for a SaaS tool targeting small businesses.", + "Produce an innovative short phrase combining 'speed' and 'security' for a tech startup." + ] + }, + "tags": [ + "marketing", + "content-generation", + "branding", + "slogan", + "creative-writing", + "automation" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"green\",\"style\",\"comfort\"],\"tone\":\"playful\",\"maxLength\":15,\"audience\":\"eco-conscious young adults\"}", + "description": "Generate a playful word or phrase for an eco-friendly apparel brand targeting young adults." + }, + { + "inputJson": "{\"keywords\":[\"speed\",\"security\"],\"tone\":\"innovative\",\"maxLength\":20,\"audience\":\"tech-savvy professionals\"}", + "description": "Create an innovative slogan word or phrase combining ideas of speed and security for a tech product." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Word", + "context": null + } + }, + { + "name": "frontend-development.analyzeHeading", + "description": "Analyzes an HTML heading element string or a plain text heading along with its level to evaluate semantic correctness, readability, and accessibility compliance. The tool identifies issues such as missing heading levels, poor contrast, and suggests improvements. Outputs a detailed report with scores and recommendations.", + "category": "frontend-development", + "parameters": [ + { + "name": "headingHTML", + "type": "string", + "description": "HTML string of the heading element to analyze (e.g., '
Hello User, welcome to our service.
\",\"attachments\":[]}", + "description": "Simple email with one recipient, subject, and both plain text and HTML body, no attachments." + }, + { + "inputJson": "{\"from\":\"support@example.com\",\"to\":[\"client@example.com\"],\"cc\":[\"manager@example.com\"],\"bcc\":[\"auditor@example.com\"],\"subject\":\"Monthly Report\",\"bodyText\":\"Please find the monthly report attached.\",\"bodyHtml\":\"Please find the monthly report attached.
\",\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"JVBERi0xLjQKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwvTGluZWFyaXplZCAxL0wgMTI1NTQvTiAxL1R5cGUvQ2F0YWxvZy9QYXJlbnQgMyAwIFI+PgplbmRvYmoK\",\"contentType\":\"application/pdf\"}]}", + "description": "Email with multiple recipients in To, CC and BCC, HTML body and a PDF attachment." + }, + { + "inputJson": "{\"from\":\"alerts@example.com\",\"to\":[\"admin@example.com\"],\"cc\":[],\"bcc\":[],\"subject\":\"System Alert\",\"bodyText\":\"High CPU usage detected.\",\"bodyHtml\":\"\",\"attachments\":[]}", + "description": "Alert email with one recipient and plain text body, no HTML or attachments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "backend-development.createCode", + "description": "Generates backend server-side code snippets based on provided specifications, including programming language, framework, and functionality requirements. Takes structured inputs describing endpoints, data models, and logic to produce ready-to-use code files or fragments for APIs and services.", + "category": "backend-development", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language in which the code should be generated (e.g., Node.js, Python, Java).", + "required": true, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "Backend framework or runtime environment to tailor the code for (e.g., Express, Flask, Spring).", + "required": false, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "Array of endpoint objects defining route paths, HTTP methods, and associated handler logic.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataModels", + "type": "array", + "description": "Array of data model definitions with fields and types to generate corresponding classes or schemas.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeDatabaseIntegration", + "type": "boolean", + "description": "Flag to specify if database interaction code (e.g., ORM or raw queries) should be included.", + "required": false, + "defaultValue": "false" + }, + { + "name": "authentication", + "type": "string", + "description": "Type of authentication mechanism to include (e.g., JWT, OAuth, none).", + "required": false, + "defaultValue": "none" + }, + { + "name": "generateTests", + "type": "boolean", + "description": "Flag indicating whether to generate basic test cases for the created code.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated code files as key-value pairs where the key is the filename and the value is the code content string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly prototype or scaffold backend server code by specifying desired endpoints, data models, and features. It helps automate generating boilerplate or initial implementations for APIs and services across various languages and frameworks.", + "limitations": "The tool generates boilerplate and scaffold code but does not implement complex business logic or optimizations. It may not cover every edge case or advanced framework-specific features.", + "examples": [ + "Generate a simple Express.js REST API with CRUD endpoints for a User model.", + "Create a Flask backend with JWT authentication and endpoints for product management.", + "Produce Java Spring controller code with database integration and unit tests for order processing." + ] + }, + "tags": [ + "backend", + "code generation", + "API", + "server", + "scaffolding", + "automation" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"Node.js\",\"framework\":\"Express\",\"endpoints\":[{\"path\":\"/users\",\"method\":\"GET\",\"handler\":\"fetch all users\"},{\"path\":\"/users\",\"method\":\"POST\",\"handler\":\"create a new user\"}],\"dataModels\":[{\"name\":\"User\",\"fields\":{\"id\":\"string\",\"name\":\"string\",\"email\":\"string\"}}],\"includeDatabaseIntegration\":true,\"authentication\":\"JWT\",\"generateTests\":true}", + "description": "Generate an Express.js backend with JWT auth, database integration, User model, and test cases." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Code", + "context": null + } + }, + { + "name": "backend-development.createDocument", + "description": "Creates a new document record in a backend system given the document type, content, metadata, and optional access permissions. Validates inputs and returns confirmation with the new document ID and timestamps.", + "category": "backend-development", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type/category of the document to create (e.g., 'report', 'invoice').", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "Main content or body of the document in plain text or markup format.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Key-value pairs providing additional information about the document (e.g., author, title, tags).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "accessPermissions", + "type": "object", + "description": "Defines user roles or groups that can access or modify this document.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "version", + "type": "number", + "description": "Initial version number of the document, defaults to 1 if omitted.", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "An object confirming document creation, including the unique document ID, creation and update timestamps, and the stored metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and store structured documents on a backend server, specifying content, type, metadata, and access controls. Commonly used in content management systems, document repositories, or business applications managing documents.", + "limitations": "Does not handle complex document transformations or content parsing beyond basic validation; does not manage document storage location specifics or full version history beyond initial version.", + "examples": [ + "Create a financial report document with title and author metadata and restrict access to finance team.", + "Create a simple text note document without metadata, open access.", + "Create an invoice document with detailed metadata including client and due date, setting access for billing and sales teams." + ] + }, + "tags": [ + "backend", + "document", + "creation", + "API", + "content-management", + "access-control" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"report\",\"content\":\"Annual financial report content...\",\"metadata\":{\"title\":\"Annual Report 2023\",\"author\":\"Jane Smith\"},\"accessPermissions\":{\"roles\":[\"finance_team\"]},\"version\":1}", + "description": "Create an annual financial report document with metadata and restrict access to finance team." + }, + { + "inputJson": "{\"documentType\":\"note\",\"content\":\"Remember to update project roadmap.\",\"metadata\":{},\"accessPermissions\":{},\"version\":1}", + "description": "Create a simple note document with no metadata and open access." + }, + { + "inputJson": "{\"documentType\":\"invoice\",\"content\":\"Invoice details for client X.\",\"metadata\":{\"client\":\"ClientX\",\"dueDate\":\"2024-07-01\"},\"accessPermissions\":{\"groups\":[\"billing\",\"sales\"]}}", + "description": "Create an invoice document with client and due date metadata, accessible by billing and sales groups." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Document", + "context": null + } + }, + { + "name": "web-development.renderLink", + "description": "Renders a fully formatted HTML anchor (<a>) tag based on input parameters such as URL, display text, target attribute, CSS classes, and optional tooltip. Outputs a valid HTML string representing the link element, ready for insertion into web pages or templates.", + "category": "web-development", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL the link points to. Required for link functionality.", + "required": true, + "defaultValue": "" + }, + { + "name": "text", + "type": "string", + "description": "The visible text content of the link to be displayed to users.", + "required": true, + "defaultValue": "" + }, + { + "name": "target", + "type": "string", + "description": "Specifies where to open the linked document, e.g., _blank, _self. Defaults to _self.", + "required": false, + "defaultValue": "_self" + }, + { + "name": "classNames", + "type": "string", + "description": "Space-separated list of CSS classes to apply to the link element for styling purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "id", + "type": "string", + "description": "Optional id attribute for the anchor tag, useful for CSS or JavaScript targeting.", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional tooltip text displayed when hovering over the link.", + "required": false, + "defaultValue": "" + }, + { + "name": "rel", + "type": "string", + "description": "The rel attribute specifying the relationship between linked resource and current document, like noopener or noreferrer.", + "required": false, + "defaultValue": "" + }, + { + "name": "isDisabled", + "type": "boolean", + "description": "If true, renders the link in a disabled state by removing the href and adding disabled styling.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'html' which is the fully formed HTML anchor tag string representing the link." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate customizable HTML links dynamically from structured input data, such as URL and display text, including optional attributes for styling, accessibility, or behavior. Ideal for web page rendering, email templates, or content generation that requires robust link formatting.", + "limitations": "This tool only generates static HTML anchor elements; it does not validate URLs for security, handle localization, or generate complex link components such as dropdowns or dynamic routing links.", + "examples": [ + "Generate a link to 'https://example.com' with text 'Visit Example' opening in a new tab.", + "Render a disabled link with the text 'Unavailable' and an explanatory tooltip.", + "Create a link with custom CSS classes 'btn primary' and id 'signup-link'" + ] + }, + "tags": [ + "html", + "link", + "rendering", + "web", + "anchor", + "frontend", + "ui" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"text\":\"Visit Example\",\"target\":\"_blank\",\"classNames\":\"btn primary\",\"id\":\"link1\",\"title\":\"Go to example website\",\"rel\":\"noopener noreferrer\",\"isDisabled\":false}", + "description": "Renders a link that opens https://example.com in a new tab with styling and tooltip." + }, + { + "inputJson": "{\"url\":\"https://unavailable.com\",\"text\":\"Unavailable\",\"target\":\"_self\",\"classNames\":\"disabled-link\",\"id\":\"\",\"title\":\"This link is currently disabled\",\"rel\":\"\",\"isDisabled\":true}", + "description": "Renders a disabled link showing 'Unavailable' with tooltip and disabled styling." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Link", + "context": null + } + }, + { + "name": "web-development.renderText", + "description": "Renders formatted textual content into HTML with optional styles and semantic tags. Accepts plain text or lightly marked up text, plus options for encoding, wrapping in container tags, and applying CSS classes or inline styles. Outputs HTML string ready for embedding in webpages or components.", + "category": "web-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw text content to render into HTML. Supports plain text or simple markup like line breaks.", + "required": true, + "defaultValue": "" + }, + { + "name": "encodeHtmlEntities", + "type": "boolean", + "description": "Whether to encode HTML entities in the text to prevent HTML injection. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "containerTag", + "type": "string", + "description": "Optional HTML tag to wrap the text output in (e.g., 'p', 'div', 'span'). If empty, text is output without container.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "List of CSS class names to add to the container tag if specified.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "inlineStyles", + "type": "object", + "description": "CSS style properties to add inline to the container tag if specified. Object keys as CSS properties, values as strings.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "preserveLineBreaks", + "type": "boolean", + "description": "If true, converts line breaks in text toelement for semantic markup.", + "required": false, + "defaultValue": "true" + }, + { + "name": "classNames", + "type": "array", + "description": "Array of CSS class names to add to the quote container element for styling purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "addQuotationMarks", + "type": "boolean", + "description": "Whether to automatically add typographic quotation marks around the quote text.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted quote as an HTML string ready for web embedding, including citation if provided." + }, + "aiAgent": { + "useCase": "Use this tool when you need to display a stylized block of quoted text on a website or web application, ensuring consistent HTML structure, optional citation, and customizable emphasis styling. Helpful for content management, blog posts, articles, or anywhere quotes are highlighted.", + "limitations": "This tool does not translate, paraphrase, or validate the authenticity of quotes. It also does not generate natural language content or advanced typographic styling beyond basic HTML and CSS class assignment.", + "examples": [ + "Format the quote 'To be or not to be' by Shakespeare in italic within a blockquote with citation.", + "Create a bold quote display without blockquote tags.", + "Add custom CSS classes to a quote from Albert Einstein including the source book title." + ] + }, + "tags": [ + "web", + "formatting", + "quote", + "HTML", + "CSS", + "content", + "citation" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"The only limit to our realization of tomorrow is our doubts of today.\",\"authorName\":\"Franklin D. Roosevelt\",\"source\":\"Speech\",\"emphasisStyle\":\"italic\",\"includeBlockquote\":true,\"classNames\":[\"inspirational\",\"highlight\"],\"addQuotationMarks\":true}", + "description": "Format a motivational quote with author and source, italic style, wrapped in blockquote with custom CSS classes." + }, + { + "inputJson": "{\"quoteText\":\"Simplicity is the ultimate sophistication.\",\"authorName\":\"Leonardo da Vinci\",\"emphasisStyle\":\"bold\",\"includeBlockquote\":false,\"classNames\":[],\"addQuotationMarks\":false}", + "description": "Format a simple quote with bold style without blockquote and without quotation marks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Quote", + "context": null + } + }, + { + "name": "web-development.renderFile", + "description": "This tool accepts a file input (such as images, PDFs, or text files), processes it to render an embeddable HTML representation or preview, and outputs the rendered HTML snippet. It supports optional parameters for width, height, and rendering mode to tailor the output for website embedding or display.", + "category": "web-development", + "parameters": [ + { + "name": "fileContent", + "type": "string", + "description": "Base64-encoded string of the file content to render, required for processing the file.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileType", + "type": "string", + "description": "MIME type of the file (e.g., image/png, application/pdf) to determine rendering method.", + "required": true, + "defaultValue": "" + }, + { + "name": "width", + "type": "string", + "description": "Desired width of the rendered output (CSS units, e.g., '100%', '400px').", + "required": false, + "defaultValue": "100%" + }, + { + "name": "height", + "type": "string", + "description": "Desired height of the rendered output (CSS units, e.g., 'auto', '300px').", + "required": false, + "defaultValue": "auto" + }, + { + "name": "renderMode", + "type": "string", + "description": "Rendering style or method, such as 'inline', 'iframe', or 'embed'.", + "required": false, + "defaultValue": "inline" + } + ], + "returns": { + "type": "object", + "description": "An object containing an HTML string that embeds or previews the file ready to be inserted into a web page." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate embeddable HTML code for displaying various types of media files (images, PDFs, text) on web pages dynamically from raw file data. It is useful in content management systems or dynamic webpage generation where files are stored or transferred as base64 strings and need rendering.", + "limitations": "Cannot render executable or complex interactive file formats (e.g., video players, complex 3D models). It does not perform file content validation beyond MIME type and encoding detection. It cannot convert file formats, only generate previews as-is.", + "examples": [ + "Render an image file as an inline HTML img tag with 300px width.", + "Render a PDF file within an iframe with a height of 500px on a website.", + "Render a plain text file content inside a styled HTML pre tag as inline content." + ] + }, + "tags": [ + "rendering", + "web", + "file-display", + "HTML", + "media-previews", + "embedding" + ], + "examples": [ + { + "inputJson": "{\"fileContent\":\"iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4\\n//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==\",\"fileType\":\"image/png\",\"width\":\"300px\",\"height\":\"auto\",\"renderMode\":\"inline\"}", + "description": "Render a PNG image as an inline HTML img element with width 300px." + }, + { + "inputJson": "{\"fileContent\":\"JVBERi0xLjcKCjEgMCBvYmoKPDwvVHlwZS9QYWdlL1BhcmVudCAzIDAgUi9SZXNvdXJjZXMgMiAwIFIvTWVkaWFCb3hbMCAwIDYxMiA3OTJdL0NvbnRlbnRzIDQgMCBSPj4KZW5kb2JqCjIgMCBvYmoKPDwvUHJvY1NldFsvUERGL0ltYWdlXTw8L0xlbmd0aCAxMi9GaWx0ZXIgWy9GbGF0ZURlY29kZV0+Pi9GaWx0ZXIAPj4KZW5kb2JqCjMgMCBvYmoKPDwvVHlwZS9QYWdlcy9Db3VudCAxL0tpZHNbMSAwIFJdPj5lbmRvYmoK", + "description": "Render a simple PDF file inside an iframe with height 500px for website embedding." + }, + { + "inputJson": "{\"fileContent\":\"SGVsbG8sIHRoaXMgaXMgYSBzYW1wbGUgdGV4dCBmaWxlLg==\",\"fileType\":\"text/plain\",\"width\":\"100%\",\"height\":\"auto\",\"renderMode\":\"inline\"}", + "description": "Render a plain text file as inline styled HTML content in a pre tag." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "File", + "context": null + } + }, + { + "name": "web-development.renderAudio", + "description": "This tool accepts audio source input parameters, such as URLs or base64 strings, and renders an HTML5 audio player element customizable with controls, autoplay, loop, and styling options. It outputs a string containing valid HTML markup to embed the audio in web pages.", + "category": "web-development", + "parameters": [ + { + "name": "audioSource", + "type": "string", + "description": "URL or base64-encoded string representing the audio file source to be rendered.", + "required": true, + "defaultValue": "" + }, + { + "name": "controls", + "type": "boolean", + "description": "Whether to display native audio controls (play, pause, volume, etc.).", + "required": false, + "defaultValue": "true" + }, + { + "name": "autoplay", + "type": "boolean", + "description": "Whether the audio should start playing automatically when loaded.", + "required": false, + "defaultValue": "false" + }, + { + "name": "loop", + "type": "boolean", + "description": "Whether the audio should loop continuously after ending.", + "required": false, + "defaultValue": "false" + }, + { + "name": "muted", + "type": "boolean", + "description": "Whether to mute the audio initially when it starts playing.", + "required": false, + "defaultValue": "false" + }, + { + "name": "preload", + "type": "string", + "description": "Preload attribute specifying if and how the audio should be loaded initially ('auto', 'metadata', or 'none').", + "required": false, + "defaultValue": "auto" + }, + { + "name": "cssClass", + "type": "string", + "description": "Optional CSS class or classes to apply to the audio element for styling.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single property 'html' containing the HTML audio tag string ready for embedding." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a fully functional and customizable HTML audio player element from a given audio source URL or base64 data for inclusion in web pages or apps. Ideal for dynamic web content generation or when automated embedding of audio is needed with control over playback behavior and styling.", + "limitations": "This tool does not process audio content beyond rendering the HTML element. It cannot convert or transcode audio files or analyze audio metadata beyond what is provided in the source string.", + "examples": [ + "Create an audio player for a podcast episode URL with controls and looping enabled.", + "Render an autoplaying background music audio element with muted start and no controls.", + "Generate a styled audio player from a base64 encoded audio source to embed in a webpage." + ] + }, + "tags": [ + "web-development", + "audio", + "media", + "rendering", + "html5", + "player", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"audioSource\":\"https://example.com/audio/song.mp3\",\"controls\":true,\"autoplay\":false,\"loop\":false,\"muted\":false,\"preload\":\"auto\",\"cssClass\":\"custom-audio-player\"}", + "description": "Render a standard audio player with controls and a custom CSS class for styling from a URL source." + }, + { + "inputJson": "{\"audioSource\":\"data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEAIlYAAESsAAACABAAZGF0YUAAAAA=\",\"controls\":false,\"autoplay\":true,\"loop\":true,\"muted\":true,\"preload\":\"auto\",\"cssClass\":\"background-music\"}", + "description": "Render a muted, autoplaying, looping audio player without visible controls, using a base64 encoded audio source." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Audio", + "context": null + } + }, + { + "name": "web-development.renderVideo", + "description": "This tool accepts video source URLs or file paths along with optional rendering parameters such as width, height, autoplay, and controls to generate an embeddable HTML5 video player snippet. It processes inputs to produce responsive and customizable video embed code for integration into websites.", + "category": "web-development", + "parameters": [ + { + "name": "videoSource", + "type": "string", + "description": "URL or file path of the video to render", + "required": true, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the video player in pixels", + "required": false, + "defaultValue": "640" + }, + { + "name": "height", + "type": "number", + "description": "Height of the video player in pixels", + "required": false, + "defaultValue": "360" + }, + { + "name": "autoplay", + "type": "boolean", + "description": "Whether the video should start playing automatically", + "required": false, + "defaultValue": "false" + }, + { + "name": "controls", + "type": "boolean", + "description": "Whether to show native video controls", + "required": false, + "defaultValue": "true" + }, + { + "name": "loop", + "type": "boolean", + "description": "Whether the video should loop when ended", + "required": false, + "defaultValue": "false" + }, + { + "name": "muted", + "type": "boolean", + "description": "Whether the video should start muted", + "required": false, + "defaultValue": "false" + }, + { + "name": "poster", + "type": "string", + "description": "URL of an image to show before the video plays", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing an 'html' string field with the embeddable HTML5 video element as per given parameters" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate HTML5 video player code for dynamic embedding of video content into web pages, adapting player size, autoplay, controls, and other attributes as per context. This is useful for website generation, content management systems, or dynamic page customization.", + "limitations": "This tool generates static HTML snippets only; it does not upload, transcode, or host videos. It also does not handle DRM, streaming protocols, or advanced video player features beyond basic HTML5 attributes.", + "examples": [ + "Generate HTML5 video embed code for a video located at https://example.com/video.mp4 with width 800px and autoplay enabled.", + "Create a video player snippet for local video file '/videos/demo.mp4' with controls hidden and looping enabled.", + "Render a video player with a poster image https://example.com/poster.jpg and muted playback by default." + ] + }, + "tags": [ + "web", + "video", + "HTML5", + "media", + "embed", + "frontend", + "rendering" + ], + "examples": [ + { + "inputJson": "{\"videoSource\":\"https://example.com/video.mp4\",\"width\":800,\"height\":450,\"autoplay\":true,\"controls\":true,\"loop\":false,\"muted\":false,\"poster\":\"\"}", + "description": "Embed a video with size 800x450, autoplay enabled, controls visible, no looping, and no poster image." + }, + { + "inputJson": "{\"videoSource\":\"/videos/demo.mp4\",\"width\":640,\"height\":360,\"autoplay\":false,\"controls\":false,\"loop\":true,\"muted\":false,\"poster\":\"\"}", + "description": "Embed a local video with controls hidden and loop enabled." + }, + { + "inputJson": "{\"videoSource\":\"https://example.com/video.mp4\",\"width\":640,\"height\":360,\"autoplay\":false,\"controls\":true,\"loop\":false,\"muted\":true,\"poster\":\"https://example.com/poster.jpg\"}", + "description": "Embed a muted video with a poster image and default player size." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Video", + "context": null + } + }, + { + "name": "web-development.renderSummary", + "description": "This tool accepts a structured JSON document or text input and generates a concise, web-friendly summary highlighting key points. It processes provided content, extracting main ideas and optionally formats the summary with HTML tags for easy embedding in web pages. The output is a clear textual or HTML snippet summarizing the original document.", + "category": "web-development", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The main textual content or JSON string of the document to summarize. Required for generating the summary.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentType", + "type": "string", + "description": "The content type of input; can be 'text' or 'json'. Determines processing method. Defaults to 'text'.", + "required": false, + "defaultValue": "text" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the summary output, ensuring concise results. Defaults to 300 characters.", + "required": false, + "defaultValue": "300" + }, + { + "name": "includeHtmlFormatting", + "type": "boolean", + "description": "If true, the output summary includes basic HTML tags (like, ) for web integration. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "highlightKeywords", + "type": "array", + "description": "Optional list of keywords to emphasize in the summary by wrapping them in tags if HTML formatting is enabled.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summarized text as a string, optionally including HTML formatting based on parameters." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create concise, readable summaries of documents or content pieces for display or use within web pages. Ideal for generating preview snippets, abstracts, or meta descriptions from longer text or JSON-structured content.", + "limitations": "Does not generate summaries for multimedia content (images, video). Quality depends on clarity and structure of input text; it cannot guarantee perfect semantic interpretation or domain-specific summarization.", + "examples": [ + "Summarize a long blog post text to 200 characters for a web preview.", + "Create a highlighted summary from JSON metadata describing an article.", + "Produce a short HTML-formatted abstract for a web page section." + ] + }, + "tags": [ + "summary", + "web", + "text-processing", + "html", + "content-extraction", + "document" + ], + "examples": [ + { + "inputJson": "{\"content\":\"This document discusses the benefits of AI in healthcare, covering improved diagnostics, personalized treatment plans, and enhanced patient engagement.\",\"contentType\":\"text\",\"maxLength\":150,\"includeHtmlFormatting\":true,\"highlightKeywords\":[\"AI\",\"healthcare\"]}", + "description": "Summarize a text document about AI in healthcare, limit to 150 chars, with HTML formatting highlighting keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Summary", + "context": null + } + }, + { + "name": "web-development.renderDocument", + "description": "Renders an HTML or markdown document into a stylized, fully formatted HTML output. Accepts raw content as HTML or markdown along with optional CSS styles and rendering options such as scripting enablement. Produces a string of rendered HTML ready for use in webpages or previews.", + "category": "web-development", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The raw document content to render, either HTML or markdown formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentType", + "type": "string", + "description": "Specifies the type of content provided ('html' or 'markdown').", + "required": true, + "defaultValue": "" + }, + { + "name": "cssStyles", + "type": "string", + "description": "Optional CSS styles to apply to the rendered output, as a style string.", + "required": false, + "defaultValue": "" + }, + { + "name": "enableScripts", + "type": "boolean", + "description": "Whether to allow scripts in the output HTML (dangerous, usually false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "rendererOptions", + "type": "object", + "description": "Additional options for rendering like sanitize output, linkify markdown URLs, etc.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML string under the key 'renderedHTML'." + }, + "aiAgent": { + "useCase": "Use this tool when converting raw HTML or markdown content into a rendered HTML format for display or preview purposes within web development or CMS applications. It helps generate safe, styled, and clean HTML output based on input content and style preferences.", + "limitations": "This tool does not execute or interpret JavaScript embedded in the HTML. It does not provide server-side rendering or dynamic content injection beyond static styling and markdown conversion.", + "examples": [ + "Render markdown content with custom CSS styles for a blog preview.", + "Render raw HTML safely with scripts disabled for user-submitted content.", + "Convert markdown notes into styled HTML formatted for website embedding." + ] + }, + "tags": [ + "web", + "rendering", + "html", + "markdown", + "document", + "css", + "preview" + ], + "examples": [ + { + "inputJson": "{\"content\":\"# Hello World\\nThis is a sample markdown document.\",\"contentType\":\"markdown\",\"cssStyles\":\"body { font-family: Arial; color: #333; }\",\"enableScripts\":false}", + "description": "Render markdown content with simple CSS styles applied, scripts disabled." + }, + { + "inputJson": "{\"content\":\"
Welcome
This is an HTML snippet.
\",\"contentType\":\"html\",\"cssStyles\":\"p { color: blue; }\",\"enableScripts\":false}", + "description": "Render raw HTML with CSS styling for paragraphs." + }, + { + "inputJson": "{\"content\":\"## Title\\n* Item 1\\n* Item 2\",\"contentType\":\"markdown\",\"enableScripts\":false}", + "description": "Render markdown list items using default styling and no scripts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Document", + "context": null + } + }, + { + "name": "web-development.renderReport", + "description": "Generates a formatted HTML report from structured input data. Accepts JSON data and optional style settings, processes the data according to specified report templates, and outputs a complete HTML string representing the rendered report ready for display or saving.", + "category": "web-development", + "parameters": [ + { + "name": "reportData", + "type": "object", + "description": "Structured input data for the report content, including sections, tables, and charts.", + "required": true, + "defaultValue": "" + }, + { + "name": "templateName", + "type": "string", + "description": "Name of the report template to use for rendering the report layout and styles.", + "required": false, + "defaultValue": "default" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Flag to include charts generated from the data within the report output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "customStyles", + "type": "string", + "description": "Optional CSS styles to apply to the rendered report to override or extend template styles.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing a single property 'htmlReport' with the full HTML string of the rendered report." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create visually structured HTML reports from JSON data for dashboards, status updates, or analytics summaries. It supports multiple templates and styling options, suitable for web page display or email embedding.", + "limitations": "Does not generate PDF or formats other than HTML. Chart rendering depends on data format and may require external scripts to display charts in the rendered HTML. Does not support real-time interactive reports.", + "examples": [ + "Render a sales summary report in HTML using the default template, including charts.", + "Generate an inventory report HTML without charts, applying custom CSS styles to brand the report.", + "Create a performance report using a specialized template with data supplied as JSON." + ] + }, + "tags": [ + "web", + "reporting", + "html", + "rendering", + "dashboard", + "charts" + ], + "examples": [ + { + "inputJson": "{\"reportData\":{\"title\":\"Monthly Sales\",\"sections\":[{\"header\":\"Overview\",\"content\":\"Sales increased by 10% compared to last month.\"}],\"tables\":[{\"header\":\"Sales Data\",\"rows\":[[\"Product\",\"Units Sold\",\"Revenue\"],[\"Widget A\",120,2400],[\"Widget B\",90,1800]]}],\"charts\":[{\"type\":\"bar\",\"data\":[120,90],\"labels\":[\"Widget A\",\"Widget B\"]}]},\"templateName\":\"default\",\"includeCharts\":true,\"customStyles\":\"\"}", + "description": "Render a monthly sales report with default template including charts." + }, + { + "inputJson": "{\"reportData\":{\"title\":\"Inventory Status\",\"sections\":[{\"header\":\"Current Stock Levels\",\"content\":\"All products are above minimum thresholds.\"}],\"tables\":[{\"header\":\"Stock Table\",\"rows\":[[\"Item\",\"Stock\"],[\"Item A\",50],[\"Item B\",30]]}]},\"templateName\":\"default\",\"includeCharts\":false,\"customStyles\":\"body { font-family: Arial; color: #333; }\"}", + "description": "Render an inventory report without charts and with custom font and color styles." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Report", + "context": null + } + }, + { + "name": "web-development.renderImage", + "description": "Renders an image element for web pages using given source URL, alt text, dimensions, and styling options. Accepts input parameters like image URL, width, height, alt text, CSS classes, and inline styles, then produces a fully formed HTMLtag string ready for embedding in web content.", + "category": "web-development", + "parameters": [ + { + "name": "src", + "type": "string", + "description": "The URL or relative path of the image to render. Required to load the image source.", + "required": true, + "defaultValue": "" + }, + { + "name": "altText", + "type": "string", + "description": "Alternative text for the image used for accessibility and SEO.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the image in pixels. If omitted, image natural width is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "height", + "type": "number", + "description": "Height of the image in pixels. If omitted, image natural height is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "Array of CSS class names to apply to the image element for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "inlineStyles", + "type": "object", + "description": "An object specifying inline CSS styles as key-value pairs to apply directly to the image element.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "loading", + "type": "string", + "description": "Loading behavior attribute for the image, e.g., 'lazy' or 'eager'. Defaults to browser default if empty.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML
tag string under the field 'htmlString'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate HTML img elements with specified attributes like source, alt text, sizing, CSS classes, or inline styles during website rendering or content generation workflows. It helps automate and ensure consistent image markup.", + "limitations": "This tool only generates the HTML img tag string and does not handle image file validation, optimization, or upload management.", + "examples": [ + "Render an image with fixed width and alt text for a product thumbnail.", + "Generate an image tag with lazy loading and multiple CSS classes for responsive design.", + "Create an image element with inline styles for custom border and shadow effects." + ] + }, + "tags": [ + "web", + "image", + "html", + "render", + "frontend", + "media", + "css" + ], + "examples": [ + { + "inputJson": "{\"src\":\"https://example.com/logo.png\",\"altText\":\"Company Logo\",\"width\":150,\"height\":50,\"cssClasses\":[\"logo\",\"responsive\"],\"inlineStyles\":{\"border\":\"1px solid #ccc\"},\"loading\":\"lazy\"}", + "description": "Render a company logo image with specific dimensions, CSS classes, border styling, and lazy loading enabled." + }, + { + "inputJson": "{\"src\":\"images/banner.jpg\",\"altText\":\"Homepage Banner\",\"cssClasses\":[\"banner-image\"],\"loading\":\"eager\"}", + "description": "Generate an img tag for the homepage banner with eager loading and given CSS class." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Image", + "context": null + } + }, + { + "name": "web-development.renderBrief", + "description": "Renders a concise, structured brief document in HTML format based on input project details. Accepts title, objectives, target audience, deliverables, and optional styling preferences. Processes the data to generate a clean, well-organized HTML brief suitable for web display or inclusion in documentation.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the brief document to be rendered.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "A list of key objectives to be included in the brief.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the brief's target audience.", + "required": true, + "defaultValue": "" + }, + { + "name": "deliverables", + "type": "array", + "description": "List of project deliverables to highlight in the brief.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTimeline", + "type": "boolean", + "description": "Whether to include a timeline section if timeline data provided.", + "required": false, + "defaultValue": "false" + }, + { + "name": "timeline", + "type": "string", + "description": "Optional timeline information for project milestones in plain text or markdown.", + "required": false, + "defaultValue": "" + }, + { + "name": "customStyles", + "type": "string", + "description": "Optional CSS styles to customize the brief's appearance in HTML output.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML brief as a string under 'htmlContent'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate a formal project brief as an HTML snippet from structured input data. Useful for quickly producing standardized briefs for project documentation or client presentations on web platforms.", + "limitations": "Does not generate graphical charts or handle complex markdown conversion. Styling is limited to basic CSS provided via 'customStyles' parameter. It produces static HTML without interactivity.", + "examples": [ + "Render a project brief with title, objectives, audience, deliverables, and a timeline.", + "Generate a brief without timeline but with custom CSS styles applied.", + "Create a minimal brief with just title and main objectives." + ] + }, + "tags": [ + "web", + "document", + "brief", + "render", + "html", + "project", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Website Redesign Project\",\"objectives\":[\"Improve user experience\",\"Increase conversion rate\",\"Update branding\"],\"targetAudience\":\"Internal stakeholders and design team\",\"deliverables\":[\"Wireframes\",\"High fidelity mockups\",\"Final design assets\"],\"includeTimeline\":true,\"timeline\":\"Phase 1: Research - Jan 2024\\nPhase 2: Design - Feb 2024\\nPhase 3: Testing - Mar 2024\",\"customStyles\":\"body { font-family: Arial, sans-serif; color: #333; } h1 { color: #0055a5; }\"}", + "description": "Render a full project brief including timeline and custom styles." + }, + { + "inputJson": "{\"title\":\"Mobile App Launch\",\"objectives\":[\"User onboarding\",\"App store optimization\"],\"targetAudience\":\"Marketing and product teams\",\"deliverables\":[\"Launch plan\",\"App store assets\"],\"includeTimeline\":false,\"customStyles\":\"\"}", + "description": "Generate a brief without timeline and default styling." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Brief", + "context": null + } + }, + { + "name": "web-development.formatReference", + "description": "Formats bibliographic reference entries into standardized citation styles such as APA, MLA, or Chicago. Accepts raw reference data as input (like author names, titles, dates) and outputs properly formatted reference strings suitable for web display or documentation.", + "category": "web-development", + "parameters": [ + { + "name": "referenceData", + "type": "object", + "description": "An object containing raw bibliographic information including author(s), title, publication year, publisher, URL, and other citation details.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The citation style to format the reference in. Supported values include 'APA', 'MLA', and 'Chicago'.", + "required": true, + "defaultValue": "APA" + }, + { + "name": "includeUrl", + "type": "boolean", + "description": "Whether to include the URL or DOI in the formatted reference when available.", + "required": false, + "defaultValue": "true" + }, + { + "name": "capitalizeTitle", + "type": "boolean", + "description": "If true, capitalizes the title according to the citation style rules.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'formattedReference' which is the citation formatted as a string according to the specified style." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or display standardized bibliographic references on websites or in documentation to ensure citation compliance and readability according to common academic or publishing standards.", + "limitations": "This tool does not verify the accuracy of the reference data provided, nor does it support citation styles beyond APA, MLA, and Chicago at this time. It may not handle complex or uncommon source types perfectly.", + "examples": [ + "Format a book reference in APA style for a website bibliography.", + "Generate a formatted reference string from raw author, title, and year data in MLA style.", + "Produce a Chicago style citation for an online article including its URL." + ] + }, + "tags": [ + "formatting", + "citation", + "bibliography", + "web-development", + "reference" + ], + "examples": [ + { + "inputJson": "{\"referenceData\":{\"author\":[\"John Doe\"],\"title\":\"Understanding AI\",\"year\":\"2022\",\"publisher\":\"Tech Books Publishing\"},\"style\":\"APA\",\"includeUrl\":false,\"capitalizeTitle\":true}", + "description": "Format a book reference in APA style with title capitalization." + }, + { + "inputJson": "{\"referenceData\":{\"author\":[\"Jane Smith\"],\"title\":\"Modern Web Design\",\"year\":\"2020\",\"url\":\"https://example.com/article\"},\"style\":\"MLA\",\"includeUrl\":true,\"capitalizeTitle\":false}", + "description": "Generate MLA style citation for an online article including URL." + }, + { + "inputJson": "{\"referenceData\":{\"author\":[\"Alice Johnson\",\"Bob Lee\"],\"title\":\"Deep Learning Advances\",\"year\":\"2019\",\"publisher\":\"Science Press\"},\"style\":\"Chicago\",\"includeUrl\":false,\"capitalizeTitle\":false}", + "description": "Produce Chicago style citation for a book with multiple authors." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Reference", + "context": null + } + }, + { + "name": "web-development.formatCitation", + "description": "This tool accepts raw citation data in JSON or string form along with a specified citation style (e.g., APA, MLA, Chicago). It processes the input by formatting the citation according to the selected style's rules and outputs a correctly formatted citation string suitable for web or academic usage.", + "category": "web-development", + "parameters": [ + { + "name": "citationData", + "type": "object", + "description": "An object containing the citation fields (author, title, year, publisher, etc.) representing the source to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The citation style to apply for formatting such as 'APA', 'MLA', or 'Chicago'.", + "required": true, + "defaultValue": "APA" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format for the formatted citation, e.g., 'text' for plain text or 'html' for HTML formatted output.", + "required": false, + "defaultValue": "text" + }, + { + "name": "includeURL", + "type": "boolean", + "description": "Whether to append the source URL if available in the citation data.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object with a single field 'formattedCitation' containing the citation formatted string as per the selected style and options." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce correctly styled citations for sources to display on websites, in documentation, or academic related content, ensuring compliance with common citation standards without manual formatting.", + "limitations": "This tool cannot retrieve citation metadata automatically; it requires structured citation input data. It is limited to commonly used citation styles and may not support highly specialized or custom citation styles.", + "examples": [ + "Format a citation in APA style from raw citation data for display on a research website.", + "Convert structured book citation details into an MLA formatted string including an HTML anchor for the URL.", + "Generate a Chicago style citation text from article metadata excluding the source URL." + ] + }, + "tags": [ + "web-development", + "citation", + "formatting", + "academic", + "bibliography", + "reference management" + ], + "examples": [ + { + "inputJson": "{\"citationData\":{\"author\":\"Smith, John\",\"title\":\"Introduction to Web Development\",\"year\":2020,\"publisher\":\"Tech Press\",\"url\":\"https://example.com/book\"},\"citationStyle\":\"APA\",\"outputFormat\":\"text\",\"includeURL\":true}", + "description": "Format a book citation in APA style including URL as plain text." + }, + { + "inputJson": "{\"citationData\":{\"author\":\"Doe, Jane\",\"title\":\"Modern Styling Techniques\",\"journal\":\"Web Journal\",\"volume\":\"15\",\"issue\":\"3\",\"pages\":\"42-59\",\"year\":2019},\"citationStyle\":\"MLA\",\"outputFormat\":\"html\",\"includeURL\":false}", + "description": "Format a journal article citation in MLA style without URL output in HTML." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Citation", + "context": null + } + }, + { + "name": "web-development.formatHeading", + "description": "Formats a given plain text string into an HTML heading element according to specified heading level and optional CSS classes. Accepts raw text input, applies heading level tags (h1 to h6), inserts optional CSS class attributes, and returns a fully formed HTML heading string suitable for embedding in web pages.", + "category": "web-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The plain text content to format as a heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "Heading level from 1 to 6 indicating h1 through h6 tags.", + "required": true, + "defaultValue": "1" + }, + { + "name": "cssClasses", + "type": "string", + "description": "Optional space-separated CSS class names to include in the heading element.", + "required": false, + "defaultValue": "" + }, + { + "name": "id", + "type": "string", + "description": "Optional id attribute to add to the heading element for anchors or styling.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the HTML string of the formatted heading in the 'html' property." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents tasked with generating or formatting web page headings dynamically, ensuring proper semantic HTML structure with correct heading levels and optional styling. It helps automate the creation of accessible and standards-compliant heading tags from plain text in content generation workflows.", + "limitations": "It does not sanitize or escape HTML entities; input text should be safe or pre-escaped to prevent injection vulnerabilities. It only formats headings and does not handle other HTML content or styles beyond class and id attributes.", + "examples": [ + "Format raw text 'Welcome to Our Site' as an h2 heading with class 'main-title'.", + "Generate an h1 heading without any CSS classes or id.", + "Create an h4 heading with CSS classes 'section-header highlight' and id 'intro'." + ] + }, + "tags": [ + "web", + "html", + "heading", + "formatting", + "frontend", + "css", + "component" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Welcome to Our Site\",\"level\":2,\"cssClasses\":\"main-title\",\"id\":\"\"}", + "description": "Format text as an h2 heading with one CSS class." + }, + { + "inputJson": "{\"text\":\"Home Page\",\"level\":1,\"cssClasses\":\"\",\"id\":\"\"}", + "description": "Create a top-level h1 heading with no additional classes or id." + }, + { + "inputJson": "{\"text\":\"Introduction\",\"level\":4,\"cssClasses\":\"section-header highlight\",\"id\":\"intro\"}", + "description": "Generate an h4 heading with multiple CSS classes and an id attribute." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Heading", + "context": null + } + }, + { + "name": "web-development.formatLink", + "description": "Formats a given URL and optional display text into a valid HTML anchor tag. Accepts a URL string and optional link text, along with options to open the link in a new tab and add CSS classes. Outputs a safely formatted HTML link string ready to embed in web pages.", + "category": "web-development", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL that the link will point to. Must be a valid URL starting with http:// or https://.", + "required": true, + "defaultValue": "" + }, + { + "name": "linkText", + "type": "string", + "description": "The visible text for the link. If omitted or empty, the URL itself will be used as the link text.", + "required": false, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "Indicates whether the link should open in a new browser tab (sets target='_blank').", + "required": false, + "defaultValue": "false" + }, + { + "name": "cssClasses", + "type": "string", + "description": "Optional string of space-separated CSS class names to add to the anchor tag's class attribute.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted HTML anchor tag string under the 'htmlLink' property." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate HTML anchor tags from a URL and optional display text, especially when formatting user input or dynamically generated links for web pages. It ensures correct HTML syntax and optionally handles opening in new tabs and CSS styling classes.", + "limitations": "This tool does not validate the URL beyond basic scheme checks and does not sanitize embedded HTML within the link text, so it should be used with trusted inputs or additionally sanitized.", + "examples": [ + "Format a simple link from a URL only.", + "Format a link with custom display text and CSS classes.", + "Create a link that opens in a new tab." + ] + }, + "tags": [ + "web-development", + "html", + "formatting", + "link", + "anchor-tag", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://www.example.com\"}", + "description": "Formats a basic anchor tag using the URL as both href and link text." + }, + { + "inputJson": "{\"url\":\"https://www.example.com\",\"linkText\":\"Example Site\",\"openInNewTab\":true}", + "description": "Formats an anchor tag with custom text that opens in a new tab." + }, + { + "inputJson": "{\"url\":\"https://www.example.com\",\"linkText\":\"Visit Example\",\"cssClasses\":\"btn btn-primary\"}", + "description": "Formats an anchor tag with custom text and CSS classes for styling." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Link", + "context": null + } + }, + { + "name": "web-development.formatParagraph", + "description": "Formats a given paragraph of text according to specified styling and structural options. Accepts raw paragraph string input and applies line breaks, indentation, text alignment, and maximum line width rules to produce a neatly formatted paragraph string suitable for web content or documentation.", + "category": "web-development", + "parameters": [ + { + "name": "paragraphText", + "type": "string", + "description": "The raw paragraph text to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum number of characters per line before wrapping. Lines will break at word boundaries if possible.", + "required": false, + "defaultValue": "80" + }, + { + "name": "indentSpaces", + "type": "number", + "description": "Number of spaces to insert at the start of each line as indentation.", + "required": false, + "defaultValue": "0" + }, + { + "name": "alignment", + "type": "string", + "description": "Text alignment style for lines: 'left', 'right', or 'center'. Defaults to 'left'.", + "required": false, + "defaultValue": "left" + }, + { + "name": "preserveLineBreaks", + "type": "boolean", + "description": "If true, preserves original line breaks in the paragraph input instead of rewrapping.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted paragraph as a single string with applied formatting rules." + }, + "aiAgent": { + "useCase": "Use this tool when needing to present or output a paragraph with consistent and readable formatting on web pages, emails, or documentation. Ideal for wrapping text to a certain width, adding indentation, and controlling alignment for better aesthetics or readability.", + "limitations": "Cannot apply complex text styling such as font changes or color. It only formats plain text paragraphs with whitespace, breaks and alignment. Does not parse or transform HTML or markdown syntax.", + "examples": [ + "Format a user input paragraph to have 4 spaces indentation, 60 characters max line width, and centered alignment.", + "Reformat a block of text to 80 characters line width with left alignment and no indentation.", + "Preserve existing line breaks but right-align each line with 2 spaces indentation." + ] + }, + "tags": [ + "formatting", + "text", + "paragraph", + "wrapping", + "alignment", + "indentation", + "web-content" + ], + "examples": [ + { + "inputJson": "{\"paragraphText\":\"This is a sample paragraph that needs to be formatted accordingly. It contains multiple sentences and should be wrapped correctly.\",\"lineWidth\":50,\"indentSpaces\":4,\"alignment\":\"left\",\"preserveLineBreaks\":false}", + "description": "Format a paragraph with 50 characters max line width, 4 spaces of indentation, left aligned." + }, + { + "inputJson": "{\"paragraphText\":\"Centered paragraph text should appear with lines centered and wrapped at 40 chars.\",\"lineWidth\":40,\"indentSpaces\":0,\"alignment\":\"center\",\"preserveLineBreaks\":false}", + "description": "Center align paragraph text with 40 char max width and no indentation." + }, + { + "inputJson": "{\"paragraphText\":\"Line one.\\nLine two is here.\\nLine three follows.\",\"lineWidth\":80,\"indentSpaces\":2,\"alignment\":\"right\",\"preserveLineBreaks\":true}", + "description": "Preserve line breaks and right-align each line with 2 spaces indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Paragraph", + "context": null + } + }, + { + "name": "web-development.formatWord", + "description": "This tool accepts a single word as input and formats it according to specified casing styles such as camelCase, snake_case, kebab-case, PascalCase, UPPERCASE, or lowercase. It outputs the formatted word as a string, enabling consistent styling for identifiers or text elements in web development projects.", + "category": "web-development", + "parameters": [ + { + "name": "word", + "type": "string", + "description": "The input word or phrase to be formatted (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "The desired output format style (e.g., camelCase, snake_case, kebab-case, PascalCase, UPPERCASE, lowercase) (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "preserveAcronyms", + "type": "boolean", + "description": "If true, preserves acronyms capitalization when applicable (optional)", + "required": false, + "defaultValue": "false" + }, + { + "name": "delimiter", + "type": "string", + "description": "Custom delimiter to use when formatStyle is 'custom' (optional)", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted word string under 'formattedWord' key" + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize the formatting of a single word or phrase for identifiers, CSS classes, variable names, or user-visible text within web development tasks. It ensures consistency in naming conventions across codebases and UI elements.", + "limitations": "This tool only formats a single word or phrase according to predefined case styles. It does not handle multiple words as separate inputs or advanced linguistic transformations such as stemming or pluralization.", + "examples": [ + "Format the word 'background color' into camelCase.", + "Convert the word 'user_name' to PascalCase.", + "Output the word 'APIResponse' in lowercase." + ] + }, + "tags": [ + "formatting", + "string", + "case-style", + "web-development", + "naming", + "identifier", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"word\":\"background color\",\"formatStyle\":\"camelCase\"}", + "description": "Convert phrase with space into camelCase string." + }, + { + "inputJson": "{\"word\":\"user_name\",\"formatStyle\":\"PascalCase\"}", + "description": "Change snake_case style word into PascalCase." + }, + { + "inputJson": "{\"word\":\"APIResponse\",\"formatStyle\":\"lowercase\",\"preserveAcronyms\":true}", + "description": "Convert to lowercase while optionally preserving acronym casing." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Word", + "context": null + } + }, + { + "name": "web-development.formatText", + "description": "Formats plain text input according to specified style rules such as capitalization, line length wrapping, indentation, and spacing. Accepts a raw string and applies transformations to produce clean, consistent formatted text suitable for display or processing in web development contexts.", + "category": "web-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The input plain text string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "capitalize", + "type": "string", + "description": "Capitalization style to apply: 'none', 'uppercase', 'lowercase', 'title' (capitalize first letter of each word).", + "required": false, + "defaultValue": "none" + }, + { + "name": "wrapWidth", + "type": "number", + "description": "Maximum number of characters per line to wrap the text. Use 0 or null for no wrapping.", + "required": false, + "defaultValue": "0" + }, + { + "name": "indentSpaces", + "type": "number", + "description": "Number of spaces to indent each line.", + "required": false, + "defaultValue": "0" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to trim leading and trailing whitespace of each line.", + "required": false, + "defaultValue": "true" + }, + { + "name": "convertTabsToSpaces", + "type": "boolean", + "description": "Replace tab characters with spaces according to indentSpaces setting.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted text string under 'formattedText'." + }, + "aiAgent": { + "useCase": "Use this tool to clean, normalize, and style plain text content before embedding it into HTML pages, emails, or documentation in web development workflows. It helps standardize text appearance, indentations, line lengths, and case formatting to improve readability and presentation consistency.", + "limitations": "Cannot parse or format markup languages like HTML or Markdown specifically; focuses purely on plain text manipulation without semantic understanding.", + "examples": [ + "Format a raw text paragraph into wrapped lines of 80 characters with title case and 4 spaces indentation.", + "Convert input text entirely to uppercase without line wrapping.", + "Trim whitespace and convert tabs to spaces with no capitalization or line wrapping." + ] + }, + "tags": [ + "text", + "formatting", + "web-development", + "string-manipulation", + "cleaning", + "indentation", + "wrapping", + "capitalization" + ], + "examples": [ + { + "inputJson": "{\"text\":\"\\tHello world! This is a sample text to demonstrate text formatting tool.\",\"capitalize\":\"title\",\"wrapWidth\":40,\"indentSpaces\":4,\"trimWhitespace\":true,\"convertTabsToSpaces\":true}", + "description": "Format the sample text by applying title case, wrap lines at 40 characters, indent each line by 4 spaces, trim whitespace, and convert tabs to spaces." + }, + { + "inputJson": "{\"text\":\"ERROR: invalid input detected.\",\"capitalize\":\"uppercase\",\"wrapWidth\":0,\"indentSpaces\":0,\"trimWhitespace\":false,\"convertTabsToSpaces\":false}", + "description": "Convert the input text to uppercase without wrapping or indentation, preserving whitespace and tabs." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Text", + "context": null + } + }, + { + "name": "web-development.formatSentence", + "description": "This tool accepts a raw sentence string and formats it according to specified stylistic rules such as capitalization style, punctuation correction, and spacing. It outputs a clean, well-formatted sentence string ready for inclusion in web content or user interfaces.", + "category": "web-development", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The raw input sentence string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "capitalizeStyle", + "type": "string", + "description": "Capitalization style to apply: 'none', 'sentenceCase', 'titleCase', 'uppercase', or 'lowercase'.", + "required": false, + "defaultValue": "sentenceCase" + }, + { + "name": "correctPunctuation", + "type": "boolean", + "description": "Whether to fix common punctuation mistakes (e.g., add missing periods, fix spacing).", + "required": false, + "defaultValue": "true" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to trim leading and trailing whitespace and reduce multiple spaces to single spaces.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "string", + "description": "The input sentence transformed and formatted as per the specified options, suitable for web display." + }, + "aiAgent": { + "useCase": "Use when raw text content or user-generated input needs to be cleaned up and standardized before display on a website or user interface, ensuring consistent capitalization, spacing, and punctuation for polished presentation.", + "limitations": "Does not perform complex grammar correction or semantic adjustments; focuses only on stylistic formatting of single sentences.", + "examples": [ + "Format the sentence 'hello world!' as title case with punctuation correction.", + "Convert the sentence 'this is a test' to uppercase without changing punctuation.", + "Trim extra spaces and capitalize the first word of the input sentence." + ] + }, + "tags": [ + "web", + "text-formatting", + "sentence", + "string-processing", + "capitalization", + "punctuation" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\"hello world! this is an example.\",\"capitalizeStyle\":\"sentenceCase\",\"correctPunctuation\":true,\"trimWhitespace\":true}", + "description": "Formats a raw sentence by capitalizing the first letter, correcting punctuation, and trimming extra spaces." + }, + { + "inputJson": "{\"sentence\":\" multiple spaces and no punctuation\",\"capitalizeStyle\":\"titleCase\",\"correctPunctuation\":false,\"trimWhitespace\":true}", + "description": "Trims whitespace and applies title case without punctuation correction." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Sentence", + "context": null + } + }, + { + "name": "web-development.formatHTML", + "description": "Formats raw or minified HTML code string by beautifying, indenting, and normalizing whitespace for improved readability and maintenance. Accepts an HTML string input, applies configurable indentation and optional beautification rules, and returns a well-structured, human-readable HTML string output.", + "category": "web-development", + "parameters": [ + { + "name": "html", + "type": "string", + "description": "The raw or minified HTML code string that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for each indentation level in the output HTML.", + "required": false, + "defaultValue": "2" + }, + { + "name": "indentWithTabs", + "type": "boolean", + "description": "Whether to use tabs instead of spaces for indentation. Overrides indentSize if true.", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveNewlines", + "type": "boolean", + "description": "Whether to preserve existing line breaks in text nodes when formatting.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxPreserveNewlines", + "type": "number", + "description": "Maximum number of consecutive line breaks to preserve when preserveNewlines is true.", + "required": false, + "defaultValue": "2" + }, + { + "name": "wrapLineLength", + "type": "number", + "description": "Maximum length of a line; lines longer than this will be wrapped when possible.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted HTML string under the 'formattedHtml' property." + }, + "aiAgent": { + "useCase": "Use this tool when you need to clean, beautify, or normalize raw or minified HTML code for easier readability, debugging, review, or maintenance. It is useful in code editors, web IDEs, or automation workflows that manipulate HTML source and require standardized formatting conventions.", + "limitations": "Does not validate HTML syntax correctness or fix semantic errors. Does not optimize or minify HTML for production use. Performance may decrease with extremely large HTML documents.", + "examples": [ + "Format a minified HTML snippet with 2-space indentation.", + "Convert HTML with tabs for indentation instead of spaces.", + "Preserve existing line breaks up to a maximum of two consecutive newlines in text content." + ] + }, + "tags": [ + "formatting", + "html", + "beautify", + "code-cleanup", + "web-development", + "indentation" + ], + "examples": [ + { + "inputJson": "{\"html\":\"
\",\"indentSize\":4,\"indentWithTabs\":false,\"preserveNewlines\":true,\"maxPreserveNewlines\":2,\"wrapLineLength\":80}", + "description": "Format simple nested HTML with 4-space indentation" + }, + { + "inputJson": "{\"html\":\"Hello
This is a paragraph.
\",\"indentSize\":0,\"indentWithTabs\":true,\"preserveNewlines\":false,\"maxPreserveNewlines\":1,\"wrapLineLength\":80}", + "description": "Format list HTML using tabs for indentation, no preservation of newlines" + }, + { + "inputJson": "{\"html\":\"
- Item1
- Item2
Line1\\n\\n\\nLine2\",\"indentSize\":2,\"indentWithTabs\":false,\"preserveNewlines\":true,\"maxPreserveNewlines\":2,\"wrapLineLength\":100}", + "description": "Preserve up to two consecutive newlines inside HTML text nodes" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "HTML", + "context": null + } + }, + { + "name": "web-development.formatMarkdown", + "description": "Formats raw Markdown text according to specified style guidelines. Accepts Markdown content as input, applies formatting options such as line wrapping, heading styles, and list indentation, and outputs a clean, standardized Markdown string suitable for consistent documentation or web content.", + "category": "web-development", + "parameters": [ + { + "name": "markdownText", + "type": "string", + "description": "The raw Markdown text input to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum number of characters per line; lines will be wrapped accordingly.", + "required": false, + "defaultValue": "80" + }, + { + "name": "useAtxHeadings", + "type": "boolean", + "description": "If true, use ATX style headings (#) instead of Setext style (= or -).", + "required": false, + "defaultValue": "true" + }, + { + "name": "listItemIndentation", + "type": "string", + "description": "Indentation style for list items: 'space' for spaces or 'tab' for tab characters.", + "required": false, + "defaultValue": "space" + }, + { + "name": "trimTrailingWhitespace", + "type": "boolean", + "description": "If true, trims trailing whitespace from each line.", + "required": false, + "defaultValue": "true" + }, + { + "name": "ensureLineBreaksBetweenBlocks", + "type": "boolean", + "description": "If true, ensures exactly one blank line between markdown block elements.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted Markdown text string under 'formattedMarkdown' key." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to enforce consistent markdown formatting across documentation or web content, such as before publishing or committing to a repo. It helps standardize heading styles, wrap lines for better readability, and clean up list indentation and whitespace issues.", + "limitations": "This tool does not render Markdown to HTML or other formats. It only reformats existing Markdown text based on stylistic rules and does not interpret or modify embedded code blocks or metadata.", + "examples": [ + "Format a raw markdown file to use ATX style headers and wrap lines at 80 characters.", + "Standardize list indentation in a markdown document with spaces instead of tabs.", + "Clean up trailing whitespace and ensure consistent blank lines between sections of markdown text." + ] + }, + "tags": [ + "formatting", + "markdown", + "documentation", + "web", + "content", + "standardization", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"markdownText\":\"#Heading\\nThis is a paragraph with a very long line that should be wrapped properly to improve readability and visual consistency in Markdown files.\",\"maxLineLength\":50,\"useAtxHeadings\":true,\"listItemIndentation\":\"space\",\"trimTrailingWhitespace\":true,\"ensureLineBreaksBetweenBlocks\":true}", + "description": "Format Markdown with ATX headings, wrap lines at 50 chars, and standardize spacing." + }, + { + "inputJson": "{\"markdownText\":\"Heading\\n=======\\n- item1\\n- item2\",\"useAtxHeadings\":true}", + "description": "Convert Setext heading to ATX heading and keep default formatting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Markdown", + "context": null + } + }, + { + "name": "web-development.formatYAML", + "description": "Formats a given YAML string to a standardized style, applying consistent indentation, spacing, and optionally sorting keys. Accepts raw YAML text and outputs a clean, human-readable YAML string conforming to common style guidelines for easier maintenance and readability.", + "category": "web-development", + "parameters": [ + { + "name": "yamlContent", + "type": "string", + "description": "Raw YAML string input to be formatted. Must be valid YAML syntax.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted YAML. Typically 2 or 4.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "If true, sorts the keys in mappings alphabetically in the output YAML to improve consistency.", + "required": false, + "defaultValue": "false" + }, + { + "name": "keepComments", + "type": "boolean", + "description": "If true, preserves comments from the original YAML in the formatted output. Otherwise strips comments.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted YAML string as 'formattedYaml' and a boolean 'success' indicating formatting result." + }, + "aiAgent": { + "useCase": "Use this tool when you receive raw or inconsistently formatted YAML data (e.g., configuration files, API specs) that needs to be cleaned and standardized for readability and maintenance in web development projects. It helps ensure uniform indentation, spacing, optional key sorting, and comment retention, making YAML files easier to review and modify.", + "limitations": "Cannot fix syntactically invalid YAML input; requires valid YAML syntax to format correctly. Does not perform semantic validation or error correction beyond formatting.", + "examples": [ + "Format this YAML configuration string with 4-space indentation and sorted keys.", + "Format a YAML file but remove all comments during formatting.", + "Standardize indentation to 2 spaces preserving original comments in the YAML code." + ] + }, + "tags": [ + "formatting", + "YAML", + "web-development", + "code-cleanup", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"yamlContent\":\"database:\\n host: localhost\\n port: 5432\\n credentials:\\n user: admin\\n password: secret\\nlogging:\\n level: info\\n enabled: true\",\"indentationSpaces\":4,\"sortKeys\":true,\"keepComments\":true}", + "description": "Format a typical web app config YAML with 4 space indentation and sorted keys, preserving comments." + }, + { + "inputJson": "{\"yamlContent\":\"- name: John\\n age: 30\\n- name: Alice\\n age: 25\",\"indentationSpaces\":2,\"sortKeys\":false,\"keepComments\":false}", + "description": "Format a YAML list without sorting keys and strip any comments, indented with 2 spaces." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "YAML", + "context": null + } + }, + { + "name": "web-development.formatXML", + "description": "Formats a raw XML string to produce a well-indented, human-readable XML output. Accepts unformatted or minified XML input and processes it by parsing and pretty-printing with configurable indentation. Returns a string of formatted XML preserving the original content structure.", + "category": "web-development", + "parameters": [ + { + "name": "xmlString", + "type": "string", + "description": "The raw XML string input to be formatted; must be well-formed XML.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for each indentation level in the output XML; default is 2.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tab characters for indentation instead of spaces; default is false (spaces used).", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveEmptyLines", + "type": "boolean", + "description": "Indicates if existing empty lines in the XML input should be preserved in the formatted output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the prettified XML string as formattedXML and an error message if formatting failed, empty if successful." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert a compressed or poorly formatted XML string into a clean, readable format with consistent indentation for debugging, display, or documentation purposes. It is ideal for XML data inspection, editing, or integration into readable documentation.", + "limitations": "Cannot format XML strings that are not well-formed. Does not perform XML validation beyond parsing nor modify XML content, only formatting is affected.", + "examples": [ + "Format a minified XML string for display in a web UI with 4-space indentation.", + "Reformat XML with tabs instead of spaces for easier code editing.", + "Preserve empty lines in large XML files while formatting indentation." + ] + }, + "tags": [ + "formatting", + "xml", + "web-development", + "data-processing", + "pretty-print", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"xmlString\":\"\",\"indentationSpaces\":2,\"useTabs\":false,\"preserveEmptyLines\":false}", + "description": "Simple XML string formatted with two spaces indentation." + }, + { + "inputJson": "{\"xmlString\":\" value \",\"indentationSpaces\":4,\"useTabs\":true,\"preserveEmptyLines\":false}", + "description": "Format XML using tabs for indentation with visually clear spacing." + }, + { + "inputJson": "{\"xmlString\":\" value \\n\\n \",\"indentationSpaces\":2,\"useTabs\":false,\"preserveEmptyLines\":true}", + "description": "Format XML preserving existing empty lines between nodes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "XML", + "context": null + } + }, + { + "name": "web-development.formatCSV", + "description": "Formats raw CSV data according to specified delimiter, line endings, and quoting rules. Accepts CSV text input, processes it to ensure consistent styling and escaping, and outputs the formatted CSV string suitable for web or application use.", + "category": "web-development", + "parameters": [ + { + "name": "csvText", + "type": "string", + "description": "Raw CSV text input to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate the fields; commonly a comma or semicolon", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteCharacter", + "type": "string", + "description": "Character used to quote fields containing delimiters or line breaks", + "required": false, + "defaultValue": "\"" + }, + { + "name": "lineEnding", + "type": "string", + "description": "Type of line ending for CSV rows; e.g., \\n (LF), \\r\\n (CRLF)", + "required": false, + "defaultValue": "\\n" + }, + { + "name": "trimFields", + "type": "boolean", + "description": "Whether to trim whitespace from fields", + "required": false, + "defaultValue": "true" + }, + { + "name": "escapeQuotes", + "type": "boolean", + "description": "Whether to double-up quote characters inside quoted fields", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "string", + "description": "The formatted CSV string with consistent delimiters, quoting, escaping, and line endings" + }, + "aiAgent": { + "useCase": "Use this tool when you receive CSV data that needs to be standardized for better compatibility with web applications, CSV readers, or APIs. It helps enforce uniform delimiter, quote, and line-ending styles to prevent parsing errors and improve readability. This is especially useful before saving, displaying, or transmitting CSV data.", + "limitations": "This tool does not validate CSV content semantically or parse CSV into structured objects. It focuses solely on formatting style and escaping rules. It also does not add or remove columns or rows.", + "examples": [ + "Format CSV text to use semicolons as delimiters and Windows-style line endings.", + "Clean CSV input from inconsistent whitespace and ensure all fields are quoted properly.", + "Convert poorly formatted CSV into standardized form for web upload." + ] + }, + "tags": [ + "csv", + "formatting", + "web-development", + "data-cleanup", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"csvText\":\"name , age,\\nJohn Doe, 30\\nJane,25\",\"delimiter\":\",\",\"quoteCharacter\":\"\\\"\",\"lineEnding\":\"\\n\",\"trimFields\":true,\"escapeQuotes\":true}", + "description": "Format CSV with commas as delimiters, trim whitespace, and standard LF line endings." + }, + { + "inputJson": "{\"csvText\":\"id;name;comment\\n1;Alice;Hello; world\\n2;Bob;Goodbye\",\"delimiter\":\";\",\"quoteCharacter\":\"\\\"\",\"lineEnding\":\"\\r\\n\",\"trimFields\":true,\"escapeQuotes\":true}", + "description": "Format CSV using semicolon delimiters and CRLF line endings for Windows compatibility." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "CSV", + "context": null + } + }, + { + "name": "web-development.formatDataset", + "description": "Formats raw dataset inputs (in JSON, CSV, or array of objects) for web display by standardizing date formats, normalizing numeric values, and aligning columns with consistent header naming conventions. Returns a cleaned and uniformly structured dataset ready for frontend rendering or further processing.", + "category": "web-development", + "parameters": [ + { + "name": "dataset", + "type": "array", + "description": "The dataset as an array of objects, each representing a data record to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "The format of the input dataset (e.g., 'json', 'csv', 'array').", + "required": false, + "defaultValue": "json" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Desired output date format string (e.g., 'YYYY-MM-DD', 'MM/DD/YYYY').", + "required": false, + "defaultValue": "YYYY-MM-DD" + }, + { + "name": "numericPrecision", + "type": "number", + "description": "Number of decimal places for numeric values normalization.", + "required": false, + "defaultValue": "2" + }, + { + "name": "columnMapping", + "type": "object", + "description": "An object mapping original column names to desired display names to unify headers.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "removeEmptyRows", + "type": "boolean", + "description": "Whether to remove rows with all empty or null values.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted dataset as an array of standardized records, with columns renamed and data cleaned for consistent web presentation." + }, + "aiAgent": { + "useCase": "Use this tool when raw datasets from diverse sources require consistent formatting for web applications. It helps unify date formats, numeric precision, and column names for frontend display or API consumption, facilitating seamless integration and improved user experience.", + "limitations": "Does not perform complex data validation, infer data types beyond basic detection, or handle extremely large datasets that may require streaming or chunk processing.", + "examples": [ + "Format a JSON dataset with inconsistent date strings and varied column headers for web display.", + "Normalize numeric values to 3 decimals and rename columns in a CSV-imported dataset.", + "Remove all empty rows from an array of data objects before rendering in a web table." + ] + }, + "tags": [ + "formatting", + "dataset", + "web", + "data-cleaning", + "json", + "csv", + "frontend", + "normalization" + ], + "examples": [ + { + "inputJson": "{\"dataset\":[{\"date\":\"12-31-2023\",\"price\":\"100.4567\",\"product\":\"A\"},{\"date\":\"01-01-2024\",\"price\":\"200.1\",\"product\":\"B\"}],\"inputFormat\":\"json\",\"dateFormat\":\"YYYY-MM-DD\",\"numericPrecision\":2,\"columnMapping\":{\"product\":\"Product Name\",\"price\":\"Price ($)\"},\"removeEmptyRows\":true}", + "description": "Formats a JSON dataset by standardizing date format to ISO, rounding price to 2 decimals, renaming product and price columns, and removing empty rows." + }, + { + "inputJson": "{\"dataset\":[{\"date\":\"2023/12/31\",\"sales\":null},{\"date\":\"2024/01/01\",\"sales\":300}],\"inputFormat\":\"array\",\"dateFormat\":\"MM/DD/YYYY\",\"numericPrecision\":0,\"columnMapping\":{\"date\":\"Sale Date\",\"sales\":\"Total Sales\"},\"removeEmptyRows\":true}", + "description": "Formats an array dataset for display, changing date format to MM/DD/YYYY, rounding sales to integer, renaming columns, and removing fully empty rows." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Dataset", + "context": null + } + }, + { + "name": "web-development.formatJSON", + "description": "Formats an input JSON string or object into a human-readable string with customizable indentation and optional sorting of keys. Accepts either a raw JSON string or a JavaScript object, processes it by pretty-printing with given indentation level and optional key sorting, and returns the formatted JSON string output suitable for improved readability and maintenance.", + "category": "web-development", + "parameters": [ + { + "name": "inputJSON", + "type": "string", + "description": "Input JSON to format as a string. Can be a raw JSON string or a stringified object. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for indentation in the output. Defaults to 2 spaces.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "Whether to sort the JSON object keys alphabetically before formatting. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputAsString", + "type": "boolean", + "description": "If true, always returns a formatted JSON string. If false and input is an object, returns the formatted JSON object (parsed). Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted JSON output either as a string or object, plus an error message if formatting failed. Contains keys: formattedJSON (string), error (string, empty if none)." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw or minified JSON data into a neatly indented and optionally key-sorted format for easier reading, debugging, or presentation in web development environments.", + "limitations": "Does not validate if the input JSON contains semantic errors or circular references. Fails if input is not valid JSON or object.", + "examples": [ + "Format a minified JSON string with 4 spaces indentation and sorted keys", + "Pretty-print a JSON object with default indentation", + "Format a JSON string without sorting keys and using 2 spaces indentation" + ] + }, + "tags": [ + "formatting", + "json", + "web-development", + "pretty-print", + "data-processing" + ], + "examples": [ + { + "inputJson": "{\"inputJSON\":\"{\\\"name\\\":\\\"Alice\\\",\\\"age\\\":30,\\\"city\\\":\\\"New York\\\"}\",\"indentation\":4,\"sortKeys\":true,\"outputAsString\":true}", + "description": "Format a JSON string with 4 spaces indentation and sorted keys." + }, + { + "inputJson": "{\"inputJSON\":\"{\\\"b\\\":2,\\\"a\\\":1}\",\"indentation\":2,\"sortKeys\":false,\"outputAsString\":true}", + "description": "Format a JSON string with default 2 spaces indentation and without sorting keys." + }, + { + "inputJson": "{\"inputJSON\":\"{\\\"z\\\":10,\\\"y\\\":20}\",\"outputAsString\":true}", + "description": "Format JSON string with default indentation and no sorting keys, output as formatted string." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "JSON", + "context": null + } + }, + { + "name": "web-development.formatTest", + "description": "Formats test code snippets from various testing frameworks (e.g., Jest, Mocha) into a standardized, readable style with consistent indentation, spacing, and naming conventions. Accepts raw test code as a string and outputs the formatted test code string for improved readability and maintainability.", + "category": "web-development", + "parameters": [ + { + "name": "testCode", + "type": "string", + "description": "Raw source code of the test to be formatted, as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "The testing framework of the input code, e.g., 'jest', 'mocha'. Helps tailor formatting rules.", + "required": false, + "defaultValue": "jest" + }, + { + "name": "indentStyle", + "type": "string", + "description": "Indentation style to apply: 'spaces' or 'tabs'.", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces or tabs to use per indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length before wrapping code lines.", + "required": false, + "defaultValue": "80" + }, + { + "name": "quoteStyle", + "type": "string", + "description": "Preferred quote style for strings: 'single' or 'double'.", + "required": false, + "defaultValue": "single" + }, + { + "name": "semi", + "type": "boolean", + "description": "Whether to add semicolons at the end of statements.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted test code string under 'formattedTestCode' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize or clean up test code from various sources or frameworks to improve readability and consistency in web development projects. Ideal during code reviews, refactoring, or CI pipelines to ensure test code adheres to team style guidelines.", + "limitations": "This tool does not validate test logic or ensure tests pass; it only formats code style. Complex dynamic code or non-standard test syntaxes may not format correctly.", + "examples": [ + "Format a raw Jest unit test code string to consistent style.", + "Convert a Mocha test code to use tabs indentation and double quotes.", + "Apply consistent semicolon usage and line length wrapping to test JavaScript functions." + ] + }, + "tags": [ + "web", + "development", + "testing", + "formatting", + "code-style", + "jest", + "mocha" + ], + "examples": [ + { + "inputJson": "{\"testCode\":\"describe('sum', ()=>{test('adds numbers',()=>{expect(sum(1,2)).toBe(3)})})\",\"framework\":\"jest\",\"indentStyle\":\"spaces\",\"indentSize\":2,\"maxLineLength\":80,\"quoteStyle\":\"single\",\"semi\":true}", + "description": "Format a simple Jest test code snippet with 2 spaces indent, single quotes, and semicolons." + }, + { + "inputJson": "{\"testCode\":\"describe('API tests', function() { it('returns 200', function() { assert.equal(response.status, 200)})})\",\"framework\":\"mocha\",\"indentStyle\":\"tabs\",\"indentSize\":1,\"maxLineLength\":100,\"quoteStyle\":\"double\",\"semi\":false}", + "description": "Format a Mocha test snippet using tabs for indentation, double quotes, and no semicolons." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Test", + "context": null + } + }, + { + "name": "web-development.formatTable", + "description": "Formats tabular data given as JSON arrays into styled HTML tables. Accepts data as an array of objects or arrays, applies optional styling and formatting options, and outputs responsive, semantic HTML table markup ready for web use.", + "category": "web-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of objects or arrays representing the rows of the table. Each object should have consistent keys for columns.", + "required": true, + "defaultValue": "" + }, + { + "name": "columnHeaders", + "type": "array", + "description": "Optional array of strings to use as column headers. If omitted and data is array of objects, headers are derived from object keys.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeBorders", + "type": "boolean", + "description": "Whether to include borders around table cells for clearer separation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "stripedRows", + "type": "boolean", + "description": "Whether to apply alternating background colors to rows for readability.", + "required": false, + "defaultValue": "false" + }, + { + "name": "responsive", + "type": "boolean", + "description": "If true, output table wrapped for horizontal scrolling on small screens.", + "required": false, + "defaultValue": "true" + }, + { + "name": "tableId", + "type": "string", + "description": "Optional id attribute for the table element for CSS or JS targeting.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single key 'html' containing the generated HTML string representing the styled table." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to convert structured data (JSON arrays or objects) into clean, styled HTML table markup suitable for embedding within web pages or apps with customizable appearance. It helps generate accessible tables with optional responsive design and visual enhancements.", + "limitations": "This tool does not support complex table features such as sorting, filtering, pagination, or nested tables. It only produces static HTML output, no interactive behaviors.", + "examples": [ + "Format a JSON array of user data into a bordered, striped HTML table for a web dashboard.", + "Generate an HTML table from an array of arrays with custom column headers and no borders.", + "Create a responsive HTML table from JSON objects with default styling and an assigned element ID." + ] + }, + "tags": [ + "html", + "table", + "formatting", + "web-development", + "responsive", + "styling" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"includeBorders\":true,\"stripedRows\":true}", + "description": "Format array of objects with borders and striped rows." + }, + { + "inputJson": "{\"data\":[[\"Product\",\"Price\",\"Stock\"],[\"Widget\",19.99,100],[\"Gadget\",29.99,50]],\"columnHeaders\":[\"Name\",\"Price\",\"Inventory\"],\"includeBorders\":false,\"responsive\":false}", + "description": "Format array of arrays with custom headers, no borders, non-responsive." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Table", + "context": null + } + }, + { + "name": "web-development.formatMigration", + "description": "Formats and standardizes database migration script code snippets to a consistent style. Accepts migration script text as input, applies syntax formatting rules based on the specified database type (e.g., SQL, MongoDB), and outputs the formatted, clean migration code ready for integration or review.", + "category": "web-development", + "parameters": [ + { + "name": "migrationCode", + "type": "string", + "description": "The raw migration script code to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "databaseType", + "type": "string", + "description": "Type of the database system the migration script targets (e.g., 'sql', 'mongodb'). Determines formatting rules.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationStyle", + "type": "string", + "description": "Indentation style to apply: 'spaces' or 'tabs'.", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces or tabs per indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "wrapLineLength", + "type": "number", + "description": "Maximum line length before wrapping is applied.", + "required": false, + "defaultValue": "80" + }, + { + "name": "preserveComments", + "type": "boolean", + "description": "Whether to preserve original comments in the migration code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted migration script and metadata such as original and formatted code length." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to clean up or standardize migration scripts in various database languages, ensuring consistent styling for readability, collaboration, or deployment. It supports multiple database types and common formatting preferences.", + "limitations": "This tool does not execute or validate migration logic correctness; it only formats code structure and style. Complex non-standard scripts or embedded dynamic code might not be perfectly formatted.", + "examples": [ + "Format a raw SQL migration script to consistent indentation and line wrapping.", + "Standardize MongoDB migration scripts with tabs indentation and preserve comments.", + "Clean and format legacy migration code snippets before code review integration." + ] + }, + "tags": [ + "formatting", + "database", + "migration", + "code-quality", + "sql", + "mongodb", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"migrationCode\":\"CREATE TABLE users(id INT PRIMARY KEY, name VARCHAR(255));\",\"databaseType\":\"sql\",\"indentationStyle\":\"spaces\",\"indentationSize\":2,\"wrapLineLength\":80,\"preserveComments\":true}", + "description": "Format a simple SQL migration script with standard 2-space indentation." + }, + { + "inputJson": "{\"migrationCode\":\"db.users.insert({name:'Alice',age:30});\",\"databaseType\":\"mongodb\",\"indentationStyle\":\"tabs\",\"indentationSize\":1,\"wrapLineLength\":100,\"preserveComments\":false}", + "description": "Format a MongoDB migration script using tabs indentation and removing comments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Migration", + "context": null + } + }, + { + "name": "web-development.formatAPI", + "description": "Formats raw API specification input (in JSON or YAML) into well-structured, human-readable documentation or code snippets. Accepts API specs and formatting options; produces formatted API docs or code stubs for easier understanding and use by developers.", + "category": "web-development", + "parameters": [ + { + "name": "apiSpec", + "type": "string", + "description": "The API specification as a JSON or YAML string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format, e.g., 'markdown', 'html', or 'codeSnippet'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "language", + "type": "string", + "description": "Programming language for code snippet generation if outputFormat is 'codeSnippet', e.g., 'javascript', 'python'.", + "required": false, + "defaultValue": "javascript" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include example requests and responses in the output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Optional style guide or formatting rules to apply (e.g., 'OpenAPI', 'RAML', or custom style).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted API documentation or code snippet as a string under the 'formattedOutput' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw API specifications into readable documentation or usable code snippets to assist developers in understanding and implementing APIs quickly and consistently. It's ideal for generating markdown docs, html formatted API pages, or client code samples from raw JSON or YAML API specs.", + "limitations": "This tool does not validate API specifications for correctness; it only formats provided specs. It cannot generate complete API implementations or handle API specs with syntax errors.", + "examples": [ + "Format a raw OpenAPI JSON spec into markdown documentation with examples.", + "Generate a Python code snippet for given API endpoints from a YAML spec.", + "Output HTML formatted API docs without example requests and responses." + ] + }, + "tags": [ + "api", + "formatting", + "documentation", + "code generation", + "web-development", + "openapi" + ], + "examples": [ + { + "inputJson": "{\"apiSpec\":\"{\\\"openapi\\\":\\\"3.0.0\\\",\\\"info\\\":{\\\"title\\\":\\\"Sample API\\\",\\\"version\\\":\\\"1.0.0\\\"},\\\"paths\\\":{\\\"/users\\\":{\\\"get\\\":{\\\"summary\\\":\\\"List users\\\",\\\"responses\\\":{\\\"200\\\":{\\\"description\\\":\\\"A JSON array of user names\\\"}}}}}}\",\"outputFormat\":\"markdown\",\"includeExamples\":true}", + "description": "Format a simple OpenAPI JSON spec to markdown including example requests." + }, + { + "inputJson": "{\"apiSpec\":\"openapi: 3.0.0\\ninfo:\\n title: Sample API\\n version: 1.0.0\\npaths:\\n /items:\\n post:\\n summary: Create item\\n responses:\\n '201':\\n description: Item created\",\"outputFormat\":\"codeSnippet\",\"language\":\"python\",\"includeExamples\":false}", + "description": "Generate Python client code snippet from YAML API spec without examples." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "API", + "context": null + } + }, + { + "name": "web-development.formatSchema", + "description": "This tool accepts JSON schema code as input and reformats it to a standardized, human-readable style according to specified indentation and styling preferences. It outputs the formatted JSON schema string, making it easier to read and maintain in web development projects.", + "category": "web-development", + "parameters": [ + { + "name": "schemaJson", + "type": "string", + "description": "The JSON schema as a string to be formatted. Must be valid JSON schema code.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for each indentation level in the formatted output.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "Whether to alphabetically sort the keys in objects for consistent ordering.", + "required": false, + "defaultValue": "true" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tab characters instead of spaces for indentation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line width for wrapping long lines in the formatted schema; if 0, no wrapping is applied.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted schema string in JSON format with applied styling preferences." + }, + "aiAgent": { + "useCase": "Use this tool when you need to clean up, standardize, or improve the readability of JSON schema files during web development. It helps automated and consistent formatting for better version control diffs and human understanding.", + "limitations": "This tool does not validate schema correctness, only formatting. It cannot merge or modify schema logic or content beyond structural formatting.", + "examples": [ + "Format a JSON schema string with 4-space indentation and sorted keys.", + "Convert a minimized JSON schema into a human-readable indented format using tabs.", + "Wrap long lines of JSON schema at 100 characters with spaces for indentation." + ] + }, + "tags": [ + "web-development", + "json-schema", + "formatting", + "code-style", + "json", + "schema", + "formatter" + ], + "examples": [ + { + "inputJson": "{\"schemaJson\":\"{\\\"type\\\":\\\"object\\\",\\\"properties\\\":{\\\"name\\\":{\\\"type\\\":\\\"string\\\"},\\\"age\\\":{\\\"type\\\":\\\"integer\\\"}}}\",\"indentation\":4,\"sortKeys\":true,\"useTabs\":false,\"lineWidth\":80}", + "description": "Format a compact JSON schema string with 4 spaces indentation and keys sorted alphabetically." + }, + { + "inputJson": "{\"schemaJson\":\"{\\\"properties\\\":{\\\"z\\\":{\\\"type\\\":\\\"string\\\"},\\\"a\\\":{\\\"type\\\":\\\"number\\\"}},\\\"type\\\":\\\"object\\\"}\",\"indentation\":2,\"sortKeys\":false,\"useTabs\":true,\"lineWidth\":0}", + "description": "Format JSON schema using tabs without sorting keys and no line wrapping." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Schema", + "context": null + } + }, + { + "name": "web-development.formatQuery", + "description": "Formats and beautifies SQL query strings, accepting raw SQL input and optional formatting preferences such as indentation size and uppercase keywords, and returns a neatly formatted SQL query string for improved readability and maintenance.", + "category": "web-development", + "parameters": [ + { + "name": "queryString", + "type": "string", + "description": "The raw SQL query string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces to use for each indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "uppercaseKeywords", + "type": "boolean", + "description": "If true, SQL keywords will be converted to uppercase for better visibility.", + "required": false, + "defaultValue": "true" + }, + { + "name": "linesBetweenClauses", + "type": "number", + "description": "Number of blank lines inserted between main SQL clauses (e.g., SELECT, FROM, WHERE).", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted SQL query string under the field 'formattedQuery'." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent encounters raw or minified SQL queries that require beautification for better readability, debugging, or presentation in web development contexts. It helps standardize query appearances to improve maintainability or documentation quality.", + "limitations": "The tool formats queries based on standard SQL syntax; it might not correctly format proprietary or non-standard SQL dialects. It does not validate SQL syntax correctness or optimize query performance.", + "examples": [ + "Format this raw SQL query for readability.", + "Convert all keywords in the SQL query to uppercase and indent with 4 spaces.", + "Insert two blank lines between main clauses in the SQL statement." + ] + }, + "tags": [ + "sql", + "formatting", + "web-development", + "query", + "beautify", + "code-style" + ], + "examples": [ + { + "inputJson": "{\"queryString\":\"select id, name from users where age>20 order by name desc\",\"indentationSize\":4,\"uppercaseKeywords\":true,\"linesBetweenClauses\":1}", + "description": "Format a simple SQL query with 4-space indentation and uppercase keywords." + }, + { + "inputJson": "{\"queryString\":\"insert into orders(id,product_id,quantity)values(1,101,2)\",\"indentationSize\":2,\"uppercaseKeywords\":false,\"linesBetweenClauses\":0}", + "description": "Format an insert statement with 2-space indentation and lowercase keywords, no extra blank lines." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Query", + "context": null + } + }, + { + "name": "web-development.formatEndpoint", + "description": "Formats a web API endpoint definition string into a standardized URL path with appropriate parameter placeholders and HTTP method indication. It accepts a raw endpoint string, HTTP method, and optional parameter details, then returns a clean, consistent endpoint format suitable for documentation or code generation.", + "category": "web-development", + "parameters": [ + { + "name": "rawEndpoint", + "type": "string", + "description": "The raw endpoint string to be formatted, e.g., '/users/:id/details' or 'api/v1/users/{userId}'", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method for this endpoint (e.g., GET, POST, PUT, DELETE) to include in the formatted output", + "required": true, + "defaultValue": "" + }, + { + "name": "parameterStyle", + "type": "string", + "description": "Style to use for path parameters: 'colon' for :param, 'curly' for {param}, or 'semicolon' for ;param (default is colon)", + "required": false, + "defaultValue": "colon" + }, + { + "name": "queryParameters", + "type": "array", + "description": "Optional array of query parameter names to append to the endpoint as a query string template", + "required": false, + "defaultValue": "[]" + }, + { + "name": "normalizeSlashes", + "type": "boolean", + "description": "Whether to normalize multiple slashes and remove trailing slash except root", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted endpoint string, including normalized path, standardized parameter placeholders, HTTP method label, and optionally the full URI template with query parameters." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert various raw or inconsistent API endpoint specifications into a single uniform format, especially useful before generating API documentation, client SDK code, or routing logic. It standardizes parameter syntax and URL formatting for better interoperability.", + "limitations": "This tool does not validate the semantic correctness of parameter names, nor does it parse or handle complex nested query parameter schemas or body payloads. It focuses solely on URL path and query string formatting.", + "examples": [ + "Format a REST endpoint with colon style parameters and GET method.", + "Normalize slashes and adapt parameters to curly braces style with POST method.", + "Add query parameters template to a base endpoint URL." + ] + }, + "tags": [ + "web-development", + "api", + "endpoint", + "formatting", + "url", + "http-method", + "parameter-handling" + ], + "examples": [ + { + "inputJson": "{\"rawEndpoint\":\"/api/v1/users/:userId/profile\",\"httpMethod\":\"GET\",\"parameterStyle\":\"curly\",\"queryParameters\":[\"include\",\"limit\"],\"normalizeSlashes\":true}", + "description": "Convert colon style path parameters to curly braces, add query parameters, and normalize slashes for a GET user profile endpoint." + }, + { + "inputJson": "{\"rawEndpoint\":\"//orders//:orderId//items\",\"httpMethod\":\"POST\",\"parameterStyle\":\"colon\",\"queryParameters\":[],\"normalizeSlashes\":true}", + "description": "Clean up duplicate slashes and keep colon style parameters for a POST order items endpoint without query parameters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Endpoint", + "context": null + } + }, + { + "name": "web-development.formatModule", + "description": "Formats JavaScript or TypeScript module code to a consistent style. Accepts source code as a string along with formatting options, then applies indentation, semicolon usage, quote style, and other stylistic rules to produce clean, standardized module code output.", + "category": "web-development", + "parameters": [ + { + "name": "sourceCode", + "type": "string", + "description": "The raw JavaScript or TypeScript module code to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Specifies whether the source code is 'javascript' or 'typescript'", + "required": true, + "defaultValue": "javascript" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for indentation", + "required": false, + "defaultValue": "2" + }, + { + "name": "useSemicolons", + "type": "boolean", + "description": "Determines whether to add semicolons at the end of statements", + "required": false, + "defaultValue": "true" + }, + { + "name": "quoteStyle", + "type": "string", + "description": "Preferred quote style: 'single' or 'double'", + "required": false, + "defaultValue": "single" + }, + { + "name": "trailingComma", + "type": "string", + "description": "Trailing commas style: 'none', 'es5', or 'all'", + "required": false, + "defaultValue": "es5" + } + ], + "returns": { + "type": "object", + "description": "Returns a formatted code string for the module, and optionally a report object with formatting changes or errors" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to clean up or standardize module source code to a preferred coding style for readability, consistency, or before further processing (e.g., analysis, transpilation). It is appropriate for both JavaScript and TypeScript modules.", + "limitations": "Does not perform semantic code transformations, lint fixes beyond formatting, or code validation. It requires syntactically valid input code; malformed modules may result in formatting errors.", + "examples": [ + "Format a raw TypeScript module code with 4 spaces indentation, double quotes, and no semicolons.", + "Convert JavaScript module source to use single quotes and trailing commas on ES5-compatible syntax, with 2 spaces indentation.", + "Apply formatting to a JavaScript module source disabling trailing commas and ensuring semicolons." + ] + }, + "tags": [ + "formatting", + "javascript", + "typescript", + "code-style", + "module", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"sourceCode\":\"import React from 'react';\\nconst Comp=()=>{returntext \\nHello}\\nexport default Comp\",\"language\":\"javascript\",\"indentSize\":2,\"useSemicolons\":true,\"quoteStyle\":\"single\",\"trailingComma\":\"es5\"}", + "description": "Format a small React JS module code to use 2 spaces, semicolons, single quotes and ES5 trailing commas." + }, + { + "inputJson": "{\"sourceCode\":\"type User = {name:string,age:number}\\nconst getUser = (): User => {return {name:\\\"Alice\\\", age:30}}\",\"language\":\"typescript\",\"indentSize\":4,\"useSemicolons\":false,\"quoteStyle\":\"double\",\"trailingComma\":\"none\"}", + "description": "Format a TypeScript module snippet with 4 space indents, double quotes, no semicolons, and no trailing commas." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Module", + "context": null + } + }, + { + "name": "web-development.formatFunction", + "description": "Formats a JavaScript function code snippet according to specified styling rules. Accepts a function as a string, applies indentation, spacing, and bracket placement preferences, and returns the formatted function string ready for use in web development.", + "category": "web-development", + "parameters": [ + { + "name": "functionCode", + "type": "string", + "description": "The JavaScript function code as a raw string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentStyle", + "type": "string", + "description": "Specifies the indentation style to use. Options: 'space' or 'tab'.", + "required": false, + "defaultValue": "space" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces per indentation level (if indentStyle is 'space').", + "required": false, + "defaultValue": "2" + }, + { + "name": "braceStyle", + "type": "string", + "description": "Brace style for function blocks. Options: '1tbs' (one true brace style), 'allman'.", + "required": false, + "defaultValue": "1tbs" + }, + { + "name": "spaceBeforeParen", + "type": "boolean", + "description": "Whether to insert a space before the parentheses in function declaration (e.g., function name () vs function name()).", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveNewlines", + "type": "boolean", + "description": "Whether to keep existing line breaks within the function code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function as a string under the key 'formattedFunction'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to ensure that JavaScript function code snippets conform to consistent style guidelines before injecting into projects or for improved readability and maintenance. It supports customization of indentation, brace placement, and spacing to match project coding standards.", + "limitations": "This tool only formats single JavaScript function code snippets and does not validate or parse entire scripts or other programming languages. It does not correct syntax errors or semantic issues in the code.", + "examples": [ + "Format a raw JS function code string with 4 spaces indentation and Allman brace style.", + "Format a function string to enforce no space before parentheses and tab indentation.", + "Preserve existing newlines but apply 2-space indentation and 1tbs brace style." + ] + }, + "tags": [ + "formatting", + "javascript", + "code-style", + "web-development", + "function" + ], + "examples": [ + { + "inputJson": "{\"functionCode\":\"function greet(name){console.log('Hello, '+name);}\",\"indentStyle\":\"space\",\"indentSize\":2,\"braceStyle\":\"1tbs\",\"spaceBeforeParen\":false,\"preserveNewlines\":true}", + "description": "Format a simple function with 2 spaces indentation and one true brace style without space before parentheses." + }, + { + "inputJson": "{\"functionCode\":\"function add (a,b)\n{\nreturn a+b;\n}\",\"indentStyle\":\"space\",\"indentSize\":4,\"braceStyle\":\"allman\",\"spaceBeforeParen\":true,\"preserveNewlines\":false}", + "description": "Format function with 4 space indentation, Allman style braces with space before parentheses, removing extra newlines." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "web-development.formatComponent", + "description": "Formats source code of web components (React, Vue, Angular) to improve readability and maintain consistent style. Accepts the component code as a string, applies specified style rules or defaults, and returns the formatted code string.", + "category": "web-development", + "parameters": [ + { + "name": "componentCode", + "type": "string", + "description": "The raw source code of the web component to format, provided as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "Specifies the framework of the component (e.g., 'react', 'vue', 'angular') to apply framework-specific formatting.", + "required": false, + "defaultValue": "react" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Name of the styling convention or code standard to apply (e.g., 'prettier', 'eslint', 'custom').", + "required": false, + "defaultValue": "prettier" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation (true) or spaces (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "tabWidth", + "type": "number", + "description": "Number of spaces per indentation level if spaces are used.", + "required": false, + "defaultValue": "2" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted component code as a string under the key 'formattedCode'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to consistently format web component source code to adhere to style guides, improving readability and maintainability across team projects. It supports multiple frameworks and formatting style options, helping when generating or refactoring component code.", + "limitations": "This tool formats code but does not validate syntax correctness or fix runtime errors. It does not support custom formatting rules beyond the specified style guides.", + "examples": [ + "Format a React component code string using Prettier style defaults.", + "Format a Vue component with custom tab settings.", + "Apply Angular component formatting using ESLint rules." + ] + }, + "tags": [ + "formatting", + "web-development", + "code-style", + "react", + "vue", + "angular", + "components" + ], + "examples": [ + { + "inputJson": "{\"componentCode\":\"function Button(){return }\",\"framework\":\"react\",\"styleGuide\":\"prettier\",\"useTabs\":false,\"tabWidth\":2}", + "description": "Format a simple React button component using Prettier defaults with spaces for indentation." + }, + { + "inputJson": "{\"componentCode\":\"\\n{{ message }}\\n\",\"framework\":\"vue\",\"styleGuide\":\"prettier\",\"useTabs\":true,\"tabWidth\":4}", + "description": "Format a Vue component template using tabs for indentation with tab width 4." + }, + { + "inputJson": "{\"componentCode\":\"@Component({ selector: 'app-root' })\\nexport class AppComponent {}\",\"framework\":\"angular\",\"styleGuide\":\"eslint\",\"useTabs\":false,\"tabWidth\":2}", + "description": "Format a basic Angular component code applying ESLint style guide with spaces and 2 spaces indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Component", + "context": null + } + }, + { + "name": "web-development.formatReadme", + "description": "Formats a README markdown document according to configurable style preferences and standards. It accepts the raw README content as input, applies standard formatting rules such as header normalization, bullet list consistency, code block styling, and line width adjustments, then outputs the formatted markdown text ready for use in repositories.", + "category": "web-development", + "parameters": [ + { + "name": "readmeContent", + "type": "string", + "description": "The raw markdown content of the README file to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length for wrapping text lines in the README. Defaults to 80 characters.", + "required": false, + "defaultValue": "80" + }, + { + "name": "headerStyle", + "type": "string", + "description": "Preferred header style: 'atx' (prefix '#' characters) or 'setext' (underline style).", + "required": false, + "defaultValue": "atx" + }, + { + "name": "bulletStyle", + "type": "string", + "description": "Preferred bullet list style: '-' (dash), '*' (asterisk), or '+' (plus).", + "required": false, + "defaultValue": "-" + }, + { + "name": "codeBlockStyle", + "type": "string", + "description": "Code block style: 'fenced' (triple backticks) or 'indented' (4-space indentation).", + "required": false, + "defaultValue": "fenced" + }, + { + "name": "ensureTrailingNewline", + "type": "boolean", + "description": "If true, ensures the README ends with a newline character.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Object containing the formatted README markdown text under 'formattedReadme' key, suitable for saving or displaying." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to clean up or standardize a project's README markdown file for consistency and readability before publishing or committing to version control. It helps maintain uniform style across projects or teams by automatically applying formatting rules based on specified preferences.", + "limitations": "This tool does not rewrite or generate README content, nor does it validate markdown semantic correctness beyond formatting style. Complex markdown elements like embedded HTML might not be perfectly handled.", + "examples": [ + "Format a messy README markdown to use ATX headers, dashes for bullets, fenced code blocks, and wrap lines at 80 characters.", + "Convert a README from indented code blocks to fenced code blocks and ensure the document ends with a trailing newline.", + "Apply consistent bullet style and header formatting to a newly created README file." + ] + }, + "tags": [ + "markdown", + "readme", + "formatting", + "web-development", + "documentation", + "style", + "automation" + ], + "examples": [ + { + "inputJson": "{\"readmeContent\":\"#Project Title\\nThis project does amazing things. \\n* First feature\\n* Second feature\\n```\ndef example():\\n pass\\n```\",\"maxLineLength\":80,\"headerStyle\":\"atx\",\"bulletStyle\":\"-\",\"codeBlockStyle\":\"fenced\",\"ensureTrailingNewline\":true}", + "description": "Formats a basic README with bullet and code block style preference, enforcing 80 character line wrap." + }, + { + "inputJson": "{\"readmeContent\":\"Project Title\\n==============\\n\\nThis is an indented code block:\\n console.log('Hello');\",\"maxLineLength\":100,\"headerStyle\":\"atx\",\"bulletStyle\":\"*\",\"codeBlockStyle\":\"fenced\",\"ensureTrailingNewline\":false}", + "description": "Converts a setext header to ATX style and changes indented code blocks to fenced style." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Readme", + "context": null + } + }, + { + "name": "web-development.formatTemplate", + "description": "Formats HTML or text-based templates by applying indentation, line breaks, and consistent spacing for improved readability and maintainability. Accepts template content as a string, along with optional formatting options, and outputs a neatly formatted template string.", + "category": "web-development", + "parameters": [ + { + "name": "templateContent", + "type": "string", + "description": "The raw template string content to be formatted, such as HTML, XML, or text with placeholders.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces used for each indentation level in the formatted template.", + "required": false, + "defaultValue": "2" + }, + { + "name": "preserveLineBreaks", + "type": "boolean", + "description": "Whether to preserve existing line breaks in the template or reformat them.", + "required": false, + "defaultValue": "true" + }, + { + "name": "compressWhitespace", + "type": "boolean", + "description": "Whether to reduce multiple spaces and tabs to a single space, compressing whitespace where possible.", + "required": false, + "defaultValue": "false" + }, + { + "name": "templateType", + "type": "string", + "description": "Type of the template language (e.g., html, xml, handlebars, mustache) to apply appropriate formatting rules.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted template string under the key 'formattedTemplate'." + }, + "aiAgent": { + "useCase": "Use this tool to format and beautify template files or strings when generating or modifying templates in web development projects. This improves readability and consistency in templates such as HTML, XML, or templating languages, facilitating debugging and collaborative editing.", + "limitations": "Does not analyze template logic or validate syntax correctness. It only formats whitespace, indentation, and line breaks according to simple rules and does not execute or render the template.", + "examples": [ + "Format a raw HTML template string for better readability.", + "Apply consistent indentation of 4 spaces across a mustache template.", + "Reduce whitespace in an XML configuration template while preserving line breaks." + ] + }, + "tags": [ + "formatting", + "template", + "web", + "html", + "xml", + "templating" + ], + "examples": [ + { + "inputJson": "{\"templateContent\":\"\",\"indentationSpaces\":2,\"preserveLineBreaks\":true,\"compressWhitespace\":false,\"templateType\":\"html\"}", + "description": "Format a simple HTML template with default 2-space indentation." + }, + { + "inputJson": "{\"templateContent\":\"Hello,{{name}}
\\n \",\"indentationSpaces\":4,\"preserveLineBreaks\":true,\"compressWhitespace\":true,\"templateType\":\"html\"}", + "description": "Format a section template with 4-space indentation and compress extra spaces inside tags." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Template", + "context": null + } + }, + { + "name": "web-development.formatSpec", + "description": "Formats web development specification documents to improve readability and maintain consistent structure. Accepts spec content in markdown or JSON format, applies style guidelines such as indentation, heading styles, bullet points, and code blocks, then returns a neatly formatted version in the requested output format (markdown or JSON).", + "category": "web-development", + "parameters": [ + { + "name": "specContent", + "type": "string", + "description": "The raw specification document content to be formatted, either as markdown text or JSON string.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "The format of the input specContent: 'markdown' or 'json'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format after formatting: 'markdown' or 'json'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "styleGuide", + "type": "object", + "description": "Optional object specifying style preferences such as indentation size, heading style (e.g., hash marks count), bullet character, and code block style.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted specification content as a string in the requested format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to take a raw or inconsistently formatted web development specification document and transform it into a clear, consistent, and standardized format, improving readability and maintainability. Useful for preparing specs for sharing with teams or publishing.", + "limitations": "Cannot interpret or create specification content; it only formats given content. Complex semantic corrections or content validation are outside its scope.", + "examples": [ + "Format a markdown spec document to have consistent heading levels and bullet styles.", + "Convert a JSON-format spec into a neatly indented JSON string with sorted keys.", + "Reformat a markdown spec using a specified style guide with 4-space indent and dash bullet points." + ] + }, + "tags": [ + "web-development", + "formatting", + "documentation", + "specification", + "markdown", + "json" + ], + "examples": [ + { + "inputJson": "{\"specContent\":\"# API Spec\\n Use this document to describe endpoints.\\n- endpoint1\\n-endpoint2\",\"inputFormat\":\"markdown\",\"outputFormat\":\"markdown\"}", + "description": "Format a messy markdown specification document to consistent heading and bullet styles." + }, + { + "inputJson": "{\"specContent\":\"{\\n\\\"title\\\": \\\"API Spec\\\",\\n\\\"endpoints\\\": [\\\"endpoint1\\\", \\\"endpoint2\\\"]\\n}\",\"inputFormat\":\"json\",\"outputFormat\":\"json\"}", + "description": "Format a JSON string spec into properly indented JSON." + }, + { + "inputJson": "{\"specContent\":\"## Spec\\n* point1\\n*point2\",\"inputFormat\":\"markdown\",\"outputFormat\":\"markdown\",\"styleGuide\":{\"indentSize\":4,\"bulletChar\":\"-\"}}", + "description": "Reformat markdown spec with 4 spaces indentation and dash bullets." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Spec", + "context": null + } + }, + { + "name": "web-development.formatFAQ", + "description": "Formats a raw FAQ input by structuring questions and answers into a clean, consistent HTML or Markdown layout. Accepts an array of question-answer pairs and customization parameters for output style, enabling easy integration into web pages or documentation sites. Produces formatted text output ready for display.", + "category": "web-development", + "parameters": [ + { + "name": "faqEntries", + "type": "array", + "description": "Array of objects each containing 'question' and 'answer' strings to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Specifies the format of the output, such as 'html' or 'markdown'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeNumbering", + "type": "boolean", + "description": "Whether to number the questions in the output for easier reference.", + "required": false, + "defaultValue": "true" + }, + { + "name": "questionStyle", + "type": "string", + "description": "CSS class or markdown syntax for styling questions.", + "required": false, + "defaultValue": "\"faq-question\"" + }, + { + "name": "answerStyle", + "type": "string", + "description": "CSS class or markdown syntax for styling answers.", + "required": false, + "defaultValue": "\"faq-answer\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single string 'formattedFAQ', which is the fully formatted FAQ content as per chosen options." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw FAQ data, typically a JSON or array of question-answer pairs, into a formatted web-friendly block for websites or documentation portals. It helps automate consistent styling and structuring FAQs for usability and aesthetic coherence.", + "limitations": "This tool does not generate FAQ content or validate factual correctness; it only formats provided data into HTML or Markdown representations. It also does not support interactive FAQ behaviors like collapsible answers without additional client-side scripting.", + "examples": [ + "Format an array of FAQs into HTML with numbered questions for a help page.", + "Generate a markdown-formatted FAQ list without numbering for a README file.", + "Apply custom CSS classes to FAQ entries for branding in a web app." + ] + }, + "tags": [ + "web", + "FAQ", + "formatting", + "documentation", + "HTML", + "Markdown" + ], + "examples": [ + { + "inputJson": "{\"faqEntries\":[{\"question\":\"What is your return policy?\",\"answer\":\"You can return any item within 30 days.\"},{\"question\":\"Do you ship internationally?\",\"answer\":\"Yes, we ship to most countries worldwide.\"}],\"outputFormat\":\"html\",\"includeNumbering\":true}", + "description": "Formats a simple FAQ array to numbered HTML styled with default CSS classes." + }, + { + "inputJson": "{\"faqEntries\":[{\"question\":\"How to reset my password?\",\"answer\":\"Click on 'Forgot password' and follow instructions.\"}],\"outputFormat\":\"markdown\",\"includeNumbering\":false,\"questionStyle\":\"**\",\"answerStyle\":\"_\"}", + "description": "Creates a markdown formatted FAQ without numbering, styling questions bold and answers italic." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "FAQ", + "context": null + } + }, + { + "name": "web-development.formatBrief", + "description": "Formats a textual project brief for web development purposes. Accepts raw text input of a brief and optional style preferences; processes the text to ensure consistent formatting, clear section organization, standard fonts, and proper paragraph spacing. Outputs a cleaned, styled version of the brief as HTML or plain text ready for inclusion in documentation or web presentation.", + "category": "web-development", + "parameters": [ + { + "name": "briefText", + "type": "string", + "description": "The raw textual content of the brief to be formatted. Required for processing.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format: 'html' for styled HTML output or 'plain' for plain text output.", + "required": false, + "defaultValue": "html" + }, + { + "name": "fontFamily", + "type": "string", + "description": "CSS font-family name to apply in the formatted output. Defaults to a clean, sans-serif font for readability.", + "required": false, + "defaultValue": "Arial, sans-serif" + }, + { + "name": "fontSize", + "type": "number", + "description": "Base font size in pixels to use in the formatted text.", + "required": false, + "defaultValue": "14" + }, + { + "name": "includeSectionHeaders", + "type": "boolean", + "description": "Whether to parse and highlight common section headers in the brief (e.g., Objectives, Timeline, Deliverables).", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed line length before wrapping text in plain output mode; ignored for HTML output.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted brief as a string in the requested format, and metadata about the formatting applied." + }, + "aiAgent": { + "useCase": "Use this tool when needing to prepare or standardize web project briefs for presentation, sharing, or documentation. It helps agents convert unstructured raw text briefs into professionally formatted documents with consistent styling and clear structure, output as HTML or plain text as needed.", + "limitations": "This tool does not perform deep semantic analysis of the brief content, cannot create briefs from scratch, nor does it handle complex multimedia content. It focuses on formatting textual briefs only.", + "examples": [ + "Format this raw project brief text into styled HTML for inclusion on our project wiki.", + "Convert this unformatted brief text into clean plain text with proper line breaks and readable font size.", + "Apply standard section headers highlighting and font styling to this client brief text and return it as HTML." + ] + }, + "tags": [ + "formatting", + "web-development", + "documentation", + "brief", + "html", + "plain-text", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"briefText\":\"Project Overview:\\nBuild a responsive website that showcases our product catalog.\\nObjectives:\\n- Create user-friendly navigation\\n- Optimize for mobile devices\\nTimeline:\\nCompletion expected in 3 months.\",\"outputFormat\":\"html\",\"fontFamily\":\"Helvetica, sans-serif\",\"fontSize\":16,\"includeSectionHeaders\":true}", + "description": "Input raw brief text with common headers, requesting HTML output with Helvetica font and 16px size." + }, + { + "inputJson": "{\"briefText\":\"This is a quick note about the website update. Make sure SEO tags are updated accordingly.\",\"outputFormat\":\"plain\",\"maxLineLength\":60}", + "description": "Simple short brief text requesting plain text formatting with line wrap at 60 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Brief", + "context": null + } + }, + { + "name": "web-development.formatChecklist", + "description": "Formats a textual checklist input into a clean, structured HTML or markdown format suitable for embedding in web pages or documentation. Accepts raw checklist text with optional metadata, processes it to uniform style, indentation, and bullet styles, then outputs formatted checklist string in the selected format.", + "category": "web-development", + "parameters": [ + { + "name": "checklistText", + "type": "string", + "description": "Raw checklist text input, with items separated by lines, optionally including nesting.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: 'html' for web embedding or 'markdown' for documentation.", + "required": true, + "defaultValue": "html" + }, + { + "name": "includeCheckboxes", + "type": "boolean", + "description": "Whether to include interactive or visual checkboxes (HTML input elements or markdown checkboxes).", + "required": false, + "defaultValue": "true" + }, + { + "name": "bulletStyle", + "type": "string", + "description": "Bullet style for top-level items, e.g. '-', '*', or numbers for ordered lists.", + "required": false, + "defaultValue": "-" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for indenting nested checklist items (only affects markdown).", + "required": false, + "defaultValue": "2" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted checklist string in the requested format under 'formattedChecklist' key." + }, + "aiAgent": { + "useCase": "Use this tool when needing to transform a raw or loosely formatted textual checklist into a consistent, attractive format for web or documents, ensuring proper nesting, bullet styles, and optionally interactive checkboxes. Ideal for content automation or generating UI components from plain text.", + "limitations": "Cannot parse very complex checklist syntax with mixed styles or embedded HTML; limited to basic nesting and bullet styles. It does not apply styling beyond formatting and cannot convert to formats other than HTML or markdown.", + "examples": [ + "Format a raw text checklist into a clean HTML list with checkboxes for embedding on a website.", + "Convert a plain text list to markdown format with proper indentation and bullet styling for documentation.", + "Generate a nested checklist in HTML without checkboxes for static display." + ] + }, + "tags": [ + "web", + "formatting", + "checklist", + "html", + "markdown", + "content", + "automation" + ], + "examples": [ + { + "inputJson": "{\"checklistText\":\"Design homepage\\n- Create wireframe\\n- Review with team\\nDeploy site\\n- Run tests\\n- Go live\",\"outputFormat\":\"html\",\"includeCheckboxes\":true,\"bulletStyle\":\"-\",\"indentSize\":2}", + "description": "Formats a simple nested task checklist into an HTML list with checkboxes." + }, + { + "inputJson": "{\"checklistText\":\"Buy groceries\\n Fruits\\n Vegetables\\nClean house\",\"outputFormat\":\"markdown\",\"includeCheckboxes\":true,\"bulletStyle\":\"*\",\"indentSize\":4}", + "description": "Converts a checklist with two nesting levels into markdown with checkboxes and 4-space indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Checklist", + "context": null + } + }, + { + "name": "web-development.formatCode", + "description": "Formats source code strings according to specified syntax rules and style preferences to improve readability and maintainability. Accepts raw code as input along with language specification and optional style configuration, and returns the formatted code string.", + "category": "web-development", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The raw source code string that needs to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming language of the code to determine proper parsing and formatting rules, e.g., 'javascript', 'python'.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleConfig", + "type": "object", + "description": "An optional object specifying style preferences such as indentation size, use of tabs vs spaces, line width limits, and other language-specific formatting rules.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted code string and any warnings or errors encountered during formatting." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically format code snippets or files to ensure consistent styling and improved readability across projects. It is especially helpful for standardizing code before commits, reviews, or sharing, and supports multiple languages and style configurations.", + "limitations": "Cannot fix semantic errors or refactor code logic; only performs syntactical formatting. Some complex or partial code fragments may not format correctly.", + "examples": [ + "Format a JavaScript function with 2-space indentation.", + "Format a Python script using PEP8 style guidelines.", + "Format a JSON string with 4 spaces indentation." + ] + }, + "tags": [ + "formatting", + "code", + "web-development", + "style", + "linting", + "beautify" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function test(){console.log('Hello, world!');}\",\"language\":\"javascript\",\"styleConfig\":{\"indentSize\":2,\"useTabs\":false}}", + "description": "Format a JavaScript function with 2 spaces indentation and spaces instead of tabs." + }, + { + "inputJson": "{\"code\":\"def foo():\\n print('bar')\",\"language\":\"python\",\"styleConfig\":{\"maxLineLength\":79}}", + "description": "Format a Python function conforming to max line length 79 for readability." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "web-development.formatTranscript", + "description": "Formats raw text transcripts by applying consistent punctuation, capitalization, speaker labeling, and paragraph breaks. Accepts plain text or JSON with speaker segments, processes it to improve readability and structure, and outputs a clean, formatted transcript suitable for publishing or archiving.", + "category": "web-development", + "parameters": [ + { + "name": "transcriptText", + "type": "string", + "description": "Raw transcript text input, may be plain text or semi-structured.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the input transcript: plainText or jsonSegments.", + "required": true, + "defaultValue": "plainText" + }, + { + "name": "speakerLabels", + "type": "boolean", + "description": "Whether to detect and label speaker turns explicitly.", + "required": false, + "defaultValue": "true" + }, + { + "name": "addTimestamps", + "type": "boolean", + "description": "Whether to include timestamps before each speaker segment if available.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum length of each line before inserting a line break for readability.", + "required": false, + "defaultValue": "80" + }, + { + "name": "capitalizeSentences", + "type": "boolean", + "description": "Whether to capitalize the first letter of each sentence.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted transcript as a string, and optionally a JSON structured version with speaker segments and timestamps if parsed." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw or semi-structured transcript data from interviews, meetings or speeches and want to produce a clean, human-readable, well-formatted transcript with proper punctuation, capitalization and speaker labels. Useful before publishing or sharing transcripts or for better readability.", + "limitations": "This tool does not perform transcription or audio processing; it requires text input. It cannot perfectly infer all speaker changes unless explicit segmentation is provided. Complex transcripts with overlapping speech or poor input structure may not format ideally.", + "examples": [ + "Format a raw meeting transcript to add speaker names and punctuation.", + "Convert JSON segments of a podcast transcript into a readable formatted text.", + "Reformat a plain text interview transcript applying consistent capitalization and paragraphs." + ] + }, + "tags": [ + "formatting", + "transcript", + "web-development", + "text-processing", + "readability" + ], + "examples": [ + { + "inputJson": "{\"transcriptText\":\"john: hello there how are you doing today\\nmary: i'm good thanks! and you?\",\"inputFormat\":\"plainText\",\"speakerLabels\":true,\"addTimestamps\":false,\"maxLineLength\":80,\"capitalizeSentences\":true}", + "description": "Format a plain text transcript with speaker labels and capitalization." + }, + { + "inputJson": "{\"transcriptText\":\"[{\\\"speaker\\\":\\\"User\\\",\\\"text\\\":\\\"hello john how are you?\\\", \\\"timestamp\\\":\\\"00:00:05\\\"},{\\\"speaker\\\":\\\"John\\\",\\\"text\\\":\\\"i'm doing well thanks for asking.\\\",\\\"timestamp\\\":\\\"00:00:10\\\"}]\",\"inputFormat\":\"jsonSegments\",\"speakerLabels\":true,\"addTimestamps\":true,\"maxLineLength\":80,\"capitalizeSentences\":true}", + "description": "Format a JSON structured transcript with speaker names and timestamps added." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Transcript", + "context": null + } + }, + { + "name": "web-development.formatMinutes", + "description": "Formats raw meeting minutes text into a clean, structured HTML document. Accepts unformatted minute text, applies parsing rules such as headings for agenda items, bullet points for decisions and actions, and timestamps formatting to produce readable, accessible minutes ready for web publishing or sharing.", + "category": "web-development", + "parameters": [ + { + "name": "rawMinutesText", + "type": "string", + "description": "Unstructured raw text of meeting minutes that need formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Flag to enable formatting or highlighting of timestamps within the minutes.", + "required": false, + "defaultValue": "true" + }, + { + "name": "highlightDecisions", + "type": "boolean", + "description": "Whether to visually emphasize decision items in the output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format; supports 'html' (default) or 'markdown'.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted minutes as a string in the requested format and metadata such as word count and detected agenda items count." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw, often loosely formatted meeting minutes that need to be transformed automatically into a clean, readable, and structured format for web display or documentation. The tool helps maintain consistency and enhances readability, especially useful for publishing minutes in internal or external sites.", + "limitations": "This tool cannot interpret or correct semantic errors in meeting content, nor can it guarantee perfect accuracy in complex minutes with unusual formatting or shorthand. It also does not generate summaries or translate content.", + "examples": [ + "Format these raw minutes including timestamps and highlight decisions for our project meeting.", + "Convert plain text meeting notes into clean HTML minutes for our company intranet.", + "Output the meeting minutes in markdown format for our documentation repository." + ] + }, + "tags": [ + "formatting", + "minutes", + "meeting-notes", + "web-development", + "document-structuring", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"rawMinutesText\":\"Meeting started at 10:00 AM.\\nAgenda: Project Updates\\n- Discussed progress on phase 1.\\nDecision: Move to phase 2 next week.\\nAction: John to prepare report by Friday.\",\"includeTimestamps\":true,\"highlightDecisions\":true,\"outputFormat\":\"html\"}", + "description": "Raw minutes with timestamps and decisions to be formatted into HTML with decision highlights." + }, + { + "inputJson": "{\"rawMinutesText\":\"10:00 Meeting began\\nTopic 1: Budget Review\\nConclusion: Budget approved for Q4\\nNext steps: team to submit expense reports.\",\"includeTimestamps\":false,\"highlightDecisions\":false,\"outputFormat\":\"markdown\"}", + "description": "Convert meeting notes to markdown without highlighting decisions or timestamps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Minutes", + "context": null + } + }, + { + "name": "web-development.formatBlogPost", + "description": "Formats a blog post content input to consistent styling and structure. Accepts raw blog post data including title, author, date, body text, and optional tags. Processes the input to normalize headings, paragraphs, code snippets, and lists according to best web development practices, then outputs a clean HTML string ready for website publishing.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the blog post to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the author of the blog post.", + "required": false, + "defaultValue": "" + }, + { + "name": "datePublished", + "type": "string", + "description": "Publication date in ISO 8601 format (e.g., 2024-05-01).", + "required": false, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "Raw blog post content, including markdown or plain text to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of tags or categories related to the blog post.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeTOC", + "type": "boolean", + "description": "Whether to generate and include a Table of Contents based on headings.", + "required": false, + "defaultValue": "false" + }, + { + "name": "codeHighlighting", + "type": "boolean", + "description": "Whether to apply syntax highlighting to code blocks within the content.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted blog post as sanitized and styled HTML, including optional metadata fields." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw blog post data into a polished, web-ready HTML structure with normalized formatting, suitable for publishing on websites or CMS platforms. It is ideal for standardizing style, handling headings, paragraphs, code blocks, lists, and optionally generating a Table of Contents.", + "limitations": "Does not perform content moderation or verify factual accuracy. It cannot generate blog post content from scratch and assumes input is text-based content. It is not a markdown-to-HTML converter covering all edge cases, mostly focused on common blog post structures.", + "examples": [ + "Format my raw blog post text into consistent HTML with headings and code blocks styled.", + "Generate a clean blog post HTML with TOC for publishing.", + "Normalize a given blog article content adding tags and author metadata." + ] + }, + "tags": [ + "web", + "blog", + "formatting", + "html", + "content-management", + "publishing" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Introducing Our New Feature\",\"author\":\"Jane Doe\",\"datePublished\":\"2024-05-01\",\"content\":\"# Welcome to Our Update\\nWe are excited to introduce...\\n```js\\nconsole.log('Hello, blog!');\\n```\",\"tags\":[\"update\",\"feature\"],\"includeTOC\":true,\"codeHighlighting\":true}", + "description": "Format a blog post including markdown headings and JavaScript code with TOC and syntax highlighting enabled." + }, + { + "inputJson": "{\"title\":\"Weekly Recap\",\"content\":\"This week we had several important events...\\n- Event one\\n- Event two\\nStay tuned for more!\",\"tags\":[\"weekly\",\"news\"],\"includeTOC\":false,\"codeHighlighting\":false}", + "description": "Format a simple text blog post with bullet points, excluding TOC and code highlighting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "BlogPost", + "context": null + } + }, + { + "name": "web-development.formatSummary", + "description": "Formats a given textual summary or document domain description into a clean, readable HTML snippet or plain text output. Accepts raw summary text and optional style preferences, then processes and returns a formatted version suitable for web display or documentation purposes.", + "category": "web-development", + "parameters": [ + { + "name": "summaryText", + "type": "string", + "description": "The raw plain text summary or document domain content to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatType", + "type": "string", + "description": "Desired output format: 'html' for HTML formatted output, or 'plain' for plain text.", + "required": false, + "defaultValue": "html" + }, + { + "name": "maxLength", + "type": "number", + "description": "Optional maximum length of the formatted summary; longer summaries will be truncated gracefully.", + "required": false, + "defaultValue": "0" + }, + { + "name": "addBulletPoints", + "type": "boolean", + "description": "If true and the summary contains multiple sentences or items, formats them as bullet points in HTML output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "textColor", + "type": "string", + "description": "Optional CSS color name or code to apply to text in HTML format output.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted summary string under the key 'formattedSummary'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to prepare a raw textual summary or domain description for web presentation or user-friendly display, ensuring consistent formatting such as HTML tagging, bullet points, truncation, and color styling. Particularly useful for rendering summaries in documentation sites or web dashboards.", + "limitations": "Cannot perform deep semantic summarization or content rewriting; only formats given text. Does not generate summaries from raw data or documents.", + "examples": [ + "Format a long text summary into HTML with bullet points and max length 200.", + "Generate plain text summary truncated to 100 characters for logs.", + "Produce colored HTML snippet from raw summary text for display on webpage." + ] + }, + "tags": [ + "formatting", + "web", + "documentation", + "summary", + "html", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"summaryText\":\"This document describes the API endpoints available for user authentication, including login, logout, and password reset.\",\"formatType\":\"html\",\"addBulletPoints\":true,\"maxLength\":200}", + "description": "Format a short technical summary into HTML with bullet points for web display." + }, + { + "inputJson": "{\"summaryText\":\"User management domain covers creating, updating, deleting user profiles, and assigning roles.\",\"formatType\":\"plain\",\"maxLength\":50}", + "description": "Generate a plain text format summary truncated to 50 characters." + }, + { + "inputJson": "{\"summaryText\":\"System overview includes performance metrics, uptime, and error rates.\",\"formatType\":\"html\",\"textColor\":\"#336699\"}", + "description": "Produce an HTML output with custom text color for visual emphasis." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Summary", + "context": null + } + }, + { + "name": "web-development.formatChangelog", + "description": "Formats a raw changelog text or structured changelog entries into a standardized, readable markdown changelog document. Accepts either plaintext logs or JSON arrays of changelog items, applies consistent formatting rules including version headings, dates, categories, and entries, and returns a clean markdown string suitable for project documentation or release notes.", + "category": "web-development", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "Raw plaintext changelog content to be formatted, optional if structuredEntries is provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "structuredEntries", + "type": "array", + "description": "Array of changelog entry objects with version, date, categories and changes to format. Overrides inputText if provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Format string for dates in versions (e.g., 'YYYY-MM-DD'), default is 'YYYY-MM-DD'.", + "required": false, + "defaultValue": "YYYY-MM-DD" + }, + { + "name": "includeUnreleasedSection", + "type": "boolean", + "description": "Whether to include an 'Unreleased' section if no version date is provided (default false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "categoryOrder", + "type": "array", + "description": "Ordered list of categories to list first; other categories come after alphabetically.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLineWidth", + "type": "number", + "description": "Maximum line width for wrapping text, 0 disables wrapping (default 80).", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted changelog content as a markdown string, ready to be saved or displayed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert raw or semi-structured changelog data into a professionally formatted markdown changelog document for display in repos, release notes, or documentation sites. Useful for standardizing changelogs from inconsistent inputs.", + "limitations": "Does not parse commit histories or generate changelog entries from version control systems. Does not validate semantic versioning correctness. Cannot fetch changelog data from external sources.", + "examples": [ + "Format raw plain text changelog into markdown", + "Format JSON changelog entries array with categories and dates", + "Reformat changelog wrapping lines to 100 characters width" + ] + }, + "tags": [ + "formatting", + "changelog", + "markdown", + "web-development", + "documentation", + "release-notes" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"Version 1.0.0\\n- Added feature A\\n- Fixed bug B\\n\\nVersion 1.1.0\\n- Improved performance\\n- Updated dependencies\"}", + "description": "Format a basic plain text changelog into markdown with default settings." + }, + { + "inputJson": "{\"structuredEntries\":[{\"version\":\"2.0.0\",\"date\":\"2024-05-20\",\"categories\":{\"Added\":[\"New UI theme\"],\"Fixed\":[\"Crash on logout\"]}},{\"version\":\"2.1.0\",\"date\":\"2024-06-05\",\"categories\":{\"Changed\":[\"Updated API endpoints\"]}}],\"dateFormat\":\"MMMM D, YYYY\",\"includeUnreleasedSection\":true,\"categoryOrder\":[\"Added\",\"Changed\",\"Fixed\"]}", + "description": "Format structured changelog entries with specific date format, category order and an unreleased section." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Changelog", + "context": null + } + }, + { + "name": "web-development.formatArticle", + "description": "Formats a raw article text input by applying typographic rules, structuring paragraphs, adding headings, and optionally converting markdown or HTML elements into clean HTML output. It accepts plain text or minimal markup articles and returns a structured HTML string suitable for publishing on websites.", + "category": "web-development", + "parameters": [ + { + "name": "articleText", + "type": "string", + "description": "The raw article content as a plain text or markdown-formatted string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Specifies the format of the input text, options include 'plain', 'markdown', or 'html'.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "convertHeadingsToHtml", + "type": "boolean", + "description": "If true and input is markdown or plain text, converts detected headings into corresponding HTML heading tags.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum number of characters per line before inserting a line break in the formatted output.", + "required": false, + "defaultValue": "80" + }, + { + "name": "removeExtraWhitespace", + "type": "boolean", + "description": "Whether to trim extra whitespace and normalize spacing between paragraphs and lines.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: 'html' or 'markdown'. Defaults to 'html'.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted article string in the requested output format, suitable for direct embedding or publishing on web pages." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw or loosely formatted article content into clean, web-ready format, applying consistent formatting rules, proper paragraph structure, heading tags, and typographic corrections. Ideal for processing articles from text sources before publishing on websites or CMS platforms.", + "limitations": "Does not perform content rewriting, language translation, or SEO optimization. It does not support complex HTML or embedded multimedia elements beyond basic formatting. It assumes the input is primarily text with light markup.", + "examples": [ + "Format a raw plain text article into properly structured HTML for website publication.", + "Convert markdown article content into clean HTML with headings and paragraphs.", + "Clean up article text by normalizing whitespace and limiting line length for better readability." + ] + }, + "tags": [ + "web", + "formatting", + "article", + "html", + "markdown", + "typography", + "content-management" + ], + "examples": [ + { + "inputJson": "{\"articleText\":\"# Introduction\\nThis is a sample article. It needs formatting.\",\"inputFormat\":\"markdown\",\"convertHeadingsToHtml\":true,\"outputFormat\":\"html\"}", + "description": "Convert markdown article text with headings to formatted HTML." + }, + { + "inputJson": "{\"articleText\":\"This is an unformatted plain text article. It lacks paragraphs and headings.\",\"inputFormat\":\"plain\",\"removeExtraWhitespace\":true,\"maxLineLength\":100,\"outputFormat\":\"html\"}", + "description": "Format plain text article by normalizing whitespace and splitting into paragraphs, output HTML." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Article", + "context": null + } + }, + { + "name": "web-development.formatResume", + "description": "Formats raw resume data into a professionally styled, customizable document in PDF or HTML format. Accepts structured JSON input detailing personal info, experience, education, skills, and optional design preferences. Outputs a polished resume file suitable for job applications or online profiles.", + "category": "web-development", + "parameters": [ + { + "name": "resumeData", + "type": "object", + "description": "Structured JSON object containing resume sections such as personal info, work experience, education, skills, and optionally projects or certifications.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the resume document, e.g., 'pdf' or 'html'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "templateName", + "type": "string", + "description": "Name of the resume template style to apply for formatting, such as 'modern', 'classic', or 'minimalist'.", + "required": false, + "defaultValue": "modern" + }, + { + "name": "includePhoto", + "type": "boolean", + "description": "Whether to include a professional photo in the formatted resume if available in resumeData.", + "required": false, + "defaultValue": "false" + }, + { + "name": "fontFamily", + "type": "string", + "description": "Preferred font family for the resume text, overriding template defaults if supplied.", + "required": false, + "defaultValue": "" + }, + { + "name": "primaryColor", + "type": "string", + "description": "Hex color code to customize primary highlight color in the resume template.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a base64 encoded string of the formatted resume document, content type (e.g., 'application/pdf'), and an optional preview URL if hosted." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw resume details in JSON format and need to generate a professional, visually appealing resume document in PDF or HTML for job applications, portfolio websites, or email submissions. It helps automate consistent formatting and styling from structured data inputs.", + "limitations": "Cannot generate resume data itself; requires structured resume input. Limited to predefined templates and customization options. Does not perform content validation, proofreading, or advanced graphic design.", + "examples": [ + "Format a JSON resume into a clean PDF resume with the 'modern' template.", + "Generate an HTML resume from input data with customized colors and fonts for an online portfolio.", + "Produce a minimalist PDF resume including the candidate's photo if provided." + ] + }, + "tags": [ + "resume", + "formatting", + "pdf", + "html", + "web-development", + "document-generation", + "career" + ], + "examples": [ + { + "inputJson": "{\"resumeData\":{\"personalInfo\":{\"name\":\"Alice Johnson\",\"email\":\"alice@example.com\",\"phone\":\"555-1234\",\"location\":\"Austin, TX\"},\"workExperience\":[{\"company\":\"Tech Innovations\",\"role\":\"Software Developer\",\"startDate\":\"2019-06\",\"endDate\":\"2023-04\",\"description\":\"Developed scalable web apps.\"}],\"education\":[{\"degree\":\"BSc Computer Science\",\"school\":\"State University\",\"year\":\"2019\"}],\"skills\":[\"JavaScript\",\"React\",\"Node.js\"]},\"outputFormat\":\"pdf\",\"templateName\":\"modern\",\"includePhoto\":false}", + "description": "Generate a PDF resume for Alice Johnson using the modern template without a photo." + }, + { + "inputJson": "{\"resumeData\":{\"personalInfo\":{\"name\":\"Bob Lee\",\"email\":\"bob@example.com\",\"phone\":\"555-5678\",\"location\":\"Seattle, WA\",\"photoUrl\":\"https://example.com/photos/bob.jpg\"},\"workExperience\":[{\"company\":\"Creative Agency\",\"role\":\"UX Designer\",\"startDate\":\"2017-01\",\"endDate\":\"2022-12\",\"description\":\"Designed user-centric interfaces.\"}],\"education\":[{\"degree\":\"BA Graphic Design\",\"school\":\"Art School\",\"year\":\"2016\"}],\"skills\":[\"Adobe XD\",\"Sketch\",\"Figma\"]},\"outputFormat\":\"html\",\"templateName\":\"minimalist\",\"includePhoto\":true,\"primaryColor\":\"#336699\",\"fontFamily\":\"Arial\"}", + "description": "Create an HTML minimalist resume for Bob Lee including his photo and customized colors and font." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Resume", + "context": null + } + }, + { + "name": "web-development.formatReleaseNotes", + "description": "Formats raw release notes text into a clean, readable, and professional document. Accepts raw release notes content with optional metadata, processes formatting including headings, bullet points, dates, versioning, and outputs a structured markdown or HTML document suitable for publication.", + "category": "web-development", + "parameters": [ + { + "name": "rawContent", + "type": "string", + "description": "Raw release notes text or markdown to format", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "Version number of the release, to include as a heading or label", + "required": false, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "Release date in ISO format to display prominently in the notes", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: 'markdown' or 'html'", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to generate and include a summary or highlights section at the top", + "required": false, + "defaultValue": "true" + }, + { + "name": "highlightKeywords", + "type": "array", + "description": "List of keywords to emphasize or highlight within the notes", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted release notes as a string in the specified format and metadata fields" + }, + "aiAgent": { + "useCase": "Use this tool when presenting raw or loosely structured release notes that need consistent professional formatting for public documentation, changelogs, or web pages. It's ideal for transforming draft notes into reader-friendly markdown or HTML formats with proper headings, bullets, and version/date highlights.", + "limitations": "Cannot generate content or verify the accuracy of release notes; does not translate or localize notes; limited to formatting existing text as provided.", + "examples": [ + "Format raw markdown notes into an HTML changelog for a new software version.", + "Add a release date and version heading when formatting notes to markdown.", + "Emphasize bug fix keywords in release notes by highlighting them in the output." + ] + }, + "tags": [ + "formatting", + "release notes", + "documentation", + "web-development", + "markdown", + "html" + ], + "examples": [ + { + "inputJson": "{\"rawContent\":\"## Bug Fixes\\n- Fixed login issue\\n- Resolved crash on startup\\n\\n## Features\\n- Added user profile page\",\"version\":\"2.1.0\",\"releaseDate\":\"2024-06-15\",\"outputFormat\":\"markdown\",\"includeSummary\":true,\"highlightKeywords\":[\"Fixed\",\"Resolved\"]}", + "description": "Formatting raw release notes with headings and highlights into markdown with version and date." + }, + { + "inputJson": "{\"rawContent\":\"- Fixed security vulnerabilities\\n- Improved performance\",\"version\":\"1.5.3\",\"releaseDate\":\"2024-05-01\",\"outputFormat\":\"html\",\"includeSummary\":false,\"highlightKeywords\":[\"Fixed\"]}", + "description": "Format brief release notes into HTML without summary, emphasizing fix keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "web-development.formatEmail", + "description": "This tool accepts raw email content and optional metadata, then formats the email into a professional and consistent HTML and plain text structure suitable for sending. It processes input such as subject, body text, sender info, and recipient details to produce well-structured email outputs with proper styling and encoding.", + "category": "web-development", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "The main plain text content of the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "Optional HTML content for the email body. If provided, used instead of plain text formatting.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderName", + "type": "string", + "description": "The name of the sender to display in the email header.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "senderEmail", + "type": "string", + "description": "The email address of the sender to include in the email header.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "recipientName", + "type": "string", + "description": "Name of the recipient for personalized greeting, if needed.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Flag to include a default signature block at the end of the email.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'fr') for localization of formatting rules and date/time if used.", + "required": false, + "defaultValue": "\"en\"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing 'htmlEmail' with fully formatted HTML email content, and 'plainTextEmail' with cleaned and formatted plain text version ready for sending." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to prepare clean, professional emails from raw content or templates, ensuring consistent formatting for both HTML-capable and plain-text-only email clients. It is useful for automating email generation, confirmation messages, newsletters, or transactional emails requiring polish and correctness.", + "limitations": "This tool does not handle sending emails or manage email headers beyond formatting sender and recipient info. It does not perform advanced personalization beyond basic name insertion or content personalization.", + "examples": [ + "Format an email by providing subject, plain text, optional HTML body, and sender/recipient information to generate ready-to-send email content.", + "Generate both HTML and plain text versions of a marketing email including a signature and localized formatting.", + "Prepare a transactional email message with consistent styling and optional personalized greeting based on recipient name." + ] + }, + "tags": [ + "email", + "formatting", + "html", + "plain text", + "communication", + "web-development", + "automation" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Welcome to Our Service\",\"bodyText\":\"Hello John,\\nThank you for joining us!\",\"bodyHtml\":\"Item: {{item}}
\\nHello John,
Thank you for joining us!
\",\"senderName\":\"Support Team\",\"senderEmail\":\"support@example.com\",\"recipientName\":\"John\",\"includeSignature\":true,\"language\":\"en\"}", + "description": "Format a welcome email with both HTML and plain text versions including a signature and personalized recipient name." + }, + { + "inputJson": "{\"subject\":\"Your Invoice\",\"bodyText\":\"Dear Customer,\\nPlease find your invoice attached.\",\"senderEmail\":\"billing@example.com\",\"includeSignature\":false}", + "description": "Generate a plain text invoice notification email without HTML or signature." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Email", + "context": null + } + }, + { + "name": "web-development.formatInvoice", + "description": "Formats raw invoice data provided as an object or JSON string into a professionally styled HTML invoice document. It accepts invoice details including supplier info, client info, line items, taxes, discounts, and totals, then generates a clean, print-ready HTML string with consistent styling suitable for embedding on web pages or emailing.", + "category": "web-development", + "parameters": [ + { + "name": "invoiceData", + "type": "object", + "description": "The invoice data object containing all necessary fields such as supplier, client, items, taxes, discounts, and totals.", + "required": true, + "defaultValue": "" + }, + { + "name": "currencySymbol", + "type": "string", + "description": "Currency symbol to display for monetary values, e.g., '$', '€', '£'.", + "required": false, + "defaultValue": "\"$\"" + }, + { + "name": "locale", + "type": "string", + "description": "Locale string (e.g., 'en-US', 'de-DE') to format dates and numbers appropriately.", + "required": false, + "defaultValue": "\"en-US\"" + }, + { + "name": "includeLogoUrl", + "type": "string", + "description": "URL of the company logo to include in the invoice header. If empty, no logo will be shown.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "showTaxBreakdown", + "type": "boolean", + "description": "Whether to display a detailed tax breakdown section on the invoice.", + "required": false, + "defaultValue": "true" + }, + { + "name": "themeColor", + "type": "string", + "description": "Primary hex color code for styling the invoice highlights and headers (e.g., '#4A90E2').", + "required": false, + "defaultValue": "\"#333333\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single string property 'html' with complete formatted invoice HTML content ready for display or emailing." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw invoice data and need to generate a visually presentable, professional invoice document in HTML format for web display or email embedding. It helps ensure consistent styling and formatting of invoices generated dynamically by applications or chatbots.", + "limitations": "This tool does not generate PDF files directly, nor does it send the invoice via email. It also does not validate invoice data semantics like tax rates or client legality; it expects valid input format.", + "examples": [ + "Format provided invoice JSON data into a clean HTML invoice for embedding on a client portal.", + "Generate an email-ready HTML snippet from raw invoice details with company logo and localized currency formatting.", + "Create a printable invoice HTML with a tax breakdown and custom theme color from structured invoice input." + ] + }, + "tags": [ + "invoice", + "formatting", + "web-development", + "html", + "document-generation", + "financial", + "billing" + ], + "examples": [ + { + "inputJson": "{\"invoiceData\":{\"supplier\":{\"name\":\"TechCorp LLC\",\"address\":\"123 Tech Lane, Silicon Valley, CA\"},\"client\":{\"name\":\"Innovate Solutions\",\"address\":\"456 Innovation Drive, New York, NY\"},\"invoiceNumber\":\"INV-2024-0056\",\"date\":\"2024-06-15\",\"dueDate\":\"2024-07-15\",\"items\":[{\"description\":\"Software License\",\"quantity\":10,\"unitPrice\":99.99},{\"description\":\"Support Plan - 12 months\",\"quantity\":1,\"unitPrice\":249.00}],\"taxRate\":0.08,\"discount\":50,\"notes\":\"Thank you for your business!\"},\"currencySymbol\":\"$\",\"locale\":\"en-US\",\"includeLogoUrl\":\"https://example.com/logo.png\",\"showTaxBreakdown\":true,\"themeColor\":\"#0A74DA\"}", + "description": "Formatting a detailed invoice with supplier and client info, multiple line items, tax, discount, and a logo into styled HTML." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Invoice", + "context": null + } + }, + { + "name": "web-development.composeReference", + "description": "Generates a structured website reference section by composing formatted citations from provided source details. Accepts an array of reference objects with fields such as author, title, publication, url, and date. Outputs a formatted, standardized reference list as an HTML string suitable for embedding in web pages.", + "category": "web-development", + "parameters": [ + { + "name": "references", + "type": "array", + "description": "An array of reference objects each containing citation details like author, title, publication, url, and date.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The citation style to format references, e.g., APA, MLA, Chicago. Defaults to APA.", + "required": false, + "defaultValue": "APA" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format of the composed reference list, either 'html' or 'markdown'. Defaults to 'html'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeLinks", + "type": "boolean", + "description": "Whether to include clickable URLs in the references if available. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object with a single property 'formattedReferences', a string containing the formatted references list in the specified output format." + }, + "aiAgent": { + "useCase": "Use this tool when generating a website or document content that requires a clear, standardized bibliography or sources section. It helps synthesize raw reference data into well-formatted reference lists suitable for web pages, enhancing source credibility and user experience.", + "limitations": "Cannot verify accuracy or completeness of references. Limited to formatting given data; does not fetch or validate source metadata. Style support limited to common academic styles and may not reflect every nuance of each style guide's latest version.", + "examples": [ + "Compose a reference section in APA style from a list of academic papers.", + "Format website sources as MLA references with clickable links in HTML.", + "Generate a bibliography in Chicago style for embedding in markdown documentation." + ] + }, + "tags": [ + "web-development", + "content-generation", + "references", + "citation-formatting", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"references\":[{\"author\":\"Smith, John\",\"title\":\"Understanding Web APIs\",\"publication\":\"Tech Journal\",\"date\":\"2021\",\"url\":\"https://techjournal.com/web-apis\"},{\"author\":\"Doe, Jane\",\"title\":\"Modern HTML Techniques\",\"publication\":\"Web Monthly\",\"date\":\"2022\"}],\"style\":\"APA\",\"outputFormat\":\"html\",\"includeLinks\":true}", + "description": "Compose an APA-style reference list in HTML including clickable links when URLs are present." + }, + { + "inputJson": "{\"references\":[{\"author\":\"Nguyen, Alex\",\"title\":\"CSS Grid Layout\",\"publication\":\"Design Weekly\",\"date\":\"2020\",\"url\":\"https://designweekly.com/css-grid\"}],\"style\":\"MLA\",\"outputFormat\":\"markdown\",\"includeLinks\":false}", + "description": "Create an MLA-formatted bibliography in markdown format without clickable links." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reference", + "context": null + } + }, + { + "name": "web-development.formatContract", + "description": "Formats a legal or business contract document provided as text or structured JSON, applying consistent styling, organization, and numbering to all sections, clauses, and definitions. Returns a cleanly formatted contract in plain text or HTML format ready for review or presentation.", + "category": "web-development", + "parameters": [ + { + "name": "contractContent", + "type": "string", + "description": "The raw contract text or JSON string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the contractContent input; either 'text' for plain contract text or 'json' for structured contract object.", + "required": true, + "defaultValue": "text" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the formatted contract, e.g., 'text' or 'html'.", + "required": false, + "defaultValue": "text" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and insert a table of contents based on contract sections.", + "required": false, + "defaultValue": "false" + }, + { + "name": "sectionNumberingStyle", + "type": "string", + "description": "Style of section numbering (e.g., 'numeric', 'roman', 'alpha').", + "required": false, + "defaultValue": "numeric" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for indenting subsections and clauses.", + "required": false, + "defaultValue": "4" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted contract as a string in the requested output format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to format a contract document received as raw text or structured JSON into a clear, consistent, and professional style for presentation or legal review. It helps organize contract sections with appropriate numbering, indentation, and optional table of contents. It is useful for contract drafting assistants or document preparation tools.", + "limitations": "This tool does not perform legal validation or content correctness checks. It only formats the contract structurally and visually. Complex semantic restructuring or content interpretation is outside its scope.", + "examples": [ + "Format a plain text contract with default numeric section numbering and output as HTML.", + "Format a contract provided as a JSON object with custom indentation and include a table of contents.", + "Convert raw contract text to a neatly formatted plain text version with Roman numeral section numbering." + ] + }, + "tags": [ + "formatting", + "contract", + "legal-documents", + "web-development", + "document-structure", + "html", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"contractContent\":\"Section 1: Introduction\\nThis contract is between...\\nSection 2: Terms\\nThe terms are...\",\"inputFormat\":\"text\",\"outputFormat\":\"text\",\"includeTableOfContents\":false}", + "description": "Format a plain text contract with default settings producing plain text output." + }, + { + "inputJson": "{\"contractContent\":\"{\\\"sections\\\":[{\\\"title\\\":\\\"Introduction\\\",\\\"text\\\":\\\"This agreement...\\\"},{\\\"title\\\":\\\"Payment Terms\\\",\\\"text\\\":\\\"Payment must be made...\\\"}]}\",\"inputFormat\":\"json\",\"outputFormat\":\"html\",\"includeTableOfContents\":true,\"sectionNumberingStyle\":\"roman\",\"indentationSpaces\":2}", + "description": "Format a contract in JSON format into HTML with Roman numeral numbering, a table of contents, and 2 spaces indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Contract", + "context": null + } + }, + { + "name": "web-development.formatProposal", + "description": "Formats a web development proposal document to ensure consistent style, structure, and readability. Accepts unformatted or semi-structured proposal text or JSON containing proposal sections, applies formatting rules like headings, bullet points, and styling, and outputs a clean, well-organized proposal in markdown or HTML format.", + "category": "web-development", + "parameters": [ + { + "name": "proposalContent", + "type": "string", + "description": "Raw proposal text or JSON string containing proposal sections to be formatted. Can include project description, deliverables, timeline, and budget.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the input proposal content. Supported values are 'text' for raw text or 'json' for structured JSON input.", + "required": false, + "defaultValue": "\"text\"" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the formatted proposal, such as 'markdown' or 'html'.", + "required": false, + "defaultValue": "\"markdown\"" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to automatically generate and include a table of contents based on proposal sections.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum number of characters per line to wrap text for readability (applicable primarily for text-based outputs).", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted proposal content string in the specified output format and metadata about the formatting process. Example fields: formattedContent (string), contentFormat (string)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to standardize the formatting of web development project proposals for clear presentation and consistent styling across mixed or raw input content. Helpful when integrating various proposal inputs into client-ready documents.", + "limitations": "Does not perform content validation, grammar correction, or proposal content generation. It only reformats existing content; complex layout designs beyond markdown or basic HTML are not supported.", + "examples": [ + "Format raw text proposal into markdown with table of contents.", + "Convert JSON structured proposal into clean HTML presentation format.", + "Wrap long lines in input text proposal to improve readability." + ] + }, + "tags": [ + "web", + "formatting", + "proposal", + "document", + "markdown", + "html", + "presentation", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"proposalContent\":\"Project: Website Redesign\\nObjectives:\\n- Modernize UI\\n- Improve SEO\\nDeliverables:\\n1. Design mockups\\n2. Responsive implementation\\nTimeline:\\n6 weeks\",\"inputFormat\":\"text\",\"outputFormat\":\"markdown\",\"includeTableOfContents\":true,\"maxLineLength\":80}", + "description": "Format a plain text web development proposal into markdown format including a table of contents for improved readability." + }, + { + "inputJson": "{\"proposalContent\":\"{\\\"title\\\":\\\"Website Redesign\\\",\\\"sections\\\":[{\\\"header\\\":\\\"Objectives\\\",\\\"content\\\":\\\"Modernize UI and improve SEO\\\"},{\\\"header\\\":\\\"Deliverables\\\",\\\"content\\\":\\\"Design mockups, responsive implementation\\\"},{\\\"header\\\":\\\"Timeline\\\",\\\"content\\\":\\\"6 weeks\\\"}]}\" ,\"inputFormat\":\"json\",\"outputFormat\":\"html\",\"includeTableOfContents\":false,\"maxLineLength\":80}", + "description": "Format a structured JSON proposal into a clean, styled HTML document without a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Proposal", + "context": null + } + }, + { + "name": "web-development.composeCitation", + "description": "This tool accepts bibliographic information as input and composes a properly formatted citation string according to a specified citation style (e.g., APA, MLA, Chicago). It processes the provided metadata such as author, title, publication year, and source, and outputs a formatted citation suitable for web content or academic references.", + "category": "web-development", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "A list of author names in 'Last, First' format; at least one author required.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "The title of the work to cite.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "The year the work was published.", + "required": false, + "defaultValue": "" + }, + { + "name": "source", + "type": "string", + "description": "The source or publisher of the work (journal name, book publisher, website, etc.).", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The citation style to format the citation (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + }, + { + "name": "edition", + "type": "string", + "description": "Edition information if applicable (e.g., '2nd edition').", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL if the source is an online resource.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the online resource was accessed, in YYYY-MM-DD format.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single string property 'formattedCitation' which holds the citation string formatted according to the specified style." + }, + "aiAgent": { + "useCase": "Use this tool when generating citations dynamically for web pages, academic writing, or documentation where proper referencing is needed in a specified style using provided bibliographic metadata.", + "limitations": "This tool cannot verify the accuracy of bibliographic data provided or handle every edge case of citation style variations or extremely unusual sources. It assumes input data is accurate and complete for formatting.", + "examples": [ + "Compose an APA citation for a journal article authored by 'Smith, John' and 'Doe, Jane' titled 'The Future of AI' published in 2020 in the 'Journal of AI Research'.", + "Generate an MLA citation for a book authored by 'Brown, Lisa' titled 'Web Development Essentials' published by 'Tech Publishers' in 2018.", + "Create a Chicago style citation for an online resource with a given url and accessed date." + ] + }, + "tags": [ + "citation", + "formatting", + "bibliography", + "reference", + "web-content", + "academic-writing" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"The Future of AI\",\"publicationYear\":2020,\"source\":\"Journal of AI Research\",\"citationStyle\":\"APA\"}", + "description": "APA style journal article citation with two authors and publication year." + }, + { + "inputJson": "{\"authors\":[\"Brown, Lisa\"],\"title\":\"Web Development Essentials\",\"publicationYear\":2018,\"source\":\"Tech Publishers\",\"citationStyle\":\"MLA\",\"edition\":\"2nd edition\"}", + "description": "MLA style book citation including edition." + }, + { + "inputJson": "{\"authors\":[\"Johnson, Mark\"],\"title\":\"An Introduction to Quantum Computing\",\"citationStyle\":\"Chicago\",\"url\":\"https://example.com/quantum\",\"accessDate\":\"2023-11-01\"}", + "description": "Chicago style citation for an online resource with access date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Citation", + "context": null + } + }, + { + "name": "web-development.composeWord", + "description": "This tool composes a word by combining specified prefixes, root words, and suffixes with optional hyphenation and case formatting. It accepts input components and options, processes them to form a single syntactically correct word string suitable for web content or UI elements, and outputs the composed word as a string.", + "category": "web-development", + "parameters": [ + { + "name": "prefix", + "type": "string", + "description": "Optional prefix to prepend to the root word (e.g., 'un')", + "required": false, + "defaultValue": "" + }, + { + "name": "rootWord", + "type": "string", + "description": "The root word to form the base of the composed word (e.g., 'happy')", + "required": true, + "defaultValue": "" + }, + { + "name": "suffix", + "type": "string", + "description": "Optional suffix to append to the root word (e.g., 'ness')", + "required": false, + "defaultValue": "" + }, + { + "name": "useHyphen", + "type": "boolean", + "description": "Whether to insert hyphens between prefix, root, and suffix if multiple parts are present", + "required": false, + "defaultValue": "false" + }, + { + "name": "caseFormat", + "type": "string", + "description": "Format casing of the output word: 'lower', 'upper', 'camel' or 'pascal'", + "required": false, + "defaultValue": "lower" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed word as a string with the key 'composedWord'" + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate or compose custom words for web UI elements, variable names, or content that requires specific prefix and suffix combinations, formatted with particular casing or hyphenation. It assists in creating consistent, readable word forms dynamically.", + "limitations": "This tool cannot validate semantics or meaning of composed words; it strictly concatenates based on input parameters. It does not perform dictionary lookups or ensure word correctness beyond formatting.", + "examples": [ + "Compose the word with prefix 'pre', root word 'view', suffix 'ed', hyphenated and in camel case.", + "Create a simple word 'happy' in uppercase without prefix or suffix.", + "Generate a word combining root 'connect' and suffix 'ion' with pascal case and no hyphens." + ] + }, + "tags": [ + "composition", + "word", + "string-manipulation", + "web-development", + "formatting", + "prefix-suffix", + "hyphenation" + ], + "examples": [ + { + "inputJson": "{\"prefix\":\"pre\",\"rootWord\":\"view\",\"suffix\":\"ed\",\"useHyphen\":true,\"caseFormat\":\"camel\"}", + "description": "Compose 'pre-view-ed' formatted in camel case resulting in 'preViewEd' with hyphens disregarded in output but indicating segmentation." + }, + { + "inputJson": "{\"rootWord\":\"happy\",\"caseFormat\":\"upper\"}", + "description": "Compose single root word 'happy' converted fully to uppercase 'HAPPY' with no prefix or suffix." + }, + { + "inputJson": "{\"rootWord\":\"connect\",\"suffix\":\"ion\",\"caseFormat\":\"pascal\",\"useHyphen\":false}", + "description": "Compose word 'connection' formatted in PascalCase: 'Connection', no hyphens." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Word", + "context": null + } + }, + { + "name": "web-development.formatDocument", + "description": "This tool accepts a raw HTML or XML document string and formats it by applying proper indentation and consistent spacing to improve readability and maintainability. It supports customizable indentation size and style (spaces or tabs) and outputs the formatted document as a string compatible with web standards.", + "category": "web-development", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "The raw HTML or XML document content to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces or tabs to use per indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveNewlines", + "type": "boolean", + "description": "Whether to preserve existing blank lines between elements in the output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length before line breaking is applied. Use 0 to disable.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "string", + "description": "The formatted HTML or XML document content as a string with consistent indentation and spacing." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to clean up or prettify raw or minified HTML or XML documents to improve readability for developers, code reviews, or automated processing. It is useful when generating or refactoring web content to ensure consistent style and maintainability.", + "limitations": "This tool does not validate if the input document is well-formed or semantically correct; malformed documents may lead to incorrect formatting or errors. It also does not modify content beyond spacing and indentation (no code transformations or linting).", + "examples": [ + "Format a raw, minified HTML document string to be more readable with 4 spaces indentation.", + "Convert an XML fragment with inconsistent spacing into a cleanly indented format using tabs.", + "Format an HTML snippet preserving blank lines but soft-wrap long lines beyond 100 characters." + ] + }, + "tags": [ + "web", + "html", + "xml", + "formatting", + "prettify", + "code-style", + "indentation" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"\",\"indentationSize\":2,\"useTabs\":false,\"preserveNewlines\":true,\"maxLineLength\":80}", + "description": "Format a simple HTML snippet with 2 spaces indentation, preserve blank lines, and default line length." + }, + { + "inputJson": "{\"documentContent\":\"Hello
\",\"indentationSize\":1,\"useTabs\":true,\"preserveNewlines\":false,\"maxLineLength\":0}", + "description": "Format an XML document using tabs with indentation size 1 and no maximum line length constraint or blank line preservation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Document", + "context": null + } + }, + { + "name": "web-development.formatReport", + "description": "Formats a report document based on a provided template, content sections, and styling preferences. Accepts a JSON object representing the report structure and formatting options, then outputs a well-structured HTML or PDF formatted report string ready for display or download.", + "category": "web-development", + "parameters": [ + { + "name": "reportData", + "type": "object", + "description": "An object representing the content and structure of the report, including title, sections, and data fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "templateStyle", + "type": "string", + "description": "A string indicating the preset formatting style/template to apply, e.g., 'professional', 'modern', or custom CSS class names.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output report, either 'html' or 'pdf'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents based on report sections.", + "required": false, + "defaultValue": "true" + }, + { + "name": "fontFamily", + "type": "string", + "description": "Font family to use for the report text, e.g., 'Arial', 'Times New Roman'.", + "required": false, + "defaultValue": "\"Arial, sans-serif\"" + }, + { + "name": "fontSize", + "type": "number", + "description": "Base font size in pixels for the report text.", + "required": false, + "defaultValue": "14" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted report as a string and metadata about the report." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a visually consistent, formatted report document from raw content data and style preferences, suitable for web display or offline distribution as PDF. Ideal for automated report generation workflows in web apps or dashboards.", + "limitations": "This tool does not perform content validation or data aggregation; it only formats provided data into a report structure. The PDF generation depends on environment support for API or library capable of HTML to PDF conversion.", + "examples": [ + "Format a quarterly sales report JSON data into a professional styled HTML report with a table of contents", + "Generate a PDF report from technical project data using a modern template style", + "Produce a report with customized font and size for better readability" + ] + }, + "tags": [ + "web", + "document", + "report", + "formatting", + "html", + "pdf", + "templating" + ], + "examples": [ + { + "inputJson": "{\"reportData\":{\"title\":\"Quarterly Sales Report\",\"author\":\"Jane Doe\",\"date\":\"2024-06-01\",\"sections\":[{\"heading\":\"Executive Summary\",\"content\":\"Sales increased by 12% from last quarter.\"},{\"heading\":\"Regional Breakdown\",\"content\":\"North America led growth with 15% increase.\"}]},\"templateStyle\":\"professional\",\"outputFormat\":\"html\",\"includeTableOfContents\":true,\"fontFamily\":\"'Helvetica, sans-serif'\",\"fontSize\":16}", + "description": "Format given quarterly sales data into an HTML report with professional style, including TOC, using Helvetica font at size 16." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Report", + "context": null + } + }, + { + "name": "web-development.composeQuote", + "description": "Generates a styled and formatted quote block for web pages, accepting input text, author name, and optional styling options. Produces an HTML snippet with semantic tags and inline styles or CSS classes suitable for direct embedding into website content.", + "category": "web-development", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The text content of the quote to be displayed.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the author or source of the quote, displayed with the quote.", + "required": false, + "defaultValue": "" + }, + { + "name": "citation", + "type": "string", + "description": "Optional citation or reference for the quote, such as a book or speech title.", + "required": false, + "defaultValue": "" + }, + { + "name": "style", + "type": "object", + "description": "Optional styling options for the quote block such as font style, color, and alignment.", + "required": false, + "defaultValue": "" + }, + { + "name": "useBlockquoteTag", + "type": "boolean", + "description": "Whether to wrap the quote in a blockquote HTML tag for semantic markup.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Contains the generated HTML string representing the composed quote, ready for embedding in web content." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate a web-ready quote snippet from plain text input with optional author and citation, applying consistent styling and semantic HTML structure. Ideal for websites presenting quotations attractively without manual HTML coding.", + "limitations": "The tool does not handle multi-language text formatting beyond basic UTF-8, and it does not sanitize HTML input from users—security measures must be applied externally.", + "examples": [ + "Create a quote block with the quote text, author, and italic styling.", + "Generate a quote without author but with a citation and right text alignment.", + "Produce a plain quote wrapped in blockquote tag with default styling." + ] + }, + "tags": [ + "web-development", + "content-generation", + "html", + "quotes", + "styling" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"The only limit to our realization of tomorrow is our doubts of today.\",\"authorName\":\"Franklin D. Roosevelt\",\"style\":{\"fontStyle\":\"italic\",\"color\":\"#555555\",\"textAlign\":\"center\"},\"useBlockquoteTag\":true}", + "description": "Quote with author, italic style, centered text wrapped in blockquote." + }, + { + "inputJson": "{\"quoteText\":\"Simplicity is the ultimate sophistication.\",\"citation\":\"Leonardo da Vinci Collection\",\"useBlockquoteTag\":false}", + "description": "Quote with citation only, no blockquote wrapper." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Quote", + "context": null + } + }, + { + "name": "web-development.composeLink", + "description": "Creates an HTML link element ( tag) based on provided URL and display options. Accepts a target URL, optional link text, and attributes like CSS classes, id, title, target, and rel. Outputs a complete HTML anchor tag string ready for embedding in web pages.", + "category": "web-development", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The target URL to which the link will point.", + "required": true, + "defaultValue": "" + }, + { + "name": "text", + "type": "string", + "description": "The visible text for the link. Defaults to the URL if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "List of CSS class names to add to the anchor tag for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "id", + "type": "string", + "description": "Optional id attribute for the anchor element.", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title attribute to show on hover for the link.", + "required": false, + "defaultValue": "" + }, + { + "name": "target", + "type": "string", + "description": "Specifies where to open the linked document (e.g., '_blank', '_self'). Defaults to '_self'.", + "required": false, + "defaultValue": "_self" + }, + { + "name": "rel", + "type": "string", + "description": "Relationship attribute for the link (e.g., 'noopener noreferrer') for security/privacy.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the 'html' property with the fully composed anchor tag string." + }, + "aiAgent": { + "useCase": "Use this tool when generating dynamic web content that requires safe, customizable HTML links. It helps form standardized anchor tags from minimal input without manually constructing HTML, ideal for templating engines, CMS content, or automation agents building webpages.", + "limitations": "Does not validate URLs or sanitize inputs for security beyond attribute assignment. It does not render or check link functionality or accessibility compliance.", + "examples": [ + "Create a link to https://example.com with text 'Visit Example' opening in a new tab.", + "Generate a styled link with classes 'btn btn-primary' and title 'Home page' linking to '/'", + "Compose a simple link using only the provided URL where link text defaults to URL." + ] + }, + "tags": [ + "web", + "html", + "link", + "anchor", + "compose", + "web-development", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"text\":\"Visit Example\",\"cssClasses\":[\"btn\",\"btn-primary\"],\"id\":\"exampleLink\",\"title\":\"Go to Example\",\"target\":\"_blank\",\"rel\":\"noopener noreferrer\"}", + "description": "Creates a styled link to example.com opening in a new tab with security rel attributes." + }, + { + "inputJson": "{\"url\":\"/home\",\"text\":\"Home\",\"cssClasses\":[],\"id\":\"\",\"title\":\"Home page\",\"target\":\"_self\",\"rel\":\"\"}", + "description": "Creates a simple internal link to the home page with a title attribute." + }, + { + "inputJson": "{\"url\":\"https://openai.com\",\"text\":\"\",\"cssClasses\":[],\"id\":\"openaiLink\",\"title\":\"\",\"target\":\"_self\",\"rel\":\"\"}", + "description": "Creates a link where text defaults to the URL since no text was provided." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Link", + "context": null + } + }, + { + "name": "web-development.composeHeading", + "description": "Generates an HTML heading element as a string based on provided text content, heading level (1-6), optional CSS class names, and optional inline styles. Useful for dynamically composing semantic and styled headings for web pages.", + "category": "web-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The textual content to be placed inside the heading element.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "The level of heading (1 to 6) indicating - Value
- Another
to
. Defaults to 1.", + "required": false, + "defaultValue": "1" + }, + { + "name": "classNames", + "type": "array", + "description": "Optional list of CSS class names to add to the heading element.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "inlineStyles", + "type": "object", + "description": "Optional object of CSS style properties and values to include as inline styles.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "string", + "description": "An HTML string representing the composed heading element with attributes and content." + }, + "aiAgent": { + "useCase": "This tool is suited for AI agents that need to generate semantic HTML headings tailored with specific styles or classes. For example, when dynamically building a webpage heading based on user input or content, an agent can invoke this tool to produce the properly formatted heading tag, ensuring correct level usage and optional styling.", + "limitations": "This tool only composes the heading as an HTML string and does not insert it into a DOM or handle complex HTML escaping beyond basic text. It also does not validate CSS properties or sanitize inputs aggressively.", + "examples": [ + "Create an
heading with the text 'Welcome to the Site' and class 'main-title'", + "Generate a simple
heading with the text 'Home' with no additional styles", + "Make an
heading that includes inline styles for font color red and bold text" + ] + }, + "tags": [ + "html", + "heading", + "web-development", + "content-generation", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Welcome to Our Website\",\"level\":2,\"classNames\":[\"hero-title\",\"bold\"],\"inlineStyles\":{\"color\":\"#333\",\"fontWeight\":\"700\"}}", + "description": "Generating an
heading with multiple CSS classes and inline styles." + }, + { + "inputJson": "{\"text\":\"About Us\",\"level\":1}", + "description": "Simple
heading with default styling." + }, + { + "inputJson": "{\"text\":\"Features\",\"level\":3,\"inlineStyles\":{\"color\":\"blue\",\"textDecoration\":\"underline\"}}", + "description": "An
heading with blue and underlined text via inline styles." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Heading", + "context": null + } + }, + { + "name": "web-development.composeSentence", + "description": "Generates a coherent sentence suitable for web content composition based on specified keywords, tone, and style. The tool accepts an array of keywords, desired tone, and style parameters, then produces a clear, contextually relevant sentence for use in website text or UI elements.", + "category": "web-development", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases to include or focus on in the sentence composition.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "The tone of the sentence, e.g., formal, casual, friendly, professional.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "style", + "type": "string", + "description": "Writing style for the sentence, such as informative, promotional, descriptive.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated sentence in characters.", + "required": false, + "defaultValue": "120" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed sentence as a single string property named 'sentence'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically generate a concise, context-aware sentence for website copy, UI text, or content snippets based on given keywords and style preferences. It assists in composing varied sentence structures aligned with the desired tone and purpose.", + "limitations": "It cannot generate long paragraphs or multiple sentences at once. It may not fully capture nuanced stylistic preferences or complex semantic relationships beyond the keywords provided.", + "examples": [ + "Compose a promotional sentence including keywords 'sustainable', 'eco-friendly', and 'affordable' with a friendly tone.", + "Generate a formal sentence with keywords 'privacy policy', 'data protection', and 'user consent'.", + "Create an informative sentence about 'cloud hosting' and 'scalability' in a professional style." + ] + }, + "tags": [ + "sentence generation", + "content creation", + "web copy", + "text generation", + "composition" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"secure\",\"login\",\"fast\"],\"tone\":\"professional\",\"style\":\"informative\",\"maxLength\":100}", + "description": "Generate a professional informative sentence about a secure and fast login." + }, + { + "inputJson": "{\"keywords\":[\"sale\",\"discount\",\"limited-time\"],\"tone\":\"friendly\",\"style\":\"promotional\",\"maxLength\":80}", + "description": "Create a friendly promotional sentence for a limited-time sale discount." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Sentence", + "context": null + } + }, + { + "name": "web-development.composeComment", + "description": "Generates a formatted comment snippet for website content, given author details and comment text. Accepts input including the author's name, email (optional), comment content, and optional metadata such as date and reply-to ID. Produces a standardized comment object or markup suitable for insertion into web pages or comment management systems.", + "category": "web-development", + "parameters": [ + { + "name": "authorName", + "type": "string", + "description": "Name of the comment author, shown publicly.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email address of the comment author, used for notifications or gravatar integration.", + "required": false, + "defaultValue": "" + }, + { + "name": "commentText", + "type": "string", + "description": "The main textual content of the comment to be published.", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "ISO 8601 formatted date string of when the comment was made; defaults to current date if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "replyToId", + "type": "string", + "description": "Identifier of the comment this is replying to if applicable; empty if a top-level comment.", + "required": false, + "defaultValue": "" + }, + { + "name": "isHtmlAllowed", + "type": "boolean", + "description": "Whether to allow HTML content inside the comment text; disables encoding if true.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A structured comment object containing author details, sanitized comment content, timestamp, and reply linkage, ready for storage or display." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate well-structured and possibly sanitized comment data for web development contexts, such as building comment sections or APIs that manage user feedback on web pages. It ensures consistent formatting, optional HTML sanitization, and metadata inclusion for web comments.", + "limitations": "Does not perform spam detection, sentiment analysis, or advanced validation beyond basic text encoding and formatting. It requires the caller to handle storage or further processing.", + "examples": [ + "Compose a new top-level comment from user 'Alice' with a text message.", + "Create a reply comment referencing comment ID '123abc' including author's email and current timestamp.", + "Generate a comment that supports HTML content in the comment text for richer formatting." + ] + }, + "tags": [ + "web", + "comment", + "compose", + "user-generated-content", + "markup", + "sanitization", + "response" + ], + "examples": [ + { + "inputJson": "{\"authorName\":\"Alice\",\"authorEmail\":\"alice@example.com\",\"commentText\":\"This is a great article!\",\"date\":\"2024-06-10T14:30:00Z\",\"replyToId\":\"\",\"isHtmlAllowed\":false}", + "description": "Top-level comment by Alice with plain text on a specific date." + }, + { + "inputJson": "{\"authorName\":\"Bob\",\"authorEmail\":\"\",\"commentText\":\"Thanks for the info!\",\"date\":\"\",\"replyToId\":\"123abc\",\"isHtmlAllowed\":true}", + "description": "A reply comment by Bob allowing HTML formatting, replying to comment ID '123abc' with current date." + }, + { + "inputJson": "{\"authorName\":\"Charlie\",\"commentText\":\"Looking forward to more updates.\",\"isHtmlAllowed\":false}", + "description": "Simple comment with minimal required fields from Charlie, no email or date specified (defaults applied)." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Comment", + "context": null + } + }, + { + "name": "web-development.composeText", + "description": "Generates well-structured website content text based on user-provided topics, tone, and style preferences. Accepts input parameters to guide content length, tone (formal, casual, etc.), and keywords to include, then produces coherent, human-like paragraphs optimized for web presentation.", + "category": "web-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the text to compose, guiding content focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone to use in the content, such as formal, casual, friendly, or professional.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "style", + "type": "string", + "description": "Preferred writing style, e.g., descriptive, persuasive, informative, or narrative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords that should be naturally incorporated into the text for SEO or emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the composed text output, in number of words.", + "required": false, + "defaultValue": "200" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the output text, e.g., 'en' for English, 'es' for Spanish.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed text as a string, matching the input constraints." + }, + "aiAgent": { + "useCase": "Use this tool to automatically generate coherent and appropriately styled website textual content when given a clear topic and tone, facilitating content creation for landing pages, descriptions, or blog intros. It helps accelerate web development by producing quality text drafts ready for review or direct use.", + "limitations": "It cannot guarantee factual accuracy or deep technical expertise about specialized subjects and may require human editing for tone consistency and brand alignment.", + "examples": [ + "Compose a formal introductory paragraph about sustainable energy technology.", + "Generate a casual product description including keywords 'eco-friendly' and 'durable'.", + "Create an informative web page section on benefits of mindfulness with a maximum length of 150 words." + ] + }, + "tags": [ + "content-generation", + "text-composition", + "web-content", + "seo", + "writing-assistant" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"tone\":\"professional\",\"style\":\"informative\",\"keywords\":[\"flexibility\",\"work-life balance\"],\"maxLength\":150,\"language\":\"en\"}", + "description": "Compose a professional and informative paragraph about benefits of remote work including specified keywords." + }, + { + "inputJson": "{\"topic\":\"Coffee brewing methods\",\"tone\":\"casual\",\"style\":\"descriptive\",\"keywords\":[\"espresso\",\"french press\"],\"maxLength\":100}", + "description": "Generate a casual, descriptive text about different coffee brewing methods using given keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Text", + "context": null + } + }, + { + "name": "web-development.composeMention", + "description": "Generates HTML snippet for a user mention in web content, accepting user details and optional display options, producing valid HTML with semantic attributes for clear user reference and linking.", + "category": "web-development", + "parameters": [ + { + "name": "username", + "type": "string", + "description": "The unique username or handle of the user to mention, used in the link and data attributes.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayName", + "type": "string", + "description": "The name to display for the user mention in the content. If omitted, username is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "profileUrl", + "type": "string", + "description": "The URL to the user's profile or page, used as the href attribute of the mention link.", + "required": true, + "defaultValue": "" + }, + { + "name": "cssClass", + "type": "string", + "description": "Optional CSS class(es) to apply to the mention element for custom styling.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeAvatar", + "type": "boolean", + "description": "Flag to include a small avatar image next to the mention name, enhances visual recognition.", + "required": false, + "defaultValue": "false" + }, + { + "name": "avatarUrl", + "type": "string", + "description": "URL to the user's avatar image, required if includeAvatar is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "HTML string representing the user mention, including a link, display name, and optional avatar." + }, + "aiAgent": { + "useCase": "Use this tool when composing web content or posts that require mentioning users with semantic, clickable references. It ensures consistent, accessible HTML with optional avatar inclusion, suitable for social media, comments, forums, or collaborative tools.", + "limitations": "This tool doesn't validate URLs or usernames, nor does it fetch user data; it relies on input parameters. It outputs HTML string only; further integration into web pages or frameworks is needed for rendering.", + "examples": [ + "Create a mention for user 'john_doe' with display name 'John Doe' linking to his profile.", + "Generate mention HTML with avatar image for user 'alice123' for a social comment.", + "Produce a simple mention using only username and profile URL, no avatar, with custom CSS class." + ] + }, + "tags": [ + "web", + "mention", + "HTML", + "user", + "social", + "content", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"username\":\"john_doe\",\"displayName\":\"John Doe\",\"profileUrl\":\"https://site.com/users/john_doe\",\"cssClass\":\"user-mention\",\"includeAvatar\":false,\"avatarUrl\":\"\"}", + "description": "Mention user John Doe without avatar, styled with CSS class." + }, + { + "inputJson": "{\"username\":\"alice123\",\"displayName\":\"Alice\",\"profileUrl\":\"https://social.app/u/alice123\",\"cssClass\":\"mention highlight\",\"includeAvatar\":true,\"avatarUrl\":\"https://social.app/images/avatar/alice123.png\"}", + "description": "Mention Alice including avatar image and CSS highlight." + }, + { + "inputJson": "{\"username\":\"guest\",\"displayName\":\"\",\"profileUrl\":\"https://example.org/users/guest\",\"cssClass\":\"\",\"includeAvatar\":false,\"avatarUrl\":\"\"}", + "description": "Simple mention using username as display with no avatar or CSS." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Mention", + "context": null + } + }, + { + "name": "web-development.composeNotification", + "description": "This tool generates customizable web notification messages based on provided parameters such as title, message content, notification type (info, warning, error, success), and optional actions like buttons or links. It outputs a JSON structure suitable for rendering on web interfaces or integrating with front-end frameworks.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The headline or title text of the notification to display.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "Main content or body text of the notification, explaining the alert or info.", + "required": true, + "defaultValue": "" + }, + { + "name": "type", + "type": "string", + "description": "Visual style and category of the notification; typical values include 'info', 'success', 'warning', 'error'.", + "required": false, + "defaultValue": "info" + }, + { + "name": "dismissable", + "type": "boolean", + "description": "Whether the notification includes a close button for the user to dismiss it.", + "required": false, + "defaultValue": "true" + }, + { + "name": "actions", + "type": "array", + "description": "Array of action objects containing label and URL that add interactive buttons/links within the notification.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Optional duration in seconds after which the notification auto-dismisses. Zero or omitted means persistent.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured JSON object representing the composed notification including all given parameters formatted for front-end usage." + }, + "aiAgent": { + "useCase": "Use this tool when constructing structured notification messages for websites or applications, especially when needing consistent formatting and support for multiple notification types and actions. Ideal for generating front-end payloads that can be rendered by UI components.", + "limitations": "This tool does not handle notification delivery mechanisms such as push notifications or server-side scheduling. It only composes the notification data structure.", + "examples": [ + "Create an error notification with dismiss button and an action link to support.", + "Generate a success notification with only a title and message, no actions, auto-dismiss after 5 seconds.", + "Produce a warning notification with custom actions and persistent display until dismissed." + ] + }, + "tags": [ + "web", + "notification", + "message", + "ui", + "alert", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Session Expired\",\"message\":\"Your session has timed out due to inactivity.\",\"type\":\"error\",\"dismissable\":true,\"actions\":[{\"label\":\"Login Again\",\"url\":\"/login\"}],\"timeoutSeconds\":0}", + "description": "An error notification informing user session expired, with a dismiss button and a link to log in again." + }, + { + "inputJson": "{\"title\":\"Upload Complete\",\"message\":\"Your files have been successfully uploaded.\",\"type\":\"success\",\"dismissable\":true,\"actions\":[],\"timeoutSeconds\":5}", + "description": "A success notification confirming file upload completion that auto-dismisses after 5 seconds." + }, + { + "inputJson": "{\"title\":\"Low Disk Space\",\"message\":\"Your disk space is running low. Please free up space.\",\"type\":\"warning\",\"dismissable\":true,\"actions\":[{\"label\":\"Manage Storage\",\"url\":\"/storage\"}],\"timeoutSeconds\":0}", + "description": "A warning notification about low disk space with an action button for storage management, persistent until dismissed." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Notification", + "context": null + } + }, + { + "name": "web-development.composeReply", + "description": "Generates a professional reply message based on the provided context and previous message. Accepts the original message and optional parameters like tone and desired length, then composes a clear, context-aware response message suitable for email, chat, or forum communication.", + "category": "web-development", + "parameters": [ + { + "name": "originalMessage", + "type": "string", + "description": "The message text to which the reply will respond (usually a received email or chat message).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the reply, e.g., formal, friendly, concise, apologetic, etc.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "string", + "description": "Preferred length of the reply: short, medium, or long.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to append a signature block to the reply message.", + "required": false, + "defaultValue": "false" + }, + { + "name": "customSignature", + "type": "string", + "description": "A custom signature text to append if includeSignature is true. Ignored otherwise.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed reply message text under the key 'replyMessage'." + }, + "aiAgent": { + "useCase": "This tool should be used by AI agents when replying to messages within web platforms like forums, customer support chats, or emails requiring coherent, contextually appropriate responses. It is ideal for automating replies that maintain a selected tone and length, improving communication efficiency.", + "limitations": "It cannot handle highly specialized legal, medical, or technical advice beyond general conversational replies. It may not perfectly capture extremely nuanced emotional context or sarcasm.", + "examples": [ + "Compose a friendly reply to an email asking for meeting availability.", + "Generate a concise, formal response to a customer complaint with an apology and resolution.", + "Create a brief, polite forum reply declining an invitation." + ] + }, + "tags": [ + "communication", + "reply", + "message", + "composition", + "web", + "automation" + ], + "examples": [ + { + "inputJson": "{\"originalMessage\":\"Hi team, can you please provide an update on the project status?\",\"tone\":\"formal\",\"length\":\"medium\",\"includeSignature\":true,\"customSignature\":\"Best regards, John\"}", + "description": "Generate a formal medium-length reply to request for project status update including a signature." + }, + { + "inputJson": "{\"originalMessage\":\"Are you attending the meetup next week?\",\"tone\":\"friendly\",\"length\":\"short\",\"includeSignature\":false,\"customSignature\":\"\"}", + "description": "Generate a short and friendly reply to an informal event invitation without signature." + }, + { + "inputJson": "{\"originalMessage\":\"Your order arrived damaged. I want a refund.\",\"tone\":\"apologetic\",\"length\":\"medium\",\"includeSignature\":true,\"customSignature\":\"Customer Support Team\"}", + "description": "Generate a medium length apologetic customer support reply addressing a refund request with signature." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reply", + "context": null + } + }, + { + "name": "web-development.composeParagraph", + "description": "Composes a well-structured paragraph of text for web content based on a given topic and style preferences. Accepts input parameters including topic keywords, tone, length, and optional specific content points, processing them to output a coherent paragraph suitable for website use or content blocks.", + "category": "web-development", + "parameters": [ + { + "name": "topicKeywords", + "type": "array", + "description": "List of keywords or phrases to include in the paragraph to guide the content focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the paragraph, e.g., formal, casual, persuasive, informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the paragraph in number of sentences. Typically between 3 and 7.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includePoints", + "type": "array", + "description": "Optional list of specific points or facts to ensure inclusion in the paragraph content.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text as a string under the key 'paragraph'." + }, + "aiAgent": { + "useCase": "Use this tool when generating descriptive or informative paragraphs for webpages, blogs, or other web-based textual content. Ideal for assisting in content creation by providing focused, coherent paragraphs tailored to given keywords, tone, and length requirements.", + "limitations": "Cannot guarantee factual accuracy or deep domain expertise; the generated text may require human review for correctness and style consistency.", + "examples": [ + "Generate a persuasive paragraph about the benefits of organic gardening using keywords like 'eco-friendly' and 'sustainable'.", + "Compose an informative paragraph summarizing key features of a new software product targeting developers.", + "Write a casual paragraph highlighting top tourist attractions in Paris including specific landmarks." + ] + }, + "tags": [ + "content generation", + "paragraph writing", + "web content", + "text synthesis", + "tone adaptation", + "SEO" + ], + "examples": [ + { + "inputJson": "{\"topicKeywords\":[\"responsive design\",\"mobile\",\"user experience\"],\"tone\":\"informative\",\"length\":5}", + "description": "Generate an informative paragraph focused on responsive design improving mobile user experience." + }, + { + "inputJson": "{\"topicKeywords\":[\"cloud security\",\"data protection\"],\"tone\":\"formal\",\"length\":6,\"includePoints\":[\"compliance standards\",\"encryption methods\"]}", + "description": "Create a formal paragraph addressing cloud security, emphasizing compliance standards and encryption methods." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Paragraph", + "context": null + } + }, + { + "name": "web-development.composeThread", + "description": "Composes a communication thread for web applications by accepting thread metadata, participants, and initial messages. It processes the input to structure a thread object suitable for posting or storing in forums, chat apps, or customer support systems, producing a fully formatted thread ready for use.", + "category": "web-development", + "parameters": [ + { + "name": "threadTitle", + "type": "string", + "description": "The title or subject of the communication thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "Array of participant user IDs or usernames involved in the thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "initialMessages", + "type": "array", + "description": "Array of initial messages for the thread, each with sender ID, timestamp, and content.", + "required": true, + "defaultValue": "" + }, + { + "name": "isPinned", + "type": "boolean", + "description": "Flag indicating if the thread should be pinned or highlighted.", + "required": false, + "defaultValue": "false" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of tags or labels to categorize the thread.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object representing the composed thread with structured metadata, participant info, message array, pinned status, tags, and a unique thread ID." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create a new communication thread in a web app context—such as initializing forums, support ticket discussions, or group chats—by defining thread metadata, participants, and initial messages to construct a complete thread structure for immediate use or storage.", + "limitations": "This tool does not handle message content moderation, real-time message delivery, or persistent storage—it only composes the thread structure. It also does not manage participant authentication or authorization.", + "examples": [ + "Create a new support thread titled 'Payment Issue' with customer and agent participants and first message describing problem.", + "Compose a forum thread with title, multiple participants, and multiple initial introductory messages.", + "Initialize a chat thread between three users with one greeting message and mark it as pinned." + ] + }, + "tags": [ + "communication", + "thread", + "web", + "messaging", + "forum", + "chat", + "support" + ], + "examples": [ + { + "inputJson": "{\"threadTitle\":\"Feature Request Discussion\",\"participants\":[\"user123\",\"dev456\"],\"initialMessages\":[{\"senderId\":\"user123\",\"timestamp\":\"2024-06-01T09:30:00Z\",\"content\":\"I would love to see dark mode support.\"}],\"isPinned\":false,\"tags\":[\"feature\",\"discussion\"]}", + "description": "Compose a new thread for discussing a feature request with two participants and one initial message." + }, + { + "inputJson": "{\"threadTitle\":\"Customer Support - Login Issues\",\"participants\":[\"customer789\",\"agent101\"],\"initialMessages\":[{\"senderId\":\"customer789\",\"timestamp\":\"2024-06-02T14:00:00Z\",\"content\":\"Unable to login after password reset.\"},{\"senderId\":\"agent101\",\"timestamp\":\"2024-06-02T14:05:00Z\",\"content\":\"We're looking into this issue.\"}],\"isPinned\":true,\"tags\":[\"support\",\"login\"]}", + "description": "Create a pinned support thread about login issues with two messages from customer and agent." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Thread", + "context": null + } + }, + { + "name": "web-development.composeChannel", + "description": "Creates a new communication channel configuration for a web platform by accepting channel type, participants, access controls, and optional metadata. Validates inputs and returns a structured channel object with unique ID suitable for integration into messaging or notification systems.", + "category": "web-development", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of the channel such as 'chat', 'announcement', or 'support'.", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "List of user identifiers who will be part of the channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "isPrivate", + "type": "boolean", + "description": "Determines if the channel is private or public.", + "required": false, + "defaultValue": "false" + }, + { + "name": "accessControls", + "type": "object", + "description": "Object defining permissions and roles for participants, e.g., {admin: [userId1], member: [userId2,userId3]}.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs for additional channel info like description or tags.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the fully composed channel, including id, type, participant list, privacy status, access controls, and metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically set up a communication channel in a web application platform, providing necessary configuration details like participant list and permissions. It's designed for creating structured channels for chat, notifications, or announcements with configurable privacy and roles.", + "limitations": "This tool does not send messages or manage real-time communication sessions; it only composes channel configurations. It assumes participant identifiers and permission formats are valid externally.", + "examples": [ + "Create a private chat channel for three users with one admin and two members.", + "Compose a public announcement channel with no restrictions and descriptive metadata.", + "Set up a support channel with specific access controls assigning different roles." + ] + }, + "tags": [ + "channel", + "communication", + "web", + "configuration", + "compose", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"chat\",\"participants\":[\"user123\",\"user456\",\"user789\"],\"isPrivate\":true,\"accessControls\":{\"admin\":[\"user123\"],\"member\":[\"user456\",\"user789\"]},\"metadata\":{\"description\":\"Team project chat\"}}", + "description": "Creates a private chat channel with three users, designating one as admin and two as members, adding a description." + }, + { + "inputJson": "{\"channelType\":\"announcement\",\"participants\":[],\"isPrivate\":false,\"accessControls\":{},\"metadata\":{\"topic\":\"Quarterly Updates\",\"tags\":[\"company\",\"news\"]}}", + "description": "Creates a public announcement channel without participants restriction, including topic and tags in metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Channel", + "context": null + } + }, + { + "name": "web-development.composeReadme", + "description": "Generates a well-structured README.md file for a web development project based on input parameters such as project name, description, technologies used, installation instructions, usage examples, contribution guidelines, and license. Outputs the complete markdown content string for immediate use.", + "category": "web-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the web development project.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief summary describing the project's purpose and features.", + "required": true, + "defaultValue": "" + }, + { + "name": "technologies", + "type": "array", + "description": "List of key technologies, frameworks, or libraries used in the project.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions to install and set up the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "string", + "description": "Code snippets or explanations illustrating how to run or use the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Instructions and rules for contributing to the project, including code style or pull requests.", + "required": false, + "defaultValue": "" + }, + { + "name": "license", + "type": "string", + "description": "The license under which the project is released, e.g., MIT, Apache 2.0, GPL.", + "required": false, + "defaultValue": "MIT" + } + ], + "returns": { + "type": "string", + "description": "A string containing the complete README.md content formatted in markdown." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate a professional README.md for a web development project from key metadata and instructions. It helps create consistent documentation quickly, ideal for initializing repos or updating project docs without manual formatting.", + "limitations": "This tool does not fetch or analyze code; it relies entirely on user-provided input. It cannot validate technical correctness or provide advanced documentation like API references or diagrams.", + "examples": [ + "Generate README for a React app with installation and usage instructions", + "Create README including contribution guidelines and license details", + "Compose a README listing project technologies and a project description" + ] + }, + "tags": [ + "documentation", + "readme", + "markdown", + "web-development", + "automation", + "project-setup" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"AwesomeWebApp\",\"projectDescription\":\"A powerful web app for managing tasks.\",\"technologies\":[\"React\",\"Node.js\",\"MongoDB\"],\"installationInstructions\":\"1. Clone repo\\n2. Run npm install\\n3. Run npm start\",\"usageExamples\":\"Open browser at localhost:3000 to use the app.\",\"contributionGuidelines\":\"Please fork and submit pull requests with descriptive messages.\",\"license\":\"MIT\"}", + "description": "Generate a full README file with all relevant sections for a React + Node.js project." + }, + { + "inputJson": "{\"projectName\":\"SimplePortfolio\",\"projectDescription\":\"Personal portfolio website.\",\"technologies\":[\"HTML\",\"CSS\",\"JavaScript\"],\"installationInstructions\":\"Just open index.html in any browser.\",\"usageExamples\":\"Showcases projects and contact info.\",\"contributionGuidelines\":\"No contributions accepted.\",\"license\":\"Apache 2.0\"}", + "description": "Create README for a simple static portfolio website with basic instructions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Readme", + "context": null + } + }, + { + "name": "web-development.composeMessage", + "description": "Generates a well-structured message for web communication by accepting parameters such as recipient, subject, message body, and optional formatting or personalization data. It produces a formatted message string ready for sending via email, chat, or web notifications.", + "category": "web-development", + "parameters": [ + { + "name": "recipient", + "type": "string", + "description": "The email address or username of the message recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject or title of the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content or text of the message to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "formattingOptions", + "type": "object", + "description": "Optional object specifying formatting rules such as bold, italic, or bullet points.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "personalizationData", + "type": "object", + "description": "Optional key-value pairs to personalize the message (e.g., recipient name, company).", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully composed message as a formatted string, including headers and body ready for dispatch." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create clear, formatted messages for communication channels within web applications, such as sending notification emails, chat messages, or alerts. It helps structure and personalize messages programmatically.", + "limitations": "This tool does not send the message, nor integrates with delivery protocols; it only composes the content and formatting. It does not perform language translation or advanced natural language generation beyond templated personalization.", + "examples": [ + "Compose a notification email to user@example.com with the subject 'Welcome' and a personalized welcome message including the user's first name.", + "Create a formatted chat message with bullet points for system updates addressed to admin user.", + "Generate a simple alert message body with no special formatting to notify a user about a password reset request." + ] + }, + "tags": [ + "web", + "message", + "compose", + "communication", + "email", + "notification" + ], + "examples": [ + { + "inputJson": "{\"recipient\":\"jane.doe@example.com\",\"subject\":\"Welcome to Our Service\",\"body\":\"Hello {{name}},\\nThank you for joining! We're excited to have you.\",\"formattingOptions\":{\"bold\":true},\"personalizationData\":{\"name\":\"Jane\"}}", + "description": "Compose a personalized welcome email in bold to Jane Doe." + }, + { + "inputJson": "{\"recipient\":\"adminUser\",\"subject\":\"System Update\",\"body\":\"Please review the following updates:\\n- Patch 1 applied\\n- Server restart at midnight\",\"formattingOptions\":{\"bulletPoints\":true},\"personalizationData\":{}}", + "description": "Compose a system update message with bullet points to an admin user." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Message", + "context": null + } + }, + { + "name": "web-development.composeTemplate", + "description": "Composes an HTML or text-based template by injecting dynamic content into placeholders. Accepts a template string with placeholders and a data object; produces a final formatted string with all placeholders replaced accordingly, suitable for emails, webpages, or document generation.", + "category": "web-development", + "parameters": [ + { + "name": "templateString", + "type": "string", + "description": "The raw template containing placeholders to be replaced with dynamic content, e.g., '{{username}}'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "object", + "description": "Key-value pairs where keys correspond to placeholders in the template and values are the content to replace them.", + "required": true, + "defaultValue": "" + }, + { + "name": "placeholderDelimiter", + "type": "array", + "description": "An array of two strings defining the opening and closing delimiters for placeholders. Default is ['{{','}}'].", + "required": false, + "defaultValue": "[\"{{\",\"}}\"]" + }, + { + "name": "escapeHtml", + "type": "boolean", + "description": "Flag indicating whether to escape HTML special characters in injected content to prevent XSS. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "strictMode", + "type": "boolean", + "description": "If true, the tool throws errors on missing data keys for placeholders; otherwise leaves placeholders unchanged. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed template string with placeholders replaced by corresponding data values." + }, + "aiAgent": { + "useCase": "Use this tool when dynamically creating web templates or documents that require runtime substitution of variable content within a consistent structure, such as generating personalized emails, HTML pages, or text reports. It handles placeholder replacement securely with options for escaping HTML and strict validation.", + "limitations": "Does not perform advanced templating logic such as loops, conditionals, or functions. Complex templates requiring logic processing must use a dedicated templating engine.", + "examples": [ + "Compose a welcome email template by injecting user name and signup date.", + "Generate a simple webpage snippet replacing a title and content placeholders with provided text.", + "Fill a plain text invoice template with customer and order details." + ] + }, + "tags": [ + "webdevelopment", + "template", + "string-replacement", + "html", + "email", + "document-generation" + ], + "examples": [ + { + "inputJson": "{\"templateString\":\"
Welcome, {{username}}!
Your account balance is {{balance}}.
\",\"data\":{\"username\":\"Alice\",\"balance\":\"$100\"}}", + "description": "Inject user name and balance into an HTML welcome message." + }, + { + "inputJson": "{\"templateString\":\"Dear {{name}},\\nThank you for your order #{{orderId}}.\",\"data\":{\"name\":\"Bob\",\"orderId\":\"12345\"}}", + "description": "Fill a plain text notification template with customer name and order ID." + }, + { + "inputJson": "{\"templateString\":\"{{greeting}} {{user}}!\",\"data\":{\"greeting\":\"Hello\",\"user\":\"Eve\"},\"escapeHtml\":true}", + "description": "Compose a small HTML snippet greeting the user, ensuring HTML entities are escaped." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Template", + "context": null + } + }, + { + "name": "web-development.composeChecklist", + "description": "Generates a detailed and organized checklist document tailored for web development projects. Accepts input parameters including project phase, focus areas (e.g., UI, backend, testing), and optional custom tasks. Processes this information to produce a structured checklist covering essential tasks, best practices, and validation points suitable for the specified project context.", + "category": "web-development", + "parameters": [ + { + "name": "projectPhase", + "type": "string", + "description": "Specifies the current phase of the web development project (e.g., planning, development, testing, deployment).", + "required": true, + "defaultValue": "" + }, + { + "name": "focusAreas", + "type": "array", + "description": "An array of key focus areas for the checklist, such as ['UI','backend','performance','security'].", + "required": true, + "defaultValue": "[]" + }, + { + "name": "includeCustomTasks", + "type": "boolean", + "description": "If true, allows inclusion of user-defined custom tasks in the checklist.", + "required": false, + "defaultValue": "false" + }, + { + "name": "customTasks", + "type": "array", + "description": "List of custom task strings to include when includeCustomTasks is true.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output checklist document; can be 'json' for structured data or 'markdown' for formatted text.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the checklist organized by categories with tasks and status placeholders. If markdown is chosen, returns a string with the formatted markdown checklist." + }, + "aiAgent": { + "useCase": "Use this tool when generating structured checklists for various phases of web development to ensure comprehensive coverage of essential tasks and best practices. It helps project managers, developers, and QA engineers systematically track progress and verify readiness in specific areas such as UI, backend, or testing.", + "limitations": "This tool does not generate real-time updates or track task completion status; it only composes an initial checklist based on input parameters. It also cannot customize subtasks deeply beyond provided custom tasks.", + "examples": [ + "Generate a checklist for the testing phase focusing on backend and performance.", + "Create a development phase checklist including UI and security-related tasks plus some custom ones.", + "Produce a markdown formatted deployment checklist covering all areas." + ] + }, + "tags": [ + "web", + "checklist", + "project management", + "task planning", + "documentation", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"projectPhase\":\"testing\",\"focusAreas\":[\"backend\",\"performance\"],\"includeCustomTasks\":false}", + "description": "Generates a backend and performance testing checklist for the testing project phase." + }, + { + "inputJson": "{\"projectPhase\":\"development\",\"focusAreas\":[\"UI\",\"security\"],\"includeCustomTasks\":true,\"customTasks\":[\"Review accessibility compliance\",\"Verify CSP headers\"],\"outputFormat\":\"markdown\"}", + "description": "Creates a markdown checklist for development focusing on UI and security with added custom tasks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Checklist", + "context": null + } + }, + { + "name": "web-development.composeFAQ", + "description": "Creates a structured FAQ document by accepting an array of questions and answers. The tool processes the input to generate a well-formatted HTML or Markdown FAQ section suitable for integration into websites, improving user self-service support and information access.", + "category": "web-development", + "parameters": [ + { + "name": "questionsAndAnswers", + "type": "array", + "description": "An array of objects each containing a 'question' and its corresponding 'answer' as strings, representing FAQ entries to be included in the document.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Specifies the format of the generated FAQ document, e.g., 'html' for HTML markup or 'markdown' for Markdown text.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeSchemaMarkup", + "type": "boolean", + "description": "Indicates whether to include structured data markup (FAQPage schema) for SEO enhancement in the output. Applies only for HTML format.", + "required": false, + "defaultValue": "true" + }, + { + "name": "title", + "type": "string", + "description": "Optional title for the FAQ section to be included at the top of the document.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing the FAQ content as a string in the requested format under 'faqContent', and a 'contentType' string indicating MIME type like 'text/html' or 'text/markdown'." + }, + "aiAgent": { + "useCase": "Use this tool when generating FAQ sections for web pages by converting raw question-answer data into polished, standardized FAQ content in HTML or Markdown with optional SEO markup. Ideal for automating support content creation, enhancing user experience, and improving search engine visibility.", + "limitations": "Does not generate questions or answers automatically; relies on provided well-formatted input. Does not handle very large datasets efficiently. Output customization beyond basic formatting is limited.", + "examples": [ + "Generate an HTML FAQ section with schema markup from given questions and answers.", + "Create a Markdown FAQ document without schema markup for inclusion in a static site generator.", + "Add a title to the FAQ section and output in HTML format for a product support page." + ] + }, + "tags": [ + "web", + "faq", + "content-generation", + "html", + "markdown", + "seo" + ], + "examples": [ + { + "inputJson": "{\"questionsAndAnswers\":[{\"question\":\"What is your return policy?\",\"answer\":\"You can return any item within 30 days of purchase.\"},{\"question\":\"Do you offer technical support?\",\"answer\":\"Yes, 24/7 technical support is available via phone and email.\"}],\"outputFormat\":\"html\",\"includeSchemaMarkup\":true,\"title\":\"Frequently Asked Questions\"}", + "description": "Generate an HTML FAQ block with schema markup and title from two Q&A pairs." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "FAQ", + "context": null + } + }, + { + "name": "web-development.composeBrief", + "description": "This tool generates a concise project brief document for a website or web app based on input requirements. Given details like project goals, target audience, key features, and constraints, it composes a structured brief summarizing the domain, objectives, and scope to guide development teams. The output is a clear, formatted textual brief suitable for initial planning stages.", + "category": "web-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name or title of the web project to be briefed.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectGoals", + "type": "string", + "description": "A description of the main goals or objectives the website should achieve.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended users or audience for the website.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of primary features or functionalities the website should include.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "technicalConstraints", + "type": "string", + "description": "Any technical, budgetary, or timeline constraints relevant to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any other relevant information or instructions to include in the brief.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed project brief as a formatted string under 'briefText'." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to assist in creating a clear, structured project brief document for web development tasks. It helps transform scattered input details into a professional summary guiding development scope, requirements, and objectives.", + "limitations": "It cannot replace a detailed requirements gathering session with stakeholders. It produces a textual brief but does not generate visuals or formal project management documents.", + "examples": [ + "Create a project brief for an e-commerce site targeting millennials focusing on mobile-first design.", + "Compose a web app brief for a productivity tool with integrations and user collaboration features.", + "Generate a brief for a nonprofit organization's informational website with a limited budget." + ] + }, + "tags": [ + "web development", + "project brief", + "requirements", + "documentation", + "planning", + "web projects" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"EcoShop\",\"projectGoals\":\"Create an environmentally focused e-commerce platform that promotes sustainable products.\",\"targetAudience\":\"Eco-conscious shoppers aged 18-35.\",\"keyFeatures\":[\"mobile-friendly design\",\"sustainable product filters\",\"user reviews\"],\"technicalConstraints\":\"Launch within 6 months on a limited budget.\",\"additionalNotes\":\"Include multilingual support starting with English and Spanish.\"}", + "description": "Brief for an eco-friendly e-commerce site targeting young eco-conscious buyers." + }, + { + "inputJson": "{\"projectName\":\"TaskMaster Pro\",\"projectGoals\":\"Develop a web productivity app to enhance team collaboration and task management.\",\"targetAudience\":\"Small to medium business teams.\",\"keyFeatures\":[\"real-time collaboration\",\"calendar integration\",\"notifications\"],\"technicalConstraints\":\"Must integrate with existing Google Workspace APIs.\",\"additionalNotes\":\"Focus on intuitive UX.\"}", + "description": "Brief for a collaborative task management web app for SMB teams." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Brief", + "context": null + } + }, + { + "name": "web-development.composeMinutes", + "description": "This tool assists in composing meeting minutes by accepting details like meeting topics, attendees, discussions, decisions, and action items as input. It processes this structured data to generate a well-formatted minutes document in text or markdown format, ready for sharing or archiving.", + "category": "web-development", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "Title or subject of the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Date of the meeting in ISO format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "attendees", + "type": "array", + "description": "List of attendee names present at the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "agendaItems", + "type": "array", + "description": "Array of agenda items or topics discussed, each as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "discussionPoints", + "type": "object", + "description": "Mapping of agenda items to an array of discussion points or notes under each topic.", + "required": true, + "defaultValue": "" + }, + { + "name": "decisionsMade", + "type": "object", + "description": "Mapping of agenda items to array of decisions or resolutions made for each topic.", + "required": false, + "defaultValue": "" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items including description, assignee, and due date as objects.", + "required": false, + "defaultValue": "" + }, + { + "name": "formatMarkdown", + "type": "boolean", + "description": "If true, formats the output as markdown; otherwise, plain text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a formatted meeting minutes document as a string under the 'minutesDocument' key." + }, + "aiAgent": { + "useCase": "Use this tool to generate clear, professional meeting minutes from structured input such as agenda, attendees, discussions, and action items. It's ideal for teams wanting to automate or standardize minutes writing for project sprints, client meetings, or internal reviews.", + "limitations": "This tool does not record audio or transcribe spoken meetings, nor can it infer content beyond the provided input. It requires structured data to compose coherent minutes.", + "examples": [ + "Create meeting minutes for the weekly team sync including attendees, agenda, and decisions.", + "Generate minutes in markdown format for a project kickoff meeting with detailed action items.", + "Prepare a summary document listing decisions and assigned tasks from a client call." + ] + }, + "tags": [ + "web-development", + "document-generation", + "meeting", + "minutes", + "automation", + "productivity" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Sprint Planning Meeting\",\"date\":\"2024-06-01\",\"attendees\":[\"Alice\",\"Bob\",\"Charlie\"],\"agendaItems\":[\"Sprint goals\",\"Task assignments\"],\"discussionPoints\":{\"Sprint goals\":[\"Define priorities for next sprint\",\"Discuss timeline constraints\"],\"Task assignments\":[\"Alice to lead frontend tasks\",\"Bob to handle backend development\"]},\"decisionsMade\":{\"Sprint goals\":[\"Focus on user authentication and dashboard\"],\"Task assignments\":[\"Assign backend API to Bob\"]},\"actionItems\":[{\"description\":\"Setup authentication module\",\"assignee\":\"Alice\",\"dueDate\":\"2024-06-10\"},{\"description\":\"Design database schema\",\"assignee\":\"Bob\",\"dueDate\":\"2024-06-08\"}],\"formatMarkdown\":true}", + "description": "Generate markdown formatted minutes for a sprint planning meeting including attendees, agenda topics, discussion notes, decisions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Minutes", + "context": null + } + }, + { + "name": "web-development.composeBlogPost", + "description": "This tool generates a complete, formatted blog post based on user inputs including title, author, main topics, target audience, and style preferences. It processes these inputs to compose coherent, well-structured content with optional SEO metadata and formatting options, outputting a ready-to-publish blog post in Markdown or HTML format.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the blog post to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the author to be displayed with the blog post.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "topics", + "type": "array", + "description": "List of main topics or keywords to cover within the blog post content.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for tone and content suitability (e.g., beginners, experts).", + "required": false, + "defaultValue": "\"general audience\"" + }, + { + "name": "style", + "type": "string", + "description": "Preferred writing style for the blog post (e.g., formal, casual, technical).", + "required": false, + "defaultValue": "\"informative\"" + }, + { + "name": "includeSEO", + "type": "boolean", + "description": "Whether to generate SEO-friendly metadata like meta description and keywords.", + "required": false, + "defaultValue": "false" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the blog post, either 'markdown' or 'html'.", + "required": false, + "defaultValue": "\"markdown\"" + }, + { + "name": "wordCount", + "type": "number", + "description": "Approximate desired word count for the blog post content.", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed blog post content with properties 'content' (string) and optionally 'seoMetadata' (object with meta description and keywords)" + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a full, publish-ready blog post from high-level inputs like title and topics. Ideal for automating content creation workflows, drafting posts quickly, or assisting in writing consistent blog entries tailored to a specific audience and style.", + "limitations": "The tool cannot guarantee factual accuracy or up-to-date information. It does not perform real-time fact checking or integrate with external data sources for dynamic content.", + "examples": [ + "Compose a 1200-word technical blog post titled 'The Future of AI in Healthcare' for expert readers with a formal style.", + "Create a casual blog post about 'Top 10 Travel Destinations in 2024' aimed at general audience, including SEO metadata.", + "Generate a markdown formatted blog post on 'Benefits of Remote Work' targeting corporate managers." + ] + }, + "tags": [ + "blogging", + "content-generation", + "markdown", + "html", + "seo", + "writing-assistant", + "web-content" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Benefits of Morning Exercise\",\"author\":\"Jane Doe\",\"topics\":[\"health\",\"exercise\",\"morning routine\"],\"targetAudience\":\"general audience\",\"style\":\"informative\",\"includeSEO\":true,\"format\":\"markdown\",\"wordCount\":800}", + "description": "Generate an 800-word informative blog post about morning exercise benefits with SEO metadata, formatted in markdown." + }, + { + "inputJson": "{\"title\":\"Advanced JavaScript Tips\",\"author\":\"John Smith\",\"topics\":[\"JavaScript\",\"programming\",\"web development\"],\"targetAudience\":\"expert developers\",\"style\":\"technical\",\"includeSEO\":false,\"format\":\"html\",\"wordCount\":1500}", + "description": "Create a technical, 1500-word blog post in HTML about advanced JavaScript techniques for expert developers, no SEO metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "BlogPost", + "context": null + } + }, + { + "name": "web-development.composeTranscript", + "description": "This tool accepts raw audio or video file URLs and optional speaker metadata, then processes and composes a clean, timestamped transcript in text or JSON format. It outputs a structured transcript suitable for embedding in websites or further text processing.", + "category": "web-development", + "parameters": [ + { + "name": "mediaUrl", + "type": "string", + "description": "URL of the audio or video file to transcribe and compose the transcript from", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the spoken content for accurate transcription", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps in the transcript output", + "required": false, + "defaultValue": "true" + }, + { + "name": "speakerLabels", + "type": "array", + "description": "Optional array of speaker names or labels for speaker diarization assignment", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output transcript: plain text or JSON", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed transcript in the requested format, including text content and metadata such as timestamps and speaker labels if requested." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate clean, web-friendly transcripts from audio or video media sources for websites, applications, or documentation. It is helpful for accessibility features, content SEO, and user engagement by providing readable and organized dialogue text with optional speaker identification and timing data.", + "limitations": "This tool does not perform actual speech recognition but expects an audio/video URL for external transcription. It relies on external services or prior transcription data. It cannot handle encrypted or inaccessible media URLs, nor translate the transcript into other languages.", + "examples": [ + "Generate a transcript of a webinar video including speaker names and timestamps in JSON format.", + "Compose a plain text transcript from a podcast episode URL in English.", + "Create a transcript without timestamps from a lecture audio file URL, assuming the media is in English." + ] + }, + "tags": [ + "transcription", + "web-content", + "accessibility", + "media-processing", + "speaker-diarization", + "timestamping" + ], + "examples": [ + { + "inputJson": "{\"mediaUrl\":\"https://example.com/media/interview.mp4\",\"language\":\"en-US\",\"includeTimestamps\":true,\"speakerLabels\":[\"Host\",\"Guest\"],\"outputFormat\":\"json\"}", + "description": "Compose a JSON transcript with timestamps and speaker labels from an English interview video URL." + }, + { + "inputJson": "{\"mediaUrl\":\"https://example.com/media/podcast.mp3\",\"includeTimestamps\":false,\"outputFormat\":\"text\"}", + "description": "Generate a plain text transcript without timestamps from an English podcast audio URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Transcript", + "context": null + } + }, + { + "name": "web-development.composeSummary", + "description": "Generates a concise summary of a given document related to web development. Accepts raw text content or HTML input, analyzes key points using natural language processing, and produces a clear, coherent summary highlighting the document's main ideas and purpose.", + "category": "web-development", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "The full text or HTML content of the document to summarize.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "The format of the input document content; either 'text' or 'html'.", + "required": false, + "defaultValue": "text" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate desired length of the summary in number of sentences or key points.", + "required": false, + "defaultValue": "3" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input content (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyPhrases", + "type": "boolean", + "description": "Whether to include a list of key phrases or terms extracted from the document.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and optionally extracted key phrases if requested." + }, + "aiAgent": { + "useCase": "Use this tool when you need a clear, concise summary of lengthy or complex web development documentation, such as technical specs, tutorials, or project notes. It helps agents extract essential points quickly for reporting, briefing, or content previews.", + "limitations": "Cannot replace human expert review for highly technical or nuanced content. Summaries are approximate and may omit subtle details. Performance may vary with very short or poorly formatted inputs.", + "examples": [ + "Summarize a long HTML tutorial about React hooks into three main points.", + "Create a concise summary of a text-based API reference documentation.", + "Generate a brief overview and key terms from a JavaScript framework specification." + ] + }, + "tags": [ + "web-development", + "summary", + "document", + "nlp", + "content-analysis", + "html", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"React is a JavaScript library for building user interfaces. It allows developers to create large web applications that can update and render efficiently in response to data changes. React uses a declarative programming model and component-based architecture.\",\"inputFormat\":\"text\",\"summaryLength\":2,\"language\":\"en\",\"includeKeyPhrases\":true}", + "description": "Summarize a short plain text description of React focusing on main ideas and key phrases." + }, + { + "inputJson": "{\"documentContent\":\"Webpack Overview
Webpack is a module bundler for modern JavaScript applications. It processes and bundles assets like JavaScript, CSS, and images for optimized delivery.
\",\"inputFormat\":\"html\",\"summaryLength\":3,\"language\":\"en\",\"includeKeyPhrases\":false}", + "description": "Generate a concise summary from a simple HTML snippet describing Webpack." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Summary", + "context": null + } + }, + { + "name": "web-development.composeEmail", + "description": "This tool generates a complete email message based on provided parameters such as recipients, subject, body content, and optional attachments. It processes inputs including plain text or HTML content, handles CC/BCC fields, and outputs a structured email object ready to be sent via an email sending service or client.", + "category": "web-development", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of primary recipient email addresses for the email (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of email addresses to receive carbon copies (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of email addresses to receive blind carbon copies (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content of the email, can be plain text or HTML (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Indicates if the body content is HTML formatted (optional, default false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachments, each with filename and base64 or URL content (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "replyTo", + "type": "string", + "description": "Email address to use in the Reply-To header (optional).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An email object containing all headers and content structured and ready for sending via SMTP or API." + }, + "aiAgent": { + "useCase": "Use this tool when generating a fully structured email message dynamically from given parameters, for sending notifications, user communications, or automated emails in web applications. It ensures all parts such as recipients, subject, body, and attachments are properly composed before dispatch.", + "limitations": "This tool only composes the email and does not send it. It does not manage SMTP connections or authentication. Validation of email addresses' deliverability is not included.", + "examples": [ + "Compose an email to multiple recipients with cc and an HTML body.", + "Create an email with attachments and a specific reply-to address.", + "Generate a plain text email with only a subject and body for a single recipient." + ] + }, + "tags": [ + "email", + "compose", + "web-development", + "communication", + "automation" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"alice@example.com\"],\"subject\":\"Meeting Reminder\",\"body\":\"Dear Alice,
\",\"isHtml\":true}", + "description": "Compose a reminder email with HTML content to a single recipient." + }, + { + "inputJson": "{\"to\":[\"john@example.com\",\"jane@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Project Update\",\"body\":\"The project has reached phase 2. Please see attached report.\",\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"base64EncodedPdfContent==\"}]}", + "description": "Compose an email with multiple recipients, CC, and a PDF attachment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "web-development.composeArticle", + "description": "This tool accepts structured input such as article title, author, content sections, and metadata. It composes a well-formatted article in HTML or Markdown format, integrating headings, paragraphs, images, links, and references as specified. The output is a complete article document ready for publication or further editing.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the article to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the article author or content creator.", + "required": false, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An ordered list of sections composing the article. Each section includes a heading and body content, optionally images or links.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "The output format of the composed article, either 'html' or 'markdown'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional article metadata such as publication date, tags, and summary.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the composed article as a string under 'content' key, plus its format and metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a structured and formatted article document for web publication or content management systems based on provided title, sections, and metadata inputs. It simplifies article creation by automatically organizing and formatting content with optional support for HTML or Markdown outputs.", + "limitations": "This tool does not generate article content automatically; it requires well-structured input content sections. It cannot perform content fact-checking, SEO optimization, or multimedia processing beyond simple image URL embedding.", + "examples": [ + "Compose an article titled 'Latest Web Development Trends' with three sections and output in HTML.", + "Create a Markdown blog post about 'Sustainable Technology' with author name and tags.", + "Generate an article with metadata including publication date and summary, formatted as HTML." + ] + }, + "tags": [ + "web", + "article", + "content", + "compose", + "html", + "markdown", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Future of AI in Web Development\",\"author\":\"Jane Doe\",\"sections\":[{\"heading\":\"Introduction\",\"body\":\"Artificial Intelligence is reshaping web development workflows...\"},{\"heading\":\"Current Applications\",\"body\":\"AI tools assist with code generation, testing, and deployment automation...\"},{\"heading\":\"Challenges and Opportunities\",\"body\":\"Despite benefits, challenges include bias, security, and maintainability...\"}],\"format\":\"html\",\"metadata\":{\"publicationDate\":\"2024-06-01\",\"tags\":[\"AI\",\"web development\"],\"summary\":\"Overview of AI trends impacting web development.\"}}", + "description": "Compose an HTML article with given title, author, multiple sections, and metadata including tags and publication date." + }, + { + "inputJson": "{\"title\":\"Accessibility Best Practices\",\"sections\":[{\"heading\":\"Why Accessibility Matters\",\"body\":\"Ensuring websites are accessible benefits all users...\"},{\"heading\":\"Key Techniques\",\"body\":\"Use semantic HTML, alt attributes, ARIA roles...\"}],\"format\":\"markdown\"}", + "description": "Generate a Markdown formatted article on accessibility with two sections, no author or metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Article", + "context": null + } + }, + { + "name": "web-development.composeDocument", + "description": "This tool accepts structured input content (such as text blocks, headings, images, and links) and configuration options to compose a complete HTML document. It processes and organizes input into semantic HTML5 structure, applies optional styling or metadata, and outputs a valid HTML document string ready for deployment or further editing.", + "category": "web-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the HTML document to set in the head section.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Optional author metadata to include in the document.", + "required": false, + "defaultValue": "" + }, + { + "name": "contentBlocks", + "type": "array", + "description": "An array of content block objects defining the main body content, each block specifying its type (e.g., paragraph, heading, image) and associated data.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeStyles", + "type": "boolean", + "description": "Flag indicating whether to include default basic CSS styles in the document to improve readability.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'fr') to set as the document's language attribute.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the full HTML document as a string under the property 'htmlDocument'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate complete HTML documents from structured content inputs for web pages, reports, or emails. It helps in automating web document creation ensuring semantic correctness and optional styling, useful for web-development agents assembling content from data or user input.", + "limitations": "Does not support advanced dynamic scripting, interactive elements, or rendering rich media beyond static images and text. Styling is basic and not customizable beyond default inclusion flag.", + "examples": [ + "Generate a simple HTML page with title, author metadata, and three paragraphs of text content.", + "Create an HTML document with multiple heading levels and images, specifying language as French.", + "Produce a minimal HTML page with no styles included, only text content and title." + ] + }, + "tags": [ + "web", + "document", + "HTML", + "compose", + "automation", + "content", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Sample Page\",\"author\":\"John Doe\",\"contentBlocks\":[{\"type\":\"heading\",\"level\":1,\"text\":\"Welcome to Our Site\"},{\"type\":\"paragraph\",\"text\":\"This is the first paragraph.\"},{\"type\":\"paragraph\",\"text\":\"This is the second paragraph.\"}],\"includeStyles\":true,\"language\":\"en\"}", + "description": "Basic HTML document with title, author, headings, and paragraphs with default styling." + }, + { + "inputJson": "{\"title\":\"Rapport Mensuel\",\"author\":\"Marie Curie\",\"contentBlocks\":[{\"type\":\"heading\",\"level\":2,\"text\":\"Introduction\"},{\"type\":\"paragraph\",\"text\":\"Voici le rapport mensuel.\"},{\"type\":\"image\",\"src\":\"report-chart.png\",\"alt\":\"Monthly Chart\"}],\"includeStyles\":false,\"language\":\"fr\"}", + "description": "French language document with heading, paragraph, image, and no styles." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "web-development.composeReport", + "description": "Generates a detailed HTML or Markdown report for web projects by accepting project data, metrics, and optional styling preferences. Processes inputs to compose structured sections, visual summaries, and downloadable content outlining project progress or status. Outputs a formatted report document as a string or file link.", + "category": "web-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the web project the report is about.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportTitle", + "type": "string", + "description": "Title of the report document to be generated.", + "required": false, + "defaultValue": "Project Report" + }, + { + "name": "contentSections", + "type": "array", + "description": "An array of objects representing individual sections with titles and body content to include in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "object", + "description": "Key-value pairs representing project metrics (e.g., performance, bug counts) to summarize in the report.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the report, either 'html' or 'markdown'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a summary section based on metrics.", + "required": false, + "defaultValue": "true" + }, + { + "name": "styleTemplate", + "type": "string", + "description": "Optional CSS style or Markdown style template to format the report visually.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the 'reportContent' as a string with the formatted report in specified format, and 'fileName' suggesting a filename for saving the report." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to create a professional, structured report document about a web development project, including sections, metrics summaries, and optionally styled output in HTML or Markdown. It's helpful for generating project status, debugging summaries, or performance analysis documents automatically from given data.", + "limitations": "This tool does not generate complex charts or graphs, nor does it fetch data from external sources; all input data must be provided. It also does not handle real-time updates or editing after report generation.", + "examples": [ + "Generate an HTML project status report for 'Website Redesign' with sections describing progress, bug fixes, and performance metrics.", + "Compose a Markdown report summarizing test results and deployment details for a web app project with a custom style template.", + "Create a simple HTML report with a summary section for project 'E-commerce Platform' including uptime and error count metrics." + ] + }, + "tags": [ + "web-development", + "report", + "document-generation", + "project-management", + "HTML", + "Markdown", + "summary", + "automation" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"Website Redesign\",\"reportTitle\":\"Monthly Status Report\",\"contentSections\":[{\"title\":\"Overview\",\"body\":\"This month we improved the UI and fixed major bugs.\"},{\"title\":\"Bug Fixes\",\"body\":\"Fixed 25 bugs including critical payment gateway issues.\"}],\"metrics\":{\"performance\":\"95%\",\"bugs\":\"25\"},\"format\":\"html\",\"includeSummary\":true}", + "description": "Generate an HTML status report for the Website Redesign project including sections and metrics summary." + }, + { + "inputJson": "{\"projectName\":\"E-commerce Platform\",\"contentSections\":[{\"title\":\"Deployment Info\",\"body\":\"Version 2.3 deployed with improved checkout flow.\"}],\"metrics\":{\"uptime\":\"99.9%\",\"errorCount\":3},\"format\":\"markdown\",\"includeSummary\":true}", + "description": "Compose a markdown report with deployment info and metrics summary for an e-commerce platform project." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "web-development.buildCluster", + "description": "Builds and configures a scalable infrastructure cluster for web applications. Accepts parameters such as cluster size, node configuration, cloud provider, and network settings. Provisions computing resources, sets up load balancers, and deploys basic monitoring. Returns cluster details including endpoints, resource allocation, and status.", + "category": "web-development", + "parameters": [ + { + "name": "clusterName", + "type": "string", + "description": "Unique name for the cluster to identify it.", + "required": true, + "defaultValue": "" + }, + { + "name": "nodeCount", + "type": "number", + "description": "Number of nodes to provision in the cluster.", + "required": true, + "defaultValue": "3" + }, + { + "name": "nodeType", + "type": "string", + "description": "Type or size of nodes to use (e.g., t3.medium, n1-standard-1).", + "required": true, + "defaultValue": "" + }, + { + "name": "cloudProvider", + "type": "string", + "description": "Cloud provider where the cluster will be built (e.g., AWS, GCP, Azure).", + "required": true, + "defaultValue": "" + }, + { + "name": "region", + "type": "string", + "description": "Geographical region to deploy the cluster in.", + "required": false, + "defaultValue": "us-east-1" + }, + { + "name": "enableLoadBalancer", + "type": "boolean", + "description": "Whether to provision a load balancer for the cluster.", + "required": false, + "defaultValue": "true" + }, + { + "name": "networkSettings", + "type": "object", + "description": "Network configuration including VPC, subnets, and security groups.", + "required": false, + "defaultValue": "" + }, + { + "name": "monitoringEnabled", + "type": "boolean", + "description": "Enable basic monitoring and alerting for cluster health.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns a detailed cluster summary including cluster ID, status, node info, endpoint URLs, and monitoring dashboard links." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and configure a new scalable cluster for deploying web applications or services across cloud providers with customizable node count and configuration. It is ideal for automating infrastructure setup as part of a CI/CD pipeline or infrastructure as code process.", + "limitations": "This tool does not manage application deployment inside the cluster nor handle advanced cluster orchestration features like autoscaling policies or CI integration. It also assumes access credentials and permissions for the specified cloud provider are already handled externally.", + "examples": [ + "Build a 5-node AWS cluster with t3.medium nodes in us-west-2 with load balancer enabled.", + "Create a GCP cluster named 'prod-cluster' with 3 nodes of n1-standard-1 and default network settings.", + "Set up a cluster on Azure with disabled monitoring and a custom VPC configuration." + ] + }, + "tags": [ + "infrastructure", + "cluster", + "cloud", + "provisioning", + "web-development", + "automation", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"clusterName\":\"dev-cluster\",\"nodeCount\":3,\"nodeType\":\"t3.medium\",\"cloudProvider\":\"AWS\",\"region\":\"us-east-1\",\"enableLoadBalancer\":true,\"monitoringEnabled\":true}", + "description": "Build a 3-node AWS cluster with t3.medium nodes in us-east-1 with monitoring and load balancing enabled." + }, + { + "inputJson": "{\"clusterName\":\"staging-cluster\",\"nodeCount\":5,\"nodeType\":\"n1-standard-1\",\"cloudProvider\":\"GCP\",\"region\":\"us-central1\",\"enableLoadBalancer\":false,\"monitoringEnabled\":true}", + "description": "Create a 5-node GCP cluster without a load balancer but with monitoring enabled." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Cluster", + "context": null + } + }, + { + "name": "web-development.buildDatabase", + "description": "Creates a relational or NoSQL database schema and provisions an initial database instance for web applications. Accepts database type, schema definition, connection parameters, and optional seed data; then generates the schema, sets up tables or collections, and returns connection information and setup status.", + "category": "web-development", + "parameters": [ + { + "name": "databaseType", + "type": "string", + "description": "Type of database to build, e.g., 'PostgreSQL', 'MySQL', 'MongoDB'.", + "required": true, + "defaultValue": "" + }, + { + "name": "schemaDefinition", + "type": "object", + "description": "Defines database tables/collections, fields, types, constraints, and relationships.", + "required": true, + "defaultValue": "" + }, + { + "name": "connectionParams", + "type": "object", + "description": "Configuration parameters for database connection such as host, port, username, password.", + "required": true, + "defaultValue": "" + }, + { + "name": "seedData", + "type": "array", + "description": "Optional array of objects representing data to pre-populate the database after creation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "enableIndexes", + "type": "boolean", + "description": "Whether to create indexes defined in the schema or suggested for optimization.", + "required": false, + "defaultValue": "true" + }, + { + "name": "validateSchemaOnly", + "type": "boolean", + "description": "If true, only validates the schema without creating the database.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the database connection info, status of creation, schema validation messages, and any error details." + }, + "aiAgent": { + "useCase": "Use this tool when a web application backend requires a new database infrastructure setup according to specific schema and connection parameters. It is ideal for automating initial provisioning of databases during deployment or development. Agents can supply schema definitions and receive ready-to-use connection info.", + "limitations": "This tool does not handle complex migration or schema evolution for existing databases, nor does it manage database backups or cluster configurations.", + "examples": [ + "Create a PostgreSQL database with user and order tables and seed initial user data.", + "Set up a MongoDB database with collections for products and customers including indexes.", + "Validate a proposed schema for a MySQL database without provisioning it yet." + ] + }, + "tags": [ + "web", + "database", + "provisioning", + "schema", + "relational", + "NoSQL", + "automation" + ], + "examples": [ + { + "inputJson": "{\"databaseType\":\"PostgreSQL\",\"schemaDefinition\":{\"tables\":{\"users\":{\"columns\":{\"id\":{\"type\":\"serial\",\"primaryKey\":true},\"name\":{\"type\":\"varchar(100)\"},\"email\":{\"type\":\"varchar(255)\",\"unique\":true}}},\"orders\":{\"columns\":{\"order_id\":{\"type\":\"serial\",\"primaryKey\":true},\"user_id\":{\"type\":\"int\",\"foreignKey\":{\"table\":\"users\",\"column\":\"id\"}},\"amount\":{\"type\":\"decimal\"}}}}},\"connectionParams\":{\"host\":\"localhost\",\"port\":5432,\"username\":\"admin\",\"password\":\"secret\",\"database\":\"shopdb\"},\"seedData\":[{\"table\":\"users\",\"rows\":[{\"name\":\"Alice\",\"email\":\"alice@example.com\"}]}]}", + "description": "Provision PostgreSQL database 'shopdb' with defined users and orders tables and seed one user." + }, + { + "inputJson": "{\"databaseType\":\"MongoDB\",\"schemaDefinition\":{\"collections\":{\"products\":{\"fields\":{\"name\":\"string\",\"price\":\"number\",\"inStock\":\"boolean\"}}}},\"connectionParams\":{\"host\":\"mongo.example.com\",\"port\":27017,\"username\":\"user\",\"password\":\"pass\",\"database\":\"store\"},\"enableIndexes\":true}", + "description": "Set up a MongoDB store database with a products collection and create indexes." + }, + { + "inputJson": "{\"databaseType\":\"MySQL\",\"schemaDefinition\":{\"tables\":{\"customers\":{\"columns\":{\"customer_id\":{\"type\":\"int\",\"primaryKey\":true},\"first_name\":{\"type\":\"varchar(50)\"},\"last_name\":{\"type\":\"varchar(50)\"}}}},\"connectionParams\":{\"host\":\"127.0.0.1\",\"port\":3306,\"username\":\"root\",\"password\":\"rootpass\",\"database\":\"crm\"},\"validateSchemaOnly\":true}", + "description": "Validate the schema definition for a MySQL CRM database without creating it yet." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Database", + "context": null + } + }, + { + "name": "web-development.buildQueue", + "description": "This tool creates and configures a task queue system for web applications. It accepts parameters specifying queue name, maximum concurrency, retry policies, persistence options, and task validation rules. It outputs a JSON representation of the configured queue infrastructure ready for integration in backend services or serverless environments.", + "category": "web-development", + "parameters": [ + { + "name": "queueName", + "type": "string", + "description": "The unique name identifier for the queue to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxConcurrency", + "type": "number", + "description": "The maximum number of tasks that can be processed concurrently in the queue.", + "required": false, + "defaultValue": "5" + }, + { + "name": "retryPolicy", + "type": "object", + "description": "Defines rules for retrying failed tasks, including max retries and delay between attempts.", + "required": false, + "defaultValue": "" + }, + { + "name": "persistence", + "type": "boolean", + "description": "Determines if the queue should persist tasks on storage to survive application restarts.", + "required": false, + "defaultValue": "true" + }, + { + "name": "taskValidationSchema", + "type": "object", + "description": "JSON schema object to validate tasks before they are accepted into the queue.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON object describing the fully configured queue including parameters used and endpoints or interfaces for interacting with the queue." + }, + "aiAgent": { + "useCase": "Use this tool when building or extending web applications that require managed background task processing, such as job queues for sending emails, processing uploads, or asynchronous workflows. It helps generate a queue configuration that can be implemented with backend services or serverless functions, enabling controlled concurrency, retries, and persistence.", + "limitations": "This tool does not implement the queue runtime itself or provide message consumption logic; it only configures and outputs queue infrastructure setup parameters. Actual task processing and queue execution environment must be managed separately.", + "examples": [ + "Create a queue named 'emailSender' with max concurrency 10 and automatic retry up to 3 times.", + "Build a persistent task queue 'imageProcessor' with validation schema requiring an image URL in each task.", + "Generate a non-persistent queue 'tempNotifications' with concurrency limit 2 and no retry policy." + ] + }, + "tags": [ + "web", + "queue", + "task management", + "infrastructure", + "backend", + "asynchronous" + ], + "examples": [ + { + "inputJson": "{\"queueName\":\"emailSender\",\"maxConcurrency\":10,\"retryPolicy\":{\"maxRetries\":3,\"retryDelayMs\":5000},\"persistence\":true}", + "description": "Create an email sending queue with max 10 concurrent tasks, retry policy of 3 attempts with 5 seconds delay, and persistent storage." + }, + { + "inputJson": "{\"queueName\":\"imageProcessor\",\"maxConcurrency\":4,\"persistence\":true,\"taskValidationSchema\":{\"type\":\"object\",\"properties\":{\"imageUrl\":{\"type\":\"string\",\"format\":\"uri\"}},\"required\":[\"imageUrl\"]}}", + "description": "Create a persistent image processing queue with concurrency 4 that validates each task has a valid image URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Queue", + "context": null + } + }, + { + "name": "web-development.buildCache", + "description": "BuildCache is a tool that accepts website resource metadata and configuration parameters to generate a configurable caching infrastructure plan. It processes inputs like cache strategies, resource types, and expiration policies, then outputs optimized cache configurations for server-side or client-side caches such as HTTP cache headers, service worker rules, or CDN cache settings.", + "category": "web-development", + "parameters": [ + { + "name": "resources", + "type": "array", + "description": "List of website resources with metadata (URL, type, size, frequency of change) to include in the cache plan.", + "required": true, + "defaultValue": "" + }, + { + "name": "cacheStrategy", + "type": "string", + "description": "The caching strategy to apply (e.g., 'Cache First', 'Network First', 'Stale While Revalidate').", + "required": true, + "defaultValue": "" + }, + { + "name": "defaultExpirationSeconds", + "type": "number", + "description": "Default cache expiration time in seconds if a specific expiration is not set per resource.", + "required": false, + "defaultValue": "86400" + }, + { + "name": "enableServiceWorker", + "type": "boolean", + "description": "Flag to generate a service worker caching configuration for offline support.", + "required": false, + "defaultValue": "false" + }, + { + "name": "cdnProvider", + "type": "string", + "description": "Specify the CDN provider to optimize the cache config output for platform-specific settings (e.g., 'Cloudflare', 'Akamai').", + "required": false, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include recommended HTTP cache headers in the output configuration.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing cache configuration rules, including HTTP headers settings, service worker code snippets (if enabled), and CDN cache rule sets optimized as per provided parameters." + }, + "aiAgent": { + "useCase": "Use this tool when designing or optimizing web caching strategies for improved website performance and bandwidth reduction. It helps generate appropriate cache configurations for different resource types, cache strategies, and deployment environments like CDNs and service workers.", + "limitations": "Does not deploy the cache configurations; it only generates the configuration code and guidelines. It does not monitor cache effectiveness or real-time cache invalidations.", + "examples": [ + "Generate a cache configuration for all site images and scripts using 'Cache First' strategy with a 1 day expiration.", + "Create service worker cache rules for a progressive web app enabling offline support with stale-while-revalidate strategy.", + "Produce CDN caching rules optimized for Cloudflare with HTTP header recommendations for static assets." + ] + }, + "tags": [ + "web", + "caching", + "performance", + "service worker", + "CDN", + "configuration", + "optimization" + ], + "examples": [ + { + "inputJson": "{\"resources\":[{\"url\":\"/images/logo.png\",\"type\":\"image\",\"size\":50000,\"changeFrequency\":\"monthly\"},{\"url\":\"/scripts/app.js\",\"type\":\"script\",\"size\":150000,\"changeFrequency\":\"weekly\"}],\"cacheStrategy\":\"Cache First\",\"defaultExpirationSeconds\":86400,\"enableServiceWorker\":true,\"cdnProvider\":\"Cloudflare\",\"includeHeaders\":true}", + "description": "Generate cache config for images and scripts with Cache First strategy, enable service worker and Cloudflare CDN." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Cache", + "context": null + } + }, + { + "name": "web-development.buildService", + "description": "Builds and deploys a web service based on provided configuration. Accepts service name, runtime environment, source code repository URL, deployment environment, and optional environment variables. Processes these inputs to set up CI/CD pipelines, configure hosting, and deploy the service. Outputs deployment status, service URL, and any error messages.", + "category": "web-development", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The name identifier for the web service to be built.", + "required": true, + "defaultValue": "" + }, + { + "name": "runtimeEnvironment", + "type": "string", + "description": "The runtime environment for the service, e.g., 'nodejs', 'python', or 'java'.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceRepositoryUrl", + "type": "string", + "description": "URL to the source code repository containing the service code (e.g., GitHub repo URL).", + "required": true, + "defaultValue": "" + }, + { + "name": "deploymentEnvironment", + "type": "string", + "description": "Target environment for deployment such as 'staging' or 'production'.", + "required": true, + "defaultValue": "" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to configure the service.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "enableAutoScaling", + "type": "boolean", + "description": "Whether to enable autoscaling for the deployed service.", + "required": false, + "defaultValue": "false" + }, + { + "name": "instanceCount", + "type": "number", + "description": "Number of instances to deploy if autoscaling is not enabled.", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing deployment status ('success' or 'failed'), the URL of the deployed service if successful, and an errors array if any issues occurred." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically build and deploy a backend web service from source code with specific runtime and environment settings, for continuous integration and delivery purposes or initial deployments.", + "limitations": "This tool does not handle detailed source code validation, complex multi-service orchestration, nor does it configure advanced network or security policies beyond basic environment variables and deployment setup.", + "examples": [ + "Deploy a NodeJS service for production environment from a GitHub repository with environment variables set.", + "Build a Python web service on staging with autoscaling enabled for load tests.", + "Deploy a Java service with two fixed instances and custom configuration variables to production." + ] + }, + "tags": [ + "web-development", + "deployment", + "ci/cd", + "service-building", + "cloud", + "infrastructure" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"user-auth-service\",\"runtimeEnvironment\":\"nodejs\",\"sourceRepositoryUrl\":\"https://github.com/example/user-auth\",\"deploymentEnvironment\":\"production\",\"environmentVariables\":{\"JWT_SECRET\":\"s3cr3t\"},\"enableAutoScaling\":true}", + "description": "Deploy NodeJS user authentication service to production with autoscaling enabled and JWT secret environment variable." + }, + { + "inputJson": "{\"serviceName\":\"data-processor\",\"runtimeEnvironment\":\"python\",\"sourceRepositoryUrl\":\"https://gitlab.com/org/data-processing\",\"deploymentEnvironment\":\"staging\",\"environmentVariables\":{\"DEBUG\":\"true\"},\"enableAutoScaling\":false,\"instanceCount\":2}", + "description": "Build and deploy a Python data processing service to staging with two fixed instances and debugging enabled via env variable." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Service", + "context": null + } + }, + { + "name": "web-development.buildInstance", + "description": "This tool provisions and configures a cloud instance for web hosting based on user-defined parameters such as cloud provider, instance type, operating system, region, and optional startup scripts. It initializes the environment and returns the instance metadata including ID, IP address, and status.", + "category": "web-development", + "parameters": [ + { + "name": "cloudProvider", + "type": "string", + "description": "Name of the cloud provider where the instance will be created (e.g., AWS, Azure, GCP).", + "required": true, + "defaultValue": "" + }, + { + "name": "instanceType", + "type": "string", + "description": "Type/size of the cloud instance to provision (e.g., t2.micro, Standard_B1s).", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system image to install on the instance (e.g., Ubuntu 20.04, Windows Server 2019).", + "required": true, + "defaultValue": "" + }, + { + "name": "region", + "type": "string", + "description": "Geographical region where the instance should be launched (e.g., us-east-1, europe-west3).", + "required": true, + "defaultValue": "" + }, + { + "name": "startupScript", + "type": "string", + "description": "Optional shell or PowerShell script to run on instance initialization.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyPairName", + "type": "string", + "description": "Name of the SSH key pair to associate with the instance for secure access.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the instance ID, public IP address, status, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically provision and configure a cloud instance for deploying or testing websites or web applications. It handles instance creation and basic setup based on user specifications without manual cloud console intervention.", + "limitations": "This tool cannot handle complex infrastructure orchestration (e.g., multi-instance clusters or container orchestration). It depends on pre-configured cloud provider credentials and may not support all providers or instance types.", + "examples": [ + "Provision a Ubuntu web server in AWS us-east-1 of type t2.micro with a startup script to install Apache.", + "Launch a Windows Server instance in Azure Europe region with specified size and no startup script.", + "Create a GCP instance with an SSH key for access and a script to deploy a Node.js application." + ] + }, + "tags": [ + "infrastructure", + "cloud", + "provisioning", + "web-hosting", + "instance-management", + "automation" + ], + "examples": [ + { + "inputJson": "{\"cloudProvider\":\"AWS\",\"instanceType\":\"t2.micro\",\"operatingSystem\":\"Ubuntu 20.04\",\"region\":\"us-east-1\",\"startupScript\":\"#!/bin/bash\\nsudo apt update && sudo apt install -y apache2\",\"keyPairName\":\"my-keypair\"}", + "description": "Provision a small Ubuntu server on AWS with Apache installed on startup and specific SSH key pair." + }, + { + "inputJson": "{\"cloudProvider\":\"Azure\",\"instanceType\":\"Standard_B1s\",\"operatingSystem\":\"Windows Server 2019\",\"region\":\"europe-west\",\"startupScript\":\"\",\"keyPairName\":\"azure-key\"}", + "description": "Launch a Windows Server instance in Azure Europe region with a named SSH key and no startup script." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Instance", + "context": null + } + }, + { + "name": "web-development.buildContainer", + "description": "Builds and deploys a containerized web application environment based on specified configurations. Accepts inputs like container image, environment variables, port mappings, and resource limits, then creates and starts the container on a target host or orchestrator. Outputs status and container details like ID and endpoint URLs.", + "category": "web-development", + "parameters": [ + { + "name": "containerImage", + "type": "string", + "description": "Docker image name with tag to use for the container", + "required": true, + "defaultValue": "" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set inside the container", + "required": false, + "defaultValue": "{}" + }, + { + "name": "portMappings", + "type": "array", + "description": "Array of objects specifying containerPort and hostPort for port forwarding", + "required": false, + "defaultValue": "[]" + }, + { + "name": "resourceLimits", + "type": "object", + "description": "Specifies resource constraints like memory (e.g., '512m') and CPU shares", + "required": false, + "defaultValue": "{}" + }, + { + "name": "containerName", + "type": "string", + "description": "Optional name to assign to the container instance", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "restartPolicy", + "type": "string", + "description": "Container restart policy such as 'no', 'on-failure', or 'always'", + "required": false, + "defaultValue": "\"no\"" + }, + { + "name": "targetHost", + "type": "string", + "description": "Address or identifier of the host or orchestrator where the container is deployed", + "required": false, + "defaultValue": "\"localhost\"" + } + ], + "returns": { + "type": "object", + "description": "Result object containing 'success' (boolean), 'containerId' (string), 'message' (string for errors or status), and 'endpoints' (array of accessible URLs)." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create and start containerized web application instances with specific configurations on a given host or orchestration platform, enabling automated deployment in web development workflows.", + "limitations": "Does not handle image building or container orchestration logic outside of starting containers. Assumes container image is pre-built and accessible. Does not manage multi-container services or networking beyond port mappings.", + "examples": [ + "Build and start a container from image 'nginx:latest' exposing port 80 mapped to host port 8080.", + "Deploy a container with environment variables for database credentials and resource limits for CPU and memory.", + "Restart a container with a specified name on a remote Docker host." + ] + }, + "tags": [ + "web-development", + "container", + "docker", + "deployment", + "automation", + "infrastructure" + ], + "examples": [ + { + "inputJson": "{\"containerImage\":\"nginx:latest\",\"portMappings\":[{\"containerPort\":80,\"hostPort\":8080}],\"containerName\":\"webserver1\"}", + "description": "Deploy an NGINX container exposing port 80 as port 8080 on the host with a container name." + }, + { + "inputJson": "{\"containerImage\":\"myapp/backend:v2\",\"environmentVariables\":{\"DB_HOST\":\"db.example.com\",\"DB_USER\":\"admin\"},\"resourceLimits\":{\"memory\":\"512m\",\"cpuShares\":512},\"restartPolicy\":\"always\"}", + "description": "Start a backend app container with environment variables and resource limits, set to always restart." + }, + { + "inputJson": "{\"containerImage\":\"redis:6-alpine\",\"targetHost\":\"192.168.1.100\",\"portMappings\":[{\"containerPort\":6379,\"hostPort\":6379}]}", + "description": "Build and deploy a Redis container on a remote host forwarding default Redis port." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Container", + "context": null + } + }, + { + "name": "web-development.buildPackage", + "description": "Builds a web development package from specified source files and configuration options. Accepts the source directory path, build environment (development or production), output directory, bundling options, and optional minification flag. Processes files to bundle, transpile if needed, and outputs a deployable package with build logs and summary.", + "category": "web-development", + "parameters": [ + { + "name": "sourceDir", + "type": "string", + "description": "File system path to the source code directory to build from.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputDir", + "type": "string", + "description": "File system path where the built package files will be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "environment", + "type": "string", + "description": "Build environment, e.g., 'development' or 'production' to configure optimizations accordingly.", + "required": true, + "defaultValue": "production" + }, + { + "name": "bundleConfig", + "type": "object", + "description": "Configuration object defining bundling options like entry points, output names, and module rules.", + "required": false, + "defaultValue": "" + }, + { + "name": "minify", + "type": "boolean", + "description": "Flag indicating whether to minify output files. Recommended true for production builds.", + "required": false, + "defaultValue": "true" + }, + { + "name": "sourceMaps", + "type": "boolean", + "description": "Flag indicating whether to generate source maps for debugging purposes.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "BuildResult containing success status, array of output file paths, build logs capturing steps and warnings/errors, and a summary including build duration and total files processed." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automate packaging of web development projects, including bundling JavaScript, CSS, and assets based on specified configurations, to generate deployable output suited for development or production environments. Useful in continuous integration pipelines or devops workflows requiring flexible and reproducible builds.", + "limitations": "Does not perform deployment or upload of packages to servers or package managers. Does not handle dependency installation or project scaffolding; expects source and configuration ready to build.", + "examples": [ + "Build a production package for the web app located in './src' with minified output and source maps.", + "Create a development build with no minification outputting files to './build-dev'.", + "Build with a custom bundling configuration specifying multiple entry points and hashed filenames." + ] + }, + "tags": [ + "web-development", + "build", + "package", + "bundling", + "transpiling" + ], + "examples": [ + { + "inputJson": "{\"sourceDir\":\"./src\",\"outputDir\":\"./dist\",\"environment\":\"production\",\"minify\":true,\"sourceMaps\":true}", + "description": "Builds a production-ready package from './src' into './dist' with minification and source maps." + }, + { + "inputJson": "{\"sourceDir\":\"./app\",\"outputDir\":\"./build-dev\",\"environment\":\"development\",\"minify\":false,\"sourceMaps\":false}", + "description": "Creates a development build from './app' into './build-dev' with no minification or source maps." + }, + { + "inputJson": "{\"sourceDir\":\"./project\",\"outputDir\":\"./output\",\"environment\":\"production\",\"bundleConfig\":{\"entry\":{\"main\":\"./project/index.js\",\"vendor\":\"./project/vendor.js\"},\"output\":{\"filename\":\"[name].[contenthash].js\"}},\"minify\":true,\"sourceMaps\":true}", + "description": "Builds a production package with custom bundling configuration generating hashed filenames for cache busting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Package", + "context": null + } + }, + { + "name": "web-development.buildServer", + "description": "Builds and configures a web server instance based on specified parameters such as server type, operating system, server software, and resources. Accepts configuration inputs and returns deployment status along with server access details. Useful for automated provisioning of web server infrastructure.", + "category": "web-development", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "Type of server to build, e.g., 'development', 'staging', or 'production'.", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system for the server, e.g., 'Ubuntu 22.04', 'CentOS 7', or 'Windows Server 2019'.", + "required": true, + "defaultValue": "" + }, + { + "name": "serverSoftware", + "type": "string", + "description": "Web server software to install, e.g., 'nginx', 'apache', or 'iis'.", + "required": true, + "defaultValue": "" + }, + { + "name": "cpuCores", + "type": "number", + "description": "Number of CPU cores to allocate to the server instance.", + "required": false, + "defaultValue": "2" + }, + { + "name": "memoryGB", + "type": "number", + "description": "Amount of RAM in gigabytes for the server.", + "required": false, + "defaultValue": "4" + }, + { + "name": "storageGB", + "type": "number", + "description": "Disk storage size in gigabytes assigned to the server.", + "required": false, + "defaultValue": "50" + }, + { + "name": "enableSSL", + "type": "boolean", + "description": "Whether to enable SSL with a self-signed certificate.", + "required": false, + "defaultValue": "false" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Additional environment variables to set on the server as key-value pairs.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing serverId, status indicating success or error, serverUrl for accessing the web server, and a message providing additional info." + }, + "aiAgent": { + "useCase": "Use this tool when automating the provisioning and configuration of web server infrastructure to support application deployments. It is suited for scenarios requiring a programmable interface to build servers with customized OS, web server software, resource allocation, and environment setup. This tool accelerates CI/CD pipelines, cloud infrastructure setup, and test environment preparation.", + "limitations": "This tool does not handle deploying application code, managing DNS settings, or configuring advanced network security groups. It also cannot customize server software beyond installation and basic configuration.", + "examples": [ + "Create a production server using Ubuntu with nginx and 8 CPU cores, 16GB RAM.", + "Setup a development server with Windows Server 2019, IIS, and enable SSL.", + "Provision a staging server on CentOS with Apache and 4 CPU cores, setting environment variables for database credentials." + ] + }, + "tags": [ + "server", + "infrastructure", + "web", + "automation", + "provisioning", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"production\",\"operatingSystem\":\"Ubuntu 22.04\",\"serverSoftware\":\"nginx\",\"cpuCores\":8,\"memoryGB\":16,\"storageGB\":100,\"enableSSL\":true}", + "description": "Provision a production Ubuntu server with nginx, ample CPU and RAM, 100GB storage, and SSL enabled." + }, + { + "inputJson": "{\"serverType\":\"development\",\"operatingSystem\":\"Windows Server 2019\",\"serverSoftware\":\"iis\",\"cpuCores\":2,\"memoryGB\":4,\"storageGB\":50,\"enableSSL\":false}", + "description": "Build a Windows development server with IIS, minimal resources, no SSL." + }, + { + "inputJson": "{\"serverType\":\"staging\",\"operatingSystem\":\"CentOS 7\",\"serverSoftware\":\"apache\",\"cpuCores\":4,\"memoryGB\":8,\"storageGB\":75,\"enableSSL\":false,\"environmentVariables\":{\"DB_HOST\":\"staging-db.local\",\"DEBUG\":\"true\"}}", + "description": "Setup a staging CentOS server with Apache and environment variables for database host and debug mode." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Server", + "context": null + } + }, + { + "name": "web-development.buildPipeline", + "description": "This tool accepts configuration inputs for a web development build pipeline, including build steps, tools, environment settings, and triggers. It processes these inputs to generate a reproducible, automated pipeline configuration file (e.g., for CI/CD systems like Jenkins, GitHub Actions, or GitLab CI) that can be directly used to build, test, and deploy web applications.", + "category": "web-development", + "parameters": [ + { + "name": "pipelineName", + "type": "string", + "description": "Unique name identifier for the build pipeline.", + "required": true, + "defaultValue": "" + }, + { + "name": "buildSteps", + "type": "array", + "description": "An ordered array of objects each defining a build step with properties such as name, command, and optional environment variables.", + "required": true, + "defaultValue": "" + }, + { + "name": "environment", + "type": "object", + "description": "Key-value pairs of environment variables to set during the build process.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "triggerEvents", + "type": "array", + "description": "Array of event types that trigger the pipeline, e.g., push, pull_request, merge, schedule.", + "required": false, + "defaultValue": "[\"push\"]" + }, + { + "name": "pipelineType", + "type": "string", + "description": "The target CI/CD system for the pipeline configuration (e.g., 'githubActions', 'jenkins', 'gitlabCi').", + "required": true, + "defaultValue": "githubActions" + }, + { + "name": "cachePaths", + "type": "array", + "description": "Array of file or directory paths to cache between runs to speed up build.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "notifications", + "type": "object", + "description": "Configuration for notifications upon pipeline success/failure, e.g., email or Slack webhook settings.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the serialized pipeline configuration as a string and metadata such as file format and suggested filename." + }, + "aiAgent": { + "useCase": "Use this tool when creating or updating an automated build pipeline configuration for web development projects. It helps generate ready-to-use pipeline config files for popular CI/CD platforms based on customizable build steps, environment settings, triggers, caching, and notifications, enabling continuous integration and continuous deployment workflows.", + "limitations": "This tool generates pipeline configuration files but does not execute pipelines or manage deployment infrastructure. Complex conditional pipeline logic or custom scripting beyond the defined commands might require manual adjustments.", + "examples": [ + "Generate a GitHub Actions workflow for a Node.js project with build, test, and deploy steps triggered on pull requests.", + "Create a Jenkins pipeline configuration with environment variables and caching for frontend asset builds.", + "Build a GitLab CI pipeline that triggers nightly to run integration tests and notify a Slack channel on failure." + ] + }, + "tags": [ + "web-development", + "build", + "CI/CD", + "pipeline", + "automation", + "devops", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"pipelineName\":\"nodejs-ci\",\"pipelineType\":\"githubActions\",\"buildSteps\":[{\"name\":\"Install Dependencies\",\"command\":\"npm install\"},{\"name\":\"Run Tests\",\"command\":\"npm test\"},{\"name\":\"Build\",\"command\":\"npm run build\"}],\"environment\":{\"NODE_ENV\":\"production\"},\"triggerEvents\":[\"pull_request\"],\"cachePaths\":[\"~/.npm\"],\"notifications\":{\"email\":\"dev-team@example.com\"}}", + "description": "Generate a GitHub Actions pipeline for a Node.js project triggered on pull requests, with caching and email notifications." + }, + { + "inputJson": "{\"pipelineName\":\"frontend-build\",\"pipelineType\":\"jenkins\",\"buildSteps\":[{\"name\":\"Install\",\"command\":\"yarn install\"},{\"name\":\"Build Assets\",\"command\":\"yarn build\"}],\"environment\":{\"CI\":\"true\"},\"triggerEvents\":[\"push\"],\"cachePaths\":[\"node_modules\"],\"notifications\":{}}", + "description": "Create a Jenkins pipeline configuration for building frontend assets on push events with caching of node_modules." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Pipeline", + "context": null + } + }, + { + "name": "web-development.buildWorkflow", + "description": "This tool generates a customizable web development workflow configuration based on user inputs. It accepts input parameters such as the development framework, build tools, testing and deployment options, and outputs a structured workflow file (e.g., YAML or JSON) for automating web project build processes with CI/CD pipelines.", + "category": "web-development", + "parameters": [ + { + "name": "projectType", + "type": "string", + "description": "Type of web project (e.g., 'React', 'Vue', 'Angular', 'StaticSite') to tailor the workflow accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "buildTool", + "type": "string", + "description": "The build tool or task runner to use (e.g., 'Webpack', 'Vite', 'Parcel').", + "required": true, + "defaultValue": "" + }, + { + "name": "testFrameworks", + "type": "array", + "description": "List of testing frameworks to include in the workflow (e.g., ['Jest', 'Cypress']).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "deploymentTarget", + "type": "string", + "description": "Target deployment platform (e.g., 'Netlify', 'Vercel', 'AWS', 'Firebase').", + "required": false, + "defaultValue": "" + }, + { + "name": "includeLinting", + "type": "boolean", + "description": "Whether to include linting steps in the workflow.", + "required": false, + "defaultValue": "true" + }, + { + "name": "nodeVersion", + "type": "string", + "description": "Specify the Node.js version to use in the workflow environment (e.g., '16', '18').", + "required": false, + "defaultValue": "16" + }, + { + "name": "workflowFormat", + "type": "string", + "description": "Output workflow file format, either 'YAML' or 'JSON'.", + "required": false, + "defaultValue": "YAML" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated workflow configuration content string and the recommended filename for the workflow file." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to quickly create a complete automated build, test, and deployment workflow tailored to a specific web project type. It is helpful for generating CI/CD pipeline files for platforms such as GitHub Actions, GitLab CI, or other CI services customized to user preferences and project requirements.", + "limitations": "This tool does not execute or validate the generated workflow files within CI environments. It cannot automatically resolve complex dependencies or environment-specific configurations outside of the user-provided parameters.", + "examples": [ + "Generate a React project workflow using Webpack and Jest, deploying to Vercel.", + "Create a Vue app workflow with Vite as the build tool, including Cypress tests and linting, deploying to Netlify.", + "Build a static site workflow with Parcel and no tests, deploying on Firebase." + ] + }, + "tags": [ + "web-development", + "automation", + "CI/CD", + "workflow", + "build", + "deployment", + "testing", + "linting" + ], + "examples": [ + { + "inputJson": "{\"projectType\":\"React\",\"buildTool\":\"Webpack\",\"testFrameworks\":[\"Jest\"],\"deploymentTarget\":\"Vercel\",\"includeLinting\":true,\"nodeVersion\":\"18\",\"workflowFormat\":\"YAML\"}", + "description": "Generate a React project workflow using Webpack and Jest, deploying to Vercel with linting and Node.js v18." + }, + { + "inputJson": "{\"projectType\":\"Vue\",\"buildTool\":\"Vite\",\"testFrameworks\":[\"Cypress\"],\"deploymentTarget\":\"Netlify\",\"includeLinting\":true,\"nodeVersion\":\"16\",\"workflowFormat\":\"JSON\"}", + "description": "Create a Vue app workflow with Vite, Cypress tests, linting enabled, deploying to Netlify in JSON format." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Workflow", + "context": null + } + }, + { + "name": "web-development.buildPullRequest", + "description": "Creates a new Pull Request on a specified git repository hosting platform based on provided source and target branches. Accepts repository details, branch names, and PR metadata, then initializes the pull request for review and integration. Outputs the pull request URL and ID for tracking.", + "category": "web-development", + "parameters": [ + { + "name": "repositoryOwner", + "type": "string", + "description": "Owner or organization name of the repository, e.g., 'octocat'.", + "required": true, + "defaultValue": "" + }, + { + "name": "repositoryName", + "type": "string", + "description": "The name of the repository, e.g., 'Hello-World'.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceBranch", + "type": "string", + "description": "The branch containing the changes you want to merge.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetBranch", + "type": "string", + "description": "The branch you want to merge the changes into, typically 'main' or 'master'.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title for the pull request describing the purpose of the changes.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Detailed description of the pull request, explaining the changes and reasons.", + "required": false, + "defaultValue": "" + }, + { + "name": "reviewers", + "type": "array", + "description": "List of usernames to request review from.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "labels", + "type": "array", + "description": "List of labels to apply to the pull request for categorization.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the pull request ID, URL, and status confirming creation success." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically open a pull request after pushing feature or fix branches for code review and integration in a git repository hosted on platforms like GitHub, GitLab, or Bitbucket. It automates PR creation during automated CI/CD flows or developer assistance.", + "limitations": "Does not create branches, commit code, or handle merge conflicts. Requires valid repository access and permissions to create PRs.", + "examples": [ + "Create a PR to merge 'feature/login' into 'main' with title 'Add login functionality' including reviewers alice and bob.", + "Open a PR to merge 'bugfix/issue-123' into 'develop' with description and labels 'bug' and 'urgent'.", + "Generate pull request for repository user/repo from branch 'hotfix' to 'master' with no reviewers or labels." + ] + }, + "tags": [ + "pull request", + "git", + "repository", + "automation", + "code review", + "CI/CD" + ], + "examples": [ + { + "inputJson": "{\"repositoryOwner\":\"octocat\",\"repositoryName\":\"Hello-World\",\"sourceBranch\":\"feature/login\",\"targetBranch\":\"main\",\"title\":\"Add login functionality\",\"body\":\"Implemented OAuth2 login flow and updated tests.\",\"reviewers\":[\"alice\",\"bob\"],\"labels\":[\"feature\",\"authentication\"]}", + "description": "Create a pull request to merge the 'feature/login' branch into 'main' including reviewers and labels." + }, + { + "inputJson": "{\"repositoryOwner\":\"teamX\",\"repositoryName\":\"project-y\",\"sourceBranch\":\"bugfix/issue-123\",\"targetBranch\":\"develop\",\"title\":\"Fix issue 123\",\"body\":\"Fixes crash when input is empty.\",\"reviewers\":[],\"labels\":[\"bug\",\"urgent\"]}", + "description": "Open a PR for a bugfix branch targeting 'develop' branch with labels for priority but no reviewers." + }, + { + "inputJson": "{\"repositoryOwner\":\"user1\",\"repositoryName\":\"repo-sample\",\"sourceBranch\":\"hotfix\",\"targetBranch\":\"master\",\"title\":\"Hotfix critical bug\"}", + "description": "Generate a basic pull request with minimal inputs and no optional reviewers or labels." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "PullRequest", + "context": null + } + }, + { + "name": "web-development.buildCommit", + "description": "Creates a commit object in a version-controlled web development project by staging specified file changes, generating a commit message, and associating author and timestamp details. Accepts file paths and content changes, commit message, author info, and optional parent commit hash; outputs a structured commit object with unique ID and metadata.", + "category": "web-development", + "parameters": [ + { + "name": "filesChanged", + "type": "array", + "description": "Array of objects representing files changed, each with file path and new content or diff.", + "required": true, + "defaultValue": "" + }, + { + "name": "commitMessage", + "type": "string", + "description": "The descriptive message summarizing the commit's purpose and scope.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "The name of the author creating the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email address of the author for identification in the commit metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "parentCommitHash", + "type": "string", + "description": "Hash of the parent commit to link the commit in the repository history; optional for initial commits.", + "required": false, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp for the commit; defaults to current time if not provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object representing the created commit, including unique commit hash, committed files, message, author info, timestamp, and parent commit hash." + }, + "aiAgent": { + "useCase": "Use this tool when automating or assisting in version control operations during web development projects, to programmatically create commits that capture file changes with appropriate metadata. Helpful for CI/CD pipelines, automated code updates, or integrating development tools that manage source control.", + "limitations": "This tool does not perform actual repository storage or branch management; it only creates the commit object structure. It cannot push commits to remote repositories or resolve merge conflicts.", + "examples": [ + "Create a commit for updated CSS and HTML files with author 'Jane Doe' and message 'Fix header layout issues'.", + "Generate a commit object for initial commit with multiple JS source files and author info.", + "Build a commit including a specified parent commit hash for tracking history explicitly." + ] + }, + "tags": [ + "web-development", + "version-control", + "commit", + "automation", + "source-code", + "build", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"filesChanged\":[{\"filePath\":\"styles/main.css\",\"content\":\"body { margin: 0; }\"},{\"filePath\":\"index.html\",\"content\":\"Hello World\"}],\"commitMessage\":\"Initial commit with basic styles and index file\",\"authorName\":\"Alice Smith\",\"authorEmail\":\"alice@example.com\",\"timestamp\":\"2024-06-01T12:00:00Z\"}", + "description": "Create an initial commit with basic CSS and HTML files by author Alice Smith." + }, + { + "inputJson": "{\"filesChanged\":[{\"filePath\":\"app.js\",\"content\":\"console.log('Update');\"}],\"commitMessage\":\"Update app console log\",\"authorName\":\"Bob Lee\",\"authorEmail\":\"bob.lee@example.com\",\"parentCommitHash\":\"abc123def456\",\"timestamp\":\"2024-06-02T08:30:00Z\"}", + "description": "Create a commit updating app.js with reference to an existing parent commit hash." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Commit", + "context": null + } + }, + { + "name": "web-development.buildVariable", + "description": "Creates a JavaScript variable declaration string based on the specified variable name, type, initial value, and scope. Accepts inputs defining the variable's characteristics and produces a valid JavaScript variable declaration statement as output.", + "category": "web-development", + "parameters": [ + { + "name": "variableName", + "type": "string", + "description": "The name of the JavaScript variable to declare.", + "required": true, + "defaultValue": "" + }, + { + "name": "variableType", + "type": "string", + "description": "The data type of the variable (e.g., string, number, boolean, array, object). This is for validation and comment purposes as JavaScript is loosely typed.", + "required": false, + "defaultValue": "string" + }, + { + "name": "initialValue", + "type": "string", + "description": "The initial value to assign to the variable, as a string representation of the code.", + "required": false, + "defaultValue": "" + }, + { + "name": "scope", + "type": "string", + "description": "The scope keyword for the variable declaration: \"var\", \"let\", or \"const\".", + "required": false, + "defaultValue": "let" + }, + { + "name": "includeTypeComment", + "type": "boolean", + "description": "Whether to include a comment indicating the intended type of the variable above the declaration.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated JavaScript variable declaration code string under the key \"variableDeclaration\"." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate JavaScript variable declarations with specific names, values, and scopes for dynamic code generation or template building. It helps construct syntactically correct variable declarations respecting the scope and optionally including a type hint comment.", + "limitations": "This tool does not validate correctness of initialValue beyond basic insertion and does not enforce strict typing since JavaScript is dynamic. It does not generate complex value expressions automatically, only formats provided strings into declarations.", + "examples": [ + "Generate a const variable named apiEndpoint with initial value 'https://api.example.com'.", + "Create a let variable called count of type number without an initial value.", + "Build a var variable named settings that is an object initialized with an empty object literal." + ] + }, + "tags": [ + "javascript", + "variable", + "code-generation", + "web-development", + "scope", + "declaration", + "programming" + ], + "examples": [ + { + "inputJson": "{\"variableName\":\"userName\",\"variableType\":\"string\",\"initialValue\":\"'Alice'\",\"scope\":\"const\",\"includeTypeComment\":true}", + "description": "Declare a constant string variable named 'userName' initialized to 'Alice' with a type comment." + }, + { + "inputJson": "{\"variableName\":\"maxRetries\",\"variableType\":\"number\",\"initialValue\":\"5\",\"scope\":\"let\",\"includeTypeComment\":false}", + "description": "Declare a let variable named 'maxRetries' initialized to 5 without a type comment." + }, + { + "inputJson": "{\"variableName\":\"config\",\"variableType\":\"object\",\"initialValue\":\"{}\",\"scope\":\"var\",\"includeTypeComment\":true}", + "description": "Declare a var variable named 'config' initialized as an empty object with a type comment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Variable", + "context": null + } + }, + { + "name": "web-development.buildBranch", + "description": "Builds a new code branch in a Git repository with specified base branch and optional commit message. Accepts repository URL, branch name, base branch, and optional commit message. Clones the repo, creates the new branch from base, optionally commits preliminary changes, and pushes the branch. Returns success status and details of the created branch.", + "category": "web-development", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The URL of the Git repository where the branch will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "branchName", + "type": "string", + "description": "The name of the new branch to create in the repository.", + "required": true, + "defaultValue": "" + }, + { + "name": "baseBranch", + "type": "string", + "description": "The base branch name from which to create the new branch, e.g., 'main' or 'develop'.", + "required": false, + "defaultValue": "main" + }, + { + "name": "commitMessage", + "type": "string", + "description": "An optional commit message for an initial commit on the new branch. If empty, no commit is made.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the result status, branch information, and any error messages from the branch creation process." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the creation of a new feature or fix branch in a codebase, for example, before applying changes or running integration workflows. This helps in automating development workflows where branching and code isolation are needed.", + "limitations": "This tool cannot perform complex Git operations beyond branch creation and a single optional commit, nor can it resolve merge conflicts or interact with code hosting service APIs beyond Git cloning and pushing.", + "examples": [ + "Create a new feature branch 'feature/login' off 'develop' branch for upcoming login feature.", + "Create a hotfix branch 'hotfix/critical-bug' from 'main' and add an initial commit message.", + "Build a new experimental branch named 'experiment/ui-redesign' without any initial commit from 'main'." + ] + }, + "tags": [ + "git", + "branch", + "web-development", + "automation", + "code-management" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/repo.git\",\"branchName\":\"feature/login\",\"baseBranch\":\"develop\",\"commitMessage\":\"Initial commit for login feature branch\"}", + "description": "Create a new 'feature/login' branch from 'develop' with an initial commit message." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/repo.git\",\"branchName\":\"hotfix/critical-bug\",\"baseBranch\":\"main\",\"commitMessage\":\"Fix critical production bug\"}", + "description": "Create a hotfix branch from 'main' with a commit message describing the fix." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/repo.git\",\"branchName\":\"experiment/ui-redesign\",\"baseBranch\":\"main\",\"commitMessage\":\"\"}", + "description": "Create a new experimental branch from 'main' without any initial commit." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Branch", + "context": null + } + }, + { + "name": "web-development.buildConfig", + "description": "Generates a structured web application configuration file based on provided input parameters including environment settings, feature toggles, API endpoints, and build options. Accepts input as JSON objects and outputs a standardized configuration object ready for use in deployment or further development workflows.", + "category": "web-development", + "parameters": [ + { + "name": "environment", + "type": "string", + "description": "Target deployment environment name such as 'development', 'testing', or 'production'.", + "required": true, + "defaultValue": "" + }, + { + "name": "featureToggles", + "type": "object", + "description": "An object mapping feature names to boolean values to enable or disable features dynamically.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "apiEndpoints", + "type": "object", + "description": "Object defining base URLs or endpoints for various backend services used by the web application.", + "required": true, + "defaultValue": "" + }, + { + "name": "buildOptions", + "type": "object", + "description": "Compilation and bundling options such as minification, source maps generation, and target JavaScript version.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Specifies the output configuration format, e.g., 'json', 'yaml', or 'js'.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "A configuration object containing all specified settings merged and formatted per the selected output format, ready for web app consumption or deployment." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate or update web application configuration files for different environments or feature sets, especially to automate build and deployment pipelines. It ensures consistent, validated config output from structured input parameters, reducing manual errors in config management.", + "limitations": "Does not validate the semantic correctness of the input API endpoints or feature toggle logic beyond structure. Not intended to configure server or infrastructure settings outside web app config scope.", + "examples": [ + "Generate a production config enabling caching and analytics features with specific API endpoints.", + "Produce a development config with debugging build options and local backend URLs.", + "Create a testing config disabling experimental features and using mock API endpoints." + ] + }, + "tags": [ + "web", + "configuration", + "automation", + "build", + "deployment", + "frontend", + "settings" + ], + "examples": [ + { + "inputJson": "{\"environment\":\"production\",\"featureToggles\":{\"enableCache\":true,\"enableAnalytics\":true},\"apiEndpoints\":{\"userService\":\"https://api.example.com/users\",\"paymentService\":\"https://api.example.com/payments\"},\"buildOptions\":{\"minify\":true,\"sourceMaps\":false},\"outputFormat\":\"json\"}", + "description": "Generate a production config enabling cache and analytics features with specified stable API endpoints." + }, + { + "inputJson": "{\"environment\":\"development\",\"featureToggles\":{\"debugMode\":true},\"apiEndpoints\":{\"userService\":\"http://localhost:3000/users\",\"paymentService\":\"http://localhost:3000/payments\"},\"buildOptions\":{\"minify\":false,\"sourceMaps\":true},\"outputFormat\":\"js\"}", + "description": "Create a development config enabling debug mode with local API URLs and enabled source maps for easier debugging." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Config", + "context": null + } + }, + { + "name": "web-development.buildEndpoint", + "description": "Creates a complete backend API endpoint in Node.js Express framework based on specified parameters including HTTP method, route path, request validation schema, response data structure, and middleware options. Outputs generated endpoint code as a string ready for integration.", + "category": "web-development", + "parameters": [ + { + "name": "httpMethod", + "type": "string", + "description": "The HTTP method for the endpoint, e.g., GET, POST, PUT, DELETE.", + "required": true, + "defaultValue": "" + }, + { + "name": "routePath", + "type": "string", + "description": "The URL path for the endpoint, e.g., '/users/:id'.", + "required": true, + "defaultValue": "" + }, + { + "name": "requestSchema", + "type": "object", + "description": "JSON schema defining the expected request body structure for validation. Optional for GET requests.", + "required": false, + "defaultValue": "" + }, + { + "name": "responseSchema", + "type": "object", + "description": "JSON schema describing the shape and types of the response data returned by the endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "middlewares", + "type": "array", + "description": "Array of middleware function names (strings) to apply to the endpoint in order, e.g., ['authenticate', 'logRequest'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "asyncHandler", + "type": "boolean", + "description": "Flag indicating whether to wrap the endpoint handler in async function to support async/await operations.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'endpointCode' string with the full Express.js route handler code snippet implementing the endpoint with validation and middleware." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically generate boilerplate backend API endpoints in Node.js Express. Ideal in situations requiring rapid prototyping or augmenting existing codebases with standardized, validated HTTP route handlers. It enables generation of consistent endpoint code based on formal specification.", + "limitations": "This tool generates Express.js style endpoints in JavaScript only and assumes the user integrates them properly into their app. It does not create frontend code or handle database interaction logic beyond placeholders. Complex business logic must be added manually.", + "examples": [ + "Generate a POST /users endpoint validating required user creation data and returning the new user object.", + "Build a GET /products/:id endpoint with middleware for authentication and response schema defining product details.", + "Create a DELETE /orders/:orderId endpoint with async handler and logging middleware." + ] + }, + "tags": [ + "web-development", + "api", + "endpoint", + "express-js", + "nodejs", + "backend", + "code-generation" + ], + "examples": [ + { + "inputJson": "{\"httpMethod\":\"POST\",\"routePath\":\"/users\",\"requestSchema\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"email\":{\"type\":\"string\",\"format\":\"email\"}},\"required\":[\"name\",\"email\"]},\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"email\":{\"type\":\"string\"}},\"required\":[\"id\",\"name\",\"email\"]},\"middlewares\":[\"validateApiKey\"],\"asyncHandler\":true}", + "description": "Create a POST /users endpoint that validates input user data with middleware to check an API key, returning the created user object asynchronously." + }, + { + "inputJson": "{\"httpMethod\":\"GET\",\"routePath\":\"/products/:id\",\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"}},\"required\":[\"id\",\"name\",\"price\"]},\"middlewares\":[\"authenticateUser\",\"logRequest\"],\"asyncHandler\":false}", + "description": "Build a synchronous GET /products/:id endpoint with authentication and logging middleware, returning product details." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Endpoint", + "context": null + } + }, + { + "name": "web-development.buildComponent", + "description": "Generates a customizable web UI component based on specified framework, component type, props, and styles. Accepts configuration inputs and outputs self-contained code snippets in JavaScript or TypeScript, compatible with React, Vue, or Angular, ready for integration and further development.", + "category": "web-development", + "parameters": [ + { + "name": "framework", + "type": "string", + "description": "Target JavaScript framework for the component, e.g., react, vue, angular", + "required": true, + "defaultValue": "" + }, + { + "name": "componentType", + "type": "string", + "description": "Type of UI component to build, e.g., button, card, modal, input", + "required": true, + "defaultValue": "" + }, + { + "name": "componentName", + "type": "string", + "description": "The name to assign to the generated component", + "required": false, + "defaultValue": "CustomComponent" + }, + { + "name": "props", + "type": "object", + "description": "Key-value pairs defining props and their types to be included in the component", + "required": false, + "defaultValue": "{}" + }, + { + "name": "styles", + "type": "object", + "description": "CSS style definitions or classes to apply to the component elements", + "required": false, + "defaultValue": "{}" + }, + { + "name": "typescript", + "type": "boolean", + "description": "Whether to generate the component code in TypeScript (true) or plain JavaScript (false)", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeTests", + "type": "boolean", + "description": "Include boilerplate test file for the component (using Jest or preferred framework)", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated source code for the component and optionally associated files like styles and tests" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create reusable UI components quickly in popular JavaScript frameworks from specifications such as component type, props, and style. It is ideal for generating starter code for frontend development tasks, speeding up prototyping or scaffolding UI elements.", + "limitations": "This tool does not handle complex business logic, state management beyond basic props, or automatically generate responsive or accessible design compliance beyond simple styling. It cannot replace full component design or human review for UI/UX best practices.", + "examples": [ + "Generate a React button component named 'PrimaryButton' with props for 'label' (string) and 'onClick' (function), including basic styling and TypeScript support.", + "Build a Vue modal component with customizable title and visible props, without TypeScript.", + "Create an Angular input field component named 'SearchInput' with style classes and include a Jest test file." + ] + }, + "tags": [ + "web", + "component", + "UI", + "frontend", + "react", + "vue", + "angular", + "code-generation" + ], + "examples": [ + { + "inputJson": "{\"framework\":\"react\",\"componentType\":\"button\",\"componentName\":\"PrimaryButton\",\"props\":{\"label\":\"string\",\"onClick\":\"() => void\"},\"styles\":{\"backgroundColor\":\"blue\",\"color\":\"white\"},\"typescript\":true,\"includeTests\":true}", + "description": "Generate a TypeScript React button component named PrimaryButton with label and onClick props, styled with blue background and white text, including a test file." + }, + { + "inputJson": "{\"framework\":\"vue\",\"componentType\":\"modal\",\"componentName\":\"InfoModal\",\"props\":{\"title\":\"string\",\"isVisible\":\"boolean\"},\"styles\":{},\"typescript\":false,\"includeTests\":false}", + "description": "Generate a plain JavaScript Vue modal component InfoModal with title and visibility controlled by props, without additional styles or tests." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Component", + "context": null + } + }, + { + "name": "web-development.buildSchema", + "description": "Generates a JSON Schema definition based on user-provided structure specifications for website data models. Accepts an input object describing fields, types, and constraints, and produces a valid, comprehensive JSON Schema to validate data objects in web applications.", + "category": "web-development", + "parameters": [ + { + "name": "modelName", + "type": "string", + "description": "The name identifier of the data model or schema to build.", + "required": true, + "defaultValue": "" + }, + { + "name": "fields", + "type": "array", + "description": "An array of field descriptor objects defining each property with type, required flag, and constraints such as minLength, maxLength, format etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "additionalProperties", + "type": "boolean", + "description": "Whether to allow properties not specified in the schema fields. Defaults to false to enforce strict validation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "requiredFields", + "type": "array", + "description": "List of field names that must be present in the valid data object. Overrides field-level required flags.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON Schema object compliant with the JSON Schema Specification (draft-07 or later) representing the data model described by the input parameters." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate JSON Schema documents for validating website data structures, such as form inputs, API payloads, or configuration objects. It helps automate schema creation based on declarative field specifications, reducing manual coding errors and improving data integrity in web apps.", + "limitations": "This tool does not generate schemas for database-specific constraints or indexing. It focuses on JSON Schema specification for data validation and does not handle UI forms or code generation.", + "examples": [ + "Generate a JSON schema for a user profile with fields like name (string), email (string, format email), age (integer, minimum 0), and required fields name and email.", + "Create schema for a blog post object with title (string), content (string), tags (array of strings), and publishedAt (string, format date-time).", + "Build schema for an e-commerce product with id (string), price (number, minimum 0), description (string, optional), and stockCount (integer)." + ] + }, + "tags": [ + "web", + "schema", + "json-schema", + "validation", + "data-model", + "automation", + "input-validation" + ], + "examples": [ + { + "inputJson": "{\"modelName\":\"UserProfile\",\"fields\":[{\"name\":\"name\",\"type\":\"string\",\"required\":true},{\"name\":\"email\",\"type\":\"string\",\"format\":\"email\",\"required\":true},{\"name\":\"age\",\"type\":\"integer\",\"minimum\":0}],\"requiredFields\":[\"name\",\"email\"],\"additionalProperties\":false}", + "description": "Generate a JSON Schema for a user profile model with required name and email, and an optional age field." + }, + { + "inputJson": "{\"modelName\":\"BlogPost\",\"fields\":[{\"name\":\"title\",\"type\":\"string\",\"required\":true},{\"name\":\"content\",\"type\":\"string\",\"required\":true},{\"name\":\"tags\",\"type\":\"array\",\"items\":{\"type\":\"string\"},\"required\":false},{\"name\":\"publishedAt\",\"type\":\"string\",\"format\":\"date-time\",\"required\":false}],\"requiredFields\":[\"title\",\"content\"],\"additionalProperties\":false}", + "description": "Create a schema for a blog post object that requires title and content, with optional tags and publishedAt datetime." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Schema", + "context": null + } + }, + { + "name": "web-development.buildQuery", + "description": "Constructs a URL query string or structured query object based on input parameters for web requests. Accepts filters, sort orders, pagination settings, and field selections, then outputs an encoded query string or JSON object suitable for API calls or URL appending.", + "category": "web-development", + "parameters": [ + { + "name": "filters", + "type": "object", + "description": "Key-value pairs representing filter conditions, where values can be strings, numbers, or arrays for multi-values.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "sortBy", + "type": "string", + "description": "Field name to sort the results by (e.g., 'date', 'name').", + "required": false, + "defaultValue": "" + }, + { + "name": "sortOrder", + "type": "string", + "description": "Sort direction: 'asc' for ascending or 'desc' for descending.", + "required": false, + "defaultValue": "asc" + }, + { + "name": "page", + "type": "number", + "description": "Page number for paginated results, starting at 1.", + "required": false, + "defaultValue": "1" + }, + { + "name": "pageSize", + "type": "number", + "description": "Number of items per page for pagination.", + "required": false, + "defaultValue": "10" + }, + { + "name": "fields", + "type": "array", + "description": "Array of strings specifying which fields to include in the response.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "encode", + "type": "boolean", + "description": "If true, output is a URL-encoded query string; if false, output is a JSON query object.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing either the 'queryString' as a URL-encoded string when encode=true, or a 'queryObject' representing the structured query if encode=false." + }, + "aiAgent": { + "useCase": "Use this tool when needing to dynamically generate URL query strings or JSON query objects for API requests based on user input parameters such as filters, sorting, pagination, and selected fields. It helps construct standardized queries to interact with RESTful web services or build URLs for fetching data.", + "limitations": "Does not support complex nested logical operators like AND/OR groups or advanced GraphQL queries. Only handles simple flat filter objects and basic sorting and pagination.", + "examples": [ + "Build a URL query string to filter products by category and price range, sorted by price descending, with page 2 of 20 items per page.", + "Generate a JSON query object for an API call filtering users by status 'active' and selecting only 'id' and 'email' fields.", + "Create a query string for fetching posts with no filters but sorted by date ascending including fields 'title' and 'summary'." + ] + }, + "tags": [ + "web", + "query builder", + "URL encoding", + "API", + "pagination", + "filters", + "sorting" + ], + "examples": [ + { + "inputJson": "{\"filters\":{\"category\":\"books\",\"priceMax\":30},\"sortBy\":\"price\",\"sortOrder\":\"desc\",\"page\":2,\"pageSize\":20,\"fields\":[\"title\",\"author\",\"price\"],\"encode\":true}", + "description": "Generate a URL query string filtering books with max price 30, sorted by price descending, page 2, 20 items/page, including title, author, price fields." + }, + { + "inputJson": "{\"filters\":{\"status\":\"active\"},\"fields\":[\"id\",\"email\"],\"encode\":false}", + "description": "Build a JSON query object to filter active users and select only id and email fields." + }, + { + "inputJson": "{\"sortBy\":\"date\",\"sortOrder\":\"asc\",\"fields\":[\"title\",\"summary\"],\"encode\":true}", + "description": "Create a URL-encoded query string sorted by ascending date selecting title and summary fields, no filters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Query", + "context": null + } + }, + { + "name": "web-development.buildDependency", + "description": "This tool automates the process of building and bundling a specified JavaScript or CSS dependency for web projects. It accepts a dependency name and version, processes it by fetching the source from package registries, builds or bundles the code (optionally minifying and transpiling), and outputs a ready-to-use build artifact with metadata for integration.", + "category": "web-development", + "parameters": [ + { + "name": "dependencyName", + "type": "string", + "description": "The exact name of the dependency/package to build (e.g., react, lodash).", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "The specific version of the dependency to use. If empty, uses latest.", + "required": false, + "defaultValue": "" + }, + { + "name": "buildTools", + "type": "array", + "description": "An array specifying which build tools or bundlers to use (e.g., webpack, rollup, esbuild). Defaults to webpack if empty.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "minify", + "type": "boolean", + "description": "Whether to minify the output bundle. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "transpileTarget", + "type": "string", + "description": "Target environment for transpilation (e.g., es5, es6) to ensure compatibility. Empty means no transpilation.", + "required": false, + "defaultValue": "" + }, + { + "name": "entryFile", + "type": "string", + "description": "Custom entry file path within the dependency if different from default package main. Empty uses default.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the built artifact filename, path, size bytes, and metadata like dependency name and version used." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically prepare a dependency package for web projects, especially in scenarios requiring building from source with specific versions, bundling strategies, and optimization options like minification or transpilation for target environments.", + "limitations": "This tool does not resolve dependency conflicts or install dependencies in projects; it solely builds individual specified dependencies. It also requires internet access to fetch package sources and assumes standard package structures.", + "examples": [ + "Build the React library version 17.0.2 using webpack with minification enabled.", + "Bundle lodash latest version with esbuild targeting ES5 environment.", + "Build a CSS framework dependency with no minification and default build process." + ] + }, + "tags": [ + "build", + "dependency", + "web-development", + "bundling", + "minification", + "transpilation" + ], + "examples": [ + { + "inputJson": "{\"dependencyName\":\"react\",\"version\":\"17.0.2\",\"buildTools\":[\"webpack\"],\"minify\":true,\"transpileTarget\":\"es6\",\"entryFile\":\"\"}", + "description": "Build React 17.0.2 using webpack with minification and ES6 target." + }, + { + "inputJson": "{\"dependencyName\":\"lodash\",\"version\":\"\",\"buildTools\":[\"esbuild\"],\"minify\":false,\"transpileTarget\":\"es5\",\"entryFile\":\"\"}", + "description": "Build latest lodash using esbuild, no minification, transpile to ES5." + }, + { + "inputJson": "{\"dependencyName\":\"tailwindcss\",\"version\":\"3.1.0\",\"buildTools\":[],\"minify\":false,\"transpileTarget\":\"\",\"entryFile\":\"src/index.css\"}", + "description": "Build Tailwind CSS 3.1.0 with default build tool and custom entry CSS file, no minification." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Dependency", + "context": null + } + }, + { + "name": "web-development.buildModule", + "description": "Builds a reusable web development module by accepting source code files, configuration options, and dependencies, then compiles and bundles them into a distributable JavaScript module compatible with modern frontend frameworks or vanilla JS projects. Outputs the compiled module files and a manifest describing the module structure.", + "category": "web-development", + "parameters": [ + { + "name": "sourceFiles", + "type": "array", + "description": "Array of source code files (JavaScript/TypeScript/HTML/CSS) to include in the module, each as an object with filename and content", + "required": true, + "defaultValue": "" + }, + { + "name": "entryPoint", + "type": "string", + "description": "The main file (relative to sourceFiles) that serves as the module entry point", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The output module format: e.g., 'esm', 'cjs', or 'umd'", + "required": true, + "defaultValue": "esm" + }, + { + "name": "includeSourceMaps", + "type": "boolean", + "description": "Whether to generate source maps for debugging", + "required": false, + "defaultValue": "false" + }, + { + "name": "dependencies", + "type": "object", + "description": "A key-value map of external dependencies and their versions to include as peer dependencies", + "required": false, + "defaultValue": "{}" + }, + { + "name": "minify", + "type": "boolean", + "description": "Whether to minify the output code", + "required": false, + "defaultValue": "true" + }, + { + "name": "targetEnvironment", + "type": "string", + "description": "Target environment for the module, e.g., 'browser', 'node', or 'universal'", + "required": false, + "defaultValue": "browser" + } + ], + "returns": { + "type": "object", + "description": "An object containing the bundled module files keyed by filename and a manifest describing the module metadata and dependencies" + }, + "aiAgent": { + "useCase": "Use this tool when you need to automate the process of building a web development module from source files, manage dependencies, configure output format, and produce a ready-to-distribute package compatible with frontend applications or libraries. Ideal for generating reusable modular code components.", + "limitations": "Does not perform runtime testing or deployment; does not resolve complex dependency graphs beyond specified peers; input code correctness and syntax checking are outside its scope.", + "examples": [ + "Build a minified ES module from several JS and CSS files with source maps for a browser app.", + "Create a CommonJS module targeting Node environment with specified external dependencies.", + "Generate a UMD bundle without minification including source files with HTML and CSS assets." + ] + }, + "tags": [ + "web-development", + "module", + "build", + "frontend", + "bundling", + "js", + "typescript" + ], + "examples": [ + { + "inputJson": "{\"sourceFiles\":[{\"filename\":\"index.js\",\"content\":\"export function greet() { return 'Hello'; }\"},{\"filename\":\"style.css\",\"content\":\".greet { color: blue; }\"}],\"entryPoint\":\"index.js\",\"outputFormat\":\"esm\",\"includeSourceMaps\":true,\"dependencies\":{},\"minify\":true,\"targetEnvironment\":\"browser\"}", + "description": "Builds an ES module with source code and CSS, including source maps, minified for browser use." + }, + { + "inputJson": "{\"sourceFiles\":[{\"filename\":\"main.ts\",\"content\":\"export const pi = 3.14;\"}],\"entryPoint\":\"main.ts\",\"outputFormat\":\"cjs\",\"includeSourceMaps\":false,\"dependencies\":{\"lodash\":\"^4.17.21\"},\"minify\":true,\"targetEnvironment\":\"node\"}", + "description": "Creates a CommonJS module in Node.js targeting environment with lodash as external dependency." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Module", + "context": null + } + }, + { + "name": "web-development.buildFunction", + "description": "Generates a JavaScript function code snippet based on specified name, parameters, body logic, and style options. It accepts the function name, list of parameter names, function body as code string, and an optional style for output format ('declaration' or 'arrow'). It outputs a well-formatted JavaScript function string that can be inserted into projects or further customized.", + "category": "web-development", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The name of the function to create (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "parameters", + "type": "array", + "description": "Array of parameter names for the function (optional, default empty)", + "required": false, + "defaultValue": "[]" + }, + { + "name": "functionBody", + "type": "string", + "description": "JavaScript code to be used as the function's executable body (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Defines format of function code: 'declaration' for function declaration or 'arrow' for arrow function (optional; default 'declaration')", + "required": false, + "defaultValue": "\"declaration\"" + }, + { + "name": "useStrict", + "type": "boolean", + "description": "Whether to add 'use strict' directive at the start of the function body (optional; default false)", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated JavaScript function code as a string under 'functionCode' key" + }, + "aiAgent": { + "useCase": "Use this tool to programmatically generate reusable JavaScript functions tailored to specified signatures and logic, facilitating automated code scaffolding in web development workflows, templates, or code synthesis scenarios.", + "limitations": "This tool does not validate syntax correctness of the provided function body code or perform static analysis; it only formats code structure based on inputs.", + "examples": [ + "Create a function named 'sum' with parameters ['a','b'] that returns their addition.", + "Generate an arrow function 'greet' that accepts one parameter 'name' and returns a greeting string.", + "Build a 'multiply' function with parameters ['x','y'] including 'use strict' directive in the body." + ] + }, + "tags": [ + "web", + "javascript", + "function", + "code-generation", + "template", + "scaffolding" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"sum\",\"parameters\":[\"a\",\"b\"],\"functionBody\":\"return a + b;\",\"style\":\"declaration\",\"useStrict\":false}", + "description": "Generate a traditional function declaration named 'sum' that adds two numbers." + }, + { + "inputJson": "{\"functionName\":\"greet\",\"parameters\":[\"name\"],\"functionBody\":\"return `Hello, ${name}!`;\",", + "description": "Create an arrow function 'greet' that returns a greeting message." + }, + { + "inputJson": "{\"functionName\":\"multiply\",\"parameters\":[\"x\",\"y\"],\"functionBody\":\"'use strict';\\nreturn x * y;\",\"style\":\"declaration\",\"useStrict\":true}", + "description": "Build a function 'multiply' that multiplies two values including 'use strict' directive." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "web-development.buildAPI", + "description": "Generates a RESTful API server skeleton based on user-supplied specifications including endpoints, HTTP methods, request/response schemas, and authentication options. Takes JSON describing API design and outputs ready-to-run server code in Node.js/Express with basic validation and routing setup.", + "category": "web-development", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "The name of the API being built, used as project title and namespace.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "An array of endpoint definitions, each including path, HTTP method, request and response schemas, and optional auth requirements.", + "required": true, + "defaultValue": "" + }, + { + "name": "authentication", + "type": "object", + "description": "Optional authentication configuration (type, e.g., jwt or none, and related settings).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "databaseSupport", + "type": "boolean", + "description": "Whether to include basic database connection scaffolding (e.g., MongoDB integration).", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Programming language/framework for the generated API server (default is Node.js with Express).", + "required": false, + "defaultValue": "nodejs-express" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated API server source code files mapped by filename, including routes, controllers, and configuration files ready for deployment." + }, + "aiAgent": { + "useCase": "Use this tool when a user needs to quickly scaffold a RESTful API with specified endpoints without manual coding, enabling rapid prototyping or starting point for development. Particularly useful when endpoint details and schema specs are known and a Node.js/Express backend is desired.", + "limitations": "This tool does not implement complex business logic or advanced data validation beyond basic schema checks. It assumes standard REST conventions and is limited to the specified framework and language. It cannot deploy or host the generated code.", + "examples": [ + "Generate an API for managing books with GET/post endpoints including JSON schemas.", + "Build a user management API with JWT authentication and CRUD endpoints.", + "Scaffold a simple product catalog API without authentication." + ] + }, + "tags": [ + "api", + "web-development", + "rest", + "nodejs", + "express", + "scaffolding", + "backend", + "automation" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"BookStoreAPI\",\"endpoints\":[{\"path\":\"/books\",\"method\":\"GET\",\"requestSchema\":{},\"responseSchema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"title\":{\"type\":\"string\"},\"author\":{\"type\":\"string\"}}}},\"authenticationRequired\":false},{\"path\":\"/books\",\"method\":\"POST\",\"requestSchema\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"},\"author\":{\"type\":\"string\"}}},\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"}}},\"authenticationRequired\":true}],\"authentication\":{\"type\":\"jwt\"},\"databaseSupport\":true}", + "description": "Generate a book management API with GET and POST endpoints, JWT authentication, and MongoDB support." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "API", + "context": null + } + }, + { + "name": "web-development.buildMigration", + "description": "Generates database migration scripts for web applications based on schema changes provided as input. Accepts current and target database schema definitions and outputs incremental migration code in SQL or a selected migration framework format.", + "category": "web-development", + "parameters": [ + { + "name": "currentSchema", + "type": "object", + "description": "Current database schema represented as a JSON object detailing tables, columns, types, and constraints.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetSchema", + "type": "object", + "description": "Desired target database schema represented as JSON, indicating intended changes compared to current schema.", + "required": true, + "defaultValue": "" + }, + { + "name": "databaseType", + "type": "string", + "description": "Type of database for targeted migration scripts (e.g., 'PostgreSQL', 'MySQL', 'SQLite').", + "required": true, + "defaultValue": "PostgreSQL" + }, + { + "name": "migrationFramework", + "type": "string", + "description": "Optional migration tooling format for output scripts (e.g., 'Knex', 'TypeORM', 'Sequelize'). If empty, outputs raw SQL.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeRollback", + "type": "boolean", + "description": "Flag specifying if rollback migration scripts should be generated alongside forward migrations.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Structured output containing the migration script code as a string, optionally both forward and rollback scripts, and metadata about the migration steps." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automate the creation of database migration scripts for web applications after schema changes. It helps developers generate safe, incremental migration SQL or framework-specific scripts to update database schemas without manual script writing.", + "limitations": "This tool does not validate the runtime environment or perform database state verification. Complex schema conflicts or manual intervention for data migrations beyond schema changes are not handled.", + "examples": [ + "Generate migration SQL from an old schema to a new schema for a PostgreSQL database.", + "Create migration scripts using Knex format including rollback scripts for schema evolution.", + "Produce raw SQL migrations for a MySQL database without rollback scripts." + ] + }, + "tags": [ + "database", + "migration", + "web-development", + "schema", + "automation", + "SQL", + "code-generation" + ], + "examples": [ + { + "inputJson": "{\"currentSchema\":{\"tables\":{\"users\":{\"columns\":{\"id\":{\"type\":\"integer\",\"primaryKey\":true},\"name\":{\"type\":\"string\",\"nullable\":false}}}}},\"targetSchema\":{\"tables\":{\"users\":{\"columns\":{\"id\":{\"type\":\"integer\",\"primaryKey\":true},\"name\":{\"type\":\"string\",\"nullable\":false},\"email\":{\"type\":\"string\",\"nullable\":true}}}}},\"databaseType\":\"PostgreSQL\",\"migrationFramework\":\"\",\"includeRollback\":true}", + "description": "Create SQL migration scripts to add an optional 'email' column to the 'users' table, including rollback script for PostgreSQL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Migration", + "context": null + } + }, + { + "name": "web-development.buildTest", + "description": "Generates automated test code for a specified web development component or function. Accepts details of the component, preferred test framework, and test cases, then produces runnable test scripts in the chosen framework format to verify component behavior.", + "category": "web-development", + "parameters": [ + { + "name": "componentName", + "type": "string", + "description": "Name of the component or module to generate tests for.", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "The testing framework to use (e.g., Jest, Mocha, Jasmine).", + "required": true, + "defaultValue": "Jest" + }, + { + "name": "testCases", + "type": "array", + "description": "Array of test case objects describing input conditions and expected outputs.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the component and test (e.g., JavaScript, TypeScript).", + "required": false, + "defaultValue": "JavaScript" + }, + { + "name": "includeSetupTeardown", + "type": "boolean", + "description": "Whether to include setup and teardown hooks in the generated test code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated test code as a string and metadata such as language and framework used." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create automated tests for a web component or function, especially to accelerate unit test writing by providing structured test cases and preferred frameworks. It helps streamline test generation for faster development cycles.", + "limitations": "The tool cannot infer component behavior without explicit test case specifications and does not execute tests or perform test validation; it only generates test code based on input descriptions.", + "examples": [ + "Generate Jest unit tests for a React button component given input events and expected outputs.", + "Create Mocha tests for a backend API request handler with specified input and expected responses.", + "Build Jasmine tests for a utility function with various edge case inputs." + ] + }, + "tags": [ + "testing", + "automation", + "web-development", + "unit-test", + "test-generation" + ], + "examples": [ + { + "inputJson": "{\"componentName\":\"LoginForm\",\"testFramework\":\"Jest\",\"testCases\":[{\"description\":\"renders input fields\",\"input\":null,\"expected\":\"input fields present\"},{\"description\":\"submits form with valid data\",\"input\":{\"username\":\"user\",\"password\":\"pass\"},\"expected\":\"calls onSubmit handler\"}],\"language\":\"JavaScript\",\"includeSetupTeardown\":true}", + "description": "Generate Jest tests for LoginForm component verifying UI elements and submit behavior." + }, + { + "inputJson": "{\"componentName\":\"apiHandler\",\"testFramework\":\"Mocha\",\"testCases\":[{\"description\":\"responds with 200 status\",\"input\":{\"requestType\":\"GET\"},\"expected\":{\"status\":200}}],\"language\":\"JavaScript\",\"includeSetupTeardown\":false}", + "description": "Create Mocha tests for an API handler that expects GET requests and returns status 200." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Test", + "context": null + } + }, + { + "name": "web-development.buildCode", + "description": "This tool accepts specifications for a website or web application in the form of a structured object describing pages, components, styles, and behaviors. It processes these inputs to generate clean, modular front-end source code in HTML, CSS, and JavaScript or frameworks like React. The output includes ready-to-use code files and a summary of generated assets.", + "category": "web-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the web project or application to generate code for.", + "required": true, + "defaultValue": "" + }, + { + "name": "pages", + "type": "array", + "description": "An array of page definitions including layout, content, and components to be included on each page.", + "required": true, + "defaultValue": "" + }, + { + "name": "styles", + "type": "object", + "description": "Styling guidelines or theme definitions such as colors, fonts, and spacing to apply globally or per component.", + "required": false, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "Target front-end framework or library to use for code generation, e.g., 'vanilla', 'react', 'vue'.", + "required": false, + "defaultValue": "vanilla" + }, + { + "name": "includeRouting", + "type": "boolean", + "description": "Whether to generate routing/navigation code for multi-page or single page applications.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Specify preferred output format such as 'file-zip' (default), 'folder-structure' or 'inline-code'.", + "required": false, + "defaultValue": "file-zip" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated source code files structured by filenames and content. May include metadata such as file count, total size in bytes, and a summary report." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically generate foundational front-end web code from high-level project and design specifications, speeding up prototyping or initial development stages. Ideal for scenarios where detailed UI/UX components and pages are described and code scaffolding is desired in popular frameworks.", + "limitations": "The tool cannot generate backend/server-side code, complex state management logic beyond basic patterns, or handle highly custom interactive behaviors without detailed specification.", + "examples": [ + "Generate a multi-page React website code base with given pages and global styles.", + "Build static HTML/CSS/JS frontend code for a simple marketing website.", + "Create a Vue.js SPA code structure with routing and styled components based on provided specs." + ] + }, + "tags": [ + "web", + "code-generation", + "frontend", + "scaffolding", + "react", + "vue", + "html", + "css", + "javascript" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"PortfolioSite\",\"pages\":[{\"name\":\"Home\",\"components\":[{\"type\":\"Header\"},{\"type\":\"Gallery\"},{\"type\":\"ContactForm\"}]},{\"name\":\"About\",\"components\":[{\"type\":\"TextSection\"}]}],\"styles\":{\"primaryColor\":\"#3498db\",\"fontFamily\":\"Arial, sans-serif\"},\"framework\":\"react\",\"includeRouting\":true,\"outputFormat\":\"file-zip\"}", + "description": "Generate React code for a portfolio site with Home and About pages, including components and global styles." + }, + { + "inputJson": "{\"projectName\":\"LandingPage\",\"pages\":[{\"name\":\"Main\",\"components\":[{\"type\":\"HeroSection\"},{\"type\":\"FeaturesList\"},{\"type\":\"SignupForm\"}]}],\"styles\":{\"primaryColor\":\"#e74c3c\",\"fontFamily\":\"Helvetica, sans-serif\"},\"framework\":\"vanilla\",\"includeRouting\":false,\"outputFormat\":\"inline-code\"}", + "description": "Build static vanilla HTML/CSS/JS for a single landing page with hero, features, and signup form components." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "build", + "object": "Code", + "context": null + } + }, + { + "name": "web-development.createReference", + "description": "Generates standardized web references (e.g., bibliography or resource citations) based on provided source details. Accepts metadata like author, title, URL, access date, and formats the reference according to common citation styles (APA, MLA, Chicago). Outputs formatted citation string suitable for embedding in web content or documentation.", + "category": "web-development", + "parameters": [ + { + "name": "sourceType", + "type": "string", + "description": "Type of source being referenced (e.g., website, article, book).", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Author or creator of the source (person or organization).", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the content or resource being referenced.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the source was published or released.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of the source if it is an online resource.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the source was accessed (ISO format recommended).", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format the reference (e.g., APA, MLA, Chicago).", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string in the chosen style, ready for inclusion in web pages or documentation, plus metadata about the citation style used." + }, + "aiAgent": { + "useCase": "Use when generating properly formatted reference citations for web-based documents or websites, especially when sourcing external information that requires crediting with standard citation formats.", + "limitations": "Does not fetch or validate source metadata automatically; requires accurate input. Limited to common citation formats and source types; may not support highly specialized or rare citation needs.", + "examples": [ + "Create an APA citation for a web article authored by Jane Doe, accessed on 2023-05-10.", + "Format a MLA style reference for a company website with no specified author.", + "Generate a Chicago style citation for an online book published in 2020 with a known author." + ] + }, + "tags": [ + "web-development", + "reference", + "citation", + "bibliography", + "content-creation", + "documentation", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"sourceType\":\"website\",\"author\":\"John Smith\",\"title\":\"Understanding Web Development\",\"publicationYear\":2022,\"url\":\"https://example.com/webdev\",\"accessDate\":\"2023-04-01\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA formatted citation for a website article with known author and access date." + }, + { + "inputJson": "{\"sourceType\":\"book\",\"author\":\"Emma Brown\",\"title\":\"Modern JavaScript\",\"publicationYear\":2019,\"citationStyle\":\"Chicago\"}", + "description": "Create a Chicago style reference for a published book with author and year." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reference", + "context": null + } + }, + { + "name": "web-development.createQuote", + "description": "Generates an HTML snippet for displaying a styled quote on a website. Accepts quote text, author, optional citation URL, and styling options like font style and alignment. Outputs a ready-to-insert HTML string representing the formatted quote block.", + "category": "web-development", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The main content of the quote to be displayed.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the person who said the quote.", + "required": true, + "defaultValue": "" + }, + { + "name": "citationUrl", + "type": "string", + "description": "Optional URL to link the author's name or provide source of the quote.", + "required": false, + "defaultValue": "" + }, + { + "name": "fontStyle", + "type": "string", + "description": "CSS font style to apply to the quote text (e.g., italic, normal).", + "required": false, + "defaultValue": "italic" + }, + { + "name": "textAlign", + "type": "string", + "description": "Text alignment for the quote block: left, center, or right.", + "required": false, + "defaultValue": "left" + }, + { + "name": "includeQuoteMarks", + "type": "boolean", + "description": "Whether to enclose the quote text in quotation marks.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Object containing a single property 'html' with the generated HTML quote block as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a visually formatted quote section as HTML for embedding into web pages or blog posts, including proper attribution and optional styling. It's helpful for dynamically generating quotes with consistent styling in web development tasks.", + "limitations": "Does not generate image-based quotes or advanced interactive elements; purely creates styled HTML text blocks. It requires valid input strings and does not validate URLs beyond presence.", + "examples": [ + "Create a centered italicized quote with author linked to a source URL.", + "Generate a left-aligned quote block without quotation marks for a testimonial section.", + "Produce a quote snippet with default styles and no citation link." + ] + }, + "tags": [ + "quote", + "html", + "web-development", + "content-creation", + "styling" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"The only limit to our realization of tomorrow is our doubts of today.\",\"author\":\"Franklin D. Roosevelt\",\"citationUrl\":\"https://www.fdrlibrary.org/\"}", + "description": "A classic inspirational quote with author linked to an external URL." + }, + { + "inputJson": "{\"quoteText\":\"Simplicity is the ultimate sophistication.\",\"author\":\"Leonardo da Vinci\",\"textAlign\":\"center\",\"fontStyle\":\"normal\",\"includeQuoteMarks\":false}", + "description": "Centered, normal font style quote without quotation marks for a minimalist web design." + }, + { + "inputJson": "{\"quoteText\":\"Code is like humor. When you have to explain it, it’s bad.\",\"author\":\"Cory House\"}", + "description": "Default styled quote with author and no citation link." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Quote", + "context": null + } + }, + { + "name": "web-development.createLink", + "description": "Generates an HTML anchor element () string based on provided parameters, including URL, display text, optional target, rel attributes, CSS classes, and accessibility attributes. Accepts parameters to customize the link output for embedding directly into web pages or HTML content.", + "category": "web-development", + "parameters": [ + { + "name": "href", + "type": "string", + "description": "The URL or link target for the anchor element. Must be a valid URL or relative path.", + "required": true, + "defaultValue": "" + }, + { + "name": "text", + "type": "string", + "description": "The visible text or content inside the link. HTML may be included if safe.", + "required": true, + "defaultValue": "" + }, + { + "name": "target", + "type": "string", + "description": "The target attribute specifying how to open the link, e.g., '_blank', '_self'. Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "rel", + "type": "string", + "description": "The rel attribute for relationship hints like 'noopener', 'nofollow'. Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "classNames", + "type": "array", + "description": "An array of CSS class names to apply to the anchor element for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "ariaLabel", + "type": "string", + "description": "Optional ARIA label attribute to improve accessibility, providing an accessible name.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated HTML string for the anchor element under the key 'html'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate a customized HTML link string to embed in web pages, emails, or other HTML content. It is ideal for generating links with specific targets, accessibility attributes, and styling classes without manually writing HTML each time.", + "limitations": "This tool does not validate URL safety or sanitize input to prevent XSS; ensure inputs are trusted or sanitized externally. It also does not support generating complex link content such as nested elements beyond the provided text string.", + "examples": [ + "Create a link to 'https://example.com' with text 'Visit Example' opening in a new tab.", + "Generate a link with CSS classes 'btn' and 'btn-primary' for styling.", + "Create an accessible link with aria-label 'Read more about topics'." + ] + }, + "tags": [ + "web", + "html", + "link", + "anchor", + "generator", + "accessibility", + "css", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"href\":\"https://example.com\",\"text\":\"Visit Example\",\"target\":\"_blank\",\"rel\":\"noopener noreferrer\",\"classNames\":[\"btn\",\"btn-primary\"],\"ariaLabel\":\"Visit Example Website\"}", + "description": "Creates an external link to example.com that opens in a new tab, includes security rel attributes, styled with CSS classes, and accessibility label." + }, + { + "inputJson": "{\"href\":\"/about\",\"text\":\"About Us\",\"classNames\":[\"nav-link\"]}", + "description": "Creates a relative link to the About page with a CSS class for navigation link styling." + }, + { + "inputJson": "{\"href\":\"mailto:info@example.com\",\"text\":\"Contact Us\",\"ariaLabel\":\"Send email to contact\"}", + "description": "Creates a mailto link to send an email with an ARIA label for accessibility." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Link", + "context": null + } + }, + { + "name": "web-development.createCitation", + "description": "Generates formatted citation text from given bibliographic details in various citation styles like APA, MLA, Chicago, and more. Accepts citation data such as author names, title, publication year, source type, and outputs a properly formatted citation string for website content inclusion.", + "category": "web-development", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of author names in 'Last, First' format.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work to be cited, such as article or book title.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the work was published.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source, e.g., 'book', 'article', 'website', 'conferencePaper'.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Publisher or organization responsible for the work. Optional for some source types.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of the source, used if sourceType is 'website' or online resource.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style format to apply: e.g., 'APA', 'MLA', 'Chicago'.", + "required": true, + "defaultValue": "APA" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the source was accessed (for online sources), in YYYY-MM-DD format.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single property 'citationText' containing the formatted citation as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate properly formatted bibliographic citations from structured bibliographic data to embed in web content, academic references, or documentation where correct citation format is required automatically. This helps maintain consistency and accuracy in citing various source types across multiple citation styles.", + "limitations": "Does not verify the accuracy of the bibliographic data entered and cannot generate citations from unstructured natural language input. It also does not support citation styles outside a predefined list and may not handle very rare or complex source types perfectly.", + "examples": [ + "Create an APA citation for a book authored by multiple authors published in 2019.", + "Generate an MLA citation for an online article with URL and access date.", + "Format a Chicago style citation for a conference paper with publisher details." + ] + }, + "tags": [ + "citation", + "web-development", + "formatting", + "bibliography", + "academic", + "reference" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Doe, John\",\"Smith, Jane\"],\"title\":\"Understanding AI Tools\",\"publicationYear\":2019,\"sourceType\":\"book\",\"publisher\":\"Tech Press\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA citation for a book with two authors published in 2019." + }, + { + "inputJson": "{\"authors\":[\"Williams, Sarah\"],\"title\":\"Open Web Sources and Their Impact\",\"publicationYear\":2021,\"sourceType\":\"website\",\"url\":\"https://example.com/article\",\"citationStyle\":\"MLA\",\"accessDate\":\"2024-04-20\"}", + "description": "Create an MLA citation for an online article including URL and access date." + }, + { + "inputJson": "{\"authors\":[\"Johnson, Mark\"],\"title\":\"Next-Gen Web Frameworks\",\"publicationYear\":2022,\"sourceType\":\"conferencePaper\",\"publisher\":\"International Web Conf\",\"citationStyle\":\"Chicago\"}", + "description": "Format a Chicago style citation for a conference paper with publisher details." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Citation", + "context": null + } + }, + { + "name": "web-development.createHeading", + "description": "Generates a semantic HTML heading element as a string. Accepts the heading level (h1-h6), the text content, an optional CSS class name or array of class names, and optional inline styles as a CSS string. Outputs a well-formed HTML heading tag with the specified attributes and content.", + "category": "web-development", + "parameters": [ + { + "name": "level", + "type": "number", + "description": "Heading level between 1 and 6 indicating h1 to h6 tags.", + "required": true, + "defaultValue": "" + }, + { + "name": "text", + "type": "string", + "description": "Text content to be placed inside the heading element.", + "required": true, + "defaultValue": "" + }, + { + "name": "className", + "type": "string", + "description": "Optional CSS class name(s) as a single string or space-separated list.", + "required": false, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Optional inline styles as a valid CSS string (e.g. 'color:red;font-weight:bold;').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string representing the complete HTML heading element with supplied level, content, class, and style." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate semantic HTML heading elements for webpages or templates, allowing customization of heading level, content, CSS classes, and inline styles. This is useful for dynamically assembled webpages where headings need to be created consistently and safely without manual HTML coding.", + "limitations": "It does not sanitize or escape the text content, so it should not be used with untrusted input without prior sanitization. It also does not support accessibility attributes like aria-label or id by default.", + "examples": [ + "Create a main title heading level 1 with custom CSS class.", + "Generate a subheading level 3 with inline style for color.", + "Produce a heading level 2 without any additional class or style." + ] + }, + "tags": [ + "web", + "html", + "heading", + "ui", + "content", + "frontend", + "templating" + ], + "examples": [ + { + "inputJson": "{\"level\":1,\"text\":\"Welcome to Our Site\",\"className\":\"main-title\",\"style\":\"color:#333; font-weight:bold;\"}", + "description": "Creates an H1 heading with text 'Welcome to Our Site', a class 'main-title', and inline styling for color and font weight." + }, + { + "inputJson": "{\"level\":3,\"text\":\"Features\",\"className\":\"features-subheading\",\"style\":\"color:blue;\"}", + "description": "Generates an H3 heading named 'Features' with a CSS class and blue colored text via inline style." + }, + { + "inputJson": "{\"level\":2,\"text\":\"Contact Us\",\"className\":\"\",\"style\":\"\"}", + "description": "Produces a simple H2 heading 'Contact Us' with no classes or styles." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Heading", + "context": null + } + }, + { + "name": "web-development.createWord", + "description": "Generates a single valid English word based on specified constraints such as length, starting or ending characters, and part of speech. Inputs include desired word length, optional prefix or suffix, and part of speech preference. Outputs a word string matching the criteria if found, suitable for content creation or dynamic web elements.", + "category": "web-development", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Desired length of the generated word; if zero or omitted, any length is acceptable.", + "required": false, + "defaultValue": "0" + }, + { + "name": "startsWith", + "type": "string", + "description": "Optional starting character(s) that the word should begin with.", + "required": false, + "defaultValue": "" + }, + { + "name": "endsWith", + "type": "string", + "description": "Optional ending character(s) that the word should end with.", + "required": false, + "defaultValue": "" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "Part of speech to filter the word by (e.g., noun, verb, adjective). Optional.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word string or an empty string if no match found, along with a success boolean." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate a valid English word that meets certain lexical or structural criteria for web content, such as placeholder text, creative naming, or user interface elements. It helps automate content generation with linguistic control.", + "limitations": "Cannot guarantee extremely rare or specialized vocabulary words; limited to standard English lexicon. Does not create new words or handle multiple languages.", + "examples": [ + "Generate a 5-letter adjective starting with 's'", + "Find a noun ending with 'ing'", + "Create any verb starting with 're' and length 6" + ] + }, + "tags": [ + "word", + "generation", + "content-creation", + "lexical", + "web-development" + ], + "examples": [ + { + "inputJson": "{\"length\":5,\"startsWith\":\"s\",\"partOfSpeech\":\"adjective\"}", + "description": "Generate a 5-letter adjective starting with 's'." + }, + { + "inputJson": "{\"endsWith\":\"ing\",\"partOfSpeech\":\"noun\"}", + "description": "Generate a noun ending with 'ing'." + }, + { + "inputJson": "{\"length\":6,\"startsWith\":\"re\",\"partOfSpeech\":\"verb\"}", + "description": "Create a 6-letter verb starting with 're'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "web-development.createConversion", + "description": "This tool creates a web conversion tracking event based on user-defined parameters such as event name, trigger conditions, and associated value. It accepts inputs describing the conversion action, trigger rules, and optional value metrics, and outputs a structured conversion tracking snippet or configuration object for integration into the website's analytics system.", + "category": "web-development", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the conversion event to track, e.g., 'Purchase' or 'SignUp'.", + "required": true, + "defaultValue": "" + }, + { + "name": "triggerType", + "type": "string", + "description": "The type of trigger for the conversion event, e.g., 'pageView', 'click', 'formSubmission'.", + "required": true, + "defaultValue": "" + }, + { + "name": "triggerSelector", + "type": "string", + "description": "A CSS selector or URL pattern to identify when the conversion event should be triggered.", + "required": false, + "defaultValue": "" + }, + { + "name": "conversionValue", + "type": "number", + "description": "Optional numeric value associated with the conversion, such as purchase amount.", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for the conversion value, e.g., 'USD'. Required if conversionValue is set.", + "required": false, + "defaultValue": "" + }, + { + "name": "sendTo", + "type": "string", + "description": "Identifier for the analytics platform or account to send the conversion data to (e.g., Google Ads ID).", + "required": true, + "defaultValue": "" + }, + { + "name": "isCustomEvent", + "type": "boolean", + "description": "Indicates if the conversion event is a custom event rather than a standard predefined one.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the conversion tracking configuration, including event name, trigger details, and tracking snippet for integration." + }, + "aiAgent": { + "useCase": "Use this tool when you need to set up or generate web conversion tracking events for analytics platforms based on specific user interactions or conditions on a web page. It is ideal for automating event creation for marketing campaigns or user behavior measurement.", + "limitations": "This tool does not integrate with analytics platforms directly; it generates configuration and snippets that must be manually or programmatically added to the website's codebase or tag manager. It cannot verify if the conversion tracking was successful or handle offline conversion imports.", + "examples": [ + "Create a conversion for tracking purchases on order confirmation page with purchase amount.", + "Set up a sign-up conversion triggered by form submission button click.", + "Generate a custom event conversion for users watching a video till the end." + ] + }, + "tags": [ + "web", + "analytics", + "conversion", + "tracking", + "event", + "marketing", + "user-behavior" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"Purchase\",\"triggerType\":\"pageView\",\"triggerSelector\":\"https://example.com/thank-you\",\"conversionValue\":99.99,\"currency\":\"USD\",\"sendTo\":\"AW-123456789\"}", + "description": "Track purchase conversions when users land on the thank you page with a value of 99.99 USD." + }, + { + "inputJson": "{\"eventName\":\"SignUp\",\"triggerType\":\"click\",\"triggerSelector\":\"#signup-button\",\"sendTo\":\"AW-123456789\"}", + "description": "Create a conversion event for when users click the sign-up button." + }, + { + "inputJson": "{\"eventName\":\"VideoComplete\",\"triggerType\":\"customEvent\",\"triggerSelector\":\"\",\"isCustomEvent\":true,\"sendTo\":\"AW-123456789\"}", + "description": "Setup a custom conversion event for video completion without a specific selector trigger." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Conversion", + "context": null + } + }, + { + "name": "web-development.createText", + "description": "Generates customizable text content suitable for websites based on specified parameters such as content type, length, tone, and topic. Inputs define the desired style and subject, and the tool outputs coherent, SEO-friendly textual content to be used in web pages, blogs, or marketing materials.", + "category": "web-development", + "parameters": [ + { + "name": "contentType", + "type": "string", + "description": "Type of text content to generate, e.g., 'paragraph', 'headline', 'list', or 'caption'.", + "required": true, + "defaultValue": "" + }, + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the generated text content.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate word count for the text output. Use 0 for flexible length.", + "required": false, + "defaultValue": "100" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the text such as 'formal', 'informal', 'friendly', 'professional', or 'persuasive'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords to be naturally integrated into the text for SEO purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the generated text, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text content as a string and metadata about the generation, including word count and content type." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to generate readable, structured text content for diverse website needs such as articles, product descriptions, or headings based on specific topics and tone preferences, facilitating quick content creation without manual writing.", + "limitations": "Cannot create highly specialized technical or legal documents requiring expert knowledge. It may not always accurately reflect current events or real-time data. Text generated may require human review for style consistency and factual accuracy.", + "examples": [ + "Generate a formal product description paragraph about eco-friendly water bottles with SEO keywords.", + "Create an engaging headline for a blog post about web development trends.", + "Produce a concise, friendly caption for a social media image about summer vacations." + ] + }, + "tags": [ + "web", + "text-generation", + "content-creation", + "seo", + "marketing", + "writing", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"contentType\":\"paragraph\",\"topic\":\"sustainable fashion\",\"length\":120,\"tone\":\"professional\",\"keywords\":[\"eco-friendly\",\"ethical\",\"clothing\"],\"language\":\"en\"}", + "description": "Generate a professional paragraph about sustainable fashion integrating given SEO keywords." + }, + { + "inputJson": "{\"contentType\":\"headline\",\"topic\":\"artificial intelligence breakthroughs\",\"length\":10,\"tone\":\"informal\",\"keywords\":[],\"language\":\"en\"}", + "description": "Create a short, informal headline about recent AI breakthroughs." + }, + { + "inputJson": "{\"contentType\":\"caption\",\"topic\":\"beach holiday\",\"length\":15,\"tone\":\"friendly\",\"keywords\":[],\"language\":\"en\"}", + "description": "Produce a friendly caption for a social media post about a beach holiday." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "web-development.createSentence", + "description": "Generates a grammatically correct, contextually appropriate English sentence based on specified content parameters such as topic, tone, and length. Accepts topic keywords, desired sentence length, and tone style, producing a coherent single sentence that can be used in web content or UI text.", + "category": "web-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or keywords the sentence should be about.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the sentence, e.g., formal, casual, friendly, professional.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "sentenceLength", + "type": "number", + "description": "Desired approximate sentence length in words.", + "required": false, + "defaultValue": "15" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action in the sentence if applicable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence as a string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate short, relevant sentences for web UI elements, marketing blurbs, tooltips, or onboarding instructions based on a specific topic and tone. It helps automate content creation for dynamic websites.", + "limitations": "Cannot generate multiple sentences or paragraphs; limited to English; may produce generic sentences that need review for brand voice consistency.", + "examples": [ + "Create a friendly sentence about user registration to greet new users.", + "Generate a formal sentence related to data security for a website header.", + "Make a short call-to-action sentence encouraging newsletter signups." + ] + }, + "tags": [ + "content generation", + "sentence creation", + "web writing", + "text generation", + "UI text" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"newsletter signup\",\"tone\":\"friendly\",\"sentenceLength\":12,\"includeCallToAction\":true}", + "description": "Generate a friendly, concise sentence encouraging newsletter signup with a call to action." + }, + { + "inputJson": "{\"topic\":\"data privacy\",\"tone\":\"formal\",\"sentenceLength\":15,\"includeCallToAction\":false}", + "description": "Create a formal, informative sentence about data privacy without a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Sentence", + "context": null + } + }, + { + "name": "web-development.createParagraph", + "description": "Creates a formatted HTML paragraph element string based on input text and optional styles and attributes. Accepts plain text content, optional CSS styles, CSS class names as an array, and additional HTML attributes as key-value pairs. Outputs a string representing a complete
Just a reminder about tomorrow's meeting at 10am.
Best regards,
BobHTML element with all applied configurations.", + "category": "web-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The textual content to be included inside the paragraph element, supports plain text.", + "required": true, + "defaultValue": "" + }, + { + "name": "styles", + "type": "object", + "description": "An optional object representing CSS style properties and their values to be applied inline to the paragraph.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "An optional array of CSS class names (strings) to assign to the paragraph element for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "attributes", + "type": "object", + "description": "Optional additional HTML attributes as key-value pairs to be added to the paragraph tag (e.g., id, data-* attributes).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string containing the fully constructed HTML
element with the provided text content, inline styles, class names, and additional attributes." + }, + "aiAgent": { + "useCase": "When an AI agent needs to dynamically generate HTML paragraph elements for web pages, including customizable text content, styling, CSS classes and extra attributes without manual HTML coding, it should use this tool to create valid and flexible paragraph elements as strings to embed in larger HTML documents or templates.", + "limitations": "This tool generates only paragraph (
) HTML elements; it does not sanitize or validate the text or attribute values for security (e.g., XSS protection) which should be handled externally.", + "examples": [ + "Create a paragraph with simple text \"Hello World\".", + "Create a paragraph with red text color and font size 14px.", + "Create a paragraph with class names ['intro','highlight'] and data-id attribute set to 'para1'." + ] + }, + "tags": [ + "web-development", + "html", + "paragraph", + "html-generation", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Hello World\"}", + "description": "Basic paragraph with plain text content." + }, + { + "inputJson": "{\"text\":\"Stylish text\",\"styles\":{\"color\":\"red\",\"fontSize\":\"14px\"}}", + "description": "Paragraph with inline styles to color text red and set font size." + }, + { + "inputJson": "{\"text\":\"Class and attrs\",\"cssClasses\":[\"intro\",\"highlight\"],\"attributes\":{\"id\":\"para1\",\"data-info\":\"sample\"}}", + "description": "Paragraph with multiple CSS classes and additional HTML attributes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "web-development.createSession", + "description": "Creates a new user analytics session for a website by accepting session metadata such as user agent, IP address, start timestamp, and optional custom attributes. It processes this data to initialize a session record and returns a unique session identifier and timestamps for tracking session duration and further analytic events.", + "category": "web-development", + "parameters": [ + { + "name": "userAgent", + "type": "string", + "description": "The user agent string from the user's browser to identify device and browser info.", + "required": true, + "defaultValue": "" + }, + { + "name": "ipAddress", + "type": "string", + "description": "The IP address of the user to track geographic or network info.", + "required": true, + "defaultValue": "" + }, + { + "name": "startTimestamp", + "type": "number", + "description": "The UNIX timestamp in milliseconds indicating when the session started.", + "required": false, + "defaultValue": "0" + }, + { + "name": "customAttributes", + "type": "object", + "description": "Optional custom key-value pairs to attach additional metadata to the session.", + "required": false, + "defaultValue": "" + }, + { + "name": "referrerUrl", + "type": "string", + "description": "The URL of the site that referred the user to this website, if any.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a unique session ID, the recorded start timestamp, and optionally metadata confirming stored custom attributes." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to start tracking a new user session for website analytics purposes, capturing essential session metadata for later event correlation or user behavior analysis.", + "limitations": "This tool does not handle event tracking within the session or session termination; those require separate tools or APIs.", + "examples": [ + "Create a session on user visit capturing user agent and IP.", + "Start a session that includes custom attributes like campaign source.", + "Initialize a session with a known start timestamp for backdated analytics." + ] + }, + "tags": [ + "session", + "analytics", + "web", + "tracking", + "user-experience", + "metrics" + ], + "examples": [ + { + "inputJson": "{\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64)\",\"ipAddress\":\"192.168.1.1\"}", + "description": "Basic session creation with required parameters userAgent and ipAddress." + }, + { + "inputJson": "{\"userAgent\":\"Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X)\",\"ipAddress\":\"203.0.113.5\",\"customAttributes\":{\"campaign\":\"spring_sale\",\"userType\":\"premium\"}}", + "description": "Create session including custom attributes to track marketing campaign and user type." + }, + { + "inputJson": "{\"userAgent\":\"Mozilla/5.0\",\"ipAddress\":\"198.51.100.23\",\"startTimestamp\":1685500000000,\"referrerUrl\":\"https://example.com\"}", + "description": "Session created with explicit start timestamp and referrer URL to track source attribution." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Session", + "context": null + } + }, + { + "name": "web-development.createDashboard", + "description": "Generates a customizable web analytics dashboard using provided configuration parameters. Accepts inputs such as data sources, visualization preferences, metrics to track, and display options. Processes these inputs to produce an interactive dashboard layout in JSON format, ready for integration into web applications.", + "category": "web-development", + "parameters": [ + { + "name": "dashboardName", + "type": "string", + "description": "The title or name for the dashboard being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "An array of objects specifying sources of data, including type (e.g., API, database), endpoint or connection string, and authentication details as needed.", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "A list of metric definitions to include on the dashboard, each specifying metric name, calculation method, and display label.", + "required": true, + "defaultValue": "" + }, + { + "name": "visualizations", + "type": "array", + "description": "Array defining the visual components (e.g., charts, tables) for displaying each metric, including chart type, layout position, and configuration options.", + "required": true, + "defaultValue": "" + }, + { + "name": "refreshInterval", + "type": "number", + "description": "Interval in seconds at which the dashboard data should refresh to show updated analytics.", + "required": false, + "defaultValue": "60" + }, + { + "name": "theme", + "type": "string", + "description": "UI theme name for the dashboard (e.g., light, dark) to control its visual style.", + "required": false, + "defaultValue": "light" + }, + { + "name": "responsive", + "type": "boolean", + "description": "Flag to enable responsive layout adapting to different screen sizes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the fully structured and configured dashboard, including metadata, layout, data source bindings, and visualization components." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a ready-to-use analytics dashboard configuration programmatically, based on user requirements for data sources, metrics, and visual styles, enabling quick setup of monitoring interfaces in web projects.", + "limitations": "This tool does not perform actual data fetching or rendering; it only creates the dashboard configuration schema. Integration with visualization libraries and data retrieval implementation must be handled separately.", + "examples": [ + "Create a sales performance dashboard with API data source and bar charts.", + "Generate a user engagement dashboard with multiple metrics and real-time refresh every 30 seconds.", + "Build a lightweight, mobile-friendly dashboard using dark theme and chart visualizations." + ] + }, + "tags": [ + "web", + "dashboard", + "analytics", + "visualization", + "configuration", + "responsive", + "theme" + ], + "examples": [ + { + "inputJson": "{\"dashboardName\":\"Sales Overview\",\"dataSources\":[{\"type\":\"API\",\"endpoint\":\"https://api.example.com/sales\",\"auth\":{\"token\":\"abcd1234\"}}],\"metrics\":[{\"name\":\"totalRevenue\",\"calculation\":\"sum\",\"label\":\"Total Revenue\"},{\"name\":\"ordersCount\",\"calculation\":\"count\",\"label\":\"Number of Orders\"}],\"visualizations\":[{\"metricName\":\"totalRevenue\",\"type\":\"barChart\",\"position\":{\"row\":1,\"column\":1}},{\"metricName\":\"ordersCount\",\"type\":\"lineChart\",\"position\":{\"row\":1,\"column\":2}}],\"refreshInterval\":120,\"theme\":\"light\",\"responsive\":true}", + "description": "Create a sales dashboard showing total revenue and order count with API data source, bar and line charts, refreshing every 2 minutes." + }, + { + "inputJson": "{\"dashboardName\":\"User Engagement\",\"dataSources\":[{\"type\":\"database\",\"connectionString\":\"Server=myServer;Database=analytics;User Id=admin;Password=pass;\"}],\"metrics\":[{\"name\":\"activeUsers\",\"calculation\":\"distinctCount\",\"label\":\"Active Users\"},{\"name\":\"sessionDuration\",\"calculation\":\"avg\",\"label\":\"Avg Session Duration\"}],\"visualizations\":[{\"metricName\":\"activeUsers\",\"type\":\"table\",\"position\":{\"row\":1,\"column\":1}},{\"metricName\":\"sessionDuration\",\"type\":\"pieChart\",\"position\":{\"row\":1,\"column\":2}}],\"refreshInterval\":30,\"theme\":\"dark\",\"responsive\":true}", + "description": "Generate a user engagement dashboard with metrics from database, including active users and session duration, with table and pie chart visualizations, refreshing every 30 seconds, in dark theme." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dashboard", + "context": null + } + }, + { + "name": "web-development.createKPI", + "description": "Creates a Key Performance Indicator (KPI) configuration for web analytics by accepting KPI name, description, associated metric, calculation formula, and target goal. Processes inputs to generate a structured KPI object ready for integration into analytics dashboards or reports.", + "category": "web-development", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The unique name of the KPI to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed description explaining the KPI and its purpose.", + "required": false, + "defaultValue": "" + }, + { + "name": "metric", + "type": "string", + "description": "The primary metric that this KPI measures (e.g., 'page views', 'conversion rate').", + "required": true, + "defaultValue": "" + }, + { + "name": "calculationFormula", + "type": "string", + "description": "Formula used to calculate the KPI from raw data metrics, expressed as a string (e.g., '(conversions / visits) * 100').", + "required": true, + "defaultValue": "" + }, + { + "name": "targetGoal", + "type": "number", + "description": "The numeric target value for this KPI to achieve, used for progress tracking.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeFrame", + "type": "string", + "description": "The time frame over which the KPI is measured (e.g., 'daily', 'monthly').", + "required": false, + "defaultValue": "monthly" + }, + { + "name": "tags", + "type": "array", + "description": "Array of strings representing tags or categories for the KPI.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A structured KPI object containing name, description, metric, formula, target goal, time frame, and tags. This object is ready for saving into analytics systems or dashboards." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to define or register new web analytics KPIs based on user input parameters, ensuring that KPIs are properly structured for tracking performance metrics on a website or web application. Useful for setting up dashboards or monitoring goals.", + "limitations": "This tool does not collect data or perform real-time analytics; it only creates the KPI definition object. The calculation formula must be provided as a string and is not automatically validated for syntax or correctness.", + "examples": [ + "Create a KPI to track daily conversion rate with target goal 5%.", + "Set up monthly page views KPI without a specific target goal.", + "Generate a KPI to measure bounce rate calculated as '(bounces / visits) * 100' with tags for user engagement." + ] + }, + "tags": [ + "web", + "analytics", + "KPI", + "dashboard", + "metrics", + "performance", + "definition" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"Daily Conversion Rate\",\"description\":\"Percentage of visitors converting daily.\",\"metric\":\"conversion rate\",\"calculationFormula\":\"(conversions / visits) * 100\",\"targetGoal\":5,\"timeFrame\":\"daily\",\"tags\":[\"conversion\",\"daily\",\"performance\"]}", + "description": "Create a KPI to track the daily conversion rate with a 5% target goal." + }, + { + "inputJson": "{\"kpiName\":\"Monthly Page Views\",\"metric\":\"page views\",\"calculationFormula\":\"pageViews\",\"timeFrame\":\"monthly\",\"tags\":[\"traffic\",\"monthly\"]}", + "description": "Set up a monthly KPI for total page views without a specific target goal." + }, + { + "inputJson": "{\"kpiName\":\"Bounce Rate\",\"description\":\"Percentage of single-page visits.\",\"metric\":\"bounce rate\",\"calculationFormula\":\"(bounces / visits) * 100\",\"tags\":[\"engagement\",\"bounce\"]}", + "description": "Generate a KPI to measure bounce rate with engagement tags but no target goal specified." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "web-development.createAnomaly", + "description": "Analyzes website analytics data (e.g., traffic, user behavior, performance metrics) over time to detect anomalies such as sudden spikes, drops, or unusual patterns. Accepts time-series data with configurable sensitivity and outputs detected anomaly events with timestamps, significance scores, and suggested causes when possible.", + "category": "web-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Time-series array of analytics data points, each containing a timestamp and associated metrics (e.g., page views, bounce rate).", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of metric names in the data to analyze for anomalies (e.g., ['pageViews', 'bounceRate']).", + "required": true, + "defaultValue": "" + }, + { + "name": "sensitivity", + "type": "number", + "description": "A number between 0 and 1 determining anomaly detection sensitivity; higher means more anomalies are detected.", + "required": false, + "defaultValue": "0.8" + }, + { + "name": "timeWindow", + "type": "string", + "description": "Time window over which to aggregate/analyze data (e.g., '1h', '1d').", + "required": false, + "defaultValue": "1h" + }, + { + "name": "seasonality", + "type": "boolean", + "description": "Indicates if the detection should account for seasonal patterns in the data (daily/weekly trends).", + "required": false, + "defaultValue": "true" + }, + { + "name": "minimumAnomalyScore", + "type": "number", + "description": "Minimum anomaly score threshold to report (0-1).", + "required": false, + "defaultValue": "0.5" + } + ], + "returns": { + "type": "object", + "description": "Object containing array of detected anomalies; each includes metric name, timestamp, anomaly score, and optionally a brief cause explanation." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically identify unusual or unexpected changes in web analytics metrics to alert site maintainers or enable automated responses. Ideal for monitoring user traffic, engagement, or performance issues that deviate from typical patterns.", + "limitations": "Cannot definitively explain root causes of anomalies or handle malformed/incomplete input data. Limited to metrics provided and detection configured parameters; false positives or negatives may occur.", + "examples": [ + "Detect anomalous traffic drops over past week for pageViews and bounceRate.", + "Identify sudden spikes in performance metrics during a marketing campaign.", + "Alert on unusual bounce rate patterns accounting for daily seasonality." + ] + }, + "tags": [ + "web", + "analytics", + "anomaly detection", + "monitoring", + "time-series" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-06-01T00:00:00Z\",\"pageViews\":1000,\"bounceRate\":0.55},{\"timestamp\":\"2024-06-01T01:00:00Z\",\"pageViews\":2500,\"bounceRate\":0.52},{\"timestamp\":\"2024-06-01T02:00:00Z\",\"pageViews\":1020,\"bounceRate\":0.54}],\"metrics\":[\"pageViews\",\"bounceRate\"],\"sensitivity\":0.9,\"timeWindow\":\"1h\",\"seasonality\":true,\"minimumAnomalyScore\":0.7}", + "description": "Analyze hourly pageViews and bounceRate data to find significant anomalies with high sensitivity and seasonality consideration." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Anomaly", + "context": null + } + }, + { + "name": "web-development.createEvent", + "description": "Creates a web analytics event object for tracking user interactions on a website. Accepts event name, category, action, optional label and value, timestamp, and custom properties. Outputs a structured event object ready for sending to analytics services or storing.", + "category": "web-development", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the event to be tracked (e.g., 'button_click').", + "required": true, + "defaultValue": "" + }, + { + "name": "eventCategory", + "type": "string", + "description": "The category of the event, representing a group of events (e.g., 'navigation').", + "required": true, + "defaultValue": "" + }, + { + "name": "eventAction", + "type": "string", + "description": "The specific action taken by the user (e.g., 'click').", + "required": true, + "defaultValue": "" + }, + { + "name": "eventLabel", + "type": "string", + "description": "An optional label providing additional information about the event (e.g., 'signup_button').", + "required": false, + "defaultValue": "" + }, + { + "name": "eventValue", + "type": "number", + "description": "An optional numeric value associated with the event (e.g., 1 for count or amount).", + "required": false, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "number", + "description": "The UNIX timestamp in milliseconds when the event occurred. Defaults to current time if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "customProperties", + "type": "object", + "description": "Optional key-value pairs for additional event metadata (e.g., {\"page\":\"homepage\"}).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured event object containing all provided event details, formatted for analytics tracking." + }, + "aiAgent": { + "useCase": "Use this tool when you need to construct a detailed event object representing user interactions on a website for analytics purposes. It helps standardize event data before sending to tracking services like Google Analytics or custom backends.", + "limitations": "This tool does not send or persist the event data. It only creates the event object; integration with tracking or storage systems must be handled separately.", + "examples": [ + "Create an event for a user clicking the signup button in the navigation menu.", + "Generate a purchase event with value and label to track revenue.", + "Record a video play event with custom properties about the video id and duration." + ] + }, + "tags": [ + "web", + "analytics", + "event", + "tracking", + "user-interaction", + "web-development", + "model" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"click\",\"eventCategory\":\"navigation\",\"eventAction\":\"button_click\",\"eventLabel\":\"signup_button\"}", + "description": "Create an event for a button click on the signup button in navigation." + }, + { + "inputJson": "{\"eventName\":\"purchase\",\"eventCategory\":\"ecommerce\",\"eventAction\":\"complete\",\"eventValue\":49.99,\"eventLabel\":\"order_12345\"}", + "description": "Create an event for a purchase completed with a dollar value and order label." + }, + { + "inputJson": "{\"eventName\":\"video_play\",\"eventCategory\":\"media\",\"eventAction\":\"play\",\"customProperties\":{\"videoId\":\"vid789\",\"duration\":300}}", + "description": "Create an event for a video play action including custom video metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "web-development.createTrend", + "description": "This tool analyzes website interaction data such as page views, user clicks, or session durations over a specified time range and generates actionable trend analytics. It accepts raw or aggregated web metrics, applies smoothing and comparison algorithms to identify positive or negative trends, seasonal patterns, and anomalies, and outputs a structured trend report with visualizable data points and key insights.", + "category": "web-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of objects representing web interaction records with timestamps and associated metrics (e.g., page views, clicks).", + "required": true, + "defaultValue": "" + }, + { + "name": "metric", + "type": "string", + "description": "The specific metric to analyze for trends, such as 'pageViews', 'clicks', or 'sessionDuration'.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "The ISO 8601 formatted date string indicating the start of the time range for trend analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "The ISO 8601 formatted date string marking the end of the time range for trend analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "granularity", + "type": "string", + "description": "Time granularity for aggregating data points such as 'hourly', 'daily', or 'weekly'.", + "required": false, + "defaultValue": "daily" + }, + { + "name": "applySmoothing", + "type": "boolean", + "description": "Whether to apply smoothing techniques to the data to reduce noise in trend detection.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeAnomalies", + "type": "boolean", + "description": "Whether to include detected anomalies in the trend report output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A detailed trend report containing an array of time series data points with timestamps and metric values, summary statistics describing trend direction and strength, identified seasonal patterns if any, and anomaly details when requested." + }, + "aiAgent": { + "useCase": "Use this tool to derive meaningful patterns and trends from raw or aggregated website interaction metrics, aiding website owners or developers in understanding user behavior changes over time, evaluating marketing impact, or optimizing web content and performance.", + "limitations": "This tool does not predict future trends beyond the input data range, nor does it process unstructured data formats; it requires input data to be properly structured and time-stamped.", + "examples": [ + "Analyze daily pageViews trend from 2024-01-01 to 2024-03-31 with smoothing and anomaly detection.", + "Generate weekly clicks trend report for last quarter without smoothing.", + "Evaluate sessionDuration hourly trend for a specific week with anomalies included." + ] + }, + "tags": [ + "web-development", + "analytics", + "trend-analysis", + "time-series", + "user-behavior", + "data-aggregation", + "website-metrics" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-01-01T00:00:00Z\",\"pageViews\":120},{\"timestamp\":\"2024-01-02T00:00:00Z\",\"pageViews\":135},{\"timestamp\":\"2024-01-03T00:00:00Z\",\"pageViews\":150}],\"metric\":\"pageViews\",\"startDate\":\"2024-01-01\",\"endDate\":\"2024-01-03\",\"granularity\":\"daily\",\"applySmoothing\":true,\"includeAnomalies\":false}", + "description": "Analyzing daily page views from Jan 1 to 3, 2024 with smoothing applied and anomaly detection off." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Trend", + "context": null + } + }, + { + "name": "web-development.createCache", + "description": "Creates and configures a caching layer for a web application. Accepts parameters defining cache type (memory, Redis, disk), TTL (time to live) for cached items, maximum cache size, and other options. Returns configuration details and a cache instance reference for integration into the web app stack.", + "category": "web-development", + "parameters": [ + { + "name": "cacheType", + "type": "string", + "description": "Type of cache to create, e.g., 'memory', 'redis', 'disk'.", + "required": true, + "defaultValue": "" + }, + { + "name": "ttlSeconds", + "type": "number", + "description": "Time to live for cache entries in seconds. Items expire after this time.", + "required": false, + "defaultValue": "3600" + }, + { + "name": "maxSize", + "type": "number", + "description": "Maximum number of items or total size (depending on cache type) allowed in the cache.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "redisConfig", + "type": "object", + "description": "Configuration object for Redis connection (host, port, password), required if cacheType='redis'.", + "required": false, + "defaultValue": "" + }, + { + "name": "persistToDisk", + "type": "boolean", + "description": "Indicates if the cache should persist data to disk (only applicable for disk cache type).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the cache instance reference, the effective configuration parameters, and status indicating readiness." + }, + "aiAgent": { + "useCase": "Use this tool when needing to add caching capabilities to a web application to improve performance and reduce database or API load. It is helpful when the agent must generate or modify cache layers dynamically based on app requirements or environment.", + "limitations": "This tool does not handle the internal caching logic beyond instantiation and configuration. It requires appropriate runtime environment support and connection access for cache backends like Redis. It does not perform cache eviction policies beyond configured parameters.", + "examples": [ + "Create an in-memory cache with 1-hour TTL and max size 500 items.", + "Create a Redis cache connected to a remote server with TTL 300 seconds.", + "Create a disk cache that persists data with max size 10000 items." + ] + }, + "tags": [ + "web", + "cache", + "performance", + "infrastructure", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"cacheType\":\"memory\",\"ttlSeconds\":3600,\"maxSize\":500}", + "description": "Create an in-memory cache with default TTL and a max size of 500 items." + }, + { + "inputJson": "{\"cacheType\":\"redis\",\"ttlSeconds\":300,\"redisConfig\":{\"host\":\"redis.example.com\",\"port\":6379,\"password\":\"s3cr3t\"}}", + "description": "Create a Redis cache connecting to a specified Redis host with 5-minute TTL." + }, + { + "inputJson": "{\"cacheType\":\"disk\",\"persistToDisk\":true,\"maxSize\":10000}", + "description": "Create a disk-based cache that persists data between restarts with a maximum of 10,000 entries." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cache", + "context": null + } + }, + { + "name": "web-development.createMetric", + "description": "Creates a customizable web analytics metric based on user-defined parameters including name, description, data source, calculation formula, and aggregation method. Accepts configuration inputs and outputs a fully defined metric object suitable for integration into web analytics dashboards or tracking systems.", + "category": "web-development", + "parameters": [ + { + "name": "metricName", + "type": "string", + "description": "The unique name identifier for the metric to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A brief explanation of what the metric measures and its purpose.", + "required": false, + "defaultValue": "" + }, + { + "name": "dataSource", + "type": "string", + "description": "The source dataset or event stream name from which metric data will be derived.", + "required": true, + "defaultValue": "" + }, + { + "name": "calculationFormula", + "type": "string", + "description": "A formula or expression defining how to compute the metric using data fields from the data source, e.g., 'sum(clicks)/sum(visits)'.", + "required": true, + "defaultValue": "" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "The aggregation method to apply, such as 'sum', 'average', 'count', or 'unique', to the calculation result.", + "required": true, + "defaultValue": "sum" + }, + { + "name": "timeGranularity", + "type": "string", + "description": "The time interval for metric aggregation, e.g., 'hourly', 'daily', or 'monthly'.", + "required": false, + "defaultValue": "daily" + }, + { + "name": "filters", + "type": "object", + "description": "Optional filter conditions to restrict data included in the metric calculation, structured as key-value pairs representing field and required value.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A metric object containing the configured name, description, data source, formula, aggregation method, and optional filters ready for use in analytics systems." + }, + "aiAgent": { + "useCase": "Use this tool when needing to define a new custom analytics metric for web data tracking, such as creating conversion rates, user engagement scores, or other KPIs that require specific calculation logic and aggregation preferences.", + "limitations": "The tool does not perform actual data fetching or calculations but only generates the metric definition; underlying analytics system must support applying the formula and aggregation to real data.", + "examples": [ + "Create a daily conversion rate metric based on clicks and visits.", + "Define a unique visitor count metric filtered by country=\"US\".", + "Set up an average session duration metric aggregated hourly." + ] + }, + "tags": [ + "web-development", + "analytics", + "metric-creation", + "custom-metrics", + "web-analytics", + "data-processing" + ], + "examples": [ + { + "inputJson": "{\"metricName\":\"conversionRate\",\"description\":\"Percentage of visitors who complete a purchase.\",\"dataSource\":\"userEvents\",\"calculationFormula\":\"sum(purchases)/sum(visits)\",\"aggregationMethod\":\"average\",\"timeGranularity\":\"daily\",\"filters\":{\"country\":\"US\"}}", + "description": "Create a daily conversion rate metric filtered for US visitors using average aggregation." + }, + { + "inputJson": "{\"metricName\":\"uniqueVisitors\",\"description\":\"Count of unique visitors to the site.\",\"dataSource\":\"pageViews\",\"calculationFormula\":\"countDistinct(userId)\",\"aggregationMethod\":\"count\",\"timeGranularity\":\"monthly\"}", + "description": "Define a monthly count of unique visitors metric without filters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Metric", + "context": null + } + }, + { + "name": "web-development.createCluster", + "description": "Creates and configures a scalable web server cluster for deploying web applications. Accepts configuration parameters such as number of servers, instance types, load balancer settings, and network configuration. Processes these inputs to provision and initialize the cluster infrastructure, then returns details about the created cluster including access endpoints and status.", + "category": "web-development", + "parameters": [ + { + "name": "clusterName", + "type": "string", + "description": "The unique name to identify the cluster.", + "required": true, + "defaultValue": "" + }, + { + "name": "serverCount", + "type": "number", + "description": "Number of web server instances to include in the cluster.", + "required": true, + "defaultValue": "3" + }, + { + "name": "instanceType", + "type": "string", + "description": "Type/specification of the server instances (e.g., t2.medium, n1-standard-2).", + "required": false, + "defaultValue": "t2.medium" + }, + { + "name": "loadBalancerType", + "type": "string", + "description": "Type of load balancer to deploy (e.g., application, network).", + "required": false, + "defaultValue": "application" + }, + { + "name": "region", + "type": "string", + "description": "Geographic region where the cluster should be deployed.", + "required": false, + "defaultValue": "us-east-1" + }, + { + "name": "autoScalingEnabled", + "type": "boolean", + "description": "Whether to enable auto-scaling for the cluster.", + "required": false, + "defaultValue": "true" + }, + { + "name": "networkConfig", + "type": "object", + "description": "Network configuration settings like VPC ID, subnets, and security groups.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing cluster identifier, list of server instance IDs, load balancer DNS name and status of deployment." + }, + "aiAgent": { + "useCase": "Use when an AI assistant needs to automate the provisioning of a web server environment, enabling deployment readiness and scalability for web applications. Ideal for scenarios requiring quick cluster setup with customizable server counts, instance types, and network parameters.", + "limitations": "Does not handle the deployment of application code or software inside the servers; it focuses on infrastructure creation only. Does not support creation beyond web server clusters (e.g., databases or caching layers).", + "examples": [ + "Create a 5-node cluster with t3.large instances in us-west-2 region and enable network load balancer.", + "Set up a minimal cluster with 2 servers and default load balancer in us-east-1 for a staging environment.", + "Build a scalable web server cluster with auto-scaling disabled in eu-central-1 region." + ] + }, + "tags": [ + "web-development", + "infrastructure", + "cluster", + "provisioning", + "automation", + "cloud", + "scalability" + ], + "examples": [ + { + "inputJson": "{\"clusterName\":\"prod-web-cluster\",\"serverCount\":5,\"instanceType\":\"t3.large\",\"loadBalancerType\":\"network\",\"region\":\"us-west-2\",\"autoScalingEnabled\":true}", + "description": "Create a 5-node cluster with t3.large instances in the us-west-2 region with a network load balancer and auto-scaling enabled." + }, + { + "inputJson": "{\"clusterName\":\"staging-cluster\",\"serverCount\":2}", + "description": "Create a minimal cluster with 2 default t2.medium instances and an application load balancer in the default region with auto-scaling enabled." + }, + { + "inputJson": "{\"clusterName\":\"eu-cluster\",\"serverCount\":4,\"autoScalingEnabled\":false,\"region\":\"eu-central-1\"}", + "description": "Set up a 4-node cluster without auto-scaling in the eu-central-1 region using default instance and load balancer settings." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cluster", + "context": null + } + }, + { + "name": "web-development.createQueue", + "description": "Creates and configures a message queue service for web applications. Accepts queue name, type, durability, max size, and optional access policies. Processes these inputs to set up a queue in the specified environment, returning its configuration details and status information.", + "category": "web-development", + "parameters": [ + { + "name": "queueName", + "type": "string", + "description": "Unique identifier for the queue.", + "required": true, + "defaultValue": "" + }, + { + "name": "queueType", + "type": "string", + "description": "Type of queue to create, e.g., 'standard' or 'fifo'.", + "required": false, + "defaultValue": "standard" + }, + { + "name": "durable", + "type": "boolean", + "description": "If true, the queue persists beyond server restarts.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxSizeMb", + "type": "number", + "description": "Maximum size of the queue in megabytes.", + "required": false, + "defaultValue": "1024" + }, + { + "name": "accessPolicies", + "type": "object", + "description": "Optional access control policies for the queue specifying permissions and roles.", + "required": false, + "defaultValue": "" + }, + { + "name": "environment", + "type": "string", + "description": "Deployment environment such as 'development', 'staging', or 'production'.", + "required": false, + "defaultValue": "production" + } + ], + "returns": { + "type": "object", + "description": "An object containing the queue configuration details including URL, ARN (if applicable), creation timestamp, and status." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically set up message queues for decoupling components in a web application architecture. It supports configuring queue properties like durability and size limits to suit different environments such as development or production.", + "limitations": "This tool does not handle message publishing or consumption; it only creates and configures the queue resource itself. It also depends on the underlying message queue infrastructure being available and accessible.", + "examples": [ + "Create a durable FIFO queue named 'orderProcessing' with a max size of 2048 MB for production environment.", + "Set up a standard queue called 'emailNotifications' with default settings for staging.", + "Create a non-durable queue with specific access policies for testing purposes." + ] + }, + "tags": [ + "web-development", + "queue", + "infrastructure", + "message-queue", + "async-processing", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"queueName\":\"orderProcessing\",\"queueType\":\"fifo\",\"durable\":true,\"maxSizeMb\":2048,\"environment\":\"production\"}", + "description": "Create a durable FIFO queue 'orderProcessing' with 2048 MB max size for production." + }, + { + "inputJson": "{\"queueName\":\"emailNotifications\"}", + "description": "Create a standard, durable queue 'emailNotifications' with default max size for production." + }, + { + "inputJson": "{\"queueName\":\"testQueue\",\"durable\":false,\"accessPolicies\":{\"roles\":[\"tester\"],\"permissions\":[\"send\",\"receive\"]}}", + "description": "Create a non-durable queue 'testQueue' with custom access policies for testing." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Queue", + "context": null + } + }, + { + "name": "web-development.createDatabase", + "description": "Creates a new database instance with specified type, name, and configuration settings. Accepts parameters defining the database type (e.g., MySQL, PostgreSQL), credentials, storage size, and optional initialization scripts. Returns connection details and status of creation.", + "category": "web-development", + "parameters": [ + { + "name": "databaseType", + "type": "string", + "description": "Type of the database to create (e.g., 'mysql', 'postgresql').", + "required": true, + "defaultValue": "" + }, + { + "name": "databaseName", + "type": "string", + "description": "Name of the new database to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "userName", + "type": "string", + "description": "Username for database access.", + "required": true, + "defaultValue": "" + }, + { + "name": "userPassword", + "type": "string", + "description": "Password for the database user.", + "required": true, + "defaultValue": "" + }, + { + "name": "storageSizeMB", + "type": "number", + "description": "Allocated storage size in megabytes for the database.", + "required": false, + "defaultValue": "100" + }, + { + "name": "initializeScripts", + "type": "array", + "description": "Array of SQL commands or file references to run immediately after database creation for initialization.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "host", + "type": "string", + "description": "Host address to deploy the database to; default is local server.", + "required": false, + "defaultValue": "localhost" + }, + { + "name": "port", + "type": "number", + "description": "Port number for the database service (default depends on databaseType).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing confirmation of creation, connection string details, and any initialization errors." + }, + "aiAgent": { + "useCase": "Use this tool when a new database is required to support a web application or service, specifying type and configuration parameters. It automates provisioning and initialization, providing connection info for subsequent use.", + "limitations": "Does not handle scaling or database backups. Does not support cloud-provider specific advanced configurations or managed services with proprietary APIs.", + "examples": [ + "Create a MySQL database named 'appdb' with default storage on localhost.", + "Create a PostgreSQL database with custom initialization SQL scripts for schema setup.", + "Create a database with specified user credentials and return the connection URI." + ] + }, + "tags": [ + "database", + "creation", + "web-development", + "configuration", + "mysql", + "postgresql" + ], + "examples": [ + { + "inputJson": "{\"databaseType\":\"mysql\",\"databaseName\":\"appdb\",\"userName\":\"admin\",\"userPassword\":\"securePass123\"}", + "description": "Create a MySQL database named 'appdb' with default storage and credentials." + }, + { + "inputJson": "{\"databaseType\":\"postgresql\",\"databaseName\":\"testdb\",\"userName\":\"testuser\",\"userPassword\":\"pass456\",\"storageSizeMB\":500,\"initializeScripts\":[\"CREATE TABLE users(id SERIAL PRIMARY KEY, name VARCHAR(100));\"]}", + "description": "Create a PostgreSQL database with a custom initialization script for creating a users table." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Database", + "context": null + } + }, + { + "name": "web-development.createService", + "description": "Creates and configures a backend service instance based on specified parameters such as service name, programming language, framework, and deployment environment. Accepts service configuration inputs, sets up the base infrastructure code, and outputs service metadata including endpoints and deployment status.", + "category": "web-development", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The desired name for the new service to identify it uniquely.", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language to use for the service (e.g., Node.js, Python, Go).", + "required": true, + "defaultValue": "Node.js" + }, + { + "name": "framework", + "type": "string", + "description": "Web framework or backend framework to use (e.g., Express, Flask, Gin).", + "required": false, + "defaultValue": "Express" + }, + { + "name": "environment", + "type": "string", + "description": "Deployment environment for the service (e.g., development, staging, production).", + "required": false, + "defaultValue": "development" + }, + { + "name": "databaseConfig", + "type": "object", + "description": "Configuration object for database connection (type, host, credentials) or empty if no DB needed.", + "required": false, + "defaultValue": "" + }, + { + "name": "enableAuthentication", + "type": "boolean", + "description": "Flag to add authentication middleware to the service.", + "required": false, + "defaultValue": "false" + }, + { + "name": "port", + "type": "number", + "description": "The port number on which the service should listen.", + "required": false, + "defaultValue": "3000" + } + ], + "returns": { + "type": "object", + "description": "An object containing serviceId, serviceUrl, deploymentStatus, and configuration summary." + }, + "aiAgent": { + "useCase": "Use this tool when a user needs to scaffold and initialize a backend service setup quickly for a web application, including setting programming language, framework, and deployment environment. It helps automate base service code creation for web projects.", + "limitations": "Does not handle detailed custom business logic insertion or continuous integration setup; focuses on initial service scaffolding only.", + "examples": [ + "Create a new Node.js Express service called 'user-service' with authentication enabled.", + "Set up a Python Flask service for staging environment without database connection.", + "Generate a Go Gin service named 'payment' listening on port 8080 with MySQL database config." + ] + }, + "tags": [ + "web", + "backend", + "service", + "scaffold", + "deployment", + "infrastructure", + "api" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"user-service\",\"programmingLanguage\":\"Node.js\",\"framework\":\"Express\",\"environment\":\"production\",\"databaseConfig\":{\"type\":\"MongoDB\",\"host\":\"mongo.example.com\",\"username\":\"admin\",\"password\":\"secret\"},\"enableAuthentication\":true,\"port\":4000}", + "description": "Create a production Node.js Express service named 'user-service' with MongoDB and authentication on port 4000." + }, + { + "inputJson": "{\"serviceName\":\"analytics\",\"programmingLanguage\":\"Python\",\"framework\":\"Flask\",\"environment\":\"development\",\"enableAuthentication\":false,\"port\":5000}", + "description": "Create a development Python Flask service named 'analytics' without database or authentication on port 5000." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Service", + "context": null + } + }, + { + "name": "web-development.createInstance", + "description": "Creates a new web server instance based on specified configuration parameters such as server type, region, size, and optional startup script. Processes these inputs to provision and initialize the server instance, returning detailed metadata including instance ID, IP address, status, and creation timestamp.", + "category": "web-development", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "Type of the server instance to create, e.g., 'nodejs', 'php', 'static'.", + "required": true, + "defaultValue": "" + }, + { + "name": "region", + "type": "string", + "description": "Geographical region where the server instance will be deployed, like 'us-east-1' or 'eu-west-2'.", + "required": true, + "defaultValue": "" + }, + { + "name": "instanceSize", + "type": "string", + "description": "Size or tier of the instance indicating resource allocation, such as 'small', 'medium', or 'large'.", + "required": true, + "defaultValue": "" + }, + { + "name": "startupScript", + "type": "string", + "description": "Optional script to run on instance startup for environment setup or deployment tasks.", + "required": false, + "defaultValue": "" + }, + { + "name": "enableAutoScaling", + "type": "boolean", + "description": "Flag to enable automatic scaling of the instance based on load.", + "required": false, + "defaultValue": "false" + }, + { + "name": "tags", + "type": "object", + "description": "Key-value pairs to tag and organize the instance for management and billing.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing instance metadata such as instanceId, ipAddress, status, region, size, creationTimestamp, and optional message information." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and configure web server instances for deploying websites or web applications. It is suited for scenarios involving automated infrastructure provisioning where parameters like server type, region, and size must be specified to prepare a fresh environment ready for deployment.", + "limitations": "This tool does not manage ongoing instance health, scaling policies beyond a simple flag, or complex orchestration workflows. It does not handle deployment of application code beyond executing an optional startup script.", + "examples": [ + "Create a new Node.js server instance in the US East region with medium size.", + "Set up a small static website server in Europe with auto-scaling disabled.", + "Provision a PHP server in Asia with a custom startup script for installing dependencies." + ] + }, + "tags": [ + "web", + "server", + "infrastructure", + "automation", + "provisioning" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"nodejs\",\"region\":\"us-east-1\",\"instanceSize\":\"medium\",\"startupScript\":\"npm install && npm start\",\"enableAutoScaling\":true,\"tags\":{\"env\":\"production\",\"project\":\"website\"}}", + "description": "Create a medium Node.js server instance in US East with auto-scaling enabled and a startup script to install dependencies." + }, + { + "inputJson": "{\"serverType\":\"static\",\"region\":\"eu-west-2\",\"instanceSize\":\"small\",\"enableAutoScaling\":false}", + "description": "Provision a small static server instance in Europe without auto-scaling." + }, + { + "inputJson": "{\"serverType\":\"php\",\"region\":\"ap-southeast-1\",\"instanceSize\":\"large\",\"startupScript\":\"composer install\",\"tags\":{\"env\":\"dev\"}}", + "description": "Create a large PHP server instance in Asia with a startup script to install PHP dependencies." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Instance", + "context": null + } + }, + { + "name": "web-development.createContainer", + "description": "Creates a containerized web application environment using specified container technology and configuration. Accepts parameters including container type (e.g., Docker), base image, port mappings, environment variables, and resource limits. Processes these inputs to generate a running container instance with the given settings. Outputs container ID, status, and access details.", + "category": "web-development", + "parameters": [ + { + "name": "containerType", + "type": "string", + "description": "Type of container technology to use, e.g., 'docker' or 'podman'.", + "required": true, + "defaultValue": "" + }, + { + "name": "baseImage", + "type": "string", + "description": "Base container image to use, such as 'node:14-alpine'.", + "required": true, + "defaultValue": "" + }, + { + "name": "portMappings", + "type": "array", + "description": "Array of port mapping objects {containerPort:number, hostPort:number} to expose container services.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set inside the container.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "resourceLimits", + "type": "object", + "description": "Resource limits like CPU and memory, e.g., {cpu:'1.0', memory:'512m'}.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "containerName", + "type": "string", + "description": "Optional name to assign to the container instance.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Details of the created container including container ID, status (e.g., 'running'), and any access information like exposed ports." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create, configure, and launch containerized web app environments as part of web development automation or deployment workflows. It helps automate container setup with custom settings based on user parameters.", + "limitations": "Does not handle container orchestration (like managing multiple containers or clusters), nor does it perform image building beyond using specified base images. Requires the container runtime to be installed and accessible on the host environment.", + "examples": [ + "Create a Docker container of a Node.js app exposing port 3000", + "Generate a container with environment variables and fixed CPU/memory limits", + "Launch a container and assign it a custom container name" + ] + }, + "tags": [ + "container", + "web-development", + "deployment", + "automation", + "docker", + "podman" + ], + "examples": [ + { + "inputJson": "{\"containerType\":\"docker\",\"baseImage\":\"node:14-alpine\",\"portMappings\":[{\"containerPort\":3000,\"hostPort\":3000}],\"environmentVariables\":{\"NODE_ENV\":\"production\"},\"resourceLimits\":{\"cpu\":\"0.5\",\"memory\":\"256m\"},\"containerName\":\"my-node-app\"}", + "description": "Create a Docker container using node:14-alpine image, expose port 3000, set NODE_ENV to production, limit CPU and memory, and name container 'my-node-app'." + }, + { + "inputJson": "{\"containerType\":\"podman\",\"baseImage\":\"nginx:latest\",\"portMappings\":[{\"containerPort\":80,\"hostPort\":8080}],\"environmentVariables\":{},\"resourceLimits\":{},\"containerName\":\"web-server\"}", + "description": "Create a Podman container with the latest nginx image, map port 80 inside container to port 8080 on host, no env vars or resource limits, name it 'web-server'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "web-development.createChannel", + "description": "Creates a new communication channel for a website or web application, allowing users or services to exchange messages or data. Accepts parameters such as channel name, type (e.g., chat, notification, support), visibility (public or private), and optional metadata. Returns the details of the created channel including a unique identifier, creation timestamp, and configuration info.", + "category": "web-development", + "parameters": [ + { + "name": "channelName", + "type": "string", + "description": "The name of the channel to be created. Required to uniquely identify the channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "channelType", + "type": "string", + "description": "Specifies the type of the channel, such as 'chat', 'notification', or 'support'. Determines how the channel behaves.", + "required": true, + "defaultValue": "" + }, + { + "name": "visibility", + "type": "string", + "description": "Defines if the channel is 'public' or 'private'. Public channels are accessible to all users, private to restricted audiences.", + "required": false, + "defaultValue": "public" + }, + { + "name": "allowedUsers", + "type": "array", + "description": "List of user IDs allowed to access the channel, relevant if visibility is 'private'.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional metadata or settings for the channel, such as description, icon URL, or rules.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the created channel's unique ID, name, type, visibility, creation timestamp, allowed users, and any metadata." + }, + "aiAgent": { + "useCase": "Use this tool when building or managing web apps that require creation of communication channels for messaging, notifications, or support. It helps programmatically provision channels with control over access and type to meet varying communication needs.", + "limitations": "This tool does not manage message sending, retrieval, or real-time updates within the channel. It strictly creates and configures the communication channel entity itself.", + "examples": [ + "Create a public chat channel named 'general' for all users.", + "Create a private support channel named 'premiumSupport' visible only to certain user IDs.", + "Create a notification channel named 'systemAlerts' with metadata describing its purpose." + ] + }, + "tags": [ + "web-development", + "channel", + "communication", + "create", + "messaging", + "notifications" + ], + "examples": [ + { + "inputJson": "{\"channelName\":\"general\",\"channelType\":\"chat\",\"visibility\":\"public\"}", + "description": "Create a public chat channel named 'general'." + }, + { + "inputJson": "{\"channelName\":\"vipSupport\",\"channelType\":\"support\",\"visibility\":\"private\",\"allowedUsers\":[\"user123\",\"user456\"]}", + "description": "Create a private support channel accessible only to specific users." + }, + { + "inputJson": "{\"channelName\":\"alerts\",\"channelType\":\"notification\",\"metadata\":{\"description\":\"System-wide alerts\"}}", + "description": "Create a notification channel with metadata describing its purpose." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Channel", + "context": null + } + }, + { + "name": "web-development.createServer", + "description": "Creates a simple HTTP or HTTPS web server based on provided configuration parameters such as port, hostname, protocol, and routes. Accepts HTTP route definitions with handlers and outputs a running server instance with status and access details.", + "category": "web-development", + "parameters": [ + { + "name": "hostname", + "type": "string", + "description": "Hostname or IP address where the server will listen (e.g., 'localhost' or '0.0.0.0')", + "required": false, + "defaultValue": "localhost" + }, + { + "name": "port", + "type": "number", + "description": "Port number for the server to listen on (e.g., 80, 443, 3000)", + "required": true, + "defaultValue": "" + }, + { + "name": "protocol", + "type": "string", + "description": "Protocol to use: 'http' or 'https'", + "required": false, + "defaultValue": "http" + }, + { + "name": "sslKeyPath", + "type": "string", + "description": "File path to SSL private key (required for https)", + "required": false, + "defaultValue": "" + }, + { + "name": "sslCertPath", + "type": "string", + "description": "File path to SSL certificate (required for https)", + "required": false, + "defaultValue": "" + }, + { + "name": "routes", + "type": "array", + "description": "Array of route objects defining URL paths, HTTP methods, and response handlers", + "required": true, + "defaultValue": "" + }, + { + "name": "enableCors", + "type": "boolean", + "description": "Whether to enable CORS headers for all routes", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object containing server status info such as 'running' boolean, server url, configured routes and any errors encountered" + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create a lightweight HTTP/HTTPS server with specified hostname, port, and route handlers for web development or testing purposes. It facilitates quick server setup within scripts or automation flows.", + "limitations": "This tool creates simple servers mainly for development or light production use; it does not support advanced middleware frameworks, database integration, or load balancing out-of-the-box.", + "examples": [ + "Create an HTTP server on port 8080 serving two GET routes with basic JSON responses.", + "Create an HTTPS server on port 443 with provided SSL key and certificate files and enable CORS.", + "Set up a server listening on all interfaces (0.0.0.0), port 3000, with a POST route handling form submissions." + ] + }, + "tags": [ + "web", + "server", + "http", + "https", + "routes", + "development", + "api" + ], + "examples": [ + { + "inputJson": "{\"hostname\":\"localhost\",\"port\":8080,\"protocol\":\"http\",\"routes\":[{\"path\":\"/hello\",\"method\":\"GET\",\"handler\":\"return { greeting: 'Hello, World!' };\"},{\"path\":\"/status\",\"method\":\"GET\",\"handler\":\"return { status: 'OK' };\"}],\"enableCors\":true}", + "description": "Create an HTTP server on localhost, port 8080 with two GET routes returning JSON and CORS enabled." + }, + { + "inputJson": "{\"hostname\":\"0.0.0.0\",\"port\":443,\"protocol\":\"https\",\"sslKeyPath\":\"./ssl/key.pem\",\"sslCertPath\":\"./ssl/cert.pem\",\"routes\":[{\"path\":\"/\",\"method\":\"GET\",\"handler\":\"return { message: 'Secure Home' };\"}],\"enableCors\":false}", + "description": "Create an HTTPS server listening on all interfaces, port 443 with SSL and a single GET route." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Server", + "context": null + } + }, + { + "name": "web-development.createReply", + "description": "Generates a user-friendly, context-aware reply message for a web-based communication interface. It accepts the original message content, user role, and optional tone and language preferences, then processes them to produce a suitable reply text formatted for web display.", + "category": "web-development", + "parameters": [ + { + "name": "originalMessage", + "type": "string", + "description": "The text of the original message to which a reply is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "userRole", + "type": "string", + "description": "Role of the user creating the reply (e.g., admin, moderator, guest, user) which influences the reply style.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Optional tone of the reply such as formal, friendly, or neutral to tailor language style.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "language", + "type": "string", + "description": "Optional language code (e.g., 'en', 'es') to create the reply in the specified language.", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Optional maximum length of the reply in characters to enforce brevity.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated reply text formatted for web display." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate an appropriate text reply to a user message within a web application, such as chat interfaces or support forums, considering user roles and tone preferences to improve communication effectiveness.", + "limitations": "This tool does not generate replies for highly technical or domain-specific content without external knowledge, nor does it manage multi-turn conversations or context beyond the single original message provided.", + "examples": [ + "Create a friendly reply from a moderator to a user's question about account settings.", + "Generate a formal reply from an admin acknowledging a bug report.", + "Produce a concise neutral reply for a guest user commenting on a post." + ] + }, + "tags": [ + "web", + "communication", + "reply", + "message", + "response", + "user-interface", + "chat", + "support" + ], + "examples": [ + { + "inputJson": "{\"originalMessage\":\"How do I change my password?\",\"userRole\":\"moderator\",\"tone\":\"friendly\",\"language\":\"en\",\"maxLength\":200}", + "description": "Generate a friendly reply from a moderator guiding a user on password change." + }, + { + "inputJson": "{\"originalMessage\":\"There is a bug in the payment system.\",\"userRole\":\"admin\",\"tone\":\"formal\",\"language\":\"en\",\"maxLength\":300}", + "description": "Generate a formal reply from an admin acknowledging the bug report." + }, + { + "inputJson": "{\"originalMessage\":\"Thanks for the info!\",\"userRole\":\"guest\",\"tone\":\"neutral\",\"language\":\"en\"}", + "description": "Generate a concise neutral reply from a guest user in response to information provided." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reply", + "context": null + } + }, + { + "name": "web-development.createMention", + "description": "Creates an HTML mention element suitable for embedding in web content or apps. Accepts a username or user ID and optional display name and styling options. Produces a sanitized HTML string representing a clickable mention link or styled span with data attributes for frontend processing or API use.", + "category": "web-development", + "parameters": [ + { + "name": "userId", + "type": "string", + "description": "Unique identifier of the user to mention, used as a data attribute (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "displayName", + "type": "string", + "description": "The visible name to show for the mention, defaults to userId if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "className", + "type": "string", + "description": "CSS class name(s) to apply to the mention element for styling (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "hrefTemplate", + "type": "string", + "description": "Template URL for the mention link with '{userId}' placeholder, e.g., '/profile/{userId}'. If empty, no link is created, only a span.", + "required": false, + "defaultValue": "" + }, + { + "name": "sanitizeHtml", + "type": "boolean", + "description": "Whether to sanitize the output HTML to prevent XSS, enabled by default.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated HTML string that is a safe, clickable or styled mention element ready for embedding in web UIs." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate user mention elements in HTML for web pages or applications, ensuring consistent markup, optional linking, and safe output. Useful for chat systems, comments, notifications, or any place where user mentions appear as part of content.", + "limitations": "This tool only creates the HTML snippet. It does not resolve user IDs to names or verify user existence. It also does not manage frontend interaction beyond static markup.", + "examples": [ + "Generate a mention for user with ID 'user123' shown as 'Alice' linking to '/users/user123'.", + "Create a mention for user 'bob' without a link, just a styled span with class 'mention'.", + "Produce a mention element sanitized to avoid script injection when given unsafe input." + ] + }, + "tags": [ + "web", + "mention", + "html", + "user", + "communication", + "UI", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"userId\":\"12345\",\"displayName\":\"Jane Doe\",\"className\":\"mention highlight\",\"hrefTemplate\":\"/users/{userId}\",\"sanitizeHtml\":true}", + "description": "Creates a clickable mention for user 12345 with display name 'Jane Doe', styled with 'mention highlight' classes linking to /users/12345." + }, + { + "inputJson": "{\"userId\":\"bob\",\"displayName\":\"\",\"className\":\"mention\",\"hrefTemplate\":\"\",\"sanitizeHtml\":true}", + "description": "Creates a non-linked mention span with class 'mention' displaying 'bob' as the visible text." + }, + { + "inputJson": "{\"userId\":\"evil
Sample text for embedding.
\",\"excludeTags\":[\"script\"],\"embeddingModel\":\"default\",\"language\":\"en\"}", + "description": "Create embedding excluding script tags to avoid non-textual content." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "HTML", + "context": null + } + }, + { + "name": "embedding-generation.createYAML", + "description": "Generates vector embeddings from structured YAML input. Accepts a YAML-formatted string that describes text entries or documents, parses the input, extracts the textual content, and produces a corresponding array of vector embeddings for each text unit, suitable for semantic search or clustering.", + "category": "embedding-generation", + "parameters": [ + { + "name": "yamlContent", + "type": "string", + "description": "A string containing well-formed YAML data representing texts to embed. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use (e.g., 'text-embedding-xyz'). If omitted, a default model is used.", + "required": false, + "defaultValue": "default" + }, + { + "name": "fieldPath", + "type": "string", + "description": "YAML path (dot notation) specifying where text is located within each entry, e.g. 'documents.text'. Defaults to top-level strings.", + "required": false, + "defaultValue": "" + }, + { + "name": "ignoreMissingFields", + "type": "boolean", + "description": "If true, entries missing the text field are skipped instead of causing error.", + "required": false, + "defaultValue": "true" + }, + { + "name": "normalizeEmbeddings", + "type": "boolean", + "description": "Whether to normalize each resulting embedding vector to unit length.", + "required": false, + "defaultValue": "true" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of text items to process per batch when generating embeddings to optimize performance.", + "required": false, + "defaultValue": "64" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of embedding vectors and metadata. Each embedding corresponds to one parsed text entry from the YAML input." + }, + "aiAgent": { + "useCase": "Use this tool when structured text data is provided in YAML format and vector embeddings are needed for downstream NLP tasks such as semantic search, clustering, or similarity comparison. Ideal for YAML documents with nested or arrayed textual content requiring extraction and embedding.", + "limitations": "This tool does not perform YAML validation beyond parsing, nor does it generate embeddings for non-text data or complex non-string YAML nodes. It requires the text to be extractable via a specified field. It cannot embed images or binary data encoded in YAML.", + "examples": [ + "Generate embeddings for a list of documents described in a YAML file where each document has a 'summary' field.", + "Create embeddings from a YAML configuration defining multiple paragraphs under keys.", + "Process YAML data with nested arrays of text entries for vectorization." + ] + }, + "tags": [ + "embedding", + "YAML", + "NLP", + "vectorization", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"yamlContent\":\"documents:\\n - id: 1\\n text: 'The quick brown fox jumps over the lazy dog'\\n - id: 2\\n text: 'Artificial intelligence and machine learning are related fields'\",\"fieldPath\":\"documents.text\"}", + "description": "Embed text under 'text' fields in an array named 'documents' in YAML." + }, + { + "inputJson": "{\"yamlContent\":\"- title: Intro\\n content: 'Welcome to the overview of embedding creation.'\\n- title: Details\\n content: 'Embedding models convert text to vectors.'\",\"fieldPath\":\"content\"}", + "description": "Embed top-level array items extracting 'content' field as text." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "YAML", + "context": null + } + }, + { + "name": "embedding-generation.createImage", + "description": "Generates a fixed-length vector embedding from an input image to represent its visual features for similarity search, classification, or other machine learning tasks. Accepts image data via base64 string or image URL, processes it through a convolutional neural network model, and returns a numerical vector embedding.", + "category": "embedding-generation", + "parameters": [ + { + "name": "imageData", + "type": "string", + "description": "Base64 encoded image data. Provide either imageData or imageUrl.", + "required": false, + "defaultValue": "" + }, + { + "name": "imageUrl", + "type": "string", + "description": "URL of the image to fetch and embed. Provide either imageUrl or imageData.", + "required": false, + "defaultValue": "" + }, + { + "name": "modelName", + "type": "string", + "description": "Name of the pre-trained embedding model to use (e.g., 'resnet50', 'mobilenetv2').", + "required": false, + "defaultValue": "resnet50" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Width in pixels to resize the image before embedding.", + "required": false, + "defaultValue": "224" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Height in pixels to resize the image before embedding.", + "required": false, + "defaultValue": "224" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the embedding vector to unit length.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embedding vector as an array of floats and metadata about the embedding." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert images to vector embeddings for tasks like image similarity, clustering, or downstream ML applications. It can embed images supplied as URLs or base64 data using common pre-trained CNN models.", + "limitations": "Does not perform image recognition or classification directly; only generates embeddings. Quality depends on the chosen underlying model. Large images may require resizing to meet input constraints. Does not support batch processing of multiple images in one call.", + "examples": [ + "Generate embedding for an image URL to find similar images.", + "Embed base64 image data for content-based image retrieval.", + "Create fixed-size vectors from product photos for recommendation engines." + ] + }, + "tags": [ + "embedding", + "image", + "vector", + "machine-learning", + "computer-vision", + "feature-extraction" + ], + "examples": [ + { + "inputJson": "{\"imageUrl\":\"https://example.com/image1.jpg\",\"modelName\":\"resnet50\",\"resizeWidth\":224,\"resizeHeight\":224,\"normalize\":true}", + "description": "Embedding generation from an image URL using ResNet50 model resized to 224x224 pixels." + }, + { + "inputJson": "{\"imageData\":\"iVBORw0KGgoAAAANSUhEUgAAA...\",\"modelName\":\"mobilenetv2\",\"normalize\":false}", + "description": "Embedding generation from base64 image data using MobileNetV2 without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Image", + "context": null + } + }, + { + "name": "embedding-generation.createXML", + "description": "Generates an XML document embedding representation by processing input text or structured data and producing a vector embedding encoded within an XML structure. Accepts raw text or key-value object inputs, creates embeddings, and outputs XML embedding entries for downstream consumption.", + "category": "embedding-generation", + "parameters": [ + { + "name": "inputData", + "type": "string", + "description": "Raw text or JSON string representing structured data to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier for the embedding model to use (e.g., 'text-embedding-ada-002').", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include additional metadata such as timestamps and model info in the XML output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxTokens", + "type": "number", + "description": "Maximum number of tokens to consider for generating the embedding.", + "required": false, + "defaultValue": "512" + }, + { + "name": "namespace", + "type": "string", + "description": "XML namespace to use for embedding elements in the output document.", + "required": false, + "defaultValue": "http://example.com/embedding" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single property 'xmlEmbedding' which is a string with the generated XML embedding document." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to convert plain text or structured key-value inputs into vector embeddings embedded in a standardized XML format for integration with systems requiring XML data exchange or further XML transformations. Useful for semantic search indexing or interoperability with legacy XML-based pipelines.", + "limitations": "Does not perform semantic reasoning on the content beyond generating embeddings. The XML schema is basic and may require adaptation for specialized XML schemas. Cannot embed binary or highly nested complex data structures directly without preprocessing.", + "examples": [ + "Generate an XML embedding for a product description text.", + "Convert JSON key-value pairs into an XML embedding format for downstream search.", + "Produce embeddings from a short paragraph with metadata included in XML format." + ] + }, + "tags": [ + "embedding", + "XML", + "vectorization", + "text-processing", + "data-serialization", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"inputData\":\"The quick brown fox jumps over the lazy dog.\",\"embeddingModel\":\"text-embedding-ada-002\",\"includeMetadata\":true,\"maxTokens\":128,\"namespace\":\"http://example.com/embedding\"}", + "description": "Embed simple English sentence with metadata in default namespace." + }, + { + "inputJson": "{\"inputData\":\"{\\\"title\\\":\\\"AI Tool\\\",\\\"description\\\":\\\"An embedding generator\\\"}\",\"embeddingModel\":\"text-embedding-ada-002\",\"includeMetadata\":false,\"maxTokens\":256,\"namespace\":\"http://custom.org/embedding\"}", + "description": "Embed JSON string input without metadata using custom XML namespace." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "XML", + "context": null + } + }, + { + "name": "embedding-generation.createMarkdown", + "description": "Generates vector embeddings from Markdown content by extracting meaningful textual elements and transforming them into numerical vectors suitable for semantic search, clustering, or machine learning applications. Accepts raw Markdown text input and outputs embedding vectors along with metadata about the processed content.", + "category": "embedding-generation", + "parameters": [ + { + "name": "markdownContent", + "type": "string", + "description": "The raw Markdown-formatted text to be embedded.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use for vector generation, e.g., 'text-embedding-ada-002'.", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "splitSections", + "type": "boolean", + "description": "Whether to split the Markdown into sections (e.g., headings) and generate embeddings per section instead of whole document.", + "required": false, + "defaultValue": "false" + }, + { + "name": "sectionDepth", + "type": "number", + "description": "If splitting, the maximum heading depth (e.g., 2 for h1 and h2) used to identify sections.", + "required": false, + "defaultValue": "2" + }, + { + "name": "removeCodeBlocks", + "type": "boolean", + "description": "Whether to exclude code blocks from the text before creating embeddings.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embeddings as arrays of floats linked to either the whole document or individual Markdown sections, including metadata such as section titles and original text snippets." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create vector embeddings from Markdown documents or content to enable semantic search, similarity comparison, or downstream NLP tasks on markdown-based knowledge bases or documentation repositories. It simplifies extracting meaningful textual data from Markdown formatting and supports section-level vector generation for finer-grained embeddings.", + "limitations": "This tool does not perform OCR, speech-to-text transcription, or generate embeddings from non-textual elements like images embedded in Markdown. Extremely large Markdown documents may require pre-chunking outside this tool. The quality of embeddings depends on the selected model and preprocessing parameters.", + "examples": [ + "Generate embeddings from a README.md file to enable semantic search in a developer documentation website.", + "Create embeddings for sections in a Markdown user guide to support topic-specific recommendations.", + "Produce vector representations from Markdown notes, excluding code blocks, for clustering similar note topics." + ] + }, + "tags": [ + "embedding", + "markdown", + "vectorization", + "semantic-search", + "nlp", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"markdownContent\":\"# Introduction\\nThis project uses AI to generate embeddings.\\n## Details\\nMore information about the embedding process.\\n```python\\ndef example():\\n pass\\n```\",\"embeddingModel\":\"text-embedding-ada-002\",\"splitSections\":true,\"sectionDepth\":2,\"removeCodeBlocks\":true}", + "description": "Creating embeddings per section from a Markdown document, excluding code blocks." + }, + { + "inputJson": "{\"markdownContent\":\"# Project Overview\\nWe use advanced embedding techniques.\",\"splitSections\":false,\"removeCodeBlocks\":false}", + "description": "Generate a single embedding vector for entire Markdown content including code blocks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Markdown", + "context": null + } + }, + { + "name": "embedding-generation.createTable", + "description": "Generates a vector embedding representation for tabular data, accepting input as a structured table in JSON or CSV format. Processes the data by encoding each row or selected columns into fixed-size embedding vectors, outputting an array of embeddings suitable for similarity search, clustering, or machine learning tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "tableData", + "type": "string", + "description": "The tabular data input as a JSON string (array of objects) or CSV string to be embedded.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Format of the input table data: 'json' or 'csv'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "columns", + "type": "array", + "description": "An optional list of column names to include in the embedding creation; if empty or omitted, all columns are used.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use for vector generation (e.g., 'default-text-embedding-v1').", + "required": false, + "defaultValue": "default-text-embedding-v1" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the resulting embeddings to unit length vectors.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the embeddings array and metadata: embeddings is an array of float arrays (one per row), metadata includes number of rows processed and column info." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert tabular data into vector embeddings for downstream tasks like data similarity search, clustering, or as input features for ML models. Especially useful when the table contains textual or mixed-type columns requiring semantic understanding.", + "limitations": "Does not perform feature engineering beyond embedding specified columns; unable to embed nested or hierarchical table data directly; performance depends on embedding model capability.", + "examples": [ + "Create embeddings for a JSON table of customer records focusing on 'name' and 'email' columns.", + "Generate vector embeddings from CSV sales data using default settings.", + "Embed tabular survey data selecting text response columns only." + ] + }, + "tags": [ + "embedding", + "table", + "vectorization", + "data-processing", + "machine-learning", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"tableData\":\"[{\\\"name\\\": \\\"Alice\\\", \\\"email\\\": \\\"alice@example.com\\\", \\\"age\\\": 30}, {\\\"name\\\": \\\"Bob\\\", \\\"email\\\": \\\"bob@example.com\\\", \\\"age\\\": 25}]\",\"format\":\"json\",\"columns\":[\"name\",\"email\"],\"embeddingModel\":\"default-text-embedding-v1\",\"normalize\":true}", + "description": "Embed JSON table data using only 'name' and 'email' columns with normalization." + }, + { + "inputJson": "{\"tableData\":\"name,email,age\\nAlice,alice@example.com,30\\nBob,bob@example.com,25\",\"format\":\"csv\",\"columns\":[],\"embeddingModel\":\"default-text-embedding-v1\",\"normalize\":false}", + "description": "Embed CSV format table data using all columns, no normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Table", + "context": null + } + }, + { + "name": "embedding-generation.createJSON", + "description": "Generates JSON-formatted vector embeddings for input text or array of texts using specified embedding model and options. Accepts plain text or list of texts, validates inputs, generates embeddings, and returns an object mapping each input to its vector embedding in JSON format.", + "category": "embedding-generation", + "parameters": [ + { + "name": "texts", + "type": "array", + "description": "An array of one or more text strings to generate embeddings for.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to use (e.g., 'text-embedding-ada-002').", + "required": true, + "defaultValue": "" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of texts to process in one batch for efficiency; default is 16.", + "required": false, + "defaultValue": "16" + }, + { + "name": "normalizeVectors", + "type": "boolean", + "description": "Whether to L2 normalize the resulting embeddings; improves vector similarity calculations if true.", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include original text alongside its embedding in the JSON output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A JSON object mapping each input text to its generated vector embedding array, optionally including original text if includeMetadata is true." + }, + "aiAgent": { + "useCase": "Use this tool to convert one or multiple input text strings into standardized JSON embedding objects for downstream tasks like semantic search, clustering, or ML input. It is useful when an agent needs structured embedding data that includes both vector arrays and optionally the source texts, supporting batch processing for efficiency.", + "limitations": "This tool does not perform embedding model training or vector database indexing. It assumes input texts are sufficiently clean and non-empty, and does not handle non-text data. Model-specific token limits or API constraints must be managed externally.", + "examples": [ + "Generate JSON embeddings for a list of customer feedback messages using 'text-embedding-ada-002' model for clustering analysis.", + "Create normalized vector embeddings in JSON for multiple product descriptions for semantic search indexing.", + "Produce JSON output embedding for a single sentence without metadata inclusion for lightweight API response." + ] + }, + "tags": [ + "embedding", + "vectorization", + "json", + "nlp", + "batch-processing", + "text", + "vector-embedding", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"texts\":[\"The quick brown fox jumps over the lazy dog.\"],\"embeddingModel\":\"text-embedding-ada-002\",\"batchSize\":1,\"normalizeVectors\":false,\"includeMetadata\":true}", + "description": "Generate JSON embeddings for a single sentence including metadata." + }, + { + "inputJson": "{\"texts\":[\"Customer review one.\",\"Customer review two.\",\"Customer review three.\"],\"embeddingModel\":\"text-embedding-ada-002\",\"batchSize\":3,\"normalizeVectors\":true,\"includeMetadata\":true}", + "description": "Generate normalized embeddings for multiple customer reviews with metadata." + }, + { + "inputJson": "{\"texts\":[\"Short phrase\"],\"embeddingModel\":\"text-embedding-ada-002\",\"batchSize\":1,\"normalizeVectors\":false,\"includeMetadata\":false}", + "description": "Generate embedding for one short phrase without including input text in output." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "JSON", + "context": null + } + }, + { + "name": "embedding-generation.createCSV", + "description": "This tool accepts an array of text entries and generates a CSV file where each row contains the original text and its corresponding vector embedding generated by a specified embedding model. It processes the texts to produce vector embeddings and outputs a CSV formatted string that can be saved or utilized for downstream tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "texts", + "type": "array", + "description": "An array of strings representing the texts to embed. Required and must contain at least one text.", + "required": true, + "defaultValue": "" + }, + { + "name": "modelName", + "type": "string", + "description": "The name of the embedding model to use for generating vectors (e.g., 'openai-text-embedding-3-small').", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Indicates whether to include CSV headers (text and embedding vector columns) in the output CSV.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Delimiter character to separate CSV columns, default is comma (,).", + "required": false, + "defaultValue": "," + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated CSV string with each row having the original text and its associated embedding vector serialized as JSON array." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a CSV file combining textual data with their vector embeddings for tasks such as semantic search, clustering, or offline analysis. Particularly useful to prepare data for ML pipelines or data export where embeddings must be paired with original texts in a CSV format.", + "limitations": "Cannot generate embeddings for non-text inputs such as images or audio. Embedding quality depends on the specified model. The output CSV may be large for big input arrays and vectors.", + "examples": [ + "Create embeddings for a list of customer reviews and output as CSV for further processing.", + "Generate a CSV of product descriptions with embeddings for semantic similarity analysis.", + "Produce a CSV file containing input texts and their embeddings to upload in a data visualization tool." + ] + }, + "tags": [ + "embedding-generation", + "csv", + "vector-embedding", + "text-processing", + "vectorization" + ], + "examples": [ + { + "inputJson": "{\"texts\":[\"The quick brown fox jumps over the lazy dog.\", \"AI is transforming many industries.\"],\"modelName\":\"openai-text-embedding-3-small\",\"includeHeaders\":true,\"delimiter\":\",\"}", + "description": "Generate a CSV embedding file for two sample texts including headers and using comma delimiter." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "CSV", + "context": null + } + }, + { + "name": "embedding-generation.createWorkflow", + "description": "Creates a customizable workflow configuration for generating vector embeddings from text or code data. Accepts input specifying the data type, embedding model parameters, preprocessing steps, and output format. Produces a structured workflow object encoding these instructions for embedding generation pipelines.", + "category": "embedding-generation", + "parameters": [ + { + "name": "dataType", + "type": "string", + "description": "Type of input data for embedding generation (e.g., 'text', 'code').", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier or name of the embedding model to use (e.g., 'sentence-transformers/all-MiniLM-L6-v2').", + "required": true, + "defaultValue": "" + }, + { + "name": "preprocessingSteps", + "type": "array", + "description": "An ordered list of preprocessing operations to apply before embedding (e.g., ['tokenization', 'lowercasing']).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of data items to process simultaneously in each embedding batch.", + "required": false, + "defaultValue": "32" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired format of the output embeddings (e.g., 'json', 'numpy').", + "required": false, + "defaultValue": "json" + }, + { + "name": "normalizeEmbeddings", + "type": "boolean", + "description": "Whether to normalize embeddings to unit length after generation.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A workflow configuration object detailing the input specifications, embedding model, preprocessing steps, batch settings, and output preferences for embedding generation pipelines." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically define embedding generation workflows that incorporate specific data types, preprocessing sequences, and model choices. It supports configuring embedding pipelines for different domains such as natural language or source code, enabling flexible and reusable workflows for downstream tasks like indexing or semantic search.", + "limitations": "This tool only creates the workflow configuration; it does not perform the actual embedding generation or model inference.", + "examples": [ + "Create an embedding workflow for text documents using a transformer model with standard preprocessing.", + "Generate a workflow configuration for embedding source code snippets including tokenization and normalization.", + "Set up a workflow to batch process text inputs and output embeddings in numpy format." + ] + }, + "tags": [ + "embedding", + "workflow", + "configuration", + "text", + "code", + "machine-learning", + "nlp" + ], + "examples": [ + { + "inputJson": "{\"dataType\":\"text\",\"embeddingModel\":\"sentence-transformers/all-MiniLM-L6-v2\",\"preprocessingSteps\":[\"tokenization\",\"lowercasing\"],\"batchSize\":64,\"outputFormat\":\"json\",\"normalizeEmbeddings\":true}", + "description": "Workflow for creating normalized embeddings from text using a popular transformer model with tokenization and lowercasing preprocessing." + }, + { + "inputJson": "{\"dataType\":\"code\",\"embeddingModel\":\"code-search-net\",\"preprocessingSteps\":[\"tokenization\"],\"batchSize\":16,\"outputFormat\":\"numpy\",\"normalizeEmbeddings\":false}", + "description": "Workflow configuration to embed code snippets using a code-search specific model, including tokenization without normalization, outputting embeddings as numpy arrays." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Workflow", + "context": null + } + }, + { + "name": "embedding-generation.createDataset", + "description": "This tool creates a dataset suitable for training embedding models by processing input text data. It accepts an array of text items or documents, optionally with associated metadata, cleans and normalizes the text, and outputs a structured dataset with unique IDs, cleaned text, and metadata fields to facilitate embedding generation.", + "category": "embedding-generation", + "parameters": [ + { + "name": "texts", + "type": "array", + "description": "An array of strings representing the text items or documents to include in the dataset.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "array", + "description": "Optional array of metadata objects corresponding to each text item; length must match texts array if provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "cleanText", + "type": "boolean", + "description": "Flag indicating whether to perform text cleaning and normalization (e.g., lowercasing, removing special chars).", + "required": false, + "defaultValue": "true" + }, + { + "name": "removeDuplicates", + "type": "boolean", + "description": "Whether to remove duplicate text entries from the dataset.", + "required": false, + "defaultValue": "true" + }, + { + "name": "minTextLength", + "type": "number", + "description": "Minimum length of text items in characters; entries shorter than this are excluded.", + "required": false, + "defaultValue": "10" + } + ], + "returns": { + "type": "object", + "description": "Returns a dataset object containing a list of entries each with unique id, cleaned text, and optional metadata, ready for embedding model consumption." + }, + "aiAgent": { + "useCase": "Use this tool when you need to prepare raw text data into a clean, structured dataset tailored for embedding generation tasks such as semantic search, clustering, or downstream NLP. It helps ensure data quality by cleaning, filtering, and structuring inputs with metadata support.", + "limitations": "This tool does not generate embeddings itself; it only prepares text data. It requires text inputs; other data types are unsupported. Complex NLP normalization or language detection is not performed.", + "examples": [ + "Create a cleaned dataset from customer reviews for embedding model training.", + "Generate an embedding dataset from a list of product descriptions with associated category metadata.", + "Remove duplicates and filter out short texts from raw text logs before creating embedding dataset." + ] + }, + "tags": [ + "embedding-generation", + "dataset-preparation", + "text-processing", + "data-cleaning", + "nlp" + ], + "examples": [ + { + "inputJson": "{\"texts\":[\"Hello World!\",\"The quick brown fox.\",\"Hello World!\"],\"metadata\":[{\"source\":\"tweet1\"},{\"source\":\"article1\"},{\"source\":\"tweet1\"}],\"cleanText\":true,\"removeDuplicates\":true,\"minTextLength\":5}", + "description": "Create a cleaned dataset from short texts with metadata, removing duplicates and enforcing minimum text length." + }, + { + "inputJson": "{\"texts\":[\"Sample document one.\",\"Another example text.\"],\"cleanText\":false,\"removeDuplicates\":false,\"minTextLength\":0}", + "description": "Create a dataset without cleaning or removing duplicates to preserve raw data for embedding." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dataset", + "context": null + } + }, + { + "name": "embedding-generation.createPullRequest", + "description": "Generates vector embeddings for the description and code changes of a GitHub pull request to aid in semantic search, code review assistance, and automation workflows. Accepts pull request metadata and diff text as input, processes them into combined embeddings capturing semantic content, and outputs structured embedding vectors.", + "category": "embedding-generation", + "parameters": [ + { + "name": "repositoryName", + "type": "string", + "description": "The full name of the repository (e.g., 'org/repo') where the pull request exists.", + "required": true, + "defaultValue": "" + }, + { + "name": "pullRequestTitle", + "type": "string", + "description": "The title of the pull request to embed for semantic understanding.", + "required": true, + "defaultValue": "" + }, + { + "name": "pullRequestDescription", + "type": "string", + "description": "The detailed description or body of the pull request, providing context and intent of the changes.", + "required": false, + "defaultValue": "" + }, + { + "name": "diffText", + "type": "string", + "description": "The unified diff text of code changes included in the pull request to generate embeddings from.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier for the embedding model to use (e.g., 'code-similarity-v1') to generate vectors.", + "required": false, + "defaultValue": "code-similarity-v1" + }, + { + "name": "maxTokens", + "type": "number", + "description": "Maximum number of tokens to process from text inputs to limit embedding size.", + "required": false, + "defaultValue": "2048" + } + ], + "returns": { + "type": "object", + "description": "An object containing embedding vectors (arrays of floating-point numbers) for the pull request title, description, and code diff, along with metadata like model used and dimensionality." + }, + "aiAgent": { + "useCase": "Use this tool when you have details of a pull request (including title, description, and code changes) and want to generate semantic vector embeddings to enable intelligent code review assistance, search over pull requests, clustering similar PRs, or feeding into ML models for downstream tasks. It is best suited for automating codebase maintenance and developer productivity enhancements.", + "limitations": "This tool does not create or modify actual pull requests on Git hosting platforms; it purely generates embeddings from provided PR data. It requires the caller to provide diff text and will not fetch repository data by itself. Embedding quality depends on the chosen model and input token limits.", + "examples": [ + "Create embeddings for a new feature pull request containing a long description and code diff.", + "Generate semantic vectors from a bugfix PR's title and changes to enable PR similarity search.", + "Embed multiple pull requests' metadata and diffs for clustering related changes during release planning." + ] + }, + "tags": [ + "embedding", + "code-review", + "pull-request", + "semantic-search", + "github", + "vectorization", + "automation" + ], + "examples": [ + { + "inputJson": "{\"repositoryName\":\"example-org/example-repo\",\"pullRequestTitle\":\"Add new payment gateway integration\",\"pullRequestDescription\":\"This PR introduces support for the new AcmePay gateway, including API client and tests.\",\"diffText\":\"diff --git a/src/payment.js b/src/payment.js\\nindex e69de29..4b825dc 100644\\n--- a/src/payment.js\\n+++ b/src/payment.js\\n@@ -0,0 +1,10 @@\\n+function acmePay() {\\n+ // AcmePay API client implementation\\n+}\\n\",\"embeddingModel\":\"code-similarity-v1\",\"maxTokens\":2048}", + "description": "Embedding generation for a feature pull request with title, description, and code diff input." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "PullRequest", + "context": null + } + }, + { + "name": "embedding-generation.createPipeline", + "description": "Creates a customizable embedding generation pipeline by combining preprocessing, encoder model selection, and postprocessing steps. Accepts configuration for input text handling, choice of embedding model, and output formatting, and returns a reusable pipeline object for embedding text inputs.", + "category": "embedding-generation", + "parameters": [ + { + "name": "preprocessingSteps", + "type": "array", + "description": "Ordered list of preprocessing operations to apply to input text before embedding (e.g., tokenization, normalization).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier or name of the embedding model to use (e.g., 'bert-base-uncased', 'sentence-transformers/all-MiniLM-L6-v2').", + "required": true, + "defaultValue": "" + }, + { + "name": "postprocessingSteps", + "type": "array", + "description": "Ordered list of operations to apply on generated embeddings (e.g., normalization, dimensionality reduction).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of input texts to embed simultaneously for efficiency. Must be positive integer.", + "required": false, + "defaultValue": "32" + }, + { + "name": "device", + "type": "string", + "description": "Compute device to run the embedding model on (e.g., 'cpu', 'cuda').", + "required": false, + "defaultValue": "cpu" + } + ], + "returns": { + "type": "object", + "description": "A pipeline object encapsulating the configured embedding generation process, exposing a method to embed input texts efficiently." + }, + "aiAgent": { + "useCase": "Use this tool to set up a flexible embedding generation pipeline tailored to specific input preprocessing needs and preferred embedding models. Useful when building vector search systems, recommendation engines, or language understanding modules requiring consistent embedding generation.", + "limitations": "This tool does not perform embedding itself but creates a configured pipeline. The pipeline's effectiveness depends on chosen models and preprocessing steps, which must be supported by underlying ML frameworks.", + "examples": [ + "Create a pipeline that tokenizes and lowercases input, uses 'sentence-transformers/all-MiniLM-L6-v2' as the embedding model, applies L2 normalization, and runs on GPU.", + "Set up a simple pipeline with no preprocessing or postprocessing using 'bert-base-uncased' model on CPU.", + "Build a pipeline that truncates long input texts, encodes with 'distilbert-base-uncased', and reduces embedding dimensionality for faster similarity search." + ] + }, + "tags": [ + "embedding", + "pipeline", + "NLP", + "vectorization", + "machine learning", + "preprocessing" + ], + "examples": [ + { + "inputJson": "{\"preprocessingSteps\":[\"lowercase\",\"tokenize\"],\"embeddingModel\":\"sentence-transformers/all-MiniLM-L6-v2\",\"postprocessingSteps\":[\"normalize\"],\"batchSize\":64,\"device\":\"cuda\"}", + "description": "Create a pipeline with lowercase and tokenization preprocessing, using a MiniLM model, normalize embeddings, batch size 64 on GPU." + }, + { + "inputJson": "{\"embeddingModel\":\"bert-base-uncased\"}", + "description": "Create a simple pipeline with default settings using bert-base-uncased model." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Pipeline", + "context": null + } + }, + { + "name": "embedding-generation.createIssue", + "description": "Generates a vector embedding for a code issue description to facilitate semantic search, clustering, and similarity analysis within code repositories or project management tools. Accepts the textual issue description and optional metadata for enhanced context, then returns a numerical vector embedding representing the issue's semantic content.", + "category": "embedding-generation", + "parameters": [ + { + "name": "issueDescription", + "type": "string", + "description": "The natural language description of the code issue or bug report to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional contextual data about the issue such as severity, tags, or component name to influence embedding generation.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to use for generating the vector representation.", + "required": false, + "defaultValue": "default-code-issue-embedding-model" + }, + { + "name": "includeRawTextEmbedding", + "type": "boolean", + "description": "Flag to include embedding of the raw issue description text alongside any metadata-enhanced embedding.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated vector embedding array, model info used, and optionally the original text and metadata for reference." + }, + "aiAgent": { + "useCase": "Use this tool when an AI system needs to represent code issue descriptions in vector form to enable semantic understanding, similarity detection, clustering, or integration with vector search systems. Ideal for improving bug triage, related issue grouping, or recommending relevant documentation.", + "limitations": "The tool cannot fix issues or provide explanations; it only encodes textual descriptions into vectors. Quality depends on the input clarity and embedding model capabilities.", + "examples": [ + "Generate an embedding for a bug report describing a null pointer exception in the login module.", + "Create embeddings for issue summaries to cluster similar tickets in a software project.", + "Produce vector representations of code vulnerabilities described in issue reports for semantic search integration." + ] + }, + "tags": [ + "embedding", + "code", + "issue-tracking", + "semantic-search", + "bug-report", + "vector", + "code-analysis" + ], + "examples": [ + { + "inputJson": "{\"issueDescription\":\"Application throws null pointer exception when user tries to login with empty password field.\",\"metadata\":{\"severity\":\"high\",\"component\":\"authentication\"},\"embeddingModel\":\"default-code-issue-embedding-model\",\"includeRawTextEmbedding\":true}", + "description": "Embedding a bug report about a null pointer exception in the login component." + }, + { + "inputJson": "{\"issueDescription\":\"Memory leak detected in image processing pipeline causing degraded performance over time.\",\"metadata\":{\"severity\":\"medium\",\"component\":\"image-processing\"}}", + "description": "Create embedding for a memory leak issue in image processing without specifying embedding model explicitly." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Issue", + "context": null + } + }, + { + "name": "embedding-generation.createCommit", + "description": "Generates a vector embedding that represents a code commit by analyzing its diffs, commit message, and metadata. Accepts structured commit data including author, message, changed files with diffs, and timestamp, and outputs a fixed-length numeric embedding useful for code search, similarity detection, or downstream ML tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "commitMessage", + "type": "string", + "description": "The textual commit message explaining the changes made in the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the author who made the commit.", + "required": false, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email address of the commit author.", + "required": false, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp of when the commit was made.", + "required": false, + "defaultValue": "" + }, + { + "name": "changedFiles", + "type": "array", + "description": "List of objects representing changed files, each with filename and diff text or patch representing code changes.", + "required": true, + "defaultValue": "" + }, + { + "name": "repositoryName", + "type": "string", + "description": "Name of the repository or project containing the commit.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a high-dimensional numeric embedding vector representing the commit semantics and code changes, suitable for similarity search and machine learning applications." + }, + "aiAgent": { + "useCase": "Use this tool when you need a concise numeric representation (embedding) of a code commit to enable semantic search, clustering, or recommendation systems based on commit contents and metadata. It is suitable for analyzing code changes at a commit level for tasks like anomaly detection, impact analysis, or finding similar commits.", + "limitations": "This tool does not perform full semantic code understanding or generate human-readable summaries. It cannot interpret binary diffs or non-textual changes and requires textual diffs that include contextual code.", + "examples": [ + "Generate an embedding for a code commit to find similar commits in a large repository.", + "Create vector embeddings of recent commits to cluster them by functionality changes.", + "Use embeddings of commits to recommend reviewers based on history." + ] + }, + "tags": [ + "embedding", + "code", + "commit", + "vector", + "diff", + "code-analysis", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"commitMessage\":\"Fix null pointer exception in user login flow\",\"authorName\":\"Alice Johnson\",\"authorEmail\":\"alice@example.com\",\"timestamp\":\"2024-05-10T15:23:00Z\",\"changedFiles\":[{\"filename\":\"src/login.js\",\"diff\":\"- if(user!=null){\\n+ if(user!==null && user.isActive){\\n\"}],\"repositoryName\":\"auth-service\"}", + "description": "Embedding generation for a commit fixing a null pointer exception in login code." + }, + { + "inputJson": "{\"commitMessage\":\"Add unit tests for payment processing module\",\"authorName\":\"Bob Lee\",\"changedFiles\":[{\"filename\":\"tests/payment.test.js\",\"diff\":\"+ test('processPayment handles invalid input', () => {\\n+ expect(() => processPayment(null)).toThrow();\\n+ });\\n\"}]}", + "description": "Embed a commit that adds new unit tests to the payment processing code." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Commit", + "context": null + } + }, + { + "name": "embedding-generation.createBranch", + "description": "Generates a branch-specific embedding vector for code repositories. Takes branch name, repository URL or code snapshots as input, processes code content on that branch, and outputs a vector embedding representing branch-specific code features for search or analysis.", + "category": "embedding-generation", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The URL of the Git repository to extract code from (required if codeSnapshot not provided).", + "required": false, + "defaultValue": "" + }, + { + "name": "branchName", + "type": "string", + "description": "The name of the branch in the repository to generate the embedding for (required if repositoryUrl provided).", + "required": false, + "defaultValue": "" + }, + { + "name": "codeSnapshot", + "type": "object", + "description": "An optional snapshot of the code files keyed by file path, used instead of repositoryUrl and branchName.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Specifies which embedding model to use for vector generation (e.g., 'code-search-babbage').", + "required": false, + "defaultValue": "code-search-babbage" + }, + { + "name": "includeDependencies", + "type": "boolean", + "description": "Whether to include dependency files from the branch in the embedding (true/false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the embedding vector as an array of floats and metadata like branch and repo info." + }, + "aiAgent": { + "useCase": "Use this tool when needing a vector embedding that captures the characteristics of a specific Git branch's code base, such as for code search, branch similarity comparisons, or specialized analysis. It supports input as a live repo+branch or code snapshots. Useful for agents managing code QA or knowledge management.", + "limitations": "Cannot directly handle private repositories without access credentials. Does not generate embeddings for individual commits or files separately unless pre-processed. The output embedding dimensionality depends on the embedding model chosen and might vary.", + "examples": [ + "Generate an embedding for the dev branch of a public GitHub repo to enable semantic search.", + "Build a branch embedding from a provided set of code files snapshot to represent a feature branch offline.", + "Create embeddings for different branches and compare similarity for impact analysis." + ] + }, + "tags": [ + "embedding-generation", + "code", + "branch", + "repository", + "vector-embedding" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"branchName\":\"feature-ai-embedding\",\"embeddingModel\":\"code-search-babbage\",\"includeDependencies\":true}", + "description": "Generate embedding for the 'feature-ai-embedding' branch of a public GitHub repository including dependencies." + }, + { + "inputJson": "{\"codeSnapshot\":{\"src/main.js\":\"console.log('Hello World');\",\"package.json\":\"{\\\"name\\\":\\\"example\\\"}\"},\"embeddingModel\":\"code-search-babbage\",\"includeDependencies\":false}", + "description": "Create embedding using a code snapshot representing files on a branch, without including dependencies." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Branch", + "context": null + } + }, + { + "name": "embedding-generation.createVariable", + "description": "Generates a vector embedding for a given code variable name or identifier using a specified embedding model. The tool accepts a variable name as input and returns its vector embedding representation, which can be used for code analysis, similarity search, or machine learning tasks involving code semantics.", + "category": "embedding-generation", + "parameters": [ + { + "name": "variableName", + "type": "string", + "description": "The name or identifier of the code variable to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The embedding model to use for vector generation, e.g., 'codebert', 'fasttext-code'.", + "required": false, + "defaultValue": "codebert" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the resulting embedding vector to unit length.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the original variable name and its corresponding embedding vector as an array of floats." + }, + "aiAgent": { + "useCase": "Use this tool when you need a vector representation of a code variable to perform semantic similarity, find related variables across codebases, support code search, or input into machine learning models that analyze code structure and meaning. It is particularly useful when analyzing or clustering code symbols by meaning.", + "limitations": "This tool cannot generate contextual embeddings requiring full code context or interpret variable usage. It only embeds isolated variable names, so deeper semantic understanding may be limited.", + "examples": [ + "Generate the embedding vector for the variable named 'userId' using default settings.", + "Create a normalized embedding vector for a variable named 'temp_buffer' using the 'fasttext-code' model." + ] + }, + "tags": [ + "embedding", + "code", + "variable", + "vector", + "machine-learning", + "code-analysis" + ], + "examples": [ + { + "inputJson": "{\"variableName\":\"userId\"}", + "description": "Generate an embedding vector for the code variable \"userId\" using the default embedding model." + }, + { + "inputJson": "{\"variableName\":\"temp_buffer\",\"embeddingModel\":\"fasttext-code\",\"normalize\":false}", + "description": "Create a raw embedding vector for the variable \"temp_buffer\" using the FastText code model without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Variable", + "context": null + } + }, + { + "name": "embedding-generation.createConfig", + "description": "Creates a configuration object for embedding generation models. Accepts parameters such as model type, embedding dimensions, normalization options, and tokenizer settings. Processes these inputs to produce a config object that standardizes embedding generation settings for downstream embedding computation workflows.", + "category": "embedding-generation", + "parameters": [ + { + "name": "modelType", + "type": "string", + "description": "Specifies the embedding model to use, e.g., 'bert-base', 'openai-text-embedding', or custom.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingDimension", + "type": "number", + "description": "Number of dimensions for the output embedding vectors; must be a positive integer matching the model's output size.", + "required": true, + "defaultValue": "" + }, + { + "name": "normalizeEmbeddings", + "type": "boolean", + "description": "Whether to normalize the embeddings to unit length after generation (true enables normalization).", + "required": false, + "defaultValue": "false" + }, + { + "name": "tokenizerSettings", + "type": "object", + "description": "Optional settings to customize the tokenizer, such as max token length, truncation strategy, or special tokens.", + "required": false, + "defaultValue": "" + }, + { + "name": "useGPU", + "type": "boolean", + "description": "Indicates if GPU acceleration should be enabled for embedding generation (if supported by environment).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A configuration object containing all specified parameters formatted for use in embedding generation pipelines, ensuring consistent embedding computation behavior." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create or update configuration objects that define how text embeddings are generated, including model specifics, embedding dimensions, normalization, and tokenizer options. This standardizes embedding setup for downstream tasks like similarity search or classification.", + "limitations": "This tool does not perform actual embedding generation; it only creates configuration objects. It cannot validate model availability or run model inference.", + "examples": [ + "Create a config for 'bert-base' model with 768 dimensions and normalized embeddings.", + "Generate a config for OpenAI embeddings with tokenization truncation settings.", + "Set up GPU-enabled embedding config for custom model with 512 dimensions." + ] + }, + "tags": [ + "embedding", + "configuration", + "model-settings", + "text-processing", + "vector", + "generation" + ], + "examples": [ + { + "inputJson": "{\"modelType\":\"bert-base\",\"embeddingDimension\":768,\"normalizeEmbeddings\":true,\"tokenizerSettings\":{\"maxLength\":512,\"truncationStrategy\":\"longest_first\"},\"useGPU\":false}", + "description": "Standard BERT embedding config with normalization and tokenizer max token length 512." + }, + { + "inputJson": "{\"modelType\":\"openai-text-embedding\",\"embeddingDimension\":1536,\"normalizeEmbeddings\":false,\"tokenizerSettings\":{},\"useGPU\":true}", + "description": "OpenAI embedding config requesting GPU compute without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Config", + "context": null + } + }, + { + "name": "embedding-generation.createDependency", + "description": "Generates vector embeddings for code dependencies based on their source code or metadata. Accepts dependency identifiers or source snippets, processes them with a code-focused embedding model, and returns numeric vector embeddings for use in search, analysis, or recommendation systems.", + "category": "embedding-generation", + "parameters": [ + { + "name": "dependencyName", + "type": "string", + "description": "The name of the dependency or package to generate embeddings for, e.g., a library or module name, optional if providing source code.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceCode", + "type": "string", + "description": "Raw source code or relevant code excerpts of the dependency for generating accurate embeddings, required if dependencyName is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the provided source code, used to enhance embedding accuracy, e.g., 'javascript', 'python'.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Specifies which embedding model to use for generation, e.g., 'code-bert', 'starcoder'.", + "required": false, + "defaultValue": "\"code-bert\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated embedding as an array of floats, the dimension of the embedding vector, and meta info about input." + }, + "aiAgent": { + "useCase": "Use this tool when you need vector embeddings representing code dependencies to improve search, similarity detection, or knowledge graphs involving software libraries. It helps integrate dependency semantic info into ML workflows by transforming code or metadata to high-dimensional vectors.", + "limitations": "Cannot generate embeddings without valid source code or identifiable dependency metadata. Embeddings quality depends heavily on the input and chosen model; it does not analyze license or security aspects of dependencies.", + "examples": [ + "Generate embeddings for the React library to enable semantic search over dependencies.", + "Create vector embeddings from code snippets of a dependency for ML model input.", + "Embed metadata of a Python package to cluster similar dependencies." + ] + }, + "tags": [ + "embedding", + "code-analysis", + "dependencies", + "vector-representation", + "software-libraries", + "machine-learning" + ], + "examples": [ + { + "inputJson": "{\"dependencyName\":\"lodash\",\"sourceCode\":\"\",\"language\":\"javascript\",\"embeddingModel\":\"code-bert\"}", + "description": "Generate embedding for the lodash JS library using default code-bert model with no source code input." + }, + { + "inputJson": "{\"dependencyName\":\"\",\"sourceCode\":\"function add(a, b) { return a + b; }\",\"language\":\"javascript\",\"embeddingModel\":\"starcoder\"}", + "description": "Embed a small JavaScript code snippet representing a dependency function with starcoder model." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dependency", + "context": null + } + }, + { + "name": "embedding-generation.createPackage", + "description": "Generates a reusable code package that encapsulates text embedding generation functionality. Accepts configuration details like embedding model, programming language, and package metadata. Processes these inputs to output a ready-to-use code package including API calls or local embedding model integration for downstream vectorization tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier or name of the embedding model to use (e.g., 'text-embedding-3-large').", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Target programming language for the generated package (e.g., 'python', 'javascript').", + "required": true, + "defaultValue": "" + }, + { + "name": "packageName", + "type": "string", + "description": "Name of the generated package or module.", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "Version number of the package, following semantic versioning (e.g., '1.0.0').", + "required": false, + "defaultValue": "\"1.0.0\"" + }, + { + "name": "includeApiClient", + "type": "boolean", + "description": "Whether to include an API client wrapper for remote embedding service calls.", + "required": false, + "defaultValue": "true" + }, + { + "name": "licenseType", + "type": "string", + "description": "License type for the generated package (e.g., 'MIT', 'Apache-2.0').", + "required": false, + "defaultValue": "\"MIT\"" + }, + { + "name": "dependencies", + "type": "array", + "description": "List of additional dependencies or libraries to include in the package.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing metadata and content of the generated package. Includes package name, version, language, a zip file content encoded as base64 string, and a manifest describing files included." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a ready-to-install or import code package that performs text embedding generation with specific model and language setups. This helps automate deployment or integration tasks by providing reusable code bundles tailored to user or system configuration.", + "limitations": "Cannot generate runnable binaries or packages for languages or environments not supported by the underlying embedding models. Does not provide embeddings directly, only the code to generate them.", + "examples": [ + "Create a Python package named 'textEmbedder' using the 'text-embedding-3-large' model with an MIT license.", + "Generate a JavaScript embedding client package configured to use a remote API with version '0.9.0'.", + "Produce a Python package including additional numpy dependency for embedding generation." + ] + }, + "tags": [ + "embedding", + "code-generation", + "package", + "text-embeddings", + "AI-integration" + ], + "examples": [ + { + "inputJson": "{\"embeddingModel\":\"text-embedding-3-large\",\"programmingLanguage\":\"python\",\"packageName\":\"textEmbedder\",\"version\":\"1.0.0\",\"includeApiClient\":true,\"licenseType\":\"MIT\",\"dependencies\":[\"numpy\"]}", + "description": "Generate a Python package named 'textEmbedder' using the 'text-embedding-3-large' model, including numpy dependency and API client wrapper." + }, + { + "inputJson": "{\"embeddingModel\":\"text-embedding-2-small\",\"programmingLanguage\":\"javascript\",\"packageName\":\"embedClientJS\",\"version\":\"0.9.0\",\"includeApiClient\":true,\"licenseType\":\"Apache-2.0\",\"dependencies\":[]}", + "description": "Create a JavaScript embedding client package named 'embedClientJS' using a smaller embedding model with Apache 2.0 license." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Package", + "context": null + } + }, + { + "name": "embedding-generation.createTest", + "description": "Generates a test suite embedding from provided code snippets in various programming languages. Accepts an array of code samples and language identifiers, processes them to create a vector representation suitable for similarity search and downstream test analysis tasks, and returns combined embedding vector data.", + "category": "embedding-generation", + "parameters": [ + { + "name": "codeSnippets", + "type": "array", + "description": "Array of objects each containing a 'code' string and 'language' string representing the code sample and its programming language.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use for vector generation, e.g. 'codebert-base' or 'text-embedding-ada-002'.", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the resulting combined embedding vector to unit length. Useful for cosine similarity calculations.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a combined embedding vector as an array of floats and metadata about the embedding generation process." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate vector embeddings representing multiple code snippets to perform similarity search, clustering, or downstream analysis on test code samples. Particularly useful in contexts of test code understanding, code search, or embedding-based retrieval related to code tests.", + "limitations": "This tool only generates embeddings for supplied code snippets; it does not analyze or execute code. Quality depends on embedding model chosen and code snippet quality.", + "examples": [ + "Create a test embedding from 3 JavaScript unit test functions for similarity search.", + "Generate embeddings for a set of Python and Java test methods for indexing in a code search engine." + ] + }, + "tags": [ + "embedding", + "code", + "test", + "vectorization", + "code-analysis", + "code-search" + ], + "examples": [ + { + "inputJson": "{\"codeSnippets\":[{\"code\":\"def test_add():\\n assert add(1, 2) == 3\",\"language\":\"python\"},{\"code\":\"function testAdd() { assert(add(1,2) === 3); }\",\"language\":\"javascript\"}],\"embeddingModel\":\"codebert-base\",\"normalize\":true}", + "description": "Generate a combined embedding from Python and JavaScript test functions using the 'codebert-base' model." + }, + { + "inputJson": "{\"codeSnippets\":[{\"code\":\"@Test public void testAdd() { assertEquals(3, add(1,2)); }\",\"language\":\"java\"}],\"embeddingModel\":\"text-embedding-ada-002\",\"normalize\":false}", + "description": "Generate an embedding vector from a single Java test method without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Test", + "context": null + } + }, + { + "name": "embedding-generation.createQuery", + "description": "Generates a vector embedding for a given query text to facilitate semantic search or similarity comparisons. Accepts plain text as input, processes it using a specified embedding model, and returns a fixed-length numeric vector representing the semantic content of the query.", + "category": "embedding-generation", + "parameters": [ + { + "name": "queryText", + "type": "string", + "description": "The input text query for which to generate the embedding.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to use (e.g., 'openai/text-embedding-ada-002').", + "required": false, + "defaultValue": "openai/text-embedding-ada-002" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the resulting embedding vector to unit length.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the original query text and its corresponding embedding vector array of floats." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to convert a textual query into a numerical vector representation for use in vector search, retrieval augmentation, recommendation systems, or similarity analyses. The generated embeddings enable semantic understanding beyond keyword matching.", + "limitations": "This tool does not handle batch embedding generation or embedding of non-textual data. The quality of the embedding depends on the chosen model and may not capture domain-specific nuances without fine-tuning.", + "examples": [ + "Generate an embedding vector for a user search query to find relevant documents.", + "Create a semantic vector for a question to compare with FAQ embeddings.", + "Convert short text queries into vectors for similarity ranking in a chatbot." + ] + }, + "tags": [ + "embedding", + "query", + "vector", + "semantic-search", + "nlp", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"queryText\": \"How to integrate vector search in my app?\", \"embeddingModel\": \"openai/text-embedding-ada-002\", \"normalize\": true}", + "description": "Generate a normalized embedding vector for a typical user query about integrating vector search." + }, + { + "inputJson": "{\"queryText\": \"Best practices for semantic similarity\", \"normalize\": false}", + "description": "Create an embedding without normalization for a text about best practices in semantic similarity." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Query", + "context": null + } + }, + { + "name": "embedding-generation.createAPI", + "description": "This tool generates a ready-to-use RESTful API server code scaffold that wraps a specified embedding generation model. It accepts model details and configuration, and outputs code templates in the chosen programming language that serve embedding vectors for given input texts.", + "category": "embedding-generation", + "parameters": [ + { + "name": "modelName", + "type": "string", + "description": "The name or identifier of the embedding model to be used (e.g., 'text-embedding-ada-002').", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language for the generated API server code (e.g., 'Python', 'Node.js').", + "required": true, + "defaultValue": "" + }, + { + "name": "apiEndpoint", + "type": "string", + "description": "The API path for embedding requests (default '/embed').", + "required": false, + "defaultValue": "/embed" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Whether to include authentication middleware in the API scaffold.", + "required": false, + "defaultValue": "false" + }, + { + "name": "openAiApiKeyEnvVar", + "type": "string", + "description": "Name of environment variable to read the OpenAI API key from, if applicable.", + "required": false, + "defaultValue": "OPENAI_API_KEY" + }, + { + "name": "port", + "type": "number", + "description": "The port number that the API server will listen on.", + "required": false, + "defaultValue": "8080" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated API server source code as a string, ready to be written to a file and run." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly generate a minimal, practical API server that exposes an embedding generation model as a REST endpoint. It enables programmatic access to embeddings via HTTP calls in standard programming languages, facilitating easy integration into applications or pipelines.", + "limitations": "Does not implement production-hardened features like rate limiting, advanced authentication, or multi-model management. Assumes embedding model is externally accessible via API or library.", + "examples": [ + "Generate a Python Flask API that wraps the OpenAI embedding model 'text-embedding-ada-002'.", + "Create a Node.js Express API endpoint for producing text embeddings on port 5000 with authentication enabled.", + "Produce server code for an embedding API using a custom embedding model name, available via environment variable OpenAI key." + ] + }, + "tags": [ + "embedding-generation", + "API", + "code-generation", + "REST", + "server", + "openai", + "text-embedding" + ], + "examples": [ + { + "inputJson": "{\"modelName\":\"text-embedding-ada-002\",\"programmingLanguage\":\"Python\",\"apiEndpoint\":\"/embed\",\"authenticationRequired\":false,\"openAiApiKeyEnvVar\":\"OPENAI_API_KEY\",\"port\":8080}", + "description": "Generate a Python Flask API endpoint '/embed' that returns embeddings from the OpenAI 'text-embedding-ada-002' model with no authentication, listening on port 8080." + }, + { + "inputJson": "{\"modelName\":\"custom-embedding-v1\",\"programmingLanguage\":\"Node.js\",\"apiEndpoint\":\"/v1/embeddings\",\"authenticationRequired\":true,\"openAiApiKeyEnvVar\":\"MY_API_KEY\",\"port\":5000}", + "description": "Generate a Node.js Express API at '/v1/embeddings' requiring auth middleware, using a custom embedding model and API key environment variable 'MY_API_KEY' on port 5000." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "embedding-generation.createMigration", + "description": "Generates a code migration script that updates embedding generation logic from one model or schema version to another. Accepts current and target embedding model details, and produces a migration script that automates refactoring embedding generation calls and configuration in codebases.", + "category": "embedding-generation", + "parameters": [ + { + "name": "currentModelVersion", + "type": "string", + "description": "The current version identifier or name of the embedding model used in the code base.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetModelVersion", + "type": "string", + "description": "The target embedding model version to migrate the codebase to.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceCodeLanguage", + "type": "string", + "description": "Programming language of the source code to generate the migration script for (e.g., Python, JavaScript).", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingFunctionName", + "type": "string", + "description": "Name of the function or method responsible for embedding generation in the existing code.", + "required": false, + "defaultValue": "generateEmbedding" + }, + { + "name": "includeDocumentationUpdates", + "type": "boolean", + "description": "Whether to include automated updates to code comments and documentation about embedding changes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the migration script code as a string plus a summary of changes for review." + }, + "aiAgent": { + "useCase": "Use this tool when needing to upgrade or refactor embedding generation in codebases across model versions or APIs, automating the tedious and error-prone process of updating embedding logic and signatures to ensure consistency and accuracy.", + "limitations": "This tool does not test the generated migration script or run it; it produces suggested migration code and summaries, requiring developer review and integration.", + "examples": [ + "Create a migration script to move embedding calls from model v1 to v2 in a Python codebase.", + "Generate migration code updating embedding function name and parameters when switching embedding APIs in JavaScript." + ] + }, + "tags": [ + "embedding-generation", + "migration", + "code-refactoring", + "automation", + "ai-model-update" + ], + "examples": [ + { + "inputJson": "{\"currentModelVersion\":\"v1\",\"targetModelVersion\":\"v2\",\"sourceCodeLanguage\":\"Python\",\"embeddingFunctionName\":\"embed_text\",\"includeDocumentationUpdates\":true}", + "description": "Generate migration script from embedding model v1 to v2 in Python codebase where embedding function is named 'embed_text' with doc updates." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Migration", + "context": null + } + }, + { + "name": "embedding-generation.createEndpoint", + "description": "This tool creates a customizable API endpoint configured to generate vector embeddings from text inputs using specified embedding models. It accepts parameters defining the endpoint path, supported models, maximum input length, and batching options, and outputs the endpoint configuration details needed for deployment or integration.", + "category": "embedding-generation", + "parameters": [ + { + "name": "endpointPath", + "type": "string", + "description": "The URL path where the embedding generation endpoint will be accessible, e.g., /api/embeddings.", + "required": true, + "defaultValue": "" + }, + { + "name": "supportedModels", + "type": "array", + "description": "List of embedding model identifiers that this endpoint will support for generating embeddings.", + "required": true, + "defaultValue": "[\"text-embedding-ada-002\"]" + }, + { + "name": "maxInputLength", + "type": "number", + "description": "Maximum length (in tokens or characters) for input text that the endpoint will accept.", + "required": false, + "defaultValue": "2048" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of input texts to process in one batch to optimize throughput and latency.", + "required": false, + "defaultValue": "16" + }, + { + "name": "enableLogging", + "type": "boolean", + "description": "Whether to enable request and response logging for the endpoint.", + "required": false, + "defaultValue": "false" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Flag to require authentication (e.g., API key) to access the endpoint.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the endpoint configuration details, including the full access URL, supported models, input constraints, and security settings." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create a new API endpoint for generating vector embeddings from textual data, customizing it with supported models, input limits, authentication, and batching to integrate embedding capabilities into applications or services.", + "limitations": "This tool configures the endpoint but does not implement the underlying embedding model or hosting infrastructure; deployment and model serving must be handled separately.", + "examples": [ + "Create an embedding endpoint at /api/embed using 'text-embedding-ada-002' and 'text-embedding-babbage-001' models.", + "Create a public embedding endpoint with no authentication and logging enabled for experimental use.", + "Set up an embedding endpoint that batches input in sizes of 32 and limits input length to 1024 tokens." + ] + }, + "tags": [ + "embedding", + "API", + "endpoint", + "configuration", + "vectorization", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"endpointPath\":\"/api/embeddings\",\"supportedModels\":[\"text-embedding-ada-002\"],\"maxInputLength\":2048,\"batchSize\":16,\"enableLogging\":false,\"authenticationRequired\":true}", + "description": "Create a secure embedding endpoint at /api/embeddings supporting the 'text-embedding-ada-002' model with default input length and batch size." + }, + { + "inputJson": "{\"endpointPath\":\"/embed/public\",\"supportedModels\":[\"text-embedding-ada-002\",\"text-embedding-babbage-001\"],\"maxInputLength\":1024,\"batchSize\":32,\"enableLogging\":true,\"authenticationRequired\":false}", + "description": "Create a public embedding endpoint supporting multiple models, with logging enabled and larger batch size for throughput." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Endpoint", + "context": null + } + }, + { + "name": "embedding-generation.createSchema", + "description": "Creates a JSON schema definition for embedding vector data according to specified dimensions and metadata requirements. Accepts parameters such as embedding dimension size, metadata fields, and data types, producing a structured JSON schema for validating embedding documents in databases or APIs.", + "category": "embedding-generation", + "parameters": [ + { + "name": "embeddingDimension", + "type": "number", + "description": "The size (dimensionality) of the embedding vectors to define in the schema.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Flag to include additional metadata fields in the schema (e.g., source, timestamp).", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadataFields", + "type": "array", + "description": "List of metadata field names to include when includeMetadata is true.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadataTypes", + "type": "object", + "description": "Map of metadata field names to their data types (e.g., string, number, date).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "requiredMetadataFields", + "type": "array", + "description": "List of metadata fields that are mandatory in the schema.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the schema definition that can be used to validate embedding documents, including the embedding vector and optional metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate a JSON schema for embedding vectors and their associated metadata to perform validation or database schema enforcement. This is useful when setting up data ingestion pipelines or APIs expecting embedding data with consistent structure and required fields.", + "limitations": "This tool does not generate embedding vectors or perform actual embedding; it only creates the schema for their structure. It also does not validate data against the schema, only produces the schema itself.", + "examples": [ + "Generate a JSON schema for 512-dimensional embeddings without metadata.", + "Create a schema for 768-dimensional embeddings including metadata fields 'source' (string) and 'timestamp' (date), with 'source' as required.", + "Produce a schema for embeddings of dimension 1024 with no metadata fields." + ] + }, + "tags": [ + "embedding", + "schema", + "validation", + "json-schema", + "vector", + "metadata", + "data-modeling" + ], + "examples": [ + { + "inputJson": "{\"embeddingDimension\":512,\"includeMetadata\":false}", + "description": "Create a simple schema for a 512-d embedding vector with no metadata." + }, + { + "inputJson": "{\"embeddingDimension\":768,\"includeMetadata\":true,\"metadataFields\":[\"source\",\"timestamp\"],\"metadataTypes\":{\"source\":\"string\",\"timestamp\":\"string\"},\"requiredMetadataFields\":[\"source\"]}", + "description": "Schema for 768-d embedding with metadata fields 'source' (required) and 'timestamp'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Schema", + "context": null + } + }, + { + "name": "embedding-generation.createModule", + "description": "Creates a reusable code module that generates vector embeddings from text data. Accepts configuration parameters including embedding model type, input text language, and preprocessing options. Produces a code module in the specified programming language with functions for embedding generation and integration guidance.", + "category": "embedding-generation", + "parameters": [ + { + "name": "embeddingModel", + "type": "string", + "description": "The embedding model to use (e.g., 'bert-base-uncased', 'openai-text-embedding-ada-002').", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Target programming language for the generated module code (e.g., 'python', 'javascript').", + "required": true, + "defaultValue": "python" + }, + { + "name": "inputLanguage", + "type": "string", + "description": "Primary language of input text to be embedded (e.g., 'en', 'fr', 'zh').", + "required": false, + "defaultValue": "en" + }, + { + "name": "preprocessingSteps", + "type": "array", + "description": "List of preprocessing steps to include in the module (e.g., ['lowercase','removePunctuation']).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeExampleUsage", + "type": "boolean", + "description": "Whether to include example usage code snippet in the module.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated source code as a string and metadata about the module, including language and dependencies." + }, + "aiAgent": { + "useCase": "Use this tool to automatically generate a ready-to-use code module for producing text embeddings tailored to a chosen embedding model and programming language. Helpful for developers integrating embedding generation into their applications without writing boilerplate code manually.", + "limitations": "This tool does not train or fine-tune embedding models, nor does it perform embedding generation itself. It only generates code modules. It cannot guarantee compatibility with all third-party libraries or runtime environments.", + "examples": [ + "Generate a Python module using the 'bert-base-uncased' model that preprocesses text by lowercasing and removing punctuation.", + "Create a JavaScript module with example usage to embed French language text using 'openai-text-embedding-ada-002'." + ] + }, + "tags": [ + "embedding-generation", + "module", + "code-generation", + "text-processing", + "developer-tool" + ], + "examples": [ + { + "inputJson": "{\"embeddingModel\":\"bert-base-uncased\",\"programmingLanguage\":\"python\",\"inputLanguage\":\"en\",\"preprocessingSteps\":[\"lowercase\",\"removePunctuation\"],\"includeExampleUsage\":true}", + "description": "Generate a Python embedding module using BERT-base with lowercasing and punctuation removal preprocessing." + }, + { + "inputJson": "{\"embeddingModel\":\"openai-text-embedding-ada-002\",\"programmingLanguage\":\"javascript\",\"inputLanguage\":\"fr\",\"preprocessingSteps\":[],\"includeExampleUsage\":true}", + "description": "Create a JavaScript module for OpenAI's ada text embedding for French text without preprocessing steps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "embedding-generation.createComponent", + "description": "Creates a reusable embedding generation component configuration based on specified model and parameters. Accepts inputs like model name, embedding dimension, tokenizer options, and returns a component definition object usable in AI pipelines for generating vector embeddings from textual data.", + "category": "embedding-generation", + "parameters": [ + { + "name": "modelName", + "type": "string", + "description": "Name of the embedding model to use for component creation, e.g., 'text-embedding-ada-002'.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingDimension", + "type": "number", + "description": "Output dimension size of the embedding vectors that the component will produce.", + "required": true, + "defaultValue": "" + }, + { + "name": "tokenizerOptions", + "type": "object", + "description": "Optional tokenizer configuration including max token length and special token handling.", + "required": false, + "defaultValue": "" + }, + { + "name": "normalizeEmbeddings", + "type": "boolean", + "description": "Whether to normalize the output embeddings to unit length for consistent vector representation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "componentName", + "type": "string", + "description": "Optional custom name to assign to the created embedding component.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object defining the embedding generation component, including model name, preprocessing options, embedding dimension, and methods to embed input text." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create reusable, configurable embedding generator components within an AI pipeline or application, especially to standardize how text is embedded using specific models and tokenization parameters. Suitable for development environments or custom ML workflows configuring vectorization steps.", + "limitations": "This tool does not execute the embedding generation itself; it only creates configuration components. It cannot process raw text inputs or return embeddings directly. It requires downstream systems to call the generated component to perform embedding.", + "examples": [ + "Create an embedding component for 'text-embedding-ada-002' with 1536 dimensions, using default tokenizer options.", + "Generate a normalized embedding component named 'MyCustomEmbedder' with 768 dimensions and custom tokenizer max token length.", + "Create embedding component with no normalization and default model settings." + ] + }, + "tags": [ + "embedding", + "component", + "vectorization", + "text-processing", + "AI-pipeline" + ], + "examples": [ + { + "inputJson": "{\"modelName\":\"text-embedding-ada-002\",\"embeddingDimension\":1536,\"normalizeEmbeddings\":true}", + "description": "Create a component using 'text-embedding-ada-002' model with 1536 dimensions and normalized embeddings." + }, + { + "inputJson": "{\"modelName\":\"custom-transformer\",\"embeddingDimension\":768,\"tokenizerOptions\":{\"maxLength\":512},\"componentName\":\"MyCustomEmbedder\",\"normalizeEmbeddings\":false}", + "description": "Create a custom named embedding component with specified tokenizer max length and without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Component", + "context": null + } + }, + { + "name": "embedding-generation.createFunction", + "description": "Creates a vector embedding generation function based on specified text preprocessing settings and model parameters. Accepts input text data, applies optional normalization and tokenization, then outputs a function that can generate embeddings for new text inputs according to the configured model.", + "category": "embedding-generation", + "parameters": [ + { + "name": "modelName", + "type": "string", + "description": "The identifier of the embedding model to use (e.g., 'bert-base', 'sentence-transformers').", + "required": true, + "defaultValue": "" + }, + { + "name": "normalizeText", + "type": "boolean", + "description": "Whether to apply text normalization steps like lowercasing and removing punctuation before embedding.", + "required": false, + "defaultValue": "true" + }, + { + "name": "tokenizerOptions", + "type": "object", + "description": "Configuration parameters for the tokenizer such as max sequence length, truncation, and padding.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "embeddingDimension", + "type": "number", + "description": "Dimensionality of the output embedding vectors. If not specified, uses the model's default dimension.", + "required": false, + "defaultValue": "" + }, + { + "name": "batchSize", + "type": "number", + "description": "Number of text inputs to process in a batch when generating embeddings to optimize performance.", + "required": false, + "defaultValue": "32" + } + ], + "returns": { + "type": "object", + "description": "A callable function that accepts an array of texts and returns an array of embedding vectors matching the configured model and preprocessing parameters." + }, + "aiAgent": { + "useCase": "Use this tool to configure and obtain a customized embedding function for text data, allowing downstream AI tasks like similarity search, clustering, or semantic analysis with embeddings generated under specific model and preprocessing conditions.", + "limitations": "This tool does not itself generate embeddings until the returned function is called with text inputs; it relies on underlying models provided externally and does not perform model training or fine-tuning.", + "examples": [ + "Create an embedding function using 'sentence-transformers' model with normalization enabled.", + "Configure a function for embedding texts with max token length set via tokenizer options.", + "Set up a function generating 768-dimensional embeddings with batching for efficient bulk processing." + ] + }, + "tags": [ + "embedding", + "function", + "text-processing", + "vectorization", + "model-config" + ], + "examples": [ + { + "inputJson": "{\"modelName\":\"sentence-transformers/all-MiniLM-L6-v2\",\"normalizeText\":true,\"tokenizerOptions\":{\"maxLength\":128,\"truncation\":true},\"embeddingDimension\":384,\"batchSize\":16}", + "description": "Create embedding function using a popular lightweight transformer model with normalization and truncation." + }, + { + "inputJson": "{\"modelName\":\"bert-base-uncased\",\"normalizeText\":false,\"tokenizerOptions\":{},\"batchSize\":32}", + "description": "Create embedding function with BERT base model without text normalization and default tokenizer settings." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "embedding-generation.createSpec", + "description": "Generates a detailed embedding specification document for a given textual domain description, including embedding dimensions, tokenization rules, and preprocessing steps required for consistent vector generation. Accepts domain description and configuration options, outputs a structured embedding specification as JSON.", + "category": "embedding-generation", + "parameters": [ + { + "name": "domainDescription", + "type": "string", + "description": "Detailed textual description of the domain or dataset for which embeddings are to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingDimension", + "type": "number", + "description": "The dimensionality of the embedding vectors to generate, typically between 50 and 1024.", + "required": true, + "defaultValue": "512" + }, + { + "name": "tokenizationMethod", + "type": "string", + "description": "The tokenization approach to use, e.g., 'word', 'subword', or 'character'.", + "required": false, + "defaultValue": "subword" + }, + { + "name": "preprocessingSteps", + "type": "array", + "description": "An ordered list of preprocessing actions to apply, such as 'lowercase', 'removePunctuation', 'lemmatization'.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeStopWords", + "type": "boolean", + "description": "Flag indicating whether stop words should be included in the embeddings or filtered out during preprocessing.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A JSON object specifying the embedding configuration including dimension, tokenization method, preprocessing pipeline, and metadata for embedding generation." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to create a precise specification document for generating embeddings tailored to a specific textual domain or dataset, to ensure consistent and optimized vector representations for downstream tasks such as search, clustering, or classification.", + "limitations": "This tool generates a specification document only, and does not perform embedding vector computation or training itself. It requires detailed domain input for best results.", + "examples": [ + "Create an embedding spec for legal documents with 300 dimensions, subword tokenization, removing punctuation, and excluding stop words.", + "Generate a spec for customer support chat logs embeddings, using 512 dimensions and including lemmatization in preprocessing.", + "Produce an embedding configuration for scientific abstracts with 768 dimensions, word tokenization, and including stop words." + ] + }, + "tags": [ + "embedding", + "specification", + "vector", + "text processing", + "tokenization", + "preprocessing" + ], + "examples": [ + { + "inputJson": "{\"domainDescription\":\"Customer support chat logs for tech products.\",\"embeddingDimension\":512,\"tokenizationMethod\":\"subword\",\"preprocessingSteps\":[\"lowercase\",\"lemmatization\"],\"includeStopWords\":false}", + "description": "Generate an embedding specification for tech product support chat logs with 512 dimensions, subword tokenization, lowercase and lemmatization preprocessing, excluding stop words." + }, + { + "inputJson": "{\"domainDescription\":\"Legal contract clauses.\",\"embeddingDimension\":300,\"tokenizationMethod\":\"word\",\"preprocessingSteps\":[\"removePunctuation\"],\"includeStopWords\":false}", + "description": "Create embedding spec for legal contracts using 300-dimensional word embeddings, removing punctuation, without stop words." + }, + { + "inputJson": "{\"domainDescription\":\"Scientific research abstracts.\",\"embeddingDimension\":768,\"tokenizationMethod\":\"word\",\"preprocessingSteps\":[],\"includeStopWords\":true}", + "description": "Produce embedding specification for scientific abstracts with 768-dimensional word embeddings, no preprocessing steps, including stop words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Spec", + "context": null + } + }, + { + "name": "embedding-generation.createFAQ", + "description": "Creates vector embeddings for a set of frequently asked questions (FAQs) and their answers, enabling semantic search and similarity tasks. Accepts an array of FAQ entries each with question and answer, optionally specifying embedding model and language. Outputs a structured array of embeddings linked to each FAQ entry.", + "category": "embedding-generation", + "parameters": [ + { + "name": "faqs", + "type": "array", + "description": "Array of FAQ entries where each entry is an object with 'question' and 'answer' strings.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use for generating vector representations.", + "required": false, + "defaultValue": "\"default-faq-embedding-v1\"" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') of the FAQ content to optimize embedding generation.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "normalizeVectors", + "type": "boolean", + "description": "Whether to normalize the output embeddings to unit length for cosine similarity purposes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with array of embeddings, each entry correlates to the input FAQ including question, answer, and the embedding vector as an array of numbers." + }, + "aiAgent": { + "useCase": "Use this tool when you have a collection of FAQs and want to create vector embeddings for them to enable semantic search, clustering, or similarity comparison, for example to build intelligent FAQ retrieval systems or customer support automation.", + "limitations": "This tool does not generate or summarize FAQ content, only creates embeddings from provided FAQ question-answer pairs. It does not index the embeddings or perform search queries itself.", + "examples": [ + "Create embeddings for a product's customer support FAQs to integrate semantic search.", + "Generate vector representations of FAQs in multiple languages for a multilingual help center.", + "Embed a set of training FAQs for a chatbot knowledge base to improve answer relevance." + ] + }, + "tags": [ + "embedding-generation", + "faq", + "semantic-search", + "vectorization", + "nlp", + "customer-support" + ], + "examples": [ + { + "inputJson": "{\"faqs\":[{\"question\":\"What is your return policy?\",\"answer\":\"You can return any item within 30 days of purchase.\"},{\"question\":\"How do I track my order?\",\"answer\":\"Once shipped, you will receive a tracking number via email.\"}]}", + "description": "Embedding generation for a small set of e-commerce customer service FAQs." + }, + { + "inputJson": "{\"faqs\":[{\"question\":\"¿Cómo puedo restablecer mi contraseña?\",\"answer\":\"Puede restablecerla desde la página de configuración de la cuenta.\"}],\"language\":\"es\"}", + "description": "Create embeddings for FAQs provided in Spanish by specifying language parameter." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "FAQ", + "context": null + } + }, + { + "name": "embedding-generation.createReadme", + "description": "Generates a detailed README document embedding by processing project-related textual input. Accepts textual project descriptions, features, and usage instructions, then creates a structured textual README suitable for embedding generation workflows. Outputs the final README content as a string for embedding purposes.", + "category": "embedding-generation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to appear as the README title.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A concise description explaining the purpose and scope of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "An array of strings listing key features or highlights of the project.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions on how to install or set up the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "array", + "description": "An array of strings providing practical usage examples or code snippets.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "license", + "type": "string", + "description": "The type of license the project is released under, to be included as a README section.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated README content as a single markdown-formatted string under the key 'readmeContent'." + }, + "aiAgent": { + "useCase": "Use this tool when needing a well-structured README document text that can later be embedded into vector representations for search, classification, or documentation indexing. Ideal for projects needing automated README generation from descriptive inputs prior to embedding.", + "limitations": "This tool generates only textual content for a README document; it does not create actual embeddings or handle binary files like images or diagrams. It also assumes input text is in English and does not validate or enrich the content beyond formatting.", + "examples": [ + "Generate a README embedding text for a new JavaScript library by providing name, description, features, installation, usage, and license.", + "Create a README text embedding from minimal inputs: only project name and description.", + "Produce a README markdown text with detailed installation and usage instructions for embedding vectorization." + ] + }, + "tags": [ + "embedding", + "readme", + "documentation", + "text-generation", + "project-description", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"FastAPI Utils\",\"projectDescription\":\"A Python utility library for simplifying FastAPI development.\",\"features\":[\"Lightweight\",\"Easy integration\",\"Asynchronous support\"],\"installationInstructions\":\"Run `pip install fastapi-utils` to install.\",\"usageExamples\":[\"from fastapi_utils import FastAPIUtils\",\"app = FastAPIUtils()\"],\"license\":\"MIT\"}", + "description": "Generating README content embedding text for a Python FastAPI utility library with typical README sections." + }, + { + "inputJson": "{\"projectName\":\"DataCleanser\",\"projectDescription\":\"Tool for fast cleansing of CSV datasets.\"}", + "description": "Generating minimal README content embedding text with just project name and description for a CSV data processing tool." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Readme", + "context": null + } + }, + { + "name": "embedding-generation.createCode", + "description": "Generates vector embeddings specifically for source code snippets or files. Accepts code as a string input along with language specification, processes the code to create semantic vector representations capturing syntax and semantics. Outputs an embedding array suitable for code search, clone detection, or recommendation tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The source code snippet/text to embed, provided as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the code (e.g., 'python', 'java', 'javascript') to optimize embedding.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingDimension", + "type": "number", + "description": "Dimension of the output embedding vector, determining size and detail of representation.", + "required": false, + "defaultValue": "768" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the output embedding vector to unit length.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embedding vector as an array of numbers representing the semantic embedding of the input code snippet." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert source code snippets or files into vector embeddings for tasks like code search, similarity detection, clone detection, or code recommendation within repositories. It captures semantic and syntactic features of the code.", + "limitations": "This tool only generates embeddings for code as text input; it does not analyze execution behavior or runtime performance. Language support depends on the specified input language; unsupported languages may yield less accurate embeddings.", + "examples": [ + "Generate embedding for a Python function to find similar functions in a codebase.", + "Create embeddings for JavaScript snippets for use in a code recommendation engine.", + "Normalize code embeddings to ensure consistency when comparing syntax vectors." + ] + }, + "tags": [ + "embedding", + "code", + "source-code", + "programming", + "vector", + "semantic", + "search" + ], + "examples": [ + { + "inputJson": "{\"code\":\"def add(a, b):\\n return a + b\",\"language\":\"python\"}", + "description": "Generate a normalized embedding for a simple Python add function." + }, + { + "inputJson": "{\"code\":\"function greet(name) { return `Hello, ${name}!`; }\",\"language\":\"javascript\",\"normalize\":false}", + "description": "Create a non-normalized embedding vector for a JavaScript greeting function." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Code", + "context": null + } + }, + { + "name": "embedding-generation.createTemplate", + "description": "Creates a customizable embedding generation template for document or domain-specific text processing. Accepts parameters defining the document domain, embedding model preferences, and template structure. Outputs a structured JSON template guiding embedding generation workflows for consistent vector embedding creation across similar document types.", + "category": "embedding-generation", + "parameters": [ + { + "name": "documentDomain", + "type": "string", + "description": "The specific domain or type of documents for which to create the embedding template (e.g., legal contracts, scientific papers).", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to be used with this template (e.g., 'text-embedding-ada-002').", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "templateDescription", + "type": "string", + "description": "A descriptive summary about the purpose and use of the generated embedding template.", + "required": false, + "defaultValue": "" + }, + { + "name": "fieldsToEmbed", + "type": "array", + "description": "An array of text fields or sections from documents that should be processed to create embeddings (e.g., ['title', 'abstract', 'body']).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "preprocessingInstructions", + "type": "string", + "description": "Optional instructions or rules for preprocessing text before embedding generation, such as tokenization, cleaning, or normalization guidelines.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Specifies whether to include document metadata as part of the embedding template context.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the embedding generation template, including domain, model settings, targeted fields, and preprocessing guidelines." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to establish standardized embedding specifications for text documents within specific domains. Typical scenarios include setting up embedding pipelines for legal documents, research papers, support tickets, or other domain-specific corpora to ensure consistent vector representations across applications.", + "limitations": "This tool does not generate embeddings directly but creates templates or specifications to guide embedding generation steps. It cannot preprocess or embed raw text by itself.", + "examples": [ + "Create an embedding template for legal contracts focusing on clauses and summaries using the 'text-embedding-ada-002' model.", + "Generate a template for scientific papers highlighting abstract and conclusion sections with preprocessing instructions to remove references.", + "Build a domain-specific embedding template for customer support tickets including metadata like ticket priority." + ] + }, + "tags": [ + "embedding", + "template", + "document-domain", + "vector embeddings", + "text processing", + "machine learning" + ], + "examples": [ + { + "inputJson": "{\"documentDomain\":\"legal contracts\",\"embeddingModel\":\"text-embedding-ada-002\",\"templateDescription\":\"Template for embedding contract clauses and summaries\",\"fieldsToEmbed\":[\"clauses\",\"summary\"],\"preprocessingInstructions\":\"Remove stopwords and legal citations\",\"includeMetadata\":true}", + "description": "Embedding template for legal contract clauses and summaries with cleaning instructions and metadata inclusion." + }, + { + "inputJson": "{\"documentDomain\":\"scientific papers\",\"embeddingModel\":\"text-embedding-ada-002\",\"templateDescription\":\"Embedding template focusing on abstract and conclusion\",\"fieldsToEmbed\":[\"abstract\",\"conclusion\"],\"preprocessingInstructions\":\"Lowercase, remove references section\",\"includeMetadata\":false}", + "description": "Template creation for embeddings of key scientific paper sections without metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Template", + "context": null + } + }, + { + "name": "embedding-generation.createSummary", + "description": "Generates a concise textual summary from a provided document to distill key points and main ideas. Accepts raw text or URL input, applies natural language processing to identify salient information, and outputs a summarized version suitable for embedding or quick understanding.", + "category": "embedding-generation", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "Raw text content of the document to be summarized. Provide either this or documentUrl, but at least one is required.", + "required": false, + "defaultValue": "" + }, + { + "name": "documentUrl", + "type": "string", + "description": "URL of the document to fetch and summarize if documentText is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate desired length of the summary in number of sentences. Defaults to 3 sentences.", + "required": false, + "defaultValue": "3" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the document text for accurate processing (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeywords", + "type": "boolean", + "description": "Whether to append important keywords extracted from the document to the summary output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and, optionally, extracted keywords if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing a vector-friendly compact representation of a document's main content, useful for embedding generation, quick previews, or content indexing. Ideal for summarizing lengthy documents into bite-sized textual snippets to improve downstream embedding quality and retrieval speed.", + "limitations": "Cannot process multimedia or non-text content directly. Summaries may lose nuanced details in complex or highly technical documents. Quality depends on language support and input document clarity.", + "examples": [ + "Summarize a research article text into 5 sentences.", + "Generate a short summary from a news article URL.", + "Create a brief summary with keywords from a company report text." + ] + }, + "tags": [ + "embedding", + "summary", + "document", + "nlp", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"Climate change is causing Earth's average temperatures to rise, leading to various environmental impacts such as melting ice, rising sea levels, and more extreme weather events.\",\"summaryLength\":2,\"includeKeywords\":true}", + "description": "Summarizes a short text about climate change into 2 sentences with keywords." + }, + { + "inputJson": "{\"documentUrl\":\"https://example.com/long-article\",\"summaryLength\":4,\"language\":\"en\"}", + "description": "Generates a 4-sentence summary from an article accessed via URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "embedding-generation.createChecklist", + "description": "Generates a structured checklist document embedding from an input checklist defined by items, categories, and optional metadata. It processes the checklist text and metadata to create vector embeddings representing each checklist item and category, enabling semantic search and similarity operations on checklist content.", + "category": "embedding-generation", + "parameters": [ + { + "name": "checklistTitle", + "type": "string", + "description": "Title of the checklist document to embed, providing context.", + "required": true, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "An array of checklist items; each item is an object with text and optional category tags.", + "required": true, + "defaultValue": "" + }, + { + "name": "categories", + "type": "array", + "description": "Optional array of category names that group checklist items, enhancing semantic structure.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Flag indicating whether to embed additional metadata such as priority or due dates for items.", + "required": false, + "defaultValue": "false" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to use (e.g., 'default-embedding-v1').", + "required": false, + "defaultValue": "default-embedding-v1" + } + ], + "returns": { + "type": "object", + "description": "An object containing the checklist title, a list of embedded items with their vector embeddings, and optionally category embeddings and metadata embeddings if included." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert a detailed checklist document — including categorized items and optional metadata — into vector embeddings for semantic search, similarity detection, or further NLP analysis in AI workflows. Useful for task management platforms, quality assurance processes, or knowledge base indexing that rely on embedding representations of checklist content.", + "limitations": "This tool does not perform natural language understanding beyond embedding generation; it cannot interpret checklist semantics, validate item correctness, or generate checklist content. Embedding quality depends on the selected model and input text clarity.", + "examples": [ + "Create a checklist embedding for a product launch QA checklist with items grouped by testing types.", + "Generate checklist embeddings from a safety inspection list including priority tags as metadata.", + "Convert a project task checklist with categories into embeddings for semantic retrieval." + ] + }, + "tags": [ + "embedding", + "checklist", + "document", + "semantic", + "vector", + "task", + "metadata" + ], + "examples": [ + { + "inputJson": "{\"checklistTitle\":\"Software Release QA Checklist\",\"items\":[{\"text\":\"Verify all unit tests pass\",\"category\":\"Testing\"},{\"text\":\"Update release notes\",\"category\":\"Documentation\"},{\"text\":\"Deploy to staging environment\",\"category\":\"Deployment\"}],\"categories\":[\"Testing\",\"Documentation\",\"Deployment\"],\"includeMetadata\":false}", + "description": "Embedding generation for a QA checklist categorized by testing, documentation, and deployment tasks." + }, + { + "inputJson": "{\"checklistTitle\":\"Safety Inspection Checklist\",\"items\":[{\"text\":\"Check fire extinguishers expiration date\",\"category\":\"Equipment\",\"priority\":\"High\"},{\"text\":\"Ensure emergency exits are clear\",\"category\":\"Facility\",\"priority\":\"Critical\"}],\"categories\":[\"Equipment\",\"Facility\"],\"includeMetadata\":true}", + "description": "Embedding generation for a safety inspection checklist including priority metadata for each item." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Checklist", + "context": null + } + }, + { + "name": "embedding-generation.createChangelog", + "description": "Generates a detailed vector embedding representation of a software project's changelog document. Accepts raw changelog text or structured JSON describing version updates, processes it to capture semantic features and context, and outputs embeddings suitable for similarity search, clustering, or analysis of changelog content evolution.", + "category": "embedding-generation", + "parameters": [ + { + "name": "changelogText", + "type": "string", + "description": "Raw text content of the changelog document, including version descriptions and update notes.", + "required": false, + "defaultValue": "" + }, + { + "name": "structuredChangelog", + "type": "object", + "description": "Optional structured JSON object representing the changelog, with versions, dates, and change lists, to generate embeddings from a cleaner input format.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The identifier of the embedding model to use (e.g., 'text-embedding-ada-002').", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "includeVersionVectors", + "type": "boolean", + "description": "Whether to generate separate embeddings for each version section in the changelog instead of a single embedding for the entire document.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the changelog text to optimize embedding model tokenization and accuracy (e.g., 'en').", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated embeddings in vector form. If includeVersionVectors is true, returns a map from version identifiers to embedding arrays; otherwise a single embedding array representing the entire changelog." + }, + "aiAgent": { + "useCase": "Use this tool when an AI system needs to semantically analyze or index software project changelogs for search, comparison, or trend detection, converting the text content into numerical vector form useful for downstream ML tasks or similarity queries. It supports both raw text and structured changelog inputs and can embed complete documents or individual version entries.", + "limitations": "This tool does not generate changelog text, interpret changelog semantics beyond embedding, or validate changelog content correctness.", + "examples": [ + "Generate embedding vectors from a raw changelog text to enable searching for similar updates across projects.", + "Create embeddings from structured changelog JSON to cluster software versions by similarity of changes.", + "Produce individual embeddings per version section to track semantic changes across software releases." + ] + }, + "tags": [ + "embedding", + "changelog", + "software", + "versioning", + "vectorization", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"changelogText\":\"## v1.0.1 - Bug fixes and minor improvements\\n- Fixed login issue causing crashes\\n- Improved UI response times\",\"embeddingModel\":\"text-embedding-ada-002\",\"includeVersionVectors\":false}", + "description": "Generate a single embedding vector from raw changelog text including version and bullet notes." + }, + { + "inputJson": "{\"structuredChangelog\":{\"versions\":[{\"version\":\"1.0.0\",\"date\":\"2023-01-15\",\"changes\":[\"Initial release\",\"Core features implemented\"]},{\"version\":\"1.0.1\",\"date\":\"2023-02-01\",\"changes\":[\"Fixed login crash\",\"UI performance optimization\"]}]},\"embeddingModel\":\"text-embedding-ada-002\",\"includeVersionVectors\":true}", + "description": "Generate separate embeddings for each version entry from a structured changelog JSON object to analyze the progression of changes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Changelog", + "context": null + } + }, + { + "name": "embedding-generation.createBrief", + "description": "Generates a concise textual summary (brief) for a technical document or dataset description to facilitate embedding creation. Accepts raw text and optional parameters controlling summary length and focus. Outputs a short, coherent brief capturing the document's essential topics, suitable for downstream embedding generation.", + "category": "embedding-generation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The full text content of the technical document or dataset description to summarize.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length of the generated brief summary. Controls brevity.", + "required": false, + "defaultValue": "300" + }, + { + "name": "focusKeywords", + "type": "array", + "description": "Optional list of keywords to emphasize in the brief summary to guide content focus.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text (e.g., 'en') to tailor the summary generation properly.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated brief summary as a string under 'briefText'." + }, + "aiAgent": { + "useCase": "Use this tool when the agent needs to create a concise, coherent summary of a longer technical document or dataset description to generate domain-specific embeddings efficiently. The brief condenses core topics and key information, optimizing embedding quality and retrieval relevance.", + "limitations": "This tool cannot generate detailed or extensive summaries; it produces brief overviews only. It may not capture very nuanced or implicit information and depends on quality and clarity of the input text.", + "examples": [ + "Create a brief summary of a long machine learning research paper abstract for embedding.", + "Generate a concise overview focusing on specified keywords within a dataset documentation to support semantic search embedding.", + "Produce a short summary in English from a longer textual description of a technical specification document." + ] + }, + "tags": [ + "embedding", + "summary", + "brief", + "technical-document", + "nlp", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"text\":\"This document describes the architecture and implementation details of a distributed machine learning framework designed to scale training across multiple GPUs and nodes. It includes modular components for data ingestion, model parallelism, and fault tolerance.\",\"maxLength\":250,\"focusKeywords\":[\"distributed\",\"machine learning\",\"scaling\"]}", + "description": "Summarize a technical document about a distributed machine learning system focusing on scaling and architecture." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Brief", + "context": null + } + }, + { + "name": "embedding-generation.createTranscript", + "description": "Generates vector embeddings from a transcript text input. Accepts raw transcript text, optionally segmented by speaker or timestamp, processes the content by embedding meaningful segments, and outputs an array of embedding vectors each tied to portions of the transcript for semantic search or analysis.", + "category": "embedding-generation", + "parameters": [ + { + "name": "transcriptText", + "type": "string", + "description": "Raw transcript text to embed, can include speaker labels or timestamps.", + "required": true, + "defaultValue": "" + }, + { + "name": "segmentBy", + "type": "string", + "description": "How to segment the transcript for embedding generation: 'sentence', 'paragraph', or 'speaker'.", + "required": false, + "defaultValue": "sentence" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or type of embedding model to use for vector generation.", + "required": false, + "defaultValue": "default-embedding-model" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps in the output alongside embeddings if available in transcript.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxSegmentLength", + "type": "number", + "description": "Maximum number of tokens or words per segment to embed; longer segments will be split.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of embeddings, each with its associated transcript segment text, optional speaker label, and optional timestamp information if requested." + }, + "aiAgent": { + "useCase": "Use this tool when you have a transcript of spoken content (like meetings, interviews, lectures) and need to produce vector embeddings to enable semantic search, content clustering, or downstream NLP tasks. It supports segmentation by sentence, paragraph, or speaker to tailor embeddings granularity.", + "limitations": "This tool cannot perform the initial transcription from audio or video; it requires the transcript text as input. It also relies on an available compatible embedding model and does not handle embedding fine-tuning or training.", + "examples": [ + "Generate embeddings from an interview transcript segmented by speaker labels.", + "Create embeddings for a meeting transcript segmented by paragraph for later semantic retrieval.", + "Produce vector embeddings from a lecture transcript with timestamp data included in output." + ] + }, + "tags": [ + "embedding", + "transcript", + "semantic-search", + "NLP", + "vectorization", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"transcriptText\":\"Speaker A: Hello, and welcome to the meeting. Speaker B: Thank you, glad to be here.\",\"segmentBy\":\"speaker\",\"embeddingModel\":\"default-embedding-model\",\"includeTimestamps\":false,\"maxSegmentLength\":500}", + "description": "Create embeddings segmenting the transcript by speaker turns for a short dialogue." + }, + { + "inputJson": "{\"transcriptText\":\"Today we discuss quarterly goals. First, the marketing targets. Then, the financial outlook.\",\"segmentBy\":\"sentence\",\"embeddingModel\":\"default-embedding-model\",\"includeTimestamps\":false,\"maxSegmentLength\":300}", + "description": "Generate embeddings from a transcript segmented by sentence for fine-grained semantic indexing." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Transcript", + "context": null + } + }, + { + "name": "embedding-generation.createMinutes", + "description": "Generates vector embeddings from meeting minutes text to capture semantic content for advanced search, clustering, and analysis. Accepts raw text or structured minutes, processes sentence or paragraph segments into embeddings, and returns vectors with metadata for downstream AI tasks.", + "category": "embedding-generation", + "parameters": [ + { + "name": "minutesText", + "type": "string", + "description": "The raw text content of the meeting minutes to be converted into embeddings.", + "required": true, + "defaultValue": "" + }, + { + "name": "segmentLevel", + "type": "string", + "description": "Granularity level of embedding generation: 'sentence' or 'paragraph'. Determines how the text is split before embedding.", + "required": false, + "defaultValue": "paragraph" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The identifier of the embedding model to use, e.g., 'text-embedding-ada-002'.", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "If true, includes metadata like segment index and timestamp references in the output for each embedding vector.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxTokensPerSegment", + "type": "number", + "description": "Maximum token count allowed per segment to ensure embedding model compatibility.", + "required": false, + "defaultValue": "512" + } + ], + "returns": { + "type": "object", + "description": "An object containing embeddings as arrays of floats, their corresponding text segments, and optional metadata such as segment indices and timestamps." + }, + "aiAgent": { + "useCase": "Use this tool when converting meeting minutes text into numerical vector embeddings to enable semantic search, similarity detection, topic clustering, or machine learning analysis. Ideal for situations where minutes text needs to be transformed from unstructured or semi-structured form into searchable vector formats for downstream AI tasks.", + "limitations": "This tool does not summarize, transcribe, or interpret meeting content. It only converts provided text into embeddings and requires pre-existing text input. Effectiveness depends on input quality and embedding model capabilities.", + "examples": [ + "Create vector embeddings for the paragraphs in our last project's meeting minutes to index in our search system.", + "Generate sentence-level embeddings from a structured minutes document for topic modeling.", + "Convert raw minutes text into embeddings including metadata for downstream AI analysis." + ] + }, + "tags": [ + "embedding", + "meeting-minutes", + "vectorization", + "text-processing", + "semantic-search", + "AI-preprocessing" + ], + "examples": [ + { + "inputJson": "{\"minutesText\":\"Attendees discussed project timeline delays and agreed to adjust milestones accordingly. The budget review highlighted increased costs due to resource changes.\",\"segmentLevel\":\"paragraph\",\"embeddingModel\":\"text-embedding-ada-002\",\"includeMetadata\":true}", + "description": "Generate paragraph-level embeddings for provided minutes text including metadata." + }, + { + "inputJson": "{\"minutesText\":\"The kickoff meeting started with introductions. Action items were assigned to team leads.\",\"segmentLevel\":\"sentence\",\"embeddingModel\":\"text-embedding-001\",\"includeMetadata\":false}", + "description": "Generate sentence-level embeddings without metadata for short minutes text." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Minutes", + "context": null + } + }, + { + "name": "embedding-generation.createBlogPost", + "description": "Generates a vector embedding for a given blog post content to facilitate semantic search, recommendation, or clustering tasks. Accepts raw blog post text and optional metadata, processes the text through an embedding model, and outputs a high-dimensional vector representation along with key metadata.", + "category": "embedding-generation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the blog post to generate embeddings for.", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "The textual content of the blog post to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the author of the blog post, used as metadata.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Array of tags or keywords associated with the blog post for context.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en') of the blog post content to select appropriate embedding model.", + "required": false, + "defaultValue": "en" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Specifies which embedding model to use (e.g., 'transformer-base').", + "required": false, + "defaultValue": "transformer-base" + } + ], + "returns": { + "type": "object", + "description": "An object containing the vector embedding array and blog post metadata including title, author, tags, and language." + }, + "aiAgent": { + "useCase": "Use this tool when you need to represent blog posts as fixed-size numerical vectors for applications like semantic search, content recommendation, similarity analysis, or clustering. It is valuable in content management systems, search engines, and personalized content delivery platforms that leverage semantic understanding of blog articles.", + "limitations": "This tool does not generate summary or extractive content from the blog post, nor does it handle image or multimedia content embeddings. The quality of embeddings depends on the selected embedding model and the quality of input text.", + "examples": [ + "Generate embeddings to enable semantic search over a corpus of blog posts.", + "Create vector representations to cluster blog posts by topic or style.", + "Produce embeddings for blog posts to power recommendation engines based on content similarity." + ] + }, + "tags": [ + "embedding", + "blog", + "vectorization", + "semantic-search", + "content-management", + "nlp" + ], + "examples": [ + { + "inputJson": "{\"title\":\"How to Boost Productivity with AI\",\"content\":\"Artificial Intelligence dramatically improves productivity by automating tasks.\",\"author\":\"Jane Doe\",\"tags\":[\"AI\",\"productivity\",\"automation\"],\"language\":\"en\"}", + "description": "Create an embedding for a blog post about AI improving productivity, including metadata." + }, + { + "inputJson": "{\"title\":\"La gestion du temps efficace\",\"content\":\"Gérer son temps est essentiel pour réussir au travail.\",\"author\":\"Jean Dupont\",\"tags\":[\"gestion du temps\",\"efficacité\"],\"language\":\"fr\"}", + "description": "Generate embedding for a French language blog post about effective time management." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "BlogPost", + "context": null + } + }, + { + "name": "embedding-generation.createReleaseNotes", + "description": "Generates vector embeddings representing the content of software release notes. Accepts the raw text or structured changelog entries, processes the textual data to create dense numerical vectors suitable for semantic search, clustering, or downstream machine learning tasks, and returns the embedding vector along with metadata.", + "category": "embedding-generation", + "parameters": [ + { + "name": "releaseNotesText", + "type": "string", + "description": "Raw text content of the release notes to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentTitle", + "type": "string", + "description": "Optional title or version identifier of the release notes document.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use (e.g., 'text-embedding-ada-002').", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "normalizeVector", + "type": "boolean", + "description": "Whether to L2-normalize the resulting embedding vector before returning it.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Object containing the embedding vector as an array of floats, along with metadata such as model and input info." + }, + "aiAgent": { + "useCase": "Use this tool when an application needs to convert release notes text into vector embeddings for similarity search, semantic analysis, or indexing in a vector database. It is useful in scenarios like recommending relevant release notes, clustering changelogs by topic, or integrating release information as knowledge vectors.", + "limitations": "This tool only generates embeddings for textual release notes content. It does not summarize, parse detailed changelog semantics, or generate release notes from diff data.", + "examples": [ + "Generate an embedding for the latest software version release notes to enable searching for breaking changes.", + "Create vectors for multiple release notes documents to support clustering similar updates.", + "Embed changelog entries to facilitate semantic filtering in a documentation portal." + ] + }, + "tags": [ + "embedding", + "release notes", + "changelog", + "vectorization", + "semantic search", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"releaseNotesText\":\"Version 2.5.0 includes new authentication features, bug fixes, and performance improvements.\",\"documentTitle\":\"App Release 2.5.0\"}", + "description": "Embedding generation for a small release note text describing features and fixes in version 2.5.0." + }, + { + "inputJson": "{\"releaseNotesText\":\"- Added OAuth2 login support\\n- Fixed memory leak issue on data sync\\n- Improved dashboard loading time by 40%\",\"embeddingModel\":\"text-embedding-ada-002\",\"normalizeVector\":true}", + "description": "Embedding for structured changelog bullet points, using the default embedding model with normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "embedding-generation.createArticle", + "description": "Generates a vector embedding representation for a full article or document text. Accepts the article content as plain text or markdown, performs linguistic and semantic processing, and outputs a fixed-length numerical vector suitable for downstream tasks like semantic search, clustering, or classification.", + "category": "embedding-generation", + "parameters": [ + { + "name": "articleText", + "type": "string", + "description": "The full text content of the article or document to embed. Required, should be at least a few sentences and can be multiple paragraphs.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The identifier of the embedding model to use (e.g., 'distilbert-base-nli-stsb-mean-tokens'). Defaults to a general-purpose semantic embedding model.", + "required": false, + "defaultValue": "all-mpnet-base-v2" + }, + { + "name": "normalizeEmbedding", + "type": "boolean", + "description": "Whether to apply normalization (e.g., L2 norm) to the embedding vector.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxTokens", + "type": "number", + "description": "Maximum tokens from the article text to use for embedding to limit size. Articles longer than this are truncated or split before embedding.", + "required": false, + "defaultValue": "512" + } + ], + "returns": { + "type": "object", + "description": "An object containing the vector embedding as a float array, the embedding dimension, and metadata such as the model used." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert article or document text into fixed-length vector embeddings for semantic search, similarity comparison, clustering, or as input features for machine learning models. It is suited for whole-article embeddings rather than short snippets or single sentences.", + "limitations": "This tool only produces embeddings for the text provided; it does not summarize, translate, or extract key phrases. Very long articles exceeding token limits must be truncated or chunked externally. Quality depends on the embedding model's capabilities.", + "examples": [ + "Generate an embedding vector for a news article to compare with other articles for topic similarity.", + "Embed a research paper abstract and body text to enable semantic retrieval in a document database.", + "Create vector representation of blog posts for clustering analysis." + ] + }, + "tags": [ + "embedding", + "generation", + "article", + "document", + "nlp", + "semantic", + "vector" + ], + "examples": [ + { + "inputJson": "{\"articleText\":\"In recent years, advances in artificial intelligence have transformed various industries...\",\"embeddingModel\":\"all-mpnet-base-v2\",\"normalizeEmbedding\":true,\"maxTokens\":512}", + "description": "Create normalized embedding for a news article using default model and token limit." + }, + { + "inputJson": "{\"articleText\":\"# Machine Learning Trends\\nThis article explores the latest trends in machine learning including transformer models...\",\"embeddingModel\":\"distilbert-base-nli-stsb-mean-tokens\",\"normalizeEmbedding\":false,\"maxTokens\":256}", + "description": "Generate unnormalized embedding for a markdown formatted technical article using a specific model and smaller max tokens." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Article", + "context": null + } + }, + { + "name": "file-operations.downloadHTML", + "description": "Downloads HTML content from a specified URL or from provided raw HTML text, and saves it as an .html file locally or returns it as a string. Supports optional filename and encoding settings for the saved file.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL of the webpage to download the HTML content from. Required if rawHtml is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "rawHtml", + "type": "string", + "description": "Raw HTML content provided as a string to save directly without fetching. Required if url is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Name of the file to save the HTML content into, default is 'download.html'.", + "required": false, + "defaultValue": "download.html" + }, + { + "name": "encoding", + "type": "string", + "description": "Character encoding for the saved HTML file, default is 'utf-8'.", + "required": false, + "defaultValue": "utf-8" + }, + { + "name": "saveToFile", + "type": "boolean", + "description": "Whether to save the HTML content to a file. If false, returns raw HTML string instead.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the filename (if saved) and the HTML content as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to download and store HTML content from the web or save raw HTML as a file. Useful for archiving pages, offline viewing, or preprocessing HTML for further analysis or rendering.", + "limitations": "Cannot download pages behind authentication or with complex JavaScript rendering. RawHtml input cannot be validated or sanitized by this tool.", + "examples": [ + "Download the homepage of example.com and save it as 'example.html'.", + "Save provided raw HTML code as a local HTML file.", + "Return the raw HTML content as a string without saving to file." + ] + }, + "tags": [ + "file", + "download", + "HTML", + "web", + "archiving", + "offline" + ], + "examples": [ + { + "inputJson": "{\"url\": \"https://example.com\", \"fileName\": \"example.html\", \"saveToFile\": true}", + "description": "Download HTML content from 'https://example.com' and save as 'example.html'" + }, + { + "inputJson": "{\"rawHtml\": \"Test
\", \"fileName\": \"test.html\", \"saveToFile\": true}", + "description": "Save given raw HTML content to 'test.html'" + }, + { + "inputJson": "{\"url\": \"https://example.com\", \"saveToFile\": false}", + "description": "Download HTML from 'https://example.com' and return it as a string without saving" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "HTML", + "context": null + } + }, + { + "name": "embedding-generation.createEmail", + "description": "Generates a vector embedding for the content of an email to enable semantic search, classification, or clustering. Accepts email components including subject, body text, sender, recipients, and optionally metadata. Produces a numerical vector embedding representing the semantic content of the entire email.", + "category": "embedding-generation", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be embedded.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content or body text of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "sender", + "type": "string", + "description": "Email address or name of the sender; used to enrich the embedding context.", + "required": false, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of email addresses or names of recipients; helps contextualize the communication.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs with extra email info (e.g., date, tags) to influence embedding generation.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated vector embedding as an array of floats and metadata about the embedding dimensions and source." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to convert email textual data into vector embeddings for similarity search, categorization, or semantic analysis within email management or CRM systems. It helps improve retrieval of related emails or clustering communications by meaning rather than keywords.", + "limitations": "This tool does not perform email content summarization or sentiment analysis. It only generates vector embeddings and does not interpret or modify email content.", + "examples": [ + "Generate embedding for an email with subject and body to classify into categories.", + "Create semantic vector for email text to cluster similar emails.", + "Embed email content and metadata to improve search relevance in an inbox." + ] + }, + "tags": [ + "embedding", + "email", + "semantic-search", + "vector", + "communication", + "NLP", + "email-processing" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Meeting Reminder\",\"body\":\"Don't forget our meeting at 10 AM tomorrow.\",\"sender\":\"alice@example.com\",\"recipients\":[\"bob@example.com\",\"carol@example.com\"]}", + "description": "Embedding for a typical meeting reminder email." + }, + { + "inputJson": "{\"subject\":\"Project Update\",\"body\":\"The latest project update includes new timelines and goals.\",\"sender\":\"manager@example.com\",\"metadata\":{\"priority\":\"high\",\"sentDate\":\"2024-05-10\"}}", + "description": "Embedding for a project update email including metadata for richer context." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "embedding-generation.createContract", + "description": "Generates vector embeddings for contract documents by analyzing their textual content. Accepts the full contract text or segmented clauses, processes the text using NLP embedding models specialized for legal language, and outputs a vector embedding array representing the document's semantic features for use in similarity search, classification, or clustering.", + "category": "embedding-generation", + "parameters": [ + { + "name": "contractText", + "type": "string", + "description": "The full text content of the contract document to embed. Required if contractClauses is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "contractClauses", + "type": "array", + "description": "Optional array of strings, each representing distinct clauses or sections of the contract to embed separately.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Name or identifier of the embedding model to use, optimized for legal documents (e.g., 'legal-embedding-v1').", + "required": false, + "defaultValue": "legal-embedding-v1" + }, + { + "name": "normalizeVectors", + "type": "boolean", + "description": "Whether to normalize the output embedding vectors to unit length for consistent similarity computations.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing one or more embedding vectors (arrays of floats), either a single embedding for the full contract text or multiple embeddings if clauses were provided." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to transform contract documents or their segments into vector embeddings for tasks like semantic search, clustering, or comparison in contract management and analysis systems. It is especially useful when working with legal language requiring domain-appropriate embedding models.", + "limitations": "The tool does not parse or validate contract content for legal correctness. It only generates embeddings of the text and cannot interpret or summarize legal meaning. Accuracy depends on the quality of the underlying embedding model.", + "examples": [ + "Generate an embedding for the full text of a commercial lease agreement.", + "Create embeddings for each clause of a service level agreement for similarity search.", + "Obtain a normalized embedding vector for a non-disclosure agreement document." + ] + }, + "tags": [ + "embedding-generation", + "legal", + "contract", + "document", + "vectorization", + "nlp", + "semantic-search" + ], + "examples": [ + { + "inputJson": "{\"contractText\":\"This Agreement is made between Party A and Party B. The term of agreement is five years...\"}", + "description": "Generate a single embedding for the full text of a simple contract." + }, + { + "inputJson": "{\"contractClauses\":[\"Confidentiality: Both parties agree to...\",\"Termination: Either party may terminate...\"],\"normalizeVectors\":true}", + "description": "Generate normalized vectors for each clause of a contract separately." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "embedding-generation.createDocument", + "description": "Creates a vector embedding for a given document text to enable semantic search, similarity comparison, or downstream NLP tasks. Accepts raw document text and optional metadata, processes the text using pretrained embedding models, and outputs a structured embedding vector along with the document metadata for indexing or storage.", + "category": "embedding-generation", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "The raw text content of the document to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs with additional information about the document (e.g., title, author).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "modelName", + "type": "string", + "description": "Identifier of the embedding model to use (e.g., 'text-embedding-ada-002'). Defaults to a general-purpose text embedding model.", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to normalize the resulting embedding vector to unit length. Defaults to true for cosine similarity use cases.", + "required": false, + "defaultValue": "true" + }, + { + "name": "truncateToMaxTokens", + "type": "boolean", + "description": "Automatically truncate the input text if it exceeds the model's max token limit. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embedding vector as an array of numbers, the embedding dimension, and echoed metadata for reference." + }, + "aiAgent": { + "useCase": "Use this tool to convert unstructured document text into fixed-length numerical vectors useful for semantic search, clustering, or machine learning. It helps represent the semantic meaning of documents for vector databases or similarity engines.", + "limitations": "The tool cannot perform document splitting; very long documents must be split before embedding. It does not generate embeddings for non-text data like images or audio. Embeddings quality depends on the chosen model and may not capture all nuances.", + "examples": [ + "Generate an embedding for a product description for search indexing.", + "Create embeddings from user manuals for semantic question-answering.", + "Convert legal contracts into vectors to compare similarity with previous cases." + ] + }, + "tags": [ + "embedding", + "document", + "vectorization", + "semantic-search", + "nlp", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"The quick brown fox jumps over the lazy dog.\",\"metadata\":{\"title\":\"Example sentence\",\"author\":\"Anonymous\"}}", + "description": "Embedding a simple sample sentence with metadata." + }, + { + "inputJson": "{\"documentText\":\"Artificial intelligence and machine learning are transforming industries.\",\"modelName\":\"text-embedding-ada-002\",\"normalize\":true}", + "description": "Embedding a tech-focused document text with default model and normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Document", + "context": null + } + }, + { + "name": "embedding-generation.createResume", + "description": "Generates a vector embedding representation for a given resume document text to enable semantic search, similarity analysis, or downstream machine learning tasks. Accepts raw resume text or structured resume JSON and outputs a normalized fixed-length embedding vector.", + "category": "embedding-generation", + "parameters": [ + { + "name": "resumeText", + "type": "string", + "description": "Raw textual content of the resume to embed. Required if structuredResume is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "structuredResume", + "type": "object", + "description": "Resume content in structured JSON format with fields like education, workExperience, skills; used instead of raw text for embedding generation.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use, e.g., 'resume-bert-base'. Determines embedding quality and vector size.", + "required": false, + "defaultValue": "resume-bert-base" + }, + { + "name": "normalizeVector", + "type": "boolean", + "description": "Whether to L2 normalize the embedding vector. Helps with cosine similarity comparisons.", + "required": false, + "defaultValue": "true" + }, + { + "name": "truncateLength", + "type": "number", + "description": "Maximum token length of the input text to consider before truncation.", + "required": false, + "defaultValue": "1024" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embedding vector as an array of floats and metadata such as vector dimension and model used." + }, + "aiAgent": { + "useCase": "Use this tool when you have resume data in text or structured JSON form and need to create vector embeddings for tasks like semantic search, candidate-job matching, clustering resumes, or similarity detection. It standardizes multiple resume formats into a consistent vector space.", + "limitations": "The tool cannot parse or extract resume data from PDFs or images; preprocessing to obtain clean text or structured JSON is required. The quality depends on the embedding model chosen and may require tuning for specific domains or languages.", + "examples": [ + "Create an embedding for a candidate's resume text to index in a search database.", + "Generate vector representation from a structured resume JSON for similarity comparison.", + "Embed resumes to cluster them by skillset and experience." + ] + }, + "tags": [ + "embedding", + "resume", + "vectorization", + "semantic-search", + "nlp", + "candidate-matching" + ], + "examples": [ + { + "inputJson": "{\"resumeText\":\"John Doe\\nSoftware Engineer with 5 years of experience in Python and Java. Skilled in machine learning and cloud computing.\",\"embeddingModel\":\"resume-bert-base\"}", + "description": "Generate embedding from raw resume text for a software engineer candidate." + }, + { + "inputJson": "{\"structuredResume\":{\"education\":[{\"degree\":\"BSc Computer Science\",\"year\":2018}],\"workExperience\":[{\"role\":\"Software Developer\",\"years\":3}],\"skills\":[\"Python\",\"Java\",\"ML\"]},\"normalizeVector\":false}", + "description": "Create embedding from structured resume data without normalization for custom downstream processing." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Resume", + "context": null + } + }, + { + "name": "embedding-generation.createInvoice", + "description": "Generates a vector embedding representation of an invoice document text or structured data for use in similarity search, classification, or downstream AI tasks. Accepts raw invoice text or parsed invoice fields and outputs a fixed-length numeric embedding vector.", + "category": "embedding-generation", + "parameters": [ + { + "name": "invoiceText", + "type": "string", + "description": "Raw text content of the invoice document to embed. Optional if invoiceData is provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "invoiceData", + "type": "object", + "description": "Structured invoice data as key-value pairs (e.g., date, items, total). Optional if invoiceText is provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "The name or identifier of the embedding model to use for generating the vector embedding.", + "required": true, + "defaultValue": "invoice-embed-v1" + }, + { + "name": "normalize", + "type": "boolean", + "description": "If true, normalize the resulting embedding vector to unit length.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the numeric embedding vector array and metadata such as embedding dimension and model used." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert invoice data into vector embeddings for similarity matching, clustering, or as input features to machine learning models. It is ideal for indexing invoices in a vector database or comparing invoice contents at semantic level.", + "limitations": "Does not extract or parse invoice fields from images or PDFs; expects text or structured data input. Embeddings capture semantic content but not layout or formatting specifics. Model choice affects embedding quality.", + "examples": [ + "Create a vector embedding for an invoice text to find similar invoices.", + "Generate an embedding for structured invoice data to enable clustering by invoice features.", + "Use embedding to convert invoice text for AI classification of invoice types." + ] + }, + "tags": [ + "embedding", + "invoice", + "document", + "vector", + "nlp", + "ai", + "finance" + ], + "examples": [ + { + "inputJson": "{\"invoiceText\":\"Invoice #12345 dated 2024-06-01 for Acme Corp. Total amount due $453.25.\",\"embeddingModel\":\"invoice-embed-v1\",\"normalize\":true}", + "description": "Generate embedding from plain invoice text." + }, + { + "inputJson": "{\"invoiceData\":{\"invoiceNumber\":\"12345\",\"date\":\"2024-06-01\",\"vendor\":\"Acme Corp.\",\"totalAmount\":453.25},\"embeddingModel\":\"invoice-embed-v1\",\"normalize\":false}", + "description": "Generate embedding from structured invoice data without normalization." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "embedding-generation.createProposal", + "description": "Generates a semantic vector embedding for a detailed project proposal document text. Accepts proposal text and optional domain context to produce a high-dimensional vector representation capturing the proposal's topical and conceptual content suitable for similarity search, recommendation, or clustering.", + "category": "embedding-generation", + "parameters": [ + { + "name": "proposalText", + "type": "string", + "description": "Full text content of the project proposal document to embed", + "required": true, + "defaultValue": "" + }, + { + "name": "domainContext", + "type": "string", + "description": "Optional context or domain (e.g., 'software development', 'marketing') to tailor embedding semantics", + "required": false, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use (e.g., 'text-embedding-ada-002')", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "normalize", + "type": "boolean", + "description": "Whether to L2-normalize the resulting embedding vector", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the embedding vector as a list of floats and metadata about the input and model used" + }, + "aiAgent": { + "useCase": "Use this tool when you need to transform detailed project proposal texts into vector embeddings for semantic search, clustering, or recommendation systems within project or document management environments. It enables downstream algorithms to compare and find similar proposals based on content.", + "limitations": "This tool generates embeddings only from textual content; it cannot analyze non-textual elements like images or tables within proposals. It does not generate or summarize proposal content.", + "examples": [ + "Generate an embedding vector for a marketing campaign proposal to find similar successful campaigns.", + "Create embeddings for software project proposals to cluster by technology focus.", + "Embed research grant proposals' content for similarity scoring and recommendation." + ] + }, + "tags": [ + "embedding", + "proposal", + "document", + "semantic", + "vectorization", + "text-processing", + "project-management" + ], + "examples": [ + { + "inputJson": "{\"proposalText\":\"This project aims to develop an AI-powered chatbot to improve customer support responsiveness and reduce operational costs by automating FAQ handling.\",\"domainContext\":\"customer service\",\"embeddingModel\":\"text-embedding-ada-002\",\"normalize\":true}", + "description": "Embedding a customer service project proposal text for semantic similarity search." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Proposal", + "context": null + } + }, + { + "name": "file-operations.downloadScreenshot", + "description": "This tool downloads a screenshot image from a specified URL or web page. It accepts a URL string and optional parameters for image format, resolution, and viewport size. It processes the webpage rendering and returns a screenshot image file in the requested format.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL of the web page to capture a screenshot from.", + "required": true, + "defaultValue": "" + }, + { + "name": "imageFormat", + "type": "string", + "description": "The image format to save the screenshot as (e.g., 'png', 'jpeg').", + "required": false, + "defaultValue": "png" + }, + { + "name": "width", + "type": "number", + "description": "The width in pixels of the viewport for the screenshot.", + "required": false, + "defaultValue": "1920" + }, + { + "name": "height", + "type": "number", + "description": "The height in pixels of the viewport for the screenshot.", + "required": false, + "defaultValue": "1080" + }, + { + "name": "fullPage", + "type": "boolean", + "description": "Whether to capture the entire page, scrolling through the full height.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the screenshot image data as a base64 encoded string and the image format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to obtain a visual capture of a web page given its URL, such as for analysis, archiving, or presentation purposes. It allows specifying resolution and image format to tailor the screenshot for various applications, like generating thumbnails or full-page captures.", + "limitations": "This tool cannot interact with dynamic content that requires user interaction beyond initial page load. It may not capture certain browser plugins or popups. Javascript-heavy pages might not render exactly as in a real browser if the rendering engine has limitations.", + "examples": [ + "Download a PNG screenshot of https://example.com with default resolution.", + "Download a full-page JPEG screenshot of https://example.com with 1280x720 viewport.", + "Download a 800x600 PNG screenshot of a URL for quick preview." + ] + }, + "tags": [ + "download", + "screenshot", + "webpage", + "image", + "capture", + "file", + "media" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"imageFormat\":\"png\"}", + "description": "Download a PNG screenshot of the homepage of example.com with default viewport size." + }, + { + "inputJson": "{\"url\":\"https://example.com\",\"imageFormat\":\"jpeg\",\"width\":1280,\"height\":720,\"fullPage\":false}", + "description": "Download a JPEG screenshot of example.com with 1280x720 viewport, not full page." + }, + { + "inputJson": "{\"url\":\"https://example.com/about\",\"fullPage\":true}", + "description": "Download a full-page PNG screenshot of the about page of example.com with default size." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Screenshot", + "context": null + } + }, + { + "name": "embedding-generation.createReport", + "description": "Generates a detailed vector embedding report summarizing the semantic structure and key topic vectors of input documents or text arrays. Accepts single or multiple texts, processes embedding creation and clustering insights, and returns a structured report with embedding statistics, cluster labels, and representative vectors.", + "category": "embedding-generation", + "parameters": [ + { + "name": "texts", + "type": "array", + "description": "An array of text strings (documents, paragraphs, or sentences) to create embeddings for and include in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "embeddingModel", + "type": "string", + "description": "Identifier of the embedding model to use for generating vector representations (e.g., 'text-embedding-ada-002').", + "required": false, + "defaultValue": "text-embedding-ada-002" + }, + { + "name": "maxClusterCount", + "type": "number", + "description": "Maximum number of semantic clusters/topics to identify and summarize in the report.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeRawEmbeddings", + "type": "boolean", + "description": "Whether to include the raw vector embeddings for each input text in the output report.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input texts to optimize embedding generation (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Report object containing: cluster summaries with representative topic vectors, embedding statistics (mean, variance), cluster assignments per input text, and optionally raw embeddings." + }, + "aiAgent": { + "useCase": "Use this tool when needing a comprehensive semantic overview of a set of text documents by generating embeddings, identifying key topics or clusters, and producing a structured report for downstream analysis or decision making. It helps analyze large text corpora by embedding and summarizing semantic content.", + "limitations": "This tool does not perform natural language generation or text summarization beyond clustering embeddings. It requires input texts in supported languages and cannot interpret the meaning beyond vector embedding space representation.", + "examples": [ + "Generate an embedding report summarizing semantic clusters for a list of product reviews.", + "Create a report showing key topics and statistics from a set of customer feedback messages.", + "Produce a vector embedding report of Wikipedia articles in English to understand topic groupings." + ] + }, + "tags": [ + "embedding", + "embedding-generation", + "semantic-clustering", + "vector-analysis", + "reporting", + "nlp" + ], + "examples": [ + { + "inputJson": "{\"texts\":[\"TPMJS is a versatile tool registry.\",\"Embedding generation creates vector representations of text.\"],\"embeddingModel\":\"text-embedding-ada-002\",\"maxClusterCount\":3,\"includeRawEmbeddings\":true,\"language\":\"en\"}", + "description": "Generate embedding report for two short text inputs with raw embeddings included and 3 semantic clusters." + }, + { + "inputJson": "{\"texts\":[\"Customer service feedback is vital.\",\"Product reviews vary widely.\",\"User satisfaction drives sales.\"],\"embeddingModel\":\"text-embedding-002\",\"maxClusterCount\":2,\"includeRawEmbeddings\":false,\"language\":\"en\"}", + "description": "Create an embedding report summarizing three customer-related texts into 2 clusters without raw embeddings." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "file-operations.downloadAttachment", + "description": "This tool downloads an email or message attachment given its source URL or identifier. It accepts parameters to specify the attachment source, authentication if needed, and optional output filename. The tool processes the download request and returns the file content or a saved file path depending on usage.", + "category": "file-operations", + "parameters": [ + { + "name": "attachmentUrl", + "type": "string", + "description": "The URL from which to download the attachment. Required if attachmentId is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachmentId", + "type": "string", + "description": "A unique identifier for the attachment in a system. Used if attachmentUrl is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or credentials required to access the attachment URL, if protected.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFilename", + "type": "string", + "description": "Optional desired filename to save the attachment locally. If omitted, a default name is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Timeout in seconds for the download operation to complete before failing.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status, filename saved or error detail if failed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically retrieve and save attachments from emails or messaging systems via URL or identifier, especially in automated workflows where manual download is impractical.", + "limitations": "Cannot download attachments from sources requiring interactive authentication steps beyond token input; does not parse or extract attachments from messages without direct URL or ID; handles single attachment per invocation.", + "examples": [ + "Download attachment from URL with authentication token.", + "Download attachment using system attachment ID without authentication.", + "Download attachment and save to a custom filename locally." + ] + }, + "tags": [ + "file-download", + "attachment", + "email", + "automation", + "file-management" + ], + "examples": [ + { + "inputJson": "{\"attachmentUrl\":\"https://example.com/files/report.pdf\",\"authToken\":\"Bearer abc123\",\"outputFilename\":\"finance_report.pdf\"}", + "description": "Download a PDF attachment from a secure URL using an auth token and save with a custom filename." + }, + { + "inputJson": "{\"attachmentId\":\"att-9876543210\"}", + "description": "Download an attachment using only its unique identifier, without providing URL or authentication." + }, + { + "inputJson": "{\"attachmentUrl\":\"https://publicserver.com/media/image.jpg\"}", + "description": "Download a publicly available image attachment by URL without authentication or custom filename." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Attachment", + "context": null + } + }, + { + "name": "file-operations.downloadFile", + "description": "Downloads a file from a specified URL to a local destination path. Accepts the file URL, optional destination directory, filename, and overwrite flag. It performs HTTP(S) download and saves the file locally, returning success status and file path or error details.", + "category": "file-operations", + "parameters": [ + { + "name": "fileUrl", + "type": "string", + "description": "The full HTTP or HTTPS URL of the file to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "The local directory path where the file will be saved. If omitted, defaults to the current working directory.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "The name to save the file as. If omitted, the original filename from the URL is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists at the destination. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Time in seconds before the download request times out. Default is 30 seconds.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object containing download success status, local file path if successful, and error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to retrieve a remote file via URL and save it locally for further processing, storage, or user delivery. Typical scenarios include downloading images, documents, or datasets. The agent should ensure valid URLs and handle network errors gracefully.", + "limitations": "This tool cannot download files requiring authentication or cookies unless the URL includes access tokens. It does not support protocols other than HTTP and HTTPS. Large file downloads may be limited by agent environment constraints.", + "examples": [ + "Download an image from a public URL and save it to a specified folder with a custom filename.", + "Fetch a dataset CSV file from a URL and save it using the default filename in the current directory.", + "Attempt to download a file with overwrite enabled, replacing an existing file if present." + ] + }, + "tags": [ + "file", + "download", + "http", + "network", + "file-system", + "media" + ], + "examples": [ + { + "inputJson": "{\"fileUrl\":\"https://example.com/image.png\",\"destinationPath\":\"/tmp/images\",\"fileName\":\"holiday.png\",\"overwrite\":false}", + "description": "Download an image from a URL to /tmp/images as 'holiday.png', do not overwrite if exists." + }, + { + "inputJson": "{\"fileUrl\":\"https://example.com/data.csv\"}", + "description": "Download a CSV file from URL to current directory with original filename." + }, + { + "inputJson": "{\"fileUrl\":\"https://example.com/report.pdf\",\"destinationPath\":\"C:/Reports\",\"overwrite\":true}", + "description": "Download a PDF report to C:/Reports, overwrite if the file already exists." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "File", + "context": null + } + }, + { + "name": "file-operations.downloadAudio", + "description": "Downloads audio files from a specified URL and saves them locally or to a specified directory. Accepts an audio file URL and optional parameters for filename, format conversion, and download timeout. Returns metadata about the saved file upon successful download.", + "category": "file-operations", + "parameters": [ + { + "name": "audioUrl", + "type": "string", + "description": "The URL of the audio file to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "savePath", + "type": "string", + "description": "Local file system path or directory where the audio file will be saved. If a directory is provided, the filename parameter or derived filename will be used.", + "required": false, + "defaultValue": "./" + }, + { + "name": "fileName", + "type": "string", + "description": "Optional filename for saving the audio file. If omitted, filename will be derived from the URL.", + "required": false, + "defaultValue": "" + }, + { + "name": "convertFormat", + "type": "string", + "description": "Desired audio format to convert the file to after download (e.g., mp3, wav). If empty, no conversion is performed.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for the download to complete before aborting.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full local path of the saved file, file size in bytes, audio format, and download status message." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to retrieve audio content from the internet programmatically, possibly converting it to a desired format, for offline processing or playback. Ideal when the agent is given a URL and must ensure the audio is saved locally with optional format standards.", + "limitations": "Cannot handle audio streams requiring authentication tokens or DRM-protected content. Format conversion supports only common audio formats and relies on underlying system capabilities. Network interruptions may cause failed downloads.", + "examples": [ + "Download a podcast episode audio file from a direct URL and save it as MP3.", + "Fetch an audio sample from a given online resource and save it locally without format conversion.", + "Download an audio file with a specified timeout to avoid long hanging downloads." + ] + }, + "tags": [ + "download", + "audio", + "file-management", + "media", + "network", + "conversion" + ], + "examples": [ + { + "inputJson": "{\"audioUrl\":\"https://example.com/audio/sample.wav\",\"savePath\":\"/user/downloads/audio\",\"fileName\":\"sample_converted.mp3\",\"convertFormat\":\"mp3\",\"timeoutSeconds\":30}", + "description": "Downloads a WAV audio file from a URL, converts it to MP3, and saves it with a specified filename and 30 seconds timeout." + }, + { + "inputJson": "{\"audioUrl\":\"https://example.com/audio/song.mp3\",\"savePath\":\"/music\",\"fileName\":\"\",\"convertFormat\":\"\",\"timeoutSeconds\":60}", + "description": "Downloads an MP3 audio file from URL and saves it to /music directory, keeping original format and filename, with a 60 seconds timeout." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Audio", + "context": null + } + }, + { + "name": "file-operations.downloadVideo", + "description": "Downloads a video file from a specified URL and saves it to a given local file path. Accepts the video URL and target path, optionally supports setting a network timeout and whether to overwrite existing files. Returns details about the downloaded file including size and duration if available.", + "category": "file-operations", + "parameters": [ + { + "name": "videoUrl", + "type": "string", + "description": "The URL of the video file to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetPath", + "type": "string", + "description": "The local file system path to save the downloaded video file to.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for the download before timing out.", + "required": false, + "defaultValue": "30" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file at targetPath if it already exists.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the file path, size in bytes, video duration in seconds (if obtainable), and a success status." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to programmatically acquire a video file from an internet source and save it locally for further processing, analysis, or playback. It is ideal for scenarios requiring reliable video downloading with options for timeout and overwrite protection.", + "limitations": "This tool cannot extract video metadata beyond basic duration if not accessible from the file. It does not support downloading from sites requiring complex authentication or streaming protocols that need specialized handling. It downloads direct video file URLs only.", + "examples": [ + "Download a training video from https://example.com/video.mp4 to /videos/training.mp4.", + "Download a promotional clip and overwrite if it exists at /tmp/promo.mov.", + "Download a video with a 60 second timeout from a given URL." + ] + }, + "tags": [ + "file", + "download", + "video", + "media", + "network", + "file-saving", + "streaming", + "media-processing" + ], + "examples": [ + { + "inputJson": "{\"videoUrl\":\"https://example.com/sample.mp4\",\"targetPath\":\"/home/user/videos/sample.mp4\",\"timeoutSeconds\":60,\"overwrite\":true}", + "description": "Download a sample MP4 video with a 60 second timeout and overwrite enabled." + }, + { + "inputJson": "{\"videoUrl\":\"https://mediahost.com/videos/event.mov\",\"targetPath\":\"C:\\\\Videos\\\\event.mov\",\"overwrite\":false}", + "description": "Download an event MOV video without overwriting an existing file on a Windows system." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Video", + "context": null + } + }, + { + "name": "file-operations.downloadMarkdown", + "description": "Downloads Markdown content provided as a string or from a URL and saves it as a .md file locally or in a specified directory. Supports customization of filename, directory path, and overwrite options. Returns the full path of the saved Markdown file.", + "category": "file-operations", + "parameters": [ + { + "name": "markdownContent", + "type": "string", + "description": "Markdown text content to save as a file. Provide as string if downloading from content directly.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceUrl", + "type": "string", + "description": "URL to fetch Markdown content from if markdownContent is not provided. Must respond with Markdown text.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Name of the saved Markdown file without extension. Defaults to 'downloaded_markdown'.", + "required": false, + "defaultValue": "downloaded_markdown" + }, + { + "name": "directoryPath", + "type": "string", + "description": "Local directory path where the Markdown file will be saved. Defaults to current working directory.", + "required": false, + "defaultValue": "." + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists. Defaults to false to prevent accidental data loss.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object containing the absolute path to the saved Markdown file and confirmation of success." + }, + "aiAgent": { + "useCase": "Use this tool when Markdown text needs to be saved as a local file either from a direct content input or fetched from a URL. Suitable for agents automating documentation download, note-taking, or archival of Markdown resources.", + "limitations": "Cannot parse or modify Markdown content, only downloads and saves. Requires valid Markdown content as input or accessible URL. Does not handle authentication for protected URLs.", + "examples": [ + "Download Markdown from a URL and save it locally with a custom filename.", + "Save provided Markdown string content to a specified directory.", + "Download Markdown content without overwriting existing files, ensuring safe file storage." + ] + }, + "tags": [ + "file", + "markdown", + "download", + "save", + "content", + "document" + ], + "examples": [ + { + "inputJson": "{\"markdownContent\":\"# Hello World\\nThis is a sample Markdown text.\",\"fileName\":\"sample_note\",\"directoryPath\":\"./docs\",\"overwrite\":true}", + "description": "Save provided Markdown string content as 'sample_note.md' in './docs' directory, overwriting existing file." + }, + { + "inputJson": "{\"sourceUrl\":\"https://raw.githubusercontent.com/user/repo/README.md\",\"fileName\":\"README\",\"directoryPath\":\"./downloads\",\"overwrite\":false}", + "description": "Download Markdown content from a URL and save as 'README.md' in './downloads' without overwriting existing files." + }, + { + "inputJson": "{\"markdownContent\":\"- Item 1\\n- Item 2\",\"fileName\":\"list\",\"directoryPath\":\".\",\"overwrite\":false}", + "description": "Save a simple Markdown list as 'list.md' in the current directory, preserving existing files." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Markdown", + "context": null + } + }, + { + "name": "file-operations.downloadImage", + "description": "Downloads an image from a specified URL, saves it locally or returns its binary content. Accepts the image URL and optional parameters for file path, HTTP headers, and timeout. Returns success status and file path or image data depending on parameters.", + "category": "file-operations", + "parameters": [ + { + "name": "imageUrl", + "type": "string", + "description": "The URL of the image to download (must be a valid http/https URL).", + "required": true, + "defaultValue": "" + }, + { + "name": "saveToFile", + "type": "boolean", + "description": "Whether to save the downloaded image to a file on disk (true) or return binary data (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "filePath", + "type": "string", + "description": "Local file path to save the image if saveToFile is true. If empty, a default filename is generated.", + "required": false, + "defaultValue": "" + }, + { + "name": "httpHeaders", + "type": "object", + "description": "Optional HTTP headers to include in the download request (e.g., authorization tokens).", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Timeout duration in seconds for the image download request.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object indicating success status and either the file path (if saved) or the image binary data in base64 encoding." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to retrieve image files from online sources for processing, analysis, or local storage. It handles accessible image URLs and provides flexibility to save images locally or return them in-memory for immediate use.", + "limitations": "Cannot download images from URLs that require interactive authentication or complex JavaScript rendering. Not suitable for scraping protected or dynamically generated images.", + "examples": [ + "Download and save an image from a public URL to a specified local path.", + "Fetch an image from a URL and get the raw image data in base64 without saving to disk.", + "Download an image with custom HTTP headers for authenticated requests." + ] + }, + "tags": [ + "download", + "image", + "file", + "http", + "media", + "file-management" + ], + "examples": [ + { + "inputJson": "{\"imageUrl\":\"https://example.com/image.jpg\",\"saveToFile\":true,\"filePath\":\"./downloads/image.jpg\"}", + "description": "Download an image from a URL and save it to a given local path." + }, + { + "inputJson": "{\"imageUrl\":\"https://example.com/avatar.png\",\"saveToFile\":false}", + "description": "Download an image and get its base64 binary data without saving to disk." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Image", + "context": null + } + }, + { + "name": "file-operations.downloadCSV", + "description": "This tool takes structured data as input (either as an array of objects or a CSV string), converts it into a valid CSV format if needed, and prepares it for download by generating a downloadable CSV file content string. It supports customizing delimiter, including headers, and encoding options, outputting the CSV content as a string ready to be saved or served as a file.", + "category": "file-operations", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of objects representing the structured data rows to be converted to CSV format. Each object is a row with key-value pairs as columns. Alternatively, a CSV string can be provided if raw CSV input is preferred.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include the object keys as the first header row in the CSV output. Defaults to true to have column headers.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "The character used to separate values in the CSV file. Defaults to comma (,).", + "required": false, + "defaultValue": "," + }, + { + "name": "fileName", + "type": "string", + "description": "The name of the CSV file to be downloaded, including extension .csv. Defaults to 'data.csv'.", + "required": false, + "defaultValue": "data.csv" + }, + { + "name": "encoding", + "type": "string", + "description": "The character encoding for the CSV file content, e.g., 'utf-8'. Defaults to 'utf-8'.", + "required": false, + "defaultValue": "utf-8" + } + ], + "returns": { + "type": "object", + "description": "An object containing the CSV file name and the CSV content as a string, encoded as specified, ready for file download or saving." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a CSV file from structured data for download or export, such as exporting tables, reports, or data summaries. It is helpful for converting data objects into a CSV string and packaging it with a proper filename and encoding for user download or backend processing.", + "limitations": "This tool does not handle downloading files directly to a user's system; it only prepares CSV content and metadata. It does not parse or process complex nested objects beyond flat key-value pairs for CSV serialization.", + "examples": [ + "Download a CSV file from a list of user information objects with default settings.", + "Export report data as CSV with semicolon delimiter and no headers.", + "Prepare CSV content under a custom filename and UTF-16 encoding." + ] + }, + "tags": [ + "file", + "csv", + "export", + "download", + "data-format", + "file-operations" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"email\":\"alice@example.com\"},{\"name\":\"Bob\",\"age\":25,\"email\":\"bob@example.com\"}]}", + "description": "Generate a CSV file from a simple array of objects with default comma delimiter and headers included." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Widget\",\"price\":19.99,\"stock\":100},{\"product\":\"Gadget\",\"price\":29.99,\"stock\":50}],\"delimiter\":\";\",\"includeHeaders\":false,\"fileName\":\"inventory.csv\"}", + "description": "Export product inventory data as CSV without headers and using semicolon as delimiter with a specified filename." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "CSV", + "context": null + } + }, + { + "name": "file-operations.downloadYAML", + "description": "Downloads YAML data from a specified URL or remote source. Accepts a URL string and optional request headers, performs an HTTP GET request, validates and parses the YAML content, then returns the raw YAML text along with a parsed JSON representation for further processing.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL or endpoint from which to download the YAML file. Must be a valid and accessible URL.", + "required": true, + "defaultValue": "" + }, + { + "name": "headers", + "type": "object", + "description": "Optional HTTP headers to include in the request, e.g., for authentication or custom user-agent.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum number of seconds to wait for the download before timing out.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object containing the raw YAML content as a string and the parsed YAML converted into a JSON structure for easy consumption by other tools or code." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically download configuration or data files in YAML format from remote HTTP(S) sources, typically APIs or raw file URLs, and want both the original YAML text as well as a parsed JSON object for processing or validation.", + "limitations": "This tool only supports downloading YAML over HTTP/HTTPS. It cannot download files from local file systems or other protocols. It assumes that the content at the URL is valid YAML and does not handle binary or non-YAML content gracefully.", + "examples": [ + "Download a remote Kubernetes configuration YAML file from a public GitHub URL.", + "Retrieve a YAML manifest from a REST API endpoint that requires custom headers for authorization." + ] + }, + "tags": [ + "download", + "yaml", + "file", + "http", + "configuration", + "parse" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/config.yaml\"}", + "description": "Download a public YAML configuration file from a standard URL with default headers and timeout." + }, + { + "inputJson": "{\"url\":\"https://api.example.com/data.yaml\",\"headers\":{\"Authorization\":\"Bearer TOKEN123\"},\"timeoutSeconds\":10}", + "description": "Download a YAML file from a protected API endpoint using a Bearer token, with a 10 second timeout." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "YAML", + "context": null + } + }, + { + "name": "file-operations.downloadXML", + "description": "Downloads XML data from a specified URL or API endpoint and saves it to a local file path. Accepts a URL string and optional HTTP headers for authentication or custom requests. Returns the saved file path and download status.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL or API endpoint from which to download the XML data.", + "required": true, + "defaultValue": "" + }, + { + "name": "savePath", + "type": "string", + "description": "Local file path where the downloaded XML file will be saved, including filename and extension.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpHeaders", + "type": "object", + "description": "Optional HTTP headers (key-value pairs) to include in the download request, e.g., for authentication.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Optional timeout in seconds for the download request before it fails. Default is 30 seconds.", + "required": false, + "defaultValue": "30" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the existing file at savePath if it exists. Default is false to avoid overwriting.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the local file path of the saved XML and a status message indicating success or error details." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically download XML data from a web resource or API and store it locally for further processing or analysis. It supports custom headers for authenticated endpoints and handles file management with overwrite control.", + "limitations": "This tool does not parse or validate the XML content; it only handles downloading and saving raw XML data. It also does not support XML downloads from URLs requiring complex authentication flows like OAuth beyond header injection.", + "examples": [ + "Download the latest RSS feed XML from a news site and save it for analysis.", + "Fetch XML data from a secured API endpoint requiring an API key header, saving the response to a specific directory.", + "Download an XML sitemap from a website and save it locally for SEO audits." + ] + }, + "tags": [ + "file", + "download", + "XML", + "network", + "HTTP", + "save", + "web" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/data.xml\",\"savePath\":\"/tmp/data.xml\"}", + "description": "Simple download of an XML file from a public URL." + }, + { + "inputJson": "{\"url\":\"https://api.example.com/secure/data\",\"savePath\":\"/data/secure.xml\",\"httpHeaders\":{\"Authorization\":\"Bearer abc123\"},\"overwrite\":true}", + "description": "Download XML data from a secured API with authorization header, overwriting any existing file." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "XML", + "context": null + } + }, + { + "name": "file-operations.downloadJSON", + "description": "Downloads JSON data by saving it to a specified file path on the user's local system. Accepts JSON content as a string or object, validates it, and writes it to the given file path with UTF-8 encoding. Produces a confirmation result indicating success or details on any write errors.", + "category": "file-operations", + "parameters": [ + { + "name": "jsonData", + "type": "string", + "description": "The JSON data to download; can be a JSON string or stringified JSON object to be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "filePath", + "type": "string", + "description": "The full path including filename where the JSON should be saved on the local filesystem.", + "required": true, + "defaultValue": "" + }, + { + "name": "prettyPrint", + "type": "boolean", + "description": "If true, the JSON will be formatted with indentation for readability before saving.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing a success boolean and optional message describing the outcome of the download operation." + }, + "aiAgent": { + "useCase": "Use this tool when you have JSON data that needs to be saved locally as a file, such as exporting configuration, data snapshots, or API responses as JSON files. Useful for persisting data generated or transformed during the workflow for later use or sharing.", + "limitations": "Cannot download files to remote machines or browsers directly; only saves JSON files where the system running the tool has write permissions. Does not handle non-JSON data formats or convert other data types automatically.", + "examples": [ + "Save JSON API response data to a local file for inspection.", + "Export user settings or preferences as a JSON file for backup.", + "Save generated report data in JSON format with pretty print for easier reading." + ] + }, + "tags": [ + "file", + "download", + "JSON", + "export", + "save", + "data", + "filesystem" + ], + "examples": [ + { + "inputJson": "{\"jsonData\":\"{\\\"name\\\":\\\"John Doe\\\",\\\"age\\\":30}\",\"filePath\":\"./output/userData.json\",\"prettyPrint\":true}", + "description": "Saving a simple JSON object to a local file with pretty formatting." + }, + { + "inputJson": "{\"jsonData\":\"[1,2,3,4]\",\"filePath\":\"/tmp/numbers.json\",\"prettyPrint\":false}", + "description": "Saving a JSON array to a file without pretty print to reduce file size." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "JSON", + "context": null + } + }, + { + "name": "file-operations.downloadTable", + "description": "Downloads a tabular dataset as a file in the specified format. Accepts a table represented as an array of objects or arrays, processes optional formatting settings, and outputs a downloadable file such as CSV, XLSX, or JSON. Useful for exporting data tables from in-memory structures to user-accessible files.", + "category": "file-operations", + "parameters": [ + { + "name": "tableData", + "type": "array", + "description": "The table data to be downloaded, represented as an array of row objects or arrays. Each row should be uniform in structure.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "The name of the file to create and download, including the extension (e.g., data.csv).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileFormat", + "type": "string", + "description": "The desired file format for download; supported formats are 'csv', 'xlsx', and 'json'.", + "required": true, + "defaultValue": "csv" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include column headers in the output file (applicable for CSV and XLSX).", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Delimiter character used in CSV output; ignored if fileFormat is not 'csv'.", + "required": false, + "defaultValue": "," + }, + { + "name": "sheetName", + "type": "string", + "description": "The name of the worksheet when exporting to XLSX format; ignored otherwise.", + "required": false, + "defaultValue": "Sheet1" + } + ], + "returns": { + "type": "object", + "description": "An object indicating success status and the downloadable file content as a Blob or data URL, depending on implementation." + }, + "aiAgent": { + "useCase": "Use this tool when needing to export structured table-like data from application memory into common file formats for download, sharing, or storage. This avoids manual file creation and formatting, streamlining client-side data export workflows.", + "limitations": "Does not support extremely large datasets that exceed in-memory handling capabilities; does not perform data validation or correcting malformed tables; limited to CSV, XLSX, and JSON exports only.", + "examples": [ + "Download the current user report table as a CSV file including headers with default comma delimiter.", + "Export sales data as an XLSX file named 'sales_report.xlsx' with a custom sheet name.", + "Generate a JSON file of the data for API export or backup purposes." + ] + }, + "tags": [ + "file", + "download", + "table", + "export", + "csv", + "xlsx", + "json" + ], + "examples": [ + { + "inputJson": "{\"tableData\":[{\"id\":1,\"name\":\"Alice\",\"score\":95},{\"id\":2,\"name\":\"Bob\",\"score\":88}],\"fileName\":\"results.csv\",\"fileFormat\":\"csv\",\"includeHeaders\":true,\"delimiter\":\",\"}", + "description": "Download a small table as CSV with headers and default comma delimiter." + }, + { + "inputJson": "{\"tableData\":[{\"product\":\"Widget\",\"quantity\":20,\"price\":9.99},{\"product\":\"Gadget\",\"quantity\":15,\"price\":15.49}],\"fileName\":\"inventory.xlsx\",\"fileFormat\":\"xlsx\",\"includeHeaders\":true,\"sheetName\":\"Inventory\"}", + "description": "Export inventory data to XLSX with headers and custom sheet name." + }, + { + "inputJson": "{\"tableData\":[{\"userId\":123,\"active\":true},{\"userId\":456,\"active\":false}],\"fileName\":\"users.json\",\"fileFormat\":\"json\"}", + "description": "Generate a JSON file representing user statuses without headers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Table", + "context": null + } + }, + { + "name": "file-operations.downloadCode", + "description": "Downloads source code files or projects from specified URLs or repository links. Accepts single or multiple URLs, supports authentication tokens for private repos, and saves files to a given local directory, returning download status and file paths.", + "category": "file-operations", + "parameters": [ + { + "name": "sourceUrls", + "type": "array", + "description": "Array of URLs pointing to code files or repositories to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Local directory path where the downloaded code should be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Optional authentication token for accessing private repositories or restricted downloads.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Whether to overwrite existing files in the destination path if they exist.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of download results, each with the source URL, success status, error messages if any, and local saved file path." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically download single or multiple code files or entire repositories from public or private sources, useful in automation workflows requiring source code acquisition. It helps in integrating code retrieval steps in automation scripts or agents.", + "limitations": "This tool does not perform repository cloning with full git history or support partial file downloads within large repositories beyond the top-level files. It relies on URLs to files or zipped archives, so it cannot interpret repository metadata or branches beyond default.", + "examples": [ + "Download code files from given URLs to a local project directory.", + "Download a private repo's zipped source code using an auth token.", + "Retrieve multiple code snippets/files from various public URLs for analysis." + ] + }, + "tags": [ + "file-download", + "code-management", + "automation", + "repository", + "source-code", + "file-operations", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"sourceUrls\":[\"https://raw.githubusercontent.com/user/repo/main/app.js\"],\"destinationPath\":\"/usr/local/projects/myapp\",\"authToken\":\"\",\"overwriteExisting\":true}", + "description": "Download a single public JavaScript file and overwrite existing if needed." + }, + { + "inputJson": "{\"sourceUrls\":[\"https://github.com/user/private-repo/archive/refs/heads/main.zip\"],\"destinationPath\":\"/home/user/projects/private\",\"authToken\":\"ghp_abcdef1234567890\",\"overwriteExisting\":false}", + "description": "Download a private repository archive with authentication token without overwriting." + }, + { + "inputJson": "{\"sourceUrls\":[\"https://example.com/code1.py\",\"https://example.com/code2.py\"],\"destinationPath\":\"C:\\\\Projects\\\\Scripts\",\"authToken\":\"\",\"overwriteExisting\":false}", + "description": "Download multiple public Python script files to specified Windows directory." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Code", + "context": null + } + }, + { + "name": "file-operations.uploadFile", + "description": "Uploads a file from the local system or a provided file buffer to a specified remote destination such as a cloud storage service or an FTP server. Accepts file path or raw file data, target destination parameters, and optional metadata, then transfers the file and returns a confirmation status with the remote file URL or path.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local filesystem path of the file to be uploaded. Required if fileBuffer is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileBuffer", + "type": "string", + "description": "Base64-encoded content of the file to be uploaded. Required if filePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationType", + "type": "string", + "description": "Type of the remote destination where file will be uploaded. Examples: 's3', 'ftp', 'http', 'azureBlob'.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationConfig", + "type": "object", + "description": "Configuration object with credentials and connection details required for the destination type (e.g., bucket name, endpoint URL, access keys).", + "required": true, + "defaultValue": "" + }, + { + "name": "remoteFileName", + "type": "string", + "description": "Name to assign to the uploaded file at the destination. If empty, original file name used.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata key-value pairs to associate with the file upon upload, if supported by destination.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing success status, remote file URL/path, and any messages or errors encountered during upload." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to transfer file data from local sources or in-memory buffers to remote storage destinations for backup, sharing, or integration with other systems. Suitable for uploading documents, images, or data files where the agent has access to file content and destination credentials.", + "limitations": "Does not perform file content validation, format conversion, or chunked uploads for very large files. Relies on correct destination configuration and available network connectivity.", + "examples": [ + "Upload a local image file to an AWS S3 bucket for further processing.", + "Send a generated PDF document from a buffer to an FTP server for official record storage.", + "Upload backup data to Azure Blob Storage with custom metadata tags." + ] + }, + "tags": [ + "upload", + "file", + "storage", + "cloud", + "ftp", + "s3", + "azure" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/tmp/report.pdf\",\"destinationType\":\"s3\",\"destinationConfig\":{\"bucketName\":\"my-bucket\",\"accessKeyId\":\"AKIA...\",\"secretAccessKey\":\"***\"},\"remoteFileName\":\"reports/2024/report.pdf\",\"metadata\":{\"author\":\"John Doe\",\"department\":\"finance\"}}", + "description": "Upload a PDF report from local filesystem to an S3 bucket under 'reports/2024/' path with metadata." + }, + { + "inputJson": "{\"fileBuffer\":\"SGVsbG8gd29ybGQ=\",\"destinationType\":\"ftp\",\"destinationConfig\":{\"host\":\"ftp.example.com\",\"port\":21,\"user\":\"ftpuser\",\"password\":\"pass\"},\"remoteFileName\":\"uploads/hello.txt\"}", + "description": "Upload a text file from base64 buffer to an FTP server into 'uploads' directory." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "File", + "context": null + } + }, + { + "name": "file-operations.uploadScreenshot", + "description": "Uploads a screenshot image file to a specified remote storage endpoint. Accepts screenshot data as a base64 string or binary file path, optional metadata (title, description), and authentication credentials. Returns the URL of the uploaded screenshot and status information.", + "category": "file-operations", + "parameters": [ + { + "name": "screenshotData", + "type": "string", + "description": "Base64 encoded image data of the screenshot to be uploaded. Required if filePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "filePath", + "type": "string", + "description": "Local file system path to the screenshot image file to be uploaded. Required if screenshotData is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationUrl", + "type": "string", + "description": "HTTP endpoint URL where the screenshot should be uploaded. Must support file uploads.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or API key to authorize the upload to the destination endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata object containing title and description to associate with the screenshot.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing upload status, uploaded file URL, and optionally any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to save or share screenshot images by uploading them to a cloud or web storage service. It handles both base64 or local files and manages metadata and authentication to integrate with remote backends.", + "limitations": "This tool does not capture screenshots; it only uploads them. It requires valid endpoint URL and authentication. It cannot perform image transformations or optimizations before upload.", + "examples": [ + "Upload a screenshot from base64 data to a cloud storage with API token.", + "Upload a local PNG screenshot file to a secure server with metadata title and description.", + "Upload screenshot without metadata, only with authentication token and destination URL." + ] + }, + "tags": [ + "file upload", + "screenshot", + "media", + "image", + "cloud storage", + "authentication", + "file-operations" + ], + "examples": [ + { + "inputJson": "{\"screenshotData\":\"iVBORw0KGgoAAAANSUhEUgAAA...\",\"destinationUrl\":\"https://upload.example.com/api/upload\",\"authToken\":\"abc123token\",\"metadata\":{\"title\":\"Error Screen\",\"description\":\"Screenshot of error message on login\"}}", + "description": "Upload a base64 encoded screenshot image to a cloud endpoint with metadata and authentication." + }, + { + "inputJson": "{\"filePath\":\"/tmp/screenshots/screen1.png\",\"destinationUrl\":\"https://files.example.com/upload\",\"authToken\":\"token987\"}", + "description": "Upload a local screenshot PNG file to a remote server requiring auth, without metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Screenshot", + "context": null + } + }, + { + "name": "file-operations.downloadDataset", + "description": "Downloads a dataset file from a specified URL, optionally authenticating with an API key, and saves it locally with a specified filename and format. Supports optional timeout and retry parameters for robust downloads.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL from which to download the dataset file.", + "required": true, + "defaultValue": "" + }, + { + "name": "saveAs", + "type": "string", + "description": "Local filename (including path) to save the downloaded dataset file.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Expected dataset file format (e.g., CSV, JSON, ZIP) to validate or process download.", + "required": false, + "defaultValue": "csv" + }, + { + "name": "apiKey", + "type": "string", + "description": "Optional API key for authorization if the dataset URL requires authentication.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for the download to complete before aborting.", + "required": false, + "defaultValue": "60" + }, + { + "name": "maxRetries", + "type": "number", + "description": "Number of times to retry download if it fails due to network errors.", + "required": false, + "defaultValue": "3" + } + ], + "returns": { + "type": "object", + "description": "An object indicating success or failure, with message details and the local path of the saved dataset if successful." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to programmatically retrieve datasets from web sources, especially those requiring authorization or configurable download options, and save them locally for analysis or further processing. It helps automate dataset acquisition workflows reliably.", + "limitations": "Does not parse or analyze dataset contents, only downloads and saves files. Cannot handle interactive authentication flows beyond simple API keys. Relies on valid URLs and accessible endpoints.", + "examples": [ + "Download a CSV dataset from a public URL and save it locally.", + "Download an authenticated JSON dataset using an API key and save it with a specified filename.", + "Download a zipped dataset from a URL with retries and timeout configured." + ] + }, + "tags": [ + "file", + "download", + "dataset", + "data acquisition", + "http", + "api", + "auth" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/data/sample.csv\",\"saveAs\":\"/tmp/sample.csv\"}", + "description": "Download a public CSV dataset and save it as sample.csv" + }, + { + "inputJson": "{\"url\":\"https://api.example.com/data\",\"saveAs\":\"data.json\",\"format\":\"json\",\"apiKey\":\"abcdef123456\"}", + "description": "Download a JSON dataset from an authenticated API endpoint using an API key" + }, + { + "inputJson": "{\"url\":\"https://datasets.example.com/archive.zip\",\"saveAs\":\"/tmp/archive.zip\",\"format\":\"zip\",\"timeoutSeconds\":120,\"maxRetries\":5}", + "description": "Download a large zipped dataset file with extended timeout and retries" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Dataset", + "context": null + } + }, + { + "name": "file-operations.uploadAttachment", + "description": "Uploads a file attachment from local storage or a URL to a specified target location or server. Accepts file path or URL input, validates and streams the file data, and returns a confirmation with metadata including file URL, size, and upload status.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path to the file to upload (required if fileUrl is not provided)", + "required": false, + "defaultValue": "" + }, + { + "name": "fileUrl", + "type": "string", + "description": "Publicly accessible URL of the file to upload (required if filePath is not provided)", + "required": false, + "defaultValue": "" + }, + { + "name": "targetLocation", + "type": "string", + "description": "Destination path or endpoint where the file should be uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists at the target location", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata key-value pairs to associate with the uploaded attachment", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing upload status, accessible URL or path of the uploaded file, file size in bytes, and any error messages if applicable" + }, + "aiAgent": { + "useCase": "Use this tool when you need to upload attachments such as documents, images, or other media files to a remote server or cloud storage as part of a workflow. It handles uploads from either local files or remote URLs, returning a confirmation with file metadata to confirm success.", + "limitations": "This tool cannot modify file contents or perform virus scanning. It requires access permissions to the target location and valid input source; it cannot fetch files from URLs requiring authentication.", + "examples": [ + "Upload a profile picture from a local file path to the user avatar storage folder.", + "Upload a PDF document available at a public URL to a cloud storage bucket with metadata tags.", + "Overwrite an existing attachment at the target location with a new local file." + ] + }, + "tags": [ + "file", + "upload", + "attachment", + "media", + "remote", + "storage", + "transfer", + "file-management" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/tmp/image.png\",\"targetLocation\":\"s3://mybucket/uploads/user123/image.png\",\"overwrite\":true}", + "description": "Upload a local image file to an S3 bucket, overwriting if exists." + }, + { + "inputJson": "{\"fileUrl\":\"https://example.com/manual.pdf\",\"targetLocation\":\"/var/data/manuals/2024_manual.pdf\",\"metadata\":{\"project\":\"Q2Release\",\"author\":\"John Doe\"}}", + "description": "Upload a remote PDF by URL to a local directory with metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Attachment", + "context": null + } + }, + { + "name": "file-operations.downloadDocument", + "description": "Downloads a document file from a specified URL and saves it to a local file path. Accepts the source URL, optional authentication headers, and local destination path. Performs HTTP GET request to fetch the document and writes it to disk, returning success status and file metadata.", + "category": "file-operations", + "parameters": [ + { + "name": "sourceUrl", + "type": "string", + "description": "The URL of the document to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Local file system path where the downloaded document will be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "authenticationHeaders", + "type": "object", + "description": "Optional HTTP headers (e.g., authorization tokens) to include in the download request.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Optional timeout in seconds for the download request. Default is 30 seconds.", + "required": false, + "defaultValue": "30" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists at the destination path.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing success status (true/false), HTTP status code, local file path if successful, and error message if any." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically download a document from the internet or a protected resource and save it to a local file system for further processing or storage. It's useful for automating document retrieval tasks from URLs requiring optional authentication.", + "limitations": "Cannot handle interactive authentication flows like OAuth redirects. Does not support partial downloads or resume capabilities. Relies on network connectivity and valid URL.", + "examples": [ + "Download a public PDF file from a URL to local disk.", + "Download a document from a URL requiring a bearer token header.", + "Download and overwrite an existing local document with the latest version from the web." + ] + }, + "tags": [ + "file", + "download", + "document", + "http", + "network", + "automation" + ], + "examples": [ + { + "inputJson": "{\"sourceUrl\":\"https://example.com/sample.pdf\",\"destinationPath\":\"/tmp/sample.pdf\"}", + "description": "Download a PDF from a public URL and save it locally." + }, + { + "inputJson": "{\"sourceUrl\":\"https://api.example.com/secure/doc1\",\"destinationPath\":\"/data/doc1.docx\",\"authenticationHeaders\":{\"Authorization\":\"Bearer abc123token\"},\"overwrite\":true}", + "description": "Download a secured document with bearer token authentication and overwrite existing file." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Document", + "context": null + } + }, + { + "name": "file-operations.uploadAudio", + "description": "Uploads an audio file to a specified remote storage server or cloud service. Accepts audio files in common formats (e.g., mp3, wav, flac) via a file path or binary input, uploads them using provided authentication credentials, and returns metadata including upload status, URL, and file info.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path to the audio file to be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Optional custom filename to use for the uploaded audio file. If empty, original filename is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationUrl", + "type": "string", + "description": "URL or endpoint of the remote storage or service where the audio will be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or API key required to authorize the upload request.", + "required": true, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file at destination if it already exists (true) or not (false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing upload result details: success status, uploaded file URL, file size in bytes, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to store audio files to a remote server or cloud storage as part of workflows like media management, content publishing, or audio analysis pipelines. It streamlines authenticated uploads and provides detailed feedback for integration.", + "limitations": "This tool handles uploading only; it does not perform any audio format conversion, validation beyond file accessibility, or resume interrupted uploads.", + "examples": [ + "Upload local podcast audio to cloud storage for hosting.", + "Save recorded interview audio files to a secure remote server.", + "Transfer processed audio clips to a content distribution endpoint." + ] + }, + "tags": [ + "file upload", + "audio", + "cloud storage", + "media management", + "authentication", + "remote upload" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/user/home/music/song.mp3\",\"fileName\":\"my_favorite_song.mp3\",\"destinationUrl\":\"https://api.cloudstorage.com/upload\",\"authToken\":\"abc123token\",\"overwrite\":true}", + "description": "Upload an MP3 file with a custom filename to cloud storage, allowing overwrite if it exists." + }, + { + "inputJson": "{\"filePath\":\"./recordings/interview.wav\",\"fileName\":\"\",\"destinationUrl\":\"https://media.server.com/uploadAudio\",\"authToken\":\"securetoken987\",\"overwrite\":false}", + "description": "Upload a WAV audio recording to a media server keeping original filename without overwriting existing files." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Audio", + "context": null + } + }, + { + "name": "file-operations.uploadVideo", + "description": "Uploads a video file to a specified storage location or video hosting service. Accepts video file content or path, validates format and size, and returns a unique video identifier and accessible URL upon successful upload.", + "category": "file-operations", + "parameters": [ + { + "name": "videoFilePath", + "type": "string", + "description": "Local file path to the video file to be uploaded.", + "required": false, + "defaultValue": "" + }, + { + "name": "videoFileContent", + "type": "string", + "description": "Base64 encoded content of the video file if not using a file path.", + "required": false, + "defaultValue": "" + }, + { + "name": "destination", + "type": "string", + "description": "Target destination or storage service identifier (e.g., 's3', 'azureBlob', or custom URL).", + "required": true, + "defaultValue": "s3" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata object including title, description, tags associated with the video.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxFileSizeMB", + "type": "number", + "description": "Maximum allowed file size for upload in megabytes.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the video ID, URL where the video is accessible, and any upload status messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to upload a video file to a cloud storage or video hosting platform, enabling subsequent retrieval, sharing, or processing. Ideal for workflows involving media upload automation or integration with video services.", + "limitations": "This tool does not transcode or process the video content beyond basic validation. Upload destination must be supported and properly configured by external integration.", + "examples": [ + "Upload a user-generated video file to cloud storage with title and tags.", + "Upload a base64 encoded video from memory to a specified video hosting service.", + "Upload a video file with file size restriction enforced." + ] + }, + "tags": [ + "upload", + "file-operations", + "video", + "cloud-storage", + "media-management" + ], + "examples": [ + { + "inputJson": "{\"videoFilePath\":\"/path/to/video.mp4\",\"destination\":\"s3\",\"metadata\":{\"title\":\"My Vacation\",\"description\":\"Vacation clips from 2023\",\"tags\":[\"vacation\",\"travel\"]},\"maxFileSizeMB\":100}", + "description": "Upload a local MP4 video file to AWS S3 with descriptive metadata and 100 MB max size limit." + }, + { + "inputJson": "{\"videoFileContent\":\"VGhpcyBpcyBhIGJhc2U2NCBlbmNvZGVkIHZpZGVvIGNvbnRlbnQ=\",\"destination\":\"azureBlob\",\"metadata\":{\"title\":\"Sample Video\"}}", + "description": "Upload a base64 encoded video content string to Azure Blob Storage with a title metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Video", + "context": null + } + }, + { + "name": "file-operations.downloadReport", + "description": "Downloads a report file from a specified URL, optionally applying authentication headers and saving it to a given local path. Accepts URL as input, supports HTTP headers for auth, and writes the downloaded content to disk in the desired location. Returns status and file path info.", + "category": "file-operations", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The full URL from which to download the report file.", + "required": true, + "defaultValue": "" + }, + { + "name": "savePath", + "type": "string", + "description": "Local file system path where the downloaded report will be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "headers", + "type": "object", + "description": "Optional HTTP headers object for authentication or custom requests (e.g., Authorization tokens).", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for the download before aborting.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "Outputs the download status, local file path of saved report, and any relevant error messages if failed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically download a report file from a remote server or API endpoint, especially when authentication or custom headers are required and the file must be saved locally for further processing or analysis.", + "limitations": "Cannot parse or interpret report content; only downloads raw file data. Does not support multi-part or chunked downloads automatically.", + "examples": [ + "Download the latest sales report from a secure URL with authentication headers and save it locally.", + "Retrieve a CSV or PDF report from a remote endpoint handling timeouts and saving file under a specific directory.", + "Programmatically fetch a report file for offline processing from an internal web service URL." + ] + }, + "tags": [ + "file", + "download", + "report", + "http", + "authentication", + "file-saving" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/reports/monthly_sales.pdf\",\"savePath\":\"/tmp/monthly_sales.pdf\",\"headers\":{\"Authorization\":\"Bearer abc123\"},\"timeoutSeconds\":30}", + "description": "Downloads a secure monthly sales report PDF with an authorization token, saving it under /tmp folder." + }, + { + "inputJson": "{\"url\":\"https://data.example.org/reports/annual_summary.csv\",\"savePath\":\"/data/annual_summary.csv\"}", + "description": "Downloads an annual summary CSV report without additional headers and saves it into /data directory." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "download", + "object": "Report", + "context": null + } + }, + { + "name": "file-operations.uploadJSON", + "description": "Uploads a JSON data file or content string to a specified storage location or endpoint. Accepts either a JSON string or a path to a local JSON file, validates the JSON format, and then uploads it using HTTP or filesystem methods as specified. Returns upload status and metadata such as size and upload destination.", + "category": "file-operations", + "parameters": [ + { + "name": "jsonContent", + "type": "string", + "description": "The JSON data as a string to be uploaded. Required if jsonFilePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "jsonFilePath", + "type": "string", + "description": "Local path to the JSON file to be uploaded. Required if jsonContent is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "uploadUrl", + "type": "string", + "description": "The destination URL or endpoint for uploading the JSON data, e.g., an HTTP API endpoint. Required if targetLocation is not specified.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetLocation", + "type": "string", + "description": "A local or network file path to upload the JSON file to instead of using a URL endpoint. Required if uploadUrl is not specified.", + "required": false, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method to use when uploading to a URL endpoint, e.g., POST or PUT. Defaults to POST.", + "required": false, + "defaultValue": "POST" + }, + { + "name": "headers", + "type": "object", + "description": "Optional HTTP headers to include in the upload request when using uploadUrl, e.g., authorization tokens.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "If true, overwrite existing files at the target location. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the upload status (e.g., success or failure), HTTP response code if applicable, bytes uploaded, the final destination path or URL, and any error messages encountered." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to transfer valid JSON data to a remote API endpoint or save it to a specific file location, supporting scenarios like configuration deployment, data syncing, or API-driven uploads. It handles both local files and direct JSON content strings with validation to ensure only correct JSON is uploaded.", + "limitations": "This tool does not perform complex JSON transformations or validations beyond basic syntax checks. It does not support multipart upload for very large files or handle authentication beyond simple HTTP headers provided. It cannot upload to unsupported protocols outside HTTP or filesystem paths.", + "examples": [ + "Upload JSON string to a given REST API with a Bearer token header.", + "Upload a local JSON config file to a local directory, overwriting any existing file.", + "Upload JSON data using PUT HTTP method to update a resource on a web service." + ] + }, + "tags": [ + "upload", + "JSON", + "file-operations", + "data-transfer", + "HTTP", + "filesystem" + ], + "examples": [ + { + "inputJson": "{\"jsonContent\":\"{\\\"name\\\": \\\"test\\\", \\\"value\\\": 123}\",\"uploadUrl\":\"https://api.example.com/upload\",\"httpMethod\":\"POST\",\"headers\":{\"Authorization\":\"Bearer abc123\"},\"overwrite\":true}", + "description": "Uploading a JSON string to a REST API endpoint with authorization and overwrite flag." + }, + { + "inputJson": "{\"jsonFilePath\":\"/tmp/data.json\",\"targetLocation\":\"/var/data/backup.json\",\"overwrite\":false}", + "description": "Uploading a local JSON file from one path to another on the local filesystem, without overwriting existing files." + }, + { + "inputJson": "{\"jsonContent\":\"{\\\"settings\\\":{\\\"theme\\\":\\\"dark\\\"}}\",\"uploadUrl\":\"https://api.example.com/config\",\"httpMethod\":\"PUT\"}", + "description": "Uploading JSON data to update configuration by sending a PUT request to a web service." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "JSON", + "context": null + } + }, + { + "name": "file-operations.uploadTable", + "description": "Uploads a tabular data file (CSV, Excel, or JSON array) to a specified storage location. Accepts a file input or raw content string, validates format and optional schema, then stores the table data and returns a reference URL or identifier for future access.", + "category": "file-operations", + "parameters": [ + { + "name": "fileName", + "type": "string", + "description": "The name of the file being uploaded, including extension (e.g., data.csv).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileContent", + "type": "string", + "description": "Raw string content of the tabular data file to upload (CSV, JSON array, or Excel base64).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileType", + "type": "string", + "description": "Type/format of the file content being uploaded (csv, json, xlsx).", + "required": true, + "defaultValue": "" + }, + { + "name": "storagePath", + "type": "string", + "description": "The target storage path or directory where the table file should be saved.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "validateSchema", + "type": "boolean", + "description": "Whether to validate the table columns against a provided schema (if schema is given).", + "required": false, + "defaultValue": "false" + }, + { + "name": "schema", + "type": "object", + "description": "Optional schema definition outlining expected columns and data types.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the storage reference URL or identifier confirming successful upload." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to save or backup structured tabular data received as strings or files into persistent storage for subsequent processing or retrieval. It supports common table formats and offers optional schema validation to ensure data integrity before upload.", + "limitations": "Does not perform complex data transformations or cleaning beyond basic schema validation. Limited to uploading tabular data formats only. Does not support databases or streaming large datasets incrementally.", + "examples": [ + "Upload a CSV sales report file string to cloud storage under folder 'reports/2024'.", + "Store an Excel inventory spreadsheet encoded in base64 with optional schema validation on columns.", + "Save a JSON array as a table file named 'users.json' in a temp directory." + ] + }, + "tags": [ + "upload", + "file operations", + "table data", + "csv", + "excel", + "json", + "storage", + "validation" + ], + "examples": [ + { + "inputJson": "{\"fileName\":\"sales.csv\",\"fileContent\":\"name,amount,date\\nAlice,100,2024-01-01\\nBob,150,2024-01-02\",\"fileType\":\"csv\",\"storagePath\":\"reports/2024\",\"validateSchema\":false,\"schema\":{}}", + "description": "Uploading a simple CSV file containing sales data to the reports/2024 folder without schema validation." + }, + { + "inputJson": "{\"fileName\":\"inventory.xlsx\",\"fileContent\":\"UEsDBBQABgAIAAAAIQCzT98ytQEAAOEPAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAA\",\"fileType\":\"xlsx\",\"storagePath\":\"inventory\",\"validateSchema\":true,\"schema\":{\"columns\":[{\"name\":\"itemId\",\"type\":\"string\"},{\"name\":\"quantity\",\"type\":\"number\"}]}}", + "description": "Uploading an Excel inventory file with base64 content and validating against a given column schema." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Table", + "context": null + } + }, + { + "name": "file-operations.uploadImage", + "description": "Uploads an image file to a specified storage location or service. Accepts image content via file path or base64 string, validates file type and size, optionally resizes or compresses the image, and returns a URL or identifier for the uploaded image.", + "category": "file-operations", + "parameters": [ + { + "name": "imageSource", + "type": "string", + "description": "Path to the image file on local disk or a base64 encoded image string.", + "required": true, + "defaultValue": "" + }, + { + "name": "destination", + "type": "string", + "description": "Target storage location identifier or URL endpoint for uploading the image.", + "required": true, + "defaultValue": "" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Optional width to resize the image to, preserving aspect ratio if height not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Optional height to resize the image to, preserving aspect ratio if width not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "compressQuality", + "type": "number", + "description": "Optional compression quality percentage (1-100) to reduce image file size.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Whether to overwrite the file if an image with the same name exists at destination.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the public URL or unique identifier of the uploaded image, the final image dimensions, and the file size in bytes." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically upload images from local or encoded sources to remote storage or CDN, optionally adjusting size or quality for optimized delivery. Useful for applications managing user avatars, product photos, or gallery images requiring automated image processing before upload.", + "limitations": "This tool cannot perform complex image editing beyond basic resizing and compression. It does not support uploading non-image files or handle authentication to storage services unless pre-configured.", + "examples": [ + "Upload a user profile picture from local disk and resize to 200x200 pixels.", + "Upload a base64-encoded product image string compressing it to 80% quality.", + "Upload an image file ensuring not to overwrite existing files at the target location." + ] + }, + "tags": [ + "upload", + "image", + "file-storage", + "image-processing", + "media", + "resize", + "compress" + ], + "examples": [ + { + "inputJson": "{\"imageSource\":\"/path/to/avatar.jpg\",\"destination\":\"s3://user-uploads/avatars/\",\"resizeWidth\":200,\"resizeHeight\":200,\"compressQuality\":85,\"overwriteExisting\":true}", + "description": "Upload a local avatar image to S3, resizing to 200x200 pixels and compressing quality to 85%, allowing overwrite." + }, + { + "inputJson": "{\"imageSource\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA...\",\"destination\":\"https://example-cdn.com/uploads/\",\"compressQuality\":80}", + "description": "Upload a base64 PNG image string to a CDN endpoint, compressing the image to 80% quality with no resizing." + }, + { + "inputJson": "{\"imageSource\":\"/images/event-photo.png\",\"destination\":\"/var/www/html/uploads/\",\"overwriteExisting\":false}", + "description": "Upload a local event photo to a web server upload folder, refusing to overwrite if file exists." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Image", + "context": null + } + }, + { + "name": "file-operations.uploadCode", + "description": "Uploads source code files to a designated remote repository or storage service. Accepts file content, file name, and destination details, performs validation and storage operations, and returns the upload status and metadata such as file URL or repository info.", + "category": "file-operations", + "parameters": [ + { + "name": "fileName", + "type": "string", + "description": "The name of the code file to upload, including extension (e.g., script.js).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileContent", + "type": "string", + "description": "The full code content of the file to be uploaded as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "destination", + "type": "object", + "description": "An object specifying where to upload the code, including type (e.g., repository, storage), URL or endpoint, and optional authentication info.", + "required": true, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite an existing file with the same name at the destination if it exists.", + "required": false, + "defaultValue": "false" + }, + { + "name": "commitMessage", + "type": "string", + "description": "A message describing the changes or purpose of the upload, used if uploading to a version control repository.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the upload (success or failure), URL or path to the uploaded file, and any relevant metadata such as version or commit ID." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically upload source code files to a remote code repository (e.g., GitHub) or storage service (e.g., cloud bucket) as part of continuous integration, collaborative development, or deployment pipelines. It handles validation and communication with the remote service to confirm successful upload.", + "limitations": "Does not perform code compilation, syntax validation, or security scanning. Authentication credentials must be correctly provided in the destination object. Does not create repositories or storage buckets, only uploads to existing destinations.", + "examples": [ + "Upload a JavaScript file to a GitHub repository with a commit message.", + "Save a Python script to a cloud storage bucket without overwriting existing files.", + "Upload multiple code files sequentially to a remote version control system." + ] + }, + "tags": [ + "file", + "upload", + "code", + "repository", + "storage", + "source code", + "devops", + "automation" + ], + "examples": [ + { + "inputJson": "{\"fileName\":\"app.js\",\"fileContent\":\"console.log('Hello, world!');\",\"destination\":{\"type\":\"repository\",\"url\":\"https://github.com/user/project\",\"authToken\":\"ghp_exampletoken\"},\"overwrite\":true,\"commitMessage\":\"Add initial app.js file\"}", + "description": "Uploading a JavaScript file named app.js to a GitHub repository with overwrite enabled and a commit message." + }, + { + "inputJson": "{\"fileName\":\"script.py\",\"fileContent\":\"print('Data processing')\",\"destination\":{\"type\":\"storage\",\"url\":\"https://cloudstorage.example.com/bucket\",\"authToken\":\"token123\"},\"overwrite\":false,\"commitMessage\":\"\"}", + "description": "Uploading a Python script to a cloud storage bucket without overwriting if the file exists." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Code", + "context": null + } + }, + { + "name": "file-operations.uploadHTML", + "description": "Uploads an HTML file or HTML content string to a specified storage location or web server endpoint. Accepts either a local file path or raw HTML content as input, performs validation to ensure valid HTML format, and then uploads the data to a target URL or storage service, returning a confirmation response including the upload status and accessible URL if applicable.", + "category": "file-operations", + "parameters": [ + { + "name": "htmlContent", + "type": "string", + "description": "Raw HTML content to upload; if provided, takes precedence over filePath.", + "required": false, + "defaultValue": "" + }, + { + "name": "filePath", + "type": "string", + "description": "Local path to an HTML file to upload; used if htmlContent is empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "uploadUrl", + "type": "string", + "description": "Destination URL or API endpoint where the HTML content should be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Optional authentication token for secure upload endpoints, such as bearer tokens.", + "required": false, + "defaultValue": "" + }, + { + "name": "contentType", + "type": "string", + "description": "MIME type of the uploaded content, typically 'text/html'.", + "required": false, + "defaultValue": "text/html" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite existing content at the destination if it exists.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the upload operation, any error messages, and the URL where the HTML content is accessible if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically upload HTML content or HTML files to web servers, content management systems, or storage services as part of web asset deployment or content updates. It supports both raw HTML strings and file-based inputs, allowing flexible workflows for web developers or automated systems managing web content.", + "limitations": "Does not perform comprehensive content sanitization or security scanning; the tool uploads as-is. It requires that the destination server accept uploads via HTTP requests with proper authentication if needed. Does not support large file chunking or resumable uploads.", + "examples": [ + "Upload a local index.html to a web server endpoint that requires an auth token.", + "Upload raw HTML content to a staging API URL without authentication.", + "Overwrite existing HTML content at a specified upload URL using raw HTML input." + ] + }, + "tags": [ + "upload", + "html", + "file-management", + "web-content", + "http", + "api", + "file-operations" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/local/path/to/page.html\",\"uploadUrl\":\"https://example.com/upload\",\"authToken\":\"Bearer abc123\",\"overwrite\":true}", + "description": "Uploads a local HTML file to a remote server with authentication, overwriting existing content." + }, + { + "inputJson": "{\"htmlContent\":\"Hello World\",\"uploadUrl\":\"https://example.com/api/upload\",\"contentType\":\"text/html\"}", + "description": "Uploads raw HTML string content to an API endpoint without authentication, default content type." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "HTML", + "context": null + } + }, + { + "name": "file-operations.uploadYAML", + "description": "Uploads a YAML file from a given file path or raw content to a specified destination, optionally validating its syntax and returning metadata about the upload. Accepts local file paths or YAML content as input, processes upload to a target directory or storage, and outputs success status and file info.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local filesystem path to the YAML file to upload. Required if rawContent is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "rawContent", + "type": "string", + "description": "Raw YAML content as a string to upload. Required if filePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Target path or directory where the YAML file will be uploaded. If directory, original filename is preserved; if file path, uploaded file uses that name.", + "required": true, + "defaultValue": "" + }, + { + "name": "validateSyntax", + "type": "boolean", + "description": "Whether to validate YAML syntax before uploading to catch errors early.", + "required": false, + "defaultValue": "true" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Allow overwriting the destination file if it already exists.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Result object indicating upload success, file path, and optionally validation errors." + }, + "aiAgent": { + "useCase": "Use this tool when you need to transfer or save YAML configuration or data files from local sources or raw content strings to a specified storage destination, with optional syntax validation to ensure YAML correctness before saving.", + "limitations": "Cannot upload files from remote URLs directly; content must be local or provided as raw string. Does not support editing or transforming YAML content beyond validation.", + "examples": [ + "Upload a local YAML file to a remote directory ensuring syntax is checked.", + "Upload YAML string content as a file to a specified path without overwriting existing files.", + "Validate and upload a YAML config file to a backup folder replacing old config if allowed." + ] + }, + "tags": [ + "file", + "upload", + "yaml", + "validation", + "configuration", + "file-management" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/local/configs/app.yaml\",\"destinationPath\":\"/remote/storage/configs/\",\"validateSyntax\":true,\"overwrite\":false}", + "description": "Upload a local YAML file to a remote directory with syntax validation and no overwrite." + }, + { + "inputJson": "{\"rawContent\":\"key: value\\nlist:\\n - item1\\n - item2\",\"destinationPath\":\"/remote/storage/data/settings.yaml\",\"validateSyntax\":true,\"overwrite\":true}", + "description": "Upload raw YAML content as a new file, validate syntax, and overwrite existing file if present." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "YAML", + "context": null + } + }, + { + "name": "file-operations.uploadXML", + "description": "Uploads an XML file to a specified storage destination. The tool accepts XML content either as a raw string or a file path, validates basic XML structure, and uploads the content to the target location such as a server, cloud storage or database. It returns an upload status including success confirmation and resource identifier.", + "category": "file-operations", + "parameters": [ + { + "name": "xmlContent", + "type": "string", + "description": "Raw XML content as a string to upload. Required if xmlFilePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "xmlFilePath", + "type": "string", + "description": "Local file path to the XML file to upload. Required if xmlContent is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationType", + "type": "string", + "description": "Type of destination to upload to, e.g., \"server\", \"cloudStorage\", \"database\".", + "required": true, + "defaultValue": "server" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Target path or identifier at the destination where the XML file will be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists at the destination.", + "required": false, + "defaultValue": "false" + }, + { + "name": "validateXML", + "type": "boolean", + "description": "Whether to perform a structural XML validation before upload.", + "required": false, + "defaultValue": "true" + }, + { + "name": "authToken", + "type": "string", + "description": "Authorization token or key to authenticate upload requests if needed.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the upload operation, including success flag, message, and optionally the uploaded resource identifier or URL." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically upload XML data files to various storage destinations within automated workflows. It is suitable for transferring configuration files, data feeds, or reports in XML format to servers, cloud storage buckets, or databases requiring file import. The tool handles basic XML validation and supports authentication for secure uploads.", + "limitations": "This tool does not parse or transform XML content beyond basic validation. It cannot handle incremental or partial uploads of large XML files. It requires either raw content or a file path for input, and does not generate XML content itself.", + "examples": [ + "Upload an XML configuration file from local disk to a cloud storage bucket with overwrite enabled.", + "Upload XML content received as a string to a remote server, validating XML before upload.", + "Upload an XML feed to a database system using an authentication token." + ] + }, + "tags": [ + "file upload", + "XML", + "data transfer", + "cloud storage", + "server upload", + "file management" + ], + "examples": [ + { + "inputJson": "{\"xmlFilePath\":\"/local/path/config.xml\",\"destinationType\":\"cloudStorage\",\"destinationPath\":\"bucket/config.xml\",\"overwrite\":true}", + "description": "Upload an XML configuration file from local storage to a cloud storage bucket, overwriting existing file." + }, + { + "inputJson": "{\"xmlContent\":\"\",\"destinationType\":\"server\",\"destinationPath\":\"/uploads/note.xml\",\"validateXML\":true}", + "description": "Upload raw XML string content to a server path with validation." + }, + { + "inputJson": "{\"xmlFilePath\":\"/data/feed.xml\",\"destinationType\":\"database\",\"destinationPath\":\"feeds/xmlFeed\",\"authToken\":\"abcd1234\"}", + "description": "Upload XML feed file to a database destination using an authorization token." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "XML", + "context": null + } + }, + { + "name": "file-operations.uploadMarkdown", + "description": "Uploads Markdown content or Markdown files to a specified storage destination. Accepts raw Markdown text or a Markdown file path, processes any optional metadata, and stores the content securely. Returns an upload status with the storage location or error details.", + "category": "file-operations", + "parameters": [ + { + "name": "markdownContent", + "type": "string", + "description": "Raw Markdown text to be uploaded directly. Required if filePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "filePath", + "type": "string", + "description": "Local file system path of the Markdown file to upload. Required if markdownContent is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "destination", + "type": "string", + "description": "The target storage location or URL where the Markdown content will be uploaded. Could be a cloud bucket, server path, or API endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs of metadata to associate with the Markdown content, e.g., tags, author, or description.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Flag indicating whether to overwrite existing content at the destination if it exists. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Upload status including success flag, message, and storage location or error information if upload failed" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to upload Markdown content, either generated dynamically or from existing files, to appropriate storage or web destinations, preserving any associated metadata and handling overwrite policies. This supports content management, publishing workflows, and data archival.", + "limitations": "This tool does not parse or validate Markdown syntax, nor does it convert Markdown to other formats; it only uploads raw Markdown content. The tool assumes access permissions to the destination are properly configured beforehand.", + "examples": [ + "Upload generated Markdown documentation to a project repository.", + "Upload a README.md file from local disk to a cloud storage bucket.", + "Upload Markdown content with metadata tags for categorization." + ] + }, + "tags": [ + "upload", + "markdown", + "file", + "content-management", + "storage", + "file-operations" + ], + "examples": [ + { + "inputJson": "{\"markdownContent\":\"# Project Title\\nThis is a sample markdown content.\",\"destination\":\"https://storage.example.com/project-docs/README.md\",\"overwrite\":true}", + "description": "Uploading raw Markdown text content to a cloud storage URL with overwrite enabled." + }, + { + "inputJson": "{\"filePath\":\"./docs/README.md\",\"destination\":\"/mnt/shared/docs/README.md\",\"metadata\":{\"author\":\"John Doe\",\"version\":\"1.0\"},\"overwrite\":false}", + "description": "Uploading a local Markdown file to a network shared folder with metadata and without overwriting existing files." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Markdown", + "context": null + } + }, + { + "name": "file-operations.uploadDataset", + "description": "Uploads a dataset file to a specified cloud storage or database endpoint. Accepts dataset files in common formats such as CSV, JSON, or Excel, validates basic structure, and stores them under a given project or folder name. Returns metadata about the upload including file size, type, and storage location URL.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local file system path to the dataset file to upload (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationType", + "type": "string", + "description": "Type of destination to upload to: 'cloudStorage' or 'database' (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Target path or connection string for upload destination, e.g., cloud folder path or database table name (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "File format of the dataset: 'csv', 'json', 'xlsx'. If not provided, deduced from file extension (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the dataset if it already exists at the destination (optional).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing upload metadata including fileName, fileSizeBytes, format, destinationUrl, and a success status." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically upload datasets stored locally to a remote storage or database while ensuring correct format handling and metadata reporting. It is ideal for automating data ingestion in ML pipelines or data processing workflows.", + "limitations": "This tool does not perform deep content validation beyond basic format checks, nor does it transform or clean data. It only supports common file formats and predefined destination types. It requires existing access and permissions to the destination.", + "examples": [ + "Upload a CSV dataset located at '/data/sales.csv' to a cloud bucket named 'project-data' without overwriting existing files.", + "Upload an Excel dataset to a database table 'customer_info' overwriting any existing data.", + "Upload a JSON dataset to cloud storage, letting the tool detect format automatically from file extension." + ] + }, + "tags": [ + "upload", + "dataset", + "file", + "cloudStorage", + "database", + "dataIngestion", + "fileTransfer" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/tmp/data/customers.csv\",\"destinationType\":\"cloudStorage\",\"destinationPath\":\"projectX/datasets/customers/\",\"format\":\"csv\",\"overwrite\":false}", + "description": "Upload customers.csv dataset file to a cloud storage under projectX folder without overwriting existing data." + }, + { + "inputJson": "{\"filePath\":\"/home/user/records.xlsx\",\"destinationType\":\"database\",\"destinationPath\":\"sales_db.records\",\"format\":\"xlsx\",\"overwrite\":true}", + "description": "Upload an Excel dataset to the 'records' table in the sales_db database, overwriting any existing data." + }, + { + "inputJson": "{\"filePath\":\"/var/data/events.json\",\"destinationType\":\"cloudStorage\",\"destinationPath\":\"events_archive/2024/\",\"overwrite\":false}", + "description": "Upload a JSON dataset to cloud storage at 'events_archive/2024/', auto-detecting file format from extension." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Dataset", + "context": null + } + }, + { + "name": "file-operations.uploadCSV", + "description": "Uploads a CSV file from a specified file path or raw content string, validates its structure optionally using provided delimiter and header presence info, and stores it to a target storage path or system. Returns status, uploaded file metadata, and any validation errors.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path of the CSV file to upload. Required if fileContent not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileContent", + "type": "string", + "description": "Raw CSV content as string. Required if filePath not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetPath", + "type": "string", + "description": "Destination path or storage URI where the CSV file should be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used as field delimiter in the CSV file (e.g., ',', ';').", + "required": false, + "defaultValue": "," + }, + { + "name": "hasHeader", + "type": "boolean", + "description": "Indicates whether the CSV content includes a header row.", + "required": false, + "defaultValue": "true" + }, + { + "name": "validateStructure", + "type": "boolean", + "description": "If true, validates CSV structure (consistency of columns) before upload.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Upload result status including success boolean, message, uploaded file metadata (like size and row count), and any validation errors encountered." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to programmatically upload CSV data from local storage or raw CSV content to a storage system, optionally validating format and headers to ensure consistent data ingestion before downstream processing.", + "limitations": "Does not parse or transform CSV data beyond structure validation; does not support uploading files other than CSV; requires either filePath or fileContent, but not both empty.", + "examples": [ + "Upload a CSV file from disk to cloud storage with validation.", + "Upload raw CSV string content and specify no header row.", + "Upload a semicolon-delimited CSV file while specifying the delimiter." + ] + }, + "tags": [ + "file-operations", + "upload", + "CSV", + "data-ingestion", + "validation" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/local/data/users.csv\",\"targetPath\":\"s3://bucket/data/users.csv\"}", + "description": "Uploads a CSV file located on local disk to an S3 bucket path, using default comma delimiter and header presence with validation." + }, + { + "inputJson": "{\"fileContent\":\"id;name;age\\n1;Alice;30\\n2;Bob;25\",\"targetPath\":\"/upload/users_semicolon.csv\",\"delimiter\":\";\",\"hasHeader\":true}", + "description": "Uploads raw CSV content with semicolon delimiter specifying header presence to a local upload directory." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "CSV", + "context": null + } + }, + { + "name": "file-operations.uploadDocument", + "description": "Uploads a document file to a specified remote storage location. Accepts a file path or file content as input, along with metadata such as target storage location and optional tags. Processes the document by transferring it securely and returns confirmation details including upload status, file URL, and file ID.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local file system path to the document to upload. Should be an absolute or relative path.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileContent", + "type": "string", + "description": "Raw base64-encoded content of the document. Provide alternatively to filePath for direct data upload.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetStorage", + "type": "string", + "description": "The identifier or URL of the remote storage location where the document should be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Optional name to assign to the uploaded document. If omitted and uploading via filePath, the original file name is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of strings for metadata tagging of the uploaded document.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "If true, overwrite an existing document with the same name at the target storage. Otherwise, upload will fail if a conflict exists.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Result object containing upload status, URL of the stored document, a unique document ID, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when needing to upload document files such as PDFs, Word documents, or text files to remote storage systems for backup, sharing, or further processing. It supports input as either local file paths or direct content, with metadata tagging and overwrite options.", + "limitations": "This tool does not perform file format conversions or content validation beyond basic existence checks. It assumes the target storage service is accessible and properly configured for receiving uploads.", + "examples": [ + "Upload a local PDF file to cloud storage with tagging.", + "Upload a base64-encoded Word document content to a secure remote path.", + "Attempt to upload a document and overwrite if it already exists at the destination." + ] + }, + "tags": [ + "upload", + "document", + "file", + "storage", + "file-management", + "file-operations" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"./reports/annual_report.pdf\",\"targetStorage\":\"https://cloudstorage.example.com/docs\",\"tags\":[\"financial\",\"2023\"],\"overwrite\":false}", + "description": "Upload a local PDF document to remote cloud storage with specified tags, without overwriting existing files." + }, + { + "inputJson": "{\"fileContent\":\"JVBERi0xLjQKJcfs...\",\"fileName\":\"summary.docx\",\"targetStorage\":\"s3://company-docs/uploads\",\"overwrite\":true}", + "description": "Upload a base64-encoded Word document content directly to an S3 bucket path, overwriting any existing file named summary.docx." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "notifications.sendMessage", + "description": "Sends a customizable notification message to one or multiple recipients via specified channels like email, SMS, or push notifications. Accepts message content, recipient details, and delivery options, and returns the status of the message delivery to inform success or failure.", + "category": "notifications", + "parameters": [ + { + "name": "messageContent", + "type": "string", + "description": "The main text content of the notification message to send.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientIds", + "type": "array", + "description": "List of recipient identifiers (e.g., email addresses, phone numbers, or user IDs) to whom the message will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "The delivery channel to use for sending the message, such as 'email', 'sms', or 'push'.", + "required": true, + "defaultValue": "email" + }, + { + "name": "subject", + "type": "string", + "description": "Optional subject of the message, typically used for email notifications.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the message: 'low', 'normal', or 'high'. Affects delivery handling if supported.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "scheduledTime", + "type": "string", + "description": "Optional ISO 8601 timestamp specifying when to send the message. If omitted, message is sent immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional custom key-value data to attach with the message for tracking or analytics purposes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the overall status of the send operation, a mapping of recipient IDs to send statuses ('sent', 'failed'), and any error messages encountered." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically deliver notification messages across multiple channels such as email, SMS, or push notifications to users or customers. It supports both immediate and scheduled sends, message prioritization, and tracking metadata for enhanced notification workflows.", + "limitations": "This tool does not handle message templating or content personalization beyond the raw message content provided. It also depends on the external services or infrastructure availability for actual message delivery.", + "examples": [ + "Send an urgent SMS notification to a list of phone numbers right now.", + "Schedule an email message with a subject and metadata to be sent tomorrow morning.", + "Send a push notification message to specific user IDs with normal priority." + ] + }, + "tags": [ + "notifications", + "messaging", + "alerts", + "email", + "sms", + "push", + "schedule", + "priority" + ], + "examples": [ + { + "inputJson": "{\"messageContent\":\"System maintenance will start at midnight.\",\"recipientIds\":[\"user1@example.com\",\"user2@example.com\"],\"channel\":\"email\",\"subject\":\"Maintenance Notice\",\"priority\":\"high\",\"scheduledTime\":\"\"}", + "description": "Send a high priority email notification immediately to two users alerting them of upcoming maintenance." + }, + { + "inputJson": "{\"messageContent\":\"Your verification code is 123456.\",\"recipientIds\":[\"+1234567890\"],\"channel\":\"sms\",\"priority\":\"normal\"}", + "description": "Send a normal priority SMS message containing a verification code to one phone number immediately." + }, + { + "inputJson": "{\"messageContent\":\"You have a new message!\",\"recipientIds\":[\"user_id_1001\"],\"channel\":\"push\",\"priority\":\"low\",\"scheduledTime\":\"2024-07-01T09:00:00Z\",\"metadata\":{\"campaign\":\"welcome\"}}", + "description": "Schedule a low priority push notification with metadata for analytics to be sent to a user at a specified time." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "file-operations.uploadReport", + "description": "Uploads a report file to a specified remote server or cloud storage. Accepts a file path and metadata, handles file validation and transmission, and returns the upload status and accessible URL or error details.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path to the report file to be uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationUrl", + "type": "string", + "description": "Remote URL or endpoint where the report will be uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata information about the report (e.g., title, author, date)", + "required": false, + "defaultValue": "{}" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Flag to allow overwriting an existing report at the destination if it exists", + "required": false, + "defaultValue": "false" + }, + { + "name": "authToken", + "type": "string", + "description": "Authorization token or credentials required for authentication with the destination", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing the upload result status, URL of the uploaded report if successful, and error message if any." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to upload a local report file to a remote server or cloud storage as part of document management, archival, or sharing workflows. It is suitable for automating report submissions and ensuring file availability on specified endpoints.", + "limitations": "This tool does not process or modify the content of the report file beyond validation, and requires correct permissions and network access for uploading. It cannot handle interactive authentication flows or convert file formats.", + "examples": [ + "Upload the latest sales report PDF to the company report server with overwrite allowed.", + "Send a generated report file along with metadata to a cloud storage endpoint using an authentication token.", + "Upload a quarterly financial report to a remote URL without overwriting existing files." + ] + }, + "tags": [ + "file", + "upload", + "report", + "cloud", + "document", + "management", + "storage" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/home/user/reports/Q1_financial_summary.pdf\",\"destinationUrl\":\"https://reports.example.com/upload\",\"metadata\":{\"title\":\"Q1 Financial Summary\",\"author\":\"Jane Doe\",\"date\":\"2024-03-31\"},\"overwrite\":true,\"authToken\":\"abcd1234\"}", + "description": "Upload a local PDF report to a remote company server with metadata and overwrite enabled." + }, + { + "inputJson": "{\"filePath\":\"/tmp/generated_report.docx\",\"destinationUrl\":\"https://cloudstorage.example/api/upload\",\"metadata\":{},\"overwrite\":false,\"authToken\":\"\"}", + "description": "Upload a newly generated report to a cloud storage URL without metadata or authentication token and with no overwrite." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "upload", + "object": "Report", + "context": null + } + }, + { + "name": "notifications.sendComment", + "description": "Sends a comment notification to one or more users via specified channels. Accepts input including comment text, recipient identifiers, optional metadata like related task or post ID, and delivery preferences. Processes input to format and dispatch the notification, returning status and details of delivery for each recipient.", + "category": "notifications", + "parameters": [ + { + "name": "commentText", + "type": "string", + "description": "The text content of the comment to be sent in the notification.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientIds", + "type": "array", + "description": "Array of user IDs to whom the comment notification should be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "relatedEntityId", + "type": "string", + "description": "Optional identifier for the related entity (e.g., task, post) that the comment is about.", + "required": false, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "List of notification channels to send through, e.g., ['email','sms','inApp'].", + "required": false, + "defaultValue": "[\"inApp\"]" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier of the user sending the comment notification, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification, e.g., 'normal' or 'high'.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object with overall status and details per recipient, indicating whether notification was successfully sent and any errors encountered." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to notify users about a new comment on a shared resource or discussion thread. It facilitates notifying multiple recipients through various channels, including in-app or external notifications. Appropriate for collaboration platforms, task management, or social apps.", + "limitations": "This tool does not create or store comments themselves, nor does it manage user preferences; it only sends notifications based on provided inputs. It cannot guarantee delivery beyond the success status returned from the notification channels.", + "examples": [ + "Send a comment notification to the team about a task update via email and in-app.", + "Notify a single user with a high priority comment alert only in-app.", + "Send a comment notification related to a blog post to multiple recipients via default in-app channel." + ] + }, + "tags": [ + "notification", + "comments", + "messaging", + "alerts", + "collaboration", + "multi-channel" + ], + "examples": [ + { + "inputJson": "{\"commentText\":\"Please review the latest update to the project plan.\",\"recipientIds\":[\"user123\",\"user456\"],\"relatedEntityId\":\"task789\",\"channels\":[\"email\",\"inApp\"],\"senderId\":\"user999\",\"priority\":\"normal\"}", + "description": "Send a standard comment notification to two users about a task via email and in-app." + }, + { + "inputJson": "{\"commentText\":\"Urgent: The server is down!\",\"recipientIds\":[\"admin001\"],\"channels\":[\"inApp\"],\"priority\":\"high\"}", + "description": "Send a high priority in-app comment notification to an admin user about an urgent issue." + }, + { + "inputJson": "{\"commentText\":\"New comment on your blog post.\",\"recipientIds\":[\"blogOwner\"],\"relatedEntityId\":\"post12345\"}", + "description": "Send a default in-app comment notification to blog owner about a new comment on their post." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "notifications.sendNotification", + "description": "Sends a notification message to specified recipients via chosen communication channels such as email, SMS, or push notifications. Accepts message content, recipient details, channel preferences, and optional metadata. Returns the send status and message IDs for tracking.", + "category": "notifications", + "parameters": [ + { + "name": "message", + "type": "string", + "description": "The content of the notification message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient identifiers such as email addresses, phone numbers, or user IDs.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "Communication channels to send the notification through, e.g., ['email', 'sms', 'push'].", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the notification, applicable for email or similar channels.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification such as 'low', 'normal', or 'high'.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional key-value pairs to include with the notification for tracking or contextual purposes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing success status, array of messageIds for sent notifications, and optionally error details if any failures occurred." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send alerts or messages to users or systems across multiple channels. Ideal for notifying users of important events, reminders, or updates in a flexible, multi-channel manner.", + "limitations": "This tool does not handle message content generation or formatting beyond accepting raw strings. Delivery depends on external channel integrations that may not guarantee instant or assured receipt.", + "examples": [ + "Send an email notification to a user about a scheduled maintenance.", + "Notify a user via SMS and push notification about a critical alert.", + "Send a low priority update message to multiple users via email." + ] + }, + "tags": [ + "notifications", + "alerts", + "communication", + "multi-channel", + "messaging", + "email", + "sms", + "push" + ], + "examples": [ + { + "inputJson": "{\"message\":\"Your appointment is confirmed for April 24 at 3 PM.\",\"recipients\":[\"user1@example.com\"],\"channels\":[\"email\"],\"subject\":\"Appointment Confirmation\",\"priority\":\"normal\"}", + "description": "Send an email notification confirming an appointment to a single recipient." + }, + { + "inputJson": "{\"message\":\"Server CPU usage has exceeded 90%.\",\"recipients\":[\"+1234567890\",\"user2@example.com\"],\"channels\":[\"sms\",\"email\"],\"priority\":\"high\"}", + "description": "Send a high priority alert via SMS and email to two recipients about server load." + }, + { + "inputJson": "{\"message\":\"Weekly newsletter is available.\",\"recipients\":[\"user3@example.com\"],\"channels\":[\"email\"],\"subject\":\"Weekly Newsletter\",\"priority\":\"low\"}", + "description": "Send a low priority weekly newsletter to a user via email." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "notifications.sendReply", + "description": "Sends a reply message to an existing notification thread or message, accepting input such as the recipient's contact details, message content, and optional attachment or metadata. It processes these inputs to deliver a reply notification and returns a status indicating success or failure along with any error messages.", + "category": "notifications", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Identifier of the existing notification thread or message to reply to.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientId", + "type": "string", + "description": "Identifier or address of the intended recipient of the reply message.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "Text content of the reply message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachments (e.g., file URLs or base64 strings) to include with the reply.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata such as message priority, tags, or custom headers relevant to the reply.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "readReceiptRequested", + "type": "boolean", + "description": "Whether to request a read receipt from the recipient.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object describing the result of sending the reply, including success status, message ID, timestamp, and any error details." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to respond to an existing notification, such as replying to a customer support message, acknowledging alerts, or continuing a conversational thread in a notification system. It allows automated or assisted communication within existing message contexts.", + "limitations": "This tool cannot compose original notifications or initiate new notification threads; it requires a valid existing thread or message identifier. It also does not handle scheduling delayed replies or rich media composition beyond simple attachments.", + "examples": [ + "Send a reply message to a user's query in a support ticket notification.", + "Automatically acknowledge receipt of an alert message with a confirmation reply.", + "Respond to a notification thread providing additional requested information." + ] + }, + "tags": [ + "notifications", + "messaging", + "reply", + "communication", + "alerts", + "automation" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"thread_12345\",\"recipientId\":\"user_67890\",\"messageContent\":\"Thank you for your message. We have escalated your request to our support team.\",\"attachments\":[],\"metadata\":{\"priority\":\"high\"},\"readReceiptRequested\":true}", + "description": "Reply to a user's support message in an existing notification thread, with priority marked and read receipt requested." + }, + { + "inputJson": "{\"threadId\":\"alert_98765\",\"recipientId\":\"admin_001\",\"messageContent\":\"Alert acknowledged. Our team is investigating the issue.\",\"attachments\":[],\"metadata\":{},\"readReceiptRequested\":false}", + "description": "Send an acknowledgment reply to an alert notification for an administrative user." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "notifications.sendMention", + "description": "Sends a mention notification to a user within a communication platform or system. Accepts the recipient's username or user ID, the content of the mention, context identifiers like channel or message ID, and optionally a mention type to tailor the notification format. Returns a status object indicating success or failure and a timestamp of delivery.", + "category": "notifications", + "parameters": [ + { + "name": "recipientId", + "type": "string", + "description": "The unique identifier or username of the user to mention (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The content of the mention or message that includes the user mention (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "channelId", + "type": "string", + "description": "Optional identifier of the channel or conversation where the mention occurs", + "required": false, + "defaultValue": "" + }, + { + "name": "contextMessageId", + "type": "string", + "description": "Optional identifier of the message that triggered the mention, if replying or referencing", + "required": false, + "defaultValue": "" + }, + { + "name": "mentionType", + "type": "string", + "description": "Optional type of mention to define notification style, e.g., 'direct', 'reply', or 'general'", + "required": false, + "defaultValue": "direct" + } + ], + "returns": { + "type": "object", + "description": "Contains success boolean, delivery timestamp ISO string, and optional error message if failed" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to alert or notify a specific user by tagging or mentioning them within a messaging or collaboration platform. This is useful to bring attention to a message, comment, or update directly relevant to that user in teams, chat rooms, or ticketing systems.", + "limitations": "Cannot ensure user presence or that the mention was seen; depends on platform capabilities. Does not support bulk mentions or mentions outside the integrated platform.", + "examples": [ + "Send a mention to user 'jsmith' with a message about upcoming deadline.", + "Mention a user in channel 'dev-updates' referencing a specific message ID.", + "Send a general mention without contextual message ID." + ] + }, + "tags": [ + "notifications", + "messaging", + "mentions", + "alerts", + "communication" + ], + "examples": [ + { + "inputJson": "{\"recipientId\":\"jsmith\",\"message\":\"Hey @jsmith, please review the updated specs.\",\"channelId\":\"dev-chat\",\"mentionType\":\"direct\"}", + "description": "Send a direct mention to user 'jsmith' in the 'dev-chat' channel with a call to action." + }, + { + "inputJson": "{\"recipientId\":\"alex\",\"message\":\"@alex replied to your comment.\",\"channelId\":\"project-discussion\",\"contextMessageId\":\"msg7890\",\"mentionType\":\"reply\"}", + "description": "Notify user 'alex' that their reply is posted referencing a specific message." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "notifications.sendChannel", + "description": "Sends a notification message through a specified communication channel such as email, SMS, or push notification. Accepts the target channel type, recipient details, message content, and optional metadata. Processes the inputs to deliver the message and returns the delivery status and message ID if successful.", + "category": "notifications", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "The communication channel to send the notification through (e.g., 'email', 'sms', 'push').", + "required": true, + "defaultValue": "" + }, + { + "name": "recipient", + "type": "string", + "description": "Identifier for the recipient depending on the channel (email address, phone number, or device token).", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The notification message content to be sent to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Optional subject line for the notification, useful for email channels.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional data such as priority level or custom tags to include with the notification.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the send action, unique message ID when available, and an error message if the send failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to notify a user or system via common communication channels with customizable message content and recipients. It allows dynamically choosing the channel and tailoring messages accordingly, supporting operational alerts, user notifications, and event triggers across multiple platforms.", + "limitations": "This tool does not handle message formatting beyond plain text or validate recipient contact formats beyond basic checks. It cannot guarantee delivery due to external factors such as provider outages or invalid recipient info. It does not store messages or support complex templating or batch sending inherently.", + "examples": [ + "Send an email notification to a user with a subject and message.", + "Send an SMS notification to a phone number with a short text message.", + "Send a push notification to a device token with a critical alert message." + ] + }, + "tags": [ + "notifications", + "send", + "communication", + "email", + "sms", + "push", + "alerts" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"recipient\":\"user@example.com\",\"subject\":\"Account Alert\",\"message\":\"Your account password was changed successfully.\",\"metadata\":{\"priority\":\"high\"}}", + "description": "Sending a high-priority email notification to inform the user about a password change." + }, + { + "inputJson": "{\"channelType\":\"sms\",\"recipient\":\"+1234567890\",\"message\":\"Your verification code is 123456.\",\"metadata\":{}}", + "description": "Sending a SMS with a verification code to a user's phone number." + }, + { + "inputJson": "{\"channelType\":\"push\",\"recipient\":\"deviceToken_abc123\",\"message\":\"You have a new message in your inbox.\",\"metadata\":{\"category\":\"messages\"}}", + "description": "Sending a push notification about a new inbox message to a specific device token." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "notifications.sendAlert", + "description": "Sends a security alert notification to specified recipients via different channels like email, SMS, or push notifications. Accepts alert details including severity, message, and recipients, processes them by formatting the alert, and returns the sending status and message ID if applicable.", + "category": "notifications", + "parameters": [ + { + "name": "alertTitle", + "type": "string", + "description": "The title or subject of the security alert to send.", + "required": true, + "defaultValue": "" + }, + { + "name": "alertMessage", + "type": "string", + "description": "Detailed message content describing the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Severity of the alert (e.g., low, medium, high, critical) that can determine notification priority.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "Array of recipient identifiers such as email addresses or phone numbers.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "Notification delivery channels (e.g., email, sms, push) to use for sending the alert.", + "required": true, + "defaultValue": "[\"email\"]" + }, + { + "name": "sendAt", + "type": "string", + "description": "Optional ISO 8601 date-time string indicating scheduled time to send the alert. Immediate if omitted.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing success status, optional message ID, and error information if sending fails." + }, + "aiAgent": { + "useCase": "Use this tool to send timely security alerts or notifications to users or administrators when suspicious or critical events occur, ensuring appropriate recipients are informed via preferred communication channels.", + "limitations": "This tool does not generate alerts from raw data; it only sends pre-formed alert messages. It also does not store alert history or provide analytics on delivery performance.", + "examples": [ + "Send a critical alert about a detected intrusion to security team emails and SMS.", + "Notify admins about a medium severity vulnerability discovered in the system via email only.", + "Schedule a low severity informational alert to be sent tomorrow morning to system operators via push notification." + ] + }, + "tags": [ + "notifications", + "security", + "alerts", + "email", + "sms", + "push", + "reminders", + "critical" + ], + "examples": [ + { + "inputJson": "{\"alertTitle\":\"Intrusion Detected\",\"alertMessage\":\"Multiple failed login attempts detected from IP 192.168.1.22\",\"severityLevel\":\"critical\",\"recipients\":[\"secops@example.com\",\"+15551234567\"],\"channels\":[\"email\",\"sms\"]}", + "description": "Send a critical security alert about intrusion to email and SMS recipients." + }, + { + "inputJson": "{\"alertTitle\":\"Vulnerability Update\",\"alertMessage\":\"A medium severity vulnerability was identified in server X.\",\"severityLevel\":\"medium\",\"recipients\":[\"admin@example.com\"],\"channels\":[\"email\"]}", + "description": "Notify system admins about a medium severity vulnerability via email only." + }, + { + "inputJson": "{\"alertTitle\":\"Daily Security Reminder\",\"alertMessage\":\"Remember to update your passwords regularly.\",\"severityLevel\":\"low\",\"recipients\":[\"ops@example.com\"],\"channels\":[\"push\"],\"sendAt\":\"2024-06-30T08:00:00Z\"}", + "description": "Schedule a low severity daily reminder for operations team via push notification." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "notifications.sendThread", + "description": "Sends a notification message to a communication thread such as a chat room or discussion channel. Accepts thread identifier, message content, optional sender info, and delivery preferences; processes and posts the message to the designated thread; returns status and metadata of the sent notification.", + "category": "notifications", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Unique identifier of the thread or channel to send the notification to.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "Content of the notification message to be sent to the thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "senderName", + "type": "string", + "description": "Name or identifier of the message sender (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "urgent", + "type": "boolean", + "description": "Flag indicating if the notification should be marked as urgent, possibly triggering special handling.", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "List of URLs or references to attachments to include with the notification message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "silent", + "type": "boolean", + "description": "If true, sends the notification without alert sounds or banners.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Result object containing success status, message ID, timestamp of sending, and optional error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to post updates, alerts, or messages directly into a communication thread or chat channel as notifications. It supports urgent flags and attachments to customize the notification's impact and content. Useful for team alerts, system warnings, or discussion starters.", + "limitations": "This tool does not support reading or fetching messages from threads, only sending. It cannot guarantee delivery beyond acknowledging sent status and does not handle user-specific notification preferences.", + "examples": [ + "Send an urgent alert to the dev team chat.", + "Post a daily summary message with report attachment.", + "Send a silent notification about system maintenance to ops channel." + ] + }, + "tags": [ + "notifications", + "communication", + "thread", + "messaging", + "alert", + "chat" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"dev-team-123\",\"message\":\"Urgent: The server will undergo maintenance at 10 PM.\",\"senderName\":\"System Alert\",\"urgent\":true}", + "description": "Send an urgent maintenance alert to the development team thread." + }, + { + "inputJson": "{\"threadId\":\"marketing-xyz\",\"message\":\"Here is the campaign report for last week.\",\"attachments\":[\"https://example.com/reports/week42.pdf\"],\"senderName\":\"MarketingBot\"}", + "description": "Post a message with a report attachment to the marketing team thread." + }, + { + "inputJson": "{\"threadId\":\"ops-channel\",\"message\":\"Scheduled downtime tomorrow.\",\"silent\":true}", + "description": "Send a silent notification about scheduled downtime to operations channel." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "notifications.sendEmail", + "description": "Sends an email notification to one or multiple recipients. Accepts parameters like recipient addresses, subject line, email body content (plaintext or HTML), optional CC and BCC lists, and attachments. Processes the inputs to format the email properly, sends it via an SMTP or configured email service, and returns a success status along with a message ID or error details.", + "category": "notifications", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "Array of recipient email addresses to send the email to.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Content of the email message; can be plaintext or HTML formatted string.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional array of email addresses to be CC'd in the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional array of email addresses to be BCC'd in the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Flag indicating whether the body content is in HTML format (true) or plaintext (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachments, each with filename and base64 encoded content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "from", + "type": "string", + "description": "Optional sender email address; defaults to system-configured sender if not provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing a success boolean, a message ID if sent successfully, or error details if failed." + }, + "aiAgent": { + "useCase": "This tool should be used when the AI agent needs to send an email notification, alert, or message to specified recipients with customizable subject, body, and optional attachments. Ideal for transactional emails, alerts, updates, or notifications that require structured email delivery.", + "limitations": "This tool does not manage recipient verification or email content validation beyond formatting. It also cannot customize SMTP server settings beyond what's preconfigured, nor does it handle email inbox management or replies.", + "examples": [ + "Send a notification email to a user confirming their account signup.", + "Send a daily report email with an attached PDF to multiple stakeholders via CC.", + "Send an HTML formatted promotional email to a subscriber list with optional BCC." + ] + }, + "tags": [ + "notifications", + "email", + "communication", + "alerts", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Welcome to Our Service\",\"body\":\"Thank you for signing up!\",\"isHtml\":false}", + "description": "Send a simple plaintext welcome email to a single recipient." + }, + { + "inputJson": "{\"to\":[\"team@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Weekly Status Report\",\"body\":\" User Admin Report
See attached.
\",\"isHtml\":true,\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"JVBERi0xLjcKJ...base64encodedpdf==\"}]}", + "description": "Send an HTML email with an attachment and CC to a team mailing list." + }, + { + "inputJson": "{\"to\":[\"customer1@example.com\",\"customer2@example.com\"],\"bcc\":[\"audit@example.com\"],\"subject\":\"Service Update\",\"body\":\"The service will be down for maintenance tonight.\",\"isHtml\":false}", + "description": "Send a plaintext notification email to multiple recipients with a BCC for audit purposes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "messaging.sendReply", + "description": "Sends a reply message within an existing chat or conversation thread. Accepts the conversation or message ID, the reply content, and optional metadata like attachments or mentions. Processes the input by posting the reply in context and returns the status and sent message details.", + "category": "messaging", + "parameters": [ + { + "name": "conversationId", + "type": "string", + "description": "ID of the conversation or thread to which the reply is sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "replyToMessageId", + "type": "string", + "description": "ID of the specific message being replied to within the conversation.", + "required": false, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "Text content of the reply message to send.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachment objects (e.g., files, images) to include in the reply.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mentions", + "type": "array", + "description": "Optional list of user IDs to mention directly in the reply message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "sendAsHtml", + "type": "boolean", + "description": "Flag indicating if messageContent includes HTML formatting to render.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the status of the send operation, the ID of the newly created reply message, timestamp, and any error details if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send a reply message in an ongoing chat or messaging conversation, for example to answer user queries, continue discussions, or provide context-specific responses within a thread.", + "limitations": "This tool cannot initiate new conversations or send messages outside of an existing conversation context. It also does not handle message editing or deletion.", + "examples": [ + "Send a reply to a user's question within a support chat thread.", + "Reply to a specific message with an attached image in a group chat.", + "Mention specific users in a reply message to notify them in the conversation." + ] + }, + "tags": [ + "messaging", + "reply", + "chat", + "conversation", + "real-time", + "communication", + "integration" + ], + "examples": [ + { + "inputJson": "{\"conversationId\":\"conv12345\",\"replyToMessageId\":\"msg67890\",\"messageContent\":\"Thank you for your message! We'll look into it.\",\"attachments\":[],\"mentions\":[],\"sendAsHtml\":false}", + "description": "Replying with a simple text thank-you message to a specific message in a conversation." + }, + { + "inputJson": "{\"conversationId\":\"groupchat567\",\"messageContent\":\"Here's the report you asked for.\",\"attachments\":[{\"type\":\"file\",\"url\":\"https://fileserver.com/report.pdf\",\"fileName\":\"report.pdf\"}],\"mentions\":[\"user789\"],\"sendAsHtml\":false}", + "description": "Sending a reply in a group chat that includes a file attachment and mentions a user." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "messaging.sendThread", + "description": "Sends a complete thread of messages to a specified chat or messaging channel. Accepts a thread ID or array of message objects with sender, content, and timestamps; posts the entire conversation context to the target destination, enabling bulk or replayed message delivery. Returns confirmation of successful delivery and message IDs.", + "category": "messaging", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Unique identifier of the thread to send; if provided, messages are fetched automatically.", + "required": false, + "defaultValue": "" + }, + { + "name": "messages", + "type": "array", + "description": "Array of message objects to send as a thread; overrides threadId if provided. Each message includes sender, content, and timestamp.", + "required": false, + "defaultValue": "" + }, + { + "name": "destinationChannelId", + "type": "string", + "description": "Identifier of the channel or chat to which the thread will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "preserveTimestamps", + "type": "boolean", + "description": "Whether to preserve original message timestamps in the sent thread (true) or use current sending time (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "notifyUsers", + "type": "boolean", + "description": "If true, users involved in the thread will receive notifications for the newly sent messages.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a status string indicating success or failure, the destination channel ID, and an array of sent message IDs confirming delivery." + }, + "aiAgent": { + "useCase": "Use this tool when needing to send or replicate an entire conversation thread from one channel or thread to another, such as migrating conversations, reposting historic chat context, or bulk message sending with context intact. It handles multiple messages atomically, preserving order and optionally timestamps.", + "limitations": "Cannot fetch messages from threads without valid threadId or messages array; message format must be valid. Does not perform message content moderation or transformations. Delivery depends on destination channel permissions and availability.", + "examples": [ + "Send an archived chat thread to a new project channel for team onboarding.", + "Replay a discussion from a support ticket thread to an escalation channel.", + "Bulk-send messages from exported chat logs to recreate conversation in backup system." + ] + }, + "tags": [ + "messaging", + "thread", + "send", + "chat", + "conversation", + "bulk-send" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"thread-12345\",\"destinationChannelId\":\"channel-6789\",\"preserveTimestamps\":true,\"notifyUsers\":false}", + "description": "Send an existing thread identified by thread-12345 to channel-6789, preserving original timestamps and disabling user notifications." + }, + { + "inputJson": "{\"messages\":[{\"sender\":\"user1\",\"content\":\"Hello team!\",\"timestamp\":1685967600000},{\"sender\":\"user2\",\"content\":\"Hi! How can I help?\",\"timestamp\":1685967660000}],\"destinationChannelId\":\"channel-9876\",\"preserveTimestamps\":false,\"notifyUsers\":true}", + "description": "Send a custom array of messages as a thread to channel-9876, using current timestamp and notifying users." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "messaging.sendComment", + "description": "Sends a text comment to a specified channel or thread within a real-time messaging system. Accepts inputs including the message content, target channel or thread ID, and optional metadata like user identity or reply references. Processes formatting and delivers the comment to the messaging backend, returning a confirmation of delivery and the unique comment ID.", + "category": "messaging", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The text content of the comment to send. Supports plain text and basic formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "channelId", + "type": "string", + "description": "Identifier of the channel or conversation where the comment should be posted.", + "required": true, + "defaultValue": "" + }, + { + "name": "threadId", + "type": "string", + "description": "Optional identifier of the parent thread to reply within a thread context.", + "required": false, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Identifier representing the user sending the comment, for authentication or attribution.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of file or media attachments metadata to include with the comment.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mentionUserIds", + "type": "array", + "description": "Optional array of user IDs to mention/highlight in the comment text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "formatting", + "type": "string", + "description": "Optional formatting style or markup language for the comment (e.g., markdown, HTML).", + "required": false, + "defaultValue": "markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing details of the sent comment, including unique comment ID, timestamp, and status confirmation." + }, + "aiAgent": { + "useCase": "Use this tool whenever your goal is to post a new comment or message in a real-time chat or messaging platform, especially to notify others, continue a conversation thread, or log communication. It handles both new channel messages and threaded replies with optional mentions or attachments.", + "limitations": "This tool does not handle editing or deleting comments after sending, nor does it guarantee delivery beyond confirmation from the messaging backend. It cannot translate or generate comment content automatically.", + "examples": [ + "Send a new comment to channel 'general' with a greeting message.", + "Reply to a specific thread in a project channel with feedback.", + "Post a comment including mentions and an image attachment in a team chat." + ] + }, + "tags": [ + "messaging", + "send", + "comment", + "chat", + "real-time", + "thread", + "mention" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Hello team, please review the latest update.\",\"channelId\":\"general\",\"userId\":\"user_123\"}", + "description": "Send a simple comment with a greeting to the 'general' channel." + }, + { + "inputJson": "{\"content\":\"I agree with the above point.\",\"channelId\":\"project-x\",\"threadId\":\"thread789\",\"userId\":\"user_456\"}", + "description": "Reply within a specific thread in the 'project-x' channel." + }, + { + "inputJson": "{\"content\":\"FYI @john_doe, here's the report.\",\"channelId\":\"team-chat\",\"mentionUserIds\":[\"john_doe\"],\"attachments\":[{\"type\":\"image\",\"url\":\"http://example.com/report.png\"}],\"userId\":\"user_789\"}", + "description": "Send a comment mentioning a user and attaching an image in a team chat." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "messaging.sendChannel", + "description": "Sends a text message to a specified messaging channel in a chat or collaboration platform. It accepts channel ID or name, message content, optional attachments or mentions, then posts the message via the platform's API. Returns confirmation status with message ID and timestamp.", + "category": "messaging", + "parameters": [ + { + "name": "channelId", + "type": "string", + "description": "Unique identifier of the target channel to send the message to.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageText", + "type": "string", + "description": "The text content of the message to send to the channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects such as images, files, or rich media to include with the message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mentions", + "type": "array", + "description": "Optional array of user IDs or usernames to mention in the message for notifications.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "priority", + "type": "string", + "description": "Optional priority level of the message, e.g., 'normal', 'high'; influences notification behavior if supported.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "The result object containing status of sending, message unique identifier, channel, and timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to post information, alerts, or responses into a team or public chat channel for communication or notification purposes.", + "limitations": "Does not support editing or deleting messages once sent; message formatting is limited to supported platform features; cannot send to private channels without proper permissions.", + "examples": [ + "Send a status update message to the project channel.", + "Notify a team channel of an important alert with user mentions.", + "Post a daily report with an attachment to a specific chat channel." + ] + }, + "tags": [ + "messaging", + "send", + "channel", + "chat", + "communication", + "notification", + "integration" + ], + "examples": [ + { + "inputJson": "{\"channelId\":\"proj-team-123\",\"messageText\":\"Deployment completed successfully.\",\"attachments\":[],\"mentions\":[]}", + "description": "Send a simple text message notifying deployment success to project team channel." + }, + { + "inputJson": "{\"channelId\":\"alerts-001\",\"messageText\":\"Urgent: Server CPU usage over 90%!\",\"attachments\":[],\"mentions\":[\"adminUser1\",\"devOpsLead\"]}", + "description": "Send an urgent alert message mentioning admins in the alerts channel." + }, + { + "inputJson": "{\"channelId\":\"reports-2024\",\"messageText\":\"Here is the weekly usage report.\",\"attachments\":[{\"type\":\"file\",\"url\":\"https://fileserver.com/report.pdf\",\"filename\":\"usage_report.pdf\"}],\"mentions\":[]}", + "description": "Send a weekly report with a PDF attachment to the reports channel." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "messaging.sendMention", + "description": "Sends a mention notification in a real-time messaging channel or conversation by tagging one or more users in a message. Accepts channel or conversation ID, user identifiers to mention, and message content, then posts the composed message with mentions. Returns message ID and status confirmation.", + "category": "messaging", + "parameters": [ + { + "name": "channelId", + "type": "string", + "description": "The unique identifier of the messaging channel or conversation where the mention will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "userIds", + "type": "array", + "description": "Array of user identifiers to mention/tag in the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageText", + "type": "string", + "description": "The content of the message to send, which will include mentions of specified users.", + "required": true, + "defaultValue": "" + }, + { + "name": "silent", + "type": "boolean", + "description": "If true, sends the mention message without triggering notification sounds for mentioned users.", + "required": false, + "defaultValue": "false" + }, + { + "name": "threadId", + "type": "string", + "description": "Optional thread or parent message ID to send this mention as a reply within a thread.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique identifier of the sent message and a status indicating success or failure." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to notify or draw specific users' attention within a messaging platform by directly mentioning them, ensuring the message is received in context. Useful for collaborative environments, task updates, or alerting team members in chats.", + "limitations": "This tool cannot create channels or retrieve user IDs; it only sends mentions in existing channels. It can't guarantee message delivery if users have notification settings that suppress mentions.", + "examples": [ + "Mention user(s) in a project update channel to alert about a new task assignment.", + "Send a mention within a thread to request clarification from a specific user.", + "Notify multiple team members in a general chat by sending a message tagging them all." + ] + }, + "tags": [ + "messaging", + "mention", + "notification", + "real-time", + "chat", + "collaboration", + "tagging" + ], + "examples": [ + { + "inputJson": "{\"channelId\":\"channel_12345\",\"userIds\":[\"user_6789\"],\"messageText\":\"@user_6789 Please review the latest design doc.\"}", + "description": "Mention a single user in the general project discussion channel to request document review." + }, + { + "inputJson": "{\"channelId\":\"team_chat_987\",\"userIds\":[\"user_123\",\"user_456\"],\"messageText\":\"@user_123 @user_456 Please confirm your availability for the meeting.\",\"silent\":true}", + "description": "Send a silent mention to two team members asking about meeting availability in the team chat." + }, + { + "inputJson": "{\"channelId\":\"support_channel\",\"userIds\":[\"agent007\"],\"messageText\":\"@agent007 Can you please check the status of ticket #54321?\",\"threadId\":\"msg_7890\"}", + "description": "Mention a specific support agent in a reply within a support ticket thread to check ticket status." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "email-communication.sendReply", + "description": "Sends a reply email to a specified original message. Accepts the original email ID or message reference, the reply content, optional subject override, attachments, and options for CC/BCC. Processes formatting and sends the reply maintaining email threading. Returns status and message ID of the sent reply.", + "category": "email-communication", + "parameters": [ + { + "name": "originalMessageId", + "type": "string", + "description": "The unique identifier of the original email message to which this is a reply.", + "required": true, + "defaultValue": "" + }, + { + "name": "replyContent", + "type": "string", + "description": "The body content of the reply email, supports plain text or HTML markup.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Optional override for the email subject of the reply. If empty, original subject with 'Re:' prefix is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "ccRecipients", + "type": "array", + "description": "Optional array of email addresses to CC on the reply.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccRecipients", + "type": "array", + "description": "Optional array of email addresses to BCC on the reply.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachments to include in the reply email, each with filename and base64 content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Flag indicating if the replyContent is formatted as HTML (true) or plain text (false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the send operation, message ID of the sent reply, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send a contextual reply to an existing email thread, preserving original conversation context and formatting. Suitable for automating customer support replies, user notifications, or assistant responses to received emails.", + "limitations": "Cannot compose an initial email unrelated to a previous message. Does not handle complex template rendering beyond supplied replyContent. Attachment size limits and recipient validation must be managed externally.", + "examples": [ + "Reply to a customer support email confirming issue resolution.", + "Send a quick follow-up answer to a meeting scheduling email.", + "Include an attachment in a reply email to a project discussion." + ] + }, + "tags": [ + "email", + "reply", + "communication", + "automation", + "customer-support", + "threading" + ], + "examples": [ + { + "inputJson": "{\n \"originalMessageId\": \"abc123xyz\",\n \"replyContent\": \"Thank you for your message. We have resolved the issue you reported.\",\n \"subject\": \"\",\n \"ccRecipients\": [],\n \"bccRecipients\": [],\n \"attachments\": [],\n \"isHtml\": false\n}", + "description": "Send a plain text reply confirming issue resolution without changing subject or adding recipients." + }, + { + "inputJson": "{\n \"originalMessageId\": \"msg789\",\n \"replyContent\": \"Please find the attached report as requested.
\",\n \"subject\": \"Project Report Attached\",\n \"ccRecipients\": [\"manager@example.com\"],\n \"bccRecipients\": [],\n \"attachments\": [{\"filename\": \"report.pdf\", \"contentBase64\": \"JVBERi0xLjQKJ...\"}],\n \"isHtml\": true\n}", + "description": "Send an HTML reply with an attachment and custom subject, CC'ing the manager." + }, + { + "inputJson": "{\n \"originalMessageId\": \"email001\",\n \"replyContent\": \"Looking forward to our meeting next week.\",\n \"subject\": \"\",\n \"ccRecipients\": [],\n \"bccRecipients\": [\"hr@example.com\"],\n \"attachments\": [],\n \"isHtml\": false\n}", + "description": "Send a plain text reply with a BCC recipient and default reply subject." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "messaging.sendMessage", + "description": "Sends a real-time message to a specified chat channel or user. Accepts inputs like recipient ID, message content, and optional metadata such as attachments or priority flags. Processes the inputs to deliver the message via the messaging platform and returns a message status with delivery details.", + "category": "messaging", + "parameters": [ + { + "name": "recipientId", + "type": "string", + "description": "The unique identifier of the target user or channel to send the message to.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageText", + "type": "string", + "description": "The text content of the message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects containing URLs or base64 encoded content to include with the message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isUrgent", + "type": "boolean", + "description": "Flag indicating if the message should be marked as urgent or high priority.", + "required": false, + "defaultValue": "false" + }, + { + "name": "formatting", + "type": "string", + "description": "Optional parameter indicating the message formatting style like markdown or plain text.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "sendAsUserId", + "type": "string", + "description": "Optional user ID to send the message on behalf of; if not set, sends as system or bot user.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing message delivery status information including success flag, message ID, timestamp, and an error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically send messages in real time to specific users or channels within a chat or messaging platform, such as notifications, alerts, or chat responses. It supports both text and attachments, as well as urgency marking, allowing for versatile messaging scenarios.", + "limitations": "This tool does not handle message retrieval, editing, or deletion. It also does not manage user presence or multi-channel broadcasting beyond individual recipient IDs.", + "examples": [ + "Send a welcome message to a new user with optional attachments.", + "Notify a support agent with an urgent alert message.", + "Post a formatted markdown announcement to a group chat." + ] + }, + "tags": [ + "messaging", + "real-time", + "send", + "chat", + "notification", + "text", + "attachments" + ], + "examples": [ + { + "inputJson": "{\"recipientId\":\"user_12345\",\"messageText\":\"Hello! Your appointment is confirmed for tomorrow at 10 AM.\",\"attachments\":[],\"isUrgent\":false,\"formatting\":\"plain\",\"sendAsUserId\":\"\"}", + "description": "Send a simple appointment confirmation message to a user." + }, + { + "inputJson": "{\"recipientId\":\"channel_support\",\"messageText\":\"**Urgent:** Server outage detected. Immediate action required.\",\"attachments\":[],\"isUrgent\":true,\"formatting\":\"markdown\",\"sendAsUserId\":\"bot_system\"}", + "description": "Send an urgent markdown-formatted alert to support channel from system bot." + }, + { + "inputJson": "{\"recipientId\":\"user_67890\",\"messageText\":\"Here's the report you requested.\",\"attachments\":[{\"type\":\"pdf\",\"url\":\"https://example.com/report.pdf\"}],\"isUrgent\":false,\"formatting\":\"plain\",\"sendAsUserId\":\"user_manager\"}", + "description": "Send a plain text message with a PDF report attachment on behalf of a manager." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "messaging.sendNotification", + "description": "Sends a real-time notification message to one or more users or devices. Accepts parameters such as recipient IDs, message content, notification type, and optional metadata for context or display customization. Returns a status indicating success or failure for each recipient along with any error messages.", + "category": "messaging", + "parameters": [ + { + "name": "recipientIds", + "type": "array", + "description": "Array of recipient user or device IDs to send the notification to.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "The title or headline of the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The main content or body of the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "notificationType", + "type": "string", + "description": "The category or type of notification (e.g., 'info', 'warning', 'alert').", + "required": false, + "defaultValue": "info" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification ('low', 'normal', 'high').", + "required": false, + "defaultValue": "normal" + }, + { + "name": "silent", + "type": "boolean", + "description": "If true, sends the notification silently without sound or vibration.", + "required": false, + "defaultValue": "false" + }, + { + "name": "dataPayload", + "type": "object", + "description": "Additional key-value pairs to include in the notification for handling on client side.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the success status and error info for each recipient." + }, + "aiAgent": { + "useCase": "Use this tool when you need to deliver timely alerts, messages, or updates directly to users' devices or sessions, such as app notifications, system alerts, or chat updates. It is ideal when you know recipient identifiers and want to customize notification appearance or behavior.", + "limitations": "Does not handle scheduling future notifications or batch queuing. Does not support rich media attachments (images, sounds). Relies on existing recipient IDs and available messaging infrastructure.", + "examples": [ + "Send a high priority alert to multiple users about system downtime.", + "Send a silent update notification with additional data to one device.", + "Notify users about a new chat message with customized title and message content." + ] + }, + "tags": [ + "messaging", + "notification", + "real-time", + "alert", + "push" + ], + "examples": [ + { + "inputJson": "{\"recipientIds\":[\"user123\",\"user456\"],\"title\":\"System Maintenance\",\"message\":\"Scheduled maintenance at midnight.\",\"notificationType\":\"alert\",\"priority\":\"high\"}", + "description": "Send a high priority alert notification to multiple users about maintenance." + }, + { + "inputJson": "{\"recipientIds\":[\"device789\"],\"title\":\"Background Sync\",\"message\":\"Your data has been synced.\",\"silent\":true}", + "description": "Send a silent notification to a device confirming background data sync." + }, + { + "inputJson": "{\"recipientIds\":[\"user321\"],\"title\":\"New Message\",\"message\":\"You have a new chat message from Alice.\",\"dataPayload\":{\"chatId\":\"chat987\"}}", + "description": "Notify a user about a new chat message including chat context data." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "messaging.sendAlert", + "description": "Sends a security alert message to specified users or channels in a messaging platform. Accepts alert content, severity levels, target recipients, and optional metadata. Processes the input to format the alert and delivers a confirmation response on success or failure.", + "category": "messaging", + "parameters": [ + { + "name": "alertTitle", + "type": "string", + "description": "Title or headline of the alert message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "alertMessage", + "type": "string", + "description": "Detailed text content of the security alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Severity classification of the alert such as 'info', 'warning', 'critical'.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "Array of user IDs, usernames, or channel identifiers who will receive the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "channelType", + "type": "string", + "description": "Type of channel for delivery such as 'direct', 'group', or 'broadcast'.", + "required": false, + "defaultValue": "direct" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional key-value pairs providing context or tags for the alert.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing status of the alert sending process including success flag, message ID if successful, and error details if failed." + }, + "aiAgent": { + "useCase": "Use this tool when a security issue or important system event needs to be communicated promptly to specific users or groups in a messaging environment. Suitable for real-time alerting of incidents, warnings, or operational notifications requiring immediate attention.", + "limitations": "This tool does not analyze or generate alert content. It assumes alert content and recipient identifiers are valid and properly formatted. It cannot escalate or route alerts beyond the provided recipients.", + "examples": [ + "Send a critical security breach alert to the security team channels.", + "Notify direct users about a scheduled maintenance alert at warning level.", + "Broadcast an informational alert about system health to all users." + ] + }, + "tags": [ + "messaging", + "security", + "alert", + "notification", + "real-time", + "incident-management", + "chat" + ], + "examples": [ + { + "inputJson": "{\"alertTitle\":\"Unauthorized Access Detected\",\"alertMessage\":\"Multiple failed login attempts detected from IP 192.168.1.100.\",\"severityLevel\":\"critical\",\"recipients\":[\"security_team\", \"admin_group\"],\"channelType\":\"group\"}", + "description": "Send a critical alert about unauthorized access attempts to security team and admins in a group channel." + }, + { + "inputJson": "{\"alertTitle\":\"Scheduled Maintenance\",\"alertMessage\":\"System patching will occur tonight at 11 PM.\",\"severityLevel\":\"info\",\"recipients\":[\"user123\"],\"channelType\":\"direct\"}", + "description": "Send an informational alert to one user about upcoming maintenance in a direct message." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "messaging.sendEmail", + "description": "Sends an email message to one or multiple recipients accepting inputs such as recipient addresses, subject, message body (plain text or HTML), and optional attachments. It processes the inputs by formatting the email and using an SMTP or email service to send the message, returning a confirmation with message ID and status.", + "category": "messaging", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses to send the email to (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of CC recipients' email addresses (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of BCC recipients' email addresses (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Content of the email body, supports plain text or HTML format (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "True if the email body is HTML formatted, false if plain text (optional, default false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachments, each with name and base64-encoded content (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "from", + "type": "string", + "description": "Email address of the sender. If not provided, uses default configured sender (optional).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing messageId (string) identifying the sent email and status (string) indicating success or failure with error messages if any." + }, + "aiAgent": { + "useCase": "This tool is appropriate for AI agents needing to send emails programmatically, such as for notifications, alerts, user communications, or transactional emails. It is useful when the agent has email content ready and recipient information and requires reliable delivery via an email service.", + "limitations": "This tool does not handle email receiving, inbox management, email templating or localization. It cannot guarantee delivery beyond successful handoff to the email service. Attachments must be encoded and provided by the caller.", + "examples": [ + "Send a welcome email to a new user with personalized subject and body.", + "Notify multiple team members with CC and BCC about a project update including attached report.", + "Send a plain text password reset email from a specified sender address." + ] + }, + "tags": [ + "messaging", + "email", + "send", + "communication", + "notification", + "transactional" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Welcome to Our Service\",\"body\":\"Hello User,\\nThank you for signing up!\",\"isHtml\":false}", + "description": "Send a simple plain text welcome email to a single recipient." + }, + { + "inputJson": "{\"to\":[\"team1@example.com\",\"team2@example.com\"],\"cc\":[\"manager@example.com\"],\"bcc\":[\"audit@example.com\"],\"subject\":\"Project Update\",\"body\":\"Update
The project is on track.
\",\"isHtml\":true,\"attachments\":[{\"name\":\"report.pdf\",\"content\":\"JVBERi0xLjQKJcfs...\"}]}", + "description": "Send an HTML email including CC, BCC, and an attached PDF report to a team." + }, + { + "inputJson": "{\"from\":\"noreply@example.com\",\"to\":[\"user@example.com\"],\"subject\":\"Password Reset\",\"body\":\"Your password reset code is 123456.\",\"isHtml\":false}", + "description": "Send a password reset email from a specific no-reply sender address." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "email-communication.sendChannel", + "description": "Sends an email through a specified communication channel such as SMTP or an API-based service. Accepts email details including recipients, subject, body, and optional attachments; processes the sending via the chosen channel; returns a status report including success confirmation and message ID or error details.", + "category": "email-communication", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of email sending channel to use (e.g., 'SMTP', 'SendGrid', 'Mailgun').", + "required": true, + "defaultValue": "" + }, + { + "name": "smtpConfig", + "type": "object", + "description": "SMTP configuration object including host, port, username, password (required if channelType is SMTP).", + "required": false, + "defaultValue": "" + }, + { + "name": "apiKey", + "type": "string", + "description": "API key for the email service provider (required if channelType uses API).", + "required": false, + "defaultValue": "" + }, + { + "name": "fromAddress", + "type": "string", + "description": "Email address of the sender.", + "required": true, + "defaultValue": "" + }, + { + "name": "toAddresses", + "type": "array", + "description": "Array of recipient email addresses.", + "required": true, + "defaultValue": "" + }, + { + "name": "ccAddresses", + "type": "array", + "description": "Array of CC recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccAddresses", + "type": "array", + "description": "Array of BCC recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main body content of the email (supports plain text or HTML).", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects, each with filename and content (base64 or file path).", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns a result object with keys: success (boolean), messageId (string if sent), error (string if failed)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to send an email message through a specified sending channel with full control over recipients, subject, content, and attachments. It supports SMTP or API-based providers, enabling flexible email automation.", + "limitations": "Does not handle email template rendering or dynamic personalization; assumes valid SMTP/API credentials are provided. Does not guarantee deliverability, only submission status.", + "examples": [ + "Send a transactional email to a user via SMTP server.", + "Send a marketing email through SendGrid API with multiple recipients and attachments.", + "Send a confirmation email with CC and BCC recipients using a configured SMTP channel." + ] + }, + "tags": [ + "email", + "send", + "communication", + "automation", + "SMTP", + "API", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"SMTP\",\"smtpConfig\":{\"host\":\"smtp.example.com\",\"port\":587,\"username\":\"user\",\"password\":\"pass\"},\"fromAddress\":\"noreply@example.com\",\"toAddresses\":[\"user1@example.com\"],\"ccAddresses\":[],\"bccAddresses\":[],\"subject\":\"Welcome to Our Service\",\"body\":\"Hello, welcome!\",\"attachments\":[]}", + "description": "Send a welcome email to one recipient using SMTP." + }, + { + "inputJson": "{\"channelType\":\"SendGrid\",\"apiKey\":\"SG.xxxxxxxx\",\"fromAddress\":\"marketing@example.com\",\"toAddresses\":[\"client1@example.com\",\"client2@example.com\"],\"ccAddresses\":[\"manager@example.com\"],\"bccAddresses\":[],\"subject\":\"Our Latest Offers\",\"body\":\"Check out our new offers!
\",\"attachments\":[{\"filename\":\"promo.pdf\",\"content\":\"base64encodedstring\"}]}", + "description": "Send a marketing email with an attachment via SendGrid API." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "email-communication.sendAlert", + "description": "Sends a security alert email to specified recipients with customizable subject, message, and priority level. Accepts list of email addresses, subject line, message body, and optionally attachments and priority tags. Processes the inputs by formatting the email, then dispatches it through the configured SMTP service. Returns delivery status for tracking.", + "category": "email-communication", + "parameters": [ + { + "name": "recipients", + "type": "array", + "description": "List of recipient email addresses for the alert. Must be valid emails.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the security alert email.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "Main content of the security alert email. Supports plain text or limited HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the alert email; e.g., 'High', 'Medium', 'Low'.", + "required": false, + "defaultValue": "Medium" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of file paths or URLs to attach to the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "ccRecipients", + "type": "array", + "description": "Optional list of email addresses to be carbon copied.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccRecipients", + "type": "array", + "description": "Optional list of email addresses to be blind carbon copied.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Object containing overall success status and per-recipient delivery results including any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to notify security teams or stakeholders of critical or informational security events via email. Suitable for automated alerts triggered by monitoring systems or AI-analyzed incidents to ensure timely awareness and response.", + "limitations": "This tool does not analyze security events or determine alert content; it only sends provided alert content via email. It does not guarantee delivery due to external email system factors and does not handle two-way email communication or escalation logic.", + "examples": [ + "Send a high priority email alert to the security operations team with an incident summary and attached logs.", + "Notify IT management with medium priority about a scheduled maintenance alert.", + "Send a low priority email to multiple recipients informing them of a resolved security issue." + ] + }, + "tags": [ + "email", + "security", + "alert", + "automation", + "notification", + "communication", + "priority", + "attachments" + ], + "examples": [ + { + "inputJson": "{\"recipients\":[\"secops@example.com\"],\"subject\":\"Critical: Unauthorized Access Detected\",\"messageBody\":\"An unauthorized login attempt was detected on server X at 03:15 UTC.\",\"priority\":\"High\",\"attachments\":[\"/var/logs/auth_log.txt\"]}", + "description": "Send a high priority alert email with an attachment to the security operations team." + }, + { + "inputJson": "{\"recipients\":[\"itmanager@example.com\"],\"subject\":\"Scheduled Security Maintenance Notification\",\"messageBody\":\"The firewall will undergo scheduled maintenance on March 5th from 2-4 AM.\",\"priority\":\"Medium\"}", + "description": "Send a medium priority informational email about scheduled maintenance to IT management." + }, + { + "inputJson": "{\"recipients\":[\"securityteam@example.com\",\"auditor@example.com\"],\"subject\":\"Resolved: Phishing Attack Incident\",\"messageBody\":\"The phishing incident reported yesterday has been fully resolved.\",\"priority\":\"Low\",\"ccRecipients\":[\"compliance@example.com\"]}", + "description": "Notify multiple recipients with a low priority email about resolution of a phishing incident, CC compliance." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "email-communication.sendMention", + "description": "Sends an email message that explicitly mentions or notifies a specific recipient or list of recipients within the email body, ensuring they are highlighted for attention. It accepts sender info, recipient email(s), mention targets, subject, and message content, and outputs a send status with message ID or error details.", + "category": "email-communication", + "parameters": [ + { + "name": "senderEmail", + "type": "string", + "description": "The email address of the sender from which the email will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmails", + "type": "array", + "description": "Array of recipient email addresses to send the email to.", + "required": true, + "defaultValue": "" + }, + { + "name": "mentionEmails", + "type": "array", + "description": "Array of email addresses to explicitly mention within the email body for notification.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content of the email message where mentions will be embedded or highlighted.", + "required": true, + "defaultValue": "" + }, + { + "name": "ccEmails", + "type": "array", + "description": "Optional array of CC (carbon copy) email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccEmails", + "type": "array", + "description": "Optional array of BCC (blind carbon copy) email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mentionStyle", + "type": "string", + "description": "Optional style or format for how mentioned emails are highlighted in the message (e.g., bold, @username).", + "required": false, + "defaultValue": "@mention" + } + ], + "returns": { + "type": "object", + "description": "Returns the result of the send operation including success status, message ID if sent, and error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool to send emails that require explicitly calling out or mentioning specific recipients in the email body to draw their attention, such as notifying team members or stakeholders in a shared conversation. It ensures mentions are formatted and recipients are notified appropriately.", + "limitations": "This tool cannot verify delivery beyond handoff to the email server and does not support rich text formatting beyond simple mention styles. It also assumes valid email addresses and does not provide spam or security scanning.", + "examples": [ + "Send notification email to a team with specific members mentioned in the message.", + "Send customer support email highlighting the responsible support agent.", + "Send project update email mentioning multiple stakeholders to ensure attention." + ] + }, + "tags": [ + "email", + "communication", + "send", + "mention", + "notification", + "automation", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"senderEmail\":\"alice@example.com\",\"recipientEmails\":[\"team@example.com\"],\"mentionEmails\":[\"bob@example.com\"],\"subject\":\"Project Update\",\"body\":\"Hello team, please note the updates. @bob@example.com please review the latest changes.\",\"ccEmails\":[],\"bccEmails\":[],\"mentionStyle\":\"@mention\"}", + "description": "Send a project update email to the team explicitly mentioning Bob to review changes." + }, + { + "inputJson": "{\"senderEmail\":\"support@company.com\",\"recipientEmails\":[\"customer@example.com\"],\"mentionEmails\":[\"agent1@company.com\"],\"subject\":\"Support Ticket Response\",\"body\":\"Dear Customer, your ticket is being handled by @agent1@company.com and will be updated shortly.\",\"ccEmails\":[],\"bccEmails\":[],\"mentionStyle\":\"@mention\"}", + "description": "Send a support response email mentioning the assigned agent to the customer." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "email-communication.sendNotification", + "description": "This tool sends email notifications to specified recipients. It accepts parameters including recipient emails, subject, body content (HTML or plain text), optional attachments, and sender details. It processes these inputs to dispatch an email via a configured SMTP service or API and returns a status including success confirmation and message ID or error details.", + "category": "email-communication", + "parameters": [ + { + "name": "recipientEmails", + "type": "array", + "description": "List of recipient email addresses to send the notification to.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for the notification email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content of the email message. Can include HTML or plain text.", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Indicates whether the body content is HTML (true) or plain text (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachments to include, each with filename and base64-encoded content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "senderEmail", + "type": "string", + "description": "Email address used as sender. If omitted, default sender is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "replyTo", + "type": "string", + "description": "Optional reply-to email address for recipient responses.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object indicating the sending result with properties 'success' (boolean), 'messageId' (string if successful), and 'error' (string if failed)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send scheduled or triggered email notifications, alerts, or updates to users or stakeholders. Helpful for automating communication workflows, transactional messages, or announcement blasts.", + "limitations": "This tool does not generate email content; it only sends emails with provided content. It cannot manage large-scale mailing list subscriptions or handle bounce management internally.", + "examples": [ + "Send a notification email to a user about a password reset.", + "Send an HTML formatted newsletter update to a list of subscribers.", + "Send an alert email with a PDF report attached to the operations team." + ] + }, + "tags": [ + "email", + "notification", + "communication", + "automation", + "SMTP", + "alert", + "transactional" + ], + "examples": [ + { + "inputJson": "{\"recipientEmails\":[\"user@example.com\"],\"subject\":\"Welcome to Our Service\",\"body\":\"Hello, thank you for joining us!\",\"isHtml\":false}", + "description": "Send a simple welcome plain text email to a single recipient." + }, + { + "inputJson": "{\"recipientEmails\":[\"team@example.com\"],\"subject\":\"Monthly Report\",\"body\":\"Monthly Report
See attached report.
\",\"isHtml\":true,\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"JVBERi0xLjQKJ...base64 content...\"}]}", + "description": "Send an HTML email with a PDF attachment to a team mailing list." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "email-communication.sendMessage", + "description": "Sends an email message to specified recipients with options for subject, body content (plain text or HTML), attachments, and additional headers. Accepts recipient addresses, message content, and configuration parameters; processes email formatting and SMTP transmission; returns delivery status and message ID.", + "category": "email-communication", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses. At least one recipient is required.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of email addresses to be CC'd.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of email addresses to be BCC'd.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Content of the email message, plain text or HTML based on isHtml parameter.", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Indicates if the body content is in HTML format. Defaults to false (plain text).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "List of file attachments with each having filename and base64 encoded content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "headers", + "type": "object", + "description": "Additional email headers to include, e.g., custom X-Headers.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "Result object including success boolean, messageId string if successful, and error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send email messages programmatically with customizable recipients, subject, body content (text or HTML), optional attachments, and custom headers via SMTP or an email service interface. Suitable for automated notifications, alerts, or replies.", + "limitations": "This tool does not handle email server configuration or authentication itself; it expects the SMTP setup to be handled externally. It also cannot guarantee delivery or handle inbound email processing.", + "examples": [ + "Send a plain text notification email to one recipient.", + "Send an HTML formatted newsletter to multiple recipients with an attached PDF.", + "Send an email with CC and BCC recipients and custom headers for tracking." + ] + }, + "tags": [ + "email", + "send", + "communication", + "automation", + "notification", + "SMTP" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Account Alert\",\"body\":\"Your account balance is low.\",\"isHtml\":false}", + "description": "Send a simple plain text alert message to a single recipient." + }, + { + "inputJson": "{\"to\":[\"client1@example.com\",\"client2@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Monthly Report\",\"body\":\"Report Attached
Please review the monthly report.
\",\"isHtml\":true,\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"JVBERi0xLjcKJYGBgYEKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmo=\"}]}", + "description": "Send an HTML email with CC recipients and a PDF attachment to multiple main recipients." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "email-communication.sendEmail", + "description": "This tool sends an email message to one or more recipients. It accepts inputs such as recipient email addresses, subject line, body content (plain text and/or HTML), optional attachments, and sender details. It processes this data to dispatch the email using SMTP or a configured email service, returning a result indicating success, message ID, or error details.", + "category": "email-communication", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses to send the email to", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of email addresses to receive a carbon copy of the email", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of email addresses to receive a blind carbon copy of the email", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "Plain text content of the email body", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "HTML content of the email body; overrides plain text if provided", + "required": false, + "defaultValue": "" + }, + { + "name": "from", + "type": "string", + "description": "Sender's email address; if omitted, defaults to configured sender identity", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects, each containing filename and base64-encoded content", + "required": false, + "defaultValue": "[]" + }, + { + "name": "priority", + "type": "string", + "description": "Email priority level, e.g., 'high', 'normal', or 'low'", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "Result indicating success or failure of sending the email, including message ID and error information if any" + }, + "aiAgent": { + "useCase": "Use this tool when needing to send transactional or marketing emails, notifications, or alerts to one or more email recipients with optional attachments and formatting. Ideal for automated systems requiring programmatic email delivery with flexible content and recipients.", + "limitations": "This tool cannot compose email content automatically beyond provided inputs; it does not manage inboxes or receive email. It also depends on configured mail servers and cannot ensure delivery or spam filtering outcomes.", + "examples": [ + "Send a welcome email to a new user after registration.", + "Send a weekly report email with PDF attachment to a distribution list.", + "Send a password reset email to a single recipient with high priority." + ] + }, + "tags": [ + "email", + "communication", + "send", + "automation", + "notifications", + "transactional", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Welcome to Our Service\",\"bodyText\":\"Hello User, welcome!\",\"from\":\"noreply@service.com\"}", + "description": "Send a simple welcome email in plain text to a single recipient." + }, + { + "inputJson": "{\"to\":[\"team@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Weekly Report\",\"bodyHtml\":\"Weekly Report
Find attached.
\",\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"\"}],\"from\":\"reports@example.com\"}", + "description": "Send an HTML weekly report email with a PDF attachment to multiple recipients and CC to manager." + }, + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Password Reset\",\"bodyText\":\"Click the link to reset your password.\",\"priority\":\"high\"}", + "description": "Send a high priority password reset email with plain text body." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "email-communication.sendComment", + "description": "Sends a comment as an email message to specified recipients. Accepts input including recipient emails, subject, comment body, optional CC/BCC lists, and attachment references. Processes inputs by formatting the email and using an SMTP or API-based service to deliver the email. Outputs a delivery status and message ID if successful.", + "category": "email-communication", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses to send the comment to", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for the comment email", + "required": true, + "defaultValue": "" + }, + { + "name": "commentBody", + "type": "string", + "description": "Main content of the comment to send", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of email addresses to CC", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of email addresses to BCC", + "required": false, + "defaultValue": "[]" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachment file references or URLs", + "required": false, + "defaultValue": "[]" + }, + { + "name": "replyTo", + "type": "string", + "description": "Optional email address to use as reply-to", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object indicating success status, message ID if sent, and any error messages encountered." + }, + "aiAgent": { + "useCase": "Use this tool when needing to send a textual comment or note to one or more email recipients as a formal email message, including handling CC/BCC and optional attachments. It is suitable for automation scenarios where comments need to be communicated via email rather than platform-internal messaging.", + "limitations": "Cannot perform rich formatting beyond plain text or simple HTML. Does not support inline images or real-time collaboration. Not responsible for email content validation or addressing spam filters.", + "examples": [ + "Send a comment to a project team with a summary and request for feedback.", + "Email a customer support comment including logs as attachment to multiple recipients.", + "Send a notification comment to stakeholders with CC and BCC recipients specified." + ] + }, + "tags": [ + "email", + "communication", + "send", + "comment", + "automation", + "notification" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"team@example.com\"],\"subject\":\"Weekly Update\",\"commentBody\":\"Here is the weekly status update on the project.\"}", + "description": "Send a simple weekly update comment email to a team." + }, + { + "inputJson": "{\"to\":[\"client@example.com\"],\"subject\":\"Issue Resolution Comment\",\"commentBody\":\"The reported issue has been resolved. Please find attached the log files.\",\"attachments\":[\"log1.txt\",\"log2.txt\"]}", + "description": "Send a comment email to client including attachments." + }, + { + "inputJson": "{\"to\":[\"support@example.com\"],\"subject\":\"Customer Feedback\",\"commentBody\":\"Customer has reported intermittent failures.\",\"cc\":[\"manager@example.com\"],\"bcc\":[\"audit@example.com\"]}", + "description": "Send customer feedback comment email with CC and BCC recipients." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "email-communication.sendThread", + "description": "Sends an entire email thread as a single continuous email, including all previous messages formatted chronologically. Accepts thread messages and recipient details, composes a combined email preserving message context, and dispatches it to specified recipients. Returns the send status and message ID for tracking.", + "category": "email-communication", + "parameters": [ + { + "name": "threadMessages", + "type": "array", + "description": "An ordered array of message objects representing the email thread, each with sender, timestamp, and content.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of email addresses to send the thread to.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for the outgoing combined email thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "senderEmail", + "type": "string", + "description": "The email address from which the thread will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeAttachments", + "type": "boolean", + "description": "Whether to include attachments from all messages in the thread in the outgoing email.", + "required": false, + "defaultValue": "false" + }, + { + "name": "format", + "type": "string", + "description": "Email format for the thread message: 'plain' for plain text or 'html' for formatted HTML.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object detailing if the send was successful with message ID and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send a consolidated email thread to one or more recipients, preserving the chronological conversation context. Ideal for summarizing or sharing discussion histories in a single email instead of multiple individual messages.", + "limitations": "Does not generate or alter individual message contents beyond formatting; cannot handle partial thread sends or dynamically summarize thread content beyond concatenation.", + "examples": [ + "Send the whole customer support email conversation to a manager for review.", + "Forward the legal discussion thread to the legal team maintaining the full message context.", + "Resend a project email thread as a consolidated recap to all participants." + ] + }, + "tags": [ + "email", + "thread", + "send", + "communication", + "automation" + ], + "examples": [ + { + "inputJson": "{\"threadMessages\":[{\"sender\":\"alice@example.com\",\"timestamp\":\"2024-05-01T09:15:00Z\",\"content\":\"Hi team, let's start the project.\"},{\"sender\":\"bob@example.com\",\"timestamp\":\"2024-05-01T09:45:00Z\",\"content\":\"I agree, setting up the infrastructure.\"}],\"recipients\":[\"manager@example.com\"],\"subject\":\"Project Kickoff Thread\",\"senderEmail\":\"alice@example.com\",\"includeAttachments\":false,\"format\":\"html\"}", + "description": "Send a project kickoff email thread to a manager as a combined HTML email." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "customer-support.sendThread", + "description": "Sends a message thread within a customer support platform to a specified recipient or group. Accepts inputs such as the thread ID, message content, recipient identifiers, and optional attachments. Processes the dispatch of the entire thread content or a new message within the thread, returning a status confirmation with message IDs and timestamps.", + "category": "customer-support", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Unique identifier of the message thread to send or append to.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientIds", + "type": "array", + "description": "An array of user IDs representing the recipients of the thread or message.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The content of the new message to send in the thread. If empty, sends the existing thread as-is.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects (each with filename and URL) to include with the message.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the message to be sent (e.g., high, normal, low).", + "required": false, + "defaultValue": "normal" + }, + { + "name": "notifyRecipients", + "type": "boolean", + "description": "Whether to trigger notifications for recipients upon sending the thread/message.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing status of the send action, sent message ID, timestamps, and any errors." + }, + "aiAgent": { + "useCase": "Use this tool when needing to send or forward an entire support conversation thread or to append a new message within an existing thread to one or multiple recipients in customer support scenarios. It ensures message content and attachments are properly sent and notifications dispatched as needed.", + "limitations": "Cannot create a new thread from scratch; the thread must exist. Does not support scheduling messages for future delivery. It does not handle message translation or content moderation.", + "examples": [ + "Send a follow-up message within thread 'abc123' to customer 'user456' with text and attachment.", + "Forward entire thread 'xyz789' to a group of support agents for review.", + "Send a quick update message in thread 'def456' without attachments and mark it as high priority." + ] + }, + "tags": [ + "customer-support", + "messaging", + "thread-management", + "notifications", + "attachments", + "priority" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"thread001\",\"recipientIds\":[\"user123\"],\"messageContent\":\"Hello, your issue is being reviewed.\",\"attachments\":[],\"priority\":\"normal\",\"notifyRecipients\":true}", + "description": "Send a follow-up message to a single customer in an existing thread with normal priority and notification." + }, + { + "inputJson": "{\"threadId\":\"thread002\",\"recipientIds\":[\"agent001\",\"agent002\"],\"messageContent\":\"\",\"attachments\":[],\"priority\":\"normal\",\"notifyRecipients\":false}", + "description": "Forward an existing thread without new message content to two agents without notifications." + }, + { + "inputJson": "{\"threadId\":\"thread003\",\"recipientIds\":[\"user789\"],\"messageContent\":\"Please find the attached logs.\",\"attachments\":[{\"filename\":\"log1.txt\",\"url\":\"https://files.example.com/log1.txt\"}],\"priority\":\"high\",\"notifyRecipients\":true}", + "description": "Send a high priority message with an attachment to one user in an existing thread." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "customer-support.sendReply", + "description": "Sends a reply message to a customer inquiry or support ticket. Accepts the ticket ID, reply content, optional attachments, and metadata like urgency or channel. Processes this by posting the reply within the customer support system and returns confirmation details including status and timestamp.", + "category": "customer-support", + "parameters": [ + { + "name": "ticketId", + "type": "string", + "description": "Unique identifier for the customer support ticket to reply to.", + "required": true, + "defaultValue": "" + }, + { + "name": "replyContent", + "type": "string", + "description": "Text content of the reply message to send to the customer.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachment file URLs or IDs to include with the reply.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "replyChannel", + "type": "string", + "description": "The communication channel used for the reply (e.g., email, chat, sms).", + "required": false, + "defaultValue": "email" + }, + { + "name": "isUrgent", + "type": "boolean", + "description": "Flag indicating if the reply is marked as urgent and requires immediate attention.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object confirming the reply was sent with message ID, timestamp, and status." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to respond to a customer support ticket by sending a text reply, optionally with attachments, via a chosen communication channel. It is ideal for automating responses or processing follow-ups in a structured support system.", + "limitations": "This tool cannot create new tickets or modify ticket data other than adding replies. It also cannot read tickets or analyze ticket contents to compose replies automatically.", + "examples": [ + "Send a follow-up reply to ticket '12345' with a troubleshooting link attached.", + "Respond urgently via chat to ticket '67890' confirming issue resolution.", + "Send a standard email reply to ticket 'abcde' thanking the customer for their patience." + ] + }, + "tags": [ + "customer-support", + "communication", + "reply", + "ticketing", + "automation", + "message-sending", + "helpdesk" + ], + "examples": [ + { + "inputJson": "{\"ticketId\":\"12345\",\"replyContent\":\"Thank you for contacting us. Please try restarting your device as the first troubleshooting step.\",\"attachments\":[],\"replyChannel\":\"email\",\"isUrgent\":false}", + "description": "Send a standard email reply with troubleshooting instructions to ticket '12345'." + }, + { + "inputJson": "{\"ticketId\":\"67890\",\"replyContent\":\"We are escalating your issue to our technical team and will update you shortly.\",\"attachments\":[],\"replyChannel\":\"chat\",\"isUrgent\":true}", + "description": "Send an urgent chat reply notifying escalation for ticket '67890'." + }, + { + "inputJson": "{\"ticketId\":\"abcde\",\"replyContent\":\"Here is the user manual you requested.\",\"attachments\":[\"file://manual.pdf\"],\"replyChannel\":\"email\",\"isUrgent\":false}", + "description": "Send an email reply with an attachment (user manual) to ticket 'abcde'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "customer-support.sendMention", + "description": "Sends a mention notification within a customer support platform to notify a specific agent or group about a ticket or message. Accepts parameters specifying the recipient, the context of the mention, and optional message content, then processes the mention trigger and returns a confirmation of delivery and status.", + "category": "customer-support", + "parameters": [ + { + "name": "recipientId", + "type": "string", + "description": "Unique identifier of the agent or group to be mentioned", + "required": true, + "defaultValue": "" + }, + { + "name": "ticketId", + "type": "string", + "description": "Identifier of the support ticket or conversation related to the mention", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "Optional additional message content to accompany the mention", + "required": false, + "defaultValue": "" + }, + { + "name": "mentionType", + "type": "string", + "description": "Type of mention: 'user' for individual or 'group' for multiple agents", + "required": true, + "defaultValue": "user" + }, + { + "name": "urgent", + "type": "boolean", + "description": "Flag indicating if the mention should be marked as urgent for priority handling", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the mention delivery, including success boolean, a message description, and a mentionId for reference" + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to notify specific customer support agents or groups about a relevant ticket, comment, or update requiring their attention within a customer support platform. This ensures timely collaboration and task visibility among support teams.", + "limitations": "This tool cannot create or modify tickets or send mentions outside the integrated support platform. It also does not support bulk mentions beyond a single agent or group at a time.", + "examples": [ + "Notify a specific support agent about a newly escalated support ticket.", + "Send a group mention to all billing team members regarding a payment issue.", + "Attach a custom note with the mention to clarify the required action." + ] + }, + "tags": [ + "customer-support", + "notification", + "mention", + "collaboration", + "support-ticket" + ], + "examples": [ + { + "inputJson": "{\"recipientId\":\"agent123\",\"ticketId\":\"tk98765\",\"message\":\"Please review the customer's latest update.\",\"mentionType\":\"user\",\"urgent\":true}", + "description": "Send an urgent mention to a single agent notifying them about a ticket update with an additional message." + }, + { + "inputJson": "{\"recipientId\":\"group_billing\",\"ticketId\":\"tk12345\",\"mentionType\":\"group\"}", + "description": "Send a mention to the billing support group about a payment-related ticket without extra message content." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "customer-support.sendEmail", + "description": "Sends an email message from a specified sender to one or more recipients, with support for subject, body (text or HTML), and optional attachments. Accepts parameters for recipients, subject line, message content, sender address, carbon copy, blind carbon copy, and reply-to addresses. Returns a status object indicating delivery success or failure and any error messages.", + "category": "customer-support", + "parameters": [ + { + "name": "fromAddress", + "type": "string", + "description": "Email address of the sender.", + "required": true, + "defaultValue": "" + }, + { + "name": "toAddresses", + "type": "array", + "description": "Array of recipient email addresses.", + "required": true, + "defaultValue": "" + }, + { + "name": "ccAddresses", + "type": "array", + "description": "Array of email addresses to be carbon copied.", + "required": false, + "defaultValue": "" + }, + { + "name": "bccAddresses", + "type": "array", + "description": "Array of email addresses to be blind carbon copied.", + "required": false, + "defaultValue": "" + }, + { + "name": "replyToAddress", + "type": "string", + "description": "Email address for reply-to header if different from sender.", + "required": false, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Content of the email message, can be plain text or HTML formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Indicates whether the body is in HTML format.", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects, each with filename and binary data as base64 string.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a boolean success flag, messageId if successful, and error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically send customizable email messages to customers or internal staff in customer support scenarios, such as sending ticket updates, notifications, or responses. It supports multiple recipients and attachments, enabling robust communication workflows.", + "limitations": "This tool does not handle email inbox management, spam filtering, or email receiving; it only sends outgoing emails. It also does not guarantee delivery, only transmission to the email server.", + "examples": [ + "Send a ticket update email to a customer with a PDF attachment.", + "Send a notification email to multiple support agents about system status.", + "Send a confirmation email with HTML formatting to a single customer." + ] + }, + "tags": [ + "email", + "customer support", + "communication", + "notification", + "outbound" + ], + "examples": [ + { + "inputJson": "{\"fromAddress\":\"support@company.com\",\"toAddresses\":[\"customer1@example.com\"],\"subject\":\"Your support ticket has been updated\",\"body\":\"Dear customer, your ticket #1234 has a new update.\",\"isHtml\":false}", + "description": "Basic support ticket update email to one customer." + }, + { + "inputJson": "{\"fromAddress\":\"noreply@company.com\",\"toAddresses\":[\"agent1@company.com\",\"agent2@company.com\"],\"ccAddresses\":[\"manager@company.com\"],\"subject\":\"System Outage Alert\",\"body\":\"The system will be down for maintenance at midnight.\",\"isHtml\":false}", + "description": "Notification email to multiple support agents with a CC to the manager." + }, + { + "inputJson": "{\"fromAddress\":\"support@company.com\",\"toAddresses\":[\"customer2@example.com\"],\"subject\":\"Your order receipt\",\"body\":\" Thank you for your purchase!
Attached is your receipt.
\",\"isHtml\":true,\"attachments\":[{\"filename\":\"receipt.pdf\",\"data\":\"JVBERi0xLjUKJcfs...\"}]}", + "description": "HTML formatted confirmation email with PDF attachment to customer." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "marketing-automation.analyzeReference", + "description": "Analyzes marketing reference content such as URLs, documents, or raw text to extract actionable marketing insights. It accepts a reference input (link, text, or file content), performs content analysis including sentiment, keyword extraction, competitor mentions, and campaign indicators, then outputs a structured summary report highlighting key marketing insights and recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "referenceType", + "type": "string", + "description": "Specifies the type of input reference: 'url', 'text', or 'document'.", + "required": true, + "defaultValue": "" + }, + { + "name": "referenceInput", + "type": "string", + "description": "The URL link, raw text content, or encoded document content to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the reference content, e.g., 'en' for English, to improve analysis accuracy.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeSentimentAnalysis", + "type": "boolean", + "description": "If true, include sentiment analysis of the reference content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeKeywordExtraction", + "type": "boolean", + "description": "If true, include keyword and keyphrase extraction in the analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeCompetitorMentions", + "type": "boolean", + "description": "If true, detect mentions of competitors in the content where applicable.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "Maximum length in characters for the generated summary report (recommend 500-2000).", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "Structured analysis report containing summary, extracted keywords, sentiment scores, detected competitor mentions, and marketing recommendations" + }, + "aiAgent": { + "useCase": "Use this tool when tasked with evaluating marketing reference materials such as competitor campaign pages, promotional texts, product launch documents, or market reports. It helps synthesize complex marketing information into actionable insights and identifies strategic markers useful for campaign optimization and competitor analysis.", + "limitations": "Cannot access restricted or paywalled content behind URLs. Accuracy depends on input language support and content quality. Does not replace human expert judgment but supplements marketing analysis.", + "examples": [ + "Analyze the marketing strategy described in this competitor's campaign URL.", + "Extract key marketing messages and sentiment from this product launch press release text.", + "Summarize and identify competitor references from the attached trade report document." + ] + }, + "tags": [ + "marketing", + "analysis", + "content-analysis", + "reference", + "insights", + "automation", + "campaigns" + ], + "examples": [ + { + "inputJson": "{\"referenceType\":\"url\",\"referenceInput\":\"https://example.com/competitor-campaign\",\"language\":\"en\",\"includeSentimentAnalysis\":true,\"includeKeywordExtraction\":true,\"includeCompetitorMentions\":true,\"maxSummaryLength\":1200}", + "description": "Analyze a competitor's marketing campaign webpage for insights, keywords, sentiment, and competitor mentions." + }, + { + "inputJson": "{\"referenceType\":\"text\",\"referenceInput\":\"Our latest product launch offers innovative solutions with a focus on sustainability and user experience.\",\"language\":\"en\",\"includeSentimentAnalysis\":true,\"includeKeywordExtraction\":true,\"includeCompetitorMentions\":false}", + "description": "Analyze raw marketing text content for key points, sentiment, and keywords, omitting competitor mentions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Reference", + "context": null + } + }, + { + "name": "customer-support.sendChannel", + "description": "This tool sends a message through a specified customer support communication channel such as email, chat, SMS, or social media messaging. It accepts parameters defining the channel type, recipient information, message content, and optional metadata, processes the sending request via the appropriate API or protocol, and returns a status report indicating success or failure with relevant details.", + "category": "customer-support", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "The type of support channel to send the message through (e.g., email, chat, SMS, social).", + "required": true, + "defaultValue": "" + }, + { + "name": "recipient", + "type": "string", + "description": "The unique identifier or address of the message recipient appropriate to the channel (email address, phone number, chat ID).", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The textual content of the message to be sent to the customer or recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional metadata such as subject line for email, message priority, or attachments information.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier for the sender or customer support representative (optional).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the sending result including success status, message ID if applicable, timestamp, and error details if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to send messages on behalf of customer support agents through various communication channels for inquiries, notifications, or follow-ups. Ideal for automating multi-channel responses or routing messages programmatically.", + "limitations": "This tool cannot create or manage the customer support channels themselves, nor can it guarantee message delivery beyond reporting the send attempt status. It also does not handle message formatting or templates inherently.", + "examples": [ + "Send a follow-up email to customer confirming their ticket resolution.", + "Send a chat message to a customer on the company support website.", + "Send an SMS notification about a scheduled service appointment." + ] + }, + "tags": [ + "customer-support", + "communication", + "send-message", + "multi-channel", + "notifications", + "automation" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"recipient\":\"user@example.com\",\"messageContent\":\"Dear customer, your issue has been resolved.\",\"metadata\":{\"subject\":\"Ticket Resolved\"},\"senderId\":\"supportAgent01\"}", + "description": "Send an email notifying the customer that their support ticket issue has been resolved." + }, + { + "inputJson": "{\"channelType\":\"chat\",\"recipient\":\"chatUser123\",\"messageContent\":\"Hello! How can I assist you today?\",\"metadata\":{},\"senderId\":\"chatBot001\"}", + "description": "Send a chat message initiating conversation with a customer on website support chat." + }, + { + "inputJson": "{\"channelType\":\"sms\",\"recipient\":\"+15551234567\",\"messageContent\":\"Reminder: Your appointment is scheduled for tomorrow at 3 PM.\",\"metadata\":{},\"senderId\":\"system\"}", + "description": "Send an SMS notification reminding the customer of an upcoming appointment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "customer-support.sendAlert", + "description": "Sends an alert notification to designated customer support team members regarding security-related events or potential threats. Accepts input including alert message, recipients, severity, and optional metadata, then processes and dispatches the alert via email or in-system notification, returning a status confirmation for each recipient.", + "category": "customer-support", + "parameters": [ + { + "name": "alertMessage", + "type": "string", + "description": "The main content or description of the security alert to be sent to the team.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient identifiers (emails or user IDs) who should receive the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Defines the urgency or impact level of the alert (e.g., 'low', 'medium', 'high').", + "required": false, + "defaultValue": "medium" + }, + { + "name": "sendByEmail", + "type": "boolean", + "description": "Whether to send the alert as an email message to recipients.", + "required": false, + "defaultValue": "true" + }, + { + "name": "sendInSystemNotification", + "type": "boolean", + "description": "Whether to send the alert as an in-system notification within the customer support portal.", + "required": false, + "defaultValue": "true" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional data related to the alert, such as incident ID, timestamp, or related system info.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the overall success status and detailed results for each recipient indicating whether alert delivery succeeded or failed." + }, + "aiAgent": { + "useCase": "Use this tool when a security incident or suspicious activity affecting customers is detected and the customer support team must be notified promptly with clear details and appropriate urgency. It is ideal for automating alerts across multiple channels and ensuring the relevant staff receive timely notifications to take action.", + "limitations": "This tool does not investigate security incidents, store alert logs long-term, or integrate directly with external incident management systems without additional interfacing.", + "examples": [ + "Send an urgent alert to the customer support lead and security team about a possible data breach.", + "Notify all frontline support agents with a medium priority message about phishing attempts targeting users.", + "Send a low severity alert via email only about a system maintenance affecting login services." + ] + }, + "tags": [ + "alert", + "security", + "customer-support", + "notification", + "incident-management" + ], + "examples": [ + { + "inputJson": "{\"alertMessage\":\"Urgent: Potential data breach detected in account management system.\",\"recipients\":[\"lead@support.com\",\"security@company.com\"],\"severityLevel\":\"high\",\"sendByEmail\":true,\"sendInSystemNotification\":true}", + "description": "Send a high severity alert to key support and security team members via email and in-system notification." + }, + { + "inputJson": "{\"alertMessage\":\"Phishing attempts detected targeting customer accounts.\",\"recipients\":[\"agent1@support.com\",\"agent2@support.com\"],\"severityLevel\":\"medium\",\"sendByEmail\":false,\"sendInSystemNotification\":true}", + "description": "Notify frontline support agents with a medium severity alert using in-system notifications only." + }, + { + "inputJson": "{\"alertMessage\":\"Scheduled maintenance affecting login services.\",\"recipients\":[\"all@support.com\"],\"severityLevel\":\"low\",\"sendByEmail\":true,\"sendInSystemNotification\":false}", + "description": "Send a low priority alert via email to all support staff about upcoming maintenance." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "customer-support.sendNotification", + "description": "Sends a notification message to specified customers or user groups. Accepts recipient identifiers, message content, notification type, and delivery preferences. Processes input to format and dispatch notifications via chosen channels, returning delivery status and error details if any.", + "category": "customer-support", + "parameters": [ + { + "name": "recipientIds", + "type": "array", + "description": "Array of unique identifiers representing the notification recipients (e.g., user IDs or customer IDs).", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The main content text of the notification to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "notificationType", + "type": "string", + "description": "Type or category of the notification, e.g., 'alert', 'reminder', or 'promotion'.", + "required": false, + "defaultValue": "general" + }, + { + "name": "channels", + "type": "array", + "description": "List of channels through which to send the notification, such as ['email', 'sms', 'push'].", + "required": false, + "defaultValue": "[\"email\"]" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification: 'low', 'normal', or 'high'.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule the notification for future delivery. Omit for immediate sending.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeAttachments", + "type": "boolean", + "description": "Whether to include attachments with the notification, if supported by channels.", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment object URLs or identifiers to include with the notification.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing a summary of notification dispatch results, including total recipients, successful deliveries, failures, and error messages if any." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to notify customers or users about updates, alerts, promotions, or reminders across multiple communication channels. This tool handles sending personalized or bulk notifications and reports delivery results.", + "limitations": "Cannot compose message content or determine recipient lists; these must be supplied. Does not guarantee delivery, only attempts it via specified channels. Scheduling accuracy depends on system clock and infrastructure.", + "examples": [ + "Send promo notification to multiple customers via email and SMS.", + "Schedule a reminder notification to a user group for an upcoming event.", + "Send a high-priority alert notification to a single user via push notification." + ] + }, + "tags": [ + "notification", + "customer-support", + "communication", + "messaging", + "alert", + "reminder", + "promotion" + ], + "examples": [ + { + "inputJson": "{\"recipientIds\": [\"user123\", \"user456\"], \"message\": \"Don't miss our summer sale! Up to 50% off.\", \"notificationType\": \"promotion\", \"channels\": [\"email\", \"sms\"], \"priority\": \"normal\", \"includeAttachments\": false}", + "description": "Send a promotional sale notification via email and SMS to two users." + }, + { + "inputJson": "{\"recipientIds\": [\"group789\"], \"message\": \"Your subscription expires in 3 days.\", \"notificationType\": \"reminder\", \"channels\": [\"email\"], \"priority\": \"high\", \"scheduleTime\": \"2024-07-01T09:00:00Z\"}", + "description": "Schedule a high-priority reminder email to a user group about subscription expiration." + }, + { + "inputJson": "{\"recipientIds\": [\"user999\"], \"message\": \"System outage detected. Please check status.\", \"notificationType\": \"alert\", \"channels\": [\"push\"], \"priority\": \"high\", \"includeAttachments\": false}", + "description": "Send an immediate high-priority push alert about a system outage to a single user." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "customer-support.sendComment", + "description": "Sends a comment message related to a specific customer support ticket or case. Accepts details such as ticket ID, comment text, optional attachments, and metadata to post the comment into the customer's support thread. Returns confirmation with comment ID and timestamp.", + "category": "customer-support", + "parameters": [ + { + "name": "ticketId", + "type": "string", + "description": "Unique identifier of the support ticket to which the comment should be added.", + "required": true, + "defaultValue": "" + }, + { + "name": "commentText", + "type": "string", + "description": "The text content of the comment message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the person or agent sending the comment, used for display in the thread.", + "required": false, + "defaultValue": "" + }, + { + "name": "isPublic", + "type": "boolean", + "description": "Flag indicating if the comment is visible to the customer (true) or internal only (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachment file URLs or base64 encoded data associated with the comment.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs with extra information about the comment, such as tags or references.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing confirmation details including the newly created comment ID, timestamp, and the status of the operation." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically add comments to existing customer support tickets, enabling automated or assisted interactions such as follow-ups, clarifications, or internal notes. It is useful when the AI agent identifies the need to append relevant information to a customer conversation or escalate issues internally.", + "limitations": "This tool cannot create new tickets, update existing ticket statuses, or delete comments. It only adds new comments to already existing tickets.", + "examples": [ + "Add a public comment to ticket 12345 informing the customer their issue is being escalated.", + "Send an internal note to ticket 98765 for the support team regarding investigation results.", + "Attach a screenshot and add a comment to ticket 54321 explaining the troubleshooting steps taken." + ] + }, + "tags": [ + "comment", + "customer-support", + "ticketing", + "communication", + "automation" + ], + "examples": [ + { + "inputJson": "{\"ticketId\":\"TKT1001\",\"commentText\":\"We have received your request and are working on it.\",\"authorName\":\"SupportBot\",\"isPublic\":true}", + "description": "Add a public comment to acknowledge receipt of the customer's request." + }, + { + "inputJson": "{\"ticketId\":\"TKT1002\",\"commentText\":\"Issue reproduction confirmed. Engineering team notified.\",\"authorName\":\"AgentAlice\",\"isPublic\":false,\"metadata\":{\"priority\":\"high\"}}", + "description": "Add an internal private comment with metadata marking the ticket as high priority." + }, + { + "inputJson": "{\"ticketId\":\"TKT1003\",\"commentText\":\"Please find attached the logs you requested.\",\"authorName\":\"SupportBot\",\"isPublic\":true,\"attachments\":[\"https://fileserver.com/logs/TKT1003.log\"]}", + "description": "Add a public comment with a link to a log file attachment for the customer." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "customer-support.sendMessage", + "description": "Sends a message to a customer or a group of customers through specified communication channels such as email, SMS, or in-app notifications. Accepts recipient identifiers, message content, channel preferences, and optional metadata. Returns delivery status and message IDs for tracking purposes.", + "category": "customer-support", + "parameters": [ + { + "name": "recipientIds", + "type": "array", + "description": "Array of unique identifiers representing the message recipients (e.g., customer IDs or contact emails).", + "required": true, + "defaultValue": "" + }, + { + "name": "messageSubject", + "type": "string", + "description": "Subject line of the message, applicable for email channels.", + "required": false, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "Main content of the message to be sent to recipients.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "List of communication channels to use for sending the message, e.g., ['email', 'sms', 'inApp'].", + "required": true, + "defaultValue": "[\"email\"]" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the message ('low', 'normal', 'high'), which may affect delivery order or notifications.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional arbitrary metadata object for tagging or additional instructions, such as campaign identifiers or message templates.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of recipient delivery statuses including message ID, recipient ID, channel used, and success or error details." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automate or assist in sending customer service messages across multiple channels, such as notifications about order status, support replies, or promotional announcements. It helps coordinate communication by specifying recipients, content, and preferred channels.", + "limitations": "Cannot generate or personalize message content dynamically; assumes content is already prepared. Does not guarantee message delivery as it depends on external channel providers.", + "examples": [ + "Send an order shipment notification email to a specific customer.", + "Send an urgent SMS alert to multiple customers.", + "Deliver an in-app notification reminding a customer about a support ticket update." + ] + }, + "tags": [ + "customer-support", + "messaging", + "notification", + "communication", + "email", + "sms", + "in-app", + "automation" + ], + "examples": [ + { + "inputJson": "{\"recipientIds\":[\"cust12345\"],\"messageSubject\":\"Your Order Has Shipped\",\"messageBody\":\"Dear customer, your order #98765 has been shipped and is on its way.\",\"channels\":[\"email\"],\"priority\":\"high\",\"metadata\":{\"orderId\":\"98765\"}}", + "description": "Send a high priority shipment confirmation email to a single customer." + }, + { + "inputJson": "{\"recipientIds\":[\"cust12345\",\"cust67890\"],\"messageBody\":\"Server maintenance is scheduled tonight from 1 AM to 3 AM.\",\"channels\":[\"sms\"],\"priority\":\"normal\"}", + "description": "Send an SMS alert about scheduled server maintenance to multiple customers." + }, + { + "inputJson": "{\"recipientIds\":[\"cust54321\"],\"messageBody\":\"Your support ticket #452 has been updated. Please check your account for details.\",\"channels\":[\"inApp\"],\"priority\":\"normal\"}", + "description": "Send an in-app notification to inform a customer about an update to their support ticket." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "marketing-automation.analyzeQuote", + "description": "Analyzes the content and sentiment of a sales or marketing quote text to extract key metrics such as sentiment score, keyword highlights, and readability. Accepts raw quote text and optional context parameters, then returns an analysis report useful for optimizing quote effectiveness in marketing campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The raw text content of the marketing or sales quote to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the quote text for accurate analysis (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "industryContext", + "type": "string", + "description": "Optional industry or sector context to tailor keyword extraction and sentiment interpretation.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeReadability", + "type": "boolean", + "description": "Flag to include readability metrics such as Flesch score in the output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report containing overall sentiment score, key highlighted phrases and words, readability scores if requested, and a summary interpretation of the quote's marketing tone." + }, + "aiAgent": { + "useCase": "Use this tool when evaluating marketing or sales quote texts to assess their emotional tone, pinpoint impactful keywords, and gauge readability. This aids marketing automation systems in optimizing content for higher engagement and conversion rates.", + "limitations": "This tool analyzes text but does not generate quotes or assess pricing accuracy. It also may have limited accuracy with slang or highly domain-specific jargon not included in its language models.", + "examples": [ + "Analyze the sentiment and key phrases of a new product launch quote for our next campaign.", + "Evaluate readability and tone of a customer testimonial quotation before using it in an ad.", + "Extract the main marketing keywords and overall positivity from a promotional quote text." + ] + }, + "tags": [ + "marketing", + "automation", + "text analysis", + "sentiment", + "quote", + "content", + "readability" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"Our innovative solution guarantees a 30% increase in efficiency, transforming your business workflows.\",\"language\":\"en\",\"industryContext\":\"technology\",\"includeReadability\":true}", + "description": "Analyzing a technology sector marketing quote for sentiment, keywords, and readability." + }, + { + "inputJson": "{\"quoteText\":\"Experience unmatched customer support and quality unlike any competitor.\",\"includeReadability\":false}", + "description": "Evaluating the sentiment and key phrases of a customer service quote without readability metrics." + }, + { + "inputJson": "{\"quoteText\":\"Boost your sales with our proven marketing strategies designed specifically for retail.\",\"language\":\"en\",\"industryContext\":\"retail\",\"includeReadability\":true}", + "description": "Extracting marketing insights from a retail-focused sales quote including readability score." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Quote", + "context": null + } + }, + { + "name": "marketing-automation.analyzeCitation", + "description": "Analyzes citations referenced in marketing content or campaigns by processing input citation texts or lists, evaluating their relevance, authority, and impact on marketing effectiveness, and producing a detailed report including citation quality scores, influence metrics, and recommendations for marketing optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "citations", + "type": "array", + "description": "An array of citation strings or objects representing marketing content references to be analyzed.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "Optional context description of the marketing campaign or content where citations are used to tailor analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeInfluenceMetrics", + "type": "boolean", + "description": "Flag to include detailed influence and impact metrics of each citation on marketing effectiveness.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language of the citations for accurate parsing and analysis.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured analysis report containing citation relevance scores, authority ratings, influence metrics, and actionable recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the quality and marketing impact of citations within marketing materials or campaigns to optimize content credibility and audience trust. It supports strategies that depend on authoritative references to enhance campaign effectiveness.", + "limitations": "This tool does not verify factual accuracy of citations or provide legal compliance checks. It is focused on marketing relevance and influence rather than academic rigor.", + "examples": [ + "Analyze the citations used in our recent email campaign to assess their marketing impact.", + "Evaluate a list of references from a whitepaper to improve its trustworthiness for targeted client outreach." + ] + }, + "tags": [ + "marketing", + "automation", + "citation", + "analysis", + "content-optimization", + "influence" + ], + "examples": [ + { + "inputJson": "{\"citations\": [\"Smith J. 2020. Marketing Trends.\", \"Doe A. 2019. Consumer Behavior Insights.\"], \"context\": \"Email campaign for new product launch\", \"includeInfluenceMetrics\": true, \"language\": \"en\"}", + "description": "Analyze two marketing citations referenced in an email campaign to determine their influence metrics and relevance." + }, + { + "inputJson": "{\"citations\": [\"Johnson R. 2018. Social Media Impact Study.\"], \"includeInfluenceMetrics\": false}", + "description": "Analyze a single citation without influence metrics to evaluate its authority in marketing content." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Citation", + "context": null + } + }, + { + "name": "marketing-automation.analyzeLink", + "description": "Analyzes marketing campaign URLs to extract and evaluate performance indicators such as traffic source, UTM parameters, click-through rates, and conversion metrics. Accepts a URL string and optional campaign context, and returns structured analysis to optimize marketing strategies.", + "category": "marketing-automation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The marketing URL to be analyzed, including tracking parameters if present.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignContext", + "type": "object", + "description": "Optional context data about the campaign such as campaign name, medium, or other metadata to enhance analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeHistoricalData", + "type": "boolean", + "description": "Flag to include historical performance data related to the URL if available in integrated analytics platforms.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A detailed analysis report including detected UTM parameters, estimated traffic source breakdown, click-through rate, conversion data if available, and recommendations for improving link performance." + }, + "aiAgent": { + "useCase": "Use this tool when needing to analyze the effectiveness and parameters of marketing links, such as URLs tagged with UTM parameters, to gain insights into campaign performance and traffic sources. It helps agents optimize campaign strategies based on link data analysis.", + "limitations": "Does not automatically fetch real-time analytics data without integration with analytics APIs. Cannot analyze URLs without access to underlying performance metrics.", + "examples": [ + "Analyze the given campaign link to report all UTM parameters and recent click metrics.", + "Evaluate the provided URL and suggest improvements based on its traffic source and conversion rates.", + "Provide a performance summary of this marketing link including historical click and conversion data if available." + ] + }, + "tags": [ + "marketing", + "automation", + "link-analysis", + "UTM", + "campaign", + "performance", + "analytics" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale\"}", + "description": "Analyze a basic marketing link with standard UTM parameters." + }, + { + "inputJson": "{\"url\":\"https://example.com/product?id=123&utm_source=newsletter\",\"campaignContext\":{\"campaignName\":\"Winter Promo\",\"medium\":\"email\"},\"includeHistoricalData\":true}", + "description": "Analyze an email campaign link with context and request inclusion of historical data." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Link", + "context": null + } + }, + { + "name": "marketing-automation.analyzeSession", + "description": "Analyzes a marketing session dataset to extract key user behavior metrics such as session duration, page views, bounce rate, conversion events, and traffic sources. Accepts session data as JSON or CSV, with options to filter by date range and segment users. Produces detailed metrics and summary insights to inform campaign optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "sessionData", + "type": "string", + "description": "Raw session data in JSON or CSV format to be analyzed, containing user interactions and events within sessions.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "Format of the input session data: 'json' or 'csv'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date (ISO 8601) to filter sessions for analysis. Optional, if provided limits data to sessions after or on this day.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date (ISO 8601) to filter sessions for analysis. Optional, if provided limits data to sessions before or on this day.", + "required": false, + "defaultValue": "" + }, + { + "name": "userSegment", + "type": "object", + "description": "Object defining filters to segment user sessions (e.g., by location, device type). Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeConversionEvents", + "type": "boolean", + "description": "Whether to include analysis of conversion events in the output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing analyzed session metrics such as average session duration, total page views, bounce rate, conversion rates, traffic source distribution, and insights summarizing user behavior." + }, + "aiAgent": { + "useCase": "Use this tool when you need to extract actionable insights from raw marketing session data to evaluate campaign performance, identify user behavior patterns, or segment users for targeted marketing strategies. Ideal for automated marketing analytics, reporting, and optimization workflows.", + "limitations": "Cannot ingest data formats other than JSON or CSV. Does not perform predictive modeling or real-time session tracking. Requires well-structured session data containing timestamps and event details.", + "examples": [ + "Analyze user sessions from last month to identify average session duration and bounce rate.", + "Segment session data for mobile device users and analyze conversion events to evaluate mobile campaign success.", + "Provide summary insights of traffic sources and page views from a JSON export of website sessions." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "session-analysis", + "user-behavior", + "conversion", + "campaign-optimization" + ], + "examples": [ + { + "inputJson": "{\"sessionData\":\"[{\\\"sessionId\\\":\\\"s1\\\",\\\"userId\\\":\\\"u1\\\",\\\"events\\\":[{\\\"eventType\\\":\\\"pageview\\\",\\\"timestamp\\\":\\\"2024-05-01T10:00:00Z\\\"},{\\\"eventType\\\":\\\"conversion\\\",\\\"timestamp\\\":\\\"2024-05-01T10:05:00Z\\\"}]},{\\\"sessionId\\\":\\\"s2\\\",\\\"userId\\\":\\\"u2\\\",\\\"events\\\":[{\\\"eventType\\\":\\\"pageview\\\",\\\"timestamp\\\":\\\"2024-05-02T11:00:00Z\\\"}]}]\",\"dataFormat\":\"json\",\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-31\",\"includeConversionEvents\":true}", + "description": "Analyze JSON session data for May 2024 including conversion events." + }, + { + "inputJson": "{\"sessionData\":\"sessionId,userId,eventType,timestamp\\ns1,u1,pageview,2024-05-01T10:00:00Z\\ns1,u1,conversion,2024-05-01T10:05:00Z\\ns2,u2,pageview,2024-05-02T11:00:00Z\",\"dataFormat\":\"csv\",\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-31\",\"userSegment\":{\"deviceType\":\"mobile\"},\"includeConversionEvents\":false}", + "description": "Analyze CSV session data for May 2024 filtering for mobile device users, excluding conversion events." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Session", + "context": null + } + }, + { + "name": "marketing-automation.analyzeText", + "description": "Analyzes marketing-related text content by extracting sentiment, key topics, and marketing tone to improve campaign effectiveness. Accepts raw text input and optional parameters for analysis depth and language. Outputs structured insights including sentiment score, dominant topics, and tone classification.", + "category": "marketing-automation", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The marketing text content to analyze for sentiment, topics, and tone.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "ISO code of the text language (e.g., 'en' for English). Helps improve accuracy of analysis.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to include sentiment analysis in the result.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeTopics", + "type": "boolean", + "description": "Whether to extract key topics from the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeTone", + "type": "boolean", + "description": "Whether to classify the marketing tone of the text (e.g., persuasive, informative).", + "required": false, + "defaultValue": "true" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of analysis detail: 'basic', 'detailed', or 'comprehensive'. Higher levels provide more insights but take longer.", + "required": false, + "defaultValue": "basic" + } + ], + "returns": { + "type": "object", + "description": "Structured analysis result including sentiment score (-1 to 1), array of key topics with confidence scores, and marketing tone classification." + }, + "aiAgent": { + "useCase": "Use this tool when needing to analyze marketing content to understand audience engagement factors such as sentiment, topical relevance, and tone style. This aids in optimizing copywriting, targeting, and campaign strategies by providing actionable insights from raw text data.", + "limitations": "Does not analyze images or multimedia content; sentiment and tone detection accuracy may vary based on language and input quality; not a substitute for human nuanced review.", + "examples": [ + "Analyze the sentiment and key topics of this new product launch email copy.", + "Determine the marketing tone of this social media ad text and identify main themes.", + "Provide a detailed analysis of customer feedback text to identify sentiment and trending topics." + ] + }, + "tags": [ + "text-analysis", + "marketing", + "sentiment", + "topic-extraction", + "tone-detection", + "content-optimization" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"Introducing our latest eco-friendly water bottle that keeps your drinks cold for 24 hours! Perfect for active lifestyles.\",\"language\":\"en\",\"includeSentiment\":true,\"includeTopics\":true,\"includeTone\":true,\"analysisDepth\":\"basic\"}", + "description": "Analyze a product promotion text for sentiment, topics, and tone." + }, + { + "inputJson": "{\"textContent\":\"Don't miss out on our summer sale! Up to 50% off on select items.\",\"includeSentiment\":true,\"includeTopics\":true,\"includeTone\":true,\"analysisDepth\":\"detailed\"}", + "description": "Analyze a promotional sale announcement with detailed insights." + }, + { + "inputJson": "{\"textContent\":\"Customer reviews show great satisfaction but some concerns about delivery times.\",\"language\":\"en\",\"includeSentiment\":true,\"includeTopics\":true,\"includeTone\":false,\"analysisDepth\":\"comprehensive\"}", + "description": "Analyze customer feedback to understand sentiment and key issues, ignoring tone." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Text", + "context": null + } + }, + { + "name": "marketing-automation.analyzeHeading", + "description": "This tool analyzes the effectiveness of marketing campaign headings by evaluating input heading text based on clarity, emotional impact, keyword presence, and length. Given a heading string, it returns a detailed analysis including scores and improvement suggestions to optimize engagement and conversion rates.", + "category": "marketing-automation", + "parameters": [ + { + "name": "headingText", + "type": "string", + "description": "The marketing campaign heading text to analyze for effectiveness.", + "required": true, + "defaultValue": "" + }, + { + "name": "focusKeywords", + "type": "array", + "description": "An array of keywords the heading should ideally include to improve relevance and SEO.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum desired length of the heading in characters to evaluate conciseness.", + "required": false, + "defaultValue": "60" + }, + { + "name": "analyzeEmotionalTone", + "type": "boolean", + "description": "Whether to analyze the emotional tone of the heading to assess impact.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing clarity score, emotional tone score, keyword presence report, length evaluation, and actionable suggestions for improving the heading." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate and improve marketing campaign headings to ensure they effectively attract attention, include important keywords, maintain ideal length, and evoke desired emotional responses, thereby optimizing click-through and conversion rates.", + "limitations": "This tool does not generate new headings or rewrite content; it only analyzes provided headings. It does not evaluate other campaign elements like images or overall strategy.", + "examples": [ + "Analyze the effectiveness of a campaign heading for email marketing.", + "Check keyword presence and length in a promotional banner heading.", + "Evaluate emotional impact of a landing page headline." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "heading", + "SEO", + "content-optimization", + "campaign" + ], + "examples": [ + { + "inputJson": "{\"headingText\":\"Unlock Your Best Summer Deals Today!\",\"focusKeywords\":[\"summer\",\"deals\"],\"maxLength\":50,\"analyzeEmotionalTone\":true}", + "description": "Analyze a promotional heading with specific focus keywords and standard max length." + }, + { + "inputJson": "{\"headingText\":\"Discover the Future of Sustainable Tech\",\"focusKeywords\":[\"sustainable\",\"tech\",\"future\"],\"maxLength\":60,\"analyzeEmotionalTone\":false}", + "description": "Evaluate a tech product heading focusing on keyword inclusion without emotional tone analysis." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Heading", + "context": null + } + }, + { + "name": "marketing-automation.analyzeWord", + "description": "Analyzes a given word or phrase to determine its marketing effectiveness based on sentiment, emotional impact, relevance to target audience, and potential for engagement. Accepts a word or phrase string and optional context parameters, then outputs a detailed analysis including sentiment score, keyword strength, and recommendations for usage in campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "word", + "type": "string", + "description": "The word or short phrase to analyze for marketing effectiveness.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en' for English) of the word for accurate sentiment and relevance analysis.", + "required": false, + "defaultValue": "en" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description or category of the target audience to tailor analysis for relevance (e.g., 'millennials', 'tech professionals').", + "required": false, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "Optional context where the word will be used (e.g., 'email subject line', 'social media ad') to fine-tune recommendations.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCompetitorComparison", + "type": "boolean", + "description": "If true, compares word effectiveness against competitor campaign word usage trends.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Analysis object containing sentiment score (-1 to 1), emotional impact summary, keyword strength score, relevance to target audience rating, usage recommendations, and optional competitor comparison insights." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the impact and suitability of a specific word or phrase in a marketing context. It helps optimize word choices for campaign messaging by providing data-driven insight on sentiment, emotional appeal, and audience relevance, boosting engagement potential.", + "limitations": "This tool does not generate new words or phrases, nor does it analyze complete texts or long documents. Sentiment and relevance scoring rely on language and context provided, so incomplete context may reduce accuracy.", + "examples": [ + "Analyze the word 'innovative' for a campaign targeting tech professionals.", + "Evaluate the phrase 'limited time offer' for an email subject line targeting young adults.", + "Check the sentiment and emotional impact of the word 'luxury' compared to competitor usage." + ] + }, + "tags": [ + "marketing", + "analysis", + "word", + "sentiment", + "engagement", + "campaign", + "optimization" + ], + "examples": [ + { + "inputJson": "{\"word\":\"innovative\",\"language\":\"en\",\"targetAudience\":\"tech professionals\",\"context\":\"email subject line\",\"includeCompetitorComparison\":true}", + "description": "Analyze the word 'innovative' for its marketing effectiveness targeting tech professionals in an email subject line with competitor usage comparison." + }, + { + "inputJson": "{\"word\":\"limited time offer\",\"language\":\"en\",\"targetAudience\":\"young adults\",\"context\":\"social media ad\",\"includeCompetitorComparison\":false}", + "description": "Evaluate the phrase 'limited time offer' for relevance and emotional impact in a social media ad targeting young adults." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Word", + "context": null + } + }, + { + "name": "marketing-automation.analyzeSentence", + "description": "Analyzes a marketing sentence by performing sentiment analysis, detecting key marketing themes, and evaluating emotional impact. Accepts a single text sentence input and returns sentiment scores, identified themes (e.g., urgency, exclusivity, trust), and emotional tone to help optimize marketing messages for target audiences.", + "category": "marketing-automation", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The marketing sentence text to analyze for sentiment and themes.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the sentence for analysis model selection.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeEmotionAnalysis", + "type": "boolean", + "description": "Whether to analyze and return emotional tone scores.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing sentiment polarity, detected marketing themes, and emotional tone scores relevant to marketing impact." + }, + "aiAgent": { + "useCase": "Use this tool when needing to evaluate the effectiveness and emotional appeal of marketing sentences. It helps identify how positive, negative, or neutral a message is, what marketing themes are emphasized, and the emotional tone it conveys, aiding in optimizing copy for campaigns.", + "limitations": "Cannot replace comprehensive campaign strategy analysis; limited to single sentences and does not assess entire campaign context or audience segmentation.", + "examples": [ + "Analyze the sentiment and themes in this sentence: 'Limited time offer! Save big today.'", + "Determine if the sentence 'Our product is trusted by millions worldwide.' conveys trust and positivity.", + "Check emotional tones in the phrase 'Hurry, only a few spots left!'" + ] + }, + "tags": [ + "marketing", + "analysis", + "sentiment", + "emotion", + "copywriting", + "messageOptimization" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\"Exclusive deal just for you! Act now before it's gone.\",\"language\":\"en\",\"includeEmotionAnalysis\":true}", + "description": "Analyze an urgent and exclusive marketing sentence for sentiment, themes, and emotional tone." + }, + { + "inputJson": "{\"sentence\":\"Our customers love the reliable quality of our products.\",\"language\":\"en\",\"includeEmotionAnalysis\":true}", + "description": "Evaluate the trustworthiness and positivity in a customer trust-related marketing sentence." + }, + { + "inputJson": "{\"sentence\":\"Don't miss out on savings this weekend only!\",\"language\":\"en\",\"includeEmotionAnalysis\":false}", + "description": "Analyze the sentiment and marketing themes without emotional tone analysis in a sales urgency sentence." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Sentence", + "context": null + } + }, + { + "name": "marketing-automation.analyzeAnomaly", + "description": "Analyzes marketing campaign performance data to detect anomalies in key metrics such as click-through rates, conversion rates, or engagement over a specified period. Accepts time-series data, applies statistical and machine learning models to identify unusual patterns or deviations, and outputs detailed anomaly reports with timestamps, impacted metrics, and severity scores.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignId", + "type": "string", + "description": "Unique identifier of the marketing campaign to analyze", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of metric names to analyze for anomalies, e.g., ['clickThroughRate','conversionRate']", + "required": true, + "defaultValue": "[]" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 formatted start date of analysis period", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 formatted end date of analysis period", + "required": true, + "defaultValue": "" + }, + { + "name": "sensitivity", + "type": "number", + "description": "Threshold sensitivity for anomaly detection (0 to 1), higher means more anomalies detected", + "required": false, + "defaultValue": "0.8" + }, + { + "name": "aggregateBy", + "type": "string", + "description": "Granularity of data aggregation, e.g., 'daily', 'hourly', or 'weekly'", + "required": false, + "defaultValue": "daily" + } + ], + "returns": { + "type": "object", + "description": "An object containing a list of detected anomalies, each with metric name, timestamp, anomaly score, and description of the anomaly." + }, + "aiAgent": { + "useCase": "Use this tool when monitoring marketing campaign analytics to automatically identify abnormal behavior or unexpected changes in key performance indicators. Ideal for early detection of potential issues or opportunities needing attention in campaigns, saving manual analysis time and improving responsiveness.", + "limitations": "Cannot explain root causes of anomalies or directly modify campaigns. Requires sufficient and clean time-series data. May produce false positives if data is noisy or incomplete.", + "examples": [ + "Find anomalies in click-through rate and conversion rate for campaign XYZ from Jan 1 to Jan 31.", + "Analyze daily engagement and bounce rate metrics for campaign ABC over the last two weeks with high sensitivity.", + "Identify unusual spikes or drops in weekly conversion rates for campaign 1234 between March 1 and March 31." + ] + }, + "tags": [ + "marketing", + "analytics", + "anomaly-detection", + "campaign-monitoring", + "time-series", + "automation" + ], + "examples": [ + { + "inputJson": "{\"campaignId\":\"cmp12345\",\"metrics\":[\"clickThroughRate\",\"conversionRate\"],\"startDate\":\"2024-04-01T00:00:00Z\",\"endDate\":\"2024-04-30T23:59:59Z\",\"sensitivity\":0.85,\"aggregateBy\":\"daily\"}", + "description": "Detect anomalies in daily click-through and conversion rates for April 2024 for campaign cmp12345 with high sensitivity." + }, + { + "inputJson": "{\"campaignId\":\"spring_sale_2024\",\"metrics\":[\"engagement\",\"bounceRate\"],\"startDate\":\"2024-03-15T00:00:00Z\",\"endDate\":\"2024-04-15T23:59:59Z\",\"sensitivity\":0.7,\"aggregateBy\":\"hourly\"}", + "description": "Analyze hourly engagement and bounce rate metrics for the Spring Sale 2024 campaign for one month with moderate sensitivity." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Anomaly", + "context": null + } + }, + { + "name": "marketing-automation.analyzeParagraph", + "description": "Analyzes a given marketing text paragraph to evaluate sentiment, extract key marketing keywords, and assess tone and engagement potential. Accepts textual input and returns structured analysis useful for refining marketing messages.", + "category": "marketing-automation", + "parameters": [ + { + "name": "paragraphText", + "type": "string", + "description": "The marketing paragraph text to analyze for sentiment, keywords, and tone.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text (e.g., 'en' for English) to tailor analysis accordingly.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "extractKeywords", + "type": "boolean", + "description": "Whether to extract key marketing keywords from the paragraph text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "analyzeSentiment", + "type": "boolean", + "description": "Whether to perform sentiment analysis on the paragraph text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "analyzeTone", + "type": "boolean", + "description": "Whether to analyze tone and engagement potential of the paragraph text.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing sentiment score (e.g., positive, neutral, negative), list of extracted marketing keywords, tone classification (e.g., persuasive, informative), and an engagement potential score." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate and improve marketing content by understanding sentiment, identifying impactful keywords, and assessing overall tone to optimize messaging effectiveness in campaigns.", + "limitations": "Does not generate new marketing content or provide in-depth industry-specific keyword suggestions. Analysis accuracy depends on input text clarity and language support.", + "examples": [ + "Analyze the sentiment and keywords in this product promotion paragraph.", + "Evaluate the tone and engagement potential of a campaign's introductory text.", + "Extract marketing keywords from a newsletter paragraph to optimize SEO." + ] + }, + "tags": [ + "marketing", + "analysis", + "sentiment", + "keywords", + "tone", + "engagement", + "content-evaluation" + ], + "examples": [ + { + "inputJson": "{\"paragraphText\":\"Our new smartwatch offers advanced health tracking features that keep you motivated and connected all day.\",\"language\":\"en\",\"extractKeywords\":true,\"analyzeSentiment\":true,\"analyzeTone\":true", + "description": "Analyze a product promotion paragraph for sentiment, keywords, and tone." + }, + { + "inputJson": "{\"paragraphText\":\"Don't miss out on our exclusive summer sale with discounts up to 50%! Shop now and save big.\",\"extractKeywords\":true,\"analyzeSentiment\":true}", + "description": "Evaluate a promotional sale paragraph extracting keywords and sentiment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Paragraph", + "context": null + } + }, + { + "name": "marketing-automation.analyzeConversion", + "description": "Analyzes marketing campaign conversion data by processing input metrics such as visits, leads, and sales over time. It calculates conversion rates, identifies trends and bottlenecks, and generates summary statistics and insights to optimize campaign performance.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the marketing campaign to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date of the analysis period in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date of the analysis period in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "conversionStages", + "type": "array", + "description": "Ordered list of conversion funnel stages to consider (e.g., ['visit','lead','sale']).", + "required": false, + "defaultValue": "[\"visit\",\"lead\",\"sale\"]" + }, + { + "name": "metrics", + "type": "array", + "description": "Specific metrics to analyze (e.g., ['conversionRate','dropOffRate']).", + "required": false, + "defaultValue": "[\"conversionRate\"]" + } + ], + "returns": { + "type": "object", + "description": "Structured report including overall conversion rates per stage, time series trend data, bottleneck identification, and actionable recommendations." + }, + "aiAgent": { + "useCase": "Use this tool to quantitatively evaluate the effectiveness of marketing campaigns by analyzing conversion data across defined funnel stages over a selectable time period. Helpful for marketing analysts and automation agents aiming to optimize lead generation and sales outcomes by identifying strengths and weaknesses in the conversion process.", + "limitations": "This tool does not directly access raw campaign data or real-time feeds; it requires pre-collected and structured data input associated with campaignId. It also does not perform campaign setup or media buying optimization.", + "examples": [ + "Analyze conversion performance for campaign ID 'cmp123' during the last quarter.", + "Provide trend insights and bottleneck detection on leads to sales conversion for campaign 'cmp456' between 2024-01-01 and 2024-03-31.", + "Calculate overall conversion rates and identify stages with highest drop-off for campaign 'springLaunch2024'." + ] + }, + "tags": [ + "marketing", + "analytics", + "conversion", + "automation", + "campaign" + ], + "examples": [ + { + "inputJson": "{\"campaignId\":\"cmp123\",\"startDate\":\"2024-01-01\",\"endDate\":\"2024-03-31\",\"conversionStages\":[\"visit\",\"lead\",\"sale\"],\"metrics\":[\"conversionRate\",\"dropOffRate\"]}", + "description": "Analyze conversion rates and drop-off across visit-lead-sale funnel for campaign cmp123 in Q1 2024." + }, + { + "inputJson": "{\"campaignId\":\"launch2024\",\"metrics\":[\"conversionRate\"]}", + "description": "Calculate overall conversion rates for campaign launch2024 using default date range and funnel stages." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Conversion", + "context": null + } + }, + { + "name": "marketing-automation.analyzeEvent", + "description": "Analyzes marketing event data such as campaign interactions or customer engagement events. Accepts event logs or structured event data, performs aggregation and statistical insights (e.g., event frequency, conversion rates, attendee behavior patterns), and outputs a detailed analysis report highlighting key metrics and trends relevant for marketing optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "eventData", + "type": "array", + "description": "Array of event objects containing event details such as type, timestamp, user attributes, and metadata for analysis", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 formatted start date to filter events (inclusive). If omitted, includes all events prior.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 formatted end date to filter events (inclusive). If omitted, includes all events after startDate.", + "required": false, + "defaultValue": "" + }, + { + "name": "eventTypes", + "type": "array", + "description": "List of event types to include in analysis. If empty or omitted, analyzes all event types.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "groupBy", + "type": "string", + "description": "Dimension to group analysis by, such as 'eventType', 'userSegment', or 'campaignId'. If empty, no grouping applied.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeConversionRate", + "type": "boolean", + "description": "Whether to compute conversion rates based on specified conversion event types.", + "required": false, + "defaultValue": "true" + }, + { + "name": "conversionEventTypes", + "type": "array", + "description": "List of event types considered as conversions, used if includeConversionRate is true.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing aggregated event metrics, including counts, frequencies, conversion rates, and time-based trends grouped by specified dimensions if provided." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to understand marketing event data to extract insights about user engagement, campaign performance, event distribution over time, and conversion effectiveness. Ideal for generating reports or feeding downstream automation with summarized metrics from raw event logs.", + "limitations": "This tool cannot perform raw data cleaning or anomaly detection beyond basic filtering. It relies on well-structured event data with consistent fields. Complex predictive modeling or causal inference is outside its scope.", + "examples": [ + "Analyze event data from last quarter for types 'click' and 'impression' grouped by campaignId.", + "Compute conversion rates for user signup events from marketing events collected in the past month.", + "Summarize attendee interactions by user segment for an event marketing campaign period." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "event-analysis", + "conversion", + "reporting", + "campaign", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"eventData\":[{\"eventType\":\"click\",\"timestamp\":\"2024-04-10T12:34:56Z\",\"userId\":\"u123\",\"campaignId\":\"camp1\"},{\"eventType\":\"impression\",\"timestamp\":\"2024-04-10T12:35:10Z\",\"userId\":\"u124\",\"campaignId\":\"camp1\"},{\"eventType\":\"click\",\"timestamp\":\"2024-04-11T08:22:00Z\",\"userId\":\"u125\",\"campaignId\":\"camp2\"}],\"startDate\":\"2024-04-01T00:00:00Z\",\"endDate\":\"2024-04-30T23:59:59Z\",\"eventTypes\":[\"click\",\"impression\"],\"groupBy\":\"campaignId\",\"includeConversionRate\":true,\"conversionEventTypes\":[\"click\"]}", + "description": "Analyze clicks and impressions for April 2024 grouped by campaign ID, including conversion rate for click events." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Event", + "context": null + } + }, + { + "name": "marketing-automation.analyzeTrend", + "description": "Analyzes marketing data trends over time by accepting campaign performance metrics or social media data, applies statistical methods and trend detection algorithms, and outputs detailed insights about trend direction, strength, anomalies, and predictions for future performance.", + "category": "marketing-automation", + "parameters": [ + { + "name": "dataSource", + "type": "string", + "description": "Type of input data (e.g., 'socialMedia', 'emailCampaign', 'adPerformance').", + "required": true, + "defaultValue": "" + }, + { + "name": "timeRange", + "type": "object", + "description": "Object specifying 'startDate' and 'endDate' (ISO strings) to define the analysis period.", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of performance metric names to analyze (e.g., ['clicks','impressions','engagementRate']).", + "required": true, + "defaultValue": "" + }, + { + "name": "aggregationInterval", + "type": "string", + "description": "Interval for data aggregation ('daily', 'weekly', 'monthly').", + "required": false, + "defaultValue": "daily" + }, + { + "name": "trendDetectionMethod", + "type": "string", + "description": "Statistical method to detect trends ('linearRegression', 'movingAverage', 'seasonalDecompose').", + "required": false, + "defaultValue": "linearRegression" + }, + { + "name": "includeForecast", + "type": "boolean", + "description": "Whether to include future trend forecasts based on historical data.", + "required": false, + "defaultValue": "false" + }, + { + "name": "forecastHorizon", + "type": "number", + "description": "Number of future periods to forecast if includeForecast is true.", + "required": false, + "defaultValue": "7" + } + ], + "returns": { + "type": "object", + "description": "An object containing identified trends for each metric including trend direction ('up', 'down', 'stable'), strength (numeric score), detected anomalies with timestamps, and optional forecast values with confidence intervals." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing marketing campaign data or social media metrics over time to detect and understand underlying trends, evaluate campaign effectiveness, and anticipate future performance. It helps automate data-driven marketing strategy adjustments.", + "limitations": "Does not perform data cleansing or integrate raw data from external sources. Accuracy depends on quality and consistency of the input data. It supports pre-defined trend detection methods but not custom algorithms.", + "examples": [ + "Analyze trending engagement rate in social media campaigns over the past quarter.", + "Identify anomalies in email marketing click rates during last 3 months.", + "Forecast impressions trends for weekly online ads for next 2 weeks." + ] + }, + "tags": [ + "marketing", + "analytics", + "trend analysis", + "campaign performance", + "forecasting", + "time series" + ], + "examples": [ + { + "inputJson": "{\"dataSource\":\"socialMedia\",\"timeRange\":{\"startDate\":\"2023-01-01\",\"endDate\":\"2023-03-31\"},\"metrics\":[\"engagementRate\",\"reach\"],\"aggregationInterval\":\"weekly\",\"trendDetectionMethod\":\"movingAverage\",\"includeForecast\":true,\"forecastHorizon\":4}", + "description": "Analyze weekly engagement rate and reach trends from social media campaigns in Q1 2023 and forecast next month." + }, + { + "inputJson": "{\"dataSource\":\"emailCampaign\",\"timeRange\":{\"startDate\":\"2023-02-01\",\"endDate\":\"2023-04-30\"},\"metrics\":[\"clicks\",\"openRate\"],\"aggregationInterval\":\"daily\",\"trendDetectionMethod\":\"linearRegression\",\"includeForecast\":false}", + "description": "Daily trend analysis on clicks and open rates of email campaigns from Feb to April 2023 with no forecast." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Trend", + "context": null + } + }, + { + "name": "marketing-automation.analyzeDashboard", + "description": "Analyzes marketing campaign dashboards by ingesting raw performance data and configuration options to produce summarized insights, trend analyses, and KPI evaluations. The tool accepts campaign metrics and dashboard settings, performs data aggregation, comparison against goals, and outputs a structured report highlighting key findings.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignData", + "type": "object", + "description": "Raw marketing campaign data including metrics like impressions, clicks, conversions over time.", + "required": true, + "defaultValue": "" + }, + { + "name": "dashboardConfig", + "type": "object", + "description": "Configuration settings of the dashboard such as selected KPIs, date ranges, and segmentation filters.", + "required": true, + "defaultValue": "" + }, + { + "name": "comparePeriod", + "type": "string", + "description": "Optional parameter specifying a previous period (e.g., 'last_month') to compare against for trend analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the analysis output report; supports 'summary' or 'detailed'.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Flag to include automated marketing improvement recommendations based on analysis.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Structured analysis report containing aggregated metrics, trend insights, KPI evaluations, and optionally improvement recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when needing to assess the performance and effectiveness of marketing campaigns through their dashboards. It helps in understanding metric trends, comparing periods, and extracting actionable insights for marketing optimization.", + "limitations": "Does not connect to live data sources or fetch raw data automatically; requires pre-provided campaign data. Does not perform creative or qualitative content analysis.", + "examples": [ + "Analyze last quarter's Facebook ad campaign dashboard with focus on conversion rate and ROAS.", + "Generate a detailed analysis report comparing current and previous month campaign KPIs.", + "Provide marketing optimization recommendations based on email campaign dashboard data." + ] + }, + "tags": [ + "marketing", + "analytics", + "dashboard", + "campaign-analysis", + "KPI", + "reporting", + "automation" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":{\"impressions\":50000,\"clicks\":1200,\"conversions\":150,\"revenue\":4500,\"dateRange\":\"2024-01-01 to 2024-03-31\"},\"dashboardConfig\":{\"selectedKPIs\":[\"CTR\",\"ConversionRate\",\"ROAS\"],\"dateRange\":\"2024-01-01 to 2024-03-31\",\"segments\":[\"age:25-34\",\"device:mobile\"]},\"comparePeriod\":\"last_quarter\",\"outputFormat\":\"summary\",\"includeRecommendations\":true}", + "description": "Summarize Q1 campaign performance with comparison to previous quarter and generate high-level recommendations." + }, + { + "inputJson": "{\"campaignData\":{\"emailOpens\":2000,\"emailClicks\":400,\"subscriptions\":50,\"dateRange\":\"2024-05-01 to 2024-05-31\"},\"dashboardConfig\":{\"selectedKPIs\":[\"OpenRate\",\"ClickThroughRate\",\"SubscriptionRate\"],\"dateRange\":\"2024-05-01 to 2024-05-31\"},\"outputFormat\":\"detailed\",\"includeRecommendations\":false}", + "description": "Produce a detailed report on May email campaign KPIs without recommendations." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Dashboard", + "context": null + } + }, + { + "name": "marketing-automation.analyzeKPI", + "description": "Analyzes marketing KPIs by accepting structured campaign data and performance metrics, calculating key indicators such as conversion rates, ROI, click-through rates, and engagement statistics. It outputs a summarized report highlighting KPI trends, benchmarks, and actionable insights for campaign optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignData", + "type": "array", + "description": "Array of objects representing campaign performance metrics over time (e.g., impressions, clicks, conversions).", + "required": true, + "defaultValue": "" + }, + { + "name": "kpisToAnalyze", + "type": "array", + "description": "List of KPI names to analyze such as 'conversionRate', 'roi', 'clickThroughRate'. If empty, analyzes all available KPIs.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeFrameStart", + "type": "string", + "description": "Start date (ISO 8601) for the time frame of KPI analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeFrameEnd", + "type": "string", + "description": "End date (ISO 8601) for the time frame of KPI analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "benchmarkValues", + "type": "object", + "description": "Optional object providing benchmark values for KPIs to compare performance against industry or historical standards.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "includeTrends", + "type": "boolean", + "description": "Flag indicating whether to include trend analysis over the specified time frame.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object summarizing each KPI with current values, trend direction, deviation from benchmarks, and actionable insights for marketing campaign improvements." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the effectiveness of marketing campaigns by analyzing key performance indicators extracted from raw campaign data. It's useful for generating detailed reports that assist in decision-making for campaign adjustments and budget allocation.", + "limitations": "This tool does not collect raw data from external sources; input data must be preprocessed and accurately structured. It also does not predict future KPI values beyond identifying trends from historical data.", + "examples": [ + "Analyze KPIs for the last quarter to see how our paid ads performed compared to industry benchmarks.", + "Generate a KPI analysis report from campaign data including conversion rates and ROI for multiple campaigns.", + "Provide trends and insights about click-through rates and engagement metrics from recent marketing emails." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "KPI", + "campaign analysis", + "performance", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":[{\"date\":\"2024-04-01\",\"impressions\":10000,\"clicks\":500,\"conversions\":50,\"revenue\":2500}],\"kpisToAnalyze\":[\"conversionRate\",\"roi\"],\"timeFrameStart\":\"2024-04-01\",\"timeFrameEnd\":\"2024-04-30\",\"benchmarkValues\":{\"conversionRate\":0.05,\"roi\":1.5},\"includeTrends\":true}", + "description": "Analyze conversion rate and ROI KPIs for April 2024 campaign data with benchmarks." + }, + { + "inputJson": "{\"campaignData\":[{\"date\":\"2024-05-01\",\"impressions\":15000,\"clicks\":850,\"conversions\":80}],\"kpisToAnalyze\":[],\"timeFrameStart\":\"2024-05-01\",\"timeFrameEnd\":\"2024-05-31\",\"benchmarkValues\":{},\"includeTrends\":false}", + "description": "Analyze all KPIs from May 2024 campaign data without trend analysis or benchmarks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "KPI", + "context": null + } + }, + { + "name": "marketing-automation.analyzeMetric", + "description": "Analyzes marketing campaign metrics by accepting raw metric data and contextual parameters. It processes time-series or aggregate marketing data, performs trend analysis, calculates key performance indicators, and outputs an interpretable summary report with insights and recommendations for campaign optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "metricData", + "type": "array", + "description": "An array of objects representing the raw metric data points to analyze, each with timestamps and values.", + "required": true, + "defaultValue": "" + }, + { + "name": "metricType", + "type": "string", + "description": "A string specifying the type of metric being analyzed (e.g., 'clicks', 'impressions', 'conversions').", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 format start date for the analysis period (e.g., '2024-01-01').", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 format end date for the analysis period (e.g., '2024-01-31').", + "required": false, + "defaultValue": "" + }, + { + "name": "compareToPreviousPeriod", + "type": "boolean", + "description": "Flag indicating whether the tool should compare metrics to the previous period for trend detection.", + "required": false, + "defaultValue": "false" + }, + { + "name": "granularity", + "type": "string", + "description": "Time granularity for analysis such as 'daily', 'weekly', or 'monthly'.", + "required": false, + "defaultValue": "daily" + } + ], + "returns": { + "type": "object", + "description": "A structured report object containing summary statistics, trend analyses, KPI calculations, and actionable insights related to the input marketing metric data." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to understand and provide insights on marketing campaign performance metrics over a given period. It helps convert raw data into actionable analysis, trends, and recommendations for improving campaign effectiveness.", + "limitations": "This tool does not perform raw data collection or cleansing; input data must be preprocessed and formatted correctly. It also does not execute campaign actions or predict future trends beyond trend comparison with past data.", + "examples": [ + "Analyze the daily clicks metric for the last month and compare it to the previous month.", + "Provide a summary and insights for conversions from a recent campaign dataset.", + "Generate trend analysis of weekly impressions over the past quarter." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "metrics", + "campaign", + "performance", + "trend-analysis" + ], + "examples": [ + { + "inputJson": "{\"metricData\":[{\"timestamp\":\"2024-04-01T00:00:00Z\",\"value\":120},{\"timestamp\":\"2024-04-02T00:00:00Z\",\"value\":150}],\"metricType\":\"clicks\",\"startDate\":\"2024-04-01\",\"endDate\":\"2024-04-07\",\"compareToPreviousPeriod\":true,\"granularity\":\"daily\"}", + "description": "Daily clicks data for the first week of April 2024 with comparison to the previous week." + }, + { + "inputJson": "{\"metricData\":[{\"timestamp\":\"2024-03-01T00:00:00Z\",\"value\":5000},{\"timestamp\":\"2024-03-31T00:00:00Z\",\"value\":7200}],\"metricType\":\"impressions\",\"startDate\":\"2024-03-01\",\"endDate\":\"2024-03-31\",\"compareToPreviousPeriod\":false,\"granularity\":\"monthly\"}", + "description": "Monthly impressions metric for March 2024 without comparison." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Metric", + "context": null + } + }, + { + "name": "marketing-automation.analyzeMention", + "description": "Analyzes brand or product mentions from provided communication text or social media data. Accepts raw text or structured mention data, extracts sentiment, key topics, and mention frequency, then outputs a detailed analysis report highlighting positive, negative, or neutral sentiment trends and key influencer impact.", + "category": "marketing-automation", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "Raw text or communication content containing mentions to analyze, can be social media posts, reviews, or comments.", + "required": false, + "defaultValue": "" + }, + { + "name": "mentionData", + "type": "array", + "description": "Structured array of mention objects including text, author, timestamp fields to analyze for sentiment and trends.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') to guide sentiment analysis and keyword extraction.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "dateRange", + "type": "object", + "description": "Optional date range filter with 'startDate' and 'endDate' (ISO 8601 strings) to limit analysis to mentions in this period.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeNeutral", + "type": "boolean", + "description": "Whether to include neutral sentiment mentions in the analysis output. Defaults to false to focus on polarized opinions.", + "required": false, + "defaultValue": "false" + }, + { + "name": "topInfluencerCount", + "type": "number", + "description": "Number of top influencers to identify based on mention impact or reach, default is 5.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "A comprehensive analysis report including total mention counts, sentiment breakdown (positive, negative, neutral), key topics extracted from mentions, and a ranked list of top influencers with their mention metrics." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to interpret raw text or structured mentions data to provide sentiment insights, identify trending topics related to a brand or product, and highlight influential mention sources, useful for marketing performance evaluation or campaign adjustment.", + "limitations": "Cannot access live social media data; must be provided with text or mention data. Sentiment analysis quality depends on language support and text clarity. Does not detect sarcastic or highly nuanced mentions reliably.", + "examples": [ + "Analyze sentiment and influencer impact from a list of social media mentions over the last month.", + "Extract key topics and mention trends from raw customer review texts in English.", + "Provide a sentiment breakdown including neutral for brand feedback comments within a custom date range." + ] + }, + "tags": [ + "marketing", + "sentiment-analysis", + "brand-monitoring", + "influencer-analysis", + "text-analysis", + "social-listening" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"I love the new product update! Great job team, but the pricing could be better.\",\"language\":\"en\",\"includeNeutral\":false}", + "description": "Analyze single input text for sentiment and topic extraction in English, excluding neutral sentiment." + }, + { + "inputJson": "{\"mentionData\":[{\"text\":\"The app keeps crashing, very frustrating.\",\"author\":\"user123\",\"timestamp\":\"2024-05-15T10:00:00Z\"},{\"text\":\"Amazing user experience and fantastic support!\",\"author\":\"influencerX\",\"timestamp\":\"2024-05-16T12:30:00Z\"}],\"language\":\"en\",\"includeNeutral\":false,\"topInfluencerCount\":3}", + "description": "Analyze structured mention data containing positive and negative user feedback, identify sentiment and top influencers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Mention", + "context": null + } + }, + { + "name": "marketing-automation.analyzeComment", + "description": "Analyzes customer comments or feedback from marketing channels to extract sentiment, detect key topics, and provide engagement metrics. Accepts raw comment text or an array of comments, processes them using natural language processing to identify positive, negative, or neutral sentiment, extracts main themes or keywords, and returns a structured summary report with insights for marketing optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "comments", + "type": "array", + "description": "An array of comment strings or feedback texts to analyze for sentiment and topics.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code of the comments to improve accuracy (e.g., 'en' for English).", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "includeSentimentScores", + "type": "boolean", + "description": "Whether to include detailed sentiment scores for each comment in the output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "extractKeywordsCount", + "type": "number", + "description": "Number of top keywords or topics to extract from the comments.", + "required": false, + "defaultValue": "5" + }, + { + "name": "minCommentLength", + "type": "number", + "description": "Minimum character length of comments to consider in the analysis, filtering out shorter texts.", + "required": false, + "defaultValue": "10" + } + ], + "returns": { + "type": "object", + "description": "An object containing overall sentiment summary, keyword topics with relevance scores, counts of positive/negative/neutral comments, and optional detailed sentiment scores per comment if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly gain insights from customer comments or feedback collected through marketing campaigns, social media, or surveys. It helps evaluate public opinion, spot emerging topics, and measure engagement tone to support data-driven marketing decisions.", + "limitations": "The tool cannot replace in-depth human qualitative analysis and may not accurately analyze sarcasm, irony, or complex emotional nuances. It relies on textual data and lacks contextual understanding beyond the comments provided.", + "examples": [ + "Analyze recent social media comments to summarize customer sentiment about a new product launch.", + "Extract key topics and sentiment from feedback collected in a user survey.", + "Generate a report summarizing positive, neutral, and negative comments about a marketing campaign." + ] + }, + "tags": [ + "marketing", + "automation", + "sentiment-analysis", + "feedback", + "comments", + "NLP", + "customer-insights" + ], + "examples": [ + { + "inputJson": "{\"comments\":[\"I love the new features you introduced! Very helpful.\",\"The product is okay, but could use improvement.\",\"Terrible experience, I am very disappointed.\"],\"includeSentimentScores\":true}", + "description": "Analyze mixed sentiment comments from users including detailed sentiment scores." + }, + { + "inputJson": "{\"comments\":[\"Great campaign!\",\"Not impressed with the new update.\",\"Average service.\"],\"extractKeywordsCount\":3}", + "description": "Analyze a small set of comments focusing on extracting top 3 keywords and overall sentiment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Comment", + "context": null + } + }, + { + "name": "marketing-automation.analyzeMessage", + "description": "Analyzes marketing message content provided as plain text, extracting key marketing metrics such as sentiment, call-to-action effectiveness, keyword relevance, and suggested improvements. It accepts message text and optional context parameters, processes linguistic and marketing-focused data, and outputs an analysis report including sentiments, scores, and optimization tips.", + "category": "marketing-automation", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The plain text content of the marketing message to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "Optional context or campaign type related to the message (e.g., email, social media) to tailor analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the message content to improve accuracy of analysis (e.g., 'en' for English).", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "includeSuggestions", + "type": "boolean", + "description": "Whether to include writing and call-to-action improvement suggestions in the output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing sentiment analysis (positive, neutral, negative scores), keyword relevance score, call-to-action effectiveness score, and optionally recommendations for message improvement." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the effectiveness and tone of a marketing message before deployment. It helps in understanding sentiment, key marketing metrics, and provides optimization suggestions to improve engagement and conversion rates.", + "limitations": "This tool analyzes text content only; it does not evaluate visual assets or full campaign performance. Sentiment and effectiveness scores are estimations and may require human review in nuance-sensitive contexts.", + "examples": [ + "Analyze my new email campaign message to understand its positivity and call-to-action strength.", + "Evaluate the social media post text for marketing impact and get suggestions for improvement.", + "Check the language tone and keyword relevance of our SMS marketing message." + ] + }, + "tags": [ + "marketing", + "analysis", + "automation", + "message", + "sentiment", + "call-to-action", + "optimization" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"Don't miss out on our exclusive 50% off sale! Shop now and save big.\",\"context\":\"email\",\"language\":\"en\",\"includeSuggestions\":true}", + "description": "Analyzing an email message promoting a sale for sentiment, call-to-action effectiveness, and improvement tips." + }, + { + "inputJson": "{\"messageText\":\"Join our webinar to learn the secrets of digital marketing success.\",\"context\":\"social media\",\"language\":\"en\",\"includeSuggestions\":true}", + "description": "Analyzing a social media post promoting a webinar to assess message impact and suggestions for enhancement." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "marketing-automation.analyzeThread", + "description": "Analyzes a marketing communication thread such as an email chain or chat conversation. Accepts thread data including messages and metadata, processes sentiment, engagement metrics, key topics, and response delays, and returns a structured report outlining thread effectiveness and communication insights.", + "category": "marketing-automation", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Unique identifier for the communication thread to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "messages", + "type": "array", + "description": "Array of message objects within the thread, each containing sender, timestamp, and content fields.", + "required": false, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Optional ISO date string to filter messages starting from this date.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "Optional ISO date string to filter messages up to this date.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSentimentAnalysis", + "type": "boolean", + "description": "Flag to enable sentiment analysis on each message. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeEngagementMetrics", + "type": "boolean", + "description": "Flag to include engagement metrics such as reply rates and delays. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeTopicExtraction", + "type": "boolean", + "description": "Flag to perform key topic and keyword extraction from the thread. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Analysis report object containing sentiment summaries, engagement metrics like response times and rates, key topics discussed, and overall thread effectiveness score." + }, + "aiAgent": { + "useCase": "Use this tool when needing to assess the quality and effectiveness of a marketing communication thread, whether email or chat, to guide campaign adjustments and optimize messaging strategies. Helpful for evaluating customer response behavior and identifying key discussion topics.", + "limitations": "Cannot analyze attachments or multimedia content embedded in the thread; quality depends on completeness and quality of supplied messages data; does not generate new responses or content.", + "examples": [ + "Analyze the email thread with ID 'thread123' to get sentiment and engagement insights.", + "Analyze messages from '2023-04-01' to '2023-04-10' including sentiment analysis.", + "Get a topic summary and response time metrics for marketing chat conversation thread ID 'conv456'." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "communication", + "thread", + "sentiment", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"email-thread-001\",\"includeSentimentAnalysis\":true,\"includeEngagementMetrics\":true,\"includeTopicExtraction\":true}", + "description": "Analyze the marketing email thread with ID 'email-thread-001' for sentiment, engagement, and topics." + }, + { + "inputJson": "{\"threadId\":\"chat-789\",\"messages\":[{\"sender\":\"agent\",\"timestamp\":\"2024-05-01T10:00:00Z\",\"content\":\"Hello! How can I help you today?\"},{\"sender\":\"customer\",\"timestamp\":\"2024-05-01T10:05:00Z\",\"content\":\"I'm interested in your product pricing.\"}],\"includeEngagementMetrics\":false}", + "description": "Analyze a short chat thread with explicit messages provided, skipping engagement metrics." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Thread", + "context": null + } + }, + { + "name": "marketing-automation.analyzeChannel", + "description": "Analyzes marketing communication channel data to assess performance metrics such as engagement, conversion rates, bounce rates, and audience demographics. Accepts input data from email, social media, or messaging platforms and outputs an analytical report summarizing channel effectiveness and recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of communication channel (e.g. email, socialMedia, sms).", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "object", + "description": "Raw interaction data specific to the channel, such as message events, clicks, opens, impressions, or replies.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeRange", + "type": "object", + "description": "Date range for analysis with startDate and endDate in ISO format (e.g. {\"startDate\":\"2024-01-01\",\"endDate\":\"2024-01-31\"}).", + "required": false, + "defaultValue": "" + }, + { + "name": "segmentFilters", + "type": "object", + "description": "Optional segmentation criteria to filter audience subsets (e.g. demographics, geography).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object summarizing key performance indicators like engagement rate, conversion rate, bounce rate, audience demographics, and actionable insights for the specified channel." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate the performance of a marketing communication channel using raw event data to generate insights on engagement, conversion, and audience characteristics, enabling data-driven campaign optimization.", + "limitations": "Does not collect raw data; requires properly formatted input data. Cannot replace human strategic marketing decisions. Limited to structured event data from recognized communication channels.", + "examples": [ + "Analyze the email campaign performance data from last month focusing on open and click rates.", + "Evaluate our social media channel effectiveness for the last quarter segmented by age group.", + "Provide engagement metrics and recommendations for SMS marketing based on text message delivery and response data." + ] + }, + "tags": [ + "marketing", + "automation", + "channelAnalysis", + "campaignPerformance", + "engagement", + "conversion", + "analytics" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"data\":{\"events\":[{\"type\":\"open\",\"timestamp\":\"2024-05-01T10:00:00Z\"},{\"type\":\"click\",\"timestamp\":\"2024-05-01T10:05:00Z\"},{\"type\":\"bounce\",\"timestamp\":\"2024-05-01T10:01:00Z\"}],\"totalSent\":1000},\"timeRange\":{\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-31\"}}", + "description": "Analyze email campaign data from May 2024 to assess open and click rates and identify potential issues like bounces." + }, + { + "inputJson": "{\"channelType\":\"socialMedia\",\"data\":{\"posts\":[{\"impressions\":1000,\"engagements\":150,\"date\":\"2024-04-01\"},{\"impressions\":1200,\"engagements\":200,\"date\":\"2024-04-02\"}]},\"timeRange\":{\"startDate\":\"2024-04-01\",\"endDate\":\"2024-04-30\"},\"segmentFilters\":{\"ageGroup\":\"18-24\"}}", + "description": "Evaluate social media channel engagement metrics for April 2024 filtered by age group 18-24." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Channel", + "context": null + } + }, + { + "name": "marketing-automation.analyzeReply", + "description": "Analyzes customer reply messages from marketing campaigns to extract sentiment, intent, and key feedback points. Accepts textual reply input, performs natural language processing to classify sentiment and intent, and outputs a structured summary including sentiment score, detected intent, and summary keywords.", + "category": "marketing-automation", + "parameters": [ + { + "name": "replyText", + "type": "string", + "description": "The raw text of the customer reply message to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code of the reply text (e.g., 'en' for English) to optimize NLP models.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "includeKeywords", + "type": "boolean", + "description": "Whether to include key extracted keywords in the output summary.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxKeywords", + "type": "number", + "description": "The maximum number of keywords to extract from the reply text.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "Returns an analysis summary object containing sentiment score (range -1 to 1), sentiment label (e.g., positive, negative, neutral), detected intent category, an array of key feedback keywords, and a brief text summary of the reply content." + }, + "aiAgent": { + "useCase": "Use this tool when you need to understand customer reply messages in marketing campaigns, to automatically gauge customer sentiment, infer their intent (e.g., inquiry, complaint, praise), and extract important feedback keywords. It helps in automating response prioritization, customer segmentation, and improving campaign messaging based on actual customer inputs.", + "limitations": "The tool cannot provide deep conversational context beyond the single reply message. Complex sarcasm, idioms, or highly ambiguous texts may reduce accuracy. It also does not perform reply generation or detailed customer profiling beyond the analyzed text.", + "examples": [ + "Analyze a customer's reply to a promotional email to understand if the customer is interested, confused, or dissatisfied.", + "Extract key topics mentioned in customer feedback replies from a recent marketing SMS campaign.", + "Determine the sentiment and intent of replies to a product launch announcement email to prioritize customer support responses." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "sentiment-analysis", + "reply", + "customer-feedback", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"replyText\":\"Thanks for the great deal! I'm very happy with the service.\",\"language\":\"en\",\"includeKeywords\":true,\"maxKeywords\":3}", + "description": "Analyze a positive customer reply expressing satisfaction." + }, + { + "inputJson": "{\"replyText\":\"I didn't understand the offer details, can you clarify?\",\"language\":\"en\",\"includeKeywords\":true,\"maxKeywords\":4}", + "description": "Analyze a customer reply indicating confusion and request for clarification." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Reply", + "context": null + } + }, + { + "name": "marketing-automation.analyzeNotification", + "description": "Analyzes marketing notification campaign data to provide insights on delivery performance, engagement metrics, and audience segmentation. Accepts notification campaign IDs or raw event data, processes metrics like open rates, click rates, and conversions, and outputs a detailed performance report to optimize future campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the notification campaign to analyze.", + "required": false, + "defaultValue": "" + }, + { + "name": "eventData", + "type": "array", + "description": "Raw event data for notifications, including delivery and interaction timestamps and user IDs. Used if campaignId is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date for analysis period in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date for analysis period in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSegmentation", + "type": "boolean", + "description": "Whether to analyze and include audience segmentation insights in the report.", + "required": false, + "defaultValue": "false" + }, + { + "name": "metrics", + "type": "array", + "description": "Specific metrics to analyze, e.g., ['openRate', 'clickThroughRate', 'conversionRate']. Defaults to all key metrics if empty.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing overall metrics, trends over time, audience segment performance, and actionable insights for improving notification campaigns." + }, + "aiAgent": { + "useCase": "Use this tool to evaluate the effectiveness of marketing notification campaigns by examining delivery success, user engagement, and conversion metrics. It helps optimize campaign timing, content, and targeting by revealing performance patterns and segment responses. Ideal when raw events or campaign IDs with date ranges are available.", + "limitations": "Cannot send notifications or modify campaigns; analysis depends on data completeness and quality provided; may not integrate real-time streaming data.", + "examples": [ + "Analyze the past month's push notification campaign with ID 'camp123' to understand engagement trends and segment performance.", + "Evaluate raw event data for a recent email notification blast to extract open and click rates between 2024-01-01 and 2024-01-15.", + "Generate a report focusing on conversion rates and click-through rates for a specified campaign to optimize messaging strategies." + ] + }, + "tags": [ + "marketing", + "notification", + "analytics", + "campaign analysis", + "engagement", + "performance" + ], + "examples": [ + { + "inputJson": "{\"campaignId\":\"camp123\",\"startDate\":\"2024-03-01\",\"endDate\":\"2024-03-31\",\"includeSegmentation\":true}", + "description": "Analyze campaign 'camp123' performance and audience segmentation for March 2024." + }, + { + "inputJson": "{\"eventData\":[{\"userId\":\"u1\",\"event\":\"delivered\",\"timestamp\":\"2024-04-10T10:00:00Z\"},{\"userId\":\"u1\",\"event\":\"opened\",\"timestamp\":\"2024-04-10T10:05:00Z\"},{\"userId\":\"u2\",\"event\":\"delivered\",\"timestamp\":\"2024-04-10T10:00:00Z\"}],\"metrics\":[\"openRate\",\"clickThroughRate\"]}", + "description": "Analyze provided raw notification events focusing on open and click-through rates." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Notification", + "context": null + } + }, + { + "name": "marketing-automation.analyzeAlert", + "description": "Analyzes marketing security alerts by processing alert details such as notification type, message, timestamps, and severity. It evaluates potential threats or suspicious activities affecting marketing campaigns or data, and outputs a structured risk assessment report including threat level, recommended actions, and alert metadata.", + "category": "marketing-automation", + "parameters": [ + { + "name": "alertType", + "type": "string", + "description": "Type of the alert to analyze, e.g., phishing, data breach, suspicious login (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "alertMessage", + "type": "string", + "description": "Detailed message or content of the alert to be analyzed (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "alertTimestamp", + "type": "string", + "description": "ISO 8601 timestamp of when the alert was generated (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Severity level of the alert, e.g., low, medium, high, critical (optional)", + "required": false, + "defaultValue": "medium" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the marketing campaign related to this alert (optional)", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalData", + "type": "object", + "description": "Optional object including any extra data relevant to alert context (optional)", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Analysis report detailing the threat assessment, including threatLevel (low, medium, high, critical), confidence score (0-1), recommended mitigation actions, and processed alert metadata." + }, + "aiAgent": { + "useCase": "This tool helps AI agents automatically analyze and assess security alerts related to marketing systems and campaigns. It is useful when an agent detects or receives marketing-related security notifications and needs to determine risk severity, impact, and next steps for mitigation. It bridges security alert data with marketing operational context for proactive defense.", + "limitations": "The tool cannot prevent attacks or fix security issues directly; it only analyzes alert data and provides recommendations. It may be limited by incomplete or inaccurate input alert information and does not replace full security incident investigations.", + "examples": [ + "Analyze a phishing alert received for a marketing email campaign", + "Assess the risk level of a suspicious login detected on a marketing platform account", + "Generate mitigation guidance from a high severity data breach alert impacting customer data" + ] + }, + "tags": [ + "marketing", + "security", + "alert-analysis", + "threat-assessment", + "automation", + "campaign-protection" + ], + "examples": [ + { + "inputJson": "{\"alertType\":\"phishing\",\"alertMessage\":\"Multiple users reported suspicious link in marketing newsletter\",\"alertTimestamp\":\"2024-05-15T08:30:00Z\",\"severityLevel\":\"high\",\"campaignId\":\"camp12345\",\"additionalData\":{\"detectedUrl\":\"http://malicious.example.com\"}}", + "description": "Analyze a phishing alert reporting suspicious link in a marketing newsletter campaign." + }, + { + "inputJson": "{\"alertType\":\"suspiciousLogin\",\"alertMessage\":\"Unusual login detected from unknown IP in marketing dashboard\",\"alertTimestamp\":\"2024-05-20T13:45:00Z\",\"severityLevel\":\"medium\",\"campaignId\":\"camp67890\"}", + "description": "Evaluate risk of a suspicious login event to marketing platform dashboard." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Alert", + "context": null + } + }, + { + "name": "marketing-automation.analyzeBudget", + "description": "Analyzes a marketing campaign budget by evaluating the allocation across channels, comparing planned versus actual spend, and providing key performance insights such as return on investment and cost efficiency. Accepts detailed budget and spend data as inputs and outputs a structured report with actionable analytics.", + "category": "marketing-automation", + "parameters": [ + { + "name": "plannedBudget", + "type": "object", + "description": "Object mapping marketing channels to their planned budget amounts in USD.", + "required": true, + "defaultValue": "" + }, + { + "name": "actualSpend", + "type": "object", + "description": "Object mapping marketing channels to their actual spend amounts in USD.", + "required": true, + "defaultValue": "" + }, + { + "name": "performanceMetrics", + "type": "object", + "description": "Object mapping marketing channels to their key performance metrics (e.g., leads generated, conversions).", + "required": false, + "defaultValue": "" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Format of the output report, e.g., 'summary' for high-level insights, 'detailed' for granular analysis.", + "required": false, + "defaultValue": "summary" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object summarizing budget allocation, variance between planned and actual spending, performance efficiency metrics such as ROI per channel, and recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate how marketing budgets were utilized across multiple channels, detect overspending or underspending, and correlate spending with performance indicators. It helps in understanding budget efficiency and guiding adjustments for future campaigns.", + "limitations": "This tool does not track real-time spend updates, does not execute budget changes, and relies on accurate input data for meaningful analysis. It cannot replace financial auditing.", + "examples": [ + "Analyze the monthly marketing budget allocation and actual spend for the April campaign.", + "Generate a report comparing planned versus actual spend across channels and evaluate ROI.", + "Provide a detailed analysis of budget underspending and performance for the last quarter." + ] + }, + "tags": [ + "marketing", + "budget analysis", + "campaign performance", + "cost efficiency", + "ROI", + "marketing-automation" + ], + "examples": [ + { + "inputJson": "{\"plannedBudget\":{\"socialMedia\":10000,\"email\":5000,\"searchAds\":15000},\"actualSpend\":{\"socialMedia\":12000,\"email\":4500,\"searchAds\":14000},\"performanceMetrics\":{\"socialMedia\":{\"leads\":250,\"conversions\":35},\"email\":{\"leads\":100,\"conversions\":20},\"searchAds\":{\"leads\":300,\"conversions\":40}},\"reportFormat\":\"summary\"}", + "description": "Summarize the marketing budget spend and performance for social media, email, and search ads with planned and actual amounts." + }, + { + "inputJson": "{\"plannedBudget\":{\"socialMedia\":8000,\"email\":4000,\"searchAds\":12000,\"affiliate\":3000},\"actualSpend\":{\"socialMedia\":7500,\"email\":4100,\"searchAds\":13000,\"affiliate\":3500},\"performanceMetrics\":{\"socialMedia\":{\"conversions\":30},\"email\":{\"conversions\":18},\"searchAds\":{\"conversions\":45},\"affiliate\":{\"conversions\":15}},\"reportFormat\":\"detailed\"}", + "description": "Provide a detailed channel-wise comparison of planned versus actual budgets including conversion metrics." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Budget", + "context": null + } + }, + { + "name": "marketing-automation.analyzeIncident", + "description": "Analyzes marketing-related security incidents by accepting incident logs, campaign metadata, and threat intelligence data. It processes these inputs to identify the root cause, affected assets, and potential campaign impact, outputting a detailed incident report with risk assessment and recommended remediation steps.", + "category": "marketing-automation", + "parameters": [ + { + "name": "incidentLogs", + "type": "array", + "description": "List of security incident log entries related to marketing platforms, including timestamps and event details.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the marketing campaign affected by the incident.", + "required": true, + "defaultValue": "" + }, + { + "name": "threatIntelligenceData", + "type": "object", + "description": "Optional object containing external threat intelligence relevant to the incident, such as known attacker signatures or vulnerabilities.", + "required": false, + "defaultValue": "" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of detail for the analysis, e.g., 'basic', 'detailed', or 'comprehensive'.", + "required": false, + "defaultValue": "basic" + }, + { + "name": "includeRemediation", + "type": "boolean", + "description": "Flag indicating whether to include remediation recommendations in the output report.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Structured incident analysis report including summary, root cause analysis, affected campaign components, risk level, and optional remediation suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when needing to analyze security incidents specifically impacting marketing campaigns or platforms. It helps identify how incidents affect campaign operations, assesses risk, and prepares actionable insights for marketing operations or security teams.", + "limitations": "This tool cannot detect incidents on its own; it requires prior incident logs and metadata. It focuses only on marketing-related security incidents and does not replace enterprise-wide security incident management.", + "examples": [ + "Analyze the recent phishing incident logs impacting campaign ID 'summer_promo_2024' to understand its root cause and impact.", + "Evaluate marketing platform breach logs with threat intelligence to generate a comprehensive incident report with remediation steps.", + "Generate a basic incident impact summary for campaign 'black_friday_2023' using given security logs." + ] + }, + "tags": [ + "security", + "marketing", + "incident analysis", + "automation", + "risk assessment", + "campaign management" + ], + "examples": [ + { + "inputJson": "{\"incidentLogs\":[{\"timestamp\":\"2024-06-10T13:45:00Z\",\"event\":\"unauthorizedAccess\",\"details\":\"Suspicious login detected from foreign IP.\"},{\"timestamp\":\"2024-06-10T14:00:00Z\",\"event\":\"dataExfiltration\",\"details\":\"Large export of customer emails.\"}],\"campaignId\":\"summer_sale_2024\",\"threatIntelligenceData\":{\"knownAttackers\":[\"APT28\"],\"vulnerabilities\":[\"CVE-2024-12345\"]},\"analysisDepth\":\"detailed\",\"includeRemediation\":true}", + "description": "Detailed analysis of unauthorized access and data exfiltration in the 'summer_sale_2024' campaign incorporating threat intelligence to produce comprehensive incident report with remediation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Incident", + "context": null + } + }, + { + "name": "marketing-automation.analyzeThreat", + "description": "Analyzes marketing campaign data and external signals to identify potential threats such as phishing, brand impersonation, or fraudulent ads. It accepts campaign metadata and threat indicators, processes risk factors using ML models, and outputs a detailed threat risk report with recommendations for mitigation.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignData", + "type": "object", + "description": "Structured data containing details about the marketing campaign to analyze, including channels, creatives, and targeting info.", + "required": true, + "defaultValue": "" + }, + { + "name": "externalThreatIndicators", + "type": "array", + "description": "List of external threat indicators such as suspicious domains, phishing URLs, or known bad actors relevant to marketing channels.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of detail in the threat analysis report, e.g., 'basic', 'detailed', or 'comprehensive'.", + "required": false, + "defaultValue": "\"basic\"" + }, + { + "name": "includeMitigationSuggestions", + "type": "boolean", + "description": "Whether to include actionable steps and recommendations for mitigating identified threats.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a summary of detected threats, risk scores, detailed findings for each threat type, and optional mitigation recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when needing to evaluate marketing campaigns for potential security threats such as phishing attempts, fake brand content, or ads leading to malicious sites to protect brand integrity and user safety. It helps automate risk assessment by correlating campaign data with external threat intelligence.", + "limitations": "Cannot detect zero-day threats not included in externalThreatIndicators or unseen attack vectors without historical data. Does not perform network-level security scans.", + "examples": [ + "Identify phishing risks in our latest email campaign.", + "Analyze recent digital ads for potential brand impersonation threats.", + "Evaluate the risk level of social media ads based on suspicious external URLs." + ] + }, + "tags": [ + "marketing", + "security", + "threat-analysis", + "automation", + "campaign", + "phishing", + "fraud-detection", + "risk-assessment" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":{\"campaignId\":\"camp123\",\"channels\":[\"email\",\"social\"],\"creatives\":[{\"id\":\"ad1\",\"type\":\"banner\",\"url\":\"http://malicious.example.com\"}],\"targetAudience\":\"general\"},\"externalThreatIndicators\":[{\"type\":\"phishing-url\",\"value\":\"malicious.example.com\"}],\"analysisDepth\":\"detailed\",\"includeMitigationSuggestions\":true}", + "description": "Analyze a marketing campaign with a known malicious URL to identify phishing threats and obtain mitigation advice." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Threat", + "context": null + } + }, + { + "name": "marketing-automation.analyzeVulnerability", + "description": "Analyzes potential vulnerabilities in marketing automation campaigns by examining inputs such as campaign configurations, user behavior patterns, and third-party integrations. Processes these data to detect weak points that could lead to data leaks, unauthorized access, or performance degradation. Returns a detailed vulnerability report with severity ratings and remediation recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignId", + "type": "string", + "description": "Unique identifier of the marketing campaign to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeThirdPartyIntegrations", + "type": "boolean", + "description": "Whether to include security analysis of third-party marketing service integrations.", + "required": false, + "defaultValue": "true" + }, + { + "name": "checkDataPrivacyCompliance", + "type": "boolean", + "description": "Flag to verify if the campaign complies with data privacy regulations (e.g., GDPR, CCPA).", + "required": false, + "defaultValue": "true" + }, + { + "name": "userSegments", + "type": "array", + "description": "Optional list of user segment identifiers to analyze for segment-specific vulnerabilities.", + "required": false, + "defaultValue": "" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of analysis detail: basic, standard, or deep. Deep includes extensive checks and simulations.", + "required": false, + "defaultValue": "standard" + } + ], + "returns": { + "type": "object", + "description": "An object containing a categorized list of detected vulnerabilities with severity levels, affected components, impact descriptions, and detailed recommendations for mitigation or fixes." + }, + "aiAgent": { + "useCase": "Use this tool when assessing the security posture of automated marketing campaigns to proactively identify risks such as data leaks, misconfigurations, or privacy violations before campaign launch or iteration. It helps ensure compliance and safeguards sensitive user data in multi-channel marketing environments.", + "limitations": "Does not directly fix vulnerabilities or patch software; requires correct campaign identifiers and access permissions. It also does not replace comprehensive IT security audits but complements them focusing on marketing automation context.", + "examples": [ + "Analyze campaign 'summer_promo_2024' for vulnerabilities including third-party integrations and data privacy compliance.", + "Check the 'holiday_launch' campaign user segments for potential data leakage risks with a deep analysis.", + "Perform a basic vulnerability scan on campaign 'new_product_intro' without third-party integrations." + ] + }, + "tags": [ + "security", + "marketing-automation", + "vulnerability-analysis", + "campaign-security", + "data-privacy", + "risk-assessment" + ], + "examples": [ + { + "inputJson": "{\"campaignId\":\"summer_promo_2024\",\"includeThirdPartyIntegrations\":true,\"checkDataPrivacyCompliance\":true,\"userSegments\":[\"loyal_customers\",\"new_signups\"],\"analysisDepth\":\"deep\"}", + "description": "Run a deep vulnerability analysis on the 'summer_promo_2024' campaign considering integrations, privacy compliance and key user segments." + }, + { + "inputJson": "{\"campaignId\":\"holiday_launch\",\"includeThirdPartyIntegrations\":false,\"checkDataPrivacyCompliance\":true,\"analysisDepth\":\"standard\"}", + "description": "Standard analysis of the 'holiday_launch' campaign focusing on privacy compliance but excluding third-party integrations." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Vulnerability", + "context": null + } + }, + { + "name": "marketing-automation.analyzeRisk", + "description": "Analyzes marketing campaign data to identify and assess potential risks such as audience overlap, compliance issues, fraud patterns, and budget exposure. Accepts campaign metadata and performance metrics, processes risk factors using predefined rules and machine learning models, then outputs a detailed risk assessment report highlighting vulnerabilities and mitigation suggestions.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignData", + "type": "object", + "description": "Detailed information about the marketing campaign including channels, budgets, targeting parameters, and performance metrics.", + "required": true, + "defaultValue": "" + }, + { + "name": "complianceRules", + "type": "array", + "description": "List of compliance and regulatory constraints relevant to the campaign to check for violations or risks.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "fraudDetectionEnabled", + "type": "boolean", + "description": "Flag to enable analysis for potential fraud such as click spamming or bot activity.", + "required": false, + "defaultValue": "true" + }, + { + "name": "riskThreshold", + "type": "number", + "description": "Numeric threshold (0-1) to classify campaigns as low or high risk based on the calculated risk score.", + "required": false, + "defaultValue": "0.7" + } + ], + "returns": { + "type": "object", + "description": "Risk assessment report including overall risk score, identified risk categories, specific issues with descriptions, and recommended mitigation actions." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing marketing campaigns to proactively identify risks that could lead to financial loss, compliance violations, or campaign underperformance. It assists in making data-driven decisions to adjust campaigns and minimize exposure to risks.", + "limitations": "Cannot guarantee detection of all risk factors, especially unforeseen external changes. Requires accurate and comprehensive input data. Not a replacement for professional risk audits.", + "examples": [ + "Analyze risk for campaign with large cross-channel activities to identify budget exposure and compliance issues", + "Assess fraud risk in paid social campaigns with suspected click anomalies", + "Evaluate impact of targeting overlap on campaign effectiveness and risk profile" + ] + }, + "tags": [ + "marketing", + "risk-analysis", + "campaign-management", + "automation", + "fraud-detection", + "compliance", + "budget-management" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":{\"channels\":[\"social\",\"email\"],\"budget\":50000,\"targetAudiences\":[\"18-25\",\"tech-enthusiasts\"],\"performanceMetrics\":{\"clickThroughRate\":0.05,\"conversionRate\":0.02}},\"complianceRules\":[\"GDPR\",\"CAN-SPAM\"],\"fraudDetectionEnabled\":true,\"riskThreshold\":0.7}", + "description": "Assess risk for a $50k campaign running social and email channels targeting young tech enthusiasts subject to GDPR and CAN-SPAM rules." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Risk", + "context": null + } + }, + { + "name": "marketing-automation.analyzeForecast", + "description": "This tool accepts historical marketing campaign data and business parameters as input to analyze and generate predictive forecasts about future campaign performance and ROI. It processes data trends, seasonal effects, and key metrics, outputting detailed forecasts with confidence intervals and actionable insights for campaign planning.", + "category": "marketing-automation", + "parameters": [ + { + "name": "historicalData", + "type": "array", + "description": "An array of past marketing campaign results, including performance metrics like impressions, clicks, conversions, and spend. Required for analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeFrame", + "type": "string", + "description": "The period for forecasting (e.g., next quarter, next 6 months). Determines the scope of predictions. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "businessObjectives", + "type": "object", + "description": "Key business goals aligned with the forecast, such as target revenue, growth rate, or desired ROI. Helps tailor forecast outputs. Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "seasonalAdjustments", + "type": "boolean", + "description": "Flag to enable adjusting forecasts for known seasonal patterns affecting marketing effectiveness. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "confidenceLevel", + "type": "number", + "description": "Confidence level (between 0 and 1) for statistical intervals around forecasted values. Default is 0.95 (95%). Optional.", + "required": false, + "defaultValue": "0.95" + } + ], + "returns": { + "type": "object", + "description": "An object containing predicted campaign metrics over the specified time frame including forecasts for impressions, clicks, conversions, expected ROI, confidence intervals, and strategic recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when you want to predict how upcoming marketing campaigns may perform based on historical data and preset business goals. It helps in planning budget allocations and setting realistic performance targets by providing statistically grounded forecasts including confidence levels.", + "limitations": "This tool does not replace expert human judgment or guarantee future results; it relies on quality and completeness of historical data and may not capture sudden market changes or unrecorded external factors.", + "examples": [ + "Predict campaign performance and ROI for next quarter based on last two years of campaign data.", + "Analyze forecasts for a new product launch campaign incorporating target revenue objectives.", + "Generate adjusted forecasts accounting for seasonality effects for upcoming holiday marketing campaigns." + ] + }, + "tags": [ + "forecasting", + "marketing", + "automation", + "campaign-analysis", + "predictive-analytics", + "ROI", + "business-intelligence" + ], + "examples": [ + { + "inputJson": "{\"historicalData\":[{\"campaignId\":\"c001\",\"date\":\"2023-01-01\",\"impressions\":100000,\"clicks\":5000,\"conversions\":250,\"spend\":10000}],\"timeFrame\":\"next quarter\",\"businessObjectives\":{\"targetROI\":1.5},\"seasonalAdjustments\":true,\"confidenceLevel\":0.95}", + "description": "Forecast next quarter's campaign outcomes using one past campaign data record and business ROI targets with seasonality adjustments enabled." + }, + { + "inputJson": "{\"historicalData\":[{\"campaignId\":\"c001\",\"date\":\"2022-05-01\",\"impressions\":75000,\"clicks\":3000,\"conversions\":150,\"spend\":7000},{\"campaignId\":\"c002\",\"date\":\"2022-12-01\",\"impressions\":90000,\"clicks\":4500,\"conversions\":220,\"spend\":9000}],\"timeFrame\":\"next 6 months\",\"seasonalAdjustments\":false,\"confidenceLevel\":0.90}", + "description": "Generate a 6-month performance forecast from two past campaigns without seasonal adjustments at 90% confidence." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Forecast", + "context": null + } + }, + { + "name": "marketing-automation.analyzeExpense", + "description": "This tool accepts detailed expense data related to marketing campaigns, including amounts, dates, categories, and campaign identifiers. It processes the data to analyze spending patterns, compare expenses against budgets, identify cost efficiencies or overruns, and generate summarized reports highlighting key insights. The output is a structured expense analysis report with metrics, trends, and recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "expenseData", + "type": "array", + "description": "Array of expense records, each with amount, date, category, and campaignId, representing marketing-related expenditures.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date (ISO 8601 format) for the analysis period. Only expenses on or after this date are included.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date (ISO 8601 format) for the analysis period. Only expenses on or before this date are included.", + "required": false, + "defaultValue": "" + }, + { + "name": "budgetByCampaign", + "type": "object", + "description": "Optional object mapping campaign IDs to budget amounts to compare actual expenses against planned budgets.", + "required": false, + "defaultValue": "" + }, + { + "name": "groupByCategory", + "type": "boolean", + "description": "If true, the analysis groups expense summaries by category, otherwise by campaign.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing summarized expense analysis including total spent, spend by category or campaign, budget comparison results, trend data, and identified cost anomalies or efficiencies." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate marketing expenses to understand spending trends, verify budget adherence, and identify areas for cost optimization across campaigns or categories. It aids in reporting and decision support for marketing financial management.", + "limitations": "Does not automate budget adjustments or recommend specific vendor changes. Analysis depends on the input accuracy and completeness of expense records. It does not perform forecasting beyond the provided expense data.", + "examples": [ + "Analyze total marketing expenses and budget compliance for campaigns in Q1 2024.", + "Identify which marketing categories incurred the highest expenses in the previous month.", + "Generate a summary of marketing spend trends grouped by category for the last 6 months." + ] + }, + "tags": [ + "marketing", + "expense-analysis", + "budget-monitoring", + "campaign-spending", + "financial-reporting", + "automation" + ], + "examples": [ + { + "inputJson": "{\"expenseData\":[{\"amount\":1200.50,\"date\":\"2024-01-05\",\"category\":\"social-media\",\"campaignId\":\"camp01\"},{\"amount\":3000,\"date\":\"2024-01-15\",\"category\":\"email\",\"campaignId\":\"camp02\"},{\"amount\":1500,\"date\":\"2024-02-10\",\"category\":\"social-media\",\"campaignId\":\"camp01\"}],\"startDate\":\"2024-01-01\",\"endDate\":\"2024-03-31\",\"budgetByCampaign\":{\"camp01\":5000,\"camp02\":4000},\"groupByCategory\":true}", + "description": "Analyze marketing expenses grouped by category with budget comparison for Q1 2024 campaigns." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Expense", + "context": null + } + }, + { + "name": "marketing-automation.analyzeOrder", + "description": "Analyzes a marketing order by processing order details such as items, customer demographics, and campaign identifiers to evaluate performance metrics like conversion rates, revenue generated, and ROI. The tool outputs insights that help optimize marketing strategies and improve campaign effectiveness.", + "category": "marketing-automation", + "parameters": [ + { + "name": "orderId", + "type": "string", + "description": "Unique identifier for the order to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "orderData", + "type": "object", + "description": "Detailed object containing order items, quantities, prices, customer info, and campaign tags. Used for in-depth analysis if orderId is not supplied or for supplementing existing records.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCustomerSegmentation", + "type": "boolean", + "description": "Whether to perform customer segmentation analysis based on order demographics.", + "required": false, + "defaultValue": "false" + }, + { + "name": "timePeriod", + "type": "string", + "description": "Optional time period (e.g., '2024-01') to constrain analysis to orders within specific campaign dates.", + "required": false, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of specific metrics to calculate such as ['conversionRate','averageOrderValue','ROI']. If empty, defaults to key standard metrics.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured report including calculated metrics (conversion rate, revenue, ROI), customer segmentation summaries, campaign performance comparisons, and actionable recommendations for marketing improvements." + }, + "aiAgent": { + "useCase": "Use this tool when needing to assess the effectiveness of a completed order in marketing campaigns, especially to extract ROI, conversion insights, and customer behavior analyses from order data or identifiers. It supports decisions on campaign adjustments and budget allocation.", + "limitations": "Cannot process orders without sufficient detail; does not access live external databases or CRM systems automatically; performs analysis based on provided data only; does not generate new campaigns or modify orders.", + "examples": [ + "Analyze order performance metrics for order ID 'ORD12345' to guide next marketing steps.", + "Perform customer segmentation and ROI calculation on a batch of orders from a specific campaign in March 2024.", + "Calculate conversion rate and average order value including customer demographic insights for a given order data object." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "order", + "campaign", + "metrics", + "customer-segmentation" + ], + "examples": [ + { + "inputJson": "{\"orderId\":\"ORD12345\",\"includeCustomerSegmentation\":true,\"metrics\":[\"ROI\",\"conversionRate\"]}", + "description": "Analyze ROI and conversion rate for order with ID ORD12345 including customer segmentation." + }, + { + "inputJson": "{\"orderData\":{\"items\":[{\"productId\":\"P001\",\"quantity\":3,\"price\":29.99},{\"productId\":\"P002\",\"quantity\":1,\"price\":99.95}],\"customer\":{\"age\":30,\"location\":\"NY\"},\"campaignId\":\"CAMP2024SPRING\"},\"timePeriod\":\"2024-03\"}", + "description": "Analyze detailed order data from spring 2024 campaign with time constraint to provide performance insight." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Order", + "context": null + } + }, + { + "name": "marketing-automation.analyzePayment", + "description": "Analyzes marketing-related payment data by accepting transaction records and campaign identifiers. Processes payment amounts, dates, and customer segments to generate insights such as revenue trends, conversion efficiency, and campaign ROI. Outputs structured analytics including summarized metrics and visualizable data points.", + "category": "marketing-automation", + "parameters": [ + { + "name": "paymentRecords", + "type": "array", + "description": "List of payment transaction objects, each including amount, date, customer segment, and payment method.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier for the marketing campaign to associate with the payments.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date (ISO 8601) for the analysis period.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date (ISO 8601) for the analysis period.", + "required": false, + "defaultValue": "" + }, + { + "name": "groupBySegment", + "type": "boolean", + "description": "Whether to group analysis results by customer segments.", + "required": false, + "defaultValue": "true" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code of the payment amounts (e.g., USD).", + "required": false, + "defaultValue": "USD" + } + ], + "returns": { + "type": "object", + "description": "An object containing summarized payment metrics including total revenue, average payment amount, payment count, revenue trends over time, ROI estimates, and optionally breakdowns by customer segments." + }, + "aiAgent": { + "useCase": "Use this tool to analyze payment data linked to marketing campaigns to assess revenue performance, conversion rates, and return on investment. It helps in identifying which campaigns and customer segments generate the highest payment volumes and revenue over a specified period.", + "limitations": "This tool does not perform payment fraud detection or individual transaction validation. It also does not connect to live payment gateways; input data must be provided externally.", + "examples": [ + "Analyze payments for campaign ID 'cmp-2023-09' in the last quarter to understand revenue trends.", + "Generate a report summarizing total payments grouped by customer segments for campaign 'holiday_sale'.", + "Calculate ROI and average transaction size for a payment dataset linked to campaign 'summer_launch'." + ] + }, + "tags": [ + "marketing", + "payment-analysis", + "campaign-performance", + "revenue", + "customer-segmentation", + "ROI", + "data-analysis" + ], + "examples": [ + { + "inputJson": "{\"paymentRecords\":[{\"amount\":120.5,\"date\":\"2024-05-01T10:15:00Z\",\"customerSegment\":\"retail\",\"paymentMethod\":\"credit_card\"},{\"amount\":75.0,\"date\":\"2024-05-03T14:22:00Z\",\"customerSegment\":\"wholesale\",\"paymentMethod\":\"paypal\"}],\"campaignId\":\"cmp-2024-spring\",\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-31\",\"groupBySegment\":true,\"currency\":\"USD\"}", + "description": "Analyze payments from May 2024 for campaign 'cmp-2024-spring' grouping results by customer segment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Payment", + "context": null + } + }, + { + "name": "marketing-automation.analyzeLead", + "description": "Analyzes lead data provided as input to evaluate quality, engagement level, and potential conversion score. Accepts lead attributes such as demographics, interaction history, and campaign source. Processes this data using predictive analytics and scoring models to output a detailed analysis report including lead score, recommended next actions, and segmentation category.", + "category": "marketing-automation", + "parameters": [ + { + "name": "leadData", + "type": "object", + "description": "An object containing lead attributes such as name, contact info, demographic details, and behavioral data.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeEngagementAnalysis", + "type": "boolean", + "description": "Whether to analyze the lead's engagement history like email opens, clicks, and website visits.", + "required": false, + "defaultValue": "true" + }, + { + "name": "scoringModel", + "type": "string", + "description": "The identifier of the scoring model to use for lead evaluation (e.g., 'default', 'customModel1').", + "required": false, + "defaultValue": "default" + }, + { + "name": "campaignSource", + "type": "string", + "description": "The marketing campaign or channel from which the lead originated, useful for segmenting and attribution.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing lead score (number), engagement metrics summary, recommended next marketing actions, and lead segmentation category label." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate individual lead data to prioritize marketing efforts and personalize follow-ups. It is especially useful in automated campaign management and qualification pipelines to score leads and suggest next campaign actions based on data-driven models.", + "limitations": "This tool does not generate leads or collect raw lead data; it only analyzes data provided to it. It relies on predefined scoring models and may require updated training data for accuracy over time.", + "examples": [ + "Analyze this lead's data to get a lead quality score and suggested follow-ups.", + "Evaluate leads from the recent webinar campaign to find hottest prospects.", + "Provide segmentation and next best action for a given lead including engagement metrics." + ] + }, + "tags": [ + "marketing", + "lead-analysis", + "automation", + "scoring", + "campaign-management" + ], + "examples": [ + { + "inputJson": "{\"leadData\":{\"name\":\"Jane Doe\",\"email\":\"jane.doe@example.com\",\"industry\":\"Technology\",\"jobTitle\":\"CTO\",\"interactions\":{\"emailOpens\":5,\"clicks\":2,\"websiteVisits\":3}},\"includeEngagementAnalysis\":true,\"scoringModel\":\"default\",\"campaignSource\":\"WebinarJune2024\"}", + "description": "Analyze a technology sector CTO lead from webinar with engagement data included." + }, + { + "inputJson": "{\"leadData\":{\"name\":\"John Smith\",\"email\":\"john.smith@example.com\",\"industry\":\"Finance\",\"jobTitle\":\"CFO\"},\"includeEngagementAnalysis\":false,\"scoringModel\":\"customModel1\",\"campaignSource\":\"NewsletterMay2024\"}", + "description": "Analyze a finance sector CFO lead without engagement data using a custom scoring model." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Lead", + "context": null + } + }, + { + "name": "marketing-automation.analyzeDeal", + "description": "Analyzes sales deal data by accepting deal attributes such as deal size, duration, client industry, and conversion stage. It processes historical and current deal information to generate insights about deal health, risk, and expected closure likelihood, outputting a detailed analysis report including key performance indicators and recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "dealId", + "type": "string", + "description": "Unique identifier of the deal to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "dealSize", + "type": "number", + "description": "Monetary value of the deal in USD or specified currency.", + "required": true, + "defaultValue": "" + }, + { + "name": "dealDurationDays", + "type": "number", + "description": "Number of days since the deal was created or first contacted.", + "required": false, + "defaultValue": "0" + }, + { + "name": "clientIndustry", + "type": "string", + "description": "Industry sector of the client associated with the deal, e.g., technology, healthcare.", + "required": false, + "defaultValue": "" + }, + { + "name": "conversionStage", + "type": "string", + "description": "Current stage of the deal in the sales pipeline, e.g., prospecting, negotiation, closing.", + "required": false, + "defaultValue": "" + }, + { + "name": "historicalDealsData", + "type": "array", + "description": "Optional array of past deals data objects to compare trends and improve analysis accuracy.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Analysis report containing risk score, expected closure probability, deal health indicators, and strategic recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the status and outlook of an ongoing or proposed sales deal by processing quantitative and categorical deal parameters to produce actionable insights. It helps prioritize deals, forecast revenue and identify risk factors in a marketing or sales automation context.", + "limitations": "This tool does not negotiate deals, generate leads, or replace human judgement. It requires accurate input data and does not handle real-time deal updates automatically.", + "examples": [ + "Analyze deal with ID D12345 having deal size 50000 USD in technology industry currently at negotiation stage.", + "Provide a risk and closure probability assessment for a healthcare sector deal of 75000 USD created 30 days ago.", + "Evaluate deal health for a set of historical deals to identify factors contributing to success." + ] + }, + "tags": [ + "marketing", + "analysis", + "sales", + "deal", + "automation", + "risk-assessment", + "forecasting" + ], + "examples": [ + { + "inputJson": "{\"dealId\":\"D12345\",\"dealSize\":50000,\"dealDurationDays\":15,\"clientIndustry\":\"technology\",\"conversionStage\":\"negotiation\"}", + "description": "Analyze a technology sector deal worth $50,000 currently in negotiation stage, created 15 days ago." + }, + { + "inputJson": "{\"dealId\":\"D67890\",\"dealSize\":120000,\"dealDurationDays\":45,\"clientIndustry\":\"healthcare\",\"conversionStage\":\"closing\"}", + "description": "Assess a healthcare industry deal valued at $120,000 that is 45 days old and in the closing stage." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Deal", + "context": null + } + }, + { + "name": "marketing-automation.analyzeAccount", + "description": "Analyzes a marketing account's campaign performance data to provide insights on key metrics such as engagement, conversion rates, and ROI. Accepts account identifiers and optional date ranges, processes marketing campaign results including channel-specific data, and outputs a detailed performance summary with actionable recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "Unique identifier of the marketing account to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date (YYYY-MM-DD) for the analysis period. If omitted, defaults to 30 days before endDate.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date (YYYY-MM-DD) for the analysis period. If omitted, defaults to current date.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeChannels", + "type": "array", + "description": "List of marketing channels to include in the analysis (e.g., ['email','social','paid']). If omitted, all channels are considered.", + "required": false, + "defaultValue": "" + }, + { + "name": "performanceThreshold", + "type": "number", + "description": "Minimum engagement rate threshold for reporting specific campaign highlights. Default is 0.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "An object containing overall account marketing performance metrics including engagement rates, conversion rates, ROI by channel, trend analysis, and specific actionable recommendations to optimize campaigns." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents that need to evaluate the effectiveness of marketing campaigns within a given account over a specified period, helping to identify strengths and weaknesses across channels and suggest improvements. It is useful for campaign performance reporting and strategic marketing optimization.", + "limitations": "Does not access raw customer data or CRM entries beyond campaign performance metrics. Lacks real-time tracking capability and depends on historical data availability through integrations. Cannot execute campaign changes automatically; only provides analysis and recommendations.", + "examples": [ + "Analyze marketing account performance for account ID 'acct123' over the last month.", + "Provide insights on social and email channels performance between 2024-04-01 and 2024-04-30 for account 'account456'.", + "Identify campaigns with engagement rates above 5% for account 'abc789' over the past quarter." + ] + }, + "tags": [ + "marketing", + "analysis", + "account", + "campaign", + "performance", + "automation", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"accountId\":\"account123\",\"startDate\":\"2024-03-01\",\"endDate\":\"2024-03-31\",\"includeChannels\":[\"email\",\"social\"],\"performanceThreshold\":0.05}", + "description": "Analyze email and social channel campaigns for account 'account123' during March 2024, highlighting any campaigns with engagement rate above 5%." + }, + { + "inputJson": "{\"accountId\":\"acct789\",\"performanceThreshold\":0.1}", + "description": "Analyze all marketing channels for account 'acct789' over the past 30 days with a high performance threshold, focusing on campaigns exceeding 10% engagement rate." + }, + { + "inputJson": "{\"accountId\":\"market999\",\"startDate\":\"2024-01-01\",\"endDate\":\"2024-06-01\"}", + "description": "Analyze overall marketing account 'market999' data from beginning of the year through June 1, 2024, covering all channels without special thresholds." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "marketing-automation.analyzeCustomer", + "description": "Analyzes customer data to identify segments, behavior patterns, and potential high-value targets. Accepts customer profiles and interaction records, applies clustering and scoring algorithms, and outputs actionable insights for targeted marketing campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "customerData", + "type": "array", + "description": "List of customer records including demographics, purchase history, and interaction data.", + "required": true, + "defaultValue": "" + }, + { + "name": "segmentCriteria", + "type": "object", + "description": "Criteria for segmenting customers, such as demographic filters or behavioral thresholds.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "scoringModel", + "type": "string", + "description": "Identifier for the scoring or predictive model to apply to customer data.", + "required": false, + "defaultValue": "defaultModel" + }, + { + "name": "maxSegments", + "type": "number", + "description": "Maximum number of customer segments to identify.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeChurnRisk", + "type": "boolean", + "description": "Whether to include churn risk estimation in the analysis.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Analysis results including identified customer segments, scores for key metrics (e.g., retention likelihood, customer value), and recommendations for marketing strategies." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to optimize marketing efforts by understanding customer groupings, identifying high-value or at-risk customers, and tailoring campaigns. Suitable for scenarios with partially or fully structured customer data requiring segmentation and predictive scoring.", + "limitations": "Does not perform raw data cleaning or unstructured text analysis; relies on input data quality and model calibration; does not execute marketing campaigns.", + "examples": [ + "Analyze the customer base to find segments at risk of churn and suggest retention strategies.", + "Provide customer segmentation based on purchase frequency and demographics for targeted email campaigns.", + "Score customers by predicted lifetime value and identify top 3 segments for a new product launch." + ] + }, + "tags": [ + "marketing", + "customer-analysis", + "segmentation", + "predictive-scoring", + "automation", + "campaign-optimization" + ], + "examples": [ + { + "inputJson": "{\"customerData\":[{\"id\":\"cust001\",\"age\":34,\"gender\":\"F\",\"purchases\":20,\"lastPurchaseDaysAgo\":15},{\"id\":\"cust002\",\"age\":28,\"gender\":\"M\",\"purchases\":5,\"lastPurchaseDaysAgo\":120}],\"segmentCriteria\":{\"ageRange\":[25,40]},\"scoringModel\":\"lifetimeValueV1\",\"maxSegments\":3,\"includeChurnRisk\":true}", + "description": "Segment customers aged 25-40, apply lifetime value scoring, limit to 3 segments, include churn risk." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Customer", + "context": null + } + }, + { + "name": "marketing-automation.analyzeOpportunity", + "description": "Analyzes business marketing opportunities by evaluating key metrics such as target market size, expected ROI, competitive landscape, and alignment with current marketing strategy. Accepts opportunity data and historical campaign performance. Processes to identify viability and potential impact, returning a detailed scoring and recommendations report.", + "category": "marketing-automation", + "parameters": [ + { + "name": "opportunityData", + "type": "object", + "description": "Detailed data about the marketing opportunity including target demographic, market size, estimated budget, and expected outcomes.", + "required": true, + "defaultValue": "" + }, + { + "name": "historicalPerformance", + "type": "array", + "description": "Array of past marketing campaign summaries to compare and benchmark the opportunity against.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "riskTolerance", + "type": "number", + "description": "Numeric value (0-1) representing how much risk the business is willing to accept when pursuing the opportunity, influencing analysis weighting.", + "required": false, + "defaultValue": "0.5" + }, + { + "name": "strategyAlignmentThreshold", + "type": "number", + "description": "Minimum alignment score (0-100) required with current marketing strategy to consider the opportunity viable.", + "required": false, + "defaultValue": "70" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object containing a viability score, ROI projection, risk assessment, competitive analysis summary, and actionable recommendations." + }, + "aiAgent": { + "useCase": "Use when evaluating potential marketing initiatives or campaigns to quantitatively assess their attractiveness and alignment with business goals. It helps prioritize opportunities based on data-driven insights from current market and past performance data.", + "limitations": "Cannot guarantee actual market performance; dependent on accuracy and completeness of input data; does not replace human strategic judgment but aids it.", + "examples": [ + "Analyze a new social media campaign opportunity targeting a niche demographic.", + "Evaluate potential ROI and risks of expanding into a new geographic market segment.", + "Compare and prioritize multiple marketing initiatives based on past campaign data and strategic fit." + ] + }, + "tags": [ + "marketing", + "automation", + "opportunity", + "analysis", + "ROI", + "strategy", + "risk", + "campaign" + ], + "examples": [ + { + "inputJson": "{\"opportunityData\":{\"targetDemographic\":\"millennials\",\"marketSize\":5000000,\"estimatedBudget\":200000,\"expectedOutcomes\":{\"leads\":10000,\"sales\":500}},\"historicalPerformance\":[{\"campaignName\":\"SpringSale\",\"ROI\":1.5,\"risk\":0.3},{\"campaignName\":\"HolidayPromo\",\"ROI\":1.2,\"risk\":0.2}],\"riskTolerance\":0.6,\"strategyAlignmentThreshold\":75}", + "description": "Analyze a new marketing opportunity aimed at millennials with past campaign data to benchmark." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Opportunity", + "context": null + } + }, + { + "name": "marketing-automation.analyzeMarkdown", + "description": "Analyzes marketing campaign content written in Markdown format to extract key marketing elements, sentiment, and topic distribution. Accepts Markdown text input, processes the content to identify marketing messages, call-to-actions, and emotional tone, and returns a structured summary report for refining campaign effectiveness.", + "category": "marketing-automation", + "parameters": [ + { + "name": "markdownContent", + "type": "string", + "description": "The raw marketing campaign text in Markdown format to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSentimentAnalysis", + "type": "boolean", + "description": "Whether to perform sentiment analysis on the Markdown content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "topicExtractionCount", + "type": "number", + "description": "Number of key topics to extract from the content for thematic analysis.", + "required": false, + "defaultValue": "5" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the Markdown content to improve accuracy of linguistic analysis.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "A detailed report summarizing detected marketing elements, sentiment scores, topic distribution, and suggestions for content optimization." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to analyze the textual content of marketing campaigns that are authored in Markdown to gain insights on marketing messages, sentiment, and topical relevance. Ideal for refining campaign wording, ensuring calls-to-action are present, and understanding emotional impact. It supports content QA and targeted optimization.", + "limitations": "Cannot analyze images or embedded media within the Markdown; focuses solely on textual content. Does not generate new marketing content, only analyzes provided input. Sentiment and topic extraction quality may vary with very short or highly technical texts.", + "examples": [ + "Analyze this markdown to identify key marketing calls to action and sentiment.", + "Extract main marketing topics from campaign content written in Markdown.", + "Provide a summary report of the promotional markdown text including emotional tone and suggestions." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "markdown", + "content-analysis", + "sentiment", + "topic-extraction", + "campaign-optimization" + ], + "examples": [ + { + "inputJson": "{\"markdownContent\":\"# Summer Sale\\nDon't miss out on our exclusive **50% off** deals! Shop now and save big.\",\"includeSentimentAnalysis\":true,\"topicExtractionCount\":3,\"language\":\"en\"}", + "description": "Analyze a markdown snippet advertising a summer sale with a strong call-to-action." + }, + { + "inputJson": "{\"markdownContent\":\"## New Product Launch\\nDiscover the innovative features of our latest product. Pre-order today to enjoy early bird discounts!\",\"includeSentimentAnalysis\":true,\"topicExtractionCount\":4,\"language\":\"en\"}", + "description": "Analyze marketing text for a new product launch with emphasis on pre-order incentives." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Markdown", + "context": null + } + }, + { + "name": "marketing-automation.analyzeYAML", + "description": "This tool accepts marketing campaign configurations and results formatted in YAML. It parses and analyzes the data to extract key performance metrics, identify trends, and generate a summarized business report. Output is returned as a structured JSON object highlighting campaign effectiveness and recommendations.", + "category": "marketing-automation", + "parameters": [ + { + "name": "yamlContent", + "type": "string", + "description": "YAML string containing the marketing campaign data and results to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Flag to include actionable marketing recommendations based on analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "metricsToFocus", + "type": "array", + "description": "List of specific metric names (strings) to prioritize in the analysis, e.g., ['clickThroughRate','conversionRate'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Specifies the format of the summary report output, either 'json' or 'markdown'.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "A detailed JSON object containing parsed campaign metrics, performance trends, and optional recommendations." + }, + "aiAgent": { + "useCase": "When an AI agent needs to understand and evaluate marketing campaign results provided in YAML format—for example, analyzing large volumes of campaign configurations and their outcomes to produce summary reports, identify top KPIs, and suggest improvements automatically.", + "limitations": "Cannot validate YAML syntax beyond basic parsing; assumes input is structured as marketing campaign data. Does not execute campaign simulations or predict future performance beyond current data analysis.", + "examples": [ + "Analyze this YAML marketing campaign data and produce a performance summary.", + "Parse the given YAML content of multiple campaigns and highlight the key metrics with recommendations.", + "Provide a markdown report focusing on conversion and click through rates from the supplied YAML data." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "yaml", + "campaign", + "metrics", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"yamlContent\":\"campaigns:\\n - name: Spring Sale\\n clicks: 1200\\n impressions: 50000\\n conversions: 60\\n - name: Summer Launch\\n clicks: 800\\n impressions: 30000\\n conversions: 45\",\"includeRecommendations\":true,\"metricsToFocus\":[\"clickThroughRate\",\"conversionRate\"],\"reportFormat\":\"json\"}", + "description": "Analyze two campaigns' basic performance data from YAML and produce a JSON report with recommendations." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "YAML", + "context": null + } + }, + { + "name": "marketing-automation.analyzeJSON", + "description": "Accepts marketing campaign data as JSON, analyzes key performance indicators (KPIs) such as conversion rates, click-through rates, and audience engagement, and outputs a structured summary highlighting strengths, weaknesses, and optimization suggestions.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignData", + "type": "object", + "description": "The raw marketing campaign data formatted as JSON, including metrics like impressions, clicks, conversions, audience demographics, and timestamps.", + "required": true, + "defaultValue": "" + }, + { + "name": "kpiList", + "type": "array", + "description": "List of KPIs to extract and analyze from the campaign data, such as ['conversionRate', 'clickThroughRate', 'bounceRate']. Defaults to common marketing KPIs if empty.", + "required": false, + "defaultValue": "[\"conversionRate\",\"clickThroughRate\",\"bounceRate\"]" + }, + { + "name": "timeFrameStart", + "type": "string", + "description": "ISO 8601 date string to specify the starting date/time for analysis window. If omitted, analysis includes all available data.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeFrameEnd", + "type": "string", + "description": "ISO 8601 date string to specify the ending date/time for analysis window. If omitted, analysis includes all available data.", + "required": false, + "defaultValue": "" + }, + { + "name": "compareToPreviousPeriod", + "type": "boolean", + "description": "Whether to compare analyzed KPIs to the previous equivalent period to identify trends or changes.", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "If true, the output will include actionable recommendations based on the analyzed data to improve marketing performance.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing analyzed KPI values, trend comparisons if requested, and optionally recommendations for marketing campaign optimization." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw marketing campaign data formatted in JSON and need a rapid, structured analysis of key performance metrics with optional trends and actionable insights. This helps automate marketing performance review and strategy optimization without manual data crunching.", + "limitations": "Cannot access external data sources or dynamically retrieve missing marketing data. Analysis depends solely on provided JSON data quality and completeness.", + "examples": [ + "Analyze my last campaign's JSON data for conversion and click rates within last month and compare to previous month.", + "Extract and summarize key KPIs from multiple marketing campaigns JSON to evaluate performance.", + "Provide marketing optimization recommendations based on social media campaign JSON data during specified time frame." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "JSON", + "campaign analysis", + "KPI", + "performance", + "recommendations" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":{\"impressions\":10000,\"clicks\":500,\"conversions\":50,\"startDate\":\"2024-05-01T00:00:00Z\",\"endDate\":\"2024-05-31T23:59:59Z\"},\"kpiList\":[\"conversionRate\",\"clickThroughRate\"],\"timeFrameStart\":\"2024-05-01T00:00:00Z\",\"timeFrameEnd\":\"2024-05-31T23:59:59Z\",\"compareToPreviousPeriod\":true,\"includeRecommendations\":true}", + "description": "Analyze conversion and click-through rates for May 2024 campaign, compare to April 2024, and provide recommendations." + }, + { + "inputJson": "{\"campaignData\":{\"impressions\":20000,\"clicks\":1000,\"conversions\":80,\"bounceRate\":0.3},\"kpiList\":[],\"includeRecommendations\":false}", + "description": "Analyze the default key KPIs of a campaign with no specific KPIs requested, without recommendations." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "JSON", + "context": null + } + }, + { + "name": "marketing-automation.analyzeHTML", + "description": "Analyzes provided raw HTML content of marketing emails or landing pages to extract key marketing metrics such as link click density, keyword frequency, image alt text presence, and form presence. Outputs a structured report highlighting potential optimizations for marketing performance.", + "category": "marketing-automation", + "parameters": [ + { + "name": "htmlContent", + "type": "string", + "description": "Raw HTML content of the marketing email or landing page to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "analyzeLinks", + "type": "boolean", + "description": "Whether to analyze and report on links and their distribution in the HTML content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "keywordList", + "type": "array", + "description": "List of marketing-related keywords to check frequency of within the HTML content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "checkAccessibility", + "type": "boolean", + "description": "Enable checking for HTML accessibility features, such as presence of alt text on images.", + "required": false, + "defaultValue": "true" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Format of the output report, e.g., 'json' or 'text'.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "Structured analysis report including metrics such as link click distribution, keyword frequency counts, accessibility checks, form detection, and suggestions for improvements." + }, + "aiAgent": { + "useCase": "Use this tool when needing to extract actionable marketing insights from raw HTML content of emails or landing pages to improve engagement rates and compliance with best practices. Ideal for automated marketing performance analysis or pre-deployment validation of marketing assets.", + "limitations": "Cannot render or simulate user interactions with the HTML content; analysis is static and based solely on the HTML markup provided. Does not execute scripts or styles. Cannot verify actual engagement metrics beyond structural analysis.", + "examples": [ + "Analyze the HTML of a marketing email to get keyword frequency and link distribution.", + "Check if all images in the landing page HTML have alt text for accessibility compliance.", + "Generate a JSON report summarizing link and form counts in campaign HTML content." + ] + }, + "tags": [ + "marketing", + "automation", + "html", + "analysis", + "email", + "landing-page", + "seo", + "accessibility" + ], + "examples": [ + { + "inputJson": "{\"htmlContent\":\"Buy now\",\"analyzeLinks\":true,\"keywordList\":[\"buy\",\"sale\"],\"checkAccessibility\":true,\"reportFormat\":\"json\"}", + "description": "HTML input containing a link, image with alt text, and a form to analyze keywords, links, and accessibility." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "HTML", + "context": null + } + }, + { + "name": "marketing-automation.analyzeXML", + "description": "Analyzes marketing campaign data provided in XML format by extracting key performance indicators like open rates, click-through rates, conversion metrics, and segment distributions, then generates a structured summary report with insights and trends for campaign performance evaluation.", + "category": "marketing-automation", + "parameters": [ + { + "name": "xmlData", + "type": "string", + "description": "The raw XML string containing marketing campaign data to analyze. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "extractKPIs", + "type": "array", + "description": "List of key performance indicators to extract from the XML, e.g., ['openRate','clickThroughRate']. Optional; defaults to common KPIs.", + "required": false, + "defaultValue": "[\"openRate\",\"clickThroughRate\",\"conversionRate\"]" + }, + { + "name": "dateRange", + "type": "object", + "description": "Optional date range filter with 'startDate' and 'endDate' strings (ISO format) to restrict analysis to specific campaign dates.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSegments", + "type": "boolean", + "description": "Whether to include analysis segmented by audience groups if present in the XML data.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object containing extracted KPI values, trend summary text, segmented breakdowns if requested, and any warnings about data quality or missing fields." + }, + "aiAgent": { + "useCase": "Use this tool when needing to extract and synthesize marketing campaign performance metrics embedded in XML format data files, especially to automate report generation and identify trends without manual data parsing. It aids in summarizing important analytics from potentially complex nested XML campaign exports.", + "limitations": "Cannot interpret data outside of the XML structure provided or generate visualizations. Assumes XML conforms to expected marketing campaign schema. Does not predict future trends or apply advanced statistical modeling.", + "examples": [ + "Analyze this campaign XML to extract all relevant KPIs.", + "Summarize click and conversion rates from the marketing data in XML for Q1 2023.", + "Provide segmented open and click rate analysis from this XML campaign export." + ] + }, + "tags": [ + "marketing", + "automation", + "XML", + "analysis", + "campaign", + "KPIs", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"xmlData\":\"
\",\"extractKPIs\":[\"openRate\",\"clickThroughRate\"],\"includeSegments\":true}", + "description": "Analyze XML campaign data extracting open and click rates including segment breakdowns." + }, + { + "inputJson": "{\"xmlData\":\" 45 10 3 50 12 \",\"dateRange\":{\"startDate\":\"2023-01-01\",\"endDate\":\"2023-03-31\"},\"includeSegments\":false}", + "description": "Analyze campaign XML data filtered by Q1 2023 date range without segment details." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "XML", + "context": null + } + }, + { + "name": "marketing-automation.analyzeTable", + "description": "Analyzes tabular marketing campaign data provided as structured arrays or objects. It performs summary statistics, identifies trends, segments data by key marketing dimensions, and highlights actionable insights. The output is a detailed report containing aggregated metrics, correlation analyses, and segmentation summaries to support campaign optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "tableData", + "type": "array", + "description": "Array of objects representing rows of marketing data, each object with key-value pairs for columns (e.g., clicks, impressions, conversions).", + "required": true, + "defaultValue": "" + }, + { + "name": "groupByColumns", + "type": "array", + "description": "List of column names to group data by for segmentation and aggregation (e.g., 'region', 'channel').", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metrics", + "type": "array", + "description": "List of numeric metric columns to analyze (e.g., 'clicks', 'CTR', 'revenue').", + "required": true, + "defaultValue": "" + }, + { + "name": "timePeriodColumn", + "type": "string", + "description": "Name of the column representing time periods (e.g., 'date' or 'week') to analyze trends over time.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCorrelationAnalysis", + "type": "boolean", + "description": "Flag to perform correlation analysis among numeric metrics, to identify relationships.", + "required": false, + "defaultValue": "false" + }, + { + "name": "trendAnalysisPeriod", + "type": "number", + "description": "Number of time units (rows) to consider when detecting trend changes, if timePeriodColumn is set.", + "required": false, + "defaultValue": "7" + } + ], + "returns": { + "type": "object", + "description": "An object containing aggregated statistics (sums, averages) per grouping, trend analyses over time, correlation coefficients among metrics, and identified segments with key insights." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw tabular marketing data, such as campaign performance logs, and need to automatically extract summaries, segment insights, identify metric correlations, and track trends to optimize marketing decisions.", + "limitations": "Cannot process unstructured data formats like images or text blobs; requires well-structured tabular data with consistent column names; does not generate predictive models or forecast future performance; analysis limited to provided numeric and categorical fields.", + "examples": [ + "Analyze campaign performance table to summarize clicks and conversions by channel and region.", + "Provide trend insights over weekly data to identify performance dips.", + "Find correlations among impressions, clicks, and revenue in marketing dataset." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "data-table", + "segmentation", + "trend-analysis", + "correlation" + ], + "examples": [ + { + "inputJson": "{\"tableData\":[{\"date\":\"2023-05-01\",\"channel\":\"email\",\"region\":\"north\",\"clicks\":150,\"impressions\":3000,\"conversions\":20},{\"date\":\"2023-05-01\",\"channel\":\"social\",\"region\":\"north\",\"clicks\":200,\"impressions\":4000,\"conversions\":25},{\"date\":\"2023-05-02\",\"channel\":\"email\",\"region\":\"south\",\"clicks\":120,\"impressions\":2800,\"conversions\":15}],\"groupByColumns\":[\"channel\",\"region\"],\"metrics\":[\"clicks\",\"impressions\",\"conversions\"],\"timePeriodColumn\":\"date\",\"includeCorrelationAnalysis\":true,\"trendAnalysisPeriod\":2}", + "description": "Analyze marketing campaign data grouped by channel and region with correlation and trend analysis over daily dates." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Table", + "context": null + } + }, + { + "name": "marketing-automation.analyzeDataset", + "description": "Analyzes marketing datasets by processing campaign performance metrics, customer engagement data, and sales figures. Accepts datasets in CSV or JSON format and returns actionable insights including key performance indicators, trend analysis, and segment-specific recommendations to optimize marketing strategies.", + "category": "marketing-automation", + "parameters": [ + { + "name": "dataset", + "type": "string", + "description": "The marketing dataset content as a CSV string or JSON array of objects to be analyzed.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "Format of the input dataset: 'csv' or 'json'.", + "required": true, + "defaultValue": "csv" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of detail for analysis: 'summary' for high-level KPIs, 'detailed' for in-depth segment and trend insights.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "dateRange", + "type": "object", + "description": "Optional filter for the analysis to a specific date range with 'startDate' and 'endDate' in ISO format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "segments", + "type": "array", + "description": "Optional list of customer segments or campaign IDs to focus the analysis on specific groups.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing overall performance metrics, trend graphs data arrays, segment-wise analysis summaries, and actionable recommendations as strings." + }, + "aiAgent": { + "useCase": "Use this tool when needing to derive insights from raw marketing campaign data to inform decision making. It is ideal for summarizing campaign effectiveness, identifying trends across time, or detecting high-value customer segments for targeted marketing.", + "limitations": "This tool cannot perform predictive modeling beyond trend analysis or handle datasets with unstructured data such as images or raw text. It requires properly formatted CSV or JSON input with recognized marketing fields.", + "examples": [ + "Analyze a CSV dataset of last quarter email campaigns to get summary KPIs and trend insights.", + "Provide detailed analysis on JSON dataset focusing on the segment of high-spending customers.", + "Filter dataset by last 6 months and analyze performance of social media campaigns across different regions." + ] + }, + "tags": [ + "marketing", + "automation", + "data-analysis", + "campaign-performance", + "customer-segmentation", + "insights" + ], + "examples": [ + { + "inputJson": "{\"dataset\":\"campaignId,date,segment,impressions,clicks,conversions,revenue\\nC101,2024-01-01,young-adults,10000,500,50,2500\\nC102,2024-01-02,middle-aged,8000,400,40,2000\",\"dataFormat\":\"csv\",\"analysisDepth\":\"summary\"}", + "description": "Analyze a CSV dataset of two marketing campaigns for a summary of key performance indicators." + }, + { + "inputJson": "{\"dataset\":[{\"campaignId\":\"C201\",\"date\":\"2024-03-15\",\"segment\":\"vip-customers\",\"impressions\":5000,\"clicks\":250,\"conversions\":30,\"revenue\":3000},{\"campaignId\":\"C202\",\"date\":\"2024-03-16\",\"segment\":\"new-users\",\"impressions\":7000,\"clicks\":350,\"conversions\":45,\"revenue\":2250}],\"dataFormat\":\"json\",\"analysisDepth\":\"detailed\",\"segments\":[\"vip-customers\"]}", + "description": "Analyze a JSON dataset focusing on VIP customer segment with detailed insights." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Dataset", + "context": null + } + }, + { + "name": "marketing-automation.analyzeCSV", + "description": "Analyzes marketing campaign data from a CSV file input, extracting key performance indicators such as open rates, click-through rates, conversion metrics, and customer segment statistics. Outputs a structured JSON report summarizing insights and trends for campaign optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "csvData", + "type": "string", + "description": "Raw CSV data as a string containing marketing campaign results (required columns like email, open_rate, click_rate, conversions).", + "required": true, + "defaultValue": "" + }, + { + "name": "dateColumn", + "type": "string", + "description": "The column name representing the date of each campaign entry, used for time-based analysis.", + "required": false, + "defaultValue": "date" + }, + { + "name": "segmentColumn", + "type": "string", + "description": "The column name for customer segments to analyze performance by segment.", + "required": false, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of metric column names to analyze (e.g., ['open_rate','click_rate','conversions']).", + "required": false, + "defaultValue": "[\"open_rate\",\"click_rate\",\"conversions\"]" + }, + { + "name": "groupByDate", + "type": "boolean", + "description": "Whether to aggregate and analyze metrics over date periods.", + "required": false, + "defaultValue": "true" + }, + { + "name": "dateAggregation", + "type": "string", + "description": "The date aggregation period: daily, weekly, or monthly. Applies only if groupByDate is true.", + "required": false, + "defaultValue": "weekly" + } + ], + "returns": { + "type": "object", + "description": "A JSON object summarizing analyzed metrics including averages, trends over time, segment breakdowns, and key insights for marketing campaign performance." + }, + "aiAgent": { + "useCase": "Use this tool to automatically analyze bulk CSV data from marketing campaigns to understand campaign effectiveness, identify successful customer segments, and track performance trends over time for data-driven decision making.", + "limitations": "Cannot process CSVs missing essential marketing metrics columns; does not perform causal analysis or predict future trends, only summarizes historical data.", + "examples": [ + "Analyze the CSV file of last quarter's email campaign performance to find trends in open and click rates.", + "Provide segment-wise conversion analysis from a CSV export of marketing data.", + "Summarize weekly performance metrics from a CSV marketing report for management review." + ] + }, + "tags": [ + "marketing", + "automation", + "csv", + "analysis", + "campaign", + "metrics", + "segmentation", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"csvData\":\"email,date,segment,open_rate,click_rate,conversions\\njohn@example.com,2023-04-01,A,0.45,0.12,2\\nsara@example.com,2023-04-01,B,0.50,0.15,1\\njohn@example.com,2023-04-08,A,0.50,0.10,3\",\"dateColumn\":\"date\",\"segmentColumn\":\"segment\",\"metrics\":[\"open_rate\",\"click_rate\",\"conversions\"],\"groupByDate\":true,\"dateAggregation\":\"weekly\"}", + "description": "Analyze weekly aggregated open, click rates, and conversions by segment from a marketing campaign CSV." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "CSV", + "context": null + } + }, + { + "name": "marketing-automation.analyzeDocument", + "description": "This tool accepts marketing campaign documents (plain text, HTML, or PDF) to analyze content effectiveness by extracting key marketing metrics, sentiment, and keyword density. It processes the input document to provide structured insights such as sentiment scores, prominent keywords, and suggested improvements, enabling data-driven marketing optimization.", + "category": "marketing-automation", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "Raw text content or full text extracted from the document to analyze", + "required": true, + "defaultValue": "" + }, + { + "name": "documentFormat", + "type": "string", + "description": "Format of the input document, e.g., 'text', 'html', or 'pdf'", + "required": true, + "defaultValue": "text" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the document content, e.g., 'en' for English", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeSentimentAnalysis", + "type": "boolean", + "description": "Whether to perform sentiment analysis on the document", + "required": false, + "defaultValue": "true" + }, + { + "name": "keywordsLimit", + "type": "number", + "description": "Maximum number of top keywords to extract and report", + "required": false, + "defaultValue": "10" + } + ], + "returns": { + "type": "object", + "description": "An analysis report including sentiment score, identified keywords with frequencies, content readability score, and improvement suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically analyze marketing campaign documents to extract insights such as sentiment, keyword prominence, and content effectiveness. It is ideal for optimizing marketing materials, assessing campaign messaging success, or summarizing document content for decision-making.", + "limitations": "This tool cannot interpret multimedia content embedded in documents, does not provide translation services, and analysis quality depends on the clarity and language of the input document. It does not replace expert marketing strategy but supports quantitative content analysis.", + "examples": [ + "Analyze the effectiveness and sentiment of a product launch email campaign document.", + "Extract key marketing keywords and sentiment from a recent newsletter HTML file.", + "Provide content improvement suggestions based on sentiment and keyword analysis for a social media marketing brochure." + ] + }, + "tags": [ + "marketing", + "automation", + "document analysis", + "sentiment analysis", + "keyword extraction", + "content optimization" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"Dear customers, our new product launches next week! Exciting features await you.\",\"documentFormat\":\"text\",\"language\":\"en\",\"includeSentimentAnalysis\":true,\"keywordsLimit\":5}", + "description": "Analyze a short product launch message text for sentiment and top keywords." + }, + { + "inputJson": "{\"documentContent\":\" 30 8 2 Monthly Newsletter
Discover our latest offers and news!
\",\"documentFormat\":\"html\",\"language\":\"en\",\"includeSentimentAnalysis\":true,\"keywordsLimit\":8}", + "description": "Analyze an HTML newsletter content to extract marketing insights." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Document", + "context": null + } + }, + { + "name": "marketing-automation.sendComment", + "description": "Sends a comment as part of a marketing campaign interaction to a specified platform or user. Accepts text content, target recipient details, and optional metadata like campaign identifiers. Processes the input to format and send the comment, then returns a status and any platform response.", + "category": "marketing-automation", + "parameters": [ + { + "name": "commentText", + "type": "string", + "description": "The text content of the comment to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientId", + "type": "string", + "description": "Identifier for the recipient user or entity to receive the comment.", + "required": true, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "The platform or communication channel where the comment will be posted (e.g., social media platform, CRM).", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Optional identifier for the marketing campaign related to this comment.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional object containing additional data such as tags, timestamps, or priorities related to the comment.", + "required": false, + "defaultValue": "" + }, + { + "name": "isPublic", + "type": "boolean", + "description": "Flag indicating if the comment should be public or private (default is true for public).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the send operation, message ID if applicable, timestamp, and any error message." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate sending comments or replies in a marketing campaign context, such as posting on social media, responding to leads, or adding comments within CRM systems to engage customers. It enables seamless interaction as part of automated outreach programs.", + "limitations": "This tool does not analyze comment content for sentiment or compliance, nor does it manage complex conversation threads or responses. It only sends one comment per call, without follow-up tracking.", + "examples": [ + "Send a promotional comment to a lead's profile on LinkedIn within campaign ID 2024Q2.", + "Post a public comment on the company Facebook page engaging users about a new product launch.", + "Send a private comment within a CRM record linked to a specific customer interaction." + ] + }, + "tags": [ + "marketing", + "automation", + "comment", + "communication", + "campaign", + "social media", + "crm" + ], + "examples": [ + { + "inputJson": "{\"commentText\":\"Great feedback, thank you for sharing!\",\"recipientId\":\"customer_12345\",\"platform\":\"CRM\",\"campaignId\":\"spring_launch_2024\",\"metadata\":{\"priority\":\"high\"},\"isPublic\":false}", + "description": "Send a private comment within a CRM system to a specific customer record with high priority tag." + }, + { + "inputJson": "{\"commentText\":\"Check out our new discounts available now!\",\"recipientId\":\"page_admin_6789\",\"platform\":\"Facebook\",\"campaignId\":\"discount_campaign_04\",\"isPublic\":true}", + "description": "Post a public promotional comment on a Facebook page as part of a discount campaign." + }, + { + "inputJson": "{\"commentText\":\"Thank you for your interest! We'll get back shortly.\",\"recipientId\":\"lead_54321\",\"platform\":\"LinkedIn\",\"campaignId\":\"lead_engagement_Q2\",\"isPublic\":true}", + "description": "Send a public comment reply to a lead on LinkedIn during a Q2 engagement campaign." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "marketing-automation.analyzeReport", + "description": "Analyzes marketing campaign reports by accepting structured report data in JSON or CSV format, extracting key performance metrics like engagement rates, conversion rates, and ROI, and generating a summarized analysis with insights and recommendations to optimize future campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "reportData", + "type": "string", + "description": "Raw report data content as JSON or CSV string containing marketing campaign metrics.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "Format of the input report data: 'json' or 'csv'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "campaignId", + "type": "string", + "description": "Optional identifier for the campaign to focus the analysis on specific data segments.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to generate actionable marketing recommendations based on the analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') for the generated analysis summary and recommendations.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing a summary with key metrics, insights, and optional recommendations for optimizing marketing campaigns." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent receives raw or structured marketing report data and needs to extract meaningful insights and performance metrics to help evaluate campaign effectiveness or to guide marketing strategy adjustments.", + "limitations": "Cannot generate analysis from unstructured text reports or purely qualitative data; relies on structured numerical campaign data. Does not replace deep domain expert analysis for complex marketing decisions.", + "examples": [ + "Analyze the Q2 social media campaign report data and provide insights along with optimization tips.", + "Given CSV data from last month's email marketing campaigns, summarize performance and suggest areas of improvement.", + "Evaluate the JSON report from a digital ad campaign and generate an English summary highlighting key outcomes." + ] + }, + "tags": [ + "marketing", + "automation", + "analysis", + "report", + "campaign", + "performance", + "insights" + ], + "examples": [ + { + "inputJson": "{\"reportData\":\"{\\\"campaigns\\\":[{\\\"id\\\":\\\"camp123\\\",\\\"impressions\\\":10000,\\\"clicks\\\":500,\\\"conversions\\\":50,\\\"cost\\\":2000}]}\",\"dataFormat\":\"json\",\"campaignId\":\"camp123\",\"includeRecommendations\":true,\"language\":\"en\"}", + "description": "Analyze a JSON report for campaign 'camp123' providing performance summary and recommendations." + }, + { + "inputJson": "{\"reportData\":\"campaignId,impressions,clicks,conversions,cost\\ncamp789,20000,1000,80,3500\",\"dataFormat\":\"csv\",\"includeRecommendations\":false,\"language\":\"en\"}", + "description": "Analyze CSV data for a marketing report without recommendations, focus on key metrics." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "analyze", + "object": "Report", + "context": null + } + }, + { + "name": "marketing-automation.sendReply", + "description": "Sends a personalized reply message as part of a marketing automation workflow. Accepts recipient contact info, message content, and optional scheduling parameters. Processes the inputs to dispatch the reply via email or SMS and returns delivery status and message ID.", + "category": "marketing-automation", + "parameters": [ + { + "name": "recipientContact", + "type": "object", + "description": "The contact information of the recipient, including at least email or phone number fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The text or HTML content of the reply message to be sent to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "Channel to send the reply through; options include 'email' or 'sms'. Defaults to 'email'.", + "required": false, + "defaultValue": "\"email\"" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule the message in the future. If omitted, message is sent immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier or name of the sender for display purposes, such as 'Marketing Team'.", + "required": false, + "defaultValue": "" + }, + { + "name": "trackingEnabled", + "type": "boolean", + "description": "Whether to enable tracking for link clicks and opens in the reply message; defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing status of the send request, a unique message ID, and optional error details if sending failed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically send follow-up or reply messages to contacts during marketing campaigns, either instantly or scheduled. It handles communication via email or SMS, allows message personalization, and returns delivery status for campaign tracking.", + "limitations": "Does not compose message content or handle multi-language translations. Cannot guarantee delivery as it's subject to external channel providers' reliability. Does not support rich media attachments beyond plain text or embedded HTML.", + "examples": [ + "Send a thank-you reply email immediately after a lead signs up.", + "Schedule an SMS reply a day later thanking a user for their purchase.", + "Send a promotional email reply with tracking enabled for click analytics." + ] + }, + "tags": [ + "marketing", + "automation", + "communication", + "email", + "sms", + "reply", + "campaign", + "scheduling" + ], + "examples": [ + { + "inputJson": "{\"recipientContact\":{\"email\":\"customer@example.com\"},\"messageContent\":\"Thank you for your interest! We will contact you shortly.\",\"channel\":\"email\",\"trackingEnabled\":true}", + "description": "Send an immediate thank-you reply email with tracking enabled." + }, + { + "inputJson": "{\"recipientContact\":{\"phone\":\"+1234567890\"},\"messageContent\":\"Hi! Thanks for your recent purchase. Let us know if you have questions.\",\"channel\":\"sms\",\"scheduleTime\":\"2024-07-01T10:00:00Z\"}", + "description": "Schedule an SMS reply message to be sent on July 1, 2024, at 10 AM UTC." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "marketing-automation.sendMention", + "description": "Sends a mention message to a specified social media platform or marketing channel. Accepts parameters defining the recipient handle, message content, and optional media attachments. Processes the message and schedules or immediately publishes the mention. Returns the delivery status and metadata of the sent mention.", + "category": "marketing-automation", + "parameters": [ + { + "name": "platform", + "type": "string", + "description": "The social media or marketing platform to send the mention on (e.g., Twitter, Instagram, LinkedIn).", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientHandle", + "type": "string", + "description": "The handle or username of the recipient to mention or tag in the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The content of the mention message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "mediaUrls", + "type": "array", + "description": "An optional array of URLs linking to images or media to attach to the mention message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "An optional ISO 8601 datetime string to schedule the mention for future delivery. If empty or omitted, sends immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional list of hashtags or tags to include in the mention message to increase reach.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the status of the mention (e.g., sent, scheduled, failed), a unique mention ID, timestamp of the action, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to automate outreach or brand engagement by mentioning specific users or channels across social media or marketing platforms. Ideal for campaign automation, influencer engagement, or prompt responses to trending topics by tagging relevant accounts.", + "limitations": "Cannot compose the message content meaningfully; relies on input text. Does not handle responses or inbound messages. Delivery depends on third-party platform API availability and rate limits.", + "examples": [ + "Send a mention on Twitter to @brandpartner thanking them for collaboration.", + "Schedule an Instagram mention tagging @influencer with promotional message and attached image.", + "Immediately mention @customer on LinkedIn with a personalized offer message." + ] + }, + "tags": [ + "marketing", + "automation", + "social-media", + "mention", + "outreach", + "campaign", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"platform\":\"Twitter\",\"recipientHandle\":\"@openai\",\"message\":\"Thanks for the great work! #AI\",\"mediaUrls\":[],\"scheduleTime\":\"\",\"tags\":[\"#AI\"]}", + "description": "Send an immediate mention on Twitter to @openai with a thank you message including a hashtag." + }, + { + "inputJson": "{\"platform\":\"Instagram\",\"recipientHandle\":\"@techguru\",\"message\":\"Check out our new product launch!\",\"mediaUrls\":[\"https://example.com/image1.jpg\"],\"scheduleTime\":\"2024-07-01T10:00:00Z\",\"tags\":[\"#Launch\"]}", + "description": "Schedule an Instagram mention to @techguru with an attached product image and a launch hashtag." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "marketing-automation.sendEmail", + "description": "Sends an email marketing campaign to a list of recipients. Accepts inputs for sender details, recipient email addresses, email subject, HTML or plain text content, and optional attachments or scheduling info. Processes the email sending via a configured SMTP or email service provider and returns a summary status with message IDs and any errors.", + "category": "marketing-automation", + "parameters": [ + { + "name": "senderEmail", + "type": "string", + "description": "The email address that appears as the sender of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmails", + "type": "array", + "description": "Array of recipient email addresses to send the email to.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentHtml", + "type": "string", + "description": "The HTML content of the email body. Either contentHtml or contentText must be provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "contentText", + "type": "string", + "description": "The plain text content of the email body. Either contentHtml or contentText must be provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachments where each attachment is an object with filename and base64 encoded content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "sendAt", + "type": "string", + "description": "Optional ISO 8601 date-time string to schedule the email for future sending.", + "required": false, + "defaultValue": "" + }, + { + "name": "replyTo", + "type": "string", + "description": "Optional email address for reply-to field in the email header.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a status indicator, a list of message IDs for successfully sent emails, and any error messages if failures occurred." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to automate sending marketing emails or newsletters to multiple recipients with customized content, attachments, or scheduled delivery. The tool helps in managing bulk email sending through standard email providers or services and tracking the send status.", + "limitations": "Cannot create or manage email lists; does not handle advanced personalization beyond static content; does not track open rates or clicks; requires configured email service credentials outside this tool.", + "examples": [ + "Send a promotional email to 500 customers with html content scheduled for next Monday.", + "Send a plain-text reminder email to a small list of subscribers immediately.", + "Send an email with PDF attachment to a business client with reply-to address specified." + ] + }, + "tags": [ + "email", + "marketing", + "automation", + "campaign", + "bulk-send", + "schedule", + "attachments" + ], + "examples": [ + { + "inputJson": "{\"senderEmail\":\"promo@company.com\",\"recipientEmails\":[\"user1@example.com\",\"user2@example.com\"],\"subject\":\"Summer Sale is Here!\",\"contentHtml\":\"Don\\'t miss our summer sale!
Up to 50% off on all items.
\",\"sendAt\":\"2024-06-01T09:00:00Z\"}", + "description": "Schedule sending an HTML email announcing a summer sale to two recipients for June 1st." + }, + { + "inputJson": "{\"senderEmail\":\"newsletter@company.com\",\"recipientEmails\":[\"subscriber@example.com\"],\"subject\":\"Monthly Newsletter\",\"contentText\":\"Hello, here is our monthly newsletter.\",\"replyTo\":\"support@company.com\"}", + "description": "Send an immediate plain text newsletter email with a reply-to address set." + }, + { + "inputJson": "{\"senderEmail\":\"sales@company.com\",\"recipientEmails\":[\"client@example.com\"],\"subject\":\"Your Invoice\",\"contentText\":\"Please find attached the invoice for your order.\",\"attachments\":[{\"filename\":\"invoice.pdf\",\"content\":\"JVBERi0xLjQKJbX...\"}]}", + "description": "Send an invoice email with a PDF attachment to a client." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "marketing-automation.sendAlert", + "description": "This tool sends marketing security alerts to designated recipients when suspicious activities or threats related to marketing campaigns are detected. It accepts alert details like message, severity, recipient list, and optional scheduling info, then processes them to dispatch notifications via email or SMS. It outputs the status of the alert dispatch attempt including success or error details.", + "category": "marketing-automation", + "parameters": [ + { + "name": "alertMessage", + "type": "string", + "description": "The main content or message of the alert to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Indicates the urgency or importance of the alert, e.g., low, medium, high.", + "required": true, + "defaultValue": "medium" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient contacts (emails or phone numbers) to receive the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "contactMethod", + "type": "string", + "description": "Preferred method to send the alert, such as 'email' or 'sms'.", + "required": true, + "defaultValue": "email" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp specifying when to send the alert; immediate if empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Optional identifier to link the alert with a specific marketing campaign for context.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a success flag, a message summarizing the result, and if failed, error details." + }, + "aiAgent": { + "useCase": "Use this tool to automatically notify marketing security teams or stakeholders when suspicious activities, vulnerabilities, or breaches are detected in marketing campaigns. It helps automate alerting based on threat detection results or monitoring systems to ensure timely response and mitigate risks.", + "limitations": "This tool does not itself detect threats or analyze campaign data; it only sends alerts based on provided input. It also depends on proper recipient contact formats and does not guarantee delivery beyond attempted dispatch.", + "examples": [ + "Send a high severity alert to the security team by email about a detected phishing campaign targeting customers.", + "Schedule a low severity warning SMS alert for the marketing manager regarding unusual login attempts in the campaign dashboard.", + "Dispatch an immediate medium level alert to multiple emails about a detected vulnerability in the campaign software integration." + ] + }, + "tags": [ + "marketing", + "automation", + "alert", + "security", + "notification", + "campaign" + ], + "examples": [ + { + "inputJson": "{\"alertMessage\":\"Detected phishing attack in recent email blast targeting customers.\",\"severityLevel\":\"high\",\"recipients\":[\"security@example.com\"],\"contactMethod\":\"email\",\"scheduleTime\":\"\"}", + "description": "Send an immediate high severity email alert to security team about detected phishing." + }, + { + "inputJson": "{\"alertMessage\":\"Unusual login attempts detected in campaign management portal.\",\"severityLevel\":\"medium\",\"recipients\":[\"manager@example.com\",\"security@example.com\"],\"contactMethod\":\"email\",\"scheduleTime\":\"2024-07-01T09:00:00Z\"}", + "description": "Schedule medium severity email alert to manager and security about suspicious logins." + }, + { + "inputJson": "{\"alertMessage\":\"Possible data exposure from marketing integration plugin.\",\"severityLevel\":\"high\",\"recipients\":[\"security@example.com\"],\"contactMethod\":\"sms\",\"scheduleTime\":\"\"}", + "description": "Send immediate SMS high severity alert to security about data exposure issue." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "marketing-automation.sendMessage", + "description": "Sends a personalized marketing message to a target audience via specified communication channels such as email or SMS. Accepts recipient details, message content, channel selection, and optional scheduling parameters. Processes message templating with variables and outputs a delivery report summarizing success and failure counts.", + "category": "marketing-automation", + "parameters": [ + { + "name": "recipientList", + "type": "array", + "description": "An array of recipient objects containing contact information and personalization data.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageTemplate", + "type": "string", + "description": "The message content that may include placeholders for personalization variables.", + "required": true, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "The communication channel to send the message through, e.g., 'email' or 'sms'.", + "required": true, + "defaultValue": "" + }, + { + "name": "sendTime", + "type": "string", + "description": "Optional scheduled time in ISO 8601 format to send the message; if omitted, sends immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier representing the sender name or number as displayed to recipients.", + "required": false, + "defaultValue": "" + }, + { + "name": "trackingEnabled", + "type": "boolean", + "description": "Flag indicating if message tracking (opens, clicks) should be enabled.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A report object with total recipients, number of messages sent successfully, and any failures with error details." + }, + "aiAgent": { + "useCase": "Use this tool to automate delivery of marketing messages tailored to individual recipients via email or SMS. Ideal for campaigns requiring scheduled dispatch and personalization, enabling better audience engagement and tracking message delivery outcomes.", + "limitations": "This tool does not handle complex campaign analytics or automatic list segmentation; it only sends messages to provided recipient data. Does not generate message content or validate phone/email formats internally.", + "examples": [ + "Send a promotional email to a list of customers with personalized discount codes.", + "Schedule an SMS notification about a product launch to subscribers.", + "Send a marketing message immediately to a small list via email with tracking enabled." + ] + }, + "tags": [ + "marketing", + "automation", + "messaging", + "email", + "sms", + "personalization", + "campaign", + "delivery" + ], + "examples": [ + { + "inputJson": "{\"recipientList\":[{\"email\":\"user1@example.com\",\"name\":\"John\"},{\"email\":\"user2@example.com\",\"name\":\"Jane\"}],\"messageTemplate\":\"Hello {{name}}, check out our new offers!\",\"channel\":\"email\",\"sendTime\":\"\",\"senderId\":\"PromoTeam\",\"trackingEnabled\":true}", + "description": "Send a personalized email to two users immediately with tracking enabled." + }, + { + "inputJson": "{\"recipientList\":[{\"phone\":\"+1234567890\",\"name\":\"Alice\"}],\"messageTemplate\":\"Hi {{name}}, don't miss our flash sale!\",\"channel\":\"sms\",\"sendTime\":\"2024-06-30T09:00:00Z\",\"senderId\":\"ShopX\",\"trackingEnabled\":false}", + "description": "Schedule an SMS campaign message to Alice at a specific future time without tracking." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "sales-automation.sendReply", + "description": "Sends a customized reply message to a sales lead or customer via the specified communication channel. Accepts input such as recipient contact details, message content, and optional metadata, then processes and dispatches the message accordingly, returning the status and message ID if successful.", + "category": "sales-automation", + "parameters": [ + { + "name": "recipientContact", + "type": "object", + "description": "Contact details of the message recipient, including type and address (e.g., email or phone number).", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The content of the reply message to send to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "communicationChannel", + "type": "string", + "description": "The channel to send the reply through, such as 'email', 'sms', or 'chat'.", + "required": true, + "defaultValue": "email" + }, + { + "name": "subjectLine", + "type": "string", + "description": "Subject line for the message when using email channel; ignored otherwise.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the message, e.g., 'normal', 'high'.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional metadata or tags to annotate the message.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the result status, message identifier if sent successfully, and error details if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to send a direct, personalized reply to a prospect or customer during a sales process, automating communication across email, SMS, or chat channels based on contact information and message context.", + "limitations": "This tool does not handle message template generation, recipient validation beyond required fields, or conversation context management beyond single message sending.", + "examples": [ + "Send a follow-up email reply to a lead after a product demo.", + "Send an SMS reply acknowledging a customer's inquiry.", + "Send a chat reply with troubleshooting instructions through a supported channel." + ] + }, + "tags": [ + "sales", + "automation", + "communication", + "reply", + "lead management", + "customer engagement", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"recipientContact\":{\"type\":\"email\",\"address\":\"lead@example.com\"},\"messageContent\":\"Thank you for your interest in our product. Let me know if you have any questions.\",\"communicationChannel\":\"email\",\"subjectLine\":\"Thank you for your inquiry\",\"priority\":\"normal\",\"metadata\":{\"campaignId\":\"camp123\"}}", + "description": "Send an email reply thanking a lead after their inquiry." + }, + { + "inputJson": "{\"recipientContact\":{\"type\":\"phone\",\"address\":\"+1234567890\"},\"messageContent\":\"We have received your request and will get back to you shortly.\",\"communicationChannel\":\"sms\",\"priority\":\"high\",\"metadata\":{}}", + "description": "Send a high priority SMS reply acknowledging receipt of a request." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Reply", + "context": null + } + }, + { + "name": "marketing-automation.sendNotification", + "description": "Sends a marketing notification to a specified list of recipients via chosen channels such as email, SMS, or push notifications. Accepts recipient details, message content, channel preferences, and scheduling options; processes delivery through integrated marketing platforms; returns delivery status and summary report.", + "category": "marketing-automation", + "parameters": [ + { + "name": "recipients", + "type": "array", + "description": "Array of recipient contact objects including email, phone number, or device ID depending on channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageSubject", + "type": "string", + "description": "Subject line of the notification (applicable for email).", + "required": false, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "Main content of the notification message to send.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "List of channels to send notifications on, e.g., ['email','sms','push'].", + "required": true, + "defaultValue": "[\"email\"]" + }, + { + "name": "sendAt", + "type": "string", + "description": "Optional ISO 8601 datetime string to schedule sending in the future; if omitted sends immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the marketing campaign for tracking purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of notification, values like 'high','normal','low'.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object summarizing the delivery status for each recipient and channel, including success flags and error messages if any." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the delivery of marketing notifications or alerts across multiple communication channels with support for scheduling and campaign tracking. Ideal for multi-channel outreach campaigns targeting segmented user lists.", + "limitations": "This tool does not create the message content or manage recipient segmentation. It requires valid contact information formatted for the chosen channels and does not guarantee delivery as external system limitations apply.", + "examples": [ + "Send promotional emails and SMS notifications to a customer segment.", + "Schedule a push notification campaign for a mobile app to go live at a future time.", + "Send immediate alert notifications to all subscribers via email." + ] + }, + "tags": [ + "marketing", + "notification", + "automation", + "email", + "sms", + "push", + "campaign", + "scheduling" + ], + "examples": [ + { + "inputJson": "{\"recipients\":[{\"email\":\"john.doe@example.com\"},{\"email\":\"jane.smith@example.com\"}],\"messageSubject\":\"Spring Sale Launch!\",\"messageBody\":\"Dear customer, enjoy our exclusive spring sale with up to 50% off.\",\"channels\":[\"email\"],\"sendAt\":\"\",\"campaignId\":\"SPRING2024\",\"priority\":\"high\"}", + "description": "Send a high priority email notification about a spring sale to a list of recipients immediately." + }, + { + "inputJson": "{\"recipients\":[{\"phone\":\"+15551234567\"}],\"messageBody\":\"Your verification code is 123456.\",\"channels\":[\"sms\"],\"sendAt\":\"2024-07-01T09:00:00Z\",\"campaignId\":\"\",\"priority\":\"normal\"}", + "description": "Schedule an SMS notification with a verification code to send at 9 AM UTC on July 1, 2024." + }, + { + "inputJson": "{\"recipients\":[{\"deviceId\":\"device123\"}],\"messageBody\":\"Don't miss our app update with new features!\",\"channels\":[\"push\"],\"sendAt\":\"\",\"campaignId\":\"UPDATE2024\",\"priority\":\"normal\"}", + "description": "Send an immediate push notification alerting users about a new app update." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "sales-automation.sendMention", + "description": "Sends a mention notification to a user or group within a sales communication platform, referencing a specific sales lead or opportunity. Accepts recipient identifiers, a message with optional lead context, and sends a formatted mention to alert relevant parties. Returns confirmation of delivery status and message ID.", + "category": "sales-automation", + "parameters": [ + { + "name": "recipientIds", + "type": "array", + "description": "Array of user or group IDs to mention in the communication platform.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The content of the mention message to be sent, which can include dynamic placeholders.", + "required": true, + "defaultValue": "" + }, + { + "name": "leadId", + "type": "string", + "description": "Optional sales lead or opportunity ID to reference in the mention, linking communication to a specific sales record.", + "required": false, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "Identifier of the communication platform where the mention should be sent (e.g., Slack, Microsoft Teams).", + "required": true, + "defaultValue": "slack" + }, + { + "name": "urgent", + "type": "boolean", + "description": "Flag to indicate if the mention should be marked as urgent or prioritized in the recipient's interface.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the send action, the unique ID of the sent mention, timestamp, and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to proactively notify specific users or groups about updates or actions related to sales leads within supported communication platforms, ensuring timely awareness and collaboration.", + "limitations": "This tool cannot compose complex natural language messages automatically; it requires a predefined message input. It also cannot fetch recipient IDs or lead details by itself.", + "examples": [ + "Notify the sales team mentioned in Slack about a new lead needing attention.", + "Send an urgent mention to the account manager group in Microsoft Teams referencing lead 12345." + ] + }, + "tags": [ + "sales", + "communication", + "notification", + "lead-management", + "automation", + "mention", + "sales-automation" + ], + "examples": [ + { + "inputJson": "{\"recipientIds\":[\"U2345\",\"U6789\"],\"message\":\"Please review the latest update on lead 98765.\",\"leadId\":\"98765\",\"platform\":\"slack\",\"urgent\":false}", + "description": "Mention two users in Slack about an update on a sales lead." + }, + { + "inputJson": "{\"recipientIds\":[\"teamAccountManagers\"],\"message\":\"Urgent: Closing date is approaching for lead 12345.\",\"leadId\":\"12345\",\"platform\":\"microsoft-teams\",\"urgent\":true}", + "description": "Send an urgent mention to a group in Microsoft Teams about a critical lead deadline." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Mention", + "context": null + } + }, + { + "name": "marketing-automation.sendChannel", + "description": "Sends marketing campaign messages through a specified communication channel such as email, SMS, or push notifications. It accepts campaign content, recipient lists, and channel configurations, processes the dispatching of messages accordingly, and returns the delivery status and analytics data per message.", + "category": "marketing-automation", + "parameters": [ + { + "name": "channel", + "type": "string", + "description": "The communication channel to send messages through (e.g., 'email', 'sms', 'push').", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier of the marketing campaign to send.", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "object", + "description": "The message content including subject, body, and any multimedia attachments.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientList", + "type": "array", + "description": "Array of recipient objects containing contact details appropriate for the channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "sendTime", + "type": "string", + "description": "ISO 8601 timestamp indicating when to send messages. If omitted, send immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "trackingEnabled", + "type": "boolean", + "description": "If true, track message open rates and clicks where supported.", + "required": false, + "defaultValue": "true" + }, + { + "name": "priority", + "type": "string", + "description": "Send priority level, e.g., 'high', 'normal', or 'low'.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the overall send operation status, a list of per-recipient delivery results with status and message IDs, and analytics summary if tracking is enabled." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to dispatch marketing campaign messages through multiple communication channels with rich message content and recipient segmentation, coordinating timed sends and capturing delivery analytics. It is particularly useful for automated campaign execution and follow-up workflows.", + "limitations": "It does not create campaign content or manage recipient lists; those must be prepared beforehand. It cannot guarantee delivery but reports status received from service providers. It does not handle channel credential configuration.", + "examples": [ + "Send an email campaign with personalized content to a customer segment now.", + "Schedule SMS alerts via the campaign at a specific future date and time.", + "Send push notifications with tracking enabled for app users in a campaign." + ] + }, + "tags": [ + "marketing", + "automation", + "send", + "channel", + "campaign", + "communication", + "email", + "sms", + "push" + ], + "examples": [ + { + "inputJson": "{\"channel\":\"email\",\"campaignId\":\"cmp12345\",\"content\":{\"subject\":\"Spring Sale!\",\"body\":\"Enjoy 20% off on all items.\",\"attachments\":[]},\"recipientList\":[{\"email\":\"user1@example.com\"},{\"email\":\"user2@example.com\"}],\"trackingEnabled\":true}", + "description": "Send an immediate email campaign to two recipients with tracking enabled." + }, + { + "inputJson": "{\"channel\":\"sms\",\"campaignId\":\"cmp67890\",\"content\":{\"body\":\"Flash Sale! 50% off. Visit our site now.\"},\"recipientList\":[{\"phoneNumber\":\"+1234567890\"},{\"phoneNumber\":\"+1987654321\"}],\"sendTime\":\"2024-07-01T10:00:00Z\",\"trackingEnabled\":false}", + "description": "Schedule an SMS blast for a flash sale to two phone numbers without tracking, to send at a specific future time." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "sales-automation.sendComment", + "description": "Sends a comment or note to a specified lead or contact within the sales CRM system. Accepts lead ID and comment text as input, optionally including metadata such as author ID and visibility scope. Processes and adds the comment to the lead's record, returning status confirming successful posting with timestamp and comment ID.", + "category": "sales-automation", + "parameters": [ + { + "name": "leadId", + "type": "string", + "description": "Unique identifier of the lead or contact to which the comment will be attached.", + "required": true, + "defaultValue": "" + }, + { + "name": "commentText", + "type": "string", + "description": "The content of the comment or note to be sent to the lead's record.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorId", + "type": "string", + "description": "Identifier of the user or agent sending the comment, for audit purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "visibility", + "type": "string", + "description": "Visibility scope of the comment (e.g., 'internal' or 'public'). Determines who can see the comment.", + "required": false, + "defaultValue": "internal" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp for the comment. If omitted, system's current time is used.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing success status, posted comment ID, timestamp, and an optional message." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to add contextual remarks, updates, or follow-up notes directly to a lead's profile within a sales CRM. Ideal for tracking interactions, sharing insights with sales team members, or logging communication details automatically during automated sales workflows.", + "limitations": "This tool does not retrieve existing comments, modify or delete comments once posted, or send notifications to leads. It only adds new comment entries to lead records.", + "examples": [ + "Add a follow-up note to lead ID 'L12345' after a call.", + "Log an internal comment noting the lead's interest level for sales review.", + "Send a public comment to a lead visible to the client on their portal." + ] + }, + "tags": [ + "sales", + "crm", + "commenting", + "lead-management", + "automation", + "notes", + "communication" + ], + "examples": [ + { + "inputJson": "{\"leadId\":\"L12345\",\"commentText\":\"Spoke with client, interested in premium plan.\",\"authorId\":\"U6789\",\"visibility\":\"internal\"}", + "description": "Adding an internal comment summarizing a client call outcome." + }, + { + "inputJson": "{\"leadId\":\"L98765\",\"commentText\":\"Sent proposal documents as requested.\",\"authorId\":\"U6789\"}", + "description": "Logging a note about sending proposal documents; visibility defaults to internal." + }, + { + "inputJson": "{\"leadId\":\"L54321\",\"commentText\":\"Client viewed contract and approved terms.\",\"authorId\":\"U4321\",\"visibility\":\"public\",\"timestamp\":\"2024-06-01T14:30:00Z\"}", + "description": "Posting a public comment with a specific timestamp, visible to the client." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Comment", + "context": null + } + }, + { + "name": "sales-automation.sendChannel", + "description": "Sends a sales communication message through a specified channel such as email, SMS, or social media. Accepts inputs including message content, recipient details, and channel type. Processes the inputs by formatting and dispatching the message via the chosen channel, returning the status of the send operation including success or failure details.", + "category": "sales-automation", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of communication channel to send the message through (e.g., 'email', 'sms', 'socialMedia').", + "required": true, + "defaultValue": "" + }, + { + "name": "recipient", + "type": "object", + "description": "Object containing recipient details like email address, phone number, or social media handle.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The text content of the message to send to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for email messages. Optional for other channels.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier or address of the sender (e.g., email address, phone number, or account handle).", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects (e.g., files or URLs) to include with the message. Optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the message, such as 'normal' or 'high'. Optional.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the message send request, including 'success' boolean, 'messageId' if applicable, and 'error' details if failed." + }, + "aiAgent": { + "useCase": "This tool is used to automate sending sales communications through various channels to leads or customers. An AI agent should use it when it needs to deliver personalized or bulk messages via email, SMS, or social platforms within a sales automation workflow. It facilitates faster outreach and follow-ups without manual intervention.", + "limitations": "This tool does not generate message content or manage lead data; it only handles sending messages through specified channels. It also depends on the availability and configuration of underlying messaging services or APIs and may not handle message templates or complex multi-step campaigns.", + "examples": [ + "Send promotional email to a lead with discount offer", + "Send SMS reminder about upcoming sales event", + "Post message via social media channel to engage new prospects" + ] + }, + "tags": [ + "sales", + "automation", + "communication", + "messaging", + "email", + "sms", + "socialMedia", + "leadManagement" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"recipient\":{\"email\":\"customer@example.com\"},\"messageContent\":\"Hello, we have a special offer just for you!\",\"subject\":\"Exclusive Discount Inside\",\"senderId\":\"sales@company.com\",\"attachments\":[],\"priority\":\"high\"}", + "description": "Send a high priority promotional email to a customer with subject and no attachments." + }, + { + "inputJson": "{\"channelType\":\"sms\",\"recipient\":{\"phoneNumber\":\"+1234567890\"},\"messageContent\":\"Reminder: your appointment is tomorrow at 10 AM.\",\"senderId\":\"CompanySMS\"}", + "description": "Send an SMS reminder message for an appointment to a customer's phone number." + }, + { + "inputJson": "{\"channelType\":\"socialMedia\",\"recipient\":{\"handle\":\"@leadUser\"},\"messageContent\":\"Check out our latest product updates! Visit our website for details.\"}", + "description": "Send a social media message to a user handle promoting product updates." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Channel", + "context": null + } + }, + { + "name": "marketing-automation.sendThread", + "description": "Sends a marketing communication thread comprising multiple messages to a target audience via specified channels. Accepts input parameters including recipient lists, message contents, channel selection, scheduling options, and tracking preferences. Processes the thread by queuing or dispatching messages accordingly and returns a status report including message IDs and delivery status.", + "category": "marketing-automation", + "parameters": [ + { + "name": "threadId", + "type": "string", + "description": "Unique identifier of the marketing thread to send, consisting of one or more coordinated messages.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientList", + "type": "array", + "description": "Array of recipient contact objects or identifiers specifying who will receive the messages.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "List of communication channels to send messages through, such as email, SMS, or push notifications.", + "required": true, + "defaultValue": "" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule when the thread should begin sending; sends immediately if empty or omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "trackDelivery", + "type": "boolean", + "description": "Flag indicating whether to track delivery and engagement metrics for the sent messages.", + "required": false, + "defaultValue": "true" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier for the sender profile or account used to send the thread messages.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the send operation, including success flag, message IDs for each sent message, and error information if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when orchestrating multi-message marketing campaigns that need to be sent as a thread or sequence across multiple communication channels to targeted recipient groups. It automates the dispatch and scheduling of threaded marketing content and provides feedback on send status and tracking.", + "limitations": "Does not create or design the messages; the thread content must already be defined. Does not handle message personalization beyond recipient addressing. Relies on external channel integrations for actual message delivery.", + "examples": [ + "Send a promotional email and SMS thread to all users who signed up last week.", + "Schedule a multi-part push notification campaign to app users next Monday.", + "Send a welcome message thread via email immediately to new subscribers using the marketing account." + ] + }, + "tags": [ + "marketing", + "automation", + "communication", + "messaging", + "campaign", + "multichannel", + "threading" + ], + "examples": [ + { + "inputJson": "{\"threadId\":\"welcomeThread2024\",\"recipientList\":[{\"email\":\"user1@example.com\"},{\"email\":\"user2@example.com\"}],\"channels\":[\"email\",\"sms\"],\"scheduleTime\":\"\",\"trackDelivery\":true,\"senderId\":\"marketingAccountA\"}", + "description": "Send a welcome thread immediately via email and SMS to specified users, tracking delivery." + }, + { + "inputJson": "{\"threadId\":\"promoSeq01\",\"recipientList\":[{\"phone\":\"+15551234567\"}],\"channels\":[\"sms\"],\"scheduleTime\":\"2024-07-01T09:00:00Z\",\"trackDelivery\":false}", + "description": "Schedule a promotional SMS thread to a phone number at a specific time, without tracking delivery." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "sales-automation.sendThread", + "description": "Sends a sales communication thread including one or more messages to a specified lead or contact. Accepts input such as recipient details, an array of message objects with content and optional attachments, and optional scheduling information. Processes the messages to deliver them via integrated email or messaging platforms. Returns a status summary with message IDs and delivery results.", + "category": "sales-automation", + "parameters": [ + { + "name": "recipientId", + "type": "string", + "description": "Unique identifier of the lead or contact to whom the thread will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "messages", + "type": "array", + "description": "An array of message objects composing the thread, each containing content, optional subject, and optional attachments.", + "required": true, + "defaultValue": "" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 datetime string to schedule the thread delivery in the future. If omitted, sends immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "communicationChannel", + "type": "string", + "description": "Channel to use for sending the thread, e.g., 'email', 'sms', or 'chat'. Defaults to 'email'.", + "required": false, + "defaultValue": "\"email\"" + }, + { + "name": "priority", + "type": "string", + "description": "Optional priority level of the thread, e.g., 'normal', 'high'.", + "required": false, + "defaultValue": "\"normal\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the overall status, individual message IDs, and any errors encountered during sending." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to automate sending a sequence of sales messages as a cohesive conversation thread to a lead or contact, potentially scheduling for future delivery and choosing communication channels. It helps streamline outreach and follow-ups with structured multistep threads.", + "limitations": "This tool does not create or manage leads; it assumes recipientId is valid. It does not handle inbound message parsing or responses. Attachments must follow supported formats externally validated before use.", + "examples": [ + "Send a three-message sales introduction thread to a new lead immediately by email.", + "Schedule a follow-up thread with personalized messages to be sent tomorrow via email.", + "Send a quick SMS message thread to a contact for a time-sensitive promotion." + ] + }, + "tags": [ + "sales", + "automation", + "communication", + "messaging", + "lead-management", + "email", + "sms" + ], + "examples": [ + { + "inputJson": "{\"recipientId\":\"lead_123456\",\"messages\":[{\"subject\":\"Introduction\",\"content\":\"Hi, I wanted to introduce our new product line.\",\"attachments\":[]},{\"content\":\"Please let me know if you want a demo.\"}],\"communicationChannel\":\"email\"}", + "description": "Send a multi-message sales email thread immediately to a lead." + }, + { + "inputJson": "{\"recipientId\":\"contact_987\",\"messages\":[{\"content\":\"Don't miss our limited offer!\"}],\"scheduleTime\":\"2024-12-01T09:00:00Z\",\"communicationChannel\":\"sms\",\"priority\":\"high\"}", + "description": "Schedule a high priority SMS message thread to be sent in the future to a contact." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Thread", + "context": null + } + }, + { + "name": "sales-automation.sendMessage", + "description": "This tool sends a personalized sales message to one or more leads. It accepts input including recipient contact details, message content, and optional scheduling or channel preferences. The tool processes the inputs to dispatch messages via email or SMS and returns the status for each recipient (success, failure, error details).", + "category": "sales-automation", + "parameters": [ + { + "name": "recipients", + "type": "array", + "description": "List of recipients where each contains contact information such as email or phone number and optional lead metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The body of the sales message to be sent, which can include placeholders for personalization.", + "required": true, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "Preferred communication channel for the message, e.g., 'email' or 'sms'.", + "required": false, + "defaultValue": "email" + }, + { + "name": "sendImmediately", + "type": "boolean", + "description": "Whether to send the message immediately (true) or schedule for later (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "scheduledTime", + "type": "string", + "description": "ISO 8601 formatted date-time string to schedule the message; required if sendImmediately is false.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the sender as it should appear in the message.", + "required": false, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for email messages; ignored if channel is SMS.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object describing the delivery status for each recipient, including success or failure and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate outreach to sales leads by sending customized messages through email or SMS channels. Ideal for scenarios involving bulk messaging, personalized content, and scheduling communications to improve engagement.", + "limitations": "Does not generate message content or handle complex campaign analytics. Does not support channels other than email or SMS. Scheduling precision depends on system clock and may vary.", + "examples": [ + "Send a welcome email to new leads with their names personalized in the message.", + "Send an SMS reminder about a sales call scheduled tomorrow afternoon to multiple contacts.", + "Schedule an email campaign to launch after business hours targeting a curated list of leads." + ] + }, + "tags": [ + "sales", + "automation", + "messaging", + "lead management", + "email", + "sms", + "outreach" + ], + "examples": [ + { + "inputJson": "{\"recipients\":[{\"email\":\"alice@example.com\"},{\"email\":\"bob@example.com\"}],\"messageContent\":\"Hello {{name}}, we have a special offer for you!\",\"channel\":\"email\",\"sendImmediately\":true,\"senderName\":\"Sales Team\",\"subject\":\"Exclusive Offer Just for You\"}", + "description": "Send an immediate personalized email to multiple leads with a promotional message." + }, + { + "inputJson": "{\"recipients\":[{\"phone\":\"+1234567890\"}],\"messageContent\":\"Hi, just a reminder about your meeting tomorrow at 10 AM.\",\"channel\":\"sms\",\"sendImmediately\":true}", + "description": "Send an immediate SMS reminder to a single lead about their meeting." + }, + { + "inputJson": "{\"recipients\":[{\"email\":\"charlie@example.com\"}],\"messageContent\":\"Dear {{name}}, check out our new product launch next week.\",\"channel\":\"email\",\"sendImmediately\":false,\"scheduledTime\":\"2024-07-01T08:00:00Z\",\"senderName\":\"Marketing Team\",\"subject\":\"Upcoming Product Launch\"}", + "description": "Schedule an email to be sent in the future with personalized product launch details." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "sales-automation.sendNotification", + "description": "Sends a notification message to a specified recipient or group within a sales context, supporting various channels such as email, SMS, or in-app alerts. Accepts parameters defining recipient contact info, message content, delivery channel, and optional scheduling, processing these inputs to dispatch the notification and returning a status report of the delivery outcome.", + "category": "sales-automation", + "parameters": [ + { + "name": "recipient", + "type": "object", + "description": "Contact information of the notification recipient, e.g., email address or phone number.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "Content of the notification message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "Communication channel to use for sending the notification, e.g., 'email', 'sms', or 'inApp'.", + "required": true, + "defaultValue": "email" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule the notification for future delivery. If omitted, sends immediately.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification, e.g., 'normal' or 'high'. Higher priority may trigger more immediate delivery methods.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional data related to the notification for tracking or personalization purposes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the notification sending attempt, including success flag, message ID if successful, and error details if any." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automate sending actionable notifications to sales leads, customers, or team members using various communication channels. It supports immediate or scheduled messages with customizable priority and metadata for personalization and tracking.", + "limitations": "Does not handle recipient validation or channel-specific formatting errors beyond basic checks; success depends on external communication service availability and correct recipient contact info.", + "examples": [ + "Send a promotional email to a sales lead immediately.", + "Schedule an SMS reminder to a customer before an appointment.", + "Send an in-app alert to sales team members about an urgent lead update." + ] + }, + "tags": [ + "notification", + "sales", + "automation", + "communication", + "email", + "sms", + "scheduling" + ], + "examples": [ + { + "inputJson": "{\"recipient\":{\"email\":\"lead@example.com\"},\"message\":\"Exclusive offer just for you!\",\"channel\":\"email\",\"priority\":\"high\"}", + "description": "Send a high-priority promotional email notification to a sales lead." + }, + { + "inputJson": "{\"recipient\":{\"phone\":\"+1234567890\"},\"message\":\"Reminder: your sales appointment is tomorrow at 3 PM.\",\"channel\":\"sms\",\"scheduleTime\":\"2024-07-01T15:00:00Z\"}", + "description": "Schedule an SMS reminder to a customer one day before their appointment." + }, + { + "inputJson": "{\"recipient\":{\"userId\":\"sales_user_007\"},\"message\":\"New lead assigned to you: Acme Corp.\",\"channel\":\"inApp\"}", + "description": "Send an immediate in-app alert to a sales team member about a new lead assignment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "sales-automation.sendEmail", + "description": "This tool sends a customized sales email to one or multiple recipients. It accepts recipient email addresses, email subject, body content (which can be plain text or HTML), and optional CC and BCC fields. It processes these inputs by connecting to an SMTP or email API to deliver the message and returns a delivery status and message ID if successful.", + "category": "sales-automation", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses to receive the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content of the email; supports plain text or HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of email addresses for CC recipients.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of email addresses for BCC recipients.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Specifies if the email body is in HTML format; false means plain text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "from", + "type": "string", + "description": "Optional sender email address; defaults to configured sales email address if omitted.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'success' boolean, 'messageId' string if sent, and 'error' string if failed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to send sales outreach or follow-up emails automatically to leads or customers, enabling automation of communication in sales workflows, including bulk personalized messaging with tracking of delivery status.", + "limitations": "This tool does not generate email content or manage replies; it only sends emails as provided. It does not provide analytics or handle complex campaign scheduling.", + "examples": [ + "Send a follow-up email to a lead list with personalized links.", + "Send a bulk promotional email to multiple recipients with CC to the sales manager.", + "Send a HTML formatted invitation email for a sales webinar." + ] + }, + "tags": [ + "email", + "sales", + "automation", + "communication", + "outreach", + "bulk-send" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"lead@example.com\"],\"subject\":\"Special Offer Just for You!\",\"body\":\"Hello, we have an exclusive offer...\",\"isHtml\":false}", + "description": "Send a plain text sales offer email to one lead." + }, + { + "inputJson": "{\"to\":[\"client1@example.com\",\"client2@example.com\"],\"subject\":\"Upcoming Product Webinar\",\"body\":\"Join us for a webinar
Details inside...
\",\"isHtml\":true,\"cc\":[\"manager@example.com\"]}", + "description": "Send an HTML formatted webinar invitation to multiple clients, CCing the manager." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "copywriting.draftQuote", + "description": "Generates a compelling marketing or promotional quote based on given product or service details, target audience, tone, and keywords. It processes the inputs to create a concise, persuasive quote suitable for advertising or branding purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to promote", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Brief description highlighting key features or benefits", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience or customer segment for the quote", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the quote (e.g., inspirational, professional, playful)", + "required": false, + "defaultValue": "inspirational" + }, + { + "name": "keywords", + "type": "array", + "description": "List of important keywords to include or emphasize", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the quote in characters", + "required": false, + "defaultValue": "140" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated quote string" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create persuasive, short-form marketing quotes or taglines based on product specifics and marketing goals. Ideal for generating promotional content for ads, websites, and campaigns.", + "limitations": "Cannot guarantee trademark compliance or adapt to extremely niche industries without clear input. May produce quotes that need human refinement for brand voice consistency.", + "examples": [ + "Generate a motivational product quote for a new fitness app targeting young adults.", + "Draft a playful and catchy quote highlighting eco-friendly features of a brand of sneakers.", + "Create a professional quote promoting a consulting firm's new AI service, including keywords like efficiency and innovation." + ] + }, + "tags": [ + "copywriting", + "marketing", + "quote", + "branding", + "promotional", + "advertising", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoRun Sneakers\",\"productDescription\":\"Lightweight, stylish sneakers made from recycled materials.\",\"targetAudience\":\"eco-conscious millennials\",\"tone\":\"playful\",\"keywords\":[\"sustainable\",\"comfort\",\"style\"],\"maxLength\":100}", + "description": "Draft a playful, short quote promoting eco-friendly sneakers targeting millennials." + }, + { + "inputJson": "{\"productName\":\"AI Boost Consulting\",\"productDescription\":\"Consulting service specializing in AI-driven efficiency improvements.\",\"targetAudience\":\"business executives\",\"tone\":\"professional\",\"keywords\":[\"efficiency\",\"innovation\"],\"maxLength\":140}", + "description": "Generate a professional quote emphasizing AI-powered innovation for business executives." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Quote", + "context": null + } + }, + { + "name": "sales-automation.sendAlert", + "description": "Sends an automated alert to a specified sales or security team member when suspicious sales activities or potential security breaches are detected within sales processes. Accepts details about the alert context, urgency, and recipient contact information and returns the status of the alert delivery.", + "category": "sales-automation", + "parameters": [ + { + "name": "alertType", + "type": "string", + "description": "Type of alert to send, e.g., 'fraudDetection', 'unauthorizedAccess', or 'suspiciousActivity' in sales systems.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "Detailed message content describing the alert and relevant context for immediate action.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmails", + "type": "array", + "description": "List of email addresses to which the alert should be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "priorityLevel", + "type": "string", + "description": "Priority of the alert: 'low', 'medium', or 'high', influencing notification urgency.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "relatedLeadId", + "type": "string", + "description": "Optional sales lead identifier related to the alert for cross-reference in CRM systems.", + "required": false, + "defaultValue": "" + }, + { + "name": "sendSms", + "type": "boolean", + "description": "Whether to also send the alert as an SMS message for urgent notifications.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object including the alertId, sendStatus ('success' or 'failure'), and timestamp of alert dispatch." + }, + "aiAgent": { + "useCase": "Use this tool when suspicious activities or security concerns related to sales processes arise and an immediate, automated notification must be sent to responsible team members to prompt fast response and mitigation.", + "limitations": "This tool does not perform detection or analysis of suspicious activities; it only sends alerts based on inputs provided by other systems or analysis modules.", + "examples": [ + "Send alert to sales security about detected fraudulent transaction on a lead.", + "Notify a sales manager via email and SMS about unauthorized CRM access attempts.", + "Alert the security team about unusual lead activity with medium priority." + ] + }, + "tags": [ + "sales", + "automation", + "alert", + "security", + "notification", + "leadManagement", + "riskManagement" + ], + "examples": [ + { + "inputJson": "{\"alertType\":\"fraudDetection\",\"message\":\"Potential fraudulent transaction detected for lead ID 12345.\",\"recipientEmails\":[\"security@example.com\"],\"priorityLevel\":\"high\",\"relatedLeadId\":\"12345\",\"sendSms\":true}", + "description": "Sending a high priority fraud detection alert with SMS notification to the security team for a specific lead." + }, + { + "inputJson": "{\"alertType\":\"unauthorizedAccess\",\"message\":\"Unauthorized CRM access attempt detected.\",\"recipientEmails\":[\"salesmanager@example.com\"],\"priorityLevel\":\"medium\",\"sendSms\":false}", + "description": "Sending an alert email without SMS about unauthorized access attempt to a sales manager." + }, + { + "inputJson": "{\"alertType\":\"suspiciousActivity\",\"message\":\"Multiple failed login attempts detected on lead 98765's CRM record.\",\"recipientEmails\":[\"securityteam@example.com\", \"itadmin@example.com\"],\"priorityLevel\":\"medium\"}", + "description": "Sending a medium priority alert email to multiple recipients about suspicious login activity." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "copywriting.draftCitation", + "description": "This tool generates a properly formatted citation for a given source, based on the specified citation style (e.g., APA, MLA, Chicago). It accepts details about the source such as author(s), title, publication year, publisher, URL, and formats these inputs into a complete, polished citation string for academic or professional use.", + "category": "copywriting", + "parameters": [ + { + "name": "sourceType", + "type": "string", + "description": "Type of source to cite (e.g., book, journal, website, article)", + "required": true, + "defaultValue": "article" + }, + { + "name": "authors", + "type": "array", + "description": "List of author names in 'Last, First' format", + "required": true, + "defaultValue": "[]" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work or article being cited", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "string", + "description": "Year the work was published", + "required": false, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or publishing organization", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL or DOI of the source if applicable", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style format to use (e.g., APA, MLA, Chicago)", + "required": true, + "defaultValue": "APA" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the URL/source was accessed, for online citations (YYYY-MM-DD)", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string under 'citation' key." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce accurate, stylistically correct citations for given sources to include in academic papers, reports, or publications. It is Ideal for generating citations in various popular formats given structured source information.", + "limitations": "This tool cannot verify the correctness of input metadata or replace manual style guide consultation. It may not cover less common citation formats or complex source types like artworks or interviews.", + "examples": [ + "Generate an APA citation for a book by two authors published in 2018.", + "Create an MLA citation for a website including author, title, URL, and access date.", + "Format a Chicago style citation for a journal article with multiple authors." + ] + }, + "tags": [ + "copywriting", + "citation", + "academic", + "formatting", + "APA", + "MLA", + "Chicago" + ], + "examples": [ + { + "inputJson": "{\"sourceType\":\"book\",\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Effective Project Management\",\"publicationYear\":\"2018\",\"publisher\":\"Tech Press\",\"citationStyle\":\"APA\"}", + "description": "Draft APA citation for a two-author book published in 2018." + }, + { + "inputJson": "{\"sourceType\":\"website\",\"authors\":[\"Brown, Alice\"],\"title\":\"Understanding AI Ethics\",\"publicationYear\":\"\",\"publisher\":\"\",\"url\":\"https://aiexample.org/ethics\",\"citationStyle\":\"MLA\",\"accessDate\":\"2024-05-15\"}", + "description": "Create an MLA citation for a website with author and access date." + }, + { + "inputJson": "{\"sourceType\":\"journal\",\"authors\":[\"Lee, Mark\",\"King, Sarah\"],\"title\":\"Advances in Battery Technology\",\"publicationYear\":\"2020\",\"publisher\":\"Journal of Energy Science\",\"citationStyle\":\"Chicago\"}", + "description": "Format a Chicago style citation for a journal article with two authors published in 2020." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Citation", + "context": null + } + }, + { + "name": "copywriting.draftReference", + "description": "This tool drafts high-quality, professional reference letters or recommendation texts based on input details about the referee, referent, purpose, and key qualities. It generates fully formatted, personalized reference content suitable for academic, employment, or character references.", + "category": "copywriting", + "parameters": [ + { + "name": "referentName", + "type": "string", + "description": "Full name of the person who is being referenced in the text.", + "required": true, + "defaultValue": "" + }, + { + "name": "refereeName", + "type": "string", + "description": "Name of the person writing the reference or their title if preferred for formality.", + "required": false, + "defaultValue": "" + }, + { + "name": "relationship", + "type": "string", + "description": "Description of the relationship between referee and referent (e.g., supervisor, professor, colleague).", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "The purpose of the reference letter, such as job application, academic admission, or character endorsement.", + "required": true, + "defaultValue": "" + }, + { + "name": "qualities", + "type": "array", + "description": "An array of key qualities or achievements of the referent to highlight in the reference text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "length", + "type": "string", + "description": "Desired approximate length of the drafted reference: short, medium, or long.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the reference letter such as formal, friendly, or enthusiastic.", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted reference letter as a formatted string under the key 'referenceLetter'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a customized, coherent reference or recommendation letter quickly and professionally, based on structured user input about the people involved and the letter's context. Especially useful for generating drafts that users can further personalize.", + "limitations": "This tool cannot verify factual accuracy or provide legally binding statements. It relies solely on user-supplied information and cannot detect dishonesty or guarantee that the reference meets specific institutional criteria.", + "examples": [ + "Draft a formal employment reference for a software engineer applying to a tech company.", + "Write a character reference for a volunteer applying for a community service award.", + "Create an academic recommendation letter for a student applying for graduate school." + ] + }, + "tags": [ + "copywriting", + "reference letter", + "recommendation", + "professional writing", + "drafting", + "personalized", + "letter", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"referentName\":\"Jane Doe\",\"refereeName\":\"Dr. Robert Smith\",\"relationship\":\"Professor of Computer Science\",\"purpose\":\"graduate school admission\",\"qualities\":[\"strong analytical skills\",\"dedicated researcher\",\"excellent communication\"],\"length\":\"medium\",\"tone\":\"formal\"}", + "description": "Generate a formal academic recommendation letter for Jane Doe applying to graduate school, highlighting her skills and dedication." + }, + { + "inputJson": "{\"referentName\":\"Mark Johnson\",\"refereeName\":\"Samantha Lee\",\"relationship\":\"former manager\",\"purpose\":\"job application\",\"qualities\":[\"leadership\",\"team player\",\"project management\"],\"length\":\"short\",\"tone\":\"enthusiastic\"}", + "description": "Create a short, enthusiastic employment reference letter for Mark Johnson from his former manager Samantha Lee." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Reference", + "context": null + } + }, + { + "name": "copywriting.draftWord", + "description": "This tool generates a concise marketing or promotional word based on input parameters such as target audience, product type, desired tone, and optional keywords. It processes the inputs by selecting or creating a single impactful word suitable for branding, advertising, or campaign use, and outputs the generated word as a string.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "The primary demographic or customer segment the word should resonate with (e.g., 'young adults', 'tech enthusiasts').", + "required": true, + "defaultValue": "" + }, + { + "name": "productType", + "type": "string", + "description": "Type or category of product or service to associate the word with (e.g., 'energy drink', 'software').", + "required": true, + "defaultValue": "" + }, + { + "name": "desiredTone", + "type": "string", + "description": "Tone or feeling to convey (e.g., 'energetic', 'trustworthy', 'luxurious').", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional array of related keywords or concepts to inspire the word creation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the output word (e.g., 'en' for English).", + "required": false, + "defaultValue": "\"en\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word and explanation for its selection." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a catchy, single-word branding or promotional term tailored to a specific audience, product type, and tone. Ideal for suggesting impactful words for marketing campaigns or product names rapidly with creative context.", + "limitations": "This tool does not generate full taglines, slogans, or multi-word phrases. It also may not generate trademark-safe or legally vetted names, which require additional checks.", + "examples": [ + "Generate a powerful one-word brand name for a fitness app aimed at millennials with an energetic tone.", + "Create a catchy promotional word for a new luxury skincare line targeting middle-aged women.", + "Provide an innovative word related to eco-friendly packaging for environmentally conscious consumers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "branding", + "word generation", + "creative writing", + "promotional", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"young adults\",\"productType\":\"energy drink\",\"desiredTone\":\"energetic\",\"keywords\":[\"power\",\"boost\",\"vitality\"],\"language\":\"en\"}", + "description": "Generate an energetic promotional word for an energy drink targeting young adults." + }, + { + "inputJson": "{\"targetAudience\":\"business professionals\",\"productType\":\"productivity software\",\"desiredTone\":\"trustworthy\",\"keywords\":[\"efficiency\",\"time\",\"focus\"],\"language\":\"en\"}", + "description": "Create a trustworthy single-word brand name for productivity software aimed at business professionals." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Word", + "context": null + } + }, + { + "name": "copywriting.draftLink", + "description": "Generates a concise, engaging marketing or promotional snippet designed to accompany a URL link. Accepts the link URL and optional context keywords, tone, and length preferences. Produces a tailored text snippet suitable for social media posts, email campaigns, or web promotions to effectively drive user clicks and engagement.", + "category": "copywriting", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "contextKeywords", + "type": "array", + "description": "Optional keywords or topics to shape the message context and increase relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the text snippet, e.g., 'formal', 'casual', 'exciting'.", + "required": false, + "defaultValue": "\"casual\"" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the drafted text, ensuring compatibility with specific platform limits.", + "required": false, + "defaultValue": "140" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call-to-action phrase to include, such as 'Learn more', 'Shop now', or 'Discover'.", + "required": false, + "defaultValue": "\"\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted promotional text snippet optimized for the given URL and parameters." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create appealing and contextually relevant short promotional texts that accompany URLs to improve click-through rates and engagement on marketing channels like social media posts, newsletters, or ads. It tailors language style and length to fit target audiences and platform constraints.", + "limitations": "Cannot verify the actual content or safety of the URL; does not generate long-form content; the output may require manual review for compliance with brand guidelines or legal standards.", + "examples": [ + "Draft a casual and exciting snippet to promote https://example.com/sale with call-to-action 'Shop now' and max length 120.", + "Create a formal, brief link preview text for https://news.example.com/article about environment with keywords ['climate', 'policy'].", + "Generate a short social media text for https://blog.example.com/new-feature without call to action, tone casual, and maximum length 100 characters." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotion", + "link", + "social media", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/sale\",\"contextKeywords\":[\"discount\",\"shoes\"],\"tone\":\"exciting\",\"maxLength\":120,\"callToAction\":\"Shop now\"}", + "description": "Creates a short, exciting promotional snippet for a sale on shoes with a call-to-action button prompting users to shop now." + }, + { + "inputJson": "{\"url\":\"https://news.example.com/article\",\"contextKeywords\":[\"climate\",\"policy\"],\"tone\":\"formal\",\"maxLength\":150,\"callToAction\":\"Learn more\"}", + "description": "Generates a formal text snippet to promote a news article on climate policy with a 'Learn more' call to action." + }, + { + "inputJson": "{\"url\":\"https://blog.example.com/new-feature\",\"tone\":\"casual\",\"maxLength\":100,\"callToAction\":\"\"}", + "description": "Drafts a casual and concise social media snippet to announce a new feature blog post without a call-to-action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Link", + "context": null + } + }, + { + "name": "copywriting.draftHeading", + "description": "Generates compelling marketing or promotional headings based on given product or service details. Accepts input such as product description, target audience, and tone to produce creative and attention-grabbing headings suitable for advertisements, websites, or campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "A brief description of the product or service to highlight in the heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the heading, influencing style and word choice.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the heading, e.g., upbeat, professional, casual, urgent.", + "required": false, + "defaultValue": "upbeat" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length of the generated heading to fit display constraints.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading text along with metadata such as length and confidence score." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate catchy, relevant headings for marketing content or promotional materials based on minimal input describing the product and desired style. It helps automate creative headline writing for campaigns, landing pages, and ads.", + "limitations": "This tool cannot guarantee the heading matches complex brand guidelines or legal advertising constraints and may need human review for tone accuracy or compliance.", + "examples": [ + "Generate a headline for a new eco-friendly water bottle aimed at young adults with an energetic tone.", + "Create a professional heading for a software consulting service targeting corporate clients.", + "Draft a casual, fun heading under 50 characters for a local bakery's spring promotion." + ] + }, + "tags": [ + "copywriting", + "marketing", + "headline", + "drafting", + "advertising", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A lightweight, eco-friendly water bottle made from recycled materials.\",\"targetAudience\":\"young adults\",\"tone\":\"energetic\",\"maxLength\":60}", + "description": "Generate an energetic headline for an eco-friendly water bottle aimed at young adults." + }, + { + "inputJson": "{\"productDescription\":\"Professional software consulting services for enterprises.\",\"targetAudience\":\"corporate clients\",\"tone\":\"professional\",\"maxLength\":70}", + "description": "Create a polished heading for a software consulting firm targeting corporate clients." + }, + { + "inputJson": "{\"productDescription\":\"Freshly baked pastries with seasonal flavors.\",\"tone\":\"casual\",\"maxLength\":50}", + "description": "Draft a short, casual heading for a bakery's seasonal promotion." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Heading", + "context": null + } + }, + { + "name": "copywriting.draftChecklist", + "description": "Generates a tailored checklist to guide the creation of marketing or promotional content based on the specified campaign type, target audience, and key objectives. Accepts parameters to customize the checklist scope and outputs structured steps to ensure comprehensive and effective copywriting.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "The type of marketing campaign (e.g., email, social media, landing page) to tailor the checklist appropriately.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience or customer segment for the campaign. Used to customize checklist focus.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyObjectives", + "type": "array", + "description": "List of key objectives or goals for the campaign (e.g., increase signups, brand awareness). Guides checklist priorities.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeSEO", + "type": "boolean", + "description": "Whether to include SEO-related items in the checklist for digital campaigns.", + "required": false, + "defaultValue": "false" + }, + { + "name": "languageTone", + "type": "string", + "description": "Preferred tone or style for the copywriting (e.g., formal, casual, persuasive). Influences checklist elements.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxItems", + "type": "number", + "description": "Maximum number of checklist items to generate. Helps keep checklist focused and manageable.", + "required": false, + "defaultValue": "20" + } + ], + "returns": { + "type": "object", + "description": "An object containing a checklist array with ordered steps or points as strings to guide marketing copywriting." + }, + "aiAgent": { + "useCase": "Use this tool when needing a structured, tailored checklist to plan and ensure thorough, goal-oriented writing for marketing or promotional content. It helps break down complex copywriting tasks into actionable items that suit specific campaign types and audience goals.", + "limitations": "Does not generate the actual copy content, only the checklist. It cannot replace creative writing or strategy planning beyond checklist guidance.", + "examples": [ + "Generate a checklist for a social media campaign targeting millennials to increase brand engagement.", + "Create a checklist for drafting an email marketing campaign with a persuasive tone including SEO considerations.", + "Produce a checklist focused on landing page copywriting for a product launch with clear call-to-action objectives." + ] + }, + "tags": [ + "copywriting", + "marketing", + "checklist", + "content planning", + "campaign", + "promotion", + "SEO", + "writing guide" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"email\",\"targetAudience\":\"small business owners\",\"keyObjectives\":[\"increase open rates\",\"drive sales\"],\"includeSEO\":false,\"languageTone\":\"professional\",\"maxItems\":10}", + "description": "Checklist for an email marketing campaign targeting small business owners with the goals of increasing open rates and driving sales, in a professional tone." + }, + { + "inputJson": "{\"campaignType\":\"social media\",\"targetAudience\":\"millennials\",\"keyObjectives\":[\"brand engagement\"],\"includeSEO\":true,\"languageTone\":\"casual\",\"maxItems\":15}", + "description": "Checklist tailored for a social media campaign aimed at millennials that includes SEO factors and adopts a casual tone, focusing on brand engagement." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Checklist", + "context": null + } + }, + { + "name": "copywriting.draftText", + "description": "Generates marketing or promotional text drafts based on the specified content type, tone, audience, and key points. Accepts structured inputs including product or service descriptions and outputs well-formed text suitable for campaigns, advertisements, or social media posts.", + "category": "copywriting", + "parameters": [ + { + "name": "contentType", + "type": "string", + "description": "Type of content to draft, e.g., 'ad copy', 'social media post', 'email newsletter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "Array of key features, benefits, or messages to include in the draft text.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the content to tailor tone and style.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style for the text, e.g., 'professional', 'friendly', 'urgent'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum desired length of the generated text in characters.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted marketing or promotional text as a string, and metadata such as word count." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate initial drafts of marketing or promotional content tailored to a specific campaign, product, or audience. It helps accelerate content creation by producing human-like, engaging text based on provided key points and style parameters.", + "limitations": "The tool cannot guarantee fully optimized SEO text or final copy ready for publication without human review. It may not capture highly specialized jargon or comply with legal/regulatory requirements automatically.", + "examples": [ + "Draft a friendly Instagram post for a new organic skincare line highlighting natural ingredients and benefits.", + "Generate a concise email newsletter introduction promoting a seasonal sale targeted at budget-conscious consumers.", + "Create an urgent ad copy for a tech gadget launch emphasizing speed and innovation." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "drafting", + "advertising", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"contentType\":\"ad copy\",\"keyPoints\":[\"fast delivery\",\"money back guarantee\",\"24/7 customer support\"],\"targetAudience\":\"online shoppers\",\"tone\":\"professional\",\"maxLength\":300}", + "description": "Draft professional ad copy emphasizing key service features for online shoppers." + }, + { + "inputJson": "{\"contentType\":\"social media post\",\"keyPoints\":[\"brand anniversary\",\"special discounts\",\"limited time offer\"],\"tone\":\"friendly\"}", + "description": "Create a friendly social media post announcing a brand anniversary sale." + }, + { + "inputJson": "{\"contentType\":\"email newsletter\",\"keyPoints\":[\"new product launch\",\"exclusive preview\",\"early bird discount\"],\"targetAudience\":\"subscribers\",\"tone\":\"urgent\",\"maxLength\":400}", + "description": "Generate an urgent, concise email newsletter intro about a new product launch for subscribers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Text", + "context": null + } + }, + { + "name": "copywriting.draftReadme", + "description": "Generates a well-structured README.md file draft for software projects based on inputs like project name, description, installation instructions, usage examples, and license information. It processes these inputs to produce a formatted markdown document outlining key project details, helping users quickly produce professional documentation.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to be included as the README title.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A concise description that summarizes the project's purpose and features.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step installation instructions to guide users in setting up the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "string", + "description": "Example code snippets or command-line usage to demonstrate how to use the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "licenseInfo", + "type": "string", + "description": "License information specifying the terms under which the project is distributed.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Information about how others can contribute to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "contactInfo", + "type": "string", + "description": "Contact information for users to reach out with questions or feedback.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeBadges", + "type": "boolean", + "description": "Flag to include common status badges (e.g., build status, version) at the top of the README.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object that contains the full README content in markdown format in the 'readmeContent' field." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a professional and structured README file for new or existing software projects based on provided project details and usage information. It helps automate initial documentation drafting, saving time and ensuring completeness of common README sections.", + "limitations": "Cannot generate content beyond supplied inputs such as advanced tutorials, changelogs, or dynamic badges that require real-time data. The quality depends on the completeness and clarity of given parameters.", + "examples": [ + "Generate a README draft for a machine learning library including install instructions and usage examples.", + "Create a README for a CLI tool with license and contribution guidelines included.", + "Produce a minimal README with project name and description only." + ] + }, + "tags": [ + "copywriting", + "documentation", + "readme", + "markdown", + "software", + "automation", + "project setup" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"SmartHomeAPI\",\"projectDescription\":\"An API to control smart home devices remotely via HTTP.\",\"installationInstructions\":\"1. Clone the repo\\n2. Run npm install\\n3. Start server with npm start\",\"usageExamples\":\"curl -X POST http://localhost:3000/devices/light/on\",\"licenseInfo\":\"MIT\",\"contributionGuidelines\":\"Please fork and submit pull requests.\",\"contactInfo\":\"devteam@smarthome.com\",\"includeBadges\":true}", + "description": "Draft a detailed README for a smart home API project including badges, install, usage, license, and contribution sections." + }, + { + "inputJson": "{\"projectName\":\"DataUtils\",\"projectDescription\":\"A utility library for common data manipulation tasks in JavaScript.\",\"installationInstructions\":\"npm install datautils\",\"usageExamples\":\"import { shuffle } from 'datautils';\\nconsole.log(shuffle([1,2,3,4]));\",\"licenseInfo\":\"Apache 2.0\",\"includeBadges\":false}", + "description": "Generate a README draft for a data utility library focusing on install instructions and usage code samples." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Readme", + "context": null + } + }, + { + "name": "copywriting.draftSentence", + "description": "Generates a single marketing sentence draft based on specified product or service details, target audience, tone, and key selling points. Accepts structured input describing what to promote and outputs a concise, persuasive promotional sentence tailored to requested style and audience.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service being promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "A brief description of the product or service, highlighting features or benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or market segment for the marketing sentence.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the sentence such as friendly, professional, urgent, or playful.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keySellingPoints", + "type": "array", + "description": "An array of key features or benefits to highlight in the sentence.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the resulting sentence in characters to fit specific format requirements.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object with a single drafted marketing sentence string tailored to the input parameters." + }, + "aiAgent": { + "useCase": "Use this tool when the AI agent needs to produce a brief, persuasive sentence for marketing or promotional material dynamically, based on specific input about the product, audience, and desired tone. Ideal for generating taglines, ad snippets, or social media lines without manual copywriting.", + "limitations": "Cannot generate multiple sentences or longer content pieces. Quality depends on clarity and completeness of input parameters. May not handle extremely technical or niche products well.", + "examples": [ + "Write a friendly sentence promoting a new eco-friendly water bottle for outdoor enthusiasts.", + "Draft a professional, concise sentence highlighting benefits of a cloud software service for small businesses.", + "Create an urgent, playful sentence for a limited-time sale on handmade jewelry." + ] + }, + "tags": [ + "copywriting", + "marketing", + "sentence generation", + "promotional text", + "advertising", + "branding" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSip Water Bottle\",\"productDescription\":\"a reusable, insulated water bottle made from recycled materials\",\"targetAudience\":\"outdoor enthusiasts and environmentally conscious consumers\",\"tone\":\"friendly\",\"keySellingPoints\":[\"keeps drinks cold for 24 hours\",\"eco-friendly materials\",\"durable design\"],\"maxLength\":140}", + "description": "Generate a friendly marketing sentence for an eco-friendly, insulated water bottle targeting outdoor lovers." + }, + { + "inputJson": "{\"productName\":\"CloudSync Pro\",\"productDescription\":\"a secure cloud storage service with automatic backup and access anywhere\",\"targetAudience\":\"small business owners\",\"tone\":\"professional\",\"keySellingPoints\":[\"99.9% uptime\",\"end-to-end encryption\",\"24/7 support\"],\"maxLength\":150}", + "description": "Draft a professional sentence highlighting a secure cloud storage solution for small businesses." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Sentence", + "context": null + } + }, + { + "name": "copywriting.draftTemplate", + "description": "Generates marketing and promotional copywriting templates based on specified campaign goals, tone, target audience, and format. Accepts inputs such as campaign type, key messages, tone style, target demographics, and output format to produce a ready-to-use draft template for marketing communications.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "The type of campaign for which the template is drafted, e.g., email, social media, product launch.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyMessages", + "type": "array", + "description": "An array of key messages or product features to highlight in the template.", + "required": true, + "defaultValue": "" + }, + { + "name": "toneStyle", + "type": "string", + "description": "The desired tone of the template such as professional, casual, humorous, or persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience to tailor the template language accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "templateFormat", + "type": "string", + "description": "Preferred output format for the template: e.g., plain text, HTML, markdown.", + "required": false, + "defaultValue": "plain text" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action section in the template.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted marketing template text and metadata such as format and recommended usage advice." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to quickly generate a marketing or promotional copywriting template tailored to campaign specifics, target demographics, and tone preferences. Ideal for campaign planning stages or automating marketing content creation for different channels.", + "limitations": "This tool cannot customize content with live data such as dynamic pricing, it does not generate final polished ads but rather draft templates needing human review and refinement.", + "examples": [ + "Draft a social media template for a product launch targeting young adults with a casual, upbeat tone.", + "Create an email marketing template highlighting eco-friendly features with a professional tone including a call to action.", + "Generate a product launch flyer template in HTML format focusing on key eco-benefits and a persuasive tone." + ] + }, + "tags": [ + "copywriting", + "template", + "marketing", + "drafting", + "promotional", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"email\",\"keyMessages\":[\"Exclusive 20% discount\",\"Limited time offer\"],\"toneStyle\":\"professional\",\"targetAudience\":\"young professionals\",\"templateFormat\":\"plain text\",\"includeCallToAction\":true}", + "description": "Draft an email marketing template with a professional tone targeting young professionals, emphasizing an exclusive limited-time discount offer." + }, + { + "inputJson": "{\"campaignType\":\"social media\",\"keyMessages\":[\"New eco-friendly product line\",\"Sustainable packaging\"],\"toneStyle\":\"casual\",\"targetAudience\":\"environmentally conscious millennials\",\"templateFormat\":\"markdown\",\"includeCallToAction\":true}", + "description": "Create a social media post template in markdown with a casual tone promoting an eco-friendly product line to millennials." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Template", + "context": null + } + }, + { + "name": "copywriting.draftFAQ", + "description": "Generates a structured FAQ document based on provided product or service details and common customer queries. It accepts key information such as product description, target audience, and example questions, then drafts clear and concise FAQ entries answering those questions. The output is a list of question-answer pairs ideal for marketing, support, or onboarding.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "A concise description of the product or service for which to create the FAQ. Provides context for accurate answer generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience (e.g., new users, technical users) to tailor the tone and complexity of the FAQ. Optional but recommended.", + "required": false, + "defaultValue": "" + }, + { + "name": "commonQuestions", + "type": "array", + "description": "An array of common or anticipated questions customers might ask about the product or service. These form the FAQ entries' questions.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxAnswerLength", + "type": "number", + "description": "Maximum word count for each answer to keep responses concise and focused. Defaults to 100 words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "If true, the tool includes example scenarios or use cases in answers where appropriate, enhancing clarity.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of FAQ entries. Each entry is an object with 'question' and 'answer' string fields." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents tasked with creating marketing content, support documentation, or onboarding materials, needing to quickly generate user-friendly FAQ sections based on limited input data. It helps automate crafting consistent Q&A content reflecting common concerns and product details.", + "limitations": "The tool cannot replace expert technical support or legal advice. It produces draft content that may require human review for accuracy and completeness. It relies on the quality and completeness of the input data to generate relevant answers.", + "examples": [ + "Generate FAQs for a new fitness tracking app targeting casual users with questions about battery life and compatibility.", + "Create an FAQ for a cloud storage service including common security and pricing questions.", + "Draft FAQ entries for a home automation device, focusing on setup and troubleshooting queries." + ] + }, + "tags": [ + "copywriting", + "FAQ", + "marketing", + "customerSupport", + "documentation", + "contentCreation" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A mobile app that tracks daily physical activity and sleep patterns.\",\"targetAudience\":\"Casual and fitness-focused users.\",\"commonQuestions\":[\"How long does the battery last?\",\"Is the app compatible with iOS and Android?\"],\"maxAnswerLength\":80,\"includeExamples\":true}", + "description": "Draft FAQs for a fitness tracking app answering battery life and compatibility." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "FAQ", + "context": null + } + }, + { + "name": "copywriting.draftParagraph", + "description": "Generates a marketing or promotional paragraph based on provided product or service details, target audience, tone, and key points. Accepts structured input to tailor content and outputs a compelling paragraph suitable for advertising or web content.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the paragraph (e.g., millennials, tech professionals).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the paragraph (e.g., professional, friendly, enthusiastic).", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key product features or selling points to highlight.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "paragraphLength", + "type": "number", + "description": "Approximate desired length of the output paragraph in number of sentences.", + "required": false, + "defaultValue": "4" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional paragraph text." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to draft clear, appealing marketing paragraphs tailored to specified audience and tone, for use in advertisements, web content, or promotional materials. It helps produce focused and engaging text based on product info and desired style.", + "limitations": "Cannot produce highly specialized technical documentation or legal disclaimers; may not capture very nuanced brand voice without extensive examples.", + "examples": [ + "Draft a friendly paragraph promoting a new eco-friendly water bottle targeted at outdoor enthusiasts.", + "Create a professional paragraph advertising a B2B cloud storage service for IT managers.", + "Write an enthusiastic paragraph highlighting the features of a new fitness app for millennials." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "promotional text", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSip Water Bottle\",\"targetAudience\":\"outdoor enthusiasts\",\"tone\":\"friendly\",\"keyFeatures\":[\"BPA-free material\",\"keeps drinks cold 24 hours\",\"sleek design\"],\"paragraphLength\":4}", + "description": "Generate a friendly marketing paragraph for an eco-friendly water bottle aimed at outdoor enthusiasts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Paragraph", + "context": null + } + }, + { + "name": "copywriting.draftSummary", + "description": "Generates a concise and engaging summary from a longer document or text input. It accepts raw textual content and options for summary length and style, then processes the text to produce a clear, readable summary suitable for marketing, presentations, or briefings.", + "category": "copywriting", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The full text or document content to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate desired word count for the summary. Defaults to 100 words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "style", + "type": "string", + "description": "Tone or style for the summary such as 'formal', 'casual', or 'persuasive'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeKeyPoints", + "type": "boolean", + "description": "Whether to highlight key points or bullet them in the summary.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and metadata about the summary such as word count and style used." + }, + "aiAgent": { + "useCase": "Use this tool when needing to condense lengthy documents, reports, or articles into brief, clear summaries that capture essential information for marketing, executive briefings, or promotional materials. Ideal for transforming complex content into reader-friendly abstracts.", + "limitations": "The tool may not perfectly capture highly technical details or nuanced arguments. It does not replace expert content editing or fact-checking.", + "examples": [ + "Create a 150-word persuasive summary for a product whitepaper.", + "Summarize the meeting transcript in a formal tone highlighting action items.", + "Generate a casual 80-word summary for a blog post introduction." + ] + }, + "tags": [ + "copywriting", + "summarization", + "marketing", + "text", + "summary", + "drafting" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Our new electric scooter offers a revolutionary way to commute with zero emissions, a range of 50 miles per charge, and compact foldable design...\",\"summaryLength\":120,\"style\":\"persuasive\",\"includeKeyPoints\":true}", + "description": "Generate a persuasive summary highlighting key features of an electric scooter product brochure." + }, + { + "inputJson": "{\"text\":\"The quarterly financial report indicates a steady growth in revenue by 12% compared to last year... The main drivers of growth included increased sales in the European market and cost optimization...\",\"summaryLength\":100,\"style\":\"formal\",\"includeKeyPoints\":false}", + "description": "Create a formal summary of a quarterly financial report for an executive briefing." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Summary", + "context": null + } + }, + { + "name": "copywriting.draftBrief", + "description": "Generates a concise marketing or project brief based on provided key points and objectives. Accepts an array of input topics, target audience details, and desired tone, then synthesizes these inputs into a structured, clear brief suitable for guiding campaigns or projects.", + "category": "copywriting", + "parameters": [ + { + "name": "topics", + "type": "array", + "description": "List of key topics or points to include in the brief, each as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the brief, e.g., demographics or buyer personas.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the brief, e.g., professional, casual, persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "objective", + "type": "string", + "description": "Main objective or goal of the brief, e.g., increase brand awareness, launch new product.", + "required": true, + "defaultValue": "" + }, + { + "name": "lengthLimit", + "type": "number", + "description": "Maximum length of the drafted brief in words. If unset, defaults to 300 words.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted brief text as a string under the 'briefText' key, formatted for immediate use or further editing." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a clear and concise marketing or project brief from fragmented input points, target audience, and campaign objectives. Ideal for automating initial briefing drafts for teams or clients.", + "limitations": "This tool does not create detailed project plans, marketing strategies, or creative content beyond concise briefing documents. It relies on clear input parameters for best results and may produce generic text if inputs are vague.", + "examples": [ + "Draft a marketing brief for a new eco-friendly water bottle targeting environmentally conscious millennials with a persuasive tone.", + "Generate a concise project brief outlining key features for a mobile app launch aimed at tech-savvy young adults.", + "Create a professional brief for a B2B software product with objectives to increase lead generation." + ] + }, + "tags": [ + "copywriting", + "brief", + "marketing", + "drafting", + "content creation", + "project planning" + ], + "examples": [ + { + "inputJson": "{\"topics\":[\"Eco-friendly materials\",\"Reusable design\",\"Affordable price point\"],\"targetAudience\":\"Environmentally conscious millennials\",\"tone\":\"persuasive\",\"objective\":\"Increase brand awareness for new water bottle launch\",\"lengthLimit\":250}", + "description": "Create a persuasive marketing brief focused on the launch of an eco-friendly water bottle targeting millennials." + }, + { + "inputJson": "{\"topics\":[\"User-friendly interface\",\"Cross-platform compatibility\",\"Real-time notifications\"],\"targetAudience\":\"Tech-savvy young adults\",\"tone\":\"professional\",\"objective\":\"Outline key app features for launch marketing\",\"lengthLimit\":300}", + "description": "Generate a professional brief highlighting core features of a new app to assist marketing efforts for young adult demographics." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Brief", + "context": null + } + }, + { + "name": "copywriting.draftTranscript", + "description": "This tool accepts a raw transcript text as input and drafts a polished, coherent written version suitable for marketing or promotional purposes. It processes the input to improve grammar, flow, and style, and outputs a refined transcript draft that is clear, engaging, and aligned with promotional communication standards.", + "category": "copywriting", + "parameters": [ + { + "name": "rawTranscript", + "type": "string", + "description": "The original raw transcript text to be polished and drafted into a marketing-friendly document.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience to tailor the tone and style of the draft accordingly (e.g., professionals, general public).", + "required": false, + "defaultValue": "" + }, + { + "name": "styleTone", + "type": "string", + "description": "Desired style or tone for the drafted transcript such as formal, casual, enthusiastic, or persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the drafted transcript in words; the tool will summarize or trim to meet this constraint.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "highlightKeyPoints", + "type": "boolean", + "description": "Whether to emphasize and highlight key points and takeaways in the drafted transcript for promotional impact.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted transcript text, polished for clarity, grammar, and promotional style." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert raw, unedited transcripts from interviews, speeches, or recordings into polished, marketing-appropriate drafts. Useful for preparing promotional materials, blog posts, press releases, or summarized presentations based on spoken content. It helps maintain engagement with the intended audience by adapting tone and length.", + "limitations": "Cannot create content beyond the transcript provided; does not add factual information not present in the source text. May require human review for technical accuracy or legal compliance.", + "examples": [ + "Draft a promotional transcript from a raw interview text for a professional tech audience.", + "Create a casual, engaging transcript draft from a recorded podcast episode.", + "Summarize and polish a long webinar transcript for a marketing newsletter." + ] + }, + "tags": [ + "copywriting", + "transcript", + "drafting", + "marketing", + "promotional", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"rawTranscript\":\"Thank you all for joining our webinar today. We discussed the latest features of our software platform and how they can help increase productivity.\",\"targetAudience\":\"technology professionals\",\"styleTone\":\"formal\",\"maxLength\":150,\"highlightKeyPoints\":true}", + "description": "Draft a formal, polished transcript from a webinar raw transcript tailored to technology professionals, emphasizing key points within 150 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Transcript", + "context": null + } + }, + { + "name": "copywriting.draftMinutes", + "description": "Generates professional meeting minutes by processing structured or semi-structured input including meeting details, discussion points, decisions, and action items. Produces a well-formatted minutes document suitable for distribution.", + "category": "copywriting", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "Title or topic of the meeting being summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "dateTime", + "type": "string", + "description": "Date and time when the meeting took place, in ISO 8601 format (e.g., 2024-06-01T10:00:00Z).", + "required": true, + "defaultValue": "" + }, + { + "name": "attendees", + "type": "array", + "description": "List of attendees' names participating in the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "agendaItems", + "type": "array", + "description": "Ordered list of agenda items discussed during the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discussionPoints", + "type": "object", + "description": "Key-value pairs mapping agenda items to arrays of discussion points or highlights.", + "required": true, + "defaultValue": "" + }, + { + "name": "decisions", + "type": "object", + "description": "Key-value pairs mapping agenda items to decisions made, if any.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items derived from the meeting with assignees and deadlines.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a meeting summary paragraph at the beginning of the minutes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted meeting minutes as a string under the 'minutesText' field, ready for distribution or documentation purposes." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent has access to structured meeting data such as attendees, agendas, discussions, decisions, and action items, and needs to produce professional, readable meeting minutes that clearly summarize key information. Suitable to automate or assist administrative tasks in business or organizational settings.", + "limitations": "This tool cannot generate meeting content from audio or unstructured text; it requires structured inputs reflecting meeting details. It also does not validate factual accuracy of inputs.", + "examples": [ + "Create meeting minutes for a project kickoff meeting with three attendees and a clear agenda.", + "Summarize discussion points and decisions from a sales review meeting into a formal minutes document.", + "Generate minutes including a summary and action items for a weekly team sync meeting." + ] + }, + "tags": [ + "copywriting", + "meeting", + "minutes", + "documentation", + "summary", + "business" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Project Kickoff\",\"dateTime\":\"2024-06-01T09:00:00Z\",\"attendees\":[\"Alice Johnson\",\"Bob Smith\",\"Carol Lee\"],\"agendaItems\":[\"Introductions\",\"Project Overview\",\"Roles and Responsibilities\"],\"discussionPoints\":{\"Introductions\":[\"Attendees introduced themselves.\"],\"Project Overview\":[\"Goals and timelines were outlined.\"],\"Roles and Responsibilities\":[\"Each member described their tasks.\"]},\"decisions\":{\"Project Overview\":\"Timeline to be finalized by next meeting.\"},\"actionItems\":[{\"task\":\"Define detailed timeline\",\"assignee\":\"Bob Smith\",\"dueDate\":\"2024-06-07\"}],\"includeSummary\":true}", + "description": "Draft meeting minutes for a project kickoff with three attendees, agenda, discussions, decisions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Minutes", + "context": null + } + }, + { + "name": "copywriting.draftEmail", + "description": "Generates a professional and persuasive marketing or promotional email based on the provided subject, target audience, product or service details, tone, and desired call-to-action. The tool processes these inputs to craft a coherent and customized email draft ready for review or sending.", + "category": "copywriting", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The main subject line or topic of the email to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended recipients, including demographics or interests to tailor the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "productOrServiceDetails", + "type": "string", + "description": "Key features, benefits, or information about the product or service being promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email, such as formal, casual, enthusiastic, or persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific action you want the reader to take after reading the email, e.g., visit website or make a purchase.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeDiscount", + "type": "boolean", + "description": "Whether to include a discount or promotional offer in the email.", + "required": false, + "defaultValue": "false" + }, + { + "name": "discountDetails", + "type": "string", + "description": "Details about the discount or offer to include, such as percentage off or promo code.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated email draft text optimized to suit the specified inputs." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to rapidly generate customized marketing emails tailored for different audiences and products, saving time and ensuring consistent professional messaging. It assists in crafting clear subject lines, persuasive content, and effective calls to action based on user inputs.", + "limitations": "This tool cannot guarantee perfect brand alignment or legal compliance with marketing laws; outputs should be reviewed by a human before sending.", + "examples": [ + "Draft a promotional email for a new eco-friendly water bottle targeting outdoor enthusiasts with a casual tone and a 10% discount offer.", + "Write a formal email introducing a software update to existing clients emphasizing improved security features and urging them to schedule an upgrade call.", + "Create an enthusiastic email inviting customers to a limited-time webinar about health supplements, encouraging registration with a special promo code." + ] + }, + "tags": [ + "copywriting", + "email", + "marketing", + "promotional", + "drafting", + "communication" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Introducing Our New Eco-Friendly Water Bottle\",\"targetAudience\":\"Outdoor enthusiasts aged 20-40 who care about sustainability\",\"productOrServiceDetails\":\"Lightweight, BPA-free water bottle made from recycled materials, keeps drinks cold for 24 hours\",\"tone\":\"casual\",\"callToAction\":\"Visit our website to order now\",\"includeDiscount\":true,\"discountDetails\":\"Use code ECO10 for 10% off\"}", + "description": "Draft a casual promotional email for an eco-friendly product including a discount." + }, + { + "inputJson": "{\"subject\":\"Important Security Update Available\",\"targetAudience\":\"Current software clients in finance sector\",\"productOrServiceDetails\":\"New update includes advanced encryption and multi-factor authentication\",\"tone\":\"formal\",\"callToAction\":\"Schedule your upgrade call today\",\"includeDiscount\":false,\"discountDetails\":\"\"}", + "description": "Generate a formal email announcing a software update emphasizing security features." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "copywriting.draftResume", + "description": "Generates a tailored professional resume draft based on user details such as work experience, education, skills, and job target. Inputs include structured personal and career information which the tool processes to output a formatted resume draft text optimized for clarity and relevance to the specified job role.", + "category": "copywriting", + "parameters": [ + { + "name": "fullName", + "type": "string", + "description": "The candidate's full name as it should appear on the resume.", + "required": true, + "defaultValue": "" + }, + { + "name": "contactInfo", + "type": "object", + "description": "Contact details including email, phone number, and optionally LinkedIn or personal website URLs.", + "required": true, + "defaultValue": "" + }, + { + "name": "professionalSummary", + "type": "string", + "description": "A brief summary or objective statement highlighting the candidate's career goals and strengths.", + "required": false, + "defaultValue": "" + }, + { + "name": "workExperience", + "type": "array", + "description": "List of work experience entries, each with job title, company name, start and end dates, and a description of responsibilities and achievements.", + "required": true, + "defaultValue": "" + }, + { + "name": "education", + "type": "array", + "description": "List of educational credentials, each with degree, institution, and graduation year.", + "required": true, + "defaultValue": "" + }, + { + "name": "skills", + "type": "array", + "description": "Key professional skills and proficiencies relevant to the job target.", + "required": true, + "defaultValue": "" + }, + { + "name": "certifications", + "type": "array", + "description": "Optional certifications or professional licenses relevant to the field.", + "required": false, + "defaultValue": "" + }, + { + "name": "jobTarget", + "type": "string", + "description": "The type of job or sector the resume should be tailored for (e.g., software engineer, project manager).", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the draft resume text formatted as a string that can be reviewed, edited, or exported by the user." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a professional and customized resume draft from structured input without manual formatting, especially helpful for job seekers tailoring resumes to specific roles. It helps save time and ensures inclusion of all relevant information, presenting it in a coherent, industry-appropriate style.", + "limitations": "The tool cannot replace manual editing for highly personalized styling preferences or guarantee ATS (Applicant Tracking System) optimization without additional specialized input. It may not handle unstructured or incomplete data gracefully.", + "examples": [ + "Draft a resume for a software engineer with 5 years experience focusing on backend development.", + "Create a resume draft for an entry-level marketing coordinator position including internships and skills.", + "Generate a resume for a project manager with certifications in PMP and Agile, targeting roles in the IT sector." + ] + }, + "tags": [ + "copywriting", + "resume", + "drafting", + "career", + "job application", + "professional writing" + ], + "examples": [ + { + "inputJson": "{\"fullName\":\"Jane Doe\",\"contactInfo\":{\"email\":\"jane.doe@example.com\",\"phone\":\"123-456-7890\",\"linkedIn\":\"linkedin.com/in/janedoe\"},\"professionalSummary\":\"Experienced software developer with a focus on scalable backend systems.\",\"workExperience\":[{\"jobTitle\":\"Backend Developer\",\"company\":\"TechCorp\",\"startDate\":\"2018-06\",\"endDate\":\"2023-01\",\"description\":\"Developed microservices and APIs using Node.js and Python.\"}],\"education\":[{\"degree\":\"B.Sc. Computer Science\",\"institution\":\"State University\",\"graduationYear\":\"2018\"}],\"skills\":[\"Node.js\",\"Python\",\"REST APIs\",\"Docker\"],\"certifications\":[],\"jobTarget\":\"Backend Software Engineer\"}", + "description": "Generate a backend-focused software engineer resume draft for Jane Doe with specified experience and skills." + }, + { + "inputJson": "{\"fullName\":\"Mark Spencer\",\"contactInfo\":{\"email\":\"mark.spencer@example.com\",\"phone\":\"987-654-3210\"},\"professionalSummary\":\"Enthusiastic marketing graduate seeking entry-level opportunities.\",\"workExperience\":[{\"jobTitle\":\"Marketing Intern\",\"company\":\"AdWorks\",\"startDate\":\"2022-06\",\"endDate\":\"2022-12\",\"description\":\"Assisted in social media campaigns and content creation.\"}],\"education\":[{\"degree\":\"B.A. Marketing\",\"institution\":\"City College\",\"graduationYear\":\"2023\"}],\"skills\":[\"Social media marketing\",\"Content creation\",\"SEO basics\"],\"certifications\":[],\"jobTarget\":\"Marketing Coordinator\"}", + "description": "Create an entry-level marketing coordinator resume draft featuring internship and skill highlights for Mark Spencer." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Resume", + "context": null + } + }, + { + "name": "copywriting.draftInvoice", + "description": "Generates a professional and clear invoice draft based on provided client information, list of billed items or services, payment terms, and optional notes. Accepts structured details such as client data, service descriptions, quantities, rates, and outputs a formatted invoice text suitable for copywriting or immediate client communication.", + "category": "copywriting", + "parameters": [ + { + "name": "clientName", + "type": "string", + "description": "Full name or company name of the invoice recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "clientAddress", + "type": "string", + "description": "Mailing address of the client or company being invoiced.", + "required": false, + "defaultValue": "" + }, + { + "name": "invoiceNumber", + "type": "string", + "description": "Unique identifier or number for the invoice.", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceDate", + "type": "string", + "description": "Date when the invoice is issued (formatted as YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "dueDate", + "type": "string", + "description": "Payment due date (formatted as YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "List of billed items, each with description, quantity, and unit price.", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency symbol or code for amounts (e.g., $, USD).", + "required": false, + "defaultValue": "$" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Payment terms like 'Net 30', 'Due on receipt', etc.", + "required": false, + "defaultValue": "" + }, + { + "name": "notes", + "type": "string", + "description": "Additional notes or instructions for the client regarding the invoice.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a complete, professionally worded invoice text ready for sending or further editing." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a clear, professional draft of an invoice from given client and billing details, especially for marketing, sales follow-up, or billing departments to quickly generate client-ready invoices in text form.", + "limitations": "This tool does not perform arithmetic verification beyond basic totals, nor does it generate PDF or formatted documents; manual formatting or integration with document tools may be required afterward.", + "examples": [ + "Create an invoice draft for client 'ABC Corp' with 3 items, due in 30 days.", + "Generate a billing invoice text for a single consulting service with payment due on receipt.", + "Draft a detailed invoice including special notes and payment terms for a corporate client." + ] + }, + "tags": [ + "copywriting", + "invoice", + "billing", + "drafting", + "financial documents", + "marketing", + "client communication" + ], + "examples": [ + { + "inputJson": "{\"clientName\":\"Acme Corporation\",\"clientAddress\":\"123 Industrial Ave, Suite 4, Metropolis\",\"invoiceNumber\":\"INV-2024-045\",\"invoiceDate\":\"2024-06-10\",\"dueDate\":\"2024-07-10\",\"items\":[{\"description\":\"Web Design Services\",\"quantity\":10,\"unitPrice\":75},{\"description\":\"Hosting Fee\",\"quantity\":1,\"unitPrice\":150}],\"currency\":\"$\",\"paymentTerms\":\"Net 30\",\"notes\":\"Thank you for your business!\"}", + "description": "Invoice draft for a corporate client with multiple line items and notes." + }, + { + "inputJson": "{\"clientName\":\"Jane Doe\",\"invoiceNumber\":\"JD-1001\",\"invoiceDate\":\"2024-06-15\",\"dueDate\":\"2024-06-15\",\"items\":[{\"description\":\"Consulting Session\",\"quantity\":1,\"unitPrice\":300}],\"currency\":\"$\",\"paymentTerms\":\"Due on receipt\",\"notes\":\"Please remit payment promptly.\"}", + "description": "Single item consulting invoice with immediate due date and payment instructions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Invoice", + "context": null + } + }, + { + "name": "copywriting.draftBlogPost", + "description": "Generates a well-structured blog post draft based on a given topic, target audience, and optional keywords. Accepts inputs describing the blog post theme and style preferences, processes them to create a coherent, engaging article, and outputs the blog post content as text.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the blog post to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers, to tailor tone and complexity appropriately.", + "required": false, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "An array of keywords or phrases to naturally incorporate in the blog post for SEO purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "wordCount", + "type": "number", + "description": "Desired length of the blog post in words; helps control detail and depth.", + "required": false, + "defaultValue": "800" + }, + { + "name": "styleTone", + "type": "string", + "description": "Preferred writing style or tone, e.g., casual, formal, persuasive, informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "includeHeadings", + "type": "boolean", + "description": "Whether to include section headings to structure the blog post.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted blog post text and optional metadata like estimated reading time." + }, + "aiAgent": { + "useCase": "Use this tool when needing to rapidly produce a complete draft of a blog post on any topic, tailored to a specific audience and style, including SEO keyword integration. It is ideal for content marketing, blogging, and digital publishing scenarios.", + "limitations": "Cannot provide final edited or critically fact-checked content; output may require human review for accuracy and personalization.", + "examples": [ + "Draft a 1000-word blog post on sustainable fashion targeting environmentally conscious millennials including keywords like 'eco-friendly', 'slow fashion'.", + "Create a formal blog post about AI automation in healthcare for industry professionals.", + "Generate a casual, 500-word blog post about outdoor fitness tips with headings." + ] + }, + "tags": [ + "copywriting", + "blogging", + "content creation", + "SEO", + "marketing", + "drafting" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"targetAudience\":\"corporate employees\",\"keywords\":[\"work from home\",\"flexibility\",\"productivity\"],\"wordCount\":700,\"styleTone\":\"informative\",\"includeHeadings\":true}", + "description": "Draft a 700-word informative blog post about the benefits of remote work tailored for corporate employees including specified keywords." + }, + { + "inputJson": "{\"topic\":\"Top 5 travel destinations in 2024\",\"targetAudience\":\"millennial travelers\",\"keywords\":[\"budget travel\",\"adventure\",\"culture\"],\"wordCount\":600,\"styleTone\":\"casual\",\"includeHeadings\":true}", + "description": "Generate a casual and engaging 600-word blog post listing top travel destinations for millennials, focusing on budget and cultural experiences." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "BlogPost", + "context": null + } + }, + { + "name": "copywriting.draftArticle", + "description": "Generates a draft article based on a topic, target audience, and style preferences. Accepts inputs such as article topic, keywords to include, target audience description, desired tone, and approximate article length. Produces a coherent, structured article draft suitable for marketing or informational use.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the article to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords to be incorporated naturally within the article to improve SEO relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor the article's tone and complexity.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the article, e.g., professional, casual, persuasive, friendly.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate target length of the article in words.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted article text and metadata such as word count and suggested title." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a first draft of an article to support marketing campaigns, blog content, or informational materials quickly. It helps generate a structured and readable article based on the provided topic and parameters, serving as a solid foundation for further editing and refinement.", + "limitations": "The tool generates initial drafts but may lack detailed factual data, advanced domain-specific knowledge, or creative nuances. It should not be used as final published content without human review and editing.", + "examples": [ + "Draft an article on the benefits of renewable energy targeting environmentally conscious consumers with a friendly tone.", + "Generate a 800-word technical overview of blockchain for software developers including keywords like \"decentralization\" and \"smart contracts\".", + "Create a persuasive marketing article about a new fitness app aimed at young adults using casual tone." + ] + }, + "tags": [ + "copywriting", + "article", + "drafting", + "marketing", + "SEO", + "contentCreation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"keywords\":[\"flexibility\",\"work-life balance\"],\"targetAudience\":\"corporate employees\",\"tone\":\"professional\",\"length\":700}", + "description": "Draft an article about the benefits of remote work for corporate employees using a professional tone, including flexibility and work-life balance keywords." + }, + { + "inputJson": "{\"topic\":\"Summer skincare tips\",\"keywords\":[\"sun protection\",\"hydration\"],\"targetAudience\":\"young adults\",\"tone\":\"friendly\",\"length\":600}", + "description": "Create a friendly article providing summer skincare tips targeting young adults with emphasis on sun protection and hydration." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Article", + "context": null + } + }, + { + "name": "copywriting.draftProposal", + "description": "Drafts a professional business proposal document based on provided project details, client information, objectives, and deliverables. It accepts structured inputs describing the project scope, goals, timeline, budget, and client preferences, then generates a clear, organized, and persuasive proposal text suitable for sending to potential clients or stakeholders.", + "category": "copywriting", + "parameters": [ + { + "name": "projectTitle", + "type": "string", + "description": "Title of the project or proposal being prepared.", + "required": true, + "defaultValue": "" + }, + { + "name": "clientName", + "type": "string", + "description": "Name of the client or organization the proposal is addressed to.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "Detailed description of the project including purpose and background.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "List of project objectives or goals that the proposal aims to achieve.", + "required": true, + "defaultValue": "" + }, + { + "name": "deliverables", + "type": "array", + "description": "List of deliverables or key outputs that will be provided to the client.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeline", + "type": "string", + "description": "Estimated timeline or schedule for completing the project phases.", + "required": false, + "defaultValue": "" + }, + { + "name": "budget", + "type": "string", + "description": "Proposed budget or cost estimate for the project work.", + "required": false, + "defaultValue": "" + }, + { + "name": "clientPreferences", + "type": "string", + "description": "Additional notes or preferences specified by the client to tailor the proposal tone or style.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete draft proposal text in a 'proposalText' string field, formatted for readability and professional presentation." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a structured, formal business proposal document based on specific provided project and client information. Ideal for sales teams, consultants, and freelancers preparing custom proposals efficiently without starting from scratch.", + "limitations": "This tool does not provide legal or contractually binding text and should be reviewed by a professional before sending. It cannot replace detailed financial analysis or project management plans.", + "examples": [ + "Draft a proposal for a new mobile app development for a retail client including objectives and deliverables.", + "Generate a project proposal for SEO consulting services with timeline and budget details.", + "Create a professional proposal for an event planning project addressing a corporate client with specific style preferences." + ] + }, + "tags": [ + "copywriting", + "proposal", + "business document", + "marketing", + "sales", + "drafting", + "professional communication" + ], + "examples": [ + { + "inputJson": "{\"projectTitle\":\"Mobile App Development for Retail\",\"clientName\":\"Acme Retail Corp\",\"projectDescription\":\"Develop a cross-platform mobile application to enhance customer engagement and support online sales.\",\"objectives\":[\"Increase user engagement\",\"Streamline purchase process\",\"Integrate loyalty program\"],\"deliverables\":[\"iOS and Android app\",\"Admin dashboard\",\"User training and documentation\"],\"timeline\":\"6 months\",\"budget\":\"$150,000\",\"clientPreferences\":\"Formal tone, emphasize ROI benefits.\"}", + "description": "Generate a formal proposal draft for a retail client focused on app development with clear objectives and deliverables." + }, + { + "inputJson": "{\"projectTitle\":\"SEO Consulting Services\",\"clientName\":\"BrightStart Media\",\"projectDescription\":\"Provide SEO strategy and implementation to boost organic search rankings and traffic.\",\"objectives\":[\"Keyword research and optimization\",\"Content strategy development\",\"Backlink building\"],\"deliverables\":[\"SEO audit report\",\"Monthly performance reports\",\"Content calendar\"],\"timeline\":\"3 months\",\"budget\":\"$20,000\",\"clientPreferences\":\"Concise and persuasive tone.\"}", + "description": "Draft a concise SEO consulting proposal including budget and timeline for a media agency." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Proposal", + "context": null + } + }, + { + "name": "copywriting.draftContract", + "description": "This tool drafts customized legal contract documents based on user inputs such as the contract type, parties involved, key terms, and jurisdiction. It processes the provided parameters to generate a clear, professional contract draft in text format, suitable for further legal review or direct use.", + "category": "copywriting", + "parameters": [ + { + "name": "contractType", + "type": "string", + "description": "Type of contract to draft (e.g., NDA, service agreement, sales contract)", + "required": true, + "defaultValue": "" + }, + { + "name": "partyA", + "type": "string", + "description": "Name and details of the first party involved in the contract", + "required": true, + "defaultValue": "" + }, + { + "name": "partyB", + "type": "string", + "description": "Name and details of the second party involved in the contract", + "required": true, + "defaultValue": "" + }, + { + "name": "terms", + "type": "object", + "description": "Key contract terms including duration, payment, obligations, confidentiality, and termination details", + "required": true, + "defaultValue": "" + }, + { + "name": "governingLaw", + "type": "string", + "description": "Jurisdiction whose laws govern the contract (e.g., California, UK)", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSignatures", + "type": "boolean", + "description": "Whether to include signature lines for the parties", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted contract as a string in standard legal format, ready for review or use." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a preliminary draft of a legal contract tailored to specific parties, terms, and contract type without starting from scratch. Valuable for preparing initial drafts for NDAs, service agreements, or sales contracts that can be reviewed or edited by legal teams.", + "limitations": "This tool does not provide legal advice or guarantee the legal enforceability of the drafted contract. It requires user-provided accurate input and should be reviewed by qualified legal professionals before use.", + "examples": [ + "Draft an NDA agreement between Acme Corp and Beta LLC, including confidentiality for 2 years governed by California law.", + "Generate a service agreement contract for a freelance consultant and a client, specifying payment terms, services scope, and termination conditions under UK law.", + "Produce a sales contract between a supplier and retailer with delivery terms, payment schedule, and dispute resolution clauses under New York jurisdiction." + ] + }, + "tags": [ + "copywriting", + "legal", + "contract drafting", + "document generation", + "business", + "law", + "automation" + ], + "examples": [ + { + "inputJson": "{\"contractType\":\"NDA\",\"partyA\":\"Acme Corp, 123 Acme Street, Acme City\",\"partyB\":\"Beta LLC, 456 Beta Avenue, Beta Town\",\"terms\":{\"duration\":\"2 years\",\"confidentiality\":\"strict\",\"obligations\":\"no disclosure of proprietary information\",\"termination\":\"30 days notice\"},\"governingLaw\":\"California\",\"includeSignatures\":true}", + "description": "Draft a 2-year NDA contract with confidentiality and termination terms between two companies under California law." + }, + { + "inputJson": "{\"contractType\":\"Service Agreement\",\"partyA\":\"John Doe Consulting\",\"partyB\":\"XYZ Inc.\",\"terms\":{\"services\":\"IT consulting\",\"payment\":\"$5000 monthly\",\"duration\":\"12 months\",\"termination\":\"60 days notice\"},\"governingLaw\":\"UK\",\"includeSignatures\":true}", + "description": "Draft a service agreement contract for IT consulting services under UK jurisdiction including payment and termination conditions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Contract", + "context": null + } + }, + { + "name": "copywriting.draftDocument", + "description": "This tool generates a marketing or promotional document draft based on inputs like target audience, product features, tone, and length preferences. It processes these inputs to produce a coherent, persuasive document draft ready for review and editing.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the document, e.g., demographics, interests. Required to tailor content effectively.", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "Name of the product, service, or offering to promote in the document.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "List of key features or benefits of the product/service to highlight.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the document, e.g., professional, friendly, enthusiastic. Influences writing style.", + "required": false, + "defaultValue": "\"professional\"" + }, + { + "name": "documentLength", + "type": "number", + "description": "Approximate desired length of the draft in words to control verbosity.", + "required": false, + "defaultValue": "300" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call-to-action phrase or message to include at the end of the document.", + "required": false, + "defaultValue": "\"Contact us today to learn more!\"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the drafted document text as a string, including sections like introduction, feature highlights, and call to action." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create initial marketing or promotional content drafts tailored to specific audiences and products, helping speed up content creation that can be later refined by humans.", + "limitations": "The tool generates drafts and may not capture nuanced brand voice or comply fully with specialized marketing strategies requiring human review.", + "examples": [ + "Draft a promotional document targeting young professionals for a new smart watch emphasizing health features.", + "Create a friendly tone marketing draft for a luxury skincare line focusing on natural ingredients.", + "Generate a concise 200-word sales document for a B2B software solution with a compelling call to action." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional", + "content-creation", + "drafting", + "document" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"young professionals aged 25-35 interested in fitness and technology\",\"productName\":\"FitTrack Pro\",\"productFeatures\":[\"24/7 heart rate monitoring\",\"Sleep tracking\",\"Water-resistant up to 50m\"],\"tone\":\"enthusiastic\",\"documentLength\":350,\"callToAction\":\"Order your FitTrack Pro today and take control of your health!\"}", + "description": "Draft a promotional document highlighting fitness features of a smartwatch for tech-savvy young professionals." + }, + { + "inputJson": "{\"targetAudience\":\"small business owners looking for easy accounting solutions\",\"productName\":\"EasyBooks Cloud\",\"productFeatures\":[\"Automated invoicing\",\"Real-time expense tracking\",\"Secure cloud backups\"],\"tone\":\"professional\",\"documentLength\":250,\"callToAction\":\"Start your free trial of EasyBooks Cloud now!\"}", + "description": "Create a professional marketing draft promoting accounting software to small business owners." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Document", + "context": null + } + }, + { + "name": "copywriting.draftReport", + "description": "Generates a structured marketing or business report based on provided input data and objectives. Accepts input parameters like report type, target audience, key points to include, tone style, and additional data. Outputs a well-formed, coherent report draft optimized for promotional or business contexts.", + "category": "copywriting", + "parameters": [ + { + "name": "reportType", + "type": "string", + "description": "Specifies the type of report to generate, such as 'market analysis', 'performance overview', or 'product launch'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Defines the intended readers of the report (e.g., executives, customers, investors) to tailor the tone and content.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of key topics or data points that must be covered in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Sets the writing tone of the report, such as 'formal', 'persuasive', or 'casual'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "additionalData", + "type": "object", + "description": "Optional supplementary data or statistics to incorporate into the report's content.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the report in words.", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the drafted report text and metadata such as report type and word count." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a professional marketing, business, or performance report draft automatically from structured input data and key points, ensuring the report is targeted, coherent, and styled appropriately for the audience.", + "limitations": "The tool cannot replace human experts in validating data accuracy or contextual nuances beyond the supplied inputs; it does not generate real data but relies on user-provided information.", + "examples": [ + "Draft a market analysis report for investors highlighting growth potential and risks, using a formal tone.", + "Create a product launch overview for customers focusing on benefits with a persuasive tone, around 800 words.", + "Generate a quarterly performance report for executives emphasizing key achievements and statistics." + ] + }, + "tags": [ + "copywriting", + "report", + "marketing", + "business", + "drafting", + "automation" + ], + "examples": [ + { + "inputJson": "{\"reportType\":\"market analysis\",\"targetAudience\":\"investors\",\"keyPoints\":[\"growth potential\",\"competitive landscape\",\"market risks\"],\"tone\":\"formal\",\"length\":1200}", + "description": "Generate a formal market analysis report aimed at investors emphasizing growth potential and risks." + }, + { + "inputJson": "{\"reportType\":\"product launch\",\"targetAudience\":\"customers\",\"keyPoints\":[\"product features\",\"usage benefits\",\"special offers\"],\"tone\":\"persuasive\",\"length\":800}", + "description": "Draft a persuasive product launch report for customers highlighting features and benefits." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Report", + "context": null + } + }, + { + "name": "copywriting.composeCitation", + "description": "Generates a properly formatted academic citation based on input source details and selected citation style. Accepts source information such as author(s), title, publication year, and more. Outputs a correctly formatted citation string suitable for academic or professional use.", + "category": "copywriting", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of author names in 'LastName, FirstName' format. Required for citation.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the source material such as a book, article, or paper. Required for citation.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year when the source was published. Helps indicate the currency of the source. Required for citation.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source, e.g., book, journal article, website, report. Adjusts citation formatting accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or organization that released the source. Optional for some source types.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of the online source if applicable, included as part of the citation when relevant.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format output, e.g., APA, MLA, Chicago. Determines citation formatting rules. Required.", + "required": true, + "defaultValue": "APA" + }, + { + "name": "pageNumbers", + "type": "string", + "description": "Page numbers or page range to cite, if applicable. Included in citation for articles or book chapters.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string under the key 'formattedCitation'." + }, + "aiAgent": { + "useCase": "Use this tool when tasked with generating standardized citations for academic, research, or professional documents. It automates adherence to specific citation style guides, saving time and reducing errors in citation formatting.", + "limitations": "Cannot verify accuracy of source data; relies on correct input. Not designed to handle extremely uncommon or custom citation styles. Formatting nuances might vary slightly based on style guide updates.", + "examples": [ + "Generate an APA citation for a journal article authored by multiple people.", + "Compose an MLA citation for a book with a known publisher and publication year.", + "Create a Chicago style citation for a web source including a URL and accessed year." + ] + }, + "tags": [ + "copywriting", + "citation", + "academic", + "formatting", + "APA", + "MLA", + "Chicago" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"The Future of AI\",\"publicationYear\":2023,\"sourceType\":\"journal article\",\"publisher\":\"Tech Journal\",\"url\":\"https://techjournal.org/future-ai\",\"citationStyle\":\"APA\",\"pageNumbers\":\"15-29\"}", + "description": "Generate an APA formatted citation for a journal article with two authors and page numbers." + }, + { + "inputJson": "{\"authors\":[\"Brown, Lisa\"],\"title\":\"Understanding Quantum Computing\",\"publicationYear\":2020,\"sourceType\":\"book\",\"publisher\":\"Science Press\",\"citationStyle\":\"MLA\"}", + "description": "Create an MLA citation for a book with one author and a known publisher." + }, + { + "inputJson": "{\"authors\":[\"Johnson, Mark\"],\"title\":\"Advances in Renewable Energy\",\"publicationYear\":2021,\"sourceType\":\"website\",\"url\":\"https://renewableenergy.com/article\",\"citationStyle\":\"Chicago\"}", + "description": "Produce a Chicago style citation for a web article including a URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Citation", + "context": null + } + }, + { + "name": "copywriting.composeReference", + "description": "Generates a professional, concise reference letter or testimonial text based on input details about the subject, relationship, and qualities to recommend. Accepts structured data about the person to reference, purpose, and tone, then composes a formatted reference text output suitable for use in job applications, academic purposes, or endorsements.", + "category": "copywriting", + "parameters": [ + { + "name": "subjectName", + "type": "string", + "description": "Full name of the person to be referenced (required for personalization).", + "required": true, + "defaultValue": "" + }, + { + "name": "relationship", + "type": "string", + "description": "Description of the relationship between the writer and the subject (e.g., manager, professor).", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Intended purpose of the reference letter (e.g., job application, academic admission).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyQualities", + "type": "array", + "description": "List of key qualities, skills, or achievements to highlight in the reference.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the reference (e.g., formal, friendly, enthusiastic).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the reference text in sentences.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed reference letter text formatted as plain text." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to generate a well-structured and personalized reference letter or testimonial text based on defined inputs about the candidate and context. Ideal for automating recommendation letter drafts, saving time, and ensuring relevant qualities are highlighted appropriately.", + "limitations": "The tool cannot verify factual accuracy of inputs or provide legally binding recommendations. It relies entirely on supplied data and cannot generate references without sufficient detail.", + "examples": [ + "Compose a strong, formal job reference for an employee named Jane Doe, highlighting her leadership and communication skills.", + "Create a friendly academic reference for a student applying to graduate school named John Smith, focusing on research and teamwork.", + "Generate a brief enthusiastic testimonial for a freelancer named Alex Brown, emphasizing reliability and creativity." + ] + }, + "tags": [ + "copywriting", + "reference", + "recommendation", + "testimonial", + "letter", + "compose", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"subjectName\":\"Jane Doe\",\"relationship\":\"former manager\",\"purpose\":\"job application\",\"keyQualities\":[\"leadership\",\"communication skills\"],\"tone\":\"formal\",\"length\":6}", + "description": "Compose a formal reference letter for an employee Jane Doe emphasizing leadership and communication." + }, + { + "inputJson": "{\"subjectName\":\"John Smith\",\"relationship\":\"professor\",\"purpose\":\"graduate school admission\",\"keyQualities\":[\"research abilities\",\"teamwork\"],\"tone\":\"friendly\",\"length\":5}", + "description": "Create a friendly academic reference for a student John Smith highlighting research and teamwork skills." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reference", + "context": null + } + }, + { + "name": "copywriting.composeQuote", + "description": "Generates impactful and contextually relevant marketing or inspirational quotes based on input themes, tone, and target audience characteristics. Accepts parameters specifying the desired stylistic tone, themes, and audience to produce a tailored quote text suitable for promotional or motivational use.", + "category": "copywriting", + "parameters": [ + { + "name": "theme", + "type": "string", + "description": "Primary theme or subject of the quote, guiding its conceptual focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The stylistic tone for the quote, e.g., inspirational, motivational, humorous, formal.", + "required": false, + "defaultValue": "inspirational" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for which the quote is intended, influencing style and wording.", + "required": false, + "defaultValue": "" + }, + { + "name": "lengthLimit", + "type": "number", + "description": "Maximum number of characters allowed in the quote text to ensure brevity and impact.", + "required": false, + "defaultValue": "140" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a subtle call to action or motivational prompt within the quote.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated quote text and metadata such as theme, tone, and length." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate concise, effective quotes for marketing materials, social posts, presentations, or motivational content. It helps produce well-phrased quotes aligned with specific themes and audience tones without manually crafting each one.", + "limitations": "The tool generates quotes based on input parameters but cannot verify originality or guarantee uniqueness. It also does not produce very long texts or detailed explanations, being limited to short quote style outputs.", + "examples": [ + "Create a motivational quote about teamwork for young professionals.", + "Generate an inspirational quote on innovation with a formal tone.", + "Compose a humorous marketing quote about productivity including a call to action." + ] + }, + "tags": [ + "copywriting", + "quote generation", + "marketing", + "inspirational", + "motivational", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"theme\":\"teamwork\",\"tone\":\"motivational\",\"targetAudience\":\"young professionals\",\"lengthLimit\":120,\"includeCallToAction\":false}", + "description": "Generate a motivational quote about teamwork targeted at young professionals with a length limit of 120 characters." + }, + { + "inputJson": "{\"theme\":\"innovation\",\"tone\":\"formal\",\"targetAudience\":\"corporate executives\",\"lengthLimit\":140,\"includeCallToAction\":false}", + "description": "Compose a formal inspirational quote about innovation for corporate executives." + }, + { + "inputJson": "{\"theme\":\"productivity\",\"tone\":\"humorous\",\"targetAudience\":\"general public\",\"lengthLimit\":140,\"includeCallToAction\":true}", + "description": "Produce a humorous marketing quote about productivity including a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Quote", + "context": null + } + }, + { + "name": "copywriting.composeLink", + "description": "This tool generates persuasive and engaging promotional text for a given URL link. Users provide the link URL and optionally a title, target audience description, and desired tone. The tool analyzes the input and composes a concise marketing message that highlights the link's value or content to encourage clicks or shares.", + "category": "copywriting", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The target URL for which to compose promotional text.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title or headline related to the link content, to help contextualize the message.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the promotional message, to tailor tone and content.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the promotional text (e.g., professional, casual, enthusiastic).", + "required": false, + "defaultValue": "casual" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the output promotional text in characters.", + "required": false, + "defaultValue": "280" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed promotional text optimized for sharing or marketing use." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create short, compelling promotional copy that encourages users to visit or share a specific web link. It is useful for social media posts, emails, or digital marketing content where quick engagement is vital.", + "limitations": "This tool cannot verify or analyze the actual content of the URL beyond parsing metadata or title provided. It also cannot generate long-form descriptions or detailed reviews.", + "examples": [ + "Compose a catchy tweet to promote https://example.com announcing a new product.", + "Generate a short promotional message for a link to a blog post targeting young professionals with an enthusiastic tone.", + "Create an engaging link preview text for a business website homepage in a professional tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "linkPromotion", + "socialMedia", + "contentCreation", + "shortCopy" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://technews.com/new-gadget\",\"title\":\"Introducing the X100 Gadget\",\"targetAudience\":\"tech enthusiasts and early adopters\",\"tone\":\"enthusiastic\",\"maxLength\":150}", + "description": "Compose a promotional message for a tech gadget aimed at tech enthusiasts with an enthusiastic style." + }, + { + "inputJson": "{\"url\":\"https://healthtips.org/healthy-eating\",\"title\":\"Healthy Eating Guide\",\"targetAudience\":\"general public interested in wellness\",\"tone\":\"professional\",\"maxLength\":200}", + "description": "Generate a professional promotional text designed for a health and wellness audience." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Link", + "context": null + } + }, + { + "name": "copywriting.composeWord", + "description": "Generates a single compelling marketing or promotional word based on the specified industry, target audience, tone, and optional keyword input to enhance brand messaging and engagement. Outputs a word optimized for use in advertising and copywriting contexts.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "The industry or sector relevant to the word, e.g., technology, fashion, finance.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The demographic or customer segment the word should appeal to, e.g., millennials, professionals.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or feeling the word should convey, e.g., energetic, trustworthy, luxurious.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyword", + "type": "string", + "description": "An optional seed keyword or concept to base the word upon or relate to, enhancing thematic relevance.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word and a brief explanation of its marketing appeal and usage context." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a powerful single word tailored for marketing copy that fits the specified industry, audience, and tone. Ideal for branding, campaign naming, slogans, or highlighting product features with catchy, targeted vocabulary.", + "limitations": "This tool does not generate full sentences or copy blocks, only single words. It may not always guarantee trademark or uniqueness clearance for generated terms.", + "examples": [ + "Create a compelling word for a new tech gadget aimed at young professionals with a futuristic tone.", + "Generate an energetic word for a fitness brand targeting millennials.", + "Find a luxury-oriented word for a high-end fashion line aimed at affluent customers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "branding", + "content generation", + "word generation" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"technology\",\"targetAudience\":\"young professionals\",\"tone\":\"futuristic\",\"keyword\":\"innovation\"}", + "description": "Generate a futuristic marketing word for technology targeting young professionals, inspired by the keyword innovation." + }, + { + "inputJson": "{\"industry\":\"fitness\",\"targetAudience\":\"millennials\",\"tone\":\"energetic\",\"keyword\":\"power\"}", + "description": "Create an energetic promotional word for a fitness brand aimed at millennials related to 'power'." + }, + { + "inputJson": "{\"industry\":\"fashion\",\"targetAudience\":\"affluent customers\",\"tone\":\"luxurious\",\"keyword\":\"elegance\"}", + "description": "Compose a luxury-oriented word for a high-end fashion audience centered on elegance." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Word", + "context": null + } + }, + { + "name": "copywriting.composeSentence", + "description": "Generates a single marketing or promotional sentence based on the provided product or service description, target audience, and tone. It accepts input parameters like product details, target customer, and desired tone, then composes an engaging sentence suitable for advertising or promotional use.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "Brief description of the product or service to promote", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The specific audience or customer segment for the sentence", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the sentence (e.g., professional, casual, enthusiastic)", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeCTA", + "type": "boolean", + "description": "Whether to include a call-to-action in the sentence", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed sentence as a string under the key 'sentence'" + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents tasked with creating concise, impactful promotional content where a single, well-crafted sentence is needed to highlight a product's value to a specific audience with a chosen tone. It helps generate marketing copy for ads, social media posts, or product descriptions.", + "limitations": "This tool generates only one sentence and cannot produce longer marketing texts or multiple variations at once. It may not handle highly technical or niche products without detailed input.", + "examples": [ + "Compose a promotional sentence for a new eco-friendly water bottle targeting outdoor enthusiasts in an enthusiastic tone including a call to action.", + "Create a professional sentence advertising a software tool for small businesses without a call to action.", + "Generate a casual sentence describing a new coffee blend aimed at young adults." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotion", + "sentence generation", + "advertising", + "tone control" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"eco-friendly reusable water bottle\",\"targetAudience\":\"outdoor enthusiasts\",\"tone\":\"enthusiastic\",\"includeCTA\":true}", + "description": "Generate an enthusiastic sentence with a call to action promoting an eco-friendly water bottle for outdoor enthusiasts." + }, + { + "inputJson": "{\"productDescription\":\"project management software for small businesses\",\"tone\":\"professional\",\"includeCTA\":false}", + "description": "Create a professional promotional sentence describing project management software without a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Sentence", + "context": null + } + }, + { + "name": "copywriting.composeText", + "description": "Generates marketing and promotional text based on input parameters such as target audience, product or service details, desired tone, and text length. It processes these inputs to compose clear, persuasive copy suitable for various marketing channels, producing finalized text output.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be promoted", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the marketing text", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "Key features or benefits of the product/service to highlight in the text", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone/style of the text, e.g., professional, casual, enthusiastic", + "required": false, + "defaultValue": "professional" + }, + { + "name": "textLength", + "type": "number", + "description": "Approximate desired length of the generated text in words", + "required": false, + "defaultValue": "100" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call to action to include in the text (optional)", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing text as a string under 'composedText'." + }, + "aiAgent": { + "useCase": "Use this tool when a marketing or promotional text is needed quickly based on product details and audience profile. It helps generate tailored copy that aligns with marketing objectives, tone, and desired length without manual writing.", + "limitations": "The tool cannot perform deep market research or provide real-time competitive analysis. It may not capture brand-specific guidelines unless explicitly detailed in inputs.", + "examples": [ + "Compose a promotional email text for a new eco-friendly water bottle targeting health-conscious millennials, tone casual, about 150 words.", + "Generate a brief social media ad copy for an online course on machine learning for beginners with an enthusiastic tone.", + "Create website homepage text highlighting the features of a new smartphone, professional tone, about 200 words, including a call to action to buy now." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional text", + "content generation", + "advertising", + "AI writing" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoWave Water Bottle\",\"targetAudience\":\"health-conscious millennials\",\"productFeatures\":[\"BPA-free\",\"insulated\",\"keeps drinks cold for 24 hours\"],\"tone\":\"casual\",\"textLength\":150,\"callToAction\":\"Order now to get 20% off!\"}", + "description": "Create casual promotional text for EcoWave Water Bottle targeting young health-focused consumers with features and a call to action." + }, + { + "inputJson": "{\"productName\":\"ML Starter Course\",\"targetAudience\":\"beginners interested in AI\",\"tone\":\"enthusiastic\",\"textLength\":100,\"callToAction\":\"Sign up today!\"}", + "description": "Generate enthusiastic social media ad copy for an introductory machine learning course inviting beginners to enroll." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Text", + "context": null + } + }, + { + "name": "copywriting.composeParagraph", + "description": "Generates a coherent and engaging marketing or promotional paragraph based on specified product or service details, tone, and target audience. Accepts input parameters describing the subject and style, then composes a tailored paragraph suitable for advertising or content marketing purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The main product, service, or topic to promote in the paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the paragraph, such as 'friendly', 'professional', 'enthusiastic', or 'informative'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or customer persona for the paragraph, e.g., 'young adults into fitness', 'small business owners', etc.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or selling points about the subject to be included in the paragraph.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length of the generated paragraph to control verbosity.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing paragraph text under the 'paragraph' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a concise and compelling paragraph for marketing materials, product descriptions, or promotional content tailored to specific subjects and tones. Ideal for quickly generating human-like persuasive text based on input features and audience information.", + "limitations": "This tool cannot create multi-paragraph content or guarantee factual accuracy beyond the provided inputs. It does not generate images or bullet lists, and is limited to text paragraphs only.", + "examples": [ + "Compose a friendly paragraph promoting a new organic energy drink aimed at fitness enthusiasts including its natural ingredients and health benefits.", + "Create a professional paragraph describing a software service for small business owners highlighting ease of use and cost savings.", + "Write an enthusiastic paragraph about a summer sale event focusing on discounts and limited-time offers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional", + "paragraph", + "content-generation", + "advertising", + "branding" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Eco-friendly reusable water bottles\",\"tone\":\"friendly\",\"targetAudience\":\"environmentally conscious millennials\",\"keyFeatures\":[\"BPA-free material\",\"keeps drinks cold for 24 hours\",\"stylish designs\"],\"maxLength\":300}", + "description": "Generate a friendly marketing paragraph about reusable water bottles for eco-conscious millennials including key features." + }, + { + "inputJson": "{\"subject\":\"Cloud-based project management software\",\"tone\":\"professional\",\"targetAudience\":\"small business teams\",\"keyFeatures\":[\"real-time collaboration\",\"task tracking\",\"customizable workflows\"],\"maxLength\":400}", + "description": "Create a professional promotional paragraph for a project management software targeting small teams, emphasizing key features." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Paragraph", + "context": null + } + }, + { + "name": "copywriting.composeReply", + "description": "This tool generates professional and contextually appropriate reply messages based on an input message and optional parameters such as tone, formality, and reply length. It processes the given conversation snippet or query and composes a coherent and relevant textual response suitable for emails, customer service, or social media communications.", + "category": "copywriting", + "parameters": [ + { + "name": "inputMessage", + "type": "string", + "description": "The original message or query to which a reply is to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone of the reply (e.g., friendly, formal, enthusiastic).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "formality", + "type": "string", + "description": "The formality level of the reply (e.g., informal, neutral, formal).", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "replyLength", + "type": "string", + "description": "Preferred length of the reply (e.g., short, medium, long).", + "required": false, + "defaultValue": "medium" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action phrase in the reply.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the reply text (e.g., en, es, fr).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed reply message as a string under 'replyMessage'." + }, + "aiAgent": { + "useCase": "Use this tool when tasked with generating a well-written response to an incoming communication in contexts such as customer support, email correspondence, or social media interaction. It helps produce replies that match requested tone and formality while ensuring relevance to the original message.", + "limitations": "Cannot handle real-time conversations or understand visual/non-textual context. Replies are generated solely from the provided message and parameters; complex multi-turn dialogue context may not be fully captured.", + "examples": [ + "Compose a friendly and short reply to a customer's complaint about delayed shipment.", + "Generate a formal and detailed response to an inquiry regarding product features.", + "Create an informal and enthusiastic reply to a social media comment praising a service." + ] + }, + "tags": [ + "copywriting", + "reply", + "communication", + "email", + "customer-service", + "social-media", + "tone", + "formality" + ], + "examples": [ + { + "inputJson": "{\"inputMessage\":\"Thank you for contacting us about your delayed shipment. We apologize for the inconvenience.\",\"tone\":\"friendly\",\"formality\":\"informal\",\"replyLength\":\"short\",\"includeCallToAction\":true,\"language\":\"en\"}", + "description": "Compose a friendly, informal, short reply with a call to action to a customer support message." + }, + { + "inputJson": "{\"inputMessage\":\"Could you provide detailed specifications of the latest model?\",\"tone\":\"formal\",\"formality\":\"formal\",\"replyLength\":\"long\",\"includeCallToAction\":false,\"language\":\"en\"}", + "description": "Generate a formal, detailed reply to a customer inquiry about product specifications." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reply", + "context": null + } + }, + { + "name": "copywriting.composeHeading", + "description": "Generates a catchy and optimized heading text based on a topic, tone, and target audience. Accepts a topic string, optional tone and audience parameters, and returns a concise heading suitable for marketing or promotional use.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone for the heading, e.g., friendly, formal, urgent.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor the heading accordingly, e.g., young professionals, tech enthusiasts.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the heading to ensure brevity.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create compelling headings for marketing materials such as ads, web pages, or emails, ensuring the heading matches the theme, appeals to the audience, and fits length constraints.", + "limitations": "It cannot generate full-length articles or detailed content bodies; output is limited to concise heading text that aligns with inputs and tone but may require manual review for brand fit.", + "examples": [ + "Create a friendly heading about eco-friendly products for young adults.", + "Generate a formal heading for a corporate software launch targeting executives.", + "Compose an urgent heading for a limited-time sale targeting online shoppers." + ] + }, + "tags": [ + "copywriting", + "heading", + "marketing", + "content creation", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"eco-friendly products\",\"tone\":\"friendly\",\"targetAudience\":\"young adults\",\"maxLength\":50}", + "description": "Generate a friendly heading about eco-friendly products targeting young adults." + }, + { + "inputJson": "{\"topic\":\"corporate software launch\",\"tone\":\"formal\",\"targetAudience\":\"executives\",\"maxLength\":60}", + "description": "Create a formal heading for corporate software launch aimed at executives." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Heading", + "context": null + } + }, + { + "name": "copywriting.composeMention", + "description": "This tool generates a well-crafted mention text suitable for marketing or promotional communications. It accepts inputs about the person or brand to mention, the context of the mention, tone style, and desired length. It outputs a polished mention text that can be used in copywriting for social media, emails, or ads.", + "category": "copywriting", + "parameters": [ + { + "name": "mentionName", + "type": "string", + "description": "The name of the person, brand, or entity to mention in the text.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "Brief description or context around why the mention is being made, e.g., product endorsement, event shoutout.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone style of the mention text, such as formal, casual, enthusiastic, or neutral.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the mention text in words.", + "required": false, + "defaultValue": "30" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action in the mention text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated mention text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly create engaging and context-appropriate mention statements for marketing or promotional content, such as tagging influencers, partners, or brands in social media posts, newsletters, or advertisements. It helps produce polished, tone-appropriate text that fits the given context and length constraints.", + "limitations": "Cannot guarantee uniqueness or compliance with brand guidelines. It does not generate images or complex multi-entity mentions. The tone and style may require human review to ensure marketing appropriateness.", + "examples": [ + "Generate an enthusiastic mention for a brand endorsing a new product in a social media post.", + "Compose a formal mention text for an event shoutout including a call to action.", + "Create a short, casual mention highlighting a partner company in an email newsletter." + ] + }, + "tags": [ + "copywriting", + "mention", + "marketing", + "branding", + "social media", + "promotion", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"mentionName\":\"EcoClean\",\"context\":\"partnering to promote sustainable home products\",\"tone\":\"enthusiastic\",\"length\":40,\"includeCallToAction\":true}", + "description": "Generate an enthusiastic mention for EcoClean emphasizing partnership and a call to action." + }, + { + "inputJson": "{\"mentionName\":\"Dr. Jane Smith\",\"context\":\"keynote speaker at our annual conference\",\"tone\":\"formal\",\"length\":30,\"includeCallToAction\":false}", + "description": "Compose a formal mention to highlight Dr. Jane Smith as a keynote speaker without a call to action." + }, + { + "inputJson": "{\"mentionName\":\"SmartHome Inc.\",\"context\":\"collaborating on new smart device launch\",\"tone\":\"casual\",\"length\":20,\"includeCallToAction\":false}", + "description": "Create a short, casual mention of SmartHome Inc. for a newsletter about a new device launch." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Mention", + "context": null + } + }, + { + "name": "copywriting.composeChannel", + "description": "Generates tailored marketing and communication content optimized for a specified communication channel such as email, social media, blogs, or ads. Takes details about the target audience, brand tone, message goal, and channel type, then composes engaging text that fits the stylistic and technical constraints of the selected channel.", + "category": "copywriting", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "The communication channel for which the text is to be composed, e.g., 'email', 'socialMedia', 'blog', 'advertisement'. Determines style and format.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience including demographics, interests, or behaviors to tailor the message appropriately.", + "required": true, + "defaultValue": "" + }, + { + "name": "brandTone", + "type": "string", + "description": "Defines the brand voice or tone (e.g., friendly, professional, playful) to be reflected in the content.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageGoal", + "type": "string", + "description": "The main purpose of the message such as to inform, persuade, promote, or engage.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "A list of main features, offers, or ideas that should be emphasized in the content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "lengthLimit", + "type": "number", + "description": "Maximum character length or word count for the composed content, tailored to the channel's typical constraints.", + "required": false, + "defaultValue": "280" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action in the content to prompt audience response or engagement.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') for output content; defaults to English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated content text optimized for the specified channel and parameters, plus metadata like length and language." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce marketing or promotional text tailored specifically to the communication channel. It helps create messages that resonate with the intended audience while respecting channel constraints like length and tone.", + "limitations": "Cannot replace deep strategic marketing expertise or understand highly specialized brand nuances outside the provided inputs. The generated content may need human review for best results.", + "examples": [ + "Compose a friendly email to young adult customers promoting a new eco-friendly product line.", + "Generate a concise social media post in professional tone highlighting a webinar announcement.", + "Create an engaging blog introduction informing tech enthusiasts about the latest software release." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "communication", + "channel", + "promotion", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"targetAudience\":\"young adults interested in sustainability\",\"brandTone\":\"friendly\",\"messageGoal\":\"promote new eco-friendly product line\",\"keyPoints\":[\"made from recycled materials\",\"discount offer\",\"limited-time availability\"],\"lengthLimit\":300,\"includeCallToAction\":true,\"language\":\"en\"}", + "description": "Compose a promotional email for eco-conscious young adult customers." + }, + { + "inputJson": "{\"channelType\":\"socialMedia\",\"targetAudience\":\"professionals in marketing\",\"brandTone\":\"professional\",\"messageGoal\":\"announce upcoming webinar\",\"keyPoints\":[\"date, time, and registration link\"],\"lengthLimit\":150,\"includeCallToAction\":true,\"language\":\"en\"}", + "description": "Generate a social media announcement for a marketing webinar in a professional tone." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Channel", + "context": null + } + }, + { + "name": "copywriting.composeReadme", + "description": "Generates a professional README.md file for software projects based on input details such as project name, description, installation steps, usage instructions, contribution guidelines, license, and contact info. Produces a markdown formatted README string ready for inclusion in repositories.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the software project.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief summary describing the project and its purpose.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions for installing the software (can include commands or prerequisites).", + "required": false, + "defaultValue": "" + }, + { + "name": "usageInformation", + "type": "string", + "description": "Details on how to use the software, including examples or commands.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Guidelines for other developers who want to contribute to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "licenseName", + "type": "string", + "description": "The license type of the project, e.g., MIT, Apache 2.0, GPLv3.", + "required": false, + "defaultValue": "" + }, + { + "name": "contactEmail", + "type": "string", + "description": "Contact email for project maintainers for questions or support.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'readmeMarkdown' which is a string containing the complete README content formatted in markdown." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a standardized, clear, and professional README file for a software project repository to help users understand and utilize the project quickly. It is useful during project setup automation, documentation generation, or when scaffolding new projects.", + "limitations": "This tool cannot validate technical accuracy of installation or usage instructions. It generates text based on provided input and does not test the software itself. Very complex or highly customized docs may need manual refinement.", + "examples": [ + "Create a README for a Python library that does text analysis, including install via pip, usage examples, an MIT license, and contributor contact.", + "Generate a basic README for a web app project with a short project description and usage instructions only.", + "Produce a README with detailed contribution guidelines and license info for an open source CLI tool." + ] + }, + "tags": [ + "copywriting", + "documentation", + "readme", + "markdown", + "software", + "automation", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"TextAnalyzer\",\"projectDescription\":\"A Python library for analyzing and summarizing text.\",\"installationInstructions\":\"Install via pip: pip install textanalyzer\",\"usageInformation\":\"Import the library and use the summarize() function.\",\"contributionGuidelines\":\"Fork the repo and submit pull requests.\",\"licenseName\":\"MIT\",\"contactEmail\":\"support@textanalyzer.org\"}", + "description": "Generating a complete README for a Python text analysis library." + }, + { + "inputJson": "{\"projectName\":\"WebApp\",\"projectDescription\":\"A React-based web application for task management.\",\"usageInformation\":\"Run npm start to launch the app.\",\"licenseName\":\"Apache 2.0\"}", + "description": "Generating a README with basic usage info and license for a React web app." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Readme", + "context": null + } + }, + { + "name": "copywriting.composeNotification", + "description": "This tool generates tailored notification messages for various contexts such as app alerts, email updates, or push notifications. It accepts inputs describing the notification purpose, target audience, tone, and key content points, then creates a clear, concise, and engaging notification message output ready for distribution.", + "category": "copywriting", + "parameters": [ + { + "name": "notificationType", + "type": "string", + "description": "Type of notification to compose, e.g., 'appAlert', 'emailUpdate', 'pushNotification'.", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience or user segment for the notification, e.g., 'newUsers', 'subscribers', 'premiumMembers'.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the notification, such as 'formal', 'casual', 'friendly', or 'urgent'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "contentPoints", + "type": "array", + "description": "Key points or information items that must be included in the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call-to-action phrase or instruction to include, e.g., 'Update now', 'Learn more'.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the notification text in characters to ensure brevity and fit.", + "required": false, + "defaultValue": "160" + } + ], + "returns": { + "type": "object", + "description": "Returns a JSON object with a composed notification message string, and metadata such as character count and suggested send channel." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate professional and customized notification messages for marketing, user engagement, or informational purposes, tailored by type and audience with an appropriate tone. It helps automate writing concise and effective notices suitable for various communication channels.", + "limitations": "Cannot generate multimedia content, complex personalization beyond given input parameters, or guarantee compliance with all regulatory standards for notifications like opt-in requirements.", + "examples": [ + "Compose a push notification for premium members with a friendly tone informing them of a new feature.", + "Create an email update for new users with a formal tone summarizing recent changes.", + "Generate a short app alert with an urgent tone calling users to update the app immediately." + ] + }, + "tags": [ + "copywriting", + "notification", + "marketing", + "communication", + "content-generation", + "messaging", + "automation" + ], + "examples": [ + { + "inputJson": "{\"notificationType\":\"pushNotification\",\"audience\":\"premiumMembers\",\"tone\":\"friendly\",\"contentPoints\":[\"New feature available\",\"Improved interface\",\"Exclusive access\"],\"callToAction\":\"Try it now!\",\"maxLength\":140}", + "description": "Generate a push notification message informing premium members of a new feature with a friendly tone and concise format." + }, + { + "inputJson": "{\"notificationType\":\"emailUpdate\",\"audience\":\"newUsers\",\"tone\":\"formal\",\"contentPoints\":[\"Welcome to our platform\",\"Overview of features\",\"How to get started\"],\"callToAction\":\"Get started\",\"maxLength\":500}", + "description": "Compose a formal email update welcoming new users and guiding them to get started with platform features." + }, + { + "inputJson": "{\"notificationType\":\"appAlert\",\"audience\":\"allUsers\",\"tone\":\"urgent\",\"contentPoints\":[\"Critical security update\",\"Immediate app update required\"],\"callToAction\":\"Update now\",\"maxLength\":100}", + "description": "Create an urgent app alert instructing all users to apply a critical security update immediately." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Notification", + "context": null + } + }, + { + "name": "copywriting.composeThread", + "description": "Generates a coherent and engaging communication thread suitable for social media or email based on the provided topic, target audience, and style preferences. Accepts input details like topic, tone, audience, and number of messages, then produces a structured thread of short, sequential messages designed to inform, persuade, or engage readers.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the thread to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers or recipients of the thread, influencing style and content.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or writing style for the thread messages, e.g., formal, casual, enthusiastic.", + "required": false, + "defaultValue": "casual" + }, + { + "name": "messageCount", + "type": "number", + "description": "The number of individual messages or posts to generate in the thread.", + "required": false, + "defaultValue": "5" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action to include towards the end of the thread, like visiting a link or responding.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing an ordered array of composed messages forming the thread." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create multi-part communications such as social media threads or email sequences that are coherent, topical, and tailored to an audience with a specified tone. It helps generate structured, engaging, and goal-oriented content spanning multiple messages or posts.", + "limitations": "Cannot guarantee factual accuracy beyond training data. Does not produce multimedia content. Limited in handling extremely technical or specialized domain-specific jargon unless explicitly provided. Not intended for real-time updates or dynamic conversations.", + "examples": [ + "Create a 7-post Twitter thread for tech enthusiasts about the newest AI model.", + "Write a 3-message email thread in a formal tone aimed at prospective clients introducing a new service.", + "Compose a 5-message casual social media thread promoting a summer sale with a call to action to visit the website." + ] + }, + "tags": [ + "copywriting", + "social media", + "thread", + "content generation", + "marketing", + "communication" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Introducing our new AI productivity tool\",\"targetAudience\":\"tech professionals\",\"tone\":\"enthusiastic\",\"messageCount\":5,\"callToAction\":\"Try it free today!\"}", + "description": "Compose a 5-message social media thread with an enthusiastic tone for tech professionals about a new AI productivity tool, ending with a call to action." + }, + { + "inputJson": "{\"topic\":\"Weekly company update\",\"targetAudience\":\"employees\",\"tone\":\"formal\",\"messageCount\":3,\"callToAction\":\"Please submit your reports by Friday.\"}", + "description": "Generate a 3-message formal email thread providing a weekly update to employees with a clear call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Thread", + "context": null + } + }, + { + "name": "copywriting.composeComment", + "description": "Generates a tailored comment based on the provided topic, tone, and context. Accepts inputs including the subject matter, desired style (e.g., friendly, professional), and any key points to highlight. Produces a well-formed comment suitable for use in marketing communications, social media, or customer engagement.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme the comment should address.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The style or attitude of the comment, such as friendly, professional, enthusiastic, or neutral.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of important points or keywords that the comment should include or emphasize.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters for the comment to ensure brevity or platform-specific limits.", + "required": false, + "defaultValue": "250" + }, + { + "name": "audience", + "type": "string", + "description": "The intended audience of the comment, e.g., customers, partners, social media followers.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated comment text that aligns with the given parameters." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate engaging and contextually appropriate comments for marketing purposes, whether for social media posts, product feedback, or customer interactions. It helps create consistent, tone-aware communication that incorporates specific key points or messaging.", + "limitations": "This tool cannot guarantee factual correctness or appropriateness beyond the input scope provided. It does not replace human review for sensitive or highly regulated content.", + "examples": [ + "Create a friendly comment highlighting new features of a product launch for social media.", + "Generate a professional comment emphasizing key benefits of a service for a business partner audience.", + "Write a short enthusiastic comment using given keywords promoting a special discount offer." + ] + }, + "tags": [ + "copywriting", + "comment", + "marketing", + "social media", + "engagement", + "customer communication" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Introducing our new eco-friendly packaging\",\"tone\":\"enthusiastic\",\"keyPoints\":[\"environmentally friendly\",\"recyclable\",\"sustainable\"],\"maxLength\":200,\"audience\":\"customers\"}", + "description": "Generate an enthusiastic customer comment about new sustainable packaging." + }, + { + "inputJson": "{\"topic\":\"Thank you for your feedback on our software update\",\"tone\":\"professional\",\"keyPoints\":[\"appreciate\",\"improvements\",\"commitment to quality\"],\"maxLength\":150}", + "description": "Create a professional comment acknowledging user feedback on a software update." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Comment", + "context": null + } + }, + { + "name": "copywriting.composeMessage", + "description": "Generates a tailored marketing or promotional message based on provided parameters such as target audience, product details, tone, and desired message length. Processes input to produce a concise and persuasive message suitable for advertising campaigns or client communications.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for the message (e.g., young professionals, parents, tech enthusiasts).", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "Name of the product or service being promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "List of key features or benefits of the product or service to highlight in the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone/style of the message (e.g., friendly, professional, humorous, urgent).", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "messageLength", + "type": "number", + "description": "Desired approximate length of the message in words.", + "required": false, + "defaultValue": "50" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call-to-action phrase to include (e.g., \"Buy now\", \"Learn more\").", + "required": false, + "defaultValue": "\"Learn more\"" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated promotional message text and metadata such as length." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create marketing or advertising messages customized to specific audiences and products, ensuring the tone and length meet campaign requirements. It is especially helpful for drafting messages for emails, social media, or product descriptions.", + "limitations": "The tool cannot verify factual accuracy of product claims and may not fully capture complex brand guidelines or legal disclaimers.", + "examples": [ + "Compose a friendly 40-word promotional message for a new eco-friendly water bottle targeted at outdoor enthusiasts.", + "Write a professional and brief message including a call-to-action to buy a new software product for small businesses.", + "Create a humorous social media post promoting a fast-food chain's new burger with key features and an urgent tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional", + "message generation", + "advertising", + "branding" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"young professionals\",\"productName\":\"EcoSip Water Bottle\",\"productFeatures\":[\"BPA-free materials\",\"Keeps drinks cold for 24 hours\",\"Sleek modern design\"],\"tone\":\"friendly\",\"messageLength\":40,\"callToAction\":\"Buy now\"}", + "description": "Generate a friendly marketing message for a water bottle targeting young professionals, about 40 words, with a buy now call to action." + }, + { + "inputJson": "{\"targetAudience\":\"small business owners\",\"productName\":\"QuickBooks Pro 2024\",\"productFeatures\":[\"Easy invoice management\",\"Real-time financial reports\",\"Cloud backup included\"],\"tone\":\"professional\",\"messageLength\":30,\"callToAction\":\"Try it free\"}", + "description": "Create a professional, concise message to promote accounting software to small business owners, including a free trial call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Message", + "context": null + } + }, + { + "name": "copywriting.composeFAQ", + "description": "This tool generates a structured FAQ document by composing clear, concise questions and answers based on a provided product or service description, key topics, and user concerns. It accepts textual inputs describing the domain and optional specific questions, then outputs an organized FAQ in JSON or markdown format to assist customer support and marketing.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product, service, or topic the FAQ is about.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyTopics", + "type": "array", + "description": "List of main topics or themes to address in the FAQ. Helps focus question generation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "specificQuestions", + "type": "array", + "description": "Optional list of user-provided questions to include or base answers on in the FAQ.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "numberOfQuestions", + "type": "number", + "description": "Desired number of questions in the generated FAQ (max limit applies).", + "required": false, + "defaultValue": "10" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format for the FAQ document: 'json' for structured data or 'markdown' for readable text.", + "required": false, + "defaultValue": "json" + }, + { + "name": "includeAnswers", + "type": "boolean", + "description": "Whether to generate answers for the questions as well (true) or only list questions (false).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object representing the FAQ document, either structured with questions and answers in JSON or as a markdown string." + }, + "aiAgent": { + "useCase": "Use this tool when you have descriptive information about a product, service, or domain and want to quickly generate a relevant FAQ section for websites, help centers, or marketing materials. It helps produce user-friendly question-and-answer content that addresses common concerns, improving customer engagement and reducing support requests.", + "limitations": "Cannot guarantee complete domain expertise or accuracy; may generate generic or approximate answers without access to up-to-date or proprietary data. The quality depends on input completeness.", + "examples": [ + "Generate an FAQ for a new mobile app based on its feature list.", + "Create FAQ questions focusing on billing and account topics for a SaaS product.", + "Produce a markdown FAQ document from a product description with 15 questions." + ] + }, + "tags": [ + "copywriting", + "FAQ generation", + "customer support", + "marketing", + "documentation", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"Our AI-powered photo editing app offers automatic filtering, object removal, and batch processing.\",\"keyTopics\":[\"features\",\"pricing\",\"usage\"],\"numberOfQuestions\":5,\"outputFormat\":\"json\",\"includeAnswers\":true}", + "description": "Generate a 5-question FAQ with answers in JSON format about an AI photo editing app." + }, + { + "inputJson": "{\"productDescription\":\"Cloud storage service with secure encryption and multi-device sync.\",\"specificQuestions\":[\"How secure is my data?\",\"Can I access files offline?\"],\"outputFormat\":\"markdown\",\"includeAnswers\":true}", + "description": "Create a markdown FAQ including user-supplied questions focusing on security and access for a cloud storage service." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "FAQ", + "context": null + } + }, + { + "name": "copywriting.composeTemplate", + "description": "This tool generates customized marketing and promotional text templates based on user-provided parameters such as target audience, product features, tone, and template type. It processes input preferences to compose structured, ready-to-use copywriting templates for campaigns, emails, ads, or social media posts.", + "category": "copywriting", + "parameters": [ + { + "name": "templateType", + "type": "string", + "description": "The type of copywriting template to generate, such as 'email', 'ad', 'landingPage', or 'socialMediaPost'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the audience segment the template should address, including demographic or psychographic details.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "A list of key product or service features to highlight within the template.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the text, such as 'professional', 'friendly', 'urgent', or 'informative'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "length", + "type": "number", + "description": "Preferred approximate length of the generated template in words. Defaults to 150 if not specified.", + "required": false, + "defaultValue": "150" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call to action phrase to include in the template, e.g., 'Buy Now', 'Sign Up Today'.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully composed copywriting template as a string under 'templateContent' field, and metadata such as templateType and wordCount." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate structured marketing copy templates tailored to specific audience segments and product features. Ideal for creating drafts of emails, promotional ads, landing pages, or social posts, providing a clear starting point for further customization.", + "limitations": "This tool cannot replace domain-specific legal or compliance review. It may not perfectly capture highly specialized brand voice nuances without additional adjustment.", + "examples": [ + "Generate a friendly email template targeting millennials highlighting eco-friendly features.", + "Compose a professional ad template for a B2B software product emphasizing security and scalability.", + "Create a short social media post template with an urgent tone and a strong call to action." + ] + }, + "tags": [ + "copywriting", + "marketing", + "template", + "text generation", + "promotional", + "email", + "advertisement", + "social media" + ], + "examples": [ + { + "inputJson": "{\"templateType\":\"email\",\"targetAudience\":\"young professionals aged 25-35 interested in sustainability\",\"productFeatures\":[\"eco-friendly materials\",\"carbon neutral production\",\"durable design\"],\"tone\":\"friendly\",\"length\":200,\"callToAction\":\"Learn More\"}", + "description": "Generate a friendly email template aimed at young, sustainability-conscious professionals emphasizing eco features and including a call to action." + }, + { + "inputJson": "{\"templateType\":\"ad\",\"targetAudience\":\"IT managers in medium-sized companies\",\"productFeatures\":[\"advanced security\",\"scalable architecture\",\"24/7 support\"],\"tone\":\"professional\",\"length\":100,\"callToAction\":\"Request a Demo\"}", + "description": "Create a professional ad template targeting IT managers highlighting security and scalability with a demo request." + }, + { + "inputJson": "{\"templateType\":\"socialMediaPost\",\"targetAudience\":\"fitness enthusiasts\",\"productFeatures\":[\"new workout plans\",\"personalized coaching\"],\"tone\":\"urgent\",\"length\":50,\"callToAction\":\"Sign Up Now\"}", + "description": "Compose a short social media post template with an urgent tone for fitness enthusiasts promoting new plans and coaching." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Template", + "context": null + } + }, + { + "name": "copywriting.composeChecklist", + "description": "Generates a detailed, customized checklist document based on specified marketing or promotional campaign objectives. Takes input parameters defining campaign type, target audience, and key focus areas, then composes a step-by-step checklist to guide copywriting and campaign execution efforts, outputting it as a structured text list.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "Type of marketing campaign (e.g., email, social media, product launch) to tailor the checklist accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Primary audience segment the campaign targets, influencing relevant checklist items.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFocusAreas", + "type": "array", + "description": "List of focus areas or goals for the campaign (e.g., brand awareness, lead generation), guiding checklist composition.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeBestPractices", + "type": "boolean", + "description": "Whether to add best practice tips for copywriting and campaign execution in the checklist.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language for the checklist content (e.g., English, Spanish).", + "required": false, + "defaultValue": "English" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed checklist as a structured array of steps and optional notes tailored to the campaign." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to help craft a focused and actionable checklist for marketing copywriting efforts, ensuring all critical tasks and considerations are included to improve campaign success and consistency.", + "limitations": "This tool cannot perform the actual copywriting of campaign text or validate the effectiveness of the checklist items; it generates structured guidance only.", + "examples": [ + "Compose a checklist for a social media product launch campaign targeting millennials.", + "Create a marketing checklist focused on lead generation email campaigns including best practices.", + "Generate a checklist for a brand awareness campaign in Spanish with focus on social media posts." + ] + }, + "tags": [ + "copywriting", + "checklist", + "marketing", + "campaign", + "promotional content", + "guidance", + "planning" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"email\",\"targetAudience\":\"small business owners\",\"keyFocusAreas\":[\"lead generation\",\"customer retention\"],\"includeBestPractices\":true,\"language\":\"English\"}", + "description": "Checklist for an email campaign focused on lead generation and customer retention for small business owners." + }, + { + "inputJson": "{\"campaignType\":\"social media\",\"targetAudience\":\"millennials\",\"keyFocusAreas\":[\"brand awareness\"],\"includeBestPractices\":false,\"language\":\"English\"}", + "description": "Checklist for a social media campaign targeting millennials focusing on brand awareness without best practices tips." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Checklist", + "context": null + } + }, + { + "name": "copywriting.composeBrief", + "description": "Generates a comprehensive marketing brief based on product details, target audience, key messages, and campaign goals. Accepts structured inputs describing the product/service, audience personas, and marketing objectives. Outputs a clear, concise brief to guide campaign creation and strategy alignment.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be marketed.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product or service including features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or customer personas.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyMessages", + "type": "array", + "description": "List of important key messages or value propositions to include in the brief.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "campaignGoals", + "type": "string", + "description": "Main objectives and goals of the marketing campaign (e.g., raise awareness, increase sales).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style for the brief (e.g., formal, friendly, persuasive).", + "required": false, + "defaultValue": "Professional" + }, + { + "name": "deadline", + "type": "string", + "description": "Deadline for the campaign or brief completion (ISO date string).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed marketing brief as a formatted string." + }, + "aiAgent": { + "useCase": "Use this tool when a concise, structured marketing brief is needed to align marketing teams, agencies, or content creators around product details, audience targeting, messaging, and campaign goals. It speeds briefing creation from raw inputs, ensuring clarity and completeness.", + "limitations": "This tool does not replace strategic marketing planning or detailed market research; it synthesizes input data into a brief but relies on quality and completeness of inputs for best output.", + "examples": [ + "Compose a marketing brief for a new organic skincare line targeting young adults emphasizing eco-friendliness and gentle ingredients.", + "Generate a promotional campaign brief for a SaaS product focused on improving team collaboration, with a professional and persuasive tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "brief", + "content creation", + "campaign planning" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoGlow Skincare\",\"productDescription\":\"A line of organic, eco-friendly skincare products made with gentle natural ingredients, designed for sensitive skin.\",\"targetAudience\":\"Young adults aged 18-30, environmentally conscious, interested in health and wellness.\",\"keyMessages\":[\"100% organic ingredients\",\"Eco-friendly packaging\",\"Gentle on sensitive skin\"],\"campaignGoals\":\"Increase brand awareness among young adults, drive online sales through social media.\",\"tone\":\"friendly\",\"deadline\":\"2024-09-30\"}", + "description": "Create a marketing brief for an organic skincare line focusing on eco-conscious young adults." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Brief", + "context": null + } + }, + { + "name": "copywriting.composeSummary", + "description": "This tool accepts a detailed document or text content as input and composes a clear, concise summary tailored for marketing or promotional purposes. It processes the key points, highlights benefits, and outputs a well-structured summary suitable for use in marketing materials or executive briefs.", + "category": "copywriting", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The full text or document content to be summarized. Required for generating the summary.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the summary in words. Limits the output to a concise size.", + "required": false, + "defaultValue": "100" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the summary, e.g., professional, casual, enthusiastic. Adjusts style accordingly.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "highlightKeywords", + "type": "array", + "description": "List of keywords or phrases to emphasize in the summary if present in the input text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "audience", + "type": "string", + "description": "Intended audience for the summary, such as investors, customers, or internal teams. Tailors language and focus.", + "required": false, + "defaultValue": "general" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the composed summary text as 'summaryText' and metadata such as 'wordCount' and 'toneUsed'." + }, + "aiAgent": { + "useCase": "Use this tool when you need a marketing-oriented summary of a longer document, to quickly produce promotional or executive summaries emphasizing key benefits and features, tailored by tone and audience.", + "limitations": "This tool does not perform in-depth text analysis beyond summarization and marketing emphasis; it may omit highly technical details and is not suitable for legal or highly technical summarizations.", + "examples": [ + "Summarize a product brochure into a professional marketing summary under 100 words.", + "Generate an enthusiastic summary of a service description highlighting its unique features for potential customers.", + "Create a concise executive summary for investors emphasizing business growth metrics." + ] + }, + "tags": [ + "copywriting", + "summary", + "marketing", + "promotion", + "document", + "text", + "content", + "compose" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"Our new eco-friendly water bottle is made from 100% recycled materials and features an innovative design that keeps beverages cold for 24 hours. Perfect for outdoor enthusiasts and environmentally conscious consumers.\",\"maxLength\":80,\"tone\":\"enthusiastic\",\"highlightKeywords\":[\"eco-friendly\",\"innovative design\"],\"audience\":\"customers\"}", + "description": "Compose an enthusiastic marketing summary for customers highlighting eco-friendliness and innovative design." + }, + { + "inputJson": "{\"inputText\":\"The quarterly report details a 25% increase in revenue and successful market expansion in three new countries, driven by our latest product launch and targeted marketing campaigns.\",\"maxLength\":100,\"tone\":\"professional\",\"audience\":\"investors\"}", + "description": "Generate a professional executive summary for investors focusing on growth and expansion." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Summary", + "context": null + } + }, + { + "name": "copywriting.composeDocument", + "description": "This tool generates a customized marketing or promotional document based on user inputs including topic, target audience, document type, tone, length, and key messages. It processes the inputs to create coherent, persuasive text tailored for advertising or promotional purposes, outputting the final composed document as a string.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or product for the document to promote or describe.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the document, defining style and content focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "Type of document to compose, such as flyer, brochure, email, or webpage content.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of voice for the document, e.g., formal, casual, enthusiastic, professional.", + "required": false, + "defaultValue": "\"professional\"" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the document in words.", + "required": false, + "defaultValue": "300" + }, + { + "name": "keyMessages", + "type": "array", + "description": "Array of key points or benefits to emphasize in the document.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "callToAction", + "type": "string", + "description": "The call-to-action phrase or instruction to include at the document's end.", + "required": false, + "defaultValue": "\"Contact us today!\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document text as a string and metadata about the document." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate professional marketing or promotional content quickly for a specific topic and audience. It helps automate copywriting tasks by producing tailored documents such as flyers, brochures, or emails based on user guidance about tone, length, and key messages.", + "limitations": "Cannot create highly specialized technical manuals or legal documents; may require human editing for accuracy and adherence to brand voice; does not generate images or multimedia content.", + "examples": [ + "Compose a brochure for a new eco-friendly water bottle targeting young adults with an enthusiastic tone.", + "Create a concise professional email promoting a software subscription service aimed at small business owners.", + "Write a flyer describing a summer sale event for a local bookstore, emphasizing discounts and inviting customers to visit." + ] + }, + "tags": [ + "copywriting", + "marketing", + "document generation", + "promotional content", + "advertising", + "content creation", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"eco-friendly water bottle\",\"targetAudience\":\"young adults\",\"documentType\":\"brochure\",\"tone\":\"enthusiastic\",\"length\":400,\"keyMessages\":[\"sustainable materials\",\"keeps water cold 24 hours\",\"stylish and durable\"],\"callToAction\":\"Buy yours today!\"}", + "description": "Compose an enthusiastic brochure promoting an eco-friendly water bottle to young adults." + }, + { + "inputJson": "{\"topic\":\"software subscription service\",\"targetAudience\":\"small business owners\",\"documentType\":\"email\",\"tone\":\"professional\",\"length\":250,\"keyMessages\":[\"affordable pricing\",\"24/7 customer support\",\"easy setup\"],\"callToAction\":\"Sign up now and boost your business.\"}", + "description": "Generate a professional and concise email for a software service targeting small business owners." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "copywriting.composeEmail", + "description": "Generates a professional marketing or promotional email based on given inputs such as target audience, product or service details, tone, and call-to-action. Accepts structured information to create a customized email body ready for distribution.", + "category": "copywriting", + "parameters": [ + { + "name": "recipientType", + "type": "string", + "description": "The target audience for the email (e.g., \"new customers\", \"subscribers\", \"partners\").", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "Name of the product or service the email is promoting.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Brief description of the product or service highlighting key features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone style of the email such as formal, casual, friendly, or persuasive.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "callToAction", + "type": "string", + "description": "Desired action for recipients, e.g., \"Buy Now\", \"Sign Up\", \"Learn More\".", + "required": true, + "defaultValue": "" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the sender or company to appear in the email signature.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeDiscount", + "type": "boolean", + "description": "Whether to include a discount or special offer in the email.", + "required": false, + "defaultValue": "false" + }, + { + "name": "discountDetails", + "type": "string", + "description": "Details about the discount or offer to include when includeDiscount is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed email components including subject, body text, and optional signature." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a well-structured marketing or promotional email crafted for a specific audience and product, saving time over manual writing and ensuring consistent messaging. It works well when given clear product info and target user data.", + "limitations": "This tool cannot send emails or perform recipient list management. It may not perfectly capture highly specialized product details without precise input. Tone and style are limited to common categories.", + "examples": [ + "Compose a promotional email for new customers introducing a new software product with a friendly tone and a call to action to sign up for a trial.", + "Write a marketing email targeting existing subscribers offering a 20% discount on a seasonal product with a formal tone.", + "Generate a casual email to partners announcing a new collaboration feature inviting them to learn more." + ] + }, + "tags": [ + "copywriting", + "email", + "marketing", + "promotional", + "compose", + "business" + ], + "examples": [ + { + "inputJson": "{\"recipientType\":\"new customers\",\"productName\":\"SmartHome Security System\",\"productDescription\":\"an advanced, easy-to-install security system with 24/7 monitoring and mobile alerts\",\"tone\":\"friendly\",\"callToAction\":\"Sign up for a free trial\",\"senderName\":\"SafeHome Inc.\",\"includeDiscount\":true,\"discountDetails\":\"20% off your first purchase\"}", + "description": "Generate a friendly marketing email for new customers about a security product with discount and call to action." + }, + { + "inputJson": "{\"recipientType\":\"subscribers\",\"productName\":\"EcoFriendly Water Bottle\",\"productDescription\":\"a reusable bottle made from 100% recycled materials, BPA-free and insulated\",\"tone\":\"formal\",\"callToAction\":\"Buy Now\",\"senderName\":\"GreenLife Corp.\",\"includeDiscount\":false,\"discountDetails\":\"\"}", + "description": "Create a formal email for subscribers promoting an eco-friendly product with a call to purchase but no discount." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "copywriting.composeMinutes", + "description": "This tool generates professional meeting minutes from an input summary or transcription. It accepts key discussion points, decisions, action items, and attendee information, then composes a clear, structured minutes document suitable for sharing with stakeholders.", + "category": "copywriting", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "Title or subject of the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Date of the meeting in YYYY-MM-DD format.", + "required": true, + "defaultValue": "" + }, + { + "name": "attendees", + "type": "array", + "description": "List of attendees' names.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "summaryPoints", + "type": "array", + "description": "Key discussion points or notes from the meeting.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "decisions", + "type": "array", + "description": "Decisions made during the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items including task description and assignee.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any other important notes or remarks to include.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed minutes as a formatted string document and a structured summary of key elements such as attendees, decisions, and action items." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert informal meeting summaries, transcripts, or notes into a polished, professional set of meeting minutes that can be easily reviewed and distributed. It helps save time and ensures consistency in documenting meetings for project management or organizational record-keeping.", + "limitations": "It does not transcribe audio or video content and relies on accurate input data. It cannot infer missing details or verify facts beyond the supplied input.", + "examples": [ + "Generate minutes for a project kickoff meeting including attendees, main discussion points, decisions, and tasks assigned.", + "Create a formal minutes document based on summarized notes from a weekly team meeting.", + "Compose minutes from a client meeting, highlighting agreements, follow-up actions, and participant list." + ] + }, + "tags": [ + "copywriting", + "meeting", + "minutes", + "document", + "summary", + "professional", + "business", + "notes" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Project Kickoff Meeting\",\"date\":\"2024-06-05\",\"attendees\":[\"Alice Johnson\",\"Bob Smith\",\"Carol Lee\"],\"summaryPoints\":[\"Project scope and goals discussed\",\"Timeline and milestones set\",\"Budget preliminary agreed\"],\"decisions\":[\"Approved project timeline\",\"Decided on weekly status meetings\"],\"actionItems\":[{\"task\":\"Prepare project plan draft\",\"assignee\":\"Alice Johnson\"},{\"task\":\"Set up project repository\",\"assignee\":\"Bob Smith\"}],\"additionalNotes\":\"Next meeting scheduled for June 12.\"}", + "description": "Minutes generation for a typical kickoff meeting with key points, decisions, and assigned tasks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Minutes", + "context": null + } + }, + { + "name": "copywriting.composeTranscript", + "description": "This tool generates a coherent and professionally written transcript from raw audio or video content summaries, notes, or bullet points. It processes input text descriptions and produces a polished, readable transcript suitable for publishing or internal record-keeping.", + "category": "copywriting", + "parameters": [ + { + "name": "contentSummary", + "type": "string", + "description": "A detailed summary or notes extracted from the audio or video content to be transformed into a transcript.", + "required": true, + "defaultValue": "" + }, + { + "name": "speakerNames", + "type": "array", + "description": "An optional list of speaker names to assign to different parts of the transcript, enhancing clarity and structure.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps at appropriate intervals within the transcript for reference.", + "required": false, + "defaultValue": "false" + }, + { + "name": "tone", + "type": "string", + "description": "The tonal style in which to compose the transcript, e.g., formal, conversational, technical.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "language", + "type": "string", + "description": "Language code specifying the language of the transcript output, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully composed transcript text, optionally with structured speaker labels and timestamps." + }, + "aiAgent": { + "useCase": "Use this tool when you have a summary, notes, or partial raw text from an audio or video recording and need a clean, well-structured transcript for documentation, publishing, or review. Ideal when the raw input is not a direct transcription but requires composition into a natural, readable transcript format.", + "limitations": "Cannot generate transcripts from raw audio or video files directly; input must already be a text summary or notes. May not perfectly capture exact spoken words if input summaries lack detail or accuracy.", + "examples": [ + "Compose a formal transcript from provided meeting notes assigning speakers and including timestamps.", + "Generate a conversational-style transcript from interview bullet points in English.", + "Create an English transcript from summarized seminar content without timestamps." + ] + }, + "tags": [ + "copywriting", + "transcript", + "text composition", + "document", + "speech", + "summarization", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"contentSummary\":\"Introduction by John Doe discussing quarterly goals. Jane Smith responds with updates on marketing campaigns.\",\"speakerNames\":[\"John Doe\",\"Jane Smith\"],\"includeTimestamps\":true,\"tone\":\"formal\",\"language\":\"en\"}", + "description": "Compose a formal transcript with speaker labels and timestamps from a meeting summary." + }, + { + "inputJson": "{\"contentSummary\":\"Q&A session highlights covering product features and user feedback.\",\"speakerNames\":[],\"includeTimestamps\":false,\"tone\":\"conversational\",\"language\":\"en\"}", + "description": "Generate a conversational transcript from summarized Q&A highlights without speaker names or timestamps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Transcript", + "context": null + } + }, + { + "name": "copywriting.composeBlogPost", + "description": "Generates a detailed and engaging blog post based on the provided topic, target audience, desired tone, and length. The tool processes input parameters to create structured content including introduction, body sections, and conclusion, optimized for readability and audience engagement.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the blog post to be written.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers or specific demographic for the blog post.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired writing style or tone such as professional, casual, informative, or persuasive.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the blog post measured in number of words.", + "required": false, + "defaultValue": "800" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords to include in the blog post for SEO or emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action at the end of the post.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed blog post text, including optional sections like introduction, body, and conclusion." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a comprehensive and tailored blog post from minimal input such as topic and audience details. It is ideal for marketing content creation, SEO blogs, and informational posts that require clear structure and engaging language.", + "limitations": "This tool cannot provide real-time trending data or verify factual correctness beyond its training data. It also does not replace expert domain-specific knowledge or personalized editorial judgment.", + "examples": [ + "Write a 1000-word blog post about sustainable travel for environmentally conscious millennial travelers, with an informative tone and SEO keywords: eco-friendly, travel tips, green tourism.", + "Create a casual blog post introducing a new tech gadget aimed at early adopters, approximately 700 words, including a persuasive tone and call to action.", + "Generate a 500-word professional blog article on financial planning for retirement targeting middle-aged professionals, emphasizing trust and reliability." + ] + }, + "tags": [ + "copywriting", + "blog", + "marketing", + "content-creation", + "SEO", + "writing", + "automation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work for businesses\",\"targetAudience\":\"HR managers and business leaders\",\"tone\":\"professional\",\"length\":900,\"keywords\":[\"remote work\",\"productivity\",\"employee satisfaction\"],\"includeCallToAction\":true}", + "description": "Generate a professional 900-word blog post for HR managers highlighting the benefits of remote work, including relevant keywords and a call to action." + }, + { + "inputJson": "{\"topic\":\"Top 10 healthy smoothie recipes\",\"targetAudience\":\"health-conscious millennials\",\"tone\":\"casual\",\"length\":600,\"keywords\":[\"smoothies\",\"healthy recipes\",\"nutrition\"],\"includeCallToAction\":false}", + "description": "Create a casual 600-word blog post targeting millennials interested in health, listing popular smoothie recipes without a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "BlogPost", + "context": null + } + }, + { + "name": "copywriting.composeReport", + "description": "Generates a structured report based on given data and topics. It accepts parameters for report type, target audience, key points, and formatting style, then composes a comprehensive textual report outline or full text tailored to the specified context.", + "category": "copywriting", + "parameters": [ + { + "name": "reportType", + "type": "string", + "description": "The kind of report to generate, such as 'market analysis', 'project status', 'financial summary'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended readers of the report, e.g., 'executives', 'clients', 'technical team'. This guides tone and complexity.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "A list of key points or data items that must be covered or emphasized in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the report in words.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "tone", + "type": "string", + "description": "The style or tone of writing, e.g., 'formal', 'informative', 'persuasive'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include an executive summary section at the start of the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Preferred formatting style or template, such as 'APA', 'bullet points', or 'narrative'.", + "required": false, + "defaultValue": "narrative" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed report text and optional metadata like section breakdown." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly generate structured, professional reports tailored to specific audiences and report types, incorporating provided key points or data. Ideal for business, marketing, project management, or financial contexts requiring clear, targeted communication.", + "limitations": "The tool cannot analyze raw data or generate actual charts/tables from numeric input; it relies on provided key points and textual input. Content accuracy depends on the quality and clarity of the input parameters.", + "examples": [ + "Generate a market analysis report for executives highlighting the recent sales growth and competitor activity.", + "Compose a project status report for the technical team focusing on completed milestones and upcoming risks.", + "Create a financial summary report for clients summarizing quarterly earnings and investment performance." + ] + }, + "tags": [ + "copywriting", + "report", + "business", + "marketing", + "professional writing", + "document generation" + ], + "examples": [ + { + "inputJson": "{\"reportType\":\"market analysis\",\"targetAudience\":\"executives\",\"keyPoints\":[\"Q1 sales increased by 15%\",\"Competitor X launched a new product\",\"Market trends show rising demand for green solutions\"],\"length\":1200,\"tone\":\"formal\",\"includeSummary\":true,\"formatStyle\":\"narrative\"}", + "description": "Generate a formal market analysis report for executives with specified key points and summary." + }, + { + "inputJson": "{\"reportType\":\"project status\",\"targetAudience\":\"technical team\",\"keyPoints\":[\"Phase 1 completed\",\"Bug backlog reduced by 40%\",\"Risks include potential delays in supplier delivery\"],\"length\":800,\"tone\":\"informative\",\"includeSummary\":false,\"formatStyle\":\"bullet points\"}", + "description": "Compose an informative project status report in bullet points style, no summary, targeting technical team." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "copywriting.generateHeading", + "description": "Generates compelling and targeted marketing headings based on provided product or campaign details. Accepts inputs such as product name, key benefits, target audience, and tone to produce a concise, engaging heading suitable for promotional materials or websites.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to feature in the heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyBenefits", + "type": "array", + "description": "List of main benefits or features of the product; helps tailor the heading content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target customer segment for the heading to appeal to.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the heading, e.g., professional, casual, urgent, friendly.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length allowed for the heading to ensure brevity.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when marketing headings are needed that resonate with a specific audience and highlight key product benefits. It aids in quickly creating engaging headlines for websites, ads, or emails tailored to tone and length constraints.", + "limitations": "Cannot produce long-form content or guarantee headline effectiveness without human review; dependent on input quality and specificity.", + "examples": [ + "Generate a catchy heading for a vegan skincare product targeting millennials with a friendly tone.", + "Create a professional heading highlighting the security features of a new software for enterprise clients." + ] + }, + "tags": [ + "copywriting", + "marketing", + "heading", + "content generation", + "branding", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Detergent\",\"keyBenefits\":[\"biodegradable\",\"hypoallergenic\",\"effective stain removal\"],\"targetAudience\":\"environmentally conscious families\",\"tone\":\"friendly\",\"maxLength\":50}", + "description": "Generate a friendly, concise headline for an eco-friendly household detergent targeting families." + }, + { + "inputJson": "{\"productName\":\"SecureVault 360\",\"keyBenefits\":[\"enterprise-grade encryption\",\"real-time monitoring\"],\"targetAudience\":\"corporate security officers\",\"tone\":\"professional\",\"maxLength\":60}", + "description": "Create a professional heading emphasizing security features for an enterprise software product." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "copywriting.composeArticle", + "description": "Generates a complete article based on given topics, target audience, tone, and length preferences. Accepts input parameters that guide the content style, subject focus, and structure, then produces a well-formed article draft suitable for marketing, educational, or informational purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or theme of the article to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor tone and complexity (e.g., general public, professionals).", + "required": false, + "defaultValue": "general public" + }, + { + "name": "tone", + "type": "string", + "description": "Writing tone or style such as formal, casual, persuasive, or neutral.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired article length measured in words.", + "required": false, + "defaultValue": "500" + }, + { + "name": "keywords", + "type": "array", + "description": "List of specific keywords or phrases to be included in the article for SEO or emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeSections", + "type": "array", + "description": "Optional sections to structure the article, e.g., introduction, benefits, conclusion.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code to specify the article's language (default is English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed article text and metadata such as word count and sections." + }, + "aiAgent": { + "useCase": "Use this tool whenever a detailed article draft is needed quickly based on a defined topic and style. Useful for content marketing, blogging, educational resources, or product descriptions where tailored, ready-to-edit content accelerates writing processes.", + "limitations": "The tool does not provide verified facts or references; content should be reviewed for factual accuracy and customized for brand voice. It may not generate highly specialized technical or legal documentation reliably.", + "examples": [ + "Compose an article on renewable energy targeting environmentally conscious readers in a persuasive tone around 800 words.", + "Create a casual style article about beginner fitness tips for general audiences with key phrases provided.", + "Write a neutral tone article in English about the benefits of meditation structured with introduction, benefits, and conclusion sections." + ] + }, + "tags": [ + "copywriting", + "article generation", + "content creation", + "marketing", + "SEO", + "writing assistant", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"targetAudience\":\"corporate employees\",\"tone\":\"professional\",\"length\":700,\"keywords\":[\"remote work\",\"productivity\",\"flexibility\"],\"includeSections\":[\"introduction\",\"main benefits\",\"challenges\",\"conclusion\"],\"language\":\"en\"}", + "description": "Generate a professional article on remote work benefits and challenges aimed at corporate employees." + }, + { + "inputJson": "{\"topic\":\"Healthy cooking tips\",\"tone\":\"casual\",\"length\":400,\"keywords\":[\"healthy cooking\",\"quick meals\"],\"language\":\"en\"}", + "description": "Compose a casual, 400-word article with tips on healthy and quick cooking." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Article", + "context": null + } + }, + { + "name": "copywriting.generateCitation", + "description": "Generates a properly formatted citation string based on provided source details and requested citation style. Accepts bibliographic information such as author(s), title, publication date, source type, and outputs a citation conforming to styles like APA, MLA, or Chicago.", + "category": "copywriting", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of authors in the format 'LastName, FirstName'. Multiple authors allowed.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work or article to be cited.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationDate", + "type": "string", + "description": "Publication date of the source, preferably in YYYY or YYYY-MM-DD format.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source such as book, journal article, website, or conference paper.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher, journal, or website where the source was published.", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number if applicable (commonly for journals).", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number if applicable (commonly for journals).", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page range of the article or chapter if applicable, e.g., '23-45'.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of the source if it is accessed online.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to use for formatting (e.g., APA, MLA, Chicago).", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string and the citation style used, enabling direct inclusion in documents or references sections." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate accurate and properly formatted citations from raw bibliographic data to support documentation, academic writing, or marketing collateral. It streamlines citation creation tailored to common styles, ensuring consistency and saving time for content creators or researchers.", + "limitations": "This tool cannot verify the accuracy or existence of the source information provided; it depends entirely on input correctness. It may not support niche or newly introduced citation styles beyond the common ones specified.", + "examples": [ + "Generate an APA citation for a journal article with multiple authors", + "Create an MLA citation for a book with a single author", + "Produce a Chicago style citation for an online article with URL" + ] + }, + "tags": [ + "copywriting", + "citation", + "bibliography", + "formatting", + "academic", + "reference" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Innovations in AI\",\"publicationDate\":\"2022\",\"sourceType\":\"journal article\",\"publisher\":\"Journal of AI Research\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"100-120\",\"url\":\"\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA citation for a journal article with two authors." + }, + { + "inputJson": "{\"authors\":[\"Brown, Lisa\"],\"title\":\"Marketing Strategies 101\",\"publicationDate\":\"2019\",\"sourceType\":\"book\",\"publisher\":\"Business Press\",\"volume\":\"\",\"issue\":\"\",\"pages\":\"\",\"url\":\"\",\"citationStyle\":\"MLA\"}", + "description": "Generate an MLA citation for a book with one author." + }, + { + "inputJson": "{\"authors\":[\"Nguyen, Alex\"],\"title\":\"How to optimize SEO\",\"publicationDate\":\"2020-05-10\",\"sourceType\":\"website\",\"publisher\":\"SEO Experts Blog\",\"volume\":\"\",\"issue\":\"\",\"pages\":\"\",\"url\":\"https://seoexpertblog.com/optimize-seo\",\"citationStyle\":\"Chicago\"}", + "description": "Generate a Chicago style citation for an online article with a URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Citation", + "context": null + } + }, + { + "name": "copywriting.generateReference", + "description": "Generates a professional and effective reference letter or testimonial based on input details about the referee, relationship, purpose, and key qualities or achievements to highlight. Accepts structured input to tailor tone and content, producing a well-formed textual reference suitable for job applications, academic recommendations, or other formal endorsements.", + "category": "copywriting", + "parameters": [ + { + "name": "refereeName", + "type": "string", + "description": "Full name of the person writing the reference letter.", + "required": true, + "defaultValue": "" + }, + { + "name": "refereePosition", + "type": "string", + "description": "Job position or title of the referee to add credibility (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "refereeOrganization", + "type": "string", + "description": "Organization or company the referee is associated with.", + "required": false, + "defaultValue": "" + }, + { + "name": "candidateName", + "type": "string", + "description": "Full name of the person being recommended or referenced.", + "required": true, + "defaultValue": "" + }, + { + "name": "relationship", + "type": "string", + "description": "Description of the relationship between referee and candidate (e.g., supervisor, professor).", + "required": true, + "defaultValue": "" + }, + { + "name": "referencePurpose", + "type": "string", + "description": "Purpose of the reference letter (e.g., job application, academic program).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyQualities", + "type": "array", + "description": "Array of key qualities, skills, or achievements of the candidate to emphasize.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the letter (e.g., formal, enthusiastic, neutral).", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated reference letter text as a string with formatted paragraphs." + }, + "aiAgent": { + "useCase": "When an AI agent needs to assist users in generating tailored reference or recommendation letters quickly by structuring relevant input details about the candidate and referee. Useful in HR, academic, or professional settings.", + "limitations": "Cannot verify factual accuracy or authenticity; does not generate legal or notarized documents; limited to text generation and does not customize formatting beyond paragraph structure.", + "examples": [ + "Generate a job reference letter for an employee named John Doe from his supervisor Jane Smith to support a software engineering position.", + "Create an academic recommendation letter for a student applying to a graduate program highlighting leadership and research skills." + ] + }, + "tags": [ + "copywriting", + "referenceLetter", + "recommendation", + "testimonial", + "professionalWriting", + "HR", + "academic" + ], + "examples": [ + { + "inputJson": "{\"refereeName\":\"Jane Smith\",\"refereePosition\":\"Senior Manager\",\"refereeOrganization\":\"Tech Innovations Ltd.\",\"candidateName\":\"John Doe\",\"relationship\":\"direct supervisor for 3 years\",\"referencePurpose\":\"job application for software engineer role\",\"keyQualities\":[\"strong coding skills\",\"team leadership\",\"problem solving\"],\"tone\":\"formal\"}", + "description": "Generate a formal reference letter from a supervisor for a candidate applying for a software engineer position." + }, + { + "inputJson": "{\"refereeName\":\"Dr. Alice Johnson\",\"refereePosition\":\"Professor of Chemistry\",\"refereeOrganization\":\"State University\",\"candidateName\":\"Mary Lee\",\"relationship\":\"thesis advisor\",\"referencePurpose\":\"graduate school admission\",\"keyQualities\":[\"research skills\",\"academic excellence\",\"critical thinking\"],\"tone\":\"enthusiastic\"}", + "description": "Create an enthusiastic academic recommendation letter for a student applying to graduate school." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Reference", + "context": null + } + }, + { + "name": "copywriting.generateParagraph", + "description": "Generates a marketing or promotional paragraph based on provided product or service details, target audience, tone, and key features. The tool processes input parameters to produce a coherent, persuasive paragraph tailored to specified style and purpose, suitable for use in advertisements, websites, or brochures.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to feature in the paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience or customer persona for whom the paragraph is intended.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of main features or benefits to highlight in the paragraph.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of writing (e.g., enthusiastic, formal, friendly).", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "paragraphLength", + "type": "number", + "description": "Approximate length of paragraph in sentences (1 to 5).", + "required": false, + "defaultValue": "3" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing paragraph as a string." + }, + "aiAgent": { + "useCase": "Use this tool when the goal is to create compelling, customized marketing paragraphs for products or services based on input features and audience characteristics. Ideal to quickly generate promotional text in various tones for websites, brochures, or ads.", + "limitations": "Cannot verify factual accuracy of features nor replace in-depth copywriting strategies requiring market research or brand voice guidelines.", + "examples": [ + "Generate a friendly paragraph highlighting eco-friendly features of a reusable water bottle for health-conscious adults.", + "Create a formal paragraph describing the benefits of an enterprise software for IT managers.", + "Write an enthusiastic short paragraph promoting a new smartphone to young tech-savvy consumers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "promotional text", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSipper Reusable Water Bottle\",\"targetAudience\":\"health-conscious adults who care about the environment\",\"keyFeatures\":[\"leak-proof lid\",\"made from recycled materials\",\"keeps drinks cold for 24 hours\"],\"tone\":\"friendly\",\"paragraphLength\":3}", + "description": "Generate a friendly marketing paragraph for an eco-friendly water bottle targeting health-conscious adults." + }, + { + "inputJson": "{\"productName\":\"SecureIT Enterprise Software\",\"targetAudience\":\"IT managers in large corporations\",\"keyFeatures\":[\"real-time threat monitoring\",\"compliance reporting\",\"easy integration with existing systems\"],\"tone\":\"formal\",\"paragraphLength\":4}", + "description": "Create a formal promotional paragraph for an IT security software aimed at enterprise IT managers." + }, + { + "inputJson": "{\"productName\":\"XPhone Ultra 2024\",\"targetAudience\":\"young tech-savvy consumers\",\"keyFeatures\":[\"120MP camera\",\"5G connectivity\",\"ultra-fast processor\"],\"tone\":\"enthusiastic\",\"paragraphLength\":2}", + "description": "Write an enthusiastic short paragraph promoting a new smartphone to young consumers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "copywriting.generateQuote", + "description": "Generates creative and compelling marketing quotes based on input themes, tones, and target audiences. Accepts keywords or topics and optional stylistic preferences, then produces a ready-to-use promotional quote string tailored for advertising or social media campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "theme", + "type": "string", + "description": "The main subject or theme the quote should be about, e.g., innovation, customer service, health.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the quote, such as inspirational, humorous, professional, or casual.", + "required": false, + "defaultValue": "inspirational" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The demographic or group the quote is intended to resonate with, e.g., millennials, entrepreneurs, fitness enthusiasts.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "The preferred maximum length of the quote in characters, to fit different platforms.", + "required": false, + "defaultValue": "140" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a subtle call to action in the quote.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing quote text." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to generate short, effective marketing or promotional quotes tailored to specific themes and audiences, suitable for use in advertisements, social media posts, or branding materials. It streamlines quote creation ensuring engagement and relevance.", + "limitations": "The tool cannot generate highly specialized domain-specific quotes without general context; it may not perfectly match niche jargon or guaranteed trademarked slogans.", + "examples": [ + "Generate an inspirational quote about sustainability for eco-conscious consumers.", + "Create a humorous quote about coffee targeting office workers.", + "Produce a concise professional quote promoting teamwork for a corporate newsletter." + ] + }, + "tags": [ + "copywriting", + "marketing", + "quote generation", + "advertising", + "social media", + "branding" + ], + "examples": [ + { + "inputJson": "{\"theme\":\"innovation\",\"tone\":\"inspirational\",\"targetAudience\":\"entrepreneurs\",\"length\":120,\"includeCallToAction\":true}", + "description": "Generate an inspirational innovation quote with a call to action for entrepreneurs." + }, + { + "inputJson": "{\"theme\":\"fitness\",\"tone\":\"motivational\",\"targetAudience\":\"fitness enthusiasts\",\"length\":100,\"includeCallToAction\":false}", + "description": "Generate a motivational fitness quote for fitness enthusiasts without call to action." + }, + { + "inputJson": "{\"theme\":\"customer service\",\"tone\":\"professional\",\"targetAudience\":\"business owners\",\"length\":140,\"includeCallToAction\":true}", + "description": "Create a professional customer service quote for business owners including a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Quote", + "context": null + } + }, + { + "name": "copywriting.generateConversion", + "description": "Generates persuasive, conversion-focused marketing copy based on provided product or service details, target audience characteristics, desired call-to-action, and optional tone or style preferences. Processes inputs to produce effective text aiming to improve reader engagement and drive measurable conversion actions.", + "category": "copywriting", + "parameters": [ + { + "name": "productOrServiceDescription", + "type": "string", + "description": "Detailed description of the product or service to promote, including key features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience including demographics, interests, and pain points.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Desired action you want readers to take after reading the copy, e.g., sign up, buy now, request a demo.", + "required": true, + "defaultValue": "" + }, + { + "name": "toneStyle", + "type": "string", + "description": "Optional tone or style for the copy such as friendly, professional, urgent, or enthusiastic.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length in words of the generated copy. Defaults to 100 words if not specified.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated conversion copy as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create compelling, persuasive marketing text aimed at converting readers into customers or leads based on structured inputs describing the offer and audience. It helps generate custom sales copy for websites, ads, emails, or social media posts tailored to specific marketing goals.", + "limitations": "Cannot guarantee actual conversion performance as effectiveness depends on real-world testing and market variables. Generated copy may require human review for compliance, brand alignment, and nuance.", + "examples": [ + "Generate a promotional paragraph for a new fitness app targeting busy professionals encouraging them to sign up for a free trial.", + "Create a Facebook ad copy for an eco-friendly cleaning product aimed at environmentally conscious millennials to buy now.", + "Draft an email invite for a webinar about cloud security targeting IT managers with a professional tone and urging registration." + ] + }, + "tags": [ + "copywriting", + "marketing", + "conversion", + "advertising", + "content generation", + "sales", + "AI writing" + ], + "examples": [ + { + "inputJson": "{\"productOrServiceDescription\":\"A productivity app that streamlines task management with AI reminders and collaboration features.\",\"targetAudience\":\"Young professionals aged 25-35 who struggle with managing multiple projects.\",\"callToAction\":\"Download the app today and get a 7-day free trial.\",\"toneStyle\":\"motivational\",\"length\":120}", + "description": "Generate motivational copy for a productivity app targeting young professionals encouraging download and free trial." + }, + { + "inputJson": "{\"productOrServiceDescription\":\"Organic skincare line made from all-natural ingredients suitable for sensitive skin.\",\"targetAudience\":\"Health-conscious women aged 30-50 looking for gentle, eco-friendly skincare.\",\"callToAction\":\"Shop now and enjoy a 20% discount.\",\"toneStyle\":\"friendly\",\"length\":90}", + "description": "Generate friendly and appealing ad copy for organic skincare aimed at health-conscious women to drive immediate sales." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Conversion", + "context": null + } + }, + { + "name": "copywriting.generateText", + "description": "Generates marketing and promotional text content based on input parameters such as target audience, product description, tone, and desired text length. It processes input details to create tailored and engaging copy suitable for advertising, websites, or social media posts.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "A detailed description of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience or customer segment for the text.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the text (e.g., casual, professional, persuasive).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "textLength", + "type": "number", + "description": "Approximate length of the generated text in words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action phrase or sentence to include at the end of the text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing text content." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce clear, persuasive, and tailored marketing copy for digital or print media based on specific product details and audience characteristics. This helps automate content creation for campaigns, websites, or social posts efficiently.", + "limitations": "The tool cannot generate factual data or guarantee marketing effectiveness. It may not be suitable for highly technical or regulated industries without further expert review.", + "examples": [ + "Generate a promotional paragraph for a new eco-friendly water bottle targeting health-conscious millennials with a casual tone.", + "Create a professional product description for an enterprise software solution aimed at IT managers, about 150 words.", + "Write a short ad copy for a summer sale on fashion shoes including a call to action to visit the store." + ] + }, + "tags": [ + "copywriting", + "marketing", + "text generation", + "advertising", + "content creation", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A smartwatch with heart rate monitor, sleep tracking, and GPS.\",\"targetAudience\":\"fitness enthusiasts\",\"tone\":\"motivational\",\"textLength\":120,\"callToAction\":\"Order yours today to stay fit!\"}", + "description": "Generate motivational marketing text for a fitness smartwatch targeting fitness enthusiasts." + }, + { + "inputJson": "{\"productDescription\":\"Online course teaching beginner guitar skills.\",\"targetAudience\":\"adults wanting to learn guitar\",\"tone\":\"friendly\",\"textLength\":80,\"callToAction\":\"Sign up now!\"}", + "description": "Create a friendly promotional text for a beginner guitar course targeting adult learners." + }, + { + "inputJson": "{\"productDescription\":\"Luxury skincare cream with natural ingredients.\",\"targetAudience\":\"women aged 30-50\",\"tone\":\"professional\",\"textLength\":150,\"callToAction\":\"Experience radiant skin today.\"}", + "description": "Produce a professional product description for luxury skincare cream targeting mature women." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "copywriting.generateSentence", + "description": "Generates a single marketing or promotional sentence based on the given product or service description, target audience, tone, and optional keywords. It processes the input to produce a persuasive and engaging sentence tailored for advertising or content marketing purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "A brief description of the product or service being promoted, providing key features or benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The specific demographic or customer segment that the sentence should appeal to, e.g., young professionals, tech enthusiasts.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the sentence, such as friendly, professional, casual, or persuasive.", + "required": false, + "defaultValue": "persuasive" + }, + { + "name": "keywords", + "type": "array", + "description": "An optional list of keywords to incorporate into the sentence for SEO or emphasis.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing or promotional sentence as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to produce a concise and compelling marketing sentence tailored to a product or service description, targeting a specific audience or tone. Ideal for creating taglines, ads, or promotional snippets requiring persuasive language.", + "limitations": "This tool generates only a single sentence and may not create complex copy or multi-sentence content. It cannot guarantee brand compliance or legal approval, and results should be reviewed before use in official materials.", + "examples": [ + "Generate a promotional sentence for a new eco-friendly water bottle targeting environmentally conscious consumers.", + "Create a friendly and casual marketing sentence for a mobile app that helps organize tasks.", + "Produce a professional tone sentence advertising cloud storage services using keywords 'secure' and 'reliable'." + ] + }, + "tags": [ + "copywriting", + "marketing", + "generate", + "sentence", + "promotion", + "advertising", + "content" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A smartwatch with heart rate monitoring, GPS, and long battery life.\",\"targetAudience\":\"fitness enthusiasts\",\"tone\":\"motivational\",\"keywords\":[\"smartwatch\",\"fitness\"]}", + "description": "Generate a motivational marketing sentence for a smartwatch targeting fitness enthusiasts, focusing on key features." + }, + { + "inputJson": "{\"productDescription\":\"An online platform that connects freelance graphic designers with clients worldwide.\",\"targetAudience\":\"freelancers\",\"tone\":\"professional\",\"keywords\":[\"design\",\"freelance\"]}", + "description": "Create a professional promotional sentence advertising an online platform for freelance graphic designers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Sentence", + "context": null + } + }, + { + "name": "copywriting.generateLink", + "description": "Generates a marketing-friendly hyperlink text and URL based on the product or campaign details provided. Accepts product name, target URL, and optional call-to-action phrase, then produces a concise, persuasive clickable link text paired with the URL, optimized for promotional content.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetUrl", + "type": "string", + "description": "The URL the link should point to.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call-to-action phrase to include in the link text (e.g., 'Buy Now', 'Learn More').", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated link text to ensure it fits display constraints.", + "required": false, + "defaultValue": "50" + }, + { + "name": "includeDiscount", + "type": "boolean", + "description": "Whether to include mention of a discount or special offer if applicable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'linkText' for the clickable copy and the 'url' it points to." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create concise, effective promotional links for marketing copy, website banners, social media posts, or email campaigns. It helps generate persuasive clickable text that aligns with the product's branding and call to action while pairing it with the correct URL.", + "limitations": "Cannot verify the validity or accessibility of the URL provided; does not generate URLs, only uses given ones. Does not create graphics or track clicks.", + "examples": [ + "Generate a link for the new winter jacket product page with a \"Shop Now\" call-to-action.", + "Create a promotional link for a summer sale with discount mention included.", + "Generate a short link text for a handheld gadget with default settings." + ] + }, + "tags": [ + "copywriting", + "link generation", + "marketing", + "promotions", + "call to action" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSmart Water Bottle\",\"targetUrl\":\"https://example.com/ecosmart-bottle\",\"callToAction\":\"Buy Now\",\"maxLength\":40,\"includeDiscount\":false}", + "description": "Generate a marketing link for the EcoSmart Water Bottle with a 'Buy Now' call-to-action." + }, + { + "inputJson": "{\"productName\":\"Summer Sale 2024\",\"targetUrl\":\"https://example.com/summer-sale\",\"callToAction\":\"Shop the Sale\",\"maxLength\":60,\"includeDiscount\":true}", + "description": "Generate a promotional link text including discount mention for Summer Sale 2024." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Link", + "context": null + } + }, + { + "name": "copywriting.generateWord", + "description": "Generates a marketing or promotional word based on input criteria such as desired tone, word length, and keyword focus. Accepts optional parameters to tailor the output word to specific campaign needs, producing a single word suitable for use in advertising copy or branding.", + "category": "copywriting", + "parameters": [ + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the word to generate, e.g., 'friendly', 'luxury', or 'energetic'.", + "required": false, + "defaultValue": "" + }, + { + "name": "keywordFocus", + "type": "string", + "description": "A keyword or theme to guide the word generation, helping make it relevant to the product or campaign.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word in characters, useful for concise branding.", + "required": false, + "defaultValue": "15" + }, + { + "name": "startLetter", + "type": "string", + "description": "Optional specific starting letter for the generated word to match branding guidelines.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSuffix", + "type": "boolean", + "description": "Whether to include common suffixes to make the word sound more product-like or brandable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word string under 'word' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need a single catchy or thematic word for marketing, advertising, branding, or promotional content. It is helpful for creating evocative product names, slogans, or buzzwords tailored to a campaign's tone and focus.", + "limitations": "This tool generates individual words only, not phrases or complete sentences. It does not guarantee trademark safety or popularity and should be used as a creative aid, not a definitive final naming solution.", + "examples": [ + "Generate a luxury-sounding word related to 'time'", + "Create a short, energetic word starting with 'S'", + "Provide a friendly word under 10 characters focusing on 'health'" + ] + }, + "tags": [ + "copywriting", + "generate", + "marketing", + "branding", + "advertising", + "word", + "creative" + ], + "examples": [ + { + "inputJson": "{\"tone\":\"luxury\",\"keywordFocus\":\"time\",\"maxLength\":12}", + "description": "Generate a luxury-themed word related to 'time' under 12 characters." + }, + { + "inputJson": "{\"tone\":\"energetic\",\"startLetter\":\"S\",\"includeSuffix\":true}", + "description": "Create an energetic word starting with S and possibly with a suffix." + }, + { + "inputJson": "{\"tone\":\"friendly\",\"keywordFocus\":\"health\",\"maxLength\":10}", + "description": "Generate a friendly word under 10 characters focusing on health." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Word", + "context": null + } + }, + { + "name": "copywriting.generateAnomaly", + "description": "Generates compelling marketing copy that highlights detected anomalies or unexpected insights from analytics data. Accepts raw anomaly descriptions or data summary as input and produces persuasive text focused on the anomaly's impact and significance to engage stakeholders or customers.", + "category": "copywriting", + "parameters": [ + { + "name": "anomalySummary", + "type": "string", + "description": "A brief summary or description of the detected anomaly in analytic data to be highlighted in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the marketing copy, e.g., professional, urgent, optimistic, cautionary.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for the copy, for tailoring language and focus.", + "required": false, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "An optional call to action phrase to include in the copy, e.g., 'Contact us for details.'", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length (in words) of the generated copy to ensure conciseness.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy as a string under the 'copyText' key." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to communicate detected anomalies or unusual patterns found in analytics data through marketing or promotional text to stakeholders, clients, or users. It helps in framing technical findings into engaging, persuasive narratives that highlight urgency, opportunity, or concern.", + "limitations": "This tool cannot analyze raw data or detect anomalies itself; it relies on provided descriptions or summaries. It also may not perfectly capture domain-specific nuances without sufficient context in input.", + "examples": [ + "Generate a professional announcement copy about a sudden spike in sales in a particular region.", + "Create urgent marketing text highlighting an anomaly in system performance metrics to notify customers.", + "Produce optimistic copy focused on an unexpected increase in user engagement detected last month." + ] + }, + "tags": [ + "copywriting", + "marketing", + "anomaly", + "analytics", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"anomalySummary\":\"Our latest analytics detected a 230% increase in website traffic from the Asia-Pacific region last quarter.\",\"tone\":\"optimistic\",\"targetAudience\":\"marketing team\",\"callToAction\":\"Let's leverage this growth opportunity.\",\"maxLength\":120}", + "description": "Generate optimistic marketing copy highlighting a large increase in website traffic for the marketing team with a call to action." + }, + { + "inputJson": "{\"anomalySummary\":\"An unexpected drop of 40% in conversion rates was observed during the last two weeks.\",\"tone\":\"cautionary\",\"targetAudience\":\"executive stakeholders\",\"callToAction\":\"Investigate immediately.\",\"maxLength\":100}", + "description": "Create cautionary marketing text warning executive stakeholders about a significant drop in conversion rates with a prompt to act." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Anomaly", + "context": null + } + }, + { + "name": "copywriting.generateEvent", + "description": "Generates persuasive and engaging marketing event copy tailored for analytics products or platforms. Accepts event details such as event name, purpose, target audience, date/time, and key highlights. Produces professionally written promotional text suitable for advertising, emails, or social media posts to drive attendance and engagement.", + "category": "copywriting", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name or title of the event to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventPurpose", + "type": "string", + "description": "The primary goal or theme of the event, such as a product launch or webinar topic.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for this event (e.g., data analysts, marketers).", + "required": true, + "defaultValue": "" + }, + { + "name": "eventDate", + "type": "string", + "description": "Date and time of the event in ISO 8601 or human-readable format.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyHighlights", + "type": "array", + "description": "List of main features, speakers, or sessions that make the event attractive.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the generated copy, e.g., formal, casual, enthusiastic, or professional.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated copy to fit marketing channels.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated event promotional copy string under the key 'eventCopy'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly create compelling, customized marketing text for analytics-related events, such as webinars, launches, or conferences, to help drive registrations and engagement without requiring manual copywriting expertise.", + "limitations": "Cannot replace the need for human review for compliance, branding consistency, or detailed scheduling information. May lack nuance for highly technical or niche subject matter without sufficient input detail.", + "examples": [ + "Generate copy for an analytics webinar targeting marketing professionals about latest trends.", + "Create a promotional text for a product launch event focusing on new analytics dashboard features.", + "Write a social media post text for an upcoming conference on data science and analytics." + ] + }, + "tags": [ + "copywriting", + "event marketing", + "analytics", + "promotion", + "content generation", + "AI writing" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"Analytics Trends 2024 Webinar\",\"eventPurpose\":\"Discuss latest analytics technologies and applications\",\"targetAudience\":\"Marketing professionals, data analysts\",\"eventDate\":\"2024-09-15T14:00:00Z\",\"keyHighlights\":[\"Top industry speakers\",\"Live Q&A session\",\"Exclusive demo\"],\"tone\":\"enthusiastic\",\"maxLength\":250}", + "description": "Generate engaging webinar promotional copy for marketing professionals." + }, + { + "inputJson": "{\"eventName\":\"New Dashboard Launch\",\"eventPurpose\":\"Showcase new advanced analytics dashboard features\",\"targetAudience\":\"Business analysts and decision makers\",\"keyHighlights\":[\"Real-time insights\",\"Custom reports\",\"User-friendly interface\"],\"tone\":\"professional\",\"maxLength\":200}", + "description": "Create professional, concise product launch event copy." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Event", + "context": null + } + }, + { + "name": "copywriting.generateSession", + "description": "Generates engaging, conversion-focused marketing copy for an analytics session, based on input session data such as user behavior, session duration, interaction highlights, and key metrics. Outputs customized promotional text that highlights session value for stakeholders or marketing campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "sessionId", + "type": "string", + "description": "Unique identifier of the analytics session to generate copy for.", + "required": true, + "defaultValue": "" + }, + { + "name": "sessionData", + "type": "object", + "description": "Object containing session metrics and interactions (e.g., duration, pageViews, userActions).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone for the copy (e.g., professional, casual, enthusiastic).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the generated copy in words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the generated copy (e.g., marketers, executives, product managers).", + "required": false, + "defaultValue": "marketers" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text and summary metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce compelling marketing or promotional text summarizing the key highlights and value of a user analytics session in a persuasive style tailored to a target audience. Useful for generating session-based marketing content automatically from raw analytics data.", + "limitations": "The tool cannot perform session data analysis or generate insights beyond the data provided; it depends entirely on the quality and completeness of input session data for meaningful copy.", + "examples": [ + "Generate a promotional paragraph highlighting peak user engagement during session XYZ123.", + "Produce a 150-word enthusiastic summary of session data for product managers.", + "Create a professional summary focused on session duration and conversion actions for executives." + ] + }, + "tags": [ + "copywriting", + "marketing", + "analytics", + "session", + "text generation", + "promotional", + "summary" + ], + "examples": [ + { + "inputJson": "{\"sessionId\":\"ABC123\",\"sessionData\":{\"duration\":300,\"pageViews\":12,\"conversions\":3,\"bounceRate\":0.2},\"tone\":\"enthusiastic\",\"length\":120,\"targetAudience\":\"marketers\"}", + "description": "Generate a 120-word enthusiastic marketing copy summarizing session ABC123 analytics for marketers." + }, + { + "inputJson": "{\"sessionId\":\"XYZ789\",\"sessionData\":{\"duration\":600,\"pageViews\":25,\"userActions\":[\"clicked signup\",\"downloaded brochure\"],\"conversions\":5},\"tone\":\"professional\",\"length\":100,\"targetAudience\":\"executives\"}", + "description": "Produce a 100-word professional summary of session XYZ789 focusing on user actions and conversions for executives." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Session", + "context": null + } + }, + { + "name": "copywriting.generateKPI", + "description": "Generates clear, concise marketing copy that highlights key performance indicators (KPIs) for a given campaign or project. Accepts KPI data such as metrics, values, and timeframe; processes this data to produce persuasive promotional text that summarizes performance and impact for reports, presentations, or marketing materials.", + "category": "copywriting", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The name or title of the KPI to be highlighted, e.g., 'Conversion Rate'.", + "required": true, + "defaultValue": "" + }, + { + "name": "kpiValue", + "type": "number", + "description": "The numerical value of the KPI, e.g., 15.5 representing 15.5%.", + "required": true, + "defaultValue": "" + }, + { + "name": "kpiUnit", + "type": "string", + "description": "The unit or measure of the KPI value, e.g., '%', 'visitors', 'revenue'.", + "required": true, + "defaultValue": "" + }, + { + "name": "timePeriod", + "type": "string", + "description": "The timeframe for the KPI measurement, e.g., 'Q1 2024', 'last month'.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The target audience for the marketing copy, e.g., 'stakeholders', 'potential clients'.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the generated copy such as 'formal', 'informative', 'enthusiastic', or 'neutral'.", + "required": false, + "defaultValue": "neutral" + } + ], + "returns": { + "type": "object", + "description": "An object containing a string field 'marketingCopy' with the generated promotional text summarizing the KPI." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create persuasive, KPI-focused marketing copy for reports, presentations or marketing materials from raw performance data. It helps translate numerical KPIs into clear, audience-appropriate language highlighting successes or insights.", + "limitations": "This tool cannot generate visual KPI charts or deep data analysis. It also cannot validate KPI data accuracy or produce multi-KPI comparative reports automatically.", + "examples": [ + "Generate an enthusiastic copy line emphasizing a 25% increase in customer engagement last quarter for potential clients.", + "Create a concise, formal summary of a 10,000 visitor milestone achieved in March 2024 for internal stakeholders.", + "Produce a neutral tone text describing a conversion rate of 5.8% for an online campaign without specifying the target audience." + ] + }, + "tags": [ + "copywriting", + "marketing", + "KPI", + "performance", + "analytics", + "promotional-text", + "business", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"Customer Retention Rate\",\"kpiValue\":85,\"kpiUnit\":\"%\",\"timePeriod\":\"FY 2023\",\"targetAudience\":\"stakeholders\",\"tone\":\"formal\"}", + "description": "Generate formal KPI-focused marketing copy for FY 2023 customer retention rate targeting stakeholders." + }, + { + "inputJson": "{\"kpiName\":\"Monthly Active Users\",\"kpiValue\":150000,\"kpiUnit\":\"users\",\"timePeriod\":\"last month\",\"targetAudience\":\"potential clients\",\"tone\":\"enthusiastic\"}", + "description": "Create enthusiastic KPI copy highlighting monthly active users for a marketing campaign aimed at potential clients." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "KPI", + "context": null + } + }, + { + "name": "copywriting.generateDashboard", + "description": "Generates persuasive marketing copy for analytics dashboards based on input data, key metrics, and target audience. Accepts dashboard context, performance highlights, and tone preferences, then produces engaging headlines, descriptions, and call-to-action text designed to showcase dashboard value and insights.", + "category": "copywriting", + "parameters": [ + { + "name": "dashboardName", + "type": "string", + "description": "The name or title of the analytics dashboard to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyMetrics", + "type": "array", + "description": "A list of important metrics or KPIs featured in the dashboard that should be highlighted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The primary audience or user group for the dashboard (e.g., executives, analysts).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the marketing copy, such as professional, casual, persuasive, or technical.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "callToAction", + "type": "string", + "description": "A call-to-action phrase to encourage use or exploration of the dashboard.", + "required": false, + "defaultValue": "Explore the dashboard now!" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated marketing copy components: headline, description, and callToAction text." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create engaging marketing and promotional text specifically tailored for analytics dashboards. It is ideal for generating copy that highlights key insights and appeals to targeted professionals or decision-makers, facilitating user engagement and dashboard adoption.", + "limitations": "This tool cannot generate or analyze actual dashboard data or visualizations; it only produces textual marketing content based on provided input. It may not capture highly technical jargon unless specified in tone or content.", + "examples": [ + "Generate marketing copy for a sales performance dashboard targeting sales managers with a persuasive tone.", + "Create a professional description highlighting the key KPIs of a financial analytics dashboard for executive stakeholders.", + "Produce a casual and engaging call-to-action for a marketing analytics dashboard encouraging exploration." + ] + }, + "tags": [ + "copywriting", + "marketing", + "dashboard", + "analytics", + "text generation", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"dashboardName\":\"Sales Performance Dashboard\",\"keyMetrics\":[\"Monthly Revenue\",\"Customer Acquisition Rate\",\"Conversion Rate\"],\"targetAudience\":\"Sales Managers\",\"tone\":\"persuasive\",\"callToAction\":\"Boost your sales insights today!\"}", + "description": "Generate persuasive marketing copy for a sales performance dashboard aimed at sales managers." + }, + { + "inputJson": "{\"dashboardName\":\"Financial Overview Dashboard\",\"keyMetrics\":[\"Cash Flow\",\"Profit Margin\",\"Expense Ratio\"],\"targetAudience\":\"Executive Team\",\"tone\":\"professional\",\"callToAction\":\"Discover financial insights now.\"}", + "description": "Create professional marketing copy highlighting financial KPIs for executives." + }, + { + "inputJson": "{\"dashboardName\":\"Marketing Trends Dashboard\",\"keyMetrics\":[\"Website Traffic\",\"Social Engagement\",\"Lead Generation\"],\"tone\":\"casual\",\"callToAction\":\"Check out the latest trends!\"}", + "description": "Produce casual and engaging copy for a marketing trends dashboard encouraging user engagement." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Dashboard", + "context": null + } + }, + { + "name": "copywriting.generateMetric", + "description": "Generates compelling descriptive marketing text for a specific business metric or KPI based on input data and context. Inputs include the metric name, its numeric value, target audience, and tone preference. Outputs a short copywriting snippet that highlights the metric's significance in a persuasive style for promotional or reporting purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "metricName", + "type": "string", + "description": "The name of the business metric or KPI to describe, e.g. 'conversion rate'.", + "required": true, + "defaultValue": "" + }, + { + "name": "metricValue", + "type": "number", + "description": "The current numeric value of the metric to incorporate in the generated text.", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "The target audience for the text, e.g. 'investors', 'customers', 'employees'.", + "required": false, + "defaultValue": "general public" + }, + { + "name": "tone", + "type": "string", + "description": "The tone of the promotional text, e.g. 'formal', 'enthusiastic', 'motivational'.", + "required": false, + "defaultValue": "enthusiastic" + }, + { + "name": "context", + "type": "string", + "description": "Additional context or background about the metric or business area to tailor the text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy as a string under the 'text' property." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to produce engaging marketing copy that highlights the importance or achievement of a specific business metric or KPI for communication purposes such as reports, newsletters, or sales materials. It is especially useful when numeric metrics need to be translated into easy-to-understand, persuasive text tailored for different audiences and tones.", + "limitations": "This tool cannot generate real-time metric data and relies on accurate input values. It does not produce visualizations or detailed analytical explanations, only concise promotional text.", + "examples": [ + "Generate a motivational message for a 15% increase in monthly recurring revenue targeting company employees.", + "Create an enthusiastic snippet for a 98% customer satisfaction rate to be used in a marketing brochure for potential clients.", + "Provide a formal description of a 5% decrease in churn rate for an investor report." + ] + }, + "tags": [ + "copywriting", + "marketing", + "analytics", + "business metrics", + "promotional text", + "KPI", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"metricName\":\"conversion rate\",\"metricValue\":12.5,\"audience\":\"marketers\",\"tone\":\"enthusiastic\",\"context\":\"Q2 sales campaign performance\"}", + "description": "Generate an enthusiastic marketing snippet describing a 12.5% conversion rate for marketers, emphasizing Q2 campaign results." + }, + { + "inputJson": "{\"metricName\":\"customer retention\",\"metricValue\":85,\"audience\":\"investors\",\"tone\":\"formal\",\"context\":\"year-end review\"}", + "description": "Create a formal copy highlighting an 85% customer retention rate for investors in year-end documents." + }, + { + "inputJson": "{\"metricName\":\"website traffic growth\",\"metricValue\":30,\"audience\":\"general public\",\"tone\":\"motivational\",\"context\":\"social media campaign success\"}", + "description": "Produce a motivational text for the general public describing 30% website traffic growth attributed to social media efforts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Metric", + "context": null + } + }, + { + "name": "copywriting.generateChart", + "description": "Generates a concise, persuasive marketing text and description for a given chart data input. Accepts chart data and chart type to produce engaging copy that highlights key insights and appeals to target audiences, suitable for promotional materials or reports.", + "category": "copywriting", + "parameters": [ + { + "name": "chartType", + "type": "string", + "description": "Type of the chart (e.g., bar, line, pie) to tailor the marketing text.", + "required": true, + "defaultValue": "" + }, + { + "name": "chartData", + "type": "object", + "description": "Data object representing the chart's data points, labels, or series to be summarized in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience to customize tone and focus of the marketing text.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyInsights", + "type": "array", + "description": "List of main insights or takeaways from the chart to emphasize in the writing.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the marketing copy, such as 'professional', 'enthusiastic', or 'informative'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length in words for the generated marketing text to ensure appropriate size.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text and a brief summary describing the chart's key message." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate promotional or descriptive marketing texts that effectively communicate the value, insights, or appeal of data presented as charts. It is handy for content creators, marketers, or analysts preparing reports, presentations, or advertisements that require engaging copy tailored around a data visualization.", + "limitations": "Cannot create visual charts or handle raw data visualization; focuses on generating textual descriptions and marketing-oriented narratives based on the provided chart data and summary input.", + "examples": [ + "Generate a marketing paragraph summarizing a sales growth line chart targeting investors.", + "Create an engaging description for a pie chart showing market share for a product launch flyer.", + "Produce a concise copy highlighting key insights from a bar chart comparing quarterly revenues." + ] + }, + "tags": [ + "copywriting", + "marketing", + "chart", + "data visualization", + "content generation", + "promotion" + ], + "examples": [ + { + "inputJson": "{\"chartType\":\"bar\",\"chartData\":{\"labels\":[\"Q1\",\"Q2\",\"Q3\",\"Q4\"],\"values\":[15000,18000,22000,25000]},\"targetAudience\":\"business executives\",\"keyInsights\":[\"steady revenue growth each quarter\",\"strong Q4 performance\"],\"tone\":\"professional\",\"maxLength\":120}", + "description": "Generate a professional marketing copy for a bar chart showing quarterly revenue growth aimed at business executives." + }, + { + "inputJson": "{\"chartType\":\"pie\",\"chartData\":{\"segments\":[\"Product A\",\"Product B\",\"Product C\"],\"percentages\":[45,30,25]},\"targetAudience\":\"marketing team\",\"tone\":\"enthusiastic\"}", + "description": "Create an enthusiastic promotional description for a pie chart displaying product market shares for the marketing team." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Chart", + "context": null + } + }, + { + "name": "copywriting.generateTrend", + "description": "Generates a concise and engaging marketing trend report based on input industry keywords and recent market data. The tool accepts keywords and optional date range to analyze relevant current trends, then produces summarized trend insights and recommended copy points for promotional content.", + "category": "copywriting", + "parameters": [ + { + "name": "industryKeywords", + "type": "array", + "description": "A list of keywords related to the industry or market to analyze for trends.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "startDate", + "type": "string", + "description": "Optional start date (YYYY-MM-DD) to filter trend data from.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "Optional end date (YYYY-MM-DD) to filter trend data up to.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxTrendCount", + "type": "number", + "description": "Maximum number of top trends to include in the output (1-10).", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeCopySuggestions", + "type": "boolean", + "description": "Whether to include suggested marketing copy points based on trends.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing an array of trend summaries with title, description, and optional copy suggestions." + }, + "aiAgent": { + "useCase": "Useful for marketers, content creators, and product managers to quickly generate insightful summaries of the latest market or industry trends based on custom keywords and recent data. Enables crafting timely promotional copy grounded in relevant trend analysis.", + "limitations": "Does not replace detailed market research or proprietary data analysis; relies on publicly available or input data and may not reflect all niche or highly specialized trends.", + "examples": [ + "Generate marketing trend insights for renewable energy industry keywords from last 6 months including copy suggestions.", + "Get top 3 trend summaries for e-commerce related keywords without copy suggestions.", + "Provide trend analysis for health tech sector keywords from 2023-01-01 to 2023-06-30 with copy suggestions." + ] + }, + "tags": [ + "copywriting", + "marketing", + "trend analysis", + "content generation", + "promotional text", + "analytics", + "market trends" + ], + "examples": [ + { + "inputJson": "{\"industryKeywords\":[\"renewable energy\",\"solar power\",\"wind energy\"],\"startDate\":\"2023-01-01\",\"endDate\":\"2023-06-30\",\"maxTrendCount\":4,\"includeCopySuggestions\":true}", + "description": "Generate a trend report with copy suggestions for renewable energy industry in first half of 2023." + }, + { + "inputJson": "{\"industryKeywords\":[\"e-commerce\",\"online shopping\"],\"maxTrendCount\":3,\"includeCopySuggestions\":false}", + "description": "Generate top 3 trends for e-commerce keywords with no copy suggestions, using recent data." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Trend", + "context": null + } + }, + { + "name": "copywriting.generateForecast", + "description": "Generates a business forecast marketing text based on input data such as market trends, sales figures, and growth projections. Processes numerical and contextual inputs to produce engaging promotional copy that highlights anticipated business performance and future opportunities.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "The industry or market sector the forecast is about (e.g., technology, retail).", + "required": true, + "defaultValue": "" + }, + { + "name": "timeFrame", + "type": "string", + "description": "The forecast period, e.g., next quarter, fiscal year, or next 5 years.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyMetrics", + "type": "object", + "description": "An object containing key numerical metrics like projected sales, growth rate, and market share percentages.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The primary audience for the forecast text, e.g., investors, customers, or internal stakeholders.", + "required": false, + "defaultValue": "investors" + }, + { + "name": "tone", + "type": "string", + "description": "The tone of the generated copy, e.g., optimistic, cautious, or neutral.", + "required": false, + "defaultValue": "optimistic" + }, + { + "name": "includeChallenges", + "type": "boolean", + "description": "Whether to include potential challenges or risks in the forecast copy.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated marketing forecast text under the 'forecastText' key." + }, + "aiAgent": { + "useCase": "Use this tool to create promotional business forecast content tailored for specific industries and timeframes based on quantitative projections and market insights. Ideal for generating investor relations materials, marketing campaigns, or strategic presentations highlighting expected growth and opportunities.", + "limitations": "This tool does not perform actual market analysis or validate data accuracy; it only generates marketing copy based on provided inputs. It cannot replace detailed financial modeling or expert forecasts.", + "examples": [ + "Generate an optimistic 1-year sales forecast text for the retail industry targeting customers.", + "Create a cautious growth forecast for the tech sector addressing investors including potential market risks.", + "Produce a neutral 5-year market share projection summary for internal stakeholders without mentioning challenges." + ] + }, + "tags": [ + "copywriting", + "business", + "marketing", + "forecast", + "sales", + "growth", + "promotional", + "writing" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"technology\",\"timeFrame\":\"next fiscal year\",\"keyMetrics\":{\"projectedSales\":\"150 million USD\",\"growthRate\":\"12%\",\"marketShare\":\"5%\"},\"targetAudience\":\"investors\",\"tone\":\"optimistic\",\"includeChallenges\":false}", + "description": "Generate an optimistic forecast text for the technology sector's next fiscal year focusing on sales and growth projections for investors." + }, + { + "inputJson": "{\"industry\":\"retail\",\"timeFrame\":\"next quarter\",\"keyMetrics\":{\"projectedSales\":\"50 million USD\",\"growthRate\":\"3%\",\"marketShare\":\"10%\"},\"targetAudience\":\"customers\",\"tone\":\"cautious\",\"includeChallenges\":true}", + "description": "Create a cautious next quarter sales forecast for the retail industry targeting customers, including potential challenges." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Forecast", + "context": null + } + }, + { + "name": "copywriting.generateGraph", + "description": "Generates a customized, publication-ready graph image to illustrate marketing or promotional content. Accepts structured data points, graph type, and styling preferences, then produces a visual graph (e.g., bar, line, pie) tailored for inclusion in marketing materials or presentations.", + "category": "copywriting", + "parameters": [ + { + "name": "dataPoints", + "type": "array", + "description": "An array of data objects representing points or categories to plot, each with label and numeric value.", + "required": true, + "defaultValue": "" + }, + { + "name": "graphType", + "type": "string", + "description": "Type of graph to generate, such as 'bar', 'line', or 'pie'.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title text to display on the graph.", + "required": false, + "defaultValue": "" + }, + { + "name": "colorScheme", + "type": "string", + "description": "Color palette to apply for graph elements, e.g., 'vibrant', 'pastel', or hex codes.", + "required": false, + "defaultValue": "vibrant" + }, + { + "name": "width", + "type": "number", + "description": "Width of the graph image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the graph image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "includeLegend", + "type": "boolean", + "description": "Whether to include a legend explaining the graph data series.", + "required": false, + "defaultValue": "true" + }, + { + "name": "xAxisLabel", + "type": "string", + "description": "Label text for the x-axis, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "yAxisLabel", + "type": "string", + "description": "Label text for the y-axis, if applicable.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a Base64 encoded image string of the generated graph and metadata including image format and dimensions." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a clear, visually appealing graph that supports marketing or promotional copy, enhancing presentations, social media posts, or reports with data visualization tailored for a marketing context.", + "limitations": "Does not perform data analysis or generate textual copy; inputs must be clean and numeric. Limited to common graph types; complex interactive or 3D graphs are not supported.", + "examples": [ + "Generate a bar chart visualizing quarterly sales to embed in a promotional newsletter.", + "Create a pie chart showing market share percentages for a presentation slide.", + "Produce a line graph tracking customer acquisition growth for social media marketing content." + ] + }, + "tags": [ + "copywriting", + "graph", + "visualization", + "marketing", + "promotional", + "media", + "data-visualization" + ], + "examples": [ + { + "inputJson": "{\"dataPoints\":[{\"label\":\"Q1\",\"value\":15000},{\"label\":\"Q2\",\"value\":20000},{\"label\":\"Q3\",\"value\":18000},{\"label\":\"Q4\",\"value\":22000}],\"graphType\":\"bar\",\"title\":\"Quarterly Sales 2023\",\"colorScheme\":\"vibrant\",\"width\":800,\"height\":600,\"includeLegend\":true,\"xAxisLabel\":\"Quarter\",\"yAxisLabel\":\"Revenue ($)\"}", + "description": "Generate a vibrant bar graph displaying quarterly sales for 2023 to use in marketing materials." + }, + { + "inputJson": "{\"dataPoints\":[{\"label\":\"Brand A\",\"value\":40},{\"label\":\"Brand B\",\"value\":35},{\"label\":\"Brand C\",\"value\":25}],\"graphType\":\"pie\",\"title\":\"Market Share Distribution\",\"colorScheme\":\"pastel\",\"width\":600,\"height\":400,\"includeLegend\":true}", + "description": "Create a pastel-colored pie chart visualizing market share distribution among three brands." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Graph", + "context": null + } + }, + { + "name": "copywriting.generateHTML", + "description": "Generates marketing or promotional HTML content based on input text, style preferences, and target audience. Accepts plain text or bullet points, processes copywriting best practices, and outputs formatted HTML code ready for web or email use.", + "category": "copywriting", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The main marketing or promotional text content to be converted into HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired writing tone for the content, such as 'formal', 'casual', 'energetic', or 'persuasive'.", + "required": false, + "defaultValue": "persuasive" + }, + { + "name": "audience", + "type": "string", + "description": "Description of the target audience to tailor the copy, e.g., 'tech-savvy millennials', 'business executives', or 'retail customers'.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCTA", + "type": "boolean", + "description": "Whether to include a call-to-action button or link in the generated HTML.", + "required": false, + "defaultValue": "true" + }, + { + "name": "ctaText", + "type": "string", + "description": "Text to display on the call-to-action button or link if includeCTA is true.", + "required": false, + "defaultValue": "Learn More" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated HTML content to ensure brevity or fit constraints.", + "required": false, + "defaultValue": "500" + }, + { + "name": "stylePreset", + "type": "string", + "description": "Optional style preset for the HTML output like 'modern', 'minimalist', or 'classic' to influence formatting and colors.", + "required": false, + "defaultValue": "modern" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated HTML string with marketing copy formatted according to provided parameters." + }, + "aiAgent": { + "useCase": "Use this tool when needing to rapidly create engaging, formatted marketing HTML content from plain text input that is tailored in tone and style for specific audiences and includes call-to-action elements for web or email campaigns.", + "limitations": "Cannot generate images or multimedia elements; does not validate HTML for all email clients or browsers; style customization is limited to presets and simple formatting.", + "examples": [ + "Generate persuasive product launch HTML for tech-savvy millennials including a call-to-action button.", + "Create short, formal promotional email HTML without call-to-action link.", + "Produce minimalist styled marketing HTML targeting business executives with custom call-to-action text." + ] + }, + "tags": [ + "copywriting", + "HTML", + "marketing", + "promotion", + "email", + "webcontent", + "call-to-action" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Introducing our latest smartwatch with advanced health tracking features.\",\"tone\":\"persuasive\",\"audience\":\"tech-savvy millennials\",\"includeCTA\":true,\"ctaText\":\"Buy Now\",\"maxLength\":400,\"stylePreset\":\"modern\"}", + "description": "Generate a modern styled promotional HTML snippet for a smartwatch aimed at tech-savvy millennials with a persuasive tone and a 'Buy Now' button." + }, + { + "inputJson": "{\"content\":\"End of season clearance sale up to 50% off.\",\"tone\":\"formal\",\"audience\":\"retail customers\",\"includeCTA\":false,\"maxLength\":250,\"stylePreset\":\"classic\"}", + "description": "Create formal, classic style HTML for a clearance sale announcement targeting retail customers without a call-to-action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "HTML", + "context": null + } + }, + { + "name": "copywriting.generateDiagram", + "description": "Generates marketing and promotional diagrams based on provided text descriptions or concepts. Accepts textual inputs outlining key messages, target audiences, and diagram style preferences. Processes these inputs to create visually structured diagram concepts ideal for marketing materials, outputting a diagram in SVG or PNG format alongside a textual summary of key design elements.", + "category": "copywriting", + "parameters": [ + { + "name": "conceptDescription", + "type": "string", + "description": "A detailed textual description of the concept or marketing message to visualize in the diagram.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the marketing diagram, influencing style and language.", + "required": false, + "defaultValue": "" + }, + { + "name": "diagramStyle", + "type": "string", + "description": "Preferred style for the diagram, such as flowchart, mind map, infographic, or organizational chart.", + "required": false, + "defaultValue": "flowchart" + }, + { + "name": "colorScheme", + "type": "string", + "description": "Color scheme preference for the diagram, e.g., 'corporate', 'vibrant', or hex color codes.", + "required": false, + "defaultValue": "corporate" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output image format: 'svg' or 'png'.", + "required": false, + "defaultValue": "svg" + }, + { + "name": "includeKeyPoints", + "type": "boolean", + "description": "Whether to include textual key points extracted from the concept in the diagram.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated diagram image encoded as a base64 string and a text summary of key diagram components." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create visually engaging marketing diagrams or infographics that illustrate key messages or concepts from textual descriptions. It helps automate the generation of promotional media assets suited for presentations, social media, or campaign materials.", + "limitations": "Cannot produce highly customized or artistic diagram visuals equivalent to professional graphic design software. Complexity of input concepts affects clarity and coherence of the generated diagram. Output is limited to simple diagram styles.", + "examples": [ + "Generate a mind map diagram for a new product launch targeting tech-savvy millennials.", + "Create a flowchart illustrating the customer journey for an online subscription service.", + "Produce an infographic style diagram summarizing the benefits of a health supplement for busy professionals." + ] + }, + "tags": [ + "copywriting", + "diagram", + "marketing", + "visualization", + "infographic", + "generate" + ], + "examples": [ + { + "inputJson": "{\"conceptDescription\":\"A flowchart showing the steps of subscribing to our premium service: sign up, select plan, payment, confirmation, start using.\",\"targetAudience\":\"young professionals\",\"diagramStyle\":\"flowchart\",\"colorScheme\":\"corporate\",\"outputFormat\":\"svg\",\"includeKeyPoints\":true}", + "description": "Generate a corporate style flowchart diagram visualizing the subscription steps for a young professional audience." + }, + { + "inputJson": "{\"conceptDescription\":\"Mind map of key features and benefits of our new eco-friendly cleaning product.\",\"diagramStyle\":\"mind map\",\"colorScheme\":\"vibrant\",\"outputFormat\":\"png\",\"includeKeyPoints\":true}", + "description": "Create a vibrant mind map infographic displaying features and benefits of an eco-friendly product." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Diagram", + "context": null + } + }, + { + "name": "copywriting.generateYAML", + "description": "Generates YAML-formatted marketing and promotional copy based on structured input data. Accepts a description of product features, target audience, tone, and style preferences, then produces clean, well-organized YAML output representing marketing text and metadata suitable for further processing or integration.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to generate marketing copy for.", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "List of key product features or benefits to highlight in the marketing copy.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the marketing message, influencing tone and style.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy such as 'friendly', 'professional', 'casual', or 'luxury'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "style", + "type": "string", + "description": "Preferred writing style or format (e.g., 'concise', 'detailed', 'storytelling').", + "required": false, + "defaultValue": "concise" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include metadata fields like version, lastUpdated, and author in the YAML output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field with the YAML string of generated marketing content and relevant metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create structured marketing or promotional copy in YAML format for integration into content management systems, chatbots, or automated marketing pipelines. It assists in converting raw product info and stylistic preferences into standardized YAML documents.", + "limitations": "Cannot generate uniquely creative writing beyond input parameters; dependent on quality and completeness of input data. Not suitable for generating fully formatted HTML or non-text multimedia content.", + "examples": [ + "Generate marketing YAML for a new smartphone highlighting camera and battery life aimed at tech enthusiasts in a friendly tone.", + "Create YAML promotional copy for an eco-friendly detergent with detailed style for environmentally conscious consumers.", + "Produce concise YAML marketing text for a new app targeting professionals with a professional tone." + ] + }, + "tags": [ + "copywriting", + "yaml", + "marketing", + "promotional-text", + "content-generation", + "structured-data" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Detergent\",\"features\":[\"Biodegradable formula\",\"Leaves no residue\",\"Safe for sensitive skin\"],\"targetAudience\":\"Environmentally conscious homeowners\",\"tone\":\"friendly\",\"style\":\"detailed\",\"includeMetadata\":true}", + "description": "Generate detailed, friendly YAML marketing copy for an eco-friendly detergent targeting environmentally conscious homeowners." + }, + { + "inputJson": "{\"productName\":\"SnapShot Pro Camera\",\"features\":[\"48MP ultra-clear photos\",\"20 hour battery life\",\"Water-resistant design\"],\"tone\":\"professional\",\"style\":\"concise\",\"includeMetadata\":false}", + "description": "Create concise, professional YAML promotional copy for a high-end camera emphasizing key features." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "YAML", + "context": null + } + }, + { + "name": "copywriting.generateXML", + "description": "Generates an XML document containing marketing or promotional text structured into customizable sections. Accepts structured input data including campaign title, target audience, product details, and promotional messages. Produces a well-formed XML string organizing these elements for easy integration with marketing platforms or further processing.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignTitle", + "type": "string", + "description": "Title or name of the marketing campaign to include in the XML root element attribute or tag.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience segment for personalization in the promotional text.", + "required": false, + "defaultValue": "" + }, + { + "name": "productDetails", + "type": "object", + "description": "Structured object containing product name, features, benefits, and pricing info to include in XML nodes.", + "required": true, + "defaultValue": "" + }, + { + "name": "promotionalMessages", + "type": "array", + "description": "Array of strings representing key promotional messages or call-to-actions to embed in the XML.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'fr') for the generated text content to adapt language style.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Flag indicating whether to include metadata such as date generated and author info in the XML.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single property 'xmlString' with the generated XML document as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to transform structured marketing content data into a standardized XML format that can be easily consumed by other marketing tools or content management systems. It is ideal for automating campaign content packaging or for generating consistent promotional text layouts in XML.", + "limitations": "This tool does not perform language translation beyond simple language style adaptation. It also does not validate marketing claims or check compliance; content quality depends entirely on input provided.", + "examples": [ + "Generate XML for a new product launch campaign targeting millennials with several promotional messages.", + "Create XML marketing content including product descriptions and CTA for use in email templates.", + "Produce an XML file with metadata for a campaign personalized for a European audience." + ] + }, + "tags": [ + "copywriting", + "XML", + "marketing", + "promotionalText", + "contentGeneration", + "campaign", + "automation" + ], + "examples": [ + { + "inputJson": "{\"campaignTitle\":\"Spring Sale 2024\",\"targetAudience\":\"budget-conscious young adults\",\"productDetails\":{\"name\":\"SmartWatch X\",\"features\":\"Heart rate monitor, GPS, Waterproof\",\"benefits\":\"Stay connected and track health easily\",\"price\":\"$199\"},\"promotionalMessages\":[\"Limited time offer!\",\"Buy one get one 50% off.\",\"Free shipping on orders over $50.\"],\"language\":\"en\",\"includeMetadata\":true}", + "description": "Generate XML structure for a spring sale marketing campaign targeting young adults including product details and promotional messages." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "XML", + "context": null + } + }, + { + "name": "copywriting.generateCSV", + "description": "Generates a CSV file containing multiple marketing copy entries based on given input prompts and parameters. Accepts input keywords, target audience descriptions, tone preferences, and desired output fields, producing a CSV formatted string with generated copy variations ready for use or further editing.", + "category": "copywriting", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "List of keywords or key phrases to focus the marketing copy on.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor the tone and style accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., casual, formal, persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "fields", + "type": "array", + "description": "The CSV columns to generate, e.g., headline, description, callToAction.", + "required": true, + "defaultValue": "[\"headline\",\"description\"]" + }, + { + "name": "numEntries", + "type": "number", + "description": "Number of copy entries (rows) to generate in the CSV output.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field `csvContent` with the generated CSV string of marketing copy entries." + }, + "aiAgent": { + "useCase": "Use this tool when needing bulk marketing copy created in structured CSV format to facilitate campaigns, A/B testing, or integration with content management workflows. It helps generate varied text snippets tailored by keywords, audience, and tone for dynamic marketing purposes.", + "limitations": "It does not generate final polished copy guaranteed to convert; outputs may require review and editing. It does not support advanced formatting beyond CSV structure.", + "examples": [ + "Generate 10 rows of promotional headlines and descriptions targeting young adults interested in eco-friendly products with a casual tone.", + "Create 5 marketing call-to-action lines and descriptions focused on a business software target audience using a formal tone.", + "Produce a CSV with 3 variants of product taglines and supporting descriptions based on the keywords provided." + ] + }, + "tags": [ + "copywriting", + "CSV generation", + "marketing", + "bulk content", + "text generation", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"sustainable\",\"eco-friendly\",\"green\"],\"targetAudience\":\"environmentally conscious millennials\",\"tone\":\"casual\",\"fields\":[\"headline\",\"description\",\"callToAction\"],\"numEntries\":5}", + "description": "Generate 5 rows of eco-friendly marketing copy targeting millennials with casual tone." + }, + { + "inputJson": "{\"keywords\":[\"B2B software\",\"productivity\",\"efficiency\"],\"targetAudience\":\"business professionals\",\"tone\":\"formal\",\"fields\":[\"headline\",\"description\"],\"numEntries\":3}", + "description": "Generate 3 formal marketing copy rows focused on B2B software benefits." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "CSV", + "context": null + } + }, + { + "name": "copywriting.generateJSON", + "description": "Generates structured JSON output for marketing copy based on input parameters such as product details, target audience, tone, and key selling points. Processes input to produce promotional text segments in JSON format, facilitating integration into marketing frameworks or automated content systems.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to be marketed.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "A brief description outlining the main features or purpose of the product.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Defines the primary demographic or customer segment to tailor the copy towards (e.g., young adults, businesses).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Specifies the stylistic tone of the generated copy, such as friendly, professional, or persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "keySellingPoints", + "type": "array", + "description": "An array of strings listing the main benefits or unique selling propositions to emphasize in the copy.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "callToAction", + "type": "string", + "description": "The desired call-to-action phrase to include in the promotional text.", + "required": false, + "defaultValue": "Buy now" + }, + { + "name": "language", + "type": "string", + "description": "The language code for generating copy (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "A JSON object containing distinct sections of marketing copy such as headline, body, and call to action, structured for easy parsing and usage in applications." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate structured promotional copy tailored to specific product details and audience characteristics in a JSON format for seamless integration into marketing platforms, websites, or apps.", + "limitations": "Does not generate long-form content or replace human editing for brand voice consistency; limited to concise marketing copy segments.", + "examples": [ + "Generate marketing copy JSON for a new organic skincare product targeting young adults with a friendly tone.", + "Create structured promotional text for a B2B software service emphasizing security features in a professional tone.", + "Produce JSON-formatted marketing snippets including headline, description, and call to action for a mobile app launch." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional-text", + "JSON", + "automation", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoGlow Facial Cream\",\"productDescription\":\"A natural and organic facial cream that hydrates and rejuvenates skin.\",\"targetAudience\":\"young adults\",\"tone\":\"friendly\",\"keySellingPoints\":[\"100% organic ingredients\",\"cruelty-free\",\"suitable for all skin types\"],\"callToAction\":\"Try EcoGlow today!\",\"language\":\"en\"}", + "description": "Generate promotional copy JSON for an organic skincare product aimed at young adults with a friendly style." + }, + { + "inputJson": "{\"productName\":\"SecureSys Cloud Storage\",\"productDescription\":\"Enterprise-grade cloud storage with top-tier encryption and compliance certifications.\",\"targetAudience\":\"businesses\",\"tone\":\"professional\",\"keySellingPoints\":[\"AES-256 encryption\",\"GDPR compliant\",\"99.9% uptime SLA\"],\"callToAction\":\"Contact us for a demo\",\"language\":\"en\"}", + "description": "Create a professional marketing copy JSON structure for a cloud storage service targeting business clients." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "JSON", + "context": null + } + }, + { + "name": "copywriting.generateMarkdown", + "description": "Generates marketing and promotional content formatted in Markdown. Accepts raw text input describing the subject and key points, processes them to create well-structured and engaging Markdown output including headings, bullet points, and emphasis suited for blogs, emails, or social posts.", + "category": "copywriting", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The main topic or product to promote in the Markdown content.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of key points or features to highlight within the content.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor the tone and style appropriately.", + "required": false, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "A call-to-action phrase or sentence to include in the content.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words for the generated Markdown content.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated Markdown string under 'markdownContent' key." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce ready-to-use marketing or promotional text formatted in Markdown, ideal for content marketing, email campaigns, or social media posts where structured text with headings and bullet points enhances readability and engagement.", + "limitations": "This tool cannot verify factual accuracy of the content or tailor responses for complex legal or technical compliance. It focuses on general marketing tone and structure rather than deep brand voice consistency.", + "examples": [ + "Generate a Markdown blog post for a new smartphone highlighting its battery life and camera features.", + "Create a promotional email in Markdown for an online course targeting young professionals.", + "Produce a Markdown formatted social media post announcing a seasonal sale with a clear call-to-action." + ] + }, + "tags": [ + "copywriting", + "markdown", + "marketing", + "promotional", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Eco-friendly Water Bottles\",\"keyPoints\":[\"Made from recycled materials\",\"Keeps drinks cold for 24hrs\",\"BPA free and non-toxic\"],\"targetAudience\":\"Environmentally conscious consumers\",\"callToAction\":\"Order yours today!\",\"maxLength\":200}", + "description": "Generate a Markdown promotional post about eco-friendly water bottles highlighting key features and call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Markdown", + "context": null + } + }, + { + "name": "copywriting.generateDataset", + "description": "Generates a structured dataset of marketing copy samples based on specified themes, tones, and target audiences. Accepts parameters defining the marketing context and outputs a dataset containing varied promotional text entries suitable for training or reference.", + "category": "copywriting", + "parameters": [ + { + "name": "themes", + "type": "array", + "description": "List of marketing themes or topics for the copy samples (e.g., technology, health).", + "required": true, + "defaultValue": "" + }, + { + "name": "tones", + "type": "array", + "description": "Desired tones for the copywriting samples (e.g., formal, casual, persuasive).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudiences", + "type": "array", + "description": "Specified target audiences or customer segments (e.g., millennials, small business owners).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "samplesPerCombination", + "type": "number", + "description": "Number of distinct copy samples to generate per theme-tone-audience combination.", + "required": false, + "defaultValue": "5" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for each copy sample.", + "required": false, + "defaultValue": "280" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array named 'dataset' with entries, each having 'theme', 'tone', 'audience' (if provided), and 'copyText' fields representing generated marketing copy samples." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create comprehensive datasets of marketing copy spanning multiple themes, tones, and audiences, for purposes like training AI models, generating marketing content templates, or performing copywriting style analysis. It automates generating diverse promotional text samples tailored to specific contexts.", + "limitations": "The tool generates synthetic marketing text samples but does not verify factual accuracy or compliance with brand guidelines. Generated content might require human review before actual marketing use. It cannot incorporate sensitive or proprietary company data not provided in inputs.", + "examples": [ + "Generate 10 persuasive copies for the health and wellness theme targeting young adults.", + "Create dataset of casual and formal tone copies for technology products aimed at professionals.", + "Produce marketing text samples for eco-friendly products in enthusiastic tone without specifying an audience." + ] + }, + "tags": [ + "copywriting", + "dataset", + "marketing", + "text-generation", + "promotional-content", + "dataset-creation" + ], + "examples": [ + { + "inputJson": "{\"themes\":[\"technology\"],\"tones\":[\"formal\",\"casual\"],\"targetAudiences\":[\"professionals\"],\"samplesPerCombination\":3,\"maxLength\":200}", + "description": "Generate 3 formal and casual tone marketing copy samples for technology targeting professionals." + }, + { + "inputJson": "{\"themes\":[\"health\",\"fitness\"],\"tones\":[\"persuasive\"],\"targetAudiences\":[],\"samplesPerCombination\":5,\"maxLength\":150}", + "description": "Generate 5 persuasive copy samples for health and fitness themes without specific audience." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Dataset", + "context": null + } + }, + { + "name": "copywriting.generateTest", + "description": "Generates realistic code test scenarios or test case descriptions based on given programming language, framework, and feature specifications. Accepts input parameters for feature description, preferred language, and testing framework, then produces structured test case text or code snippets suitable for integration in test suites.", + "category": "copywriting", + "parameters": [ + { + "name": "featureDescription", + "type": "string", + "description": "A brief description of the feature or functionality to be tested.", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Programming language in which the test code or examples should be generated (e.g., JavaScript, Python).", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "Testing framework name or style (e.g., Jest, Mocha, PyTest) that output tests should be compatible with.", + "required": false, + "defaultValue": "Jest" + }, + { + "name": "testType", + "type": "string", + "description": "Type of test to generate, such as unit, integration, or functional.", + "required": false, + "defaultValue": "unit" + }, + { + "name": "includeSetup", + "type": "boolean", + "description": "Whether to include test setup and teardown code snippets if applicable.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxTestCases", + "type": "number", + "description": "Maximum number of individual test cases to generate in the output.", + "required": false, + "defaultValue": "3" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated test code or detailed test case descriptions as a string, formatted appropriately for the specified language and framework." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate skeleton or example test code or test case descriptions for specified features in chosen languages and frameworks, to accelerate test coverage creation or to suggest test ideas.", + "limitations": "Cannot run or validate the correctness of generated test code; generated tests may require manual review and adaptation. Limited to popular languages and frameworks specified; may not support all edge case test types or obscure frameworks.", + "examples": [ + "Generate unit tests in JavaScript using Jest for a user login feature.", + "Create integration test cases in Python with PyTest for a data import module.", + "Produce a set of functional test scenarios describing expected behavior for an e-commerce cart system." + ] + }, + "tags": [ + "copywriting", + "testing", + "code generation", + "unit test", + "integration test", + "test automation" + ], + "examples": [ + { + "inputJson": "{\"featureDescription\":\"User authentication with email and password\",\"programmingLanguage\":\"JavaScript\",\"testFramework\":\"Jest\",\"testType\":\"unit\",\"includeSetup\":true,\"maxTestCases\":3}", + "description": "Generate Jest unit test code snippets for user authentication feature in JavaScript." + }, + { + "inputJson": "{\"featureDescription\":\"Data import from CSV files\",\"programmingLanguage\":\"Python\",\"testFramework\":\"PyTest\",\"testType\":\"integration\",\"includeSetup\":false,\"maxTestCases\":2}", + "description": "Generate PyTest integration test cases for CSV data import in Python without setup code." + }, + { + "inputJson": "{\"featureDescription\":\"Shopping cart adding and removing items\",\"programmingLanguage\":\"JavaScript\",\"testFramework\":\"Mocha\",\"testType\":\"functional\",\"includeSetup\":true,\"maxTestCases\":4}", + "description": "Generate functional test case descriptions and sample code using Mocha for shopping cart behavior." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Test", + "context": null + } + }, + { + "name": "copywriting.generateQuery", + "description": "Generates optimized marketing or advertising search queries based on a product description, target audience, and marketing goals. Accepts detailed product information and campaign context, then produces a list of tailored, high-impact search queries or keywords suitable for use in SEO or pay-per-click campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product or service to be marketed, including key features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the ideal customer or demographic targeted by the marketing campaign.", + "required": false, + "defaultValue": "" + }, + { + "name": "marketingGoal", + "type": "string", + "description": "Primary objective for the marketing campaign, such as brand awareness, lead generation, or direct sales.", + "required": false, + "defaultValue": "" + }, + { + "name": "queryCount", + "type": "number", + "description": "Number of distinct search queries or keywords to generate.", + "required": false, + "defaultValue": "10" + }, + { + "name": "includeBrandName", + "type": "boolean", + "description": "Whether to incorporate the brand name in the generated queries for branding purposes.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing a list of generated search queries optimized for marketing campaigns, each including the query text and a relevance score." + }, + "aiAgent": { + "useCase": "Use this tool when planning or optimizing digital marketing and advertising campaigns that rely on targeted search queries, such as SEO or PPC advertising. It helps to quickly generate relevant, high-impact queries tailored to a product and audience.", + "limitations": "Cannot guarantee actual search volume or bid cost effectiveness; it does not access live search engine data or trends, only generates queries based on provided input context.", + "examples": [ + "Generate top search queries for a new eco-friendly water bottle aimed at young adults.", + "Create marketing search keywords to boost direct sales of a premium skincare line.", + "Provide branded and unbranded query suggestions for a SaaS productivity tool targeting small businesses." + ] + }, + "tags": [ + "copywriting", + "marketing", + "SEO", + "advertising", + "search query generation", + "digital marketing", + "PPC" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"Lightweight, durable eco-friendly water bottle made from recycled materials.\",\"targetAudience\":\"Young adults aged 18-30 interested in sustainability and outdoor activities.\",\"marketingGoal\":\"Brand awareness\",\"queryCount\":5,\"includeBrandName\":false}", + "description": "Generate 5 SEO queries targeting young adults to raise brand awareness for eco water bottle." + }, + { + "inputJson": "{\"productDescription\":\"Premium anti-aging skincare serum with natural ingredients.\",\"targetAudience\":\"Women aged 35-55 concerned about skin health.\",\"marketingGoal\":\"Direct sales\",\"queryCount\":8,\"includeBrandName\":true}", + "description": "Generate 8 branded and unbranded PPC keywords for premium skincare product aimed at middle-aged women." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Query", + "context": null + } + }, + { + "name": "copywriting.generateFAQ", + "description": "Generates a comprehensive Frequently Asked Questions (FAQ) document based on a given topic, product, or service description and list of common customer questions. The tool processes input text and optional question prompts to produce clear, concise question-and-answer pairs formatted as an FAQ section.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The overall subject or product name for which the FAQ is to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed description of the product, service, or domain to contextualize the FAQ content.", + "required": true, + "defaultValue": "" + }, + { + "name": "commonQuestions", + "type": "array", + "description": "An optional array of specific questions customers frequently ask related to the topic, guiding the FAQ generation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxQuestions", + "type": "number", + "description": "Maximum number of FAQ question-answer pairs to generate, capped to avoid excessive length.", + "required": false, + "defaultValue": "10" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en' for English) for the generated FAQ content.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing a list of FAQ entries, each with a question and an answer string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to rapidly produce a clear, well-structured FAQ section for marketing websites, product pages, user support portals, or documentation based on concise input about a product or service and optionally typical customer questions. It helps automate content creation to improve user self-service and reduce support queries.", + "limitations": "The generated FAQ is only as accurate and relevant as the input description and questions provided. It may produce generic or incomplete answers if inputs lack detail. Domain-specific or highly technical FAQs might need manual review and refinement.", + "examples": [ + "Generate an FAQ for a new smart fitness watch including common questions about battery life and compatibility.", + "Create an FAQ document for an online cloud storage service based on a product description and common user concerns about security.", + "Produce up to 5 FAQ entries for an eco-friendly cleaning product focusing on usage and safety." + ] + }, + "tags": [ + "copywriting", + "FAQ", + "content generation", + "marketing", + "customer support", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Smart Home Thermostat\",\"description\":\"A state-of-the-art smart thermostat that learns your schedule, saves energy, and can be controlled via mobile app.\",\"commonQuestions\":[\"How do I install the thermostat?\",\"Is it compatible with my heating system?\",\"Can it be controlled remotely?\"],\"maxQuestions\":5,\"language\":\"en\"}", + "description": "Generate a focused FAQ for a smart thermostat covering installation, compatibility, and remote control questions." + }, + { + "inputJson": "{\"topic\":\"Organic Shampoo\",\"description\":\"A natural shampoo made with organic ingredients, free from sulfates and parabens, designed for sensitive scalp.\",\"commonQuestions\":[],\"maxQuestions\":3,\"language\":\"en\"}", + "description": "Generate a brief FAQ about an organic shampoo based on product description only, no given questions." + }, + { + "inputJson": "{\"topic\":\"Cloud Storage Pro Plan\",\"description\":\"High-capacity cloud storage with advanced encryption and 24/7 customer support.\",\"commonQuestions\":[\"How secure is my data?\",\"What is the storage limit?\"],\"maxQuestions\":4,\"language\":\"en\"}", + "description": "Generate a FAQ for a cloud storage service highlighting security and storage limit questions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "FAQ", + "context": null + } + }, + { + "name": "copywriting.generateReadme", + "description": "Generates a professional and clear README.md content for a software project. Accepts project details such as project name, description, installation instructions, usage examples, contribution guidelines, license, and outputs a well-structured markdown README file content.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to be included as the README title.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief description of the project’s purpose and features.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions on how to install the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "string", + "description": "Examples demonstrating how to use the project or its features.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Guidelines for contributing to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "licenseType", + "type": "string", + "description": "The license under which the project is released (e.g., MIT, GPL).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated README content as a markdown string under the 'readmeContent' property." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a complete, organized README.md file for a new or existing software project. It helps automate the creation of essential documentation by combining project details into a professional markdown document, saving time and ensuring consistency.", + "limitations": "It cannot generate project-specific technical documentation beyond what is provided in parameters. It relies entirely on input details and does not analyze codebases to infer content.", + "examples": [ + "Generate a README for an open-source JavaScript library including installation and usage.", + "Create a README for a tool with contribution guidelines and license.", + "Generate a minimal README with just project name and description." + ] + }, + "tags": [ + "copywriting", + "documentation", + "readme", + "markdown", + "software", + "project" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"AwesomeLib\",\"projectDescription\":\"A JavaScript library to simplify data visualization.\",\"installationInstructions\":\"npm install awesomelib\",\"usageExamples\":\"import { Chart } from 'awesomelib';\\nconst chart = new Chart(data);\\nchart.render();\",\"contributionGuidelines\":\"Please submit pull requests with tests.\",\"licenseType\":\"MIT\"}", + "description": "Generate a full README for a JS library with installation, usage, contribution, and license." + }, + { + "inputJson": "{\"projectName\":\"MyCLI\",\"projectDescription\":\"A command-line tool for task automation.\",\"installationInstructions\":\"Download the binary from releases.\",\"usageExamples\":\"mycli --help\",\"contributionGuidelines\":\"Fork the repo and open pull requests.\",\"licenseType\":\"GPL-3.0\"}", + "description": "Generate README for a CLI tool including main sections." + }, + { + "inputJson": "{\"projectName\":\"SimpleProject\",\"projectDescription\":\"A demo project to showcase example code.\"}", + "description": "Generate a minimal README with only project name and description." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Readme", + "context": null + } + }, + { + "name": "copywriting.generateCode", + "description": "Generates ready-to-use programming code snippets or small modules based on natural language descriptions or specifications provided. Accepts parameters for desired programming language, functionality description, code style preferences, and output length constraints, producing clean example code tailored to user requirements.", + "category": "copywriting", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "The target programming language for the generated code (e.g., Python, JavaScript).", + "required": true, + "defaultValue": "" + }, + { + "name": "functionalityDescription", + "type": "string", + "description": "A detailed natural language description of the desired code functionality or behavior.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeStyle", + "type": "string", + "description": "Preferred coding style or conventions to follow (e.g., functional, object-oriented, compact).", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLines", + "type": "number", + "description": "Maximum number of lines for the generated code snippet.", + "required": false, + "defaultValue": "50" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether the generated code should include explanatory comments.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated code as a string and metadata about the code, including language and estimated complexity." + }, + "aiAgent": { + "useCase": "Use this tool when a user requests coding help in natural language, such as generating a function, script, or algorithm snippet in a specific language, especially for prototyping, educational purposes, or accelerating development.", + "limitations": "The tool cannot guarantee the generated code is optimized, bug-free, or secure. It does not perform thorough validation or testing. Complex system designs or very large code bases are out of scope.", + "examples": [ + "Generate a Python function that sorts a list of integers.", + "Create a JavaScript module to validate email addresses.", + "Produce a compact JavaScript snippet that fetches data from an API and logs the result." + ] + }, + "tags": [ + "code generation", + "copywriting", + "programming", + "automation", + "developer tools", + "snippet" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"Python\",\"functionalityDescription\":\"Function to calculate the factorial of a number using recursion.\",\"codeStyle\":\"functional\",\"maxLines\":20,\"includeComments\":true}", + "description": "Generate a Python recursive factorial function with comments." + }, + { + "inputJson": "{\"programmingLanguage\":\"JavaScript\",\"functionalityDescription\":\"Check if a given string is a palindrome.\",\"codeStyle\":\"compact\",\"maxLines\":15,\"includeComments\":false}", + "description": "Generate a compact JavaScript function to check palindromes without comments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Code", + "context": null + } + }, + { + "name": "copywriting.generateMinutes", + "description": "Generates professional and concise meeting minutes from provided meeting details including agenda, attendees, discussion points, and action items. Accepts structured input of meeting data, processes it into organized and readable minutes text document, suitable for distribution.", + "category": "copywriting", + "parameters": [ + { + "name": "meetingDate", + "type": "string", + "description": "Date of the meeting in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "meetingTitle", + "type": "string", + "description": "Title or subject of the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "attendees", + "type": "array", + "description": "List of meeting attendees' names or roles.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "agendaItems", + "type": "array", + "description": "List of agenda topics to be discussed in the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discussionPoints", + "type": "array", + "description": "Detailed discussion points covering each agenda item with summaries.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items with descriptions and assigned responsible persons.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "meetingDurationMinutes", + "type": "number", + "description": "Duration of the meeting in minutes.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a summary section at the beginning of the minutes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Structured document containing formatted meeting minutes as a text string, including headings for date, attendees, agenda, discussions, action items, and optional summary." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw meeting details, notes, or structured inputs into a well-formatted, clear set of meeting minutes suitable for sharing with stakeholders. It is ideal for business meetings, project updates, or team syncs.", + "limitations": "Cannot generate minutes without sufficient input detail. Does not record audio or transcribe raw recordings; requires textual inputs. Quality depends on completeness of provided meeting data.", + "examples": [ + "Generate minutes from a project kickoff meeting with detailed agenda and action items.", + "Create a summary minute document from a brainstorming session notes.", + "Produce concise minutes focusing on assigned action items and decisions made." + ] + }, + "tags": [ + "copywriting", + "minutes", + "meeting", + "documentation", + "summary", + "business" + ], + "examples": [ + { + "inputJson": "{\"meetingDate\":\"2024-06-01\",\"meetingTitle\":\"Q2 Project Update\",\"attendees\":[\"Alice Smith\",\"Bob Johnson\",\"Carlos Diaz\"],\"agendaItems\":[\"Project status\",\"Budget review\",\"Next steps\"],\"discussionPoints\":[\"Project status: On track with milestones.\",\"Budget review: Additional funding required.\",\"Next steps: Prepare proposal for additional budget.\"],\"actionItems\":[{\"description\":\"Draft budget proposal\",\"assignedTo\":\"Alice Smith\"},{\"description\":\"Schedule follow-up meeting\",\"assignedTo\":\"Bob Johnson\"}],\"meetingDurationMinutes\":45,\"includeSummary\":true}", + "description": "Minutes generation for a Q2 project update meeting with agenda, discussions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Minutes", + "context": null + } + }, + { + "name": "copywriting.generateChecklist", + "description": "Generates a comprehensive, customized checklist for marketing and promotional campaigns based on user-provided goals, target audience, campaign type, and specific tasks. Accepts details and outputs an organized list of actionable checklist items to guide marketing efforts effectively.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "Type of marketing campaign (e.g., email, social media, product launch) to tailor checklist content.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the campaign's target audience to customize relevant checklist points.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignGoals", + "type": "array", + "description": "List of primary goals for the campaign (e.g., increase engagement, brand awareness) to focus checklist items.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTaskDetails", + "type": "boolean", + "description": "Whether to include detailed explanations and tips for each checklist item.", + "required": false, + "defaultValue": "false" + }, + { + "name": "deadline", + "type": "string", + "description": "Optional campaign deadline to prioritize checklist items accordingly (format: YYYY-MM-DD).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing an ordered array named checklist where each entry includes a title and optionally detailed description of task items customized for the campaign." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a structured and actionable checklist for various types of marketing campaigns to ensure all critical steps are remembered and properly executed. Particularly helpful in automating checklist generation based on campaign specifics to save time and reduce errors.", + "limitations": "Cannot replace expert marketing consultation or capture highly specialized industry compliance requirements. Checklist items are generic and depend on accurate and complete input details.", + "examples": [ + "Generate a checklist for a social media campaign targeting young adults focusing on brand awareness and engagement.", + "Create an email marketing checklist aiming to increase newsletter subscriptions with detailed task explanations.", + "Produce a product launch checklist with a deadline emphasizing pre-launch and post-launch activities." + ] + }, + "tags": [ + "copywriting", + "marketing", + "checklist", + "campaign", + "promotion", + "automation" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"social media\",\"targetAudience\":\"millennial urban professionals\",\"campaignGoals\":[\"increase engagement\",\"brand awareness\"],\"includeTaskDetails\":true}", + "description": "Generate a detailed social media campaign checklist aimed at urban millennials, focused on engagement and brand awareness." + }, + { + "inputJson": "{\"campaignType\":\"email\",\"targetAudience\":\"subscribers of tech newsletter\",\"campaignGoals\":[\"increase subscriptions\"],\"includeTaskDetails\":false}", + "description": "Generate a straightforward checklist for an email marketing campaign to boost tech newsletter subscriptions without detailed task info." + }, + { + "inputJson": "{\"campaignType\":\"product launch\",\"targetAudience\":\"retail customers\",\"campaignGoals\":[\"successful launch\",\"customer feedback\"],\"includeTaskDetails\":true,\"deadline\":\"2024-12-01\"}", + "description": "Generate a detailed product launch checklist with a set deadline emphasizing launch preparation and feedback collection." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Checklist", + "context": null + } + }, + { + "name": "copywriting.generateBrief", + "description": "Generates a concise and effective marketing brief based on product details, target audience, objectives, and tone. Accepts inputs describing the product or service, key features, target demographics, and desired style, and produces a structured brief outlining marketing goals, unique selling points, and suggested messaging strategies.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to create the brief for.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product, including key features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended customer segment or demographic.", + "required": true, + "defaultValue": "" + }, + { + "name": "marketingObjectives", + "type": "array", + "description": "List of primary marketing objectives, such as brand awareness or lead generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "toneOfVoice", + "type": "string", + "description": "Preferred tone or style of the marketing brief, e.g., formal, casual, enthusiastic.", + "required": false, + "defaultValue": "Professional" + }, + { + "name": "competitorInsights", + "type": "string", + "description": "Optional overview of competitors or differentiators to include in the brief.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured marketing brief including objectives, target audience summary, key messaging, and recommended approach." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a streamlined marketing brief from product and audience inputs to aid marketing teams in campaign planning. Ideal for quickly summarizing essential marketing parameters into a clear document.", + "limitations": "This tool generates briefs based on provided input but does not perform deep market analysis or guarantee marketing success. It relies on accurate and sufficient input data to create useful outputs.", + "examples": [ + "Generate a marketing brief for a new eco-friendly water bottle targeting environmentally conscious millennials with an enthusiastic tone.", + "Create a brief highlighting the key selling points and objectives for a SaaS platform aiming to increase subscriptions among small businesses.", + "Produce a structured marketing brief for a luxury skincare brand emphasizing exclusivity and quality targeting affluent women." + ] + }, + "tags": [ + "copywriting", + "marketing", + "brief", + "generate", + "promotion", + "strategy" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSip Water Bottle\",\"productDescription\":\"A reusable water bottle made from recycled materials that keeps drinks cold for 24 hours.\",\"targetAudience\":\"Environmentally conscious millennials aged 25-35.\",\"marketingObjectives\":[\"Increase brand awareness\",\"Drive online sales\"],\"toneOfVoice\":\"Enthusiastic\",\"competitorInsights\":\"Competitors focus less on sustainability, more on style.\"}", + "description": "Generate a marketing brief for an eco-friendly water bottle targeting millennials." + }, + { + "inputJson": "{\"productName\":\"CloudTrack SaaS\",\"productDescription\":\"A subscription-based cloud platform for project management and team collaboration.\",\"targetAudience\":\"Small and medium business owners seeking efficient team tools.\",\"marketingObjectives\":[\"Increase subscriptions\",\"Build brand loyalty\"],\"toneOfVoice\":\"Professional\",\"competitorInsights\":\"Strong competitors with complex UIs.\"}", + "description": "Create a marketing brief for a SaaS product targeting SMBs to improve subscriptions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Brief", + "context": null + } + }, + { + "name": "copywriting.generateSummary", + "description": "This tool accepts a document text input and generates a concise, coherent summary highlighting the key points. It processes the input text using natural language understanding techniques to produce an accurate and engaging summary suitable for marketing, presentations, or quick overviews.", + "category": "copywriting", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "The full text of the document to summarize, typically several paragraphs or pages.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Desired length of the summary in number of sentences; controls conciseness.", + "required": false, + "defaultValue": "3" + }, + { + "name": "tone", + "type": "string", + "description": "Writing tone of the summary; e.g., formal, casual, professional, friendly.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "highlightKeywords", + "type": "array", + "description": "Optional list of keywords or phrases to emphasize or include in the summary.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the summary output, default is 'en' for English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated summary text and metadata including length and language." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to quickly generate a brief, readable summary of a longer document or article to streamline understanding, improve marketing content creation, or prepare executive briefs. It helps in extracting key points without manual summarization.", + "limitations": "This tool cannot fully interpret highly technical or ambiguous content accurately and may miss nuanced meanings. It does not generate summaries longer than the requested sentence count and cannot analyze non-textual content.", + "examples": [ + "Generate a short professional summary of a product description document.", + "Summarize a long research article into 5 sentences with a friendly tone.", + "Create a brief overview highlighting user benefits from a technical manual." + ] + }, + "tags": [ + "copywriting", + "summary", + "marketing", + "text", + "document", + "content creation", + "natural language processing" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"Our new software product offers unprecedented data processing speeds combined with ease of use. Designed for both enterprises and individual users, it supports a wide range of formats and integrates seamlessly with existing workflows.\",\"summaryLength\":2,\"tone\":\"professional\"}", + "description": "Generate a professional 2-sentence summary highlighting product features." + }, + { + "inputJson": "{\"documentText\":\"This article explains the benefits of sustainable energy and how your company can reduce its carbon footprint by adopting solar power solutions.\",\"summaryLength\":3,\"tone\":\"friendly\",\"highlightKeywords\":[\"sustainable energy\",\"solar power\"]}", + "description": "Create a friendly 3-sentence summary emphasizing sustainable energy and solar power keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "copywriting.generateTemplate", + "description": "Generates marketing and promotional copywriting templates based on input parameters such as industry, target audience, template type, and tone. Inputs define the structure and style, and the output is a customizable text template suitable for marketing campaigns or promotional materials.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "Industry or business sector for which to generate the copywriting template (e.g., technology, fashion).", + "required": true, + "defaultValue": "" + }, + { + "name": "templateType", + "type": "string", + "description": "Type of marketing template to generate (e.g., email, social media post, landing page).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience or customer persona for whom the template is intended.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of voice for the template (e.g., professional, casual, enthusiastic).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action section in the template.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') for the template output.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated copywriting template text and metadata such as the industry, template type, and tone." + }, + "aiAgent": { + "useCase": "When an AI agent needs to quickly generate structured marketing content frameworks tailored to specific industries and audiences, this tool produces detailed copywriting templates that can be customized and refined further. Useful for automated marketing content generation and campaign planning.", + "limitations": "This tool generates templates and frameworks, not complete finalized copy. It cannot replace creative human copywriting nuance or verify factual claims. Output should be reviewed and edited before use.", + "examples": [ + "Generate a social media post template for the fitness industry targeting young adults with an enthusiastic tone.", + "Create an email marketing template for a B2B technology company with a professional tone including a call to action.", + "Produce a landing page copy template for an eco-friendly product in Spanish language." + ] + }, + "tags": [ + "copywriting", + "template", + "marketing", + "promotional", + "automation", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"fitness\",\"templateType\":\"social media post\",\"targetAudience\":\"young adults\",\"tone\":\"enthusiastic\",\"includeCallToAction\":true,\"language\":\"en\"}", + "description": "Generate a social media marketing template targeted at young adults in the fitness industry with an enthusiastic tone and call to action." + }, + { + "inputJson": "{\"industry\":\"technology\",\"templateType\":\"email\",\"targetAudience\":\"B2B clients\",\"tone\":\"professional\",\"includeCallToAction\":true,\"language\":\"en\"}", + "description": "Generate a professional email marketing template for B2B technology company including call to action." + }, + { + "inputJson": "{\"industry\":\"eco-friendly products\",\"templateType\":\"landing page\",\"language\":\"es\",\"tone\":\"professional\",\"includeCallToAction\":true}", + "description": "Generate a Spanish landing page copy template for eco-friendly products with a professional tone." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Template", + "context": null + } + }, + { + "name": "copywriting.generateSchema", + "description": "Generates a structured JSON schema for marketing content based on specified content types and attributes. Accepts input detailing desired content elements and outputs a JSON schema defining the structure and constraints for automated or guided copy creation.", + "category": "copywriting", + "parameters": [ + { + "name": "contentType", + "type": "string", + "description": "Type of marketing content schema to generate (e.g., 'productDescription', 'adCopy', 'emailNewsletter').", + "required": true, + "defaultValue": "" + }, + { + "name": "attributes", + "type": "array", + "description": "List of content attributes to include, each defining a field name and expected data type (e.g., [{\"field\":\"headline\",\"type\":\"string\"}, {\"field\":\"callToAction\",\"type\":\"string\"}]).", + "required": true, + "defaultValue": "" + }, + { + "name": "requiredFields", + "type": "array", + "description": "Array of attribute field names to be marked as required in the schema.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Flag to include example values in the generated schema to illustrate content format.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the generated JSON schema for the specified marketing content type, including properties, types, required fields, and optionally examples." + }, + "aiAgent": { + "useCase": "This tool is intended for AI agents tasked with generating structured templates or validation schemas for marketing copywriting content. It helps define clear schema structures for automated content generation engines or content management systems that require standardized input formats.", + "limitations": "The tool produces schema definitions but does not generate the actual marketing text content. It requires explicit attribute and content type inputs and does not infer content semantics beyond the given specifications.", + "examples": [ + "Generate a schema for product description including headline, features, and call to action.", + "Create a JSON schema for ad copy with required fields headline and offer details.", + "Produce a newsletter schema with subject, intro text, main content, and signature fields, including examples." + ] + }, + "tags": [ + "copywriting", + "schema", + "marketing", + "automation", + "content-structure", + "json-schema" + ], + "examples": [ + { + "inputJson": "{\"contentType\":\"productDescription\",\"attributes\":[{\"field\":\"headline\",\"type\":\"string\"},{\"field\":\"features\",\"type\":\"array\"},{\"field\":\"callToAction\",\"type\":\"string\"}],\"requiredFields\":[\"headline\",\"callToAction\"],\"includeExamples\":true}", + "description": "Generate a JSON schema for a product description content type, marking headline and callToAction as required, with example values included." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Schema", + "context": null + } + }, + { + "name": "copywriting.generateTranscript", + "description": "Generates a written transcript from audio or video content by accepting a spoken content input or its summary, and producing a coherent, reader-friendly transcript that captures spoken words with clarity and correct formatting suitable for publication or accessibility purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "audioContent", + "type": "string", + "description": "The URL or base64 string of the audio or video file to transcribe.", + "required": false, + "defaultValue": "" + }, + { + "name": "spokenContentSummary", + "type": "string", + "description": "A brief textual summary or notes of the spoken content, used when audio input is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language spoken in the audio content for accurate transcription (e.g., 'en', 'es').", + "required": true, + "defaultValue": "en" + }, + { + "name": "includeSpeakerLabels", + "type": "boolean", + "description": "Whether to include speaker labels in the transcript for multi-person conversations.", + "required": false, + "defaultValue": "false" + }, + { + "name": "formattingStyle", + "type": "string", + "description": "Preferred formatting style for the transcript output such as 'verbatim', 'clean', or 'summary'.", + "required": false, + "defaultValue": "clean" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the final transcript text, metadata like word count, and optionally speaker labels if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create readable, accurate transcripts from audio or video materials for marketing content, interviews, podcasts, or presentations to facilitate accessibility, content repurposing, and documentation.", + "limitations": "This tool requires either an audio/video input or an accurate summary to generate a transcript. It cannot perfectly transcribe poor quality audio, multiple overlapping speakers without clear separation, or translate languages.", + "examples": [ + "Generate a transcript from the uploaded podcast audio in English with speaker labels.", + "Create a clean transcript from a meeting summary without audio input.", + "Produce a verbatim transcript from a webinar audio file in Spanish without speaker differentiation." + ] + }, + "tags": [ + "copywriting", + "transcription", + "marketing", + "audio processing", + "content creation", + "accessibility" + ], + "examples": [ + { + "inputJson": "{\"audioContent\":\"https://example.com/podcast-episode.mp3\",\"language\":\"en\",\"includeSpeakerLabels\":true,\"formattingStyle\":\"clean\"}", + "description": "Generate a clean transcript from a podcast audio with speaker labels." + }, + { + "inputJson": "{\"spokenContentSummary\":\"In this webinar, we discussed Q3 marketing strategy and upcoming product launches.\",\"language\":\"en\",\"formattingStyle\":\"summary\"}", + "description": "Generate a summarized transcript based on webinar notes without audio input." + }, + { + "inputJson": "{\"audioContent\":\"base64audio==\",\"language\":\"es\",\"includeSpeakerLabels\":false,\"formattingStyle\":\"verbatim\"}", + "description": "Create a verbatim transcript from a Spanish audio recording without speaker labels." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Transcript", + "context": null + } + }, + { + "name": "copywriting.generateReleaseNotes", + "description": "Generates professional and clear release notes based on the input details of a software release. Accepts information such as version number, release date, a list of features, bug fixes, improvements, deprecated features, and known issues. Produces well-structured, human-readable release notes text suitable for publication to end users or stakeholders.", + "category": "copywriting", + "parameters": [ + { + "name": "version", + "type": "string", + "description": "The version number of the release (e.g., '2.5.1').", + "required": true, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "The date of the release in ISO format (e.g., '2024-06-20').", + "required": false, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "An array of new features added in this release. Each item is a short descriptive string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bugFixes", + "type": "array", + "description": "An array of bug fixes included in this release. Each item is a short descriptive string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "improvements", + "type": "array", + "description": "An array of improvements or enhancements made in this release. Each item is a short descriptive string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "deprecatedFeatures", + "type": "array", + "description": "An array listing any features that are deprecated or removed in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "knownIssues", + "type": "array", + "description": "An array listing known issues or limitations that users should be aware of in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "audience", + "type": "string", + "description": "Optional target audience for the release notes (e.g., 'end-users', 'developers').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single string property 'releaseNotesText' with the generated release notes." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create clear, professional release notes for software or applications based on structured input about version, changes, fixes, and issues. Particularly useful to automate the creation of release communications or documentation updates by summarizing input details into natural language notes.", + "limitations": "This tool generates release notes text based solely on the provided input and cannot infer missing details or verify the accuracy of input data. It does not create formatted documents such as PDFs or HTML but only generates plain text notes.", + "examples": [ + "Generate release notes for a version 1.3.0 release including new features, bug fixes, and known issues.", + "Create release notes targeted at developers, highlighting deprecated features and improvements in version 2.0.0.", + "Produce release notes for an interim patch release version 2.1.2 containing only bug fixes." + ] + }, + "tags": [ + "copywriting", + "release notes", + "documentation", + "software", + "marketing", + "automation", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"version\":\"1.3.0\",\"releaseDate\":\"2024-06-21\",\"features\":[\"Added dark mode support\",\"Integrated new payment gateway\"],\"bugFixes\":[\"Fixed crash on startup on iOS 14\",\"Resolved data sync issue under poor network conditions\"],\"improvements\":[\"Improved app loading speed\",\"Enhanced security for user data\"],\"deprecatedFeatures\":[],\"knownIssues\":[\"Occasional UI flicker on Android 11 devices\"],\"audience\":\"end-users\"}", + "description": "Release notes for a major feature release targeting end users with features, fixes, improvements, and known issues." + }, + { + "inputJson": "{\"version\":\"2.0.0\",\"releaseDate\":\"2024-07-01\",\"features\":[\"Added support for multiple user profiles\"],\"bugFixes\":[],\"improvements\":[\"Refactored backend API for better scalability\"],\"deprecatedFeatures\":[\"Removed legacy authentication methods\"],\"knownIssues\":[],\"audience\":\"developers\"}", + "description": "Release notes focusing on developer audience highlighting new features, improvements, and deprecated features for a major version update." + }, + { + "inputJson": "{\"version\":\"2.1.2\",\"releaseDate\":\"2024-07-10\",\"features\":[],\"bugFixes\":[\"Patched security vulnerability in login module\"],\"improvements\":[],\"deprecatedFeatures\":[],\"knownIssues\":[],\"audience\":\"end-users\"}", + "description": "Patch release notes listing only the bug fixes and no new features or improvements." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "copywriting.generateChangelog", + "description": "Generates a professional and clear changelog document based on provided version updates, feature descriptions, bug fixes, and improvements. Accepts structured update data and outputs formatted changelog text suitable for release notes or documentation.", + "category": "copywriting", + "parameters": [ + { + "name": "version", + "type": "string", + "description": "The version number for the release (e.g., '1.2.0').", + "required": true, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "The release date in ISO format (e.g., '2024-05-30').", + "required": false, + "defaultValue": "" + }, + { + "name": "addedFeatures", + "type": "array", + "description": "List of new features added in this version, each as a string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "fixedBugs", + "type": "array", + "description": "List of bugs fixed in this version, each as a string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "improvements", + "type": "array", + "description": "List of general improvements or optimizations in this release, each as a string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "breakingChanges", + "type": "array", + "description": "List of breaking changes or important notes that users should be aware of, each as a string.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Output changelog style format: options like 'markdown', 'plaintext', or 'html'.", + "required": false, + "defaultValue": "markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing the changelog text formatted as specified, with a single property 'changelogText' containing the full changelog string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate professional changelog text from structured release update data to maintain up-to-date release notes or product documentation. It helps ensure consistency and clarity in software or product update announcements.", + "limitations": "This tool cannot infer updates from unstructured text or code diffs automatically; input data must be well-structured. It does not generate detailed technical descriptions or interpret ambiguous update entries.", + "examples": [ + "Generate a markdown formatted changelog for version '2.0.0' released today including new features, bug fixes and breaking changes.", + "Create a plaintext changelog for a patch version with only bug fixes and improvements listed.", + "Produce an HTML changelog snippet for embedding in a website release notes section." + ] + }, + "tags": [ + "copywriting", + "changelog", + "release-notes", + "documentation", + "marketing", + "versioning" + ], + "examples": [ + { + "inputJson": "{\"version\":\"1.4.0\",\"releaseDate\":\"2024-06-01\",\"addedFeatures\":[\"Added user profile customization options\",\"Implemented dark mode support\"],\"fixedBugs\":[\"Fixed crash on logout\",\"Resolved layout issue on mobile devices\"],\"improvements\":[\"Improved loading speed\",\"Enhanced security for authentication\"],\"breakingChanges\":[\"Removed deprecated API endpoints\"],\"formatStyle\":\"markdown\"}", + "description": "Generate a markdown changelog for version 1.4.0 with various update categories." + }, + { + "inputJson": "{\"version\":\"1.3.2\",\"addedFeatures\":[],\"fixedBugs\":[\"Fixed typo in settings page\"],\"improvements\":[\"Optimized database queries\"],\"formatStyle\":\"plaintext\"}", + "description": "Create a simple plaintext changelog highlighting minor bug fix and improvement for patch version." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Changelog", + "context": null + } + }, + { + "name": "copywriting.generateDocument", + "description": "Generates a marketing or promotional document based on user-defined parameters like target audience, product details, tone, document type, and length. Processes these inputs to produce a well-structured, persuasive text tailored for the intended purpose, such as brochures, email campaigns, or press releases.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for whom the document is intended.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "Type of marketing document to generate (e.g., brochure, email, press release).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the document (e.g., friendly, professional, urgent).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or selling points to highlight in the document.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "desiredLength", + "type": "number", + "description": "Approximate length of the document in words.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing document text and a summary of its characteristics." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to create customized marketing or promotional documents quickly based on product details and audience insights. It helps generate polished text tailored to specific campaign goals and formats, accelerating content creation workflows.", + "limitations": "Cannot generate document with highly technical or legal accuracy without expert input. May produce generic content if input details are insufficient or vague.", + "examples": [ + "Generate a friendly brochure text for a new fitness tracker targeting millennials.", + "Create a professional press release announcing the launch of a new software product for enterprise clients.", + "Write an urgent email campaign promoting a limited-time offer on home security systems." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "promotional", + "document", + "advertising", + "brand messaging" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSmart Water Bottle\",\"targetAudience\":\"Environmentally conscious young adults\",\"documentType\":\"brochure\",\"tone\":\"friendly\",\"keyFeatures\":[\"BPA-free\",\"Double insulated\",\"Keeps drinks cold for 24h\"],\"desiredLength\":250}", + "description": "Generate a friendly brochure for an eco-friendly water bottle targeting young adults." + }, + { + "inputJson": "{\"productName\":\"SecurePay Online\",\"targetAudience\":\"Small business owners looking for easy payment solutions\",\"documentType\":\"email\",\"tone\":\"professional\",\"keyFeatures\":[\"Low fees\",\"24/7 support\",\"Easy integration\"],\"desiredLength\":150}", + "description": "Write a professional email promoting an online payment service for small businesses." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "copywriting.generateBlogPost", + "description": "Generates a comprehensive blog post based on the given topic, target audience, desired length, and tone. The tool processes input parameters to create a coherent, engaging, and well-structured article suitable for marketing or informational purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the blog post to write about.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers of the blog post (e.g., beginners, tech professionals).", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired word count for the blog post.", + "required": false, + "defaultValue": "800" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style for the blog post (e.g., formal, casual, persuasive).", + "required": false, + "defaultValue": "informative" + }, + { + "name": "keywords", + "type": "array", + "description": "A list of keywords to naturally incorporate in the blog post for SEO purposes.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated blog post text and metadata like word count." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to quickly generate marketing, educational, or informative blog content tailored to specific topics and audiences. It helps automate content creation in digital marketing, content strategy, or communications roles.", + "limitations": "The tool cannot replace expert review or domain-specific accuracy validation. It may produce generic or slightly off-topic content if parameters are vague or insufficient. It is not designed for highly technical or legal content requiring precise citations.", + "examples": [ + "Generate a 1000-word persuasive blog post about sustainable fashion targeting environmentally conscious consumers.", + "Create a casual style 500-word article explaining the benefits of meditation for beginners.", + "Write an informative blog post about cloud computing trends incorporating keywords 'cloud security' and 'hybrid cloud'." + ] + }, + "tags": [ + "copywriting", + "blogging", + "content creation", + "marketing", + "SEO", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"targetAudience\":\"HR managers and team leaders\",\"length\":1000,\"tone\":\"professional\",\"keywords\":[\"remote work\",\"flexible schedule\"]}", + "description": "Generate a professional, 1000-word blog post about benefits of remote work aimed at HR managers, including specified SEO keywords." + }, + { + "inputJson": "{\"topic\":\"Top 5 programming languages in 2024\",\"length\":800,\"tone\":\"informative\"}", + "description": "Create an informative 800-word article listing the top programming languages in 2024 with no specific audience or keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "BlogPost", + "context": null + } + }, + { + "name": "copywriting.generateArticle", + "description": "Generates a well-structured, coherent article based on a provided topic and style preferences. Accepts inputs such as topic keywords, target audience, desired tone, length, and optional subtopics, then produces a formatted article text suitable for marketing or informational purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the article to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers, to help tailor language and content complexity.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The writing style or mood, e.g. formal, casual, enthusiastic, persuasive.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the article in words.", + "required": false, + "defaultValue": "500" + }, + { + "name": "subtopics", + "type": "array", + "description": "List of specific points or themes to be covered within the article for focus and structure.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to append a marketing call to action at the end of the article.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article text and metadata such as estimated word count." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce original, coherent, and contextually relevant articles for marketing, blogging, or informational websites based on topical inputs and style preferences.", + "limitations": "May not capture highly specialized or technical domain expertise accurately without domain-specific training data; output should be reviewed for factual accuracy and compliance.", + "examples": [ + "Generate an article on sustainable tourism targeted at environmentally conscious travelers, with a friendly tone.", + "Create a 750-word formal article about cybersecurity risks for small business owners, including detailed subtopics on phishing and malware and a call to action.", + "Write a brief casual article introducing the benefits of meditation for busy professionals." + ] + }, + "tags": [ + "copywriting", + "article", + "marketing", + "content-generation", + "writing", + "SEO" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"sustainable tourism\",\"targetAudience\":\"environmentally conscious travelers\",\"tone\":\"friendly\",\"length\":600,\"subtopics\":[\"eco-friendly practices\",\"local community support\"],\"includeCallToAction\":true}", + "description": "Generate a friendly, 600-word article on sustainable tourism focusing on eco-friendly practices and supporting local communities with a call to action." + }, + { + "inputJson": "{\"topic\":\"cybersecurity risks\",\"targetAudience\":\"small business owners\",\"tone\":\"formal\",\"length\":750,\"subtopics\":[\"phishing\",\"malware\"],\"includeCallToAction\":true}", + "description": "Create a formal 750-word article about cybersecurity risks aimed at small business owners, covering phishing and malware, including a call to action." + }, + { + "inputJson": "{\"topic\":\"meditation benefits\",\"targetAudience\":\"busy professionals\",\"tone\":\"casual\",\"length\":400,\"subtopics\":[],\"includeCallToAction\":false}", + "description": "Write a casual 400-word article introducing meditation benefits for busy professionals with no additional call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Article", + "context": null + } + }, + { + "name": "copywriting.generateReport", + "description": "Generates a structured marketing report based on input parameters including target audience, product details, campaign goals, and tone. The tool synthesizes these inputs to create a comprehensive report suitable for marketing teams outlining strategy, expected results, and key messaging.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be featured in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the marketing campaign.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignGoals", + "type": "string", + "description": "Primary objectives of the marketing campaign such as increasing brand awareness or driving sales.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the report, e.g., professional, casual, persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include an executive summary section at the start of the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the generated report in number of words.", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing report text under the key 'reportContent'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce well-organized marketing strategy reports automatically from high-level campaign inputs. It helps marketing teams quickly generate drafts that outline key campaign elements, target audiences, goals, and messaging strategies.", + "limitations": "This tool generates text based on input parameters but does not create visual elements, detailed analytics, or personalized data insights. It is not a substitute for expert marketing consulting and may produce generalized content.", + "examples": [ + "Generate a marketing report for a new smartphone targeting young adults focusing on brand awareness with a persuasive tone.", + "Create a brief marketing strategy report for an eco-friendly detergent product for environmentally conscious consumers with a professional tone." + ] + }, + "tags": [ + "copywriting", + "report", + "marketing", + "strategy", + "automation" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Detergent\",\"targetAudience\":\"Environmentally conscious consumers aged 25-40\",\"campaignGoals\":\"Increase brand awareness and drive sales in organic markets\",\"tone\":\"professional\",\"includeSummary\":true,\"length\":1200}", + "description": "Generate a detailed marketing report for an eco-friendly detergent targeting green consumers, emphasizing brand awareness goals." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Report", + "context": null + } + }, + { + "name": "copywriting.createCitation", + "description": "Generates a formatted citation text snippet based on provided source information and citation style. Accepts input details like author, title, publication date, and source type, then produces a properly styled citation string suitable for marketing or promotional content referencing.", + "category": "copywriting", + "parameters": [ + { + "name": "author", + "type": "string", + "description": "Full name(s) of the author(s) of the source material.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the source document or content.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationDate", + "type": "string", + "description": "Publication date or year of the source, in ISO 8601 or YYYY format.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source (e.g., book, article, website, report).", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or organization that produced the source.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "Web address if the source is online, used to generate URL citations.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to use for formatting (e.g., APA, MLA, Chicago).", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string under the key 'citationText'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce correctly formatted citations for source references within marketing or promotional text. It helps ensure proper accreditation of content sources in widely recognized citation styles, supporting credible and professional copywriting.", + "limitations": "This tool generates citations based on input parameters and common citation styles but does not verify source accuracy, completeness, or conformity to the latest style manual editions.", + "examples": [ + "Create an APA citation for a marketing report authored by Jane Smith published in 2021.", + "Generate an MLA style citation for a website article by Tom Johnson.", + "Format a Chicago style citation for a book titled 'Digital Marketing Basics' published by MarketPro in 2020." + ] + }, + "tags": [ + "copywriting", + "citation", + "marketing", + "reference", + "formatting", + "APA", + "MLA", + "Chicago" + ], + "examples": [ + { + "inputJson": "{\"author\":\"Jane Smith\",\"title\":\"2021 Market Trends\",\"publicationDate\":\"2021\",\"sourceType\":\"report\",\"publisher\":\"Insight Analytics\",\"url\":\"\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA style citation for a marketing report by Jane Smith published in 2021." + }, + { + "inputJson": "{\"author\":\"Tom Johnson\",\"title\":\"How to Boost Online Engagement\",\"publicationDate\":\"\",\"sourceType\":\"website\",\"publisher\":\"\",\"url\":\"https://example.com/boost-engagement\",\"citationStyle\":\"MLA\"}", + "description": "Create an MLA citation for an online article with provided URL and author." + }, + { + "inputJson": "{\"author\":\"Michael Lee\",\"title\":\"Digital Marketing Basics\",\"publicationDate\":\"2020\",\"sourceType\":\"book\",\"publisher\":\"MarketPro\",\"url\":\"\",\"citationStyle\":\"Chicago\"}", + "description": "Format a Chicago style citation for a book with given author, title, and publisher." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Citation", + "context": null + } + }, + { + "name": "copywriting.createKPI", + "description": "Generates clear and persuasive Key Performance Indicator (KPI) descriptions for marketing and promotional content based on provided performance metrics and business goals. Accepts KPI metrics, target audience, and optional tone; produces a concise, engaging KPI statement suitable for reports, campaigns, or presentations.", + "category": "copywriting", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The name/title of the KPI to describe (e.g., 'Customer Retention Rate').", + "required": true, + "defaultValue": "" + }, + { + "name": "metricValue", + "type": "string", + "description": "Numeric or percentage value representing the KPI's current or target measurement (e.g., '85%').", + "required": true, + "defaultValue": "" + }, + { + "name": "businessGoal", + "type": "string", + "description": "The business objective related to the KPI (e.g., 'improve customer loyalty').", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the KPI statement (e.g., 'executive team', 'marketing department').", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style for the KPI statement (e.g., 'formal', 'motivational', 'concise').", + "required": false, + "defaultValue": "concise" + } + ], + "returns": { + "type": "object", + "description": "Structured output including the KPI statement text and a summary of the KPI context." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate impactful, tailored KPI descriptions for marketing or business analytics reports that clearly convey measurement results and align with strategic goals. It helps in creating engaging and understandable KPI statements for various audiences and contexts.", + "limitations": "This tool does not generate or analyze KPI data itself; it requires accurate input metrics and goals from the user. It also cannot customize extremely technical KPI language beyond general tone adjustments.", + "examples": [ + "Create a motivational KPI statement describing a 20% increase in web traffic to emphasize marketing success for the marketing team.", + "Generate a concise KPI line for a quarterly financial report showing a 15% reduction in churn rate linking to revenue growth.", + "Write a formal KPI description aimed at executives highlighting a 90% customer satisfaction rating achieved this quarter." + ] + }, + "tags": [ + "copywriting", + "KPI", + "marketing", + "analytics", + "business", + "reporting", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"Customer Retention Rate\",\"metricValue\":\"85%\",\"businessGoal\":\"improve customer loyalty\",\"targetAudience\":\"marketing department\",\"tone\":\"motivational\"}", + "description": "Generate an engaging KPI descriptor for a marketing team showing strong retention numbers with a motivational tone." + }, + { + "inputJson": "{\"kpiName\":\"Website Traffic Growth\",\"metricValue\":\"+20%\",\"businessGoal\":\"increase brand awareness\",\"targetAudience\":\"executive team\",\"tone\":\"formal\"}", + "description": "Produce a formal KPI statement describing positive website traffic increase for an executive-level report." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "copywriting.createReference", + "description": "Creates a polished and professional reference or testimonial text for marketing purposes based on provided information about a product, service, or individual. Accepts details such as subject name, key qualities, usage context, and tone to generate an effective promotional reference statement.", + "category": "copywriting", + "parameters": [ + { + "name": "subjectName", + "type": "string", + "description": "The name of the person, product, or service the reference is about.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyQualities", + "type": "array", + "description": "A list of key qualities, features, or benefits to highlight in the reference.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "The usage context or situation in which the subject was used or experienced.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the reference text, e.g., professional, friendly, enthusiastic.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the generated reference text in words.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated reference text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when a marketing or promotional reference/testimonial is needed to endorse a product, service, or individual, based on key attributes and context to produce persuasive content suitable for use in campaigns, websites, or presentations.", + "limitations": "This tool generates generic, plausible references based on input but cannot verify authenticity or provide real customer testimonials.", + "examples": [ + "Create a positive professional reference for a software product highlighting reliability and user support.", + "Generate a friendly testimonial for a consulting service emphasizing personalized attention and results." + ] + }, + "tags": [ + "copywriting", + "reference", + "testimonial", + "marketing", + "promotion", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"subjectName\":\"BrightTech CRM\",\"keyQualities\":[\"user-friendly interface\",\"excellent customer support\",\"scalable features\"],\"context\":\"used by small businesses for sales management\",\"tone\":\"professional\",\"length\":80}", + "description": "Generate a professional testimonial for a CRM software highlighting key benefits and usage context." + }, + { + "inputJson": "{\"subjectName\":\"Jane Doe Consulting\",\"keyQualities\":[\"personalized strategies\",\"quick turnaround\",\"result-oriented approach\"],\"context\":\"consulting services for startups\",\"tone\":\"friendly\",\"length\":60}", + "description": "Create a friendly marketing reference for a consulting service focused on startups." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reference", + "context": null + } + }, + { + "name": "copywriting.createQuote", + "description": "Generates an inspiring or promotional quote tailored to a specific theme or product. Accepts parameters for tone, style, target audience, and key message. Outputs a polished quote suitable for marketing materials, social media, or promotional content.", + "category": "copywriting", + "parameters": [ + { + "name": "theme", + "type": "string", + "description": "The main subject or theme for the quote (e.g., motivation, innovation, teamwork).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The emotional style of the quote such as uplifting, witty, formal, or casual.", + "required": false, + "defaultValue": "inspirational" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the quote, helping tailor language and impact (e.g., entrepreneurs, students, general public).", + "required": false, + "defaultValue": "" + }, + { + "name": "keyMessage", + "type": "string", + "description": "A core message or idea the quote should convey or emphasize.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the quote to fit specific mediums.", + "required": false, + "defaultValue": "120" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated quote text and metadata like length and tone." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create catchy, thematic quotes for marketing campaigns, social media posts, speeches, or motivational contexts. It's especially useful to produce tailored quotes with a specific emotional tone and audience in mind to enhance engagement and relevance.", + "limitations": "This tool cannot verify factual accuracy if specific data is involved in the quote and does not generate multi-sentence paragraphs or detailed content beyond a short quote.", + "examples": [ + "Create an inspiring quote about teamwork for corporate professionals.", + "Generate a witty quote related to technology for social media.", + "Provide a motivational quote under 100 characters for student audience." + ] + }, + "tags": [ + "copywriting", + "quote", + "marketing", + "social-media", + "inspiration", + "promotional-content" + ], + "examples": [ + { + "inputJson": "{\"theme\":\"motivation\",\"tone\":\"uplifting\",\"targetAudience\":\"entrepreneurs\",\"keyMessage\":\"perseverance leads to success\",\"maxLength\":100}", + "description": "Generate an uplifting motivational quote about perseverance for entrepreneurs, max 100 characters." + }, + { + "inputJson": "{\"theme\":\"innovation\",\"tone\":\"formal\",\"targetAudience\":\"technology executives\",\"keyMessage\":\"embracing change\",\"maxLength\":140}", + "description": "Produce a formal quote on innovation and embracing change for tech executives, max 140 characters." + }, + { + "inputJson": "{\"theme\":\"teamwork\",\"tone\":\"casual\",\"targetAudience\":\"young professionals\",\"keyMessage\":\"collaboration wins\",\"maxLength\":120}", + "description": "Create a casual quote about teamwork and collaboration targeted at young professionals, maximum 120 chars." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Quote", + "context": null + } + }, + { + "name": "copywriting.createLink", + "description": "Generates a marketing-friendly hyperlink with customizable anchor text and optional tracking parameters. Accepts a base URL and descriptive text, then outputs a full HTML anchor tag or plain URL with UTM parameters for promotional campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "baseUrl", + "type": "string", + "description": "The main URL to which the link should point, e.g., a product or landing page URL.", + "required": true, + "defaultValue": "" + }, + { + "name": "anchorText", + "type": "string", + "description": "The visible text for the hyperlink that will be displayed to users.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeUtm", + "type": "boolean", + "description": "Whether to append UTM tracking parameters to the URL for campaign analytics.", + "required": false, + "defaultValue": "false" + }, + { + "name": "utmSource", + "type": "string", + "description": "The UTM source identifier, e.g., 'newsletter' or 'social'. Used only if includeUtm is true.", + "required": false, + "defaultValue": "" + }, + { + "name": "utmMedium", + "type": "string", + "description": "The UTM medium descriptor, like 'email' or 'cpc'. Used only if includeUtm is true.", + "required": false, + "defaultValue": "" + }, + { + "name": "utmCampaign", + "type": "string", + "description": "The UTM campaign name to track the marketing effort, e.g., 'spring-sale'. Used only if includeUtm is true.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format for the generated link: 'html' for anchor tag, or 'url' for plain URL string.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated link either as an HTML anchor tag or plain URL string, depending on outputFormat." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create attractive, trackable promotional links for marketing content. It helps dynamically construct URLs with embedded tracking parameters and present them either as clickable HTML or simple text links suitable for emails, websites, or social media posts.", + "limitations": "This tool cannot create shortened URLs or guarantee the validity of the input URLs. It also doesn't generate QR codes or graphical elements.", + "examples": [ + "Generate an HTML link with UTM parameters for an email campaign.", + "Create a plain URL with custom anchor text for social media posting.", + "Produce a hyperlink without tracking parameters for a simple product link." + ] + }, + "tags": [ + "copywriting", + "marketing", + "linkGeneration", + "utm", + "promotionalLinks", + "htmlAnchor" + ], + "examples": [ + { + "inputJson": "{\"baseUrl\":\"https://example.com/product\",\"anchorText\":\"Check out our new product!\",\"includeUtm\":true,\"utmSource\":\"newsletter\",\"utmMedium\":\"email\",\"utmCampaign\":\"spring-sale\",\"outputFormat\":\"html\"}", + "description": "Generate an HTML anchor tag with UTM parameters for an email newsletter campaign." + }, + { + "inputJson": "{\"baseUrl\":\"https://example.com/offer\",\"anchorText\":\"Limited Time Offer\",\"includeUtm\":true,\"utmSource\":\"social\",\"utmMedium\":\"cpc\",\"utmCampaign\":\"holiday-deal\",\"outputFormat\":\"url\"}", + "description": "Generate a plain URL with UTM parameters suitable for social media paid campaign." + }, + { + "inputJson": "{\"baseUrl\":\"https://example.com/about\",\"anchorText\":\"Learn More\",\"includeUtm\":false,\"outputFormat\":\"html\"}", + "description": "Generate a simple HTML anchor link without any tracking parameters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Link", + "context": null + } + }, + { + "name": "copywriting.createHeading", + "description": "This tool generates compelling and attention-grabbing headings based on input keywords or topics and the intended audience or tone. It processes these inputs to produce suitable, concise, marketing-focused headings for use in advertisements, blogs, emails, or social media.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the heading to focus on.", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience the heading should appeal to, e.g., professionals, teenagers, or fitness enthusiasts.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the heading, such as formal, casual, humorous, or urgent.", + "required": false, + "defaultValue": "casual" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length allowed for the heading to ensure brevity and impact.", + "required": false, + "defaultValue": "60" + }, + { + "name": "includeKeyword", + "type": "boolean", + "description": "Whether to explicitly include the main topic keyword in the heading for SEO or clarity.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading string under the key 'heading'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create effective marketing or promotional headings tailored to specific topics, audiences, and tones to improve engagement and clarity in copywriting tasks. It helps generate creative, contextual headline ideas quickly.", + "limitations": "It cannot guarantee originality or trademark safety of headings. It also cannot replace deep human creativity for highly nuanced branding or legal review.", + "examples": [ + "Create a catchy heading about sustainable fashion targeting eco-conscious consumers with a casual tone.", + "Generate a formal heading for a financial report summary for professional investors.", + "Produce a short humorous heading about coffee benefits for young adults." + ] + }, + "tags": [ + "copywriting", + "heading", + "marketing", + "content creation", + "advertising", + "SEO" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"healthy snacks\",\"audience\":\"parents\",\"tone\":\"friendly\",\"maxLength\":50,\"includeKeyword\":true}", + "description": "Generate a friendly, concise heading about healthy snacks aimed at parents." + }, + { + "inputJson": "{\"topic\":\"cloud security\",\"audience\":\"IT professionals\",\"tone\":\"formal\",\"maxLength\":70,\"includeKeyword\":true}", + "description": "Create a formal heading focused on cloud security targeted at IT professionals." + }, + { + "inputJson": "{\"topic\":\"summer sale\",\"audience\":\"general public\",\"tone\":\"urgent\",\"maxLength\":40,\"includeKeyword\":false}", + "description": "Produce a short, urgent heading about a summer sale without necessarily including the topic keyword explicitly." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Heading", + "context": null + } + }, + { + "name": "copywriting.createText", + "description": "Generates marketing or promotional text based on input parameters including target audience, product description, tone, and desired text length. Processes inputs with NLP models to produce persuasive and customized copy for various marketing channels.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product or service features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the text, including demographics and preferences.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the text, e.g., professional, casual, enthusiastic, or humorous.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "textLength", + "type": "number", + "description": "Approximate length of the generated text in words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action to include at the end of the text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create customized marketing or promotional copy based on specific product details and audience profiles. Ideal for generating content for ads, social media posts, emails, or product descriptions that match a given tone and length requirement.", + "limitations": "Cannot guarantee uniqueness or compliance with advertising standards. Generated text may require human review to ensure factual accuracy and appropriateness for specific brands or regulatory environments.", + "examples": [ + "Generate a professional 100-word product description for a new smartphone targeted at tech-savvy millennials with a call to action to buy now.", + "Create a casual and enthusiastic social media post promoting a new organic skincare line aimed at eco-conscious consumers.", + "Write a brief, humorous promotional email for a coffee subscription service aimed at young adults." + ] + }, + "tags": [ + "copywriting", + "marketing", + "text generation", + "promotional content", + "NLP", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Dishwasher\",\"productDescription\":\"A fully automatic dishwasher using eco-friendly detergents and low water consumption.\",\"targetAudience\":\"Environmentally conscious homeowners aged 30-50.\",\"tone\":\"professional\",\"textLength\":120,\"callToAction\":\"Order yours today to make your home greener!\"}", + "description": "Generate a professional promotional text for an eco-friendly dishwasher targeting environmentally conscious homeowners." + }, + { + "inputJson": "{\"productName\":\"GlowUp Serum\",\"productDescription\":\"A vitamin-rich face serum that hydrates skin and reduces wrinkles.\",\"targetAudience\":\"Women aged 25-40 interested in skincare.\",\"tone\":\"enthusiastic\",\"textLength\":80,\"callToAction\":\"Try GlowUp Serum now for radiant skin!\"}", + "description": "Create a short enthusiastic marketing text for a skincare product aimed at women interested in beauty treatments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "copywriting.createSentence", + "description": "Generates a concise, persuasive marketing or promotional sentence based on provided product or service details, target audience, and desired tone. Accepts textual inputs describing key product features and outputs a polished sentence suitable for use in ads, social media, or promotional materials.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "Brief description of the product or service to promote, including key features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the marketing sentence, e.g., young adults, professionals, hobbyists.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the sentence, such as casual, professional, enthusiastic, or authoritative.", + "required": false, + "defaultValue": "casual" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated sentence in characters, to fit specific use cases like tweets or ads.", + "required": false, + "defaultValue": "140" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional sentence as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need a single, compelling marketing sentence crafted from raw product or service details to quickly generate promotional content tailored to a specific target audience and tone. Ideal for social media posts, ad copy snippets, or headline generation.", + "limitations": "This tool generates only one sentence at a time and does not create full paragraphs or extensive marketing plans. It may not reflect nuanced brand voice details without careful input.", + "examples": [ + "Create a catchy sentence for a new energy drink targeting athletes with an enthusiastic tone.", + "Generate a professional promotional sentence for a software tool aimed at business consultants." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotion", + "sentence generation", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A smartwatch that tracks fitness metrics and monitors heart rate in real-time.\",\"targetAudience\":\"fitness enthusiasts\",\"tone\":\"enthusiastic\",\"maxLength\":120}", + "description": "Generate an enthusiastic marketing sentence for a fitness smartwatch targeting fitness enthusiasts." + }, + { + "inputJson": "{\"productDescription\":\"Cloud-based project management software with collaboration tools.\",\"targetAudience\":\"small business owners\",\"tone\":\"professional\",\"maxLength\":140}", + "description": "Create a professional marketing sentence promoting project management software to small business owners." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Sentence", + "context": null + } + }, + { + "name": "copywriting.createParagraph", + "description": "Generates a compelling marketing paragraph based on provided topic, target audience, tone, and key points. It processes the input to create an engaging piece of promotional text tailored to the brand voice and campaign goals.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or product for the marketing paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the paragraph (e.g., young professionals, tech enthusiasts).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone for the paragraph such as friendly, professional, enthusiastic, or casual.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of key features or benefits to highlight in the paragraph.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the paragraph in words; defaults to 100 words.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing paragraph text." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate engaging marketing paragraphs for products, services, or campaigns. It helps draft promotional content tailored to a specific audience, tone, and message points, streamlining copywriting tasks for marketing teams or automated content generation.", + "limitations": "This tool cannot replace detailed copywriting strategy, deep brand insight, or highly specialized content creation. It may produce generic text if inputs are vague or too broad.", + "examples": [ + "Create a friendly promotional paragraph about a new fitness app for young adults.", + "Generate an enthusiastic paragraph highlighting the eco-friendly features of a product targeting environmentally conscious consumers.", + "Write a professional marketing paragraph about a SaaS platform for corporate clients focusing on security features." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content generation", + "paragraph creation", + "promotional text", + "branding" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Smart Home Security System\",\"targetAudience\":\"homeowners concerned about safety\",\"tone\":\"professional\",\"keyPoints\":[\"24/7 monitoring\",\"easy installation\",\"mobile app access\"],\"maxLength\":80}", + "description": "Generate a professional marketing paragraph about a smart home security system targeting homeowners." + }, + { + "inputJson": "{\"topic\":\"Organic Skincare Line\",\"targetAudience\":\"eco-conscious millennials\",\"tone\":\"enthusiastic\",\"keyPoints\":[\"natural ingredients\",\"cruelty-free\",\"sustainable packaging\"],\"maxLength\":100}", + "description": "Create an enthusiastic paragraph emphasizing the natural and ethical qualities of an organic skincare line for millennials." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "copywriting.createWord", + "description": "Generates a single compelling and contextually appropriate word tailored for marketing and promotional content. Accepts parameters defining the desired tone, industry context, word length, and style preferences to produce an effective, catchy word that fits specific branding or campaign needs.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "The industry or product category the word should relate to (e.g., technology, fashion, food).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The emotional tone or mood of the word (e.g., playful, professional, luxurious).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word.", + "required": false, + "defaultValue": "15" + }, + { + "name": "style", + "type": "string", + "description": "Preferred stylistic attribute of the word (e.g., modern, classic, futuristic).", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language of the generated word (default is English).", + "required": false, + "defaultValue": "English" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word and optional metadata such as reasoning or related keywords." + }, + "aiAgent": { + "useCase": "Use when needing a unique, brand-appropriate word for marketing copy, product names, slogans, or promotional materials to capture the target audience's attention and convey specific brand attributes.", + "limitations": "Cannot guarantee trademark uniqueness or legal clearance; not suitable for generating multi-word phrases or full sentences.", + "examples": [ + "Create a playful word for a children's toy brand.", + "Generate a futuristic-sounding word related to technology.", + "Produce a luxurious one-word brand name for a high-end fashion line." + ] + }, + "tags": [ + "copywriting", + "branding", + "marketing", + "word-generation", + "naming" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"technology\",\"tone\":\"futuristic\",\"maxLength\":10,\"style\":\"modern\",\"language\":\"English\"}", + "description": "Generate a modern, futuristic word up to 10 characters long related to technology." + }, + { + "inputJson": "{\"industry\":\"food\",\"tone\":\"playful\",\"maxLength\":7,\"style\":\"\",\"language\":\"English\"}", + "description": "Create a playful short word related to food industry." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "copywriting.createEvent", + "description": "Creates a compelling marketing copy for an event based on provided details like event name, date, audience, and key highlights. It processes the input attributes to generate engaging promotional text tailored to attract the specified audience, producing ready-to-use event descriptions.", + "category": "copywriting", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The official name of the event to include in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventDate", + "type": "string", + "description": "The date or date range of the event, formatted as a string (e.g., 'June 15-17, 2024').", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "The target audience for the event, such as 'tech professionals' or 'music lovers'.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyHighlights", + "type": "array", + "description": "A list of key features, speakers, or attractions of the event to emphasize in the copy.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the marketing copy, e.g., 'professional', 'casual', 'exciting'.", + "required": false, + "defaultValue": "exciting" + }, + { + "name": "callToAction", + "type": "string", + "description": "A call-to-action phrase to encourage audience engagement, like 'Register now' or 'Join us today'.", + "required": false, + "defaultValue": "Register now" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated event marketing copy as a single string under 'marketingCopy'." + }, + "aiAgent": { + "useCase": "Use this tool when creating promotional content for events where the agent has factual details such as event name, date, audience, and highlights. It helps generate engaging text to attract and inform potential attendees efficiently without manually crafting marketing materials.", + "limitations": "Cannot generate event details or logistics; requires accurate input data to produce relevant copy. Does not replace professional copywriting nuances or deep brand alignment beyond given parameters.", + "examples": [ + "Create an engaging event description for a technology conference happening July 10-12 targeting software developers.", + "Generate a promotional text for a local jazz festival aimed at music enthusiasts with highlights of featured artists.", + "Write a professional event announcement for a corporate summit scheduled in September focused on business leaders." + ] + }, + "tags": [ + "copywriting", + "event", + "marketing", + "promotional text", + "content creation", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"Global Tech Summit 2024\",\"eventDate\":\"July 10-12, 2024\",\"audience\":\"software developers\",\"keyHighlights\":[\"Keynote by industry leaders\",\"Workshops on AI and Blockchain\"],\"tone\":\"exciting\",\"callToAction\":\"Register now\"}", + "description": "Generate exciting marketing copy for a technology summit targeting software developers." + }, + { + "inputJson": "{\"eventName\":\"Downtown Jazz Festival\",\"eventDate\":\"August 5, 2024\",\"audience\":\"music lovers\",\"keyHighlights\":[\"Live performances by top jazz artists\",\"Food and craft beer stalls\"],\"tone\":\"casual\",\"callToAction\":\"Join us today\"}", + "description": "Create casual event copy to promote a local jazz festival for music fans." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "copywriting.createConversion", + "description": "Generates persuasive marketing copy aimed at increasing conversion rates based on specified product details, target audience, and desired call-to-action. Accepts inputs describing product features, target demographic, conversion goals, and tone, then outputs tailored promotional text optimized for conversion.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "List of key features or benefits of the product/service to highlight in the copy.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the ideal audience or customer persona for the campaign.", + "required": true, + "defaultValue": "" + }, + { + "name": "conversionGoal", + "type": "string", + "description": "The specific conversion action the copy should encourage, e.g., sign-ups, purchases, downloads.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The style or tone of the copy, e.g., friendly, professional, urgent.", + "required": false, + "defaultValue": "\"friendly\"" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated copy to fit specific platform constraints.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated conversion-focused marketing copy as a string." + }, + "aiAgent": { + "useCase": "Use this tool when creating marketing content aimed at boosting conversion metrics based on given product and audience details. It helps generate tailored promotional copy that aligns with conversion objectives, saving time and improving message effectiveness.", + "limitations": "This tool generates text based on input parameters but does not validate factual accuracy or guarantee conversion success; it cannot replace professional marketing strategy or human creativity.", + "examples": [ + "Create a persuasive product description for a new fitness app targeting busy professionals to increase free trial sign-ups.", + "Generate an urgent call-to-action copy for a limited-time discount on eco-friendly home products.", + "Write friendly and engaging promotional text for a new book launch aiming to maximize pre-orders." + ] + }, + "tags": [ + "copywriting", + "marketing", + "conversion", + "promotional text", + "advertising", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"SmartHome Thermostat\",\"productFeatures\":[\"Energy saving\",\"Easy installation\",\"Remote control via app\"],\"targetAudience\":\"Homeowners interested in smart technology and energy efficiency\",\"conversionGoal\":\"Purchase\",\"tone\":\"professional\",\"maxLength\":250}", + "description": "Generate professional marketing copy for a smart thermostat appealing to tech-savvy homeowners to encourage purchases." + }, + { + "inputJson": "{\"productName\":\"Yoga Retreat Weekend\",\"productFeatures\":[\"Relaxing environment\",\"Expert instructors\",\"All levels welcome\"],\"targetAudience\":\"Adults seeking stress relief and wellness experiences\",\"conversionGoal\":\"Sign-ups\",\"tone\":\"friendly\",\"maxLength\":200}", + "description": "Create friendly and inviting copy for a yoga retreat promotion targeting adults interested in wellness to boost sign-ups." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Conversion", + "context": null + } + }, + { + "name": "copywriting.createDashboard", + "description": "Generates a compelling marketing copy for an analytics dashboard product by taking product features, target audience, and tone of voice as inputs and producing persuasive promotional text suitable for websites, ads, or brochures.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the analytics dashboard product for which the copy is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "A list of key features or functionalities of the dashboard to highlight in the marketing copy.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended user base or market segment to address in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "toneOfVoice", + "type": "string", + "description": "The desired tone or style for the copy, e.g., professional, casual, innovative, or persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "primaryBenefit", + "type": "string", + "description": "The main benefit or value proposition to emphasize in the marketing text.", + "required": false, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "A phrase or sentence encouraging users to take a specific action, such as sign up or request a demo.", + "required": false, + "defaultValue": "Learn more and get started today!" + } + ], + "returns": { + "type": "object", + "description": "An object containing the crafted marketing copy text for the dashboard product and optionally key highlighted points." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate clear and engaging marketing copy tailored to a specific analytics dashboard product, emphasizing features and benefits for a defined audience. Ideal for creating promotional website content, ad copy, or brochures automatically.", + "limitations": "This tool cannot create graphical dashboard visualizations or actual UI elements; it only generates textual marketing content based on input descriptions. It also depends on the quality of input data for relevance and accuracy.", + "examples": [ + "Create a promotional description for a new dashboard product targeting small business owners, highlighting ease of use and real-time data insights in a casual tone.", + "Generate persuasive copy for an enterprise analytics dashboard focused on security and scalability with a professional tone.", + "Write marketing text for a dashboard with AI-powered predictive analytics aimed at marketing teams." + ] + }, + "tags": [ + "copywriting", + "marketing", + "analytics", + "dashboard", + "textGeneration", + "promotionalContent" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"InsightPro\",\"features\":[\"Real-time data tracking\",\"Customizable reports\",\"Mobile-friendly interface\"],\"targetAudience\":\"small business owners\",\"toneOfVoice\":\"casual\",\"primaryBenefit\":\"Make data-driven decisions easily\",\"callToAction\":\"Sign up for a free trial now!\"}", + "description": "Generate marketing copy for InsightPro targeting small business owners emphasizing ease of data-driven decisions with a casual tone." + }, + { + "inputJson": "{\"productName\":\"SecureAnalytics\",\"features\":[\"Enterprise-grade security\",\"Scalable infrastructure\",\"24/7 customer support\"],\"targetAudience\":\"IT professionals\",\"toneOfVoice\":\"professional\",\"primaryBenefit\":\"Protect your critical business data\",\"callToAction\":\"Request a demo today.\"}", + "description": "Create a professional promotional text for SecureAnalytics aimed at IT professionals highlighting security and scalability." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dashboard", + "context": null + } + }, + { + "name": "copywriting.createTrend", + "description": "Generates a marketing trend report by analyzing input data such as social media keywords, product mentions, or customer feedback. It identifies emerging popular topics, sentiment, and potential marketing angles, producing a concise trend summary and actionable copywriting insights for promotional content.", + "category": "copywriting", + "parameters": [ + { + "name": "dataSource", + "type": "string", + "description": "Source of the input data to analyze (e.g., 'socialMedia', 'productReviews', 'customerSurveys').", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or hashtags to focus the trend analysis on.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeFrameDays", + "type": "number", + "description": "Number of past days to consider for trend analysis.", + "required": false, + "defaultValue": "30" + }, + { + "name": "sentimentAnalysis", + "type": "boolean", + "description": "Whether to perform sentiment analysis on the data to gauge positive or negative trends.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxTrendCount", + "type": "number", + "description": "Maximum number of distinct trends to identify and summarize.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "An object containing identified trends with summaries, sentiment scores, and copywriting suggestions to leverage each trend in marketing." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create marketing-oriented trend reports based on various textual data inputs to inform copywriting and promotional strategies. It helps produce actionable insights from raw data focusing on social media or customer feedback trends.", + "limitations": "Cannot process non-textual data; effectiveness depends on quality and volume of input data; trends are based on recent textual patterns only, no predictive forecasting.", + "examples": [ + "Create a trend report for the past 14 days focused on hashtags related to eco-friendly products from social media sources.", + "Analyze product reviews and identify top 3 emerging customer sentiment trends for copywriting purposes.", + "Generate a marketing trend summary from customer survey comments focusing on wellness and lifestyle keywords." + ] + }, + "tags": [ + "copywriting", + "trend analysis", + "marketing", + "social media", + "sentiment", + "analytics", + "promotion" + ], + "examples": [ + { + "inputJson": "{\"dataSource\":\"socialMedia\",\"keywords\":[\"#sustainability\",\"#greenliving\"],\"timeFrameDays\":14,\"sentimentAnalysis\":true,\"maxTrendCount\":3}", + "description": "Generate a trend report for sustainability-related hashtags on social media over the last 14 days." + }, + { + "inputJson": "{\"dataSource\":\"productReviews\",\"keywords\":[\"durability\",\"battery life\"],\"timeFrameDays\":30,\"sentimentAnalysis\":true,\"maxTrendCount\":2}", + "description": "Identify top 2 trends in product reviews focusing on durability and battery life for copywriting insights." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Trend", + "context": null + } + }, + { + "name": "copywriting.createAnomaly", + "description": "Generates a compelling marketing anomaly report that highlights unusual or unexpected patterns in analytics data. It accepts key anomaly insights and context, then crafts engaging copy to communicate these unique findings effectively to stakeholders or marketing audiences.", + "category": "copywriting", + "parameters": [ + { + "name": "anomalyDescription", + "type": "string", + "description": "Detailed description of the anomaly or unusual pattern detected in analytics data", + "required": true, + "defaultValue": "" + }, + { + "name": "contextData", + "type": "object", + "description": "Supplementary details or metrics related to the anomaly, such as time frame, affected segments, or key figures", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience type for the copy, e.g., marketing team, executives, or customers", + "required": false, + "defaultValue": "marketing team" + }, + { + "name": "tone", + "type": "string", + "description": "Writing tone for the copy, for example: formal, casual, enthusiastic, or urgent", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the output copy in words", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text emphasizing the anomaly and its significance" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to translate complex or technical anomaly data from analytics into clear, engaging, and audience-tailored marketing or internal communication copy. It is ideal for highlighting unusual trends or data points in newsletters, reports, or campaign materials.", + "limitations": "Cannot analyze raw data itself; requires pre-processed anomaly insights as input. Does not generate visualizations or perform statistical anomaly detection.", + "examples": [ + "Create a brief report copy explaining an unexpected sales spike last quarter for the executive team with a formal tone.", + "Generate engaging marketing text describing a sudden increase in user activity for customers with an enthusiastic tone.", + "Write a concise internal update about a drop in website traffic detected last week for the marketing team in a casual tone." + ] + }, + "tags": [ + "copywriting", + "analytics", + "anomaly", + "marketing", + "reporting", + "communication" + ], + "examples": [ + { + "inputJson": "{\"anomalyDescription\":\"A 40% increase in product sign-ups in the last 7 days compared to the previous month.\",\"contextData\":{\"timeFrame\":\"last 7 days\",\"comparisonPeriod\":\"previous month\",\"keyMetric\":\"sign-ups\"},\"audience\":\"executive team\",\"tone\":\"formal\",\"length\":120}", + "description": "Generate formal marketing copy for executives highlighting a significant increase in product sign-ups." + }, + { + "inputJson": "{\"anomalyDescription\":\"A sudden 25% drop in website traffic from social media referrals.\",\"contextData\":{\"timeFrame\":\"last week\",\"affectedSegment\":\"social media referrals\",\"metric\":\"website visits\"},\"audience\":\"marketing team\",\"tone\":\"casual\",\"length\":100}", + "description": "Create casual internal communication copy explaining a drop in website traffic from social media." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Anomaly", + "context": null + } + }, + { + "name": "copywriting.createSession", + "description": "Creates a copywriting session summary by accepting session analytics data such as visitor behavior, engagement metrics, and timeframe to generate a marketing-focused report that highlights key insights for promotional content optimization.", + "category": "copywriting", + "parameters": [ + { + "name": "sessionId", + "type": "string", + "description": "Unique identifier for the analytics session to summarize", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 start time for the session analytics period", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 end time for the session analytics period", + "required": true, + "defaultValue": "" + }, + { + "name": "engagementMetrics", + "type": "array", + "description": "List of engagement metric names to include such as clicks, scroll depth, or time on page", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudienceDescription", + "type": "string", + "description": "Brief description of the target audience for tailoring the session summary", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a summarized marketing session report with key analytics insights and recommendations for promotional copywriting." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a concise, marketing-oriented summary of a given analytics session including visitor behavior and engagement metrics, to inform copywriting strategies or content optimization. It is ideal for creating quick syntheses from raw session data focusing on promotional improvement.", + "limitations": "This tool does not perform raw data analytics or collect session data itself; it requires pre-processed analytics input for summary generation. It cannot customize complex analytics reports beyond engagement metrics or replace detailed data analysis tools.", + "examples": [ + "Generate a marketing summary report for session ID 'sess123' from last week focusing on click rates and scroll depth.", + "Create an engagement overview for session 'sess987' including time on page and audience description 'young professionals.'" + ] + }, + "tags": [ + "copywriting", + "analytics", + "session", + "marketing", + "summary", + "engagement", + "content optimization" + ], + "examples": [ + { + "inputJson": "{\"sessionId\":\"sess123\",\"startTime\":\"2024-05-01T00:00:00Z\",\"endTime\":\"2024-05-01T23:59:59Z\",\"engagementMetrics\":[\"clicks\",\"scrollDepth\"],\"targetAudienceDescription\":\"millennial tech users\"}", + "description": "Create a marketing-focused session summary for specified engagement metrics and a defined audience." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Session", + "context": null + } + }, + { + "name": "copywriting.createCache", + "description": "Generates persuasive and clear marketing copy for promoting caching infrastructure solutions. Accepts inputs about cache types, benefits, target audience, and usage scenarios, then creates tailored promotional text to highlight cache advantages in software infrastructure.", + "category": "copywriting", + "parameters": [ + { + "name": "cacheType", + "type": "string", + "description": "Type of cache to promote (e.g., Redis, Memcached, CDN cache).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the copy (e.g., software developers, CTOs, infrastructure engineers).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyBenefits", + "type": "array", + "description": "List of main benefits to highlight (e.g., reduced latency, scalability, cost savings).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "usageScenario", + "type": "string", + "description": "Specific use case or scenario where the cache is applied (e.g., real-time analytics, web acceleration).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the copywriting (e.g., professional, friendly, technical).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated copy.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text under the key 'marketingCopy'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce effective, domain-specific marketing content to promote cache infrastructure products or solutions. Especially useful for software companies looking to create tailored promotional materials or website content that highlights cache advantages for targeted audiences.", + "limitations": "This tool does not generate technical documentation or deep technical explanations; it focuses solely on promotional marketing copy. It cannot replace detailed architecture or implementation guides.", + "examples": [ + "Generate a short promotional paragraph for Redis cache targeting CTOs highlighting scalability and cost savings.", + "Create friendly tone copy to promote CDN cache for web developers focusing on latency reduction and reliability." + ] + }, + "tags": [ + "copywriting", + "marketing", + "infrastructure", + "cache", + "promotion", + "technology" + ], + "examples": [ + { + "inputJson": "{\"cacheType\":\"Redis\",\"targetAudience\":\"CTOs\",\"keyBenefits\":[\"scalability\",\"cost savings\"],\"usageScenario\":\"real-time analytics\",\"tone\":\"professional\",\"maxLength\":250}", + "description": "Professional marketing copy for Redis cache targeting CTOs emphasizing scalability and cost savings in real-time analytics." + }, + { + "inputJson": "{\"cacheType\":\"CDN cache\",\"targetAudience\":\"web developers\",\"keyBenefits\":[\"latency reduction\",\"reliability\"],\"tone\":\"friendly\",\"maxLength\":150}", + "description": "Friendly promotional text for CDN cache targeting web developers focusing on latency reduction and reliability." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cache", + "context": null + } + }, + { + "name": "copywriting.createMetric", + "description": "Generates a custom marketing or promotional metric definition based on input parameters such as campaign goals, target audience, and performance indicators. Accepts details about the marketing context and outputs a well-defined metric description along with how to calculate it, enabling better performance tracking for copywriting efforts.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignGoal", + "type": "string", + "description": "The main objective of the marketing campaign (e.g., brand awareness, lead generation).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the campaign (e.g., young adults, B2B professionals).", + "required": true, + "defaultValue": "" + }, + { + "name": "performanceIndicators", + "type": "array", + "description": "List of relevant measurable indicators to include in the metric (e.g., click-through rate, conversion rate).", + "required": true, + "defaultValue": "" + }, + { + "name": "timeFrame", + "type": "string", + "description": "The period over which the metric should be evaluated (e.g., monthly, quarterly).", + "required": false, + "defaultValue": "monthly" + }, + { + "name": "includeBenchmark", + "type": "boolean", + "description": "Whether to include benchmarking information or industry standards in the metric description.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the metric name, detailed description, calculation method, and optional benchmarking information." + }, + "aiAgent": { + "useCase": "Use this tool when you need to define clear, actionable marketing metrics tailored to specific campaign goals and audiences. It assists in creating meaningful metrics for copywriting performance measurement, enabling data-driven optimization.", + "limitations": "It cannot fetch real-time data or perform metric calculations on actual campaign data; it only generates metric definitions and calculation methods based on input parameters.", + "examples": [ + "Create a metric for measuring conversion rate from a digital ad campaign targeting young adults aiming at lead generation.", + "Generate a brand awareness metric definition for a B2B campaign targeting professionals with benchmarking included.", + "Define a metric to track email campaign engagement over a quarterly period focusing on click-through and open rates." + ] + }, + "tags": [ + "copywriting", + "marketing", + "metrics", + "analytics", + "campaign", + "performance", + "measurement" + ], + "examples": [ + { + "inputJson": "{\"campaignGoal\":\"lead generation\",\"targetAudience\":\"young adults\",\"performanceIndicators\":[\"conversion rate\",\"click-through rate\"],\"timeFrame\":\"monthly\",\"includeBenchmark\":true}", + "description": "Generate a metric focused on lead generation for young adults including benchmarking details." + }, + { + "inputJson": "{\"campaignGoal\":\"brand awareness\",\"targetAudience\":\"B2B professionals\",\"performanceIndicators\":[\"impressions\",\"engagement rate\"],\"includeBenchmark\":false}", + "description": "Define a brand awareness metric for B2B professional audience without benchmarking." + }, + { + "inputJson": "{\"campaignGoal\":\"email engagement\",\"targetAudience\":\"existing customers\",\"performanceIndicators\":[\"open rate\",\"click rate\"],\"timeFrame\":\"quarterly\",\"includeBenchmark\":true}", + "description": "Create an email campaign engagement metric over a quarterly timeframe including benchmark info." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Metric", + "context": null + } + }, + { + "name": "copywriting.createQueue", + "description": "This tool generates a creative marketing copy for promoting a queue management system or infrastructure. It accepts input such as the type of queue system, target audience, purpose, and desired tone, then crafts persuasive, clear promotional text to effectively communicate the queue's benefits and features.", + "category": "copywriting", + "parameters": [ + { + "name": "queueType", + "type": "string", + "description": "Type of queue system to promote, e.g., customer support, task processing, checkout line.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Primary audience for the promotional copy, such as business managers, IT professionals, or end consumers.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of main features or benefits of the queue system to highlight.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "toneStyle", + "type": "string", + "description": "Desired tone for the copy, e.g., professional, friendly, urgent, playful.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the promotional copy in words.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text under the 'marketingCopy' field." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create tailored marketing or promotional content focused on queue management solutions or infrastructure. Helpful for generating engaging, audience-appropriate copy that highlights system benefits and features for sales or informational purposes.", + "limitations": "This tool does not generate technical documentation, detailed product specifications, or scripts for UI interactions. It focuses solely on persuasive marketing text generation.", + "examples": [ + "Create a friendly marketing paragraph promoting a customer support queue to small business owners.", + "Write a professional 100-word advertisement for a task processing queue targeting IT managers.", + "Generate a playful promo text highlighting benefits of a checkout line queue for retail customers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "queue", + "promotional text", + "infrastructure", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"queueType\":\"customer support\",\"targetAudience\":\"small business owners\",\"keyFeatures\":[\"reduces wait time\",\"improves customer satisfaction\",\"easy to integrate\"],\"toneStyle\":\"friendly\",\"length\":100}", + "description": "Create a friendly promo marketing text for a customer support queue aimed at small business owners." + }, + { + "inputJson": "{\"queueType\":\"task processing\",\"targetAudience\":\"IT managers\",\"keyFeatures\":[\"automated task assignment\",\"scalable\",\"real-time monitoring\"],\"toneStyle\":\"professional\",\"length\":120}", + "description": "Generate a professional marketing copy for a task processing queue targeting IT managers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Queue", + "context": null + } + }, + { + "name": "copywriting.createService", + "description": "Generates tailored promotional and marketing copy for technology services based on service descriptors provided. Takes inputs describing the target audience, key features, benefits, and tone to produce professional, engaging service descriptions usable for websites, brochures, or advertising.", + "category": "copywriting", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The name of the service to create promotional copy for.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or customer segment for the service.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of important features or capabilities of the service.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "benefits", + "type": "array", + "description": "List of primary benefits or value propositions for customers.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., professional, casual, persuasive, technical.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated copy in characters.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated service promotional text under the 'promotionalCopy' key." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate clear, persuasive, and tailored marketing copy for technology or infrastructure-related services, helping to craft engaging service descriptions for websites, sales materials, or ads. It is ideal when you have service details and want professional copy without manual writing.", + "limitations": "This tool focuses only on copywriting and cannot generate technical documentation, code, or complex marketing strategies. It relies on quality input and does not verify factual accuracy beyond provided descriptions.", + "examples": [ + "Create a promotional description for a cloud backup service targeting SMBs emphasizing security and simplicity in a friendly tone.", + "Generate marketing copy for a managed Kubernetes service highlighting scalability and expert support for enterprise customers.", + "Write service copy for a 5G network infrastructure service focusing on speed and reliability with a professional tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "service description", + "promotion", + "technology", + "infrastructure", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"CloudSecure Backup\",\"targetAudience\":\"Small and Medium Businesses\",\"keyFeatures\":[\"End-to-end encryption\",\"Automatic daily backups\",\"Unlimited storage\"],\"benefits\":[\"Protect business data from loss\",\"Easy recovery in case of disaster\"],\"tone\":\"friendly\",\"maxLength\":450}", + "description": "Generate friendly marketing copy for a cloud backup service targeted at SMBs, focusing on security and ease of use." + }, + { + "inputJson": "{\"serviceName\":\"KubeSmart Managed Service\",\"targetAudience\":\"Enterprise IT teams\",\"keyFeatures\":[\"Automated scaling\",\"24/7 expert support\",\"Seamless cluster upgrades\"],\"benefits\":[\"Reduce operational overhead\",\"Ensure high availability\"],\"tone\":\"professional\"}", + "description": "Create professional promotional text for a managed Kubernetes service emphasizing scalability and support." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Service", + "context": null + } + }, + { + "name": "copywriting.createCluster", + "description": "Generates a cohesive and logically grouped cluster of marketing copy components centered on a specific infrastructure topic or product, integrating keywords, taglines, and thematic content to support SEO and promotional efforts. Accepts a primary infrastructure theme and related keywords, and outputs an organized cluster of copy elements.", + "category": "copywriting", + "parameters": [ + { + "name": "primaryTheme", + "type": "string", + "description": "The main infrastructure topic or product around which the copy cluster is created.", + "required": true, + "defaultValue": "" + }, + { + "name": "relatedKeywords", + "type": "array", + "description": "List of related keywords to include throughout the cluster to enhance SEO relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor tone and style of the copy cluster.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., professional, casual, tech-savvy. Defaults to professional.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "clusterSize", + "type": "number", + "description": "Number of copy elements (e.g., taglines, summaries, bullet points) to generate in the cluster. Defaults to 5.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "An object representing a cluster of copy items, each including title, description, and relevant keywords to support infrastructure marketing campaigns." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce a coherent set of related marketing text snippets about an infrastructure product or domain to improve SEO and campaign cohesion. It helps in creating interconnected copy elements for landing pages, ads, or content hubs.", + "limitations": "Cannot generate fully finalized marketing content without human review; does not perform graphic design or full content strategy planning.", + "examples": [ + "Create an SEO copy cluster for a cloud hosting service emphasizing reliability and scalability.", + "Generate a cluster of promotional taglines and descriptions for a new data center infrastructure, targeting IT managers.", + "Produce a set of related marketing phrases and summaries for a container orchestration platform with a casual tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "infrastructure", + "SEO", + "cluster", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"primaryTheme\":\"Cloud hosting service\",\"relatedKeywords\":[\"reliability\",\"scalability\",\"24/7 support\"],\"targetAudience\":\"SMB IT managers\",\"tone\":\"professional\",\"clusterSize\":4}", + "description": "Cluster for cloud hosting featuring reliability, scalability for SMB IT managers" + }, + { + "inputJson": "{\"primaryTheme\":\"Data center infrastructure\",\"relatedKeywords\":[\"security\",\"high availability\"],\"targetAudience\":\"enterprise IT executives\",\"tone\":\"formal\",\"clusterSize\":3}", + "description": "Professional cluster emphasizing security and availability for data centers" + }, + { + "inputJson": "{\"primaryTheme\":\"Container orchestration platform\",\"relatedKeywords\":[\"automation\",\"Kubernetes\",\"DevOps\"],\"targetAudience\":\"DevOps engineers\",\"tone\":\"casual\",\"clusterSize\":5}", + "description": "Casual tone cluster targeting DevOps engineers for container orchestration" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cluster", + "context": null + } + }, + { + "name": "copywriting.createReply", + "description": "Generates a tailored reply message based on the original incoming message and contextual details. Accepts the received message content and optional tone, language, and purpose parameters, then crafts an appropriate and coherent response suitable for professional or casual communication.", + "category": "copywriting", + "parameters": [ + { + "name": "originalMessage", + "type": "string", + "description": "The text of the incoming message that requires a reply.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the reply, such as formal, casual, friendly, or professional.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the reply (e.g., 'en' for English, 'es' for Spanish).", + "required": false, + "defaultValue": "en" + }, + { + "name": "purpose", + "type": "string", + "description": "The intent behind the reply, such as answering questions, providing information, or expressing gratitude.", + "required": false, + "defaultValue": "" + }, + { + "name": "recipientType", + "type": "string", + "description": "Type of recipient like customer, colleague, or manager to tailor the reply accordingly.", + "required": false, + "defaultValue": "customer" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated reply text suitable for sending back as a response." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a context-aware and appropriately toned reply message to an incoming communication. Ideal for automating responses to customer inquiries, internal messages, or other communications requiring clear, polite, and tailored replies.", + "limitations": "This tool generates text based on input context but does not analyze or verify factual accuracy of the content. Human review might be needed for sensitive or critical communications.", + "examples": [ + "Generate a polite customer service reply in English with a friendly tone.", + "Create a formal reply to a colleague's technical inquiry.", + "Write a brief thank you reply to a customer feedback message." + ] + }, + "tags": [ + "copywriting", + "reply", + "communication", + "customer service", + "email", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"originalMessage\":\"Thank you for your help with the project last week.\",\"tone\":\"friendly\",\"purpose\":\"express gratitude\",\"language\":\"en\"}", + "description": "Generate a friendly thank you reply to express gratitude." + }, + { + "inputJson": "{\"originalMessage\":\"Can you provide the latest sales report?\",\"tone\":\"formal\",\"purpose\":\"provide information\",\"recipientType\":\"colleague\"}", + "description": "Create a formal reply providing information to a colleague's request." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reply", + "context": null + } + }, + { + "name": "copywriting.createDatabase", + "description": "This tool generates persuasive and clear copywriting text aimed at promoting and explaining database infrastructure products or services. It accepts inputs such as the database type, key features, target audience, and marketing tone, processes these to create engaging marketing content suitable for websites, brochures, or pitches, and outputs polished promotional text tailored to the given parameters.", + "category": "copywriting", + "parameters": [ + { + "name": "databaseType", + "type": "string", + "description": "Type of database to focus the copywriting on (e.g., SQL, NoSQL, graph, cloud database)", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of important features or selling points of the database product or service", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Primary audience for the marketing text, such as developers, CTOs, or business users", + "required": false, + "defaultValue": "technical and business professionals" + }, + { + "name": "marketingTone", + "type": "string", + "description": "Tone of the copywriting text, like professional, casual, innovative, or trustworthy", + "required": false, + "defaultValue": "professional" + }, + { + "name": "lengthLimit", + "type": "number", + "description": "Maximum length of the generated marketing text in words", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text for the database product or service, ready for use in promotional materials." + }, + "aiAgent": { + "useCase": "Use this tool when tasked with creating high-quality marketing content that highlights the features and benefits of database infrastructure products. It is especially useful for promotional writing that requires tailoring to a specific audience or marketing tone, helping automate copy generation for websites, brochures, or presentations.", + "limitations": "This tool does not generate technical documentation, implementation guides, or detailed product specifications. It focuses only on promotional and marketing style text.", + "examples": [ + "Create marketing copy for a cloud-based NoSQL database highlighting scalability and security for CTOs in a trustworthy tone.", + "Generate promotional text focused on a new graph database's unique querying capabilities for software developers with an innovative tone.", + "Write brief marketing content about key-value store database emphasizing performance and reliability in a casual tone for business users." + ] + }, + "tags": [ + "copywriting", + "database", + "marketing", + "promotional text", + "infrastructure", + "content generation", + "technology" + ], + "examples": [ + { + "inputJson": "{\"databaseType\":\"NoSQL\",\"keyFeatures\":[\"scalability\",\"high availability\",\"flexible data model\"],\"targetAudience\":\"CTOs and software architects\",\"marketingTone\":\"trusted and professional\",\"lengthLimit\":120}", + "description": "Marketing text promoting a NoSQL database focusing on scalability and availability for CTOs." + }, + { + "inputJson": "{\"databaseType\":\"graph database\",\"keyFeatures\":[\"advanced relationship queries\",\"visual data exploration\",\"real-time analytics\"],\"targetAudience\":\"data scientists\",\"marketingTone\":\"innovative\",\"lengthLimit\":100}", + "description": "Copy highlighting the innovative features of a graph database for data scientists." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Database", + "context": null + } + }, + { + "name": "copywriting.createChannel", + "description": "Generates engaging and tailored copy for communication channels like email newsletters, social media posts, or SMS campaigns based on specified channel type, audience profile, tone, and message goals. Accepts input parameters defining channel characteristics and outputs optimized marketing text suitable for that channel.", + "category": "copywriting", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of communication channel (e.g., 'email', 'socialMedia', 'SMS') for which the copy is created.", + "required": true, + "defaultValue": "" + }, + { + "name": "audienceProfile", + "type": "string", + "description": "Brief description of the target audience including demographics, interests, or behaviors.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the message such as 'friendly', 'professional', 'urgent', or 'casual'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "messageGoal", + "type": "string", + "description": "Primary goal of the message, e.g., 'promote a sale', 'announce a new product', or 'drive website traffic'.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call to action to include in the copy, like 'Sign up now' or 'Learn more'.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the output copy, e.g., 'en' for English. Defaults to English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated copy in characters. If omitted, no length limit is applied.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated copy text optimized for the specified communication channel." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create channel-specific marketing copy tailored to a defined audience profile and communication tone, ensuring message relevance and channel appropriateness. Ideal for automating generation of promotional content like email campaign body text, social media posts, or SMS messages.", + "limitations": "This tool does not generate visual content or handle multi-channel integration workflows. It cannot verify compliance with legal or platform-specific regulations on its own and may require human review for sensitive contexts.", + "examples": [ + "Create a friendly email newsletter promoting a new product launch for young adults interested in fitness.", + "Generate a concise and urgent SMS message to notify customers about a flash sale.", + "Write a casual social media post for millennials announcing a webinar with a signup call to action." + ] + }, + "tags": [ + "copywriting", + "marketing", + "channel-specific", + "content generation", + "automation", + "promotional", + "communication" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"email\",\"audienceProfile\":\"Young professionals interested in tech gadgets\",\"tone\":\"professional\",\"messageGoal\":\"promote a new smartwatch launch\",\"callToAction\":\"Pre-order now\",\"language\":\"en\",\"maxLength\":300}", + "description": "Generate a professional email promoting a smartwatch launch targeting young tech-savvy adults with a pre-order CTA." + }, + { + "inputJson": "{\"channelType\":\"socialMedia\",\"audienceProfile\":\"Millennials active on Instagram\",\"tone\":\"casual\",\"messageGoal\":\"announce a summer sale\",\"callToAction\":\"Shop today!\",\"language\":\"en\"}", + "description": "Create a casual Instagram post announcing a summer sale with a shopping CTA geared to millennial users." + }, + { + "inputJson": "{\"channelType\":\"SMS\",\"audienceProfile\":\"Subscribers in New York interested in dining offers\",\"tone\":\"urgent\",\"messageGoal\":\"notify about a limited-time discount\",\"callToAction\":\"Reserve a table\",\"language\":\"en\",\"maxLength\":160}", + "description": "Generate an urgent SMS message notifying subscribers of a limited-time dining discount with a reservation CTA." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Channel", + "context": null + } + }, + { + "name": "copywriting.createServer", + "description": "Generates engaging marketing copy to promote server infrastructure products or services. Accepts inputs describing the server's key features, target audience, tone, and purpose, then crafts persuasive text aimed at driving user interest and sales. Outputs polished promotional content tailored to specified marketing needs.", + "category": "copywriting", + "parameters": [ + { + "name": "serverName", + "type": "string", + "description": "Name of the server or server product to promote", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "List of key features and benefits of the server infrastructure", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or customer persona", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., professional, casual, persuasive", + "required": false, + "defaultValue": "professional" + }, + { + "name": "useCase", + "type": "string", + "description": "Primary use case or purpose of the server product", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated copy in characters", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a 'marketingCopy' string field containing the generated promotional text" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create tailored marketing copy for server infrastructure products based on features, audience, and tone. It helps automate content creation for marketing campaigns, websites, or sales collateral.", + "limitations": "This tool cannot generate highly technical documentation, user manuals, or detailed specifications. It focuses purely on marketing and promotional language.", + "examples": [ + "Create a persuasive product description for a cloud server targeting startups with a casual tone.", + "Generate concise marketing copy highlighting security features of an enterprise server for IT professionals.", + "Write engaging content for a new gaming server product aimed at gamers using a lively tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "server", + "infrastructure", + "promotion", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"serverName\":\"CloudX Pro\",\"features\":[\"99.99% uptime\",\"Scalable resources\",\"24/7 customer support\"],\"targetAudience\":\"startup tech companies\",\"tone\":\"casual\",\"useCase\":\"cloud computing platform\",\"maxLength\":300}", + "description": "Generate casual promotional copy for CloudX Pro server targeted at startup companies highlighting reliability and support." + }, + { + "inputJson": "{\"serverName\":\"SecureCore 5000\",\"features\":[\"Advanced encryption\",\"Multi-factor authentication\",\"Automated security updates\"],\"targetAudience\":\"IT security professionals\",\"tone\":\"professional\",\"useCase\":\"enterprise security servers\",\"maxLength\":400}", + "description": "Create professional marketing content emphasizing the security features of SecureCore 5000 for IT experts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Server", + "context": null + } + }, + { + "name": "copywriting.createInstance", + "description": "This tool generates tailored marketing copywriting content for cloud infrastructure service instances. It accepts inputs describing instance features such as type, size, region, and target audience, then produces professionally written promotional text that highlights key benefits and use cases for the specified instance configuration.", + "category": "copywriting", + "parameters": [ + { + "name": "instanceType", + "type": "string", + "description": "The type of the infrastructure instance (e.g., virtual machine, container, database).", + "required": true, + "defaultValue": "" + }, + { + "name": "instanceSize", + "type": "string", + "description": "The size or tier of the instance (e.g., small, medium, large, or specific resource allocation).", + "required": true, + "defaultValue": "" + }, + { + "name": "region", + "type": "string", + "description": "The geographic region or data center location of the instance (e.g., US-East, Europe-West).", + "required": false, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the marketing copy (e.g., startups, enterprise, developers).", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key technical or business features to emphasize in the copy (e.g., high availability, cost efficiency).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone for the copywriting (e.g., professional, casual, persuasive).", + "required": false, + "defaultValue": "professional" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text for the instance." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate compelling, customized marketing copy for cloud infrastructure instances based on specified features and audience. It helps create engaging promotional text suitable for product pages, brochures, or ads in technology marketing contexts.", + "limitations": "This tool cannot generate highly technical documentation or detailed specifications. It focuses on marketing-oriented language and does not replace technical writing or compliance-related texts.", + "examples": [ + "Create promotional copy for a large virtual machine in US-East targeting startups highlighting cost efficiency and scalability.", + "Generate persuasive instance description for a small container in Europe-West aimed at developers emphasizing ease of deployment.", + "Produce professional marketing content for a medium database instance targeting enterprise clients focusing on high availability and security features." + ] + }, + "tags": [ + "copywriting", + "marketing", + "infrastructure", + "cloud", + "instance", + "promotion", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"instanceType\":\"virtual machine\",\"instanceSize\":\"large\",\"region\":\"US-East\",\"targetAudience\":\"startups\",\"keyFeatures\":[\"cost efficiency\",\"scalability\"],\"tone\":\"persuasive\"}", + "description": "Generate persuasive marketing copy for a large virtual machine in US-East for startups focusing on cost efficiency and scalability." + }, + { + "inputJson": "{\"instanceType\":\"container\",\"instanceSize\":\"small\",\"region\":\"Europe-West\",\"targetAudience\":\"developers\",\"keyFeatures\":[\"ease of deployment\"],\"tone\":\"casual\"}", + "description": "Create casual tone marketing copy for a small container instance in Europe-West highlighting ease of deployment for developers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Instance", + "context": null + } + }, + { + "name": "copywriting.createContainer", + "description": "Generates persuasive marketing copy describing container infrastructure solutions. Accepts input parameters detailing container technology features, target audience, and tone, then produces tailored promotional text suitable for websites, brochures, or ads that highlight the value and benefits of container platforms.", + "category": "copywriting", + "parameters": [ + { + "name": "containerType", + "type": "string", + "description": "Type of container infrastructure to promote, e.g., Docker, Kubernetes, or OpenShift.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the marketing copy, such as developers, CIOs, or DevOps teams.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of main features or advantages of the container platform to highlight in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the marketing text, e.g., professional, casual, or enthusiastic.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "outputLength", + "type": "number", + "description": "Approximate number of words for the created marketing text.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy text under a 'marketingCopy' key." + }, + "aiAgent": { + "useCase": "When an AI agent needs to produce targeted marketing content for container infrastructure products or services, this tool creates clear, persuasive copy customized by container type, audience, and tone to facilitate promotional materials generation.", + "limitations": "This tool does not generate technical manuals, purely factual datasheets, or code snippets; it focuses on marketing text only.", + "examples": [ + "Create a compelling ad copy for Kubernetes targeting DevOps engineers with an enthusiastic tone.", + "Generate website copy highlighting Docker's scalability features for CIOs in a professional tone.", + "Write a concise brochure description of OpenShift aimed at developers emphasizing key security benefits." + ] + }, + "tags": [ + "copywriting", + "marketing", + "container", + "infrastructure", + "promotional text", + "technology", + "DevOps", + "cloud" + ], + "examples": [ + { + "inputJson": "{\"containerType\":\"Kubernetes\",\"targetAudience\":\"DevOps engineers\",\"keyFeatures\":[\"scalability\",\"automated deployment\",\"open-source\"],\"tone\":\"enthusiastic\",\"outputLength\":120}", + "description": "Generate energetic marketing copy for Kubernetes focusing on key benefits for DevOps engineers." + }, + { + "inputJson": "{\"containerType\":\"Docker\",\"targetAudience\":\"CIOs\",\"keyFeatures\":[\"portability\",\"security\",\"ecosystem\"],\"tone\":\"professional\",\"outputLength\":150}", + "description": "Create professional marketing text emphasizing Docker's advantages for CIO-level decision makers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "copywriting.createComment", + "description": "Generates a concise and engaging comment for marketing or communication purposes based on the input topic, tone, and target audience. Accepts text inputs describing the context and desired sentiment, processes the information using natural language generation techniques, and outputs a polished comment suitable for social media, blogs, or promotional materials.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or content the comment should address.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the comment, e.g., friendly, professional, enthusiastic.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the comment to tailor the language and style accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the comment in characters; helps keep messages concise.", + "required": false, + "defaultValue": "280" + }, + { + "name": "includeHashtags", + "type": "boolean", + "description": "Whether to include relevant hashtags to improve reach or engagement.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated comment text and optional metadata like length and hashtags." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to create engaging and contextually appropriate comments for marketing campaigns, social media posts, or communication channels. It helps produce concise comments that fit a desired tone and audience, enhancing interaction and promotion effectiveness.", + "limitations": "It cannot produce deeply technical or confidential comments without proper context. Generated comments may need human review for brand voice compliance and cultural nuances.", + "examples": [ + "Generate a friendly comment promoting a new eco-friendly product.", + "Create a professional comment for a B2B software announcement targeting IT managers.", + "Write a short enthusiastic comment for a social media post about a summer sale including hashtags." + ] + }, + "tags": [ + "copywriting", + "comment", + "marketing", + "social media", + "communication", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Launch of our new sustainable packaging line\",\"tone\":\"enthusiastic\",\"targetAudience\":\"environmentally conscious consumers\",\"maxLength\":200,\"includeHashtags\":true}", + "description": "Generate an enthusiastic comment promoting a new eco-friendly packaging product with hashtags." + }, + { + "inputJson": "{\"topic\":\"Upcoming webinar on cybersecurity best practices\",\"tone\":\"professional\",\"targetAudience\":\"IT professionals\",\"maxLength\":150,\"includeHashtags\":false}", + "description": "Create a professional comment inviting IT professionals to a webinar without hashtags." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Comment", + "context": null + } + }, + { + "name": "copywriting.createMention", + "description": "Generates a customized, engaging mention or shout-out text for marketing and promotional communications. Accepts inputs describing the person, brand, or entity to mention, the context or platform, tone style, and additional keywords to tailor the mention. Produces relevant, professional mention text ready for use in social media, blogs, or ads.", + "category": "copywriting", + "parameters": [ + { + "name": "mentionEntity", + "type": "string", + "description": "The name of the person, brand, product, or entity to mention in the text.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "The communication context such as social media post, blog, email newsletter, or advertisement.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the mention text, e.g., casual, professional, enthusiastic, or formal.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "keywords", + "type": "array", + "description": "Additional keywords or attributes to incorporate into the mention for relevance and SEO purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated mention text to fit platform limits.", + "required": false, + "defaultValue": "280" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated mention text string optimized for the given inputs." + }, + "aiAgent": { + "useCase": "Use this tool when generating short, targeted promotional or recognition mentions for individuals, brands, products, or services tailored to the intended platform and tone. Ideal for marketing campaigns, social media engagement posts, influencer shout-outs, or brand awareness efforts.", + "limitations": "This tool does not generate long-form copy or detailed descriptive content. It focuses on concise mention text and cannot handle complex narratives or factual verification beyond given inputs.", + "examples": [ + "Create a warm, casual mention for a new tech startup for Twitter.", + "Generate a professional mention to recognize a collaborator in a newsletter.", + "Produce an enthusiastic shout-out featuring product features for an Instagram post." + ] + }, + "tags": [ + "copywriting", + "marketing", + "mention", + "promotion", + "social media", + "branding", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"mentionEntity\":\"EcoBright Solar\",\"context\":\"social media post\",\"tone\":\"enthusiastic\",\"keywords\":[\"renewable energy\",\"sustainability\"],\"maxLength\":140}", + "description": "Generate an enthusiastic mention for EcoBright Solar emphasizing renewable energy in a social media post." + }, + { + "inputJson": "{\"mentionEntity\":\"Anna Smith\",\"context\":\"email newsletter\",\"tone\":\"professional\",\"keywords\":[\"collaboration\",\"teamwork\"],\"maxLength\":300}", + "description": "Create a professional mention recognizing Anna Smith's collaboration for an email newsletter." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Mention", + "context": null + } + }, + { + "name": "copywriting.createThread", + "description": "Generates a structured communication thread by creating a series of engaging, topic-coherent messages. Accepts inputs such as topic, audience profile, thread length, and style preferences, then produces a sequence of connected messages suitable for social media or forum discussions.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the thread to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "audienceProfile", + "type": "string", + "description": "Description of the target audience to tailor tone and content appropriately.", + "required": false, + "defaultValue": "" + }, + { + "name": "threadLength", + "type": "number", + "description": "Number of messages or posts to generate in the thread.", + "required": false, + "defaultValue": "5" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the thread messages, e.g., formal, casual, humorous.", + "required": false, + "defaultValue": "casual" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action in the final message of the thread.", + "required": false, + "defaultValue": "true" + }, + { + "name": "platform", + "type": "string", + "description": "Intended platform for the thread, which may affect style and format (e.g. Twitter, Reddit).", + "required": false, + "defaultValue": "Twitter" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated thread as an ordered array of messages, each with message content and metadata like message number and suggested hashtags if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a multi-message communication thread for marketing or promotional purposes, targeting specific audience segments and platforms to maximize engagement.", + "limitations": "Cannot guarantee platform-specific compliance such as length limits or community guidelines; generated content may require human review before publication.", + "examples": [ + "Create a Twitter thread of 7 messages about the benefits of electric vehicles for environmentally conscious millennials.", + "Generate a casual Reddit discussion thread on the topic of home workouts during winter targeting fitness enthusiasts.", + "Produce a LinkedIn thread consisting of 5 professional messages highlighting the latest trends in AI technology for business executives." + ] + }, + "tags": [ + "copywriting", + "thread", + "social media", + "marketing", + "content creation", + "communication", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of Electric Vehicles\",\"audienceProfile\":\"Environmentally conscious millennials\",\"threadLength\":7,\"tone\":\"informative\",\"includeCallToAction\":true,\"platform\":\"Twitter\"}", + "description": "Create a 7-message Twitter thread launching an informative discussion about electric vehicles targeting millennials interested in sustainability." + }, + { + "inputJson": "{\"topic\":\"Home Workouts in Winter\",\"audienceProfile\":\"Fitness enthusiasts\",\"threadLength\":5,\"tone\":\"casual\",\"includeCallToAction\":false,\"platform\":\"Reddit\"}", + "description": "Generate a casual 5-message Reddit thread focused on home workouts during winter to engage fitness enthusiasts without a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Thread", + "context": null + } + }, + { + "name": "copywriting.createNotification", + "description": "Generates clear and engaging notification text for marketing, product updates, or user alerts. Accepts inputs such as notification purpose, tone, audience, and key message points. Produces a polished notification message ready for deployment across digital platforms.", + "category": "copywriting", + "parameters": [ + { + "name": "notificationType", + "type": "string", + "description": "Type of notification to create, e.g., 'product update', 'promotion', 'reminder'.", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience for the notification, e.g., 'existing customers', 'newsletter subscribers'.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the notification, such as 'formal', 'friendly', 'urgent'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keyMessage", + "type": "string", + "description": "The main message or offer to communicate in the notification.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action phrase, e.g., 'Shop now', 'Learn more'.", + "required": false, + "defaultValue": "" + }, + { + "name": "characterLimit", + "type": "number", + "description": "Maximum character length for the notification text to fit platform restrictions.", + "required": false, + "defaultValue": "160" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted notification text ready for distribution." + }, + "aiAgent": { + "useCase": "Use this tool when you need to produce concise, audience-appropriate notification messages for marketing campaigns, app alerts, or product updates. Ideal for generating text that aligns with specified tones and character limits.", + "limitations": "Cannot design layout or handle multimedia content; focuses solely on text generation for notifications.", + "examples": [ + "Create a friendly promotional notification for newsletter subscribers offering a 20% discount.", + "Generate an urgent product update notification for all users with a call to action to update the app.", + "Produce a reminder notification in a formal tone for existing customers about upcoming subscription renewal." + ] + }, + "tags": [ + "copywriting", + "notification", + "marketing", + "text generation", + "communication" + ], + "examples": [ + { + "inputJson": "{\"notificationType\":\"promotion\",\"audience\":\"newsletter subscribers\",\"tone\":\"friendly\",\"keyMessage\":\"Get 20% off all items this weekend only!\",\"callToAction\":\"Shop now\",\"characterLimit\":160}", + "description": "Create a friendly promotional notification for newsletter subscribers offering a 20% discount." + }, + { + "inputJson": "{\"notificationType\":\"product update\",\"audience\":\"all users\",\"tone\":\"urgent\",\"keyMessage\":\"Version 2.0 is live with new security features.\",\"callToAction\":\"Update now\",\"characterLimit\":160}", + "description": "Generate an urgent product update notification directing users to update their app." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Notification", + "context": null + } + }, + { + "name": "copywriting.createMessage", + "description": "Generates a tailored marketing or promotional message based on input parameters including target audience, product details, tone of voice, and desired call to action. It processes these inputs to produce an engaging, coherent message suitable for marketing communication channels.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "Description of the audience the message is targeted to, including demographics or interests.", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "The name of the product or service the message is promoting.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or benefits to highlight about the product or service.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the message, such as friendly, professional, enthusiastic, or urgent.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "callToAction", + "type": "string", + "description": "Desired call to action to include, e.g., buy now, sign up, learn more.", + "required": false, + "defaultValue": "learn more" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length in characters for the generated message to ensure fit for specific channels.", + "required": false, + "defaultValue": "280" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing message string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a concise, targeted marketing or promotional message that incorporates specific product information, audience targeting, and tone. Ideal for social media, email campaigns, or online ads where messaging needs to be clear and engaging.", + "limitations": "The tool may not generate messages that are fully compliant with all regional advertising regulations or extremely specialized industry jargon without additional context.", + "examples": [ + "Create a promotional message for a new fitness tracker targeting active millennials using a friendly tone.", + "Generate a professional message to announce a software update to enterprise clients with a call to action to upgrade.", + "Write an enthusiastic message for a limited-time discount on eco-friendly products aimed at environmentally conscious shoppers." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotion", + "message generation", + "advertising", + "communication" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"young professionals aged 25-35 interested in health and wellness\",\"productName\":\"FitTrack Pro\",\"keyFeatures\":[\"24/7 heart rate monitor\",\"sleep tracking\",\"water resistant\"],\"tone\":\"enthusiastic\",\"callToAction\":\"buy now\",\"maxLength\":200}", + "description": "Generate an enthusiastic marketing message for a fitness tracker targeting young professionals with a clear call to action." + }, + { + "inputJson": "{\"targetAudience\":\"small business owners\",\"productName\":\"Invoice Master\",\"keyFeatures\":[\"automated invoicing\",\"multi-currency support\",\"easy tax calculations\"],\"tone\":\"professional\",\"callToAction\":\"sign up\",\"maxLength\":150}", + "description": "Create a professional promotional message for invoicing software directed at small business owners encouraging sign ups." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Message", + "context": null + } + }, + { + "name": "copywriting.createKey", + "description": "Generates compelling, persuasive marketing copy for security keys and related security hardware. Accepts product details and target audience info, crafts tailored promotional text highlighting key features and security benefits, and outputs ready-to-use copy for marketing materials or product pages.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The official name of the security key product to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "List of key technical features and specifications of the security key.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended users or customer segment for the security key.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the marketing copy such as professional, friendly, or technical.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the marketing text in words.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated marketing copy as a string under the 'marketingCopy' field." + }, + "aiAgent": { + "useCase": "Use this tool when generating marketing content for security hardware products like security keys. It helps create targeted, feature-focused copy tailored to specific audiences, improving promotional materials with persuasive text highlighting product security benefits.", + "limitations": "Cannot generate detailed technical datasheets or exhaustive manuals; focuses solely on marketing style content. It does not provide legal or compliance verbiage.", + "examples": [ + "Create promotional copy for a new biometric security key aimed at enterprise IT admins in a professional tone, about 150 words.", + "Generate friendly and concise marketing text for a USB security key targeting everyday consumers.", + "Write a technical-sounding advertising paragraph highlighting multi-factor authentication features of a security key for cybersecurity professionals." + ] + }, + "tags": [ + "copywriting", + "marketing", + "security", + "security key", + "promotional text", + "product description" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"SecurePass Pro\",\"productFeatures\":[\"FIDO2 compliant\",\"Biometric fingerprint sensor\",\"Multi-factor authentication support\",\"Water resistant\",\"USB-C and NFC connectivity\"],\"targetAudience\":\"Enterprise IT administrators looking to enhance login security\",\"tone\":\"professional\",\"length\":150}", + "description": "Generate professional marketing copy for SecurePass Pro targeting enterprise IT admins." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Key", + "context": null + } + }, + { + "name": "copywriting.createCredential", + "description": "This tool generates professional and persuasive copywriting text for digital security credentials, such as user access tokens and authentication badges. It accepts inputs detailing the credential type, audience, and usage context, then produces clear and compelling descriptive text for marketing or user guidance purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "credentialType", + "type": "string", + "description": "The type of digital credential to describe (e.g., access token, security badge).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the credential text (e.g., IT admins, end users).", + "required": true, + "defaultValue": "" + }, + { + "name": "usageContext", + "type": "string", + "description": "The context or scenario in which the credential is used (e.g., multi-factor authentication, secure login).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the copywriting output (e.g., professional, friendly, technical).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the output text in words.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated credential descriptive text under the key 'credentialCopy'. The output is optimized for clarity and marketing effectiveness." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create engaging, clear, and market-friendly descriptive text for digital security credentials, such as in onboarding materials, product descriptions, or internal documentation. It helps transform credential technical details into audience-appropriate copy to improve understanding and adoption.", + "limitations": "The tool focuses on writing copy and does not generate actual security credentials or validate their security properties. It also may not cover deeply technical or legal compliance language accurately.", + "examples": [ + "Create a friendly description of an access token for end users to explain its usage in a mobile app.", + "Generate professional copy explaining a security badge for IT administrators implementing role-based access control.", + "Write a concise, technical overview for a multi-factor authentication credential to be used in training materials." + ] + }, + "tags": [ + "copywriting", + "security", + "credential", + "marketing", + "digital identity", + "authentication" + ], + "examples": [ + { + "inputJson": "{\"credentialType\":\"Access Token\",\"targetAudience\":\"End Users\",\"usageContext\":\"Secure login to mobile app\",\"tone\":\"friendly\",\"length\":80}", + "description": "Generate friendly, concise copy describing an access token for end users using a mobile app." + }, + { + "inputJson": "{\"credentialType\":\"Security Badge\",\"targetAudience\":\"IT Administrators\",\"usageContext\":\"Role-based access control management\",\"tone\":\"professional\",\"length\":120}", + "description": "Create professional copy explaining security badges for IT admins managing access." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Credential", + "context": null + } + }, + { + "name": "copywriting.createCertificate", + "description": "This tool generates professionally worded certificate texts for security and compliance domains. It accepts details such as recipient name, certificate type, issuing authority, date, and purpose, then crafts a formal certificate text suitable for printing or digital presentation.", + "category": "copywriting", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Full name of the certificate recipient, to be included on the certificate.", + "required": true, + "defaultValue": "" + }, + { + "name": "certificateType", + "type": "string", + "description": "Type of certificate to generate (e.g., 'Security Compliance', 'Data Protection Training').", + "required": true, + "defaultValue": "" + }, + { + "name": "issuingAuthority", + "type": "string", + "description": "Name of the organization or authority issuing the certificate.", + "required": true, + "defaultValue": "" + }, + { + "name": "dateIssued", + "type": "string", + "description": "Date when the certificate is issued, in ISO format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "purposeDescription", + "type": "string", + "description": "Brief description of what the certificate recognizes or validates.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSignatureLine", + "type": "boolean", + "description": "Whether to include a placeholder for a signature line at the bottom of the certificate.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully composed certificate text and metadata such as the title and formatted date." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create formal certificate text for security or compliance achievements to present professionally to individuals or organizations. It helps automate generating consistent, clear, and proper certificate wording based on given input details.", + "limitations": "This tool only generates textual content for certificates; it does not create visual layouts, graphic design, or official certificate files like PDFs or images.", + "examples": [ + "Create a certificate text for a cybersecurity awareness course completion.", + "Generate a security compliance certificate text for a company issued by the regulatory board.", + "Write certificate wording recognizing a data protection officer's training completion issued by an internal security team." + ] + }, + "tags": [ + "copywriting", + "certificate", + "security", + "compliance", + "document", + "certificateText" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Jane Doe\",\"certificateType\":\"Security Compliance\",\"issuingAuthority\":\"Global Security Board\",\"dateIssued\":\"2024-07-01\",\"purposeDescription\":\"successful completion of the 2024 Security Compliance Program\",\"includeSignatureLine\":true}", + "description": "Generate a Security Compliance certificate text recognizing Jane Doe's successful completion of the 2024 Security Compliance Program issued by Global Security Board." + }, + { + "inputJson": "{\"recipientName\":\"John Smith\",\"certificateType\":\"Data Protection Training\",\"issuingAuthority\":\"InfoSec Department\",\"dateIssued\":\"2024-06-15\",\"purposeDescription\":\"completion of mandatory data protection and privacy training\",\"includeSignatureLine\":false}", + "description": "Create a Data Protection Training certificate text for John Smith issued by the InfoSec Department without a signature line." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Certificate", + "context": null + } + }, + { + "name": "copywriting.createIncident", + "description": "This tool generates professional, clear incident reports for security-related events based on provided details like incident type, description, severity, and response actions. It accepts structured input about the incident and produces a concise, formal written incident report suitable for communication with stakeholders or documentation purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "incidentType", + "type": "string", + "description": "The category or type of the security incident (e.g., data breach, ransomware attack).", + "required": true, + "defaultValue": "" + }, + { + "name": "incidentDescription", + "type": "string", + "description": "A detailed description of what occurred during the incident.", + "required": true, + "defaultValue": "" + }, + { + "name": "impactSeverity", + "type": "string", + "description": "Severity level of the incident impact (e.g., low, medium, high, critical).", + "required": true, + "defaultValue": "" + }, + { + "name": "detectionDateTime", + "type": "string", + "description": "Date and time when the incident was first detected, in ISO 8601 format.", + "required": false, + "defaultValue": "" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "List of affected systems, services, or assets involved in the incident.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mitigationActions", + "type": "string", + "description": "Description of actions taken to contain or mitigate the incident.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportAudience", + "type": "string", + "description": "Intended audience of the report (e.g., internal stakeholders, customers, regulatory bodies).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a well-formatted textual incident report summarizing the incident details in professional language." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create formal incident reports from raw incident data to communicate clearly with stakeholders or document incidents properly. It helps transform structured incident details into polished, readable reports that highlight critical information, impact, and response efforts.", + "limitations": "This tool cannot verify incident facts or replace in-depth forensic analysis. It is not designed to generate incident remediation plans or technical logs directly, only narrative reports based on inputs.", + "examples": [ + "Create an incident report for a recent data breach affecting customer data with high severity.", + "Generate a formal report describing actions taken during a ransomware attack found yesterday.", + "Summarize a security incident involving unauthorized access to internal systems for management review." + ] + }, + "tags": [ + "copywriting", + "security", + "incident reporting", + "communication", + "documentation", + "security incident" + ], + "examples": [ + { + "inputJson": "{\"incidentType\":\"Data Breach\",\"incidentDescription\":\"Unauthorized access detected in customer database exposing email addresses.\",\"impactSeverity\":\"High\",\"detectionDateTime\":\"2024-06-10T14:23:00Z\",\"affectedSystems\":[\"Customer DB\",\"Email Marketing System\"],\"mitigationActions\":\"Access blocked, passwords reset, forensic investigation initiated.\",\"reportAudience\":\"Internal Management\"}", + "description": "A high severity data breach incident with details on detection, impact and mitigation for internal management." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Incident", + "context": null + } + }, + { + "name": "copywriting.createSecret", + "description": "Generates compelling marketing copy emphasizing product or service secrecy features, such as confidentiality, security, or exclusivity. Accepts inputs including product details, target audience, and tone, producing persuasive secret-focused promotional text to enhance appeal and trust in security-sensitive markets.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be marketed.", + "required": true, + "defaultValue": "" + }, + { + "name": "secretFeatureDescription", + "type": "string", + "description": "Description of the secret, confidentiality, or security feature to highlight.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience or customer segment for the copy.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the copy, such as professional, casual, or urgent.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "copyLength", + "type": "number", + "description": "Approximate desired length of the generated copy in words.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated secret-focused marketing copy as a string." + }, + "aiAgent": { + "useCase": "When an AI agent needs to create marketing content that highlights the secrecy, confidentiality, or security aspects of a product or service to attract customers who value privacy or exclusive features. Suitable for promotional materials emphasizing trust and discretion.", + "limitations": "Does not generate technical security documentation or actual encryption keys; focuses strictly on persuasive copywriting. Cannot verify factual accuracy of security claims.", + "examples": [ + "Create secret-focused marketing copy for a new encrypted messaging app targeting privacy-conscious users.", + "Generate a promotional paragraph emphasizing the exclusive, confidential nature of a premium membership service.", + "Write professional marketing text highlighting the security features of a cloud storage solution for enterprises." + ] + }, + "tags": [ + "copywriting", + "marketing", + "security", + "secret", + "promotional", + "content generation", + "privacy", + "confidentiality" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"SecureChat\",\"secretFeatureDescription\":\"end-to-end encryption ensuring no third-party access\",\"targetAudience\":\"privacy-conscious consumers\",\"tone\":\"professional\",\"copyLength\":100}", + "description": "Generate professional copy for SecureChat emphasizing its end-to-end encryption for privacy-focused users." + }, + { + "inputJson": "{\"productName\":\"EliteClub\",\"secretFeatureDescription\":\"exclusive membership with confidential benefits\",\"targetAudience\":\"affluent individuals\",\"tone\":\"luxurious\",\"copyLength\":80}", + "description": "Create luxurious copy promoting EliteClub’s secretive, exclusive membership benefits for wealthy clients." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Secret", + "context": null + } + }, + { + "name": "copywriting.createAlert", + "description": "Generates a professionally written security alert message based on provided incident details, target audience, and urgency level. Accepts inputs like incident type, description, affected systems, and urgency, then crafts a clear, concise alert suitable for internal or external communication.", + "category": "copywriting", + "parameters": [ + { + "name": "incidentType", + "type": "string", + "description": "Type of security incident (e.g., data breach, malware, phishing).", + "required": true, + "defaultValue": "" + }, + { + "name": "incidentDescription", + "type": "string", + "description": "Detailed description of the incident, including what happened and impact.", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "List of affected systems, services, or locations.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "urgencyLevel", + "type": "string", + "description": "Urgency level of the alert (e.g., low, medium, high, critical).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Audience for the alert (e.g., internal staff, customers, partners).", + "required": true, + "defaultValue": "" + }, + { + "name": "recommendedActions", + "type": "string", + "description": "Suggested next steps or mitigations for recipients to follow.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated alert message text and a brief summary for quick reference." + }, + "aiAgent": { + "useCase": "Use this tool when a clear, professional security alert needs to be quickly created based on incident details. Ideal for informing stakeholders with a properly structured and audience-appropriate message about security issues and required actions.", + "limitations": "Cannot replace legal or official communications requiring approvals. Does not perform incident analysis or verify incident accuracy. It generates text only based on inputs provided.", + "examples": [ + "Create a high urgency alert for a phishing attack affecting email systems to internal staff with recommended actions.", + "Generate a medium urgency alert for a malware outbreak affecting endpoint devices for IT partners.", + "Draft a low urgency alert about a minor data exposure incident directed to customers." + ] + }, + "tags": [ + "copywriting", + "security", + "alert", + "notification", + "incident communication", + "marketing", + "internal communication" + ], + "examples": [ + { + "inputJson": "{\"incidentType\":\"Phishing Scam\",\"incidentDescription\":\"A phishing email campaign was detected targeting employees with malicious links.\",\"affectedSystems\":[\"Email System\"],\"urgencyLevel\":\"High\",\"targetAudience\":\"Internal Staff\",\"recommendedActions\":\"Do not click on suspicious links; report emails to IT immediately.\"}", + "description": "Generate a high urgency alert for internal staff describing a phishing scam affecting email systems." + }, + { + "inputJson": "{\"incidentType\":\"Malware Infection\",\"incidentDescription\":\"Several endpoint devices were found infected by ransomware.\",\"affectedSystems\":[\"Endpoint Devices\"],\"urgencyLevel\":\"Critical\",\"targetAudience\":\"IT Partners\",\"recommendedActions\":\"Isolate affected devices and begin incident response protocols.\"}", + "description": "Create a critical alert for IT partners about ransomware infection on endpoint devices." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Alert", + "context": null + } + }, + { + "name": "copywriting.createVulnerability", + "description": "Generates clear, concise vulnerability descriptions for security advisories or reports. Accepts inputs like vulnerability type, affected software, impact severity, and technical details, processes this data to produce well-structured, professional vulnerability write-ups suitable for communication to technical and non-technical audiences.", + "category": "copywriting", + "parameters": [ + { + "name": "vulnerabilityType", + "type": "string", + "description": "Type or category of the vulnerability (e.g., SQL Injection, Buffer Overflow).", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSoftware", + "type": "string", + "description": "Name and version(s) of the software affected by the vulnerability.", + "required": true, + "defaultValue": "" + }, + { + "name": "impactSeverity", + "type": "string", + "description": "Severity level of the vulnerability (e.g., Low, Medium, High, Critical).", + "required": true, + "defaultValue": "" + }, + { + "name": "technicalDetails", + "type": "string", + "description": "Technical description including how the vulnerability can be exploited or occurs.", + "required": true, + "defaultValue": "" + }, + { + "name": "mitigationAdvice", + "type": "string", + "description": "Recommended mitigations or remediation actions to address the vulnerability.", + "required": false, + "defaultValue": "" + }, + { + "name": "audienceType", + "type": "string", + "description": "Target audience for the output (e.g., technical, non-technical, executive).", + "required": false, + "defaultValue": "technical" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated vulnerability description formatted for the specified audience, including a summary, impact, and mitigation sections." + }, + "aiAgent": { + "useCase": "Use this tool when generating professional vulnerability descriptions for security advisories, reports, or documentation requiring clear communication of technical details and impact to various audiences. It helps in drafting initial write-ups that comply with security communication best practices.", + "limitations": "This tool cannot verify or discover vulnerabilities. It relies solely on the input provided and does not replace expert security analysis or vulnerability validation.", + "examples": [ + "Generate a vulnerability description for a cross-site scripting flaw in version 2.5 of a web app targeting non-technical managers.", + "Create a detailed report entry describing a critical buffer overflow in a networking library used in embedded devices.", + "Draft mitigation advice for a new SQL injection vulnerability found in a CMS platform." + ] + }, + "tags": [ + "copywriting", + "security", + "vulnerability", + "reporting", + "documentation", + "communication" + ], + "examples": [ + { + "inputJson": "{\"vulnerabilityType\":\"Cross-Site Scripting (XSS)\",\"affectedSoftware\":\"ExampleCMS 3.2.1\",\"impactSeverity\":\"High\",\"technicalDetails\":\"The vulnerability is due to improper sanitization of user input in the comment submission form, allowing execution of arbitrary JavaScript.\",\"mitigationAdvice\":\"Apply input validation and output encoding on all user-generated content.\",\"audienceType\":\"non-technical\"}", + "description": "Generate a user-friendly vulnerability description for a cross-site scripting bug in a CMS, intended for non-technical readers." + }, + { + "inputJson": "{\"vulnerabilityType\":\"Buffer Overflow\",\"affectedSoftware\":\"NetSecureLib v1.4\",\"impactSeverity\":\"Critical\",\"technicalDetails\":\"A buffer overflow occurs in the packet parsing function when processing oversized network frames, leading to potential remote code execution.\",\"mitigationAdvice\":\"Update to the latest version 1.5 where bounds checking is enforced.\",\"audienceType\":\"technical\"}", + "description": "Create a technical report snippet describing a critical buffer overflow vulnerability in a networking library with recommended action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Vulnerability", + "context": null + } + }, + { + "name": "copywriting.createForecast", + "description": "Generates a clear, concise business forecast text based on provided historical data, market trends, time horizon, and business goals. It processes numerical and qualitative inputs to create a persuasive marketing-style forecast for business planning or promotional purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "historicalDataSummary", + "type": "string", + "description": "A brief summary of past performance metrics relevant to the forecast (e.g., sales figures, growth rates).", + "required": true, + "defaultValue": "" + }, + { + "name": "marketTrends", + "type": "string", + "description": "Description of current relevant market conditions or trends affecting the business domain.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeHorizonMonths", + "type": "number", + "description": "The forecast period in months, indicating how far ahead to project the forecast.", + "required": true, + "defaultValue": "12" + }, + { + "name": "businessGoals", + "type": "string", + "description": "Business objectives or targets to highlight or align the forecast with.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style for the forecast text (e.g., optimistic, conservative, neutral).", + "required": false, + "defaultValue": "optimistic" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated forecast text and a summary highlight." + }, + "aiAgent": { + "useCase": "Use this tool when generating persuasive business forecast texts for marketing materials, investor updates, strategic planning documents, or promotional content where a forecast is needed from given historical and market data inputs. It helps produce coherent narrative forecasts based on numerical and qualitative data inputs.", + "limitations": "This tool cannot generate precise quantitative models or replace detailed financial modeling; it creates text forecasts based on inputs without deep statistical computations.", + "examples": [ + "Create a 12-month optimistic sales forecast to use in a product launch presentation.", + "Generate a conservative business growth forecast highlighting market challenges for an investor report.", + "Write a neutral forecast summary focusing on new market trends and business goals for internal strategy planning." + ] + }, + "tags": [ + "copywriting", + "forecast", + "business", + "marketing", + "text generation", + "planning" + ], + "examples": [ + { + "inputJson": "{\"historicalDataSummary\":\"Our revenue grew 15% annually over the past 3 years.\",\"marketTrends\":\"Increasing demand in sustainable products and eco-conscious consumer base.\",\"timeHorizonMonths\":12,\"businessGoals\":\"Expand market share by 10% and launch two new product lines.\",\"tone\":\"optimistic\"}", + "description": "Generate a 12-month optimistic business forecast emphasizing growth and new products based on historical and market data." + }, + { + "inputJson": "{\"historicalDataSummary\":\"Sales declined 5% last year due to supply chain disruptions.\",\"marketTrends\":\"Market facing strong competition and fluctuating raw material costs.\",\"timeHorizonMonths\":6,\"businessGoals\":\"Maintain current customer base and reduce costs.\",\"tone\":\"conservative\"}", + "description": "Create a 6-month conservative forecast focusing on cost management and stable customer retention amid challenges." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Forecast", + "context": null + } + }, + { + "name": "copywriting.createRisk", + "description": "Generates clear, concise marketing copy describing security risks for products or services. Accepts inputs like risk type, target audience, severity level, and context to produce persuasive, informative text for awareness campaigns, product pages, or security advisories.", + "category": "copywriting", + "parameters": [ + { + "name": "riskType", + "type": "string", + "description": "The specific type of security risk to describe (e.g., phishing, data breach).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Who the risk description is aimed at (e.g., general users, IT professionals).", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "The risk severity level (e.g., low, medium, high) to emphasize in the copy.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "context", + "type": "string", + "description": "Additional context about the risk or environment where it applies (e.g., cloud services, mobile apps).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the copy (e.g., formal, simple, urgent).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length for the generated text in characters.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated risk marketing copy as a string field 'riskCopy'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to produce effective marketing or informational copy focused on explaining security risks tailored to a specific audience. It helps convert technical risk details into clear, engaging promotional or educational text.", + "limitations": "This tool does not perform risk assessment or validation. It cannot generate technical documentation or detailed security reports. It relies solely on provided inputs to generate copy and may not capture all nuances of complex risks.", + "examples": [ + "Create marketing text warning general users about high severity phishing risks in mobile apps.", + "Produce a formal description of medium severity data breach risks targeting IT professionals.", + "Generate a simple, urgent warning about ransomware threats in cloud services for a newsletter." + ] + }, + "tags": [ + "copywriting", + "security", + "risk", + "marketing", + "awareness", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"riskType\":\"phishing\",\"targetAudience\":\"general users\",\"severityLevel\":\"high\",\"context\":\"mobile apps\",\"tone\":\"urgent\",\"maxLength\":300}", + "description": "Generate an urgent warning about high severity phishing risk targeting general users using mobile apps." + }, + { + "inputJson": "{\"riskType\":\"data breach\",\"targetAudience\":\"IT professionals\",\"severityLevel\":\"medium\",\"context\":\"cloud services\",\"tone\":\"formal\",\"maxLength\":400}", + "description": "Produce formal marketing copy about medium severity data breach risks for IT professionals focused on cloud services." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Risk", + "context": null + } + }, + { + "name": "copywriting.createThreat", + "description": "Generates a realistic, detailed security threat description based on given parameters such as threat type, attack vector, target system, and severity level. It processes structured inputs to produce a comprehensive promotional or awareness text about cybersecurity threats suitable for marketing or educational content.", + "category": "copywriting", + "parameters": [ + { + "name": "threatType", + "type": "string", + "description": "Type of threat to describe (e.g., phishing, ransomware, DDoS).", + "required": true, + "defaultValue": "" + }, + { + "name": "attackVector", + "type": "string", + "description": "The method or entry point used by the threat (e.g., email, network, USB).", + "required": false, + "defaultValue": "" + }, + { + "name": "targetSystem", + "type": "string", + "description": "The target environment or system affected by the threat (e.g., corporate network, IoT devices).", + "required": false, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "The level of threat severity (e.g., low, medium, high, critical).", + "required": false, + "defaultValue": "medium" + }, + { + "name": "industry", + "type": "string", + "description": "Industry or sector for contextualizing the threat (e.g., finance, healthcare).", + "required": false, + "defaultValue": "" + }, + { + "name": "includeMitigationTips", + "type": "boolean", + "description": "Whether to append actionable mitigation advice to the threat description.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a coherent, engaging threat description text suitable for marketing, awareness campaigns, or security blogs." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to generate compelling, informative descriptions of cybersecurity threats for marketing materials, cybersecurity awareness content, blogs, or educational campaigns. It helps transform technical threat data into understandable and engaging copy for a general or specialized audience.", + "limitations": "The tool does not analyze real-time threat data or perform vulnerability assessments; it only generates descriptive copy based on provided parameters and may not reflect current threat trends or real attack data.", + "examples": [ + "Generate a description about ransomware targeting healthcare with high severity including mitigation tips.", + "Create a phishing threat description focused on email attack vectors for corporate networks without mitigation tips.", + "Write a DDoS attack description for financial services with critical severity." + ] + }, + "tags": [ + "copywriting", + "security", + "threat", + "marketing", + "cybersecurity", + "awareness" + ], + "examples": [ + { + "inputJson": "{\"threatType\":\"ransomware\",\"attackVector\":\"email attachments\",\"targetSystem\":\"healthcare systems\",\"severityLevel\":\"high\",\"industry\":\"healthcare\",\"includeMitigationTips\":true}", + "description": "Generate a high severity ransomware threat description targeting healthcare systems via email attachments, including mitigation advice." + }, + { + "inputJson": "{\"threatType\":\"phishing\",\"attackVector\":\"email\",\"targetSystem\":\"corporate network\",\"severityLevel\":\"medium\",\"industry\":\"finance\",\"includeMitigationTips\":false}", + "description": "Create a phishing threat description aimed at corporate networks in finance sector, medium severity, without mitigation tips." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Threat", + "context": null + } + }, + { + "name": "copywriting.createBudget", + "description": "Generates a detailed business budget proposal text based on input financial data and project parameters. Accepts project goals, estimated costs, duration, and key financial assumptions, then produces a clear, persuasive budget document ready for stakeholder review or marketing contexts.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project or business initiative the budget is for.", + "required": true, + "defaultValue": "" + }, + { + "name": "totalBudget", + "type": "number", + "description": "The total amount of money allocated or requested for the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "durationMonths", + "type": "number", + "description": "The timeframe in months over which the budget applies.", + "required": true, + "defaultValue": "" + }, + { + "name": "costBreakdown", + "type": "object", + "description": "A detailed object containing key cost categories and their respective amounts (e.g., personnel, equipment, marketing).", + "required": true, + "defaultValue": "" + }, + { + "name": "financialAssumptions", + "type": "string", + "description": "Any financial assumptions or constraints that affect the budget, such as expected inflation or resource availability.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience of the budget document, e.g., internal management, investors, partners.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a formatted budget proposal text string that summarizes the financial plan clearly and persuasively." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create coherent, professional budget proposals from raw financial and project data. It helps generate persuasive and structured budget overviews for business presentations, investor pitches, or internal planning documents.", + "limitations": "Cannot perform actual financial validations or audits; outputs based solely on user input and basic formatting; detailed financial accuracy must be verified by experts.", + "examples": [ + "Create a project budget summary for an IT development initiative with a $500,000 budget over 12 months.", + "Generate a marketing campaign budget proposal based on provided costs for personnel, media buys, and creative expenses.", + "Produce a clear and concise budget document for internal stakeholders showing cost allocation across departments." + ] + }, + "tags": [ + "copywriting", + "budget", + "business", + "financial writing", + "proposal generation", + "marketing", + "financial planning" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"New App Launch\",\"totalBudget\":300000,\"durationMonths\":6,\"costBreakdown\":{\"personnel\":150000,\"marketing\":80000,\"equipment\":30000,\"miscellaneous\":40000},\"financialAssumptions\":\"Costs assume moderate inflation and stable supplier pricing.\",\"targetAudience\":\"investors\"}", + "description": "Budget proposal for a 6 month new app launch project with detailed cost categories." + }, + { + "inputJson": "{\"projectName\":\"Annual Marketing Campaign\",\"totalBudget\":120000,\"durationMonths\":12,\"costBreakdown\":{\"mediaBuy\":60000,\"creativeProduction\":30000,\"staffSalaries\":20000,\"contingency\":10000},\"financialAssumptions\":\"Budget assumes 5% annual marketing cost increase.\",\"targetAudience\":\"management\"}", + "description": "Marketing campaign budget over one year with breakdown for media, creative, and salaries." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Budget", + "context": null + } + }, + { + "name": "copywriting.createPayment", + "description": "Generates clear, persuasive marketing copy for payment-related communications such as invoices, payment reminders, payment confirmations, or payment plan offers. Accepts details about the payment context and target audience, then produces professional text tailored to the specified purpose.", + "category": "copywriting", + "parameters": [ + { + "name": "paymentType", + "type": "string", + "description": "Type of payment material to create, e.g., invoice, reminder, confirmation, plan offer.", + "required": true, + "defaultValue": "" + }, + { + "name": "amount", + "type": "number", + "description": "Monetary amount related to the payment.", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for the amount, e.g., USD, EUR.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "dueDate", + "type": "string", + "description": "Due date for payment in ISO format (YYYY-MM-DD), if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "recipientName", + "type": "string", + "description": "Name of the payment recipient or customer.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., formal, friendly, urgent.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "additionalInfo", + "type": "string", + "description": "Extra details or instructions to include in the payment text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated payment-related copy text as 'text' and metadata including type and tone." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate professional marketing or transactional copy related to payments, such as sending payment reminders or confirming a received payment. It helps create clear, appropriate text quickly tailored to the payment context and audience.", + "limitations": "This tool cannot generate actual payment processing data or legal documents, nor can it replace personalized financial advice. It only produces marketing-style text for payment communications.", + "examples": [ + "Create a friendly payment reminder for a $150 invoice due on 2024-07-01 addressed to John Doe.", + "Generate a formal payment confirmation message for a completed $99.99 payment in USD.", + "Produce a promotional text offering a payment plan option with clear terms and friendly tone." + ] + }, + "tags": [ + "copywriting", + "payment", + "marketing", + "financial communication", + "text generation", + "business", + "invoicing" + ], + "examples": [ + { + "inputJson": "{\"paymentType\":\"reminder\",\"amount\":150,\"currency\":\"USD\",\"dueDate\":\"2024-07-01\",\"recipientName\":\"John Doe\",\"tone\":\"friendly\",\"additionalInfo\":\"Please pay via bank transfer.\"}", + "description": "Generate a friendly payment reminder for John Doe about an invoice of $150 due on July 1, 2024." + }, + { + "inputJson": "{\"paymentType\":\"confirmation\",\"amount\":99.99,\"currency\":\"USD\",\"recipientName\":\"Jane Smith\",\"tone\":\"formal\"}", + "description": "Create a formal payment confirmation message for Jane Smith for a payment of $99.99." + }, + { + "inputJson": "{\"paymentType\":\"plan offer\",\"tone\":\"friendly\",\"additionalInfo\":\"Two monthly installments with no interest.\"}", + "description": "Produce a friendly promotional text offering a no-interest payment plan with two installments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Payment", + "context": null + } + }, + { + "name": "copywriting.createExpense", + "description": "Generates professional and clear expense descriptions and justifications for business communication, based on input details like amount, purpose, date, and category. Produces formatted text suitable for reimbursement requests, reports, or documentation.", + "category": "copywriting", + "parameters": [ + { + "name": "amount", + "type": "number", + "description": "Expense amount in the relevant currency.", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for the expense, e.g., USD, EUR.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "expenseDate", + "type": "string", + "description": "Date of the expense in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "category", + "type": "string", + "description": "Category or type of expense (e.g., travel, meals, office supplies).", + "required": false, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Brief explanation of the reason for the expense.", + "required": true, + "defaultValue": "" + }, + { + "name": "additionalDetails", + "type": "string", + "description": "Any additional details or context to include in the expense description.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated expense description text formatted suitably for business use." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create clear, concise, and professional expense descriptions or justifications for business reimbursements, accounting, or reporting based on minimal input details. It helps automate writing expense narratives for documentation or communication.", + "limitations": "This tool generates text descriptions only and does not perform expense validation, approval, or processing. It cannot verify receipt authenticity or compliance with company policy.", + "examples": [ + "Create a detailed description for a $150 meal expense during a client meeting on 2024-05-10.", + "Generate an expense justification for a $300 office supply purchase on 2024-04-22.", + "Produce a reimbursement description for a $450 travel expense categorized as 'transportation'." + ] + }, + "tags": [ + "copywriting", + "expense", + "business", + "finance", + "reporting", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"amount\":150,\"currency\":\"USD\",\"expenseDate\":\"2024-05-10\",\"category\":\"meals\",\"purpose\":\"Client meeting lunch\",\"additionalDetails\":\"Lunch with potential client to discuss project scope.\"}", + "description": "Generate description for a meal expense for a client meeting." + }, + { + "inputJson": "{\"amount\":300,\"category\":\"office supplies\",\"purpose\":\"New office chairs for team members\",\"expenseDate\":\"2024-04-22\"}", + "description": "Create justification for an office supplies purchase." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Expense", + "context": null + } + }, + { + "name": "copywriting.createOrder", + "description": "Generates persuasive and clear marketing copy to promote a product order, based on input details such as product name, quantity, target audience, and desired tone. It processes these inputs to produce compelling order-related promotional text suitable for emails, ads, or websites.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product to feature in the order copy", + "required": true, + "defaultValue": "" + }, + { + "name": "quantity", + "type": "number", + "description": "Number of units to be ordered or promoted", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the audience intended to receive the promotional text", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Style or mood of the copy, e.g., friendly, professional, urgent", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call to action to include, e.g., \"Order now\", \"Limited offer\"", + "required": false, + "defaultValue": "Order now" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional order copy as a string under the key 'orderCopy'" + }, + "aiAgent": { + "useCase": "Use this tool when you need to create tailored marketing text that encourages customers to place an order for a product. Ideal for generating dynamic promotional content for emails, advertisements, or landing pages based on product details and audience context.", + "limitations": "Cannot perform actual order processing or validate inventory; it focuses solely on copywriting for promotional purposes.", + "examples": [ + "Create order copy to promote 100 units of a new eco-friendly water bottle to young professionals with an urgent tone.", + "Generate friendly marketing text for ordering 50 custom notebooks targeting students with a call to action to buy now.", + "Write a professional order prompt for 200 office chairs aimed at corporate clients with a 'Limited time offer' CTA." + ] + }, + "tags": [ + "copywriting", + "marketing", + "order", + "promotional text", + "business", + "sales", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoBottle\",\"quantity\":100,\"targetAudience\":\"young professionals\",\"tone\":\"urgent\",\"callToAction\":\"Order now\"}", + "description": "Generate urgent, persuasive copy promoting an order of 100 EcoBottles for young professionals." + }, + { + "inputJson": "{\"productName\":\"Custom Notebook\",\"quantity\":50,\"targetAudience\":\"students\",\"tone\":\"friendly\",\"callToAction\":\"Buy now\"}", + "description": "Create friendly and inviting order copy for 50 custom notebooks targeting students." + }, + { + "inputJson": "{\"productName\":\"Office Chair Model X\",\"quantity\":200,\"targetAudience\":\"corporate clients\",\"tone\":\"professional\",\"callToAction\":\"Limited time offer\"}", + "description": "Produce professional marketing text to promote ordering 200 office chairs to corporate clients with a limited time promotion." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Order", + "context": null + } + }, + { + "name": "copywriting.createDeal", + "description": "Generates persuasive marketing copy for business deals based on input parameters like offer details, target audience, tone, and call-to-action. Processes the inputs to create engaging promotional text for use in advertising campaigns, emails, or websites.", + "category": "copywriting", + "parameters": [ + { + "name": "dealTitle", + "type": "string", + "description": "The title or headline of the deal or promotion to be advertised.", + "required": true, + "defaultValue": "" + }, + { + "name": "offerDetails", + "type": "string", + "description": "The specific details or description of the deal, including discounts, benefits, or conditions.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "A brief description of the intended audience for the deal (e.g., tech enthusiasts, holiday shoppers).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the copy, such as friendly, urgent, formal, or playful.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "callToAction", + "type": "string", + "description": "The call-to-action phrase to encourage customer response (e.g., 'Shop Now', 'Limited Time Offer').", + "required": false, + "defaultValue": "Act Now!" + }, + { + "name": "expirationDate", + "type": "string", + "description": "Optional expiration date of the deal to create urgency in the copy (format ISO 8601 date).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional deal copy as a string under the 'dealCopy' key." + }, + "aiAgent": { + "useCase": "Use this tool when generating marketing or promotional text for specific business deals or offers. It helps create compelling messaging tailored to the deal's specifics, preferred tone, and target audience to increase customer engagement and conversions.", + "limitations": "Does not verify factual accuracy of deal details; cannot replace human review for compliance or legal checks. Also, it does not generate graphics or multimedia content.", + "examples": [ + "Create a friendly and urgent promotional text advertising a 30% off winter sale for fashion shoppers with a call-to-action 'Shop Now' and expiration date.", + "Generate formal marketing copy for a business bulk purchase discount aimed at corporate clients with a polite call-to-action.", + "Write a playful promotional message for a weekend flash deal on electronics targeting tech enthusiasts without a specified expiration date." + ] + }, + "tags": [ + "copywriting", + "marketing", + "deal", + "promotion", + "advertising", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"dealTitle\":\"Winter Sale - 30% Off All Fashion\",\"offerDetails\":\"Enjoy 30% discount on all winter apparel including coats, scarves, and boots.\",\"targetAudience\":\"fashion shoppers\",\"tone\":\"friendly\",\"callToAction\":\"Shop Now\",\"expirationDate\":\"2024-12-31\"}", + "description": "Generate a friendly promotional copy for a winter sale deal targeting fashion shoppers with a call-to-action and expiration date." + }, + { + "inputJson": "{\"dealTitle\":\"Bulk Purchase Discount\",\"offerDetails\":\"Receive 15% off on orders of 100 units or more for corporate clients.\",\"targetAudience\":\"corporate clients\",\"tone\":\"formal\",\"callToAction\":\"Contact Sales\",\"expirationDate\":\"\"}", + "description": "Create formal marketing text for a bulk discount aimed at corporate clients with a polite call-to-action and no expiration date." + }, + { + "inputJson": "{\"dealTitle\":\"Weekend Flash Electronics Deal\",\"offerDetails\":\"Exclusive discounts on laptops, tablets, and accessories this weekend only.\",\"targetAudience\":\"tech enthusiasts\",\"tone\":\"playful\",\"callToAction\":\"Grab Yours Now!\",\"expirationDate\":\"\"}", + "description": "Write playful promotional copy for a weekend-only flash deal targeting tech enthusiasts without an expiration date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Deal", + "context": null + } + }, + { + "name": "copywriting.createAccount", + "description": "Generates persuasive and engaging marketing copy to promote a new business account, focusing on target audience, key benefits, and unique selling points to attract signups or interest. Takes input about account features, target demographics, and tone and outputs polished promotional text.", + "category": "copywriting", + "parameters": [ + { + "name": "accountName", + "type": "string", + "description": "The name of the business account or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the primary audience for the marketing copy (e.g., small business owners, freelancers).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or benefits of the account to highlight in the copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone for the copy (e.g., professional, friendly, casual, persuasive).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "callToAction", + "type": "string", + "description": "A call to action to encourage user engagement (e.g., Sign up today!).", + "required": false, + "defaultValue": "Sign up today!" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete generated promotional marketing copy text under 'marketingCopy' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create compelling promotional text for a business account aimed at attracting and converting potential customers. It is ideal for generating marketing material that highlights features and benefits tailored to a specific audience with a specified tone and call to action.", + "limitations": "The tool generates text based on provided inputs but cannot create actual logos, design elements, or perform account setup processes. It also does not guarantee compliance with legal advertising standards or industry-specific regulations.", + "examples": [ + "Generate marketing copy for a new freelancer account targeting independent consultants with a friendly tone and emphasizing flexible pricing.", + "Create promotional text for a small business account highlighting security features and professional tone with a strong call to action.", + "Write copy to introduce a new student account emphasizing ease of use and appealing to young adults." + ] + }, + "tags": [ + "copywriting", + "marketing", + "account promotion", + "business", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"accountName\":\"ProConsult Freelancer Account\",\"targetAudience\":\"independent consultants and freelancers\",\"keyFeatures\":[\"flexible pricing\",\"24/7 support\",\"easy invoicing\"],\"tone\":\"friendly\",\"callToAction\":\"Join now and boost your freelancing career!\"}", + "description": "Marketing copy for a freelancer account aimed at consultants, using a friendly tone." + }, + { + "inputJson": "{\"accountName\":\"SecureBiz Small Business Account\",\"targetAudience\":\"small business owners\",\"keyFeatures\":[\"advanced security\",\"multi-factor authentication\",\"dedicated account manager\"],\"tone\":\"professional\",\"callToAction\":\"Protect your business today!\"}", + "description": "Professional tone marketing text promoting security features for small business owners." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Account", + "context": null + } + }, + { + "name": "copywriting.createDiagram", + "description": "Generates a marketing or promotional diagram based on textual input and stylistic preferences. Accepts textual description of the message or concept, diagram type, style options, and outputs a detailed diagram layout plan or graphic structure that can be used in marketing content creation.", + "category": "copywriting", + "parameters": [ + { + "name": "textDescription", + "type": "string", + "description": "The main textual content or concept description to base the diagram on.", + "required": true, + "defaultValue": "" + }, + { + "name": "diagramType", + "type": "string", + "description": "Type of diagram to create, e.g., flowchart, infographic, mind map, or chart.", + "required": true, + "defaultValue": "flowchart" + }, + { + "name": "style", + "type": "string", + "description": "Visual style for the diagram, e.g., professional, playful, minimalist.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "colorPalette", + "type": "array", + "description": "Array of color hex codes defining the color scheme for the diagram.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeLegend", + "type": "boolean", + "description": "Whether to include a legend explaining diagram elements.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format such as JSON layout, SVG markup, or textual layout description.", + "required": false, + "defaultValue": "JSON" + } + ], + "returns": { + "type": "object", + "description": "An object containing the diagram layout or graphic data in the specified output format, including nodes, connections, colors, and annotations relevant for marketing use." + }, + "aiAgent": { + "useCase": "Use this tool when a marketing or copywriting agent needs to convert promotional or conceptual text into a clear and visually structured diagram to enhance communication, presentations, or campaign materials. Suitable for generating flowcharts, infographics, and mind maps that represent marketing ideas visually.", + "limitations": "This tool does not generate final graphical images but produces structured layouts or graphic blueprints. It cannot replace graphic design software or manual artistic adjustments. Complex or highly customized visual styles may not be fully supported.", + "examples": [ + "Create a flowchart diagram explaining the customer journey with a professional style.", + "Generate a colorful infographic from a product features description including a legend.", + "Produce a minimalist mind map from campaign goals text for internal presentation." + ] + }, + "tags": [ + "copywriting", + "diagram", + "marketing", + "visualization", + "promotional content", + "flowchart", + "infographic", + "mind map" + ], + "examples": [ + { + "inputJson": "{\"textDescription\":\"Outline of customer onboarding process steps and decision points.\",\"diagramType\":\"flowchart\",\"style\":\"professional\",\"colorPalette\":[\"#004080\",\"#c0d6e4\"],\"includeLegend\":true,\"outputFormat\":\"JSON\"}", + "description": "Generate a professional flowchart diagram layout based on a customer onboarding textual outline." + }, + { + "inputJson": "{\"textDescription\":\"Key product features and benefits arranged for an infographic.\",\"diagramType\":\"infographic\",\"style\":\"playful\",\"colorPalette\":[\"#ff5733\",\"#33c1ff\",\"#a833ff\"],\"includeLegend\":true,\"outputFormat\":\"JSON\"}", + "description": "Create a colorful playful infographic layout highlighting product features and benefits with legend." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Diagram", + "context": null + } + }, + { + "name": "copywriting.createLead", + "description": "Generates compelling lead paragraphs for marketing or promotional content based on the target audience, product/service details, tone, and format preferences. Accepts structured input describing context and outputs a persuasive introductory text snippet designed to engage potential customers effectively.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or customer segment for the lead.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style for the lead paragraph (e.g., friendly, professional, enthusiastic).", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keyBenefits", + "type": "array", + "description": "List of key benefits or features of the product/service to highlight in the lead.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "format", + "type": "string", + "description": "Preferred text format or length for the lead (e.g., short, medium, long).", + "required": false, + "defaultValue": "medium" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated lead paragraph as a string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to craft the opening paragraph of marketing materials, advertisements, or promotional content that requires quick audience engagement by summarizing key product/service value in a targeted, persuasive manner.", + "limitations": "The tool cannot create full marketing copy beyond the lead paragraph and may not account fully for very niche or highly technical domains without adequate input detail.", + "examples": [ + "Create a friendly lead paragraph for a new eco-friendly water bottle targeting young adults highlighting sustainability and convenience.", + "Generate a professional lead for a B2B software platform aimed at financial institutions emphasizing security and efficiency.", + "Write an enthusiastic short lead for a fitness app targeting beginners focusing on ease of use and motivation." + ] + }, + "tags": [ + "copywriting", + "marketing", + "lead generation", + "text generation", + "promotional text" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoFlow Water Bottle\",\"targetAudience\":\"Environmentally conscious young adults\",\"tone\":\"friendly\",\"keyBenefits\":[\"sustainable materials\",\"keeps drinks cold for 24 hours\"],\"format\":\"medium\"}", + "description": "Generate a mid-length friendly lead paragraph for an eco-friendly water bottle aimed at young adults." + }, + { + "inputJson": "{\"productName\":\"FinSecurePro\",\"targetAudience\":\"Financial institutions\",\"tone\":\"professional\",\"keyBenefits\":[\"advanced encryption\",\"real-time monitoring\"],\"format\":\"long\"}", + "description": "Create a detailed professional lead paragraph for a financial software focusing on security features." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Lead", + "context": null + } + }, + { + "name": "copywriting.createOpportunity", + "description": "This tool generates persuasive business opportunity descriptions based on input parameters such as industry, target audience, product or service details, and unique selling points. It processes these inputs to produce a clear, engaging marketing copy that outlines the opportunity's value proposition and potential benefits for stakeholders.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "The industry or sector related to the opportunity (e.g., technology, healthcare).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target customers or clients for the opportunity.", + "required": true, + "defaultValue": "" + }, + { + "name": "productOrService", + "type": "string", + "description": "Description of the product or service involved in the opportunity.", + "required": true, + "defaultValue": "" + }, + { + "name": "uniqueSellingPoints", + "type": "array", + "description": "List of key unique selling points or advantages of the opportunity.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "marketTrends", + "type": "string", + "description": "Relevant market trends that support the opportunity, if available.", + "required": false, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action to include at the end of the opportunity description.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing copy describing the business opportunity, including value proposition and benefits." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to craft a clear, compelling business opportunity description for marketing materials, presentations or proposals. It helps translate raw business facts into persuasive copy tailored to a target audience and industry context.", + "limitations": "It cannot replace detailed business analysis or strategic consultation and relies on accurate input data to produce relevant copy.", + "examples": [ + "Generate an opportunity description for a new healthcare app targeting elderly users.", + "Create a business opportunity for a solar energy product focusing on sustainability market trends.", + "Write a persuasive opportunity summary for a tech startup's AI-based chatbot tool." + ] + }, + "tags": [ + "marketing", + "business", + "copywriting", + "opportunity", + "business development", + "sales", + "promotional text", + "B2B" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"Healthcare\",\"targetAudience\":\"elderly patients and caregivers\",\"productOrService\":\"a user-friendly medication management app\",\"uniqueSellingPoints\":[\"easy to use interface\",\"reminder notifications\",\"integration with pharmacies\"],\"marketTrends\":\"growing aging population and increasing use of mobile health tools\",\"callToAction\":\"Contact us for a demo today!\"}", + "description": "Create opportunity copy for a healthcare app aimed at elderly users." + }, + { + "inputJson": "{\"industry\":\"Renewable Energy\",\"targetAudience\":\"homeowners interested in sustainable solutions\",\"productOrService\":\"a compact, affordable solar panel system\",\"uniqueSellingPoints\":[\"cost-effective\",\"easy installation\",\"government incentives available\"],\"marketTrends\":\"rising energy costs and government subsidies for green energy\",\"callToAction\":\"Join the green revolution now!\"}", + "description": "Generate marketing copy for a new solar energy product." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Opportunity", + "context": null + } + }, + { + "name": "copywriting.createCustomer", + "description": "Generates a detailed customer persona description based on provided demographic details, interests, and behaviors. Accepts input parameters defining customer attributes and produces a marketing-ready customer profile text to support targeted copywriting and campaign planning.", + "category": "copywriting", + "parameters": [ + { + "name": "ageRange", + "type": "string", + "description": "Age range of the customer group (e.g., '25-34')", + "required": true, + "defaultValue": "" + }, + { + "name": "gender", + "type": "string", + "description": "Gender identity of the customer group (e.g., 'female', 'male', 'non-binary')", + "required": false, + "defaultValue": "" + }, + { + "name": "location", + "type": "string", + "description": "Geographic location or region of the customer (e.g., 'North America')", + "required": false, + "defaultValue": "" + }, + { + "name": "interests", + "type": "array", + "description": "List of main interests or hobbies of the customer (e.g., ['fitness', 'technology'])", + "required": true, + "defaultValue": "" + }, + { + "name": "incomeLevel", + "type": "string", + "description": "Typical income level of the customer group (e.g., 'middle', 'high')", + "required": false, + "defaultValue": "" + }, + { + "name": "purchaseBehavior", + "type": "string", + "description": "Key purchasing habits or preferences (e.g., 'prefers online shopping')", + "required": false, + "defaultValue": "" + }, + { + "name": "brandAttitudes", + "type": "string", + "description": "Customer's general attitude towards brands (e.g., 'brand loyal', 'value-seeker')", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a comprehensive, narrative customer profile text suitable for use in marketing and advertising copy." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a detailed, humanized customer persona to tailor marketing messages, segment audiences, or inform product positioning. It helps transform raw customer attribute data into engaging descriptions for copywriting purposes.", + "limitations": "This tool does not generate actual customer data but creates fictional personas based on inputs; it cannot replace detailed market research or analytics data.", + "examples": [ + "Create a customer profile for females aged 25-34 interested in fitness and healthy eating living in North America.", + "Generate a buyer persona for middle income tech enthusiasts aged 30-40 who prefer online shopping.", + "Create a customer description for brand loyal males interested in outdoor activities and sustainability aged 20-30." + ] + }, + "tags": [ + "copywriting", + "customerPersona", + "marketing", + "audience", + "profile", + "advertising", + "targeting" + ], + "examples": [ + { + "inputJson": "{\"ageRange\":\"25-34\",\"gender\":\"female\",\"location\":\"North America\",\"interests\":[\"fitness\",\"healthy eating\"],\"incomeLevel\":\"middle\",\"purchaseBehavior\":\"prefers online shopping\",\"brandAttitudes\":\"value-seeker\"}", + "description": "Create a customer persona for middle-income females aged 25-34 in North America interested in fitness and healthy eating, who prefer online shopping and seek value from brands." + }, + { + "inputJson": "{\"ageRange\":\"30-40\",\"gender\":\"male\",\"location\":\"Europe\",\"interests\":[\"technology\",\"gaming\"],\"incomeLevel\":\"high\",\"purchaseBehavior\":\"early adopter\",\"brandAttitudes\":\"brand loyal\"}", + "description": "Generate a customer profile for high-income males aged 30-40 in Europe into technology and gaming, who are early adopters and brand loyal." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Customer", + "context": null + } + }, + { + "name": "copywriting.createScreenshot", + "description": "Generates a high-quality promotional screenshot image for marketing purposes by combining textual content, visual styling, and optional branding elements. Accepts input text, style parameters, and optional images, producing a shareable screenshot image optimized for ads, presentations, or social media.", + "category": "copywriting", + "parameters": [ + { + "name": "headlineText", + "type": "string", + "description": "Primary headline text displayed prominently in the screenshot.", + "required": true, + "defaultValue": "" + }, + { + "name": "subHeadlineText", + "type": "string", + "description": "Supporting subheadline text that appears below the main headline.", + "required": false, + "defaultValue": "" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color of the screenshot in HEX or CSS color names.", + "required": false, + "defaultValue": "#ffffff" + }, + { + "name": "fontFamily", + "type": "string", + "description": "Font family to apply to all text elements.", + "required": false, + "defaultValue": "Arial" + }, + { + "name": "fontSize", + "type": "number", + "description": "Base font size in pixels for headline text.", + "required": false, + "defaultValue": "24" + }, + { + "name": "textColor", + "type": "string", + "description": "Color of the text in HEX or CSS color names.", + "required": false, + "defaultValue": "#000000" + }, + { + "name": "logoImageUrl", + "type": "string", + "description": "URL of an optional logo image to include in the screenshot.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Image output format, e.g., PNG or JPEG.", + "required": false, + "defaultValue": "PNG" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated screenshot image as a base64 encoded string and metadata including format and dimensions." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create marketing-ready, visually appealing screenshots that combine text and optional branding for promotional content such as social media ads, landing pages, or presentations. It automates the generation of styled images from textual input and design parameters.", + "limitations": "Cannot generate complex layouts or interactive elements; limited to static image output. Image quality depends on text length and parameter combinations; does not fetch or verify external URLs for logos.", + "examples": [ + "Create a screenshot with a headline and subheadline on a blue background with white text.", + "Generate a promotional banner including a logo and customized font for a new product release.", + "Produce a simple text-only screenshot optimized for social media advertising." + ] + }, + "tags": [ + "copywriting", + "image generation", + "marketing", + "screenshot", + "promotional", + "branding", + "visual content" + ], + "examples": [ + { + "inputJson": "{\"headlineText\":\"Announcing Our New Product!\",\"subHeadlineText\":\"Innovate your workflow with cutting-edge tech.\",\"backgroundColor\":\"#0047AB\",\"fontFamily\":\"Helvetica\",\"fontSize\":28,\"textColor\":\"#ffffff\",\"logoImageUrl\":\"https://example.com/logo.png\",\"outputFormat\":\"PNG\"}", + "description": "Creates a promotional screenshot with a bold headline, subheadline, blue background, white text, and company logo." + }, + { + "inputJson": "{\"headlineText\":\"Limited Time Offer!\",\"subHeadlineText\":\"Get 50% off until Sunday.\",\"backgroundColor\":\"#ffcc00\",\"fontFamily\":\"Verdana\",\"fontSize\":24,\"textColor\":\"#333333\",\"logoImageUrl\":\"\",\"outputFormat\":\"JPEG\"}", + "description": "Generates a bright promotional image emphasizing a sales offer using yellow background and dark text, without a logo." + }, + { + "inputJson": "{\"headlineText\":\"Join Our Webinar\",\"subHeadlineText\":\"Learn industry secrets from experts.\",\"backgroundColor\":\"#ffffff\",\"fontFamily\":\"Times New Roman\",\"fontSize\":20,\"textColor\":\"#000000\",\"logoImageUrl\":\"\",\"outputFormat\":\"PNG\"}", + "description": "Produces a clean, elegant screenshot with black text on white background promoting a webinar event." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Screenshot", + "context": null + } + }, + { + "name": "copywriting.createGraph", + "description": "Generates compelling, marketing-oriented textual descriptions for various types of graphs based on input data and graph type. Accepts raw numerical or categorical data along with graph metadata, processes key insights, trends, and comparisons, and outputs persuasive copy suitable for promotional or analytical content.", + "category": "copywriting", + "parameters": [ + { + "name": "graphType", + "type": "string", + "description": "Type of graph to describe, such as 'bar', 'line', 'pie', or 'scatter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "object", + "description": "Structured data representing the graph contents, including labels and values.", + "required": true, + "defaultValue": "" + }, + { + "name": "highlightPoints", + "type": "array", + "description": "Specific data points or trends in the graph to emphasize in the copy.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Writing tone for the description, e.g., 'professional', 'casual', 'enthusiastic'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "language", + "type": "string", + "description": "Desired language for the generated text, default is English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words for the generated graph description.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated persuasive graph description text ready for marketing use." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to create engaging and readable copy that explains or promotes graphical data visualizations in marketing materials, presentations, or reports. It is ideal for summarizing data insights in a way that is accessible and persuasive to a non-technical audience.", + "limitations": "The tool cannot generate visual graphs or handle raw image inputs; it focuses solely on textual description. It may not be able to capture deeply complex statistical insights beyond summary-level trends.", + "examples": [ + "Create a compelling description for a bar graph showing quarterly sales growth.", + "Write an enthusiastic copy for a pie chart illustrating market share.", + "Generate a professional summary of a line chart tracking website traffic over a year." + ] + }, + "tags": [ + "copywriting", + "graph description", + "marketing text", + "data storytelling", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"graphType\":\"bar\",\"data\":{\"labels\":[\"Q1\",\"Q2\",\"Q3\",\"Q4\"],\"values\":[15000,18000,22000,25000]},\"highlightPoints\":[\"Q3 and Q4 show significant growth\"],\"tone\":\"enthusiastic\",\"language\":\"en\",\"maxLength\":100}", + "description": "Generating an energetic description for a bar graph illustrating quarterly sales increase." + }, + { + "inputJson": "{\"graphType\":\"pie\",\"data\":{\"labels\":[\"Brand A\",\"Brand B\",\"Brand C\"],\"values\":[45,30,25]},\"highlightPoints\":[\"Brand A leads the market\"],\"tone\":\"professional\",\"language\":\"en\",\"maxLength\":80}", + "description": "Creating a professional summary for a pie chart showing brand market share." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Graph", + "context": null + } + }, + { + "name": "copywriting.createChart", + "description": "Generates descriptive chart content for marketing use by accepting raw chart data and chart type. It analyzes the data, summarizes key insights, and produces engaging promotional text that highlights trends, comparisons, or performance metrics to support marketing campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "chartType", + "type": "string", + "description": "The type of chart (e.g., bar, line, pie) to contextualize the description.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "array", + "description": "An array of objects representing the chart data points, each with labels and numeric values.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Defines the audience for tailoring tone and complexity of the chart text (e.g., general public, executives).", + "required": false, + "defaultValue": "general public" + }, + { + "name": "highlightKeyPoints", + "type": "boolean", + "description": "Whether to emphasize key insights and trends prominently in the generated text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code to generate the chart description text (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing a concise, engaging chart description optimized for marketing or promotional usage." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce compelling written explanations or promotional blurbs for chart data in marketing materials. It is valuable when the visual data needs narrative to engage the audience and communicate insights effectively without manual copywriting.", + "limitations": "Cannot generate actual images or visual charts; output is limited to textual descriptions. It also relies on well-structured input data and may not capture very complex or domain-specific nuances without tailored input.", + "examples": [ + "Create a promotional text for a line chart showing quarterly sales growth.", + "Generate engaging copy describing a pie chart breaking down product category revenue.", + "Write an executive summary highlighting key points from a bar chart comparing market share." + ] + }, + "tags": [ + "copywriting", + "chart", + "marketing", + "content generation", + "data summarization" + ], + "examples": [ + { + "inputJson": "{\"chartType\":\"bar\",\"data\":[{\"label\":\"Q1\",\"value\":150},{\"label\":\"Q2\",\"value\":200},{\"label\":\"Q3\",\"value\":250},{\"label\":\"Q4\",\"value\":300}],\"targetAudience\":\"executives\",\"highlightKeyPoints\":true}", + "description": "Generate executive-focused promotional text describing quarterly sales growth from bar chart data." + }, + { + "inputJson": "{\"chartType\":\"pie\",\"data\":[{\"label\":\"Category A\",\"value\":45},{\"label\":\"Category B\",\"value\":35},{\"label\":\"Category C\",\"value\":20}],\"targetAudience\":\"general public\",\"highlightKeyPoints\":true}", + "description": "Create engaging copy explaining a pie chart illustrating product category revenue distribution." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Chart", + "context": null + } + }, + { + "name": "copywriting.createConfig", + "description": "Generates a structured configuration object for copywriting tasks, allowing specification of tone, target audience, content length, and style preferences. Accepts parameters defining these elements, processes them into a unified JSON config used to guide AI copywriting models or tools. Outputs a JSON configuration ready for integration.", + "category": "copywriting", + "parameters": [ + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy, e.g., 'formal', 'casual', 'friendly', or 'professional'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the copy, such as demographics or buyer persona.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentLength", + "type": "number", + "description": "Approximate target length of the copy in words.", + "required": false, + "defaultValue": "300" + }, + { + "name": "style", + "type": "string", + "description": "Specific stylistic preferences like 'concise', ' humorous', 'technical', or 'storytelling'.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeKeywords", + "type": "array", + "description": "List of keywords or phrases to include in the copy for SEO or emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "excludeWords", + "type": "array", + "description": "List of words or phrases to avoid in the content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') for the copywriting content.", + "required": false, + "defaultValue": "en" + }, + { + "name": "contentType", + "type": "string", + "description": "Type of content to be produced, such as 'blog post', 'ad copy', 'product description'.", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON object containing the full copywriting configuration, consolidating all input parameters in a structured schema for use by copywriting generation services." + }, + "aiAgent": { + "useCase": "Use this tool to create detailed and structured configurations that guide AI-powered copywriting engines, ensuring the generated text matches tone, style, length, audience, and content type requirements for marketing and promotional materials.", + "limitations": "Does not generate actual copywriting text; only provides configuration. It cannot validate audience or stylistic preferences semantics beyond input copying.", + "examples": [ + "Create a config for a friendly, concise blog post targeting young professionals about fintech.", + "Generate a configuration for professional product description copy in English including specific SEO keywords.", + "Set up a config for humorous ad copy aimed at teenagers with a casual tone." + ] + }, + "tags": [ + "copywriting", + "configuration", + "marketing", + "content generation", + "AI prompt", + "text style", + "SEO" + ], + "examples": [ + { + "inputJson": "{\"tone\":\"friendly\",\"targetAudience\":\"young professionals in fintech\",\"contentLength\":500,\"style\":\"concise\",\"includeKeywords\":[\"fintech\",\"investment\"],\"excludeWords\":[\"complex\"],\"language\":\"en\",\"contentType\":\"blog post\"}", + "description": "Configuration for a friendly and concise blog post aimed at young fintech professionals, including SEO keywords." + }, + { + "inputJson": "{\"tone\":\"professional\",\"targetAudience\":\"enterprise customers\",\"contentLength\":300,\"style\":\"technical\",\"includeKeywords\":[\"cloud computing\",\"security\"],\"excludeWords\":[],\"language\":\"en\",\"contentType\":\"product description\"}", + "description": "Config for a professional, technical product description targeting enterprise customers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Config", + "context": null + } + }, + { + "name": "copywriting.createDataset", + "description": "Generates a structured dataset of marketing copy samples tailored for training or testing natural language models. Accepts inputs like target industry, tone, and content type, then creates a labeled dataset with text samples categorized by style, purpose, and format in JSON or CSV format.", + "category": "copywriting", + "parameters": [ + { + "name": "industry", + "type": "string", + "description": "Target industry or domain for marketing copy (e.g., technology, healthcare).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the copy (e.g., formal, casual, persuasive).", + "required": false, + "defaultValue": "informative" + }, + { + "name": "contentTypes", + "type": "array", + "description": "List of marketing content types to include (e.g., slogans, product descriptions, social media posts).", + "required": true, + "defaultValue": "[\"slogans\",\"productDescriptions\"]" + }, + { + "name": "numSamples", + "type": "number", + "description": "Number of text samples to generate per content type.", + "required": false, + "defaultValue": "10" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output dataset file (json or csv).", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated dataset as an array of sample objects and metadata such as industry, tone, and content types." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create diverse, labeled datasets containing marketing copy samples for specific industries and tones, useful for training, testing, or benchmarking NLP and AI copywriting models.", + "limitations": "Cannot guarantee factual accuracy or legal compliance of generated content. May not capture extremely niche or specialized industry jargon fully.", + "examples": [ + "Create a dataset of 20 persuasive slogans and product descriptions for the technology sector.", + "Generate 15 formal healthcare marketing social media posts samples.", + "Produce an informative dataset in json format with 10 product descriptions and 10 slogans for the fashion industry." + ] + }, + "tags": [ + "copywriting", + "dataset", + "marketing", + "NLP", + "training-data", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"industry\":\"technology\",\"tone\":\"persuasive\",\"contentTypes\":[\"slogans\",\"productDescriptions\"],\"numSamples\":5,\"outputFormat\":\"json\"}", + "description": "Generate a dataset with 5 persuasive slogans and product descriptions for the technology industry." + }, + { + "inputJson": "{\"industry\":\"healthcare\",\"contentTypes\":[\"socialMediaPosts\"],\"numSamples\":10,\"outputFormat\":\"csv\"}", + "description": "Create 10 social media post samples for healthcare in CSV format using default tone (informative)." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dataset", + "context": null + } + }, + { + "name": "copywriting.createAttachment", + "description": "Generates a promotional media attachment combining copywriting text with image or video links. Accepts marketing copy, media URLs, attachment type, and optional branding details. Produces a structured attachment object optimized for social media or email campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "copyText", + "type": "string", + "description": "The marketing or promotional text content for the attachment, concise and engaging.", + "required": true, + "defaultValue": "" + }, + { + "name": "mediaUrls", + "type": "array", + "description": "List of URLs pointing to images or videos to include in the attachment.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "attachmentType", + "type": "string", + "description": "The type of media attachment: e.g., 'image', 'video', or 'carousel'.", + "required": true, + "defaultValue": "" + }, + { + "name": "brandName", + "type": "string", + "description": "Optional brand or product name to include in the attachment for branding consistency.", + "required": false, + "defaultValue": "" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call to action phrase to encourage user interaction.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetPlatform", + "type": "string", + "description": "Intended platform for the attachment, e.g., 'email', 'facebook', or 'instagram' to optimize formatting.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the finalized attachment including structured text, embedded media links, formatting metadata, and call to action ready for marketing use." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create ready-to-deploy promotional media attachments that combine compelling copywriting with visual media links, tailored for social media or email marketing channels. It facilitates generating structured, consistent marketing attachments to improve campaign engagement.", + "limitations": "This tool does not generate or host media files; it only organizes provided copy and media URLs into a marketing attachment structure. It cannot validate media URL content or perform visual content analysis.", + "examples": [ + "Create an Instagram image post attachment with marketing copy and brand name.", + "Generate a video attachment with call to action text for email marketing.", + "Build a carousel attachment with multiple images and promotional copy for Facebook." + ] + }, + "tags": [ + "copywriting", + "marketing", + "media", + "attachment", + "social media", + "email marketing", + "promotional content" + ], + "examples": [ + { + "inputJson": "{\"copyText\":\"Discover the future of smart tech with our latest smartwatch! Limited time offer.\",\"mediaUrls\":[\"https://example.com/images/smartwatch.jpg\"],\"attachmentType\":\"image\",\"brandName\":\"SmartTech\",\"callToAction\":\"Shop Now\",\"targetPlatform\":\"instagram\"}", + "description": "An Instagram image attachment promoting a smartwatch with brand and call to action." + }, + { + "inputJson": "{\"copyText\":\"Watch our introduction video to see how our product can change your life.\",\"mediaUrls\":[\"https://example.com/videos/intro.mp4\"],\"attachmentType\":\"video\",\"brandName\":\"LifeChanger\",\"callToAction\":\"Learn More\",\"targetPlatform\":\"email\"}", + "description": "A video attachment for an email campaign containing promotional text and call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Attachment", + "context": null + } + }, + { + "name": "copywriting.createFile", + "description": "Generates a text-based marketing copy file (e.g., TXT, DOCX, PDF) from provided marketing content, tone, and format preferences. Accepts input content and style parameters, processes the text with formatting suitable for the specified file type, and outputs a downloadable file containing the crafted copy ready for distribution or publishing.", + "category": "copywriting", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The main marketing or promotional text content to be included in the file.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the copy such as formal, casual, enthusiastic, or professional.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "fileFormat", + "type": "string", + "description": "Specifies the output file format to generate such as 'txt', 'docx', or 'pdf'.", + "required": true, + "defaultValue": "txt" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to include a header section with branding or title in the file.", + "required": false, + "defaultValue": "false" + }, + { + "name": "headerText", + "type": "string", + "description": "Custom header text to include if header is enabled.", + "required": false, + "defaultValue": "" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size to apply to the text content in the file, applicable for rich formats.", + "required": false, + "defaultValue": "12" + }, + { + "name": "fontName", + "type": "string", + "description": "Name of the font to use in the file for text formatting (if supported).", + "required": false, + "defaultValue": "Arial" + } + ], + "returns": { + "type": "object", + "description": "An object containing the file name and a base64 string representing the encoded file content for download or saving." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to generate a marketing or promotional text document file that can be readily saved, shared, or sent to clients. It is ideal for automating the creation of polished copy files in various formats tailored to desired tone and styling.", + "limitations": "Does not generate graphic content or complex layouts beyond basic text and simple formatting. Cannot create multimedia or interactive files. Precision font styling depends on file format support.", + "examples": [ + "Create a professional PDF file with promotional copy about a new software release.", + "Generate a casual tone TXT file containing event invitation text.", + "Produce a DOCX marketing flyer text file with custom header and font settings." + ] + }, + "tags": [ + "copywriting", + "fileGeneration", + "marketing", + "textFormatting", + "documentCreation", + "promotion", + "contentCreation" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Introducing our latest product, designed to boost your productivity!\",\"tone\":\"enthusiastic\",\"fileFormat\":\"pdf\",\"includeHeader\":true,\"headerText\":\"Product Launch\",\"fontSize\":14,\"fontName\":\"Helvetica\"}", + "description": "Generate an enthusiastic promotional PDF file with a header and custom font." + }, + { + "inputJson": "{\"content\":\"Join us for our annual conference.\",\"tone\":\"casual\",\"fileFormat\":\"txt\",\"includeHeader\":false}", + "description": "Create a simple casual TXT file with invitation text without a header." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "File", + "context": null + } + }, + { + "name": "copywriting.createVideo", + "description": "Generates a short promotional video script and storyboard based on provided marketing content and style preferences. Accepts product descriptions, target audience details, tone, and desired video length, then outputs a storyboard outline with suggested scenes, dialogue, and text overlays for video production.", + "category": "copywriting", + "parameters": [ + { + "name": "productDescription", + "type": "string", + "description": "Detailed description of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience including demographics and interests.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the video, e.g., professional, casual, humorous, inspirational.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "videoLengthSeconds", + "type": "number", + "description": "Approximate length of the video in seconds, typically between 15 and 120 seconds.", + "required": false, + "defaultValue": "60" + }, + { + "name": "callToAction", + "type": "string", + "description": "Specific call-to-action to include at the end of the video, like 'Buy now' or 'Learn more'.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated video script and storyboard consisting of scenes with text, dialogue suggestions, and visual descriptions." + }, + "aiAgent": { + "useCase": "This tool is ideal for generating initial video marketing content for advertising campaigns, social media videos, or product promos when given product details and audience context. It helps quickly produce structured creative outlines for video production teams.", + "limitations": "This tool does not generate actual video media files or animations. It provides textual storyboard and script suggestions, requiring further production work to create final videos.", + "examples": [ + "Create a 30-second inspirational video script for a new smartwatch aimed at tech-savvy professionals.", + "Generate a humorous 15-second storyboard for a snack brand targeting teenagers.", + "Produce a professional promotional video outline highlighting fitness app features for health-conscious adults." + ] + }, + "tags": [ + "copywriting", + "video", + "marketing", + "advertising", + "scriptwriting", + "storyboarding", + "promotional" + ], + "examples": [ + { + "inputJson": "{\"productDescription\":\"A smartwatch with health tracking and seamless smartphone integration.\",\"targetAudience\":\"tech-savvy professionals aged 25-40.\",\"tone\":\"inspirational\",\"videoLengthSeconds\":30,\"callToAction\":\"Order yours today!\"}", + "description": "Generate a motivational and professional 30-second video script promoting a smartwatch." + }, + { + "inputJson": "{\"productDescription\":\"A new crunchy snack brand offering various flavors.\",\"targetAudience\":\"teenagers aged 13-19.\",\"tone\":\"humorous\",\"videoLengthSeconds\":15,\"callToAction\":\"Try it now!\"}", + "description": "Create a short, funny storyboard for a snack targeted to teenagers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Video", + "context": null + } + }, + { + "name": "copywriting.createImage", + "description": "Generates marketing and promotional images based on textual descriptions and branding guidelines. Accepts inputs such as key marketing messages, style preferences, target audience details, and branding colors, then uses these to create visually appealing images suitable for campaigns, advertisements, or social media posts. Outputs a high-resolution image file URL or base64 string.", + "category": "copywriting", + "parameters": [ + { + "name": "textPrompt", + "type": "string", + "description": "A concise description of the marketing message or theme to be visualized in the image.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The artistic or design style to apply to the image (e.g., minimalistic, vintage, modern, futuristic).", + "required": false, + "defaultValue": "modern" + }, + { + "name": "brandColors", + "type": "array", + "description": "List of hex color codes to incorporate in the image following brand guidelines.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Brief description of the target audience (e.g., young adults, professionals) to tailor image tone accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "imageDimensions", + "type": "object", + "description": "An object specifying image width and height in pixels, e.g., {\"width\":1080, \"height\":1080}.", + "required": false, + "defaultValue": "{\"width\":1080,\"height\":1080}" + }, + { + "name": "includeLogo", + "type": "boolean", + "description": "Whether to include the company's logo in the image if logo details are available.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated image as a URL or base64 string and metadata about the image including dimensions and style." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate promotional images for marketing campaigns, social media, advertisements, or product launches by converting marketing messages and brand preferences into visually optimized images. It enables fast creation of visuals aligned with branding and target audience.", + "limitations": "Cannot guarantee compliance with all brand manual specifics especially for complex logos or proprietary fonts. Not suitable for creating photographic or hyper-realistic images from scratch. May require human review for final approval.", + "examples": [ + "Create a modern style promotional image with the phrase 'Summer Sale - 50% OFF' targeting young adults, incorporating brand color #FF5733.", + "Generate a minimalistic social media post image with the text 'Join our Webinar' using brand colors #0044CC and #FFFFFF.", + "Produce a futuristic product launch banner for professionals, 1920x1080 pixels, including company logo." + ] + }, + "tags": [ + "copywriting", + "image generation", + "marketing", + "promotion", + "branding", + "design", + "advertisement" + ], + "examples": [ + { + "inputJson": "{\"textPrompt\":\"Summer Sale - 50% OFF on all items\",\"style\":\"modern\",\"brandColors\":[\"#FF5733\"],\"targetAudience\":\"young adults\",\"imageDimensions\":{\"width\":1080,\"height\":1080},\"includeLogo\":false}", + "description": "Creates a modern styled promotional image for a summer sale targeting young adults with vibrant brand color." + }, + { + "inputJson": "{\"textPrompt\":\"Join our Webinar\",\"style\":\"minimalistic\",\"brandColors\":[\"#0044CC\", \"#FFFFFF\"],\"targetAudience\":\"professionals\",\"imageDimensions\":{\"width\":1200,\"height\":628},\"includeLogo\":true}", + "description": "Generates a minimalistic social media post inviting professionals to join a webinar, including the company logo." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Image", + "context": null + } + }, + { + "name": "copywriting.createHTML", + "description": "Generates marketing and promotional HTML content based on provided text inputs, style preferences, and layout options. Accepts input such as headline, body text, call-to-action details, and style parameters. Outputs an HTML string with semantic structure, inline or linked styles, and responsive design elements suitable for web marketing materials.", + "category": "copywriting", + "parameters": [ + { + "name": "headline", + "type": "string", + "description": "Main headline or title text for the promotional content.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "Primary body or description text detailing the offer or promotion.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToActionText", + "type": "string", + "description": "Text for the call-to-action button or link, e.g., 'Buy Now'.", + "required": true, + "defaultValue": "" + }, + { + "name": "callToActionUrl", + "type": "string", + "description": "URL the call-to-action button or link should point to.", + "required": true, + "defaultValue": "" + }, + { + "name": "themeColor", + "type": "string", + "description": "Hex or named color used for accents and call-to-action button styling.", + "required": false, + "defaultValue": "#007BFF" + }, + { + "name": "includeImageUrl", + "type": "string", + "description": "Optional URL to an image displayed in the promotional HTML block.", + "required": false, + "defaultValue": "" + }, + { + "name": "layoutStyle", + "type": "string", + "description": "Layout style choice, e.g., 'vertical' or 'horizontal' arrangement of elements.", + "required": false, + "defaultValue": "vertical" + }, + { + "name": "responsive", + "type": "boolean", + "description": "Whether to produce responsive HTML designed for mobile and desktop.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated HTML string under the 'html' property." + }, + "aiAgent": { + "useCase": "Use this tool when generating standardized, well-structured promotional HTML content from marketing text inputs, ensuring consistent style and formatting without manual coding. Helpful for automating creation of email campaigns, landing pages, or web advertisements.", + "limitations": "Cannot create complex interactive scripts, animations, or handle rich multimedia beyond basic images. Styling is basic and intended for marketing use cases, not full website development.", + "examples": [ + "Create HTML for a promotional sale with headline, body, call-to-action button linking to a product page, using brand color #FF5733.", + "Generate marketing HTML content with a horizontal layout including an image URL for a new product launch announcement.", + "Provide responsive promotional HTML content with default theme color, featuring a headline, descriptive text, and a signup button linking to a registration page." + ] + }, + "tags": [ + "copywriting", + "HTML", + "marketing", + "promotion", + "template", + "automation", + "web", + "email" + ], + "examples": [ + { + "inputJson": "{\"headline\":\"Summer Sale - Up to 50% Off!\",\"bodyText\":\"Don't miss out on our biggest sale of the year. Shop now and save big on all your favorite products.\",\"callToActionText\":\"Shop Now\",\"callToActionUrl\":\"https://example.com/sale\",\"themeColor\":\"#FF5733\",\"includeImageUrl\":\"https://example.com/images/sale_banner.jpg\",\"layoutStyle\":\"vertical\",\"responsive\":true}", + "description": "Generate a vertical layout HTML promotional block for a summer sale with an image and custom brand color." + }, + { + "inputJson": "{\"headline\":\"Join Our Newsletter!\",\"bodyText\":\"Stay updated with the latest news and exclusive offers. Subscribe today.\",\"callToActionText\":\"Subscribe\",\"callToActionUrl\":\"https://example.com/subscribe\",\"themeColor\":\"#0056b3\",\"layoutStyle\":\"horizontal\",\"responsive\":true}", + "description": "Create a horizontal layout marketing HTML with call-to-action for newsletter subscription." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "HTML", + "context": null + } + }, + { + "name": "copywriting.createAudio", + "description": "Generates a promotional or marketing audio clip based on provided text content and style preferences. Accepts written scripts or summaries and produces a finalized audio file in specified format using text-to-speech synthesis, optionally adding background music or effects.", + "category": "copywriting", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The main script or promotional text to be converted into audio.", + "required": true, + "defaultValue": "" + }, + { + "name": "voiceType", + "type": "string", + "description": "The desired voice profile for narration, e.g., male/female, tone, accent.", + "required": false, + "defaultValue": "neutral-female" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the speech synthesis (e.g., en-US, es-ES).", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "audioFormat", + "type": "string", + "description": "Output audio file format, e.g., mp3, wav, ogg.", + "required": false, + "defaultValue": "mp3" + }, + { + "name": "backgroundMusicUrl", + "type": "string", + "description": "Optional URL to background music track to blend with narration.", + "required": false, + "defaultValue": "" + }, + { + "name": "speechRate", + "type": "number", + "description": "Speed of the speech in words per minute.", + "required": false, + "defaultValue": "150" + }, + { + "name": "includeEffects", + "type": "boolean", + "description": "Whether to add audio effects or enhancements like reverb or equalization.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the audio file URL and metadata about the generated audio clip, including duration and format." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to create marketing or promotional audio content from textual inputs, such as ad scripts, product descriptions, or announcements, producing professional-sounding audio files for campaigns or media.", + "limitations": "Cannot generate original voice acting beyond synthesized voices; background music must be provided via URL; audio quality depends on underlying TTS engine capabilities.", + "examples": [ + "Create an upbeat female voice ad in English with background music in MP3.", + "Generate a Spanish male voice narration from the given promo script without background music.", + "Produce a slow-paced audio announcement file in WAV format with slight echo effect." + ] + }, + "tags": [ + "copywriting", + "audio", + "text-to-speech", + "marketing", + "promotions", + "media", + "voice synthesis" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"Introducing our new product line - efficient, affordable, and eco-friendly! Order now and save 20%.\",\"voiceType\":\"female-standard\",\"language\":\"en-US\",\"audioFormat\":\"mp3\",\"backgroundMusicUrl\":\"https://example.com/music/ambient.mp3\",\"speechRate\":160,\"includeEffects\":true}", + "description": "Generation of a female English promo audio with upbeat background music and subtle audio effects." + }, + { + "inputJson": "{\"textContent\":\"¡Descubre la nueva experiencia con nuestro servicio premium! Calidad y exclusividad a tu alcance.\",\"voiceType\":\"male\",\"language\":\"es-ES\",\"audioFormat\":\"wav\",\"backgroundMusicUrl\":\"\",\"speechRate\":140,\"includeEffects\":false}", + "description": "Creating a Spanish male voice narration for a premium service announcement with no background music." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Audio", + "context": null + } + }, + { + "name": "copywriting.createMarkdown", + "description": "Generates well-structured marketing or promotional content formatted in Markdown. Accepts inputs describing the product or service, target audience, tone, and key points, then produces a ready-to-use Markdown document suitable for blogs, newsletters, or promotional websites.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the content (e.g., demographics, interests).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or benefits to highlight in the content.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the content (e.g., professional, friendly, casual, urgent).", + "required": false, + "defaultValue": "Professional" + }, + { + "name": "callToAction", + "type": "string", + "description": "Call to action phrase or sentence to include at the end of the content.", + "required": false, + "defaultValue": "Learn more and get started today!" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any extra instructions or style guidelines for content generation.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated Markdown content as a string under 'markdownContent'." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to create engaging, market-ready Markdown formatted copy for products or services based on given details and specified tone. It's useful for quickly generating promotional blog posts, feature highlights, and sales copy that can be directly published or edited further.", + "limitations": "The tool cannot verify factual accuracy about the product beyond the given input and may not perfectly capture nuanced brand voice or highly technical content without detailed input.", + "examples": [ + "Create a Markdown promo for a new smartwatch for fitness enthusiasts with a friendly tone.", + "Generate an urgent call-to-action newsletter snippet highlighting limited-time discounts for a software service.", + "Produce a professional product overview in Markdown emphasizing ease of use and security features." + ] + }, + "tags": [ + "copywriting", + "markdown", + "marketing", + "promotional", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Water Bottle\",\"targetAudience\":\"environmentally conscious adults aged 25-45\",\"keyFeatures\":[\"Reusable and eco-friendly\",\"Keeps water cold for 24 hours\",\"BPA-free materials\"],\"tone\":\"friendly\",\"callToAction\":\"Join the green movement—get your EcoClean now!\",\"additionalNotes\":\"Include bullet points and a short intro paragraph.\"}", + "description": "Generate friendly marketing Markdown text for an eco-friendly water bottle targeting adult eco-conscious consumers." + }, + { + "inputJson": "{\"productName\":\"QuickFix Antivirus\",\"targetAudience\":\"small business owners\",\"keyFeatures\":[\"Real-time protection\",\"Automatic updates\",\"24/7 customer support\"],\"tone\":\"professional\",\"callToAction\":\"Protect your business today with QuickFix Antivirus.\",\"additionalNotes\":\"Focus on reliability and business safety.\"}", + "description": "Create a professional Markdown promotional snippet for antivirus software aimed at small businesses." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Markdown", + "context": null + } + }, + { + "name": "copywriting.createYAML", + "description": "Generates a YAML-formatted document that structures marketing copy based on input parameters such as campaign details, target audience, product features, and desired tone. The tool processes descriptive input and outputs a well-organized YAML string suitable for use in marketing automation or content management systems.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignName", + "type": "string", + "description": "The name or title of the marketing campaign.", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "The name of the product or service being promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the marketing copy.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "A list of the product's main features or selling points to highlight.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the copy, e.g., 'professional', 'friendly', 'exciting'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "callToAction", + "type": "string", + "description": "The call-to-action phrase to include at the end of the copy.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string containing the marketing copy formatted as YAML, including sections for campaignName, productName, targetAudience, features, tone, and callToAction." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert structured marketing information into a formatted YAML document that can be integrated with marketing automation tools or content management systems. Ideal for agents tasked with generating templated marketing content with configurable tone and focus.", + "limitations": "This tool generates YAML-formatted text but does not validate the marketing effectiveness or compliance of the content. It cannot create fully original persuasive text beyond basic templates and supplied inputs.", + "examples": [ + "Generate YAML for a friendly tone marketing campaign promoting a new eco-friendly water bottle.", + "Create YAML that organizes product features and includes a clear call to action for a B2B SaaS software.", + "Output marketing copy YAML targeting young professionals with a professional tone and detailed product descriptions." + ] + }, + "tags": [ + "copywriting", + "yaml", + "marketing", + "contentGeneration", + "automation", + "templating" + ], + "examples": [ + { + "inputJson": "{\"campaignName\":\"Summer Sale\",\"productName\":\"Eco Water Bottle\",\"targetAudience\":\"environment-conscious young adults\",\"keyFeatures\":[\"BPA free\",\"Keeps water cold 24 hours\",\"Recyclable materials\"],\"tone\":\"friendly\",\"callToAction\":\"Shop now and save!\"}", + "description": "Generate YAML marketing copy for a summer sale campaign targeting eco-conscious consumers with a friendly tone." + }, + { + "inputJson": "{\"campaignName\":\"Enterprise Cloud Upgrade\",\"productName\":\"CloudPro SaaS\",\"targetAudience\":\"IT professionals and CTOs\",\"keyFeatures\":[\"99.9% uptime\",\"24/7 support\",\"Scalable infrastructure\"],\"tone\":\"professional\",\"callToAction\":\"Request a demo today\"}", + "description": "Create professional tone YAML marketing copy for an enterprise software upgrade campaign." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "YAML", + "context": null + } + }, + { + "name": "copywriting.createXML", + "description": "Creates a structured XML document representing marketing or promotional content. Accepts input as either a JSON object or string describing copywriting elements like headings, paragraphs, calls to action, and metadata. Processes this input to generate a well-formed XML string output suitable for integration with content management systems or marketing automation platforms.", + "category": "copywriting", + "parameters": [ + { + "name": "copyElements", + "type": "object", + "description": "A JSON object representing the structured content elements such as headings, paragraphs, and calls to action to include in the XML.", + "required": true, + "defaultValue": "" + }, + { + "name": "rootElementName", + "type": "string", + "description": "The name of the root XML element enclosing all provided copywriting content.", + "required": false, + "defaultValue": "MarketingContent" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Flag to indicate whether to include metadata such as author, campaign name, and date in the XML output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "metadata", + "type": "object", + "description": "An optional JSON object containing metadata fields like author, campaignName, creationDate to embed in the output XML if includeMetadata is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string containing a well-formed XML document representing the input copywriting content and optional metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to transform structured marketing or promotional text data into a standardized XML format. This is useful in workflows where copywriting content must be interoperable with XML-based CMS, automated marketing tools, or for export to external platforms requiring XML input.", + "limitations": "This tool does not perform copywriting creativity or natural language generation; it requires well-structured input describing the content elements. It also does not validate XML schemas beyond well-formedness and assumes simple hierarchical XML structures.", + "examples": [ + "Create an XML representation of a promotional headline, body text, and call to action for a product launch.", + "Generate an XML document including campaign metadata for marketing automation import.", + "Transform provided JSON-formatted marketing copy into XML format for CMS ingestion." + ] + }, + "tags": [ + "copywriting", + "XML", + "marketing", + "content generation", + "data transformation", + "promotion" + ], + "examples": [ + { + "inputJson": "{\"copyElements\":{\"heading\":\"Introducing the Future\",\"paragraphs\":[\"Our latest product revolutionizes your workflow.\"],\"callToAction\":\"Buy Now\"},\"rootElementName\":\"AdContent\",\"includeMetadata\":true,\"metadata\":{\"author\":\"Jane Doe\",\"campaignName\":\"Launch2024\",\"creationDate\":\"2024-06-01\"}}", + "description": "Generate XML for a promotional ad with heading, paragraph, CTA, and campaign metadata." + }, + { + "inputJson": "{\"copyElements\":{\"heading\":\"Summer Sale\",\"paragraphs\":[\"Save up to 50% on select items!\"],\"callToAction\":\"Shop Today\"},\"rootElementName\":\"Promo\",\"includeMetadata\":false}", + "description": "Create a simple XML document for a summer sale promotion without metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "XML", + "context": null + } + }, + { + "name": "copywriting.createJSON", + "description": "Generates a structured JSON object containing marketing copy elements based on given input parameters such as product name, target audience, key features, and tone of voice. It processes inputs to produce organized promotional text segments suitable for use in marketing campaigns, ads, or content strategies.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "A brief description of the intended audience for the marketing copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "An array of key features or benefits to highlight in the marketing copy.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style for the copy such as professional, casual, humorous, or inspirational.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "callToAction", + "type": "string", + "description": "A call to action phrase or sentence to encourage user engagement or purchase.", + "required": false, + "defaultValue": "Buy now!" + } + ], + "returns": { + "type": "object", + "description": "A JSON object containing segmented fields for headline, body copy, features list, and call to action, formatted for immediate use in marketing materials." + }, + "aiAgent": { + "useCase": "Use this tool when generating structured marketing copy tailored to a specific product and audience. It helps encapsulate key messaging elements in JSON format for easy integration with other systems or further processing.", + "limitations": "This tool does not generate long-form articles or SEO optimized content. It focuses on concise promotional copy snippets only.", + "examples": [ + "Create marketing JSON for a new smartphone aimed at young professionals, highlighting speed and camera features with a casual tone.", + "Generate promotional copy JSON for an organic skincare line targeting eco-conscious consumers with an inspirational style.", + "Produce marketing content JSON for a productivity app emphasizing ease of use and time-saving features using a professional tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "JSON", + "promotional-text", + "content-generation", + "product-description" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSmart Water Bottle\",\"targetAudience\":\"environmentally conscious consumers\",\"keyFeatures\":[\"Keeps water cold for 24 hours\",\"Made from recycled materials\",\"Leak-proof design\"],\"tone\":\"inspirational\",\"callToAction\":\"Join the green revolution today!\"}", + "description": "Generate inspirational marketing copy JSON for an eco-friendly water bottle targeting green consumers." + }, + { + "inputJson": "{\"productName\":\"FastTrack Laptop\",\"targetAudience\":\"tech-savvy professionals\",\"keyFeatures\":[\"Lightning fast SSD\",\"Ultra HD display\",\"Long battery life\"],\"tone\":\"professional\",\"callToAction\":\"Upgrade your workflow now!\"}", + "description": "Create professional marketing JSON for a high-performance laptop aimed at professionals." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "JSON", + "context": null + } + }, + { + "name": "copywriting.createCSV", + "description": "Generates a CSV string containing marketing copy entries based on provided input prompts, keywords, or themes. Accepts an array of texts or topics and produces a structured CSV where each row represents a distinct marketing message, suitable for bulk editing or content planning.", + "category": "copywriting", + "parameters": [ + { + "name": "entries", + "type": "array", + "description": "An array of objects each containing 'headline' and optionally 'description' strings to be converted into CSV rows.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include CSV column headers in the output. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character to separate CSV values (e.g., comma, semicolon). Default is comma (,).", + "required": false, + "defaultValue": "," + } + ], + "returns": { + "type": "string", + "description": "A CSV formatted string representing the marketing copy entries." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to convert generated or curated marketing copy ideas into a structured CSV format for workflows like bulk upload, editing in spreadsheets, or integration with marketing platforms.", + "limitations": "This tool only creates CSV formatted text and does not generate marketing copy content itself. It assumes input entries are pre-generated or curated and does not validate the marketing effectiveness of the copy.", + "examples": [ + "Create a CSV from a list of marketing headlines for email campaign.", + "Export product promotion titles and descriptions into CSV for team review.", + "Generate a CSV file from given marketing slogans with descriptions included." + ] + }, + "tags": [ + "copywriting", + "csv", + "marketing", + "content export", + "bulk processing" + ], + "examples": [ + { + "inputJson": "{\"entries\":[{\"headline\":\"Boost Your Sales Now!\",\"description\":\"Use our platform to increase conversions.\"},{\"headline\":\"Limited Time Offer\",\"description\":\"Grab the deal before it expires.\"}],\"includeHeaders\":true,\"delimiter\":\",\"}", + "description": "Create CSV including headers from a list of marketing headlines and descriptions." + }, + { + "inputJson": "{\"entries\":[{\"headline\":\"Eco-Friendly Products\"},{\"headline\":\"Sustainable Living Tips\"}],\"includeHeaders\":false,\"delimiter\":\";\"}", + "description": "Generate CSV without headers using semicolon as delimiter from headlines only." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "CSV", + "context": null + } + }, + { + "name": "copywriting.createWorkflow", + "description": "This tool generates a step-by-step copywriting workflow tailored for marketing campaigns. It accepts input parameters defining the campaign goals, target audience, content type, and desired channels. It produces a detailed, practical workflow outlining phases such as research, drafting, reviews, and distribution to streamline content creation and maximize promotional effectiveness.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignGoal", + "type": "string", + "description": "The primary objective of the marketing campaign (e.g., brand awareness, lead generation).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience including demographics and interests.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentType", + "type": "string", + "description": "Type of content to create, such as blog posts, social media posts, or email newsletters.", + "required": true, + "defaultValue": "" + }, + { + "name": "distributionChannels", + "type": "array", + "description": "List of channels where content will be published (e.g., Facebook, email, blog).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeSEO", + "type": "boolean", + "description": "Whether to integrate SEO best practices in the workflow phases.", + "required": false, + "defaultValue": "false" + }, + { + "name": "workflowDetailLevel", + "type": "string", + "description": "Level of detail desired in the workflow: 'basic', 'intermediate', or 'detailed'.", + "required": false, + "defaultValue": "basic" + } + ], + "returns": { + "type": "object", + "description": "An object describing the copywriting workflow with ordered phases, detailed actions per phase, and tips for execution." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a structured copywriting process tailored to specific campaign goals, audience, and content types. It helps automate planning and ensures marketing content creation follows efficient, best-practice steps.", + "limitations": "It does not generate the actual copy content; rather, it outlines the process. It cannot customize workflows for highly specialized or niche industries without further input.", + "examples": [ + "Create a workflow for a social media campaign aimed at millennials to increase brand engagement with detailed steps.", + "Generate a basic copywriting workflow for email newsletters targeting small business owners with SEO considerations.", + "Provide an intermediate-level workflow for blog post creation focusing on lead generation distributed via company website." + ] + }, + "tags": [ + "copywriting", + "workflow", + "marketing", + "content creation", + "automation", + "campaign planning", + "SEO integration" + ], + "examples": [ + { + "inputJson": "{\"campaignGoal\":\"brand awareness\",\"targetAudience\":\"young adults ages 18-24 interested in fitness and wellness\",\"contentType\":\"social media posts\",\"distributionChannels\":[\"Instagram\",\"TikTok\"],\"includeSEO\":true,\"workflowDetailLevel\":\"detailed\"}", + "description": "A detailed social media copywriting workflow designed for a fitness brand targeting young adults on Instagram and TikTok with SEO best practices included." + }, + { + "inputJson": "{\"campaignGoal\":\"lead generation\",\"targetAudience\":\"small business owners\",\"contentType\":\"email newsletters\",\"distributionChannels\":[\"email\"],\"includeSEO\":false,\"workflowDetailLevel\":\"basic\"}", + "description": "A basic email newsletter copywriting workflow aimed at generating leads from small business owners without SEO integration." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Workflow", + "context": null + } + }, + { + "name": "copywriting.createTable", + "description": "Generates a marketing or promotional content table based on specified headers and data points, organizing key product or service attributes into a structured, readable table format for use in copywriting contexts. Accepts headers and rows as inputs and outputs formatted table text.", + "category": "copywriting", + "parameters": [ + { + "name": "headers", + "type": "array", + "description": "An array of strings defining the column headers for the table. These represent key marketing attributes or categories.", + "required": true, + "defaultValue": "" + }, + { + "name": "rows", + "type": "array", + "description": "An array of arrays, each inner array representing a row of string values corresponding to the headers. These contain the marketing details or comparisons.", + "required": true, + "defaultValue": "" + }, + { + "name": "tableFormat", + "type": "string", + "description": "The desired table format: 'markdown', 'html', or 'plain' for different output styles.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "If true, appends a brief summary paragraph below the table highlighting key selling points.", + "required": false, + "defaultValue": "false" + }, + { + "name": "summaryTone", + "type": "string", + "description": "Tone or style for the optional summary text, e.g., 'professional', 'casual', or 'enthusiastic'. Used only if includeSummary is true.", + "required": false, + "defaultValue": "professional" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'tableText' which includes the generated table in the selected format as a string. If summary is included, it is appended as text below the table." + }, + "aiAgent": { + "useCase": "Use this tool when marketing content needs a clear, well-structured table summarizing product features, comparisons, or benefits. It helps generate formatted tables with consistent style to enhance promotional materials, sales sheets, or online listings, especially when input data is organized in key-value form.", + "limitations": "It does not generate the content values themselves; it requires fully provided header and row data. It cannot create graphical tables or images, only text-based tables in specified formats.", + "examples": [ + "Create a markdown table comparing three software plans with key features.", + "Generate an HTML table to showcase product specs for an e-commerce page.", + "Produce a plain text table listing benefits and drawbacks of a service including a casual summary paragraph." + ] + }, + "tags": [ + "copywriting", + "table", + "marketing", + "promotion", + "content-generation", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"headers\":[\"Plan\",\"Price\",\"Storage\",\"Support\"],\"rows\":[[\"Basic\",\"$5/mo\",\"10GB\",\"Email\"],[\"Pro\",\"$15/mo\",\"100GB\",\"Phone & Email\"],[\"Enterprise\",\"Custom\",\"1TB+\",\"24/7 Dedicated\"]],\"tableFormat\":\"markdown\",\"includeSummary\":true,\"summaryTone\":\"professional\"}", + "description": "Generate a markdown table comparing subscription plans with a professional summary." + }, + { + "inputJson": "{\"headers\":[\"Feature\",\"Standard\",\"Premium\"],\"rows\":[[\"Availability\",\"9am-5pm\",\"24/7\"],[\"Backup\",\"Weekly\",\"Daily\"],[\"Customizable\",\"No\",\"Yes\"]],\"tableFormat\":\"html\",\"includeSummary\":false}", + "description": "Create an HTML table showing feature differences between service tiers without summary." + }, + { + "inputJson": "{\"headers\":[\"Benefit\",\"Description\"],\"rows\":[[\"Fast Setup\",\"Get started in minutes\"],[\"Affordable\",\"Low monthly costs\"],[\"Reliable\",\"99.9% uptime guarantee\"]],\"tableFormat\":\"plain\",\"includeSummary\":true,\"summaryTone\":\"enthusiastic\"}", + "description": "Build a plain text table listing benefits with an enthusiastic summary." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Table", + "context": null + } + }, + { + "name": "copywriting.createPullRequest", + "description": "Generates a well-structured, persuasive pull request description for code changes, given code context and objectives. Accepts inputs describing the code changes, purpose, and key points, and produces a polished PR message that concisely explains what the change does and why it matters.", + "category": "copywriting", + "parameters": [ + { + "name": "branchName", + "type": "string", + "description": "The name of the branch for which the pull request is being created, to provide context.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeSummary", + "type": "string", + "description": "A brief summary of the changes introduced by this code update or feature.", + "required": true, + "defaultValue": "" + }, + { + "name": "changeDetails", + "type": "string", + "description": "Detailed explanation of what the code changes, including features, fixes, or improvements.", + "required": true, + "defaultValue": "" + }, + { + "name": "motivation", + "type": "string", + "description": "The core reason or motivation behind making these changes, e.g., bug fix, enhancement, refactor.", + "required": false, + "defaultValue": "" + }, + { + "name": "impact", + "type": "string", + "description": "Description of the potential impact or benefits this change will have on the project or users.", + "required": false, + "defaultValue": "" + }, + { + "name": "relatedIssues", + "type": "array", + "description": "List of related issue identifiers or references to link in the pull request description.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated pull request title and body text, ready to be used as the PR message." + }, + "aiAgent": { + "useCase": "Use this tool when creating pull requests that require clear and effective communication about the code changes. It helps summarize technical updates into professional and persuasive messages for reviewers.", + "limitations": "This tool cannot create or submit the pull request on the version control platform; it focuses solely on generating the textual description. It may not capture highly project-specific conventions without tailored prompts.", + "examples": [ + "Create a PR description for a feature branch adding user authentication with OAuth integration.", + "Generate a pull request message summarizing a bug fix for a memory leak issue and referencing the related ticket.", + "Produce a PR description for code refactoring to improve API response times without changing functionality." + ] + }, + "tags": [ + "copywriting", + "pull request", + "code collaboration", + "developer tools", + "automation" + ], + "examples": [ + { + "inputJson": "{\"branchName\":\"feature/oauth-login\",\"codeSummary\":\"Implemented OAuth user login.\",\"changeDetails\":\"Added OAuth2 authentication flow with Google and Facebook providers, including token handling and session management.\",\"motivation\":\"To simplify user login and increase security by using established OAuth providers.\",\"impact\":\"Improves user onboarding and reduces password management risks.\",\"relatedIssues\":[\"#123\",\"#124\"]}", + "description": "Create a PR message for implementing OAuth login." + }, + { + "inputJson": "{\"branchName\":\"bugfix/memory-leak\",\"codeSummary\":\"Fixed memory leak in cache module.\",\"changeDetails\":\"Refactored cache invalidation to properly release references, preventing memory bloat over time.\",\"motivation\":\"Resolve report of increasing memory consumption causing crashes.\",\"impact\":\"Enhances stability and performance under heavy load.\",\"relatedIssues\":[\"#200\"]}", + "description": "Generate a PR description for fixing a memory leak issue." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "PullRequest", + "context": null + } + }, + { + "name": "copywriting.createPipeline", + "description": "Constructs a customizable sequence (pipeline) of content generation and editing steps tailored for marketing and promotional copywriting. Takes an array of task modules (e.g., idea generation, drafting, SEO optimization, headline creation) as input, processes them in order, and outputs the final polished copy text along with metadata about each step's output.", + "category": "copywriting", + "parameters": [ + { + "name": "tasks", + "type": "array", + "description": "An ordered list of copywriting task modules to include in the pipeline, e.g. 'generateIdea','draftContent','seoOptimize','createHeadline'. Each task will be executed sequentially.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for which the copy should be tailored, influencing the tone and style of the generated text.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy such as 'formal', 'friendly', 'urgent', etc., affecting language style at various pipeline steps.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "keywords", + "type": "array", + "description": "List of SEO or thematic keywords that should be incorporated into the copy when relevant, enhancing SEO optimization steps.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the final copy output in characters to constrain verbosity.", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "An object containing the final polished copy text and a breakdown of outputs from each pipeline step for review and auditing." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically build and run a series of marketing copywriting operations as a workflow, enabling complex tailored content generation with different stylistic and functional enhancements. Ideal when a consistent multi-step process is required rather than a single stand-alone generation.", + "limitations": "This tool cannot execute custom code tasks beyond predefined copywriting steps and is limited to sequential linear pipelines. It does not provide direct analytics or A/B testing capabilities within the pipeline.", + "examples": [ + "Create a pipeline with idea generation, draft writing, SEO keyword insertion, headline creation for a youthful audience.", + "Build a copywriting flow with a formal tone including content drafting and proofreading steps.", + "Generate a promotional email copy pipeline limited to 500 characters embedding provided keywords." + ] + }, + "tags": [ + "copywriting", + "pipeline", + "marketing", + "content-generation", + "seo", + "automation" + ], + "examples": [ + { + "inputJson": "{\"tasks\":[\"generateIdea\",\"draftContent\",\"seoOptimize\",\"createHeadline\"],\"targetAudience\":\"young adults interested in technology\",\"tone\":\"friendly\",\"keywords\":[\"innovative\",\"smart devices\"],\"maxLength\":800}", + "description": "Create a pipeline that generates ideas, drafts content, optimizes it with provided keywords, and creates a headline for young, tech-savvy adults." + }, + { + "inputJson": "{\"tasks\":[\"draftContent\",\"proofreadContent\"],\"tone\":\"formal\",\"maxLength\":1000}", + "description": "Build a two-step pipeline to draft and proofread formal tone copy limited to 1000 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Pipeline", + "context": null + } + }, + { + "name": "copywriting.createIssue", + "description": "This tool generates a clear and concise issue description for software development or project management purposes. It accepts inputs such as issue title, problem summary, impact description, environment details, and reproduction steps, then composes a well-structured issue report suitable for use in code repositories or tracking systems.", + "category": "copywriting", + "parameters": [ + { + "name": "issueTitle", + "type": "string", + "description": "A brief, descriptive title for the issue.", + "required": true, + "defaultValue": "" + }, + { + "name": "problemSummary", + "type": "string", + "description": "A concise summary of the problem experienced.", + "required": true, + "defaultValue": "" + }, + { + "name": "impactDescription", + "type": "string", + "description": "Details explaining the issue's impact on the system or users.", + "required": false, + "defaultValue": "" + }, + { + "name": "environmentDetails", + "type": "string", + "description": "Information about the environment where the issue occurs (e.g., OS, software version).", + "required": false, + "defaultValue": "" + }, + { + "name": "reproductionSteps", + "type": "array", + "description": "Step-by-step instructions to reproduce the issue.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted issue report with title and detailed description ready to be used in issue trackers." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create clear, well-structured issue reports for software bugs or feature requests based on fragmented user input. It ensures clarity and completeness, facilitating better understanding by developers and stakeholders.", + "limitations": "Cannot verify technical accuracy or automatically detect issues from code; relies on user-provided inputs for content generation.", + "examples": [ + "Create an issue for a bug where the app crashes on startup with steps to reproduce.", + "Generate a feature request issue describing desired functionality with its benefits." + ] + }, + "tags": [ + "copywriting", + "issue", + "software", + "bug report", + "feature request", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"issueTitle\":\"App crashes on startup\",\"problemSummary\":\"Application crashes immediately after launching.\",\"impactDescription\":\"Prevents users from accessing the app, causing loss of productivity.\",\"environmentDetails\":\"iOS 15.2, app version 1.3.5\",\"reproductionSteps\":[\"Open the app\",\"Observe crash within 2 seconds\"]}", + "description": "Create a bug issue report for an app crashing on startup with detailed reproduction steps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Issue", + "context": null + } + }, + { + "name": "copywriting.createBranch", + "description": "Generates compelling and targeted promotional copy for marketing a new software branch or feature update. Accepts inputs describing the branch name, key features, target audience, and desired tone. Processes this data to produce a concise marketing text suitable for release notes, announcements, or campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "branchName", + "type": "string", + "description": "Name of the software branch or feature update to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of main features or improvements in the branch.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or user segment for this branch.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone for the promotional copy, e.g., professional, casual, enthusiastic.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated promotional text in characters.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated promotional copy text as a string under the property 'promotionalText'." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create persuasive and engaging marketing or promotional copy specifically tailored to announce or describe a new software branch or feature update. It assists in quickly generating audience-appropriate copy highlighting key improvements and benefits without manual writing.", + "limitations": "Cannot generate technical documentation or detailed release notes; it focuses on marketing-oriented, concise promotional text rather than exhaustive technical details.", + "examples": [ + "Create an enthusiastic promotional blurb for a new mobile app version called 'Velocity v2.0' highlighting speed improvements and new UI.", + "Generate a professional marketing text announcing the 'DataSync Branch' aimed at enterprise users focusing on security enhancements.", + "Write a casual, succinct promotion for a 'Night mode feature branch' targeting young, tech-savvy users." + ] + }, + "tags": [ + "copywriting", + "marketing", + "promotional text", + "software branch", + "feature announcement", + "advertising" + ], + "examples": [ + { + "inputJson": "{\"branchName\":\"Velocity v2.0\",\"keyFeatures\":[\"50% faster load times\",\"Redesigned user interface\",\"Improved battery efficiency\"],\"targetAudience\":\"mobile app users\",\"tone\":\"enthusiastic\",\"maxLength\":250}", + "description": "Generate an enthusiastic marketing blurb for a new app version highlighting speed, UI, and battery improvements." + }, + { + "inputJson": "{\"branchName\":\"DataSync Branch\",\"keyFeatures\":[\"End-to-end encryption\",\"Enterprise-grade access control\",\"Optimized sync performance\"],\"targetAudience\":\"enterprise clients\",\"tone\":\"professional\"}", + "description": "Create a professional promotional text for an enterprise-focused software branch emphasizing security and performance." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Branch", + "context": null + } + }, + { + "name": "copywriting.createCommit", + "description": "Generates a concise, clear, and contextually relevant git commit message based on a provided description of code changes. Accepts a natural language summary or list of code modifications and produces a professional commit message following best practices.", + "category": "copywriting", + "parameters": [ + { + "name": "changeDescription", + "type": "string", + "description": "Natural language description of the code changes or update summary to base the commit message on.", + "required": true, + "defaultValue": "" + }, + { + "name": "type", + "type": "string", + "description": "Type of commit (e.g., feat, fix, docs, style, refactor, test, chore) to categorize the change.", + "required": false, + "defaultValue": "feat" + }, + { + "name": "scope", + "type": "string", + "description": "Optional scope or component affected by the commit (e.g., 'auth', 'UI').", + "required": false, + "defaultValue": "" + }, + { + "name": "breakingChange", + "type": "boolean", + "description": "Marks if the commit introduces a breaking change, adding 'BREAKING CHANGE:' in body.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted commit message string adhering to conventional commit standards." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate commit message generation for code changes described in natural language, ensuring messages are standardized, clear, and useful for version control history. Ideal for CI/CD pipelines, automated PRs, or assisting developers in writing better commit messages.", + "limitations": "Cannot verify the accuracy of commit messages against actual code diffs; quality depends on the input description clarity. Does not generate code diffs or analyze code quality.", + "examples": [ + "Generate a commit message for fixing a login bug described as 'Fix null pointer exception when user logs in without profile picture'", + "Create a commit message for adding user profile page with description 'Add new user profile page with editable details'", + "Generate a commit message marking a breaking change when removing deprecated API endpoints." + ] + }, + "tags": [ + "copywriting", + "commit", + "version control", + "automation", + "devops", + "conventional commits" + ], + "examples": [ + { + "inputJson": "{\"changeDescription\":\"Fix null pointer exception when user logs in without profile picture\",\"type\":\"fix\",\"scope\":\"auth\",\"breakingChange\":false}", + "description": "Generate a commit message for a bug fix in the authentication module." + }, + { + "inputJson": "{\"changeDescription\":\"Add new user profile page with editable details\",\"type\":\"feat\",\"scope\":\"UI\",\"breakingChange\":false}", + "description": "Generate a commit message for a new feature adding a user profile page." + }, + { + "inputJson": "{\"changeDescription\":\"Remove deprecated API endpoints causing conflicts\",\"type\":\"refactor\",\"scope\":\"api\",\"breakingChange\":true}", + "description": "Generate a commit message for a breaking change removing deprecated APIs." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Commit", + "context": null + } + }, + { + "name": "copywriting.createVariable", + "description": "Generates a well-crafted variable name and optionally a description text for use in code or templates based on a provided concept or value description. Accepts input describing the intended use or meaning of the variable, then creates clear, concise, code-appropriate variable names and explanation text to improve readability and maintainability.", + "category": "copywriting", + "parameters": [ + { + "name": "conceptDescription", + "type": "string", + "description": "Brief textual description of the concept or value that the variable should represent, e.g. 'number of items in cart' or 'user login status'.", + "required": true, + "defaultValue": "" + }, + { + "name": "variableType", + "type": "string", + "description": "Data type of the variable, e.g. 'string', 'number', 'boolean' to guide name appropriateness.", + "required": false, + "defaultValue": "string" + }, + { + "name": "style", + "type": "string", + "description": "Naming style to apply, e.g. 'camelCase', 'snake_case', 'PascalCase' for variable name formatting.", + "required": false, + "defaultValue": "camelCase" + }, + { + "name": "includeDescription", + "type": "boolean", + "description": "Whether to output a descriptive comment or human-readable explanation alongside the variable name.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated variable name as a string and optionally a descriptive text explaining the variable purpose." + }, + "aiAgent": { + "useCase": "Use this tool when generating or suggesting meaningful and consistent variable names for marketing copywriting templates, scripts, or any code-related variables. Helps enforce best naming practices and clarity in code and copywriting projects.", + "limitations": "Does not generate actual variable values or code, only name suggestions and explanations. Not suited for very complex variable naming that requires domain-specific knowledge beyond provided description.", + "examples": [ + "Create a variable name for a user’s current subscription plan", + "Generate a boolean variable indicating product availability", + "Get a descriptive variable name for number of clicks on a promotion button" + ] + }, + "tags": [ + "copywriting", + "variableNaming", + "code", + "namingConvention", + "automation", + "codeQuality" + ], + "examples": [ + { + "inputJson": "{\"conceptDescription\":\"number of items in shopping cart\",\"variableType\":\"number\",\"style\":\"camelCase\",\"includeDescription\":true}", + "description": "Generate a camelCase variable name and description for 'number of items in shopping cart' as a number type." + }, + { + "inputJson": "{\"conceptDescription\":\"user login status\",\"variableType\":\"boolean\",\"style\":\"snake_case\",\"includeDescription\":false}", + "description": "Generate a snake_case variable name without description for a boolean variable representing user login status." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Variable", + "context": null + } + }, + { + "name": "copywriting.createPackage", + "description": "Generates a complete marketing copywriting package tailored for a product or service. Accepts inputs such as product details, target audience, tone, and key features, then produces multiple copy components including taglines, product descriptions, and social media posts designed for persuasive marketing.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to be promoted.", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "A detailed description of the product or service highlighting its main features and benefits.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The primary audience or customer segment that the copy should appeal to.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the marketing copy, e.g., enthusiastic, professional, casual, luxurious.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "An array of key product features or unique selling points to emphasize in the copy.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the output copy, e.g., 'en' for English, 'es' for Spanish.", + "required": false, + "defaultValue": "en" + }, + { + "name": "socialPlatforms", + "type": "array", + "description": "List of social media platforms for which to generate specific posts, e.g., ['twitter','facebook'].", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing several marketing copy components such as tagline, productDescription, socialMediaPosts keyed by platform." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents tasked with supporting marketing teams or small businesses by generating a comprehensive set of promotional texts quickly from minimal product input, streamlining the content creation process across multiple channels.", + "limitations": "The tool cannot create visual assets, perform competitive analysis, or guarantee marketing effectiveness. It generates text based solely on provided inputs without real-time market data.", + "examples": [ + "Create a marketing copy package for a new fitness tracker aimed at health-conscious millennials with an enthusiastic tone.", + "Generate promotional texts for an eco-friendly detergent targeting environmentally aware consumers using a professional tone.", + "Produce social media post ideas for a luxury watch across Twitter and Instagram with a luxurious tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "content-creation", + "package", + "promotional-text", + "automation", + "social-media" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoClean Detergent\",\"productDescription\":\"A biodegradable, non-toxic detergent that cleans clothes effectively without harming the environment.\",\"targetAudience\":\"environmentally conscious families\",\"tone\":\"professional\",\"keyFeatures\":[\"biodegradable\",\"non-toxic\",\"high performance\"],\"language\":\"en\",\"socialPlatforms\":[\"facebook\",\"instagram\"]}", + "description": "Generate full marketing package for EcoClean targeting eco-conscious families with professional tone and social media posts for Facebook and Instagram." + }, + { + "inputJson": "{\"productName\":\"FitPro X1 Fitness Tracker\",\"productDescription\":\"A sleek fitness tracker with heart rate monitoring, GPS, and sleep tracking features.\",\"targetAudience\":\"millennials into fitness and tech\",\"tone\":\"enthusiastic\",\"keyFeatures\":[\"heart rate monitor\",\"GPS\",\"sleep tracking\"],\"language\":\"en\",\"socialPlatforms\":[\"twitter\"]}", + "description": "Create marketing copy for FitPro X1 fitness tracker targeting millennials, include enthusiastic tone and Twitter posts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Package", + "context": null + } + }, + { + "name": "copywriting.createEndpoint", + "description": "Generates a clear and persuasive API endpoint documentation snippet based on input details such as endpoint path, method, parameters, description, and response format. It transforms technical input into marketing-style copy suitable for product docs, developer portals, or promotional materials.", + "category": "copywriting", + "parameters": [ + { + "name": "endpointPath", + "type": "string", + "description": "The URL path of the API endpoint (e.g., /users/{id}).", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "The HTTP method used by the endpoint (e.g., GET, POST).", + "required": true, + "defaultValue": "" + }, + { + "name": "summary", + "type": "string", + "description": "A brief high-level summary of what the endpoint does, for promotional style text.", + "required": true, + "defaultValue": "" + }, + { + "name": "detailedDescription", + "type": "string", + "description": "A longer technical description of the endpoint's functionality and purpose.", + "required": false, + "defaultValue": "" + }, + { + "name": "parametersDescription", + "type": "array", + "description": "An array of objects describing each input parameter with fields: name (string), type (string), required (boolean), and description (string).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "responseDescription", + "type": "string", + "description": "Description of the typical response content and success criteria.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object with a 'marketingCopy' string containing the generated endpoint description in clear, persuasive, marketing style." + }, + "aiAgent": { + "useCase": "Use this tool when you need to transform raw API technical details into friendly, engaging marketing copy or user-facing documentation for an API endpoint. It is ideal for developer portals, product releases, or marketing materials to explain technical endpoints in an accessible way.", + "limitations": "This tool does not generate actual code or validate API schema correctness. It focuses solely on clear marketing-style textual descriptions and does not cover complex technical specifications or security details.", + "examples": [ + "Generate a user-friendly description for a GET /users/{id} API endpoint that retrieves user details.", + "Create a marketing snippet describing the POST /orders endpoint for creating new orders with parameters and response info." + ] + }, + "tags": [ + "copywriting", + "documentation", + "api", + "endpoint", + "marketing", + "developer-portal" + ], + "examples": [ + { + "inputJson": "{\"endpointPath\":\"/users/{id}\",\"httpMethod\":\"GET\",\"summary\":\"Retrieve user details\",\"detailedDescription\":\"Fetches detailed information for a user specified by the user ID.\",\"parametersDescription\":[{\"name\":\"id\",\"type\":\"string\",\"required\":true,\"description\":\"Unique identifier for the user.\"}],\"responseDescription\":\"Returns user profile including name, email, and account status.\"}", + "description": "Marketing copy generation for GET /users/{id} endpoint." + }, + { + "inputJson": "{\"endpointPath\":\"/orders\",\"httpMethod\":\"POST\",\"summary\":\"Create a new order\",\"detailedDescription\":\"Allows clients to create new orders by submitting product and quantity information.\",\"parametersDescription\":[{\"name\":\"productId\",\"type\":\"string\",\"required\":true,\"description\":\"ID of the product to order.\"},{\"name\":\"quantity\",\"type\":\"number\",\"required\":true,\"description\":\"Number of units to order.\"}],\"responseDescription\":\"Returns the order confirmation with order ID and estimated delivery date.\"}", + "description": "Marketing copy for POST /orders endpoint to create new orders." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Endpoint", + "context": null + } + }, + { + "name": "copywriting.createDependency", + "description": "This tool generates persuasive and clear dependency descriptions for software projects or libraries based on input details such as dependency name, version constraints, and target audience. It creates marketing-style text that explains the purpose and benefits of the dependency to encourage adoption.", + "category": "copywriting", + "parameters": [ + { + "name": "dependencyName", + "type": "string", + "description": "The name of the software dependency to describe.", + "required": true, + "defaultValue": "" + }, + { + "name": "versionRange", + "type": "string", + "description": "The version constraints or specific versions for the dependency (e.g., ^2.1.0, >=1.0.0).", + "required": false, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the description, such as developers, technical leads, or product managers.", + "required": false, + "defaultValue": "developers" + }, + { + "name": "highlightFeatures", + "type": "array", + "description": "An array of key features or benefits of the dependency to emphasize in the description.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the description, such as professional, friendly, or persuasive.", + "required": false, + "defaultValue": "professional" + } + ], + "returns": { + "type": "object", + "description": "An object containing a generated description text presenting the dependency in a compelling and clear manner." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create marketing or explanatory text describing a software dependency for documentation, project READMEs, or promotional material to clearly communicate its purpose and value to potential users.", + "limitations": "It cannot generate actual technical dependency metadata or handle complex technical validations. It focuses on descriptive marketing style text, not on dependency resolution or compatibility analysis.", + "examples": [ + "Generate a dependency description for 'axios' library version '^0.21.1' targeting frontend developers highlighting its ease of use and reliability, in a friendly tone.", + "Create a professional description for a logging library 'winston' with no specified version, aimed at backend engineers emphasizing flexibility and support for transports.", + "Produce a persuasive dependency description for 'lodash', specifying version '>=4.17.0', highlighting utility and performance benefits for general developers." + ] + }, + "tags": [ + "copywriting", + "dependency", + "marketing", + "description", + "software", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"dependencyName\":\"express\",\"versionRange\":\"^4.17.1\",\"targetAudience\":\"backend developers\",\"highlightFeatures\":[\"minimalist web framework\",\"robust routing\",\"middleware support\"],\"tone\":\"professional\"}", + "description": "Generate a professional marketing description for the Express framework dependency targeting backend developers." + }, + { + "inputJson": "{\"dependencyName\":\"react\",\"versionRange\":\"^18.0.0\",\"targetAudience\":\"frontend developers\",\"highlightFeatures\":[\"component-based UI\",\"virtual DOM\",\"strong community support\"],\"tone\":\"friendly\"}", + "description": "Create a friendly description highlighting React features for frontend developers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dependency", + "context": null + } + }, + { + "name": "copywriting.createAPI", + "description": "Generates well-structured, comprehensive API documentation and promotional content based on provided API details such as endpoints, methods, parameters, and usage examples. Takes structured input describing an API and outputs engaging marketing copy alongside technical summaries to assist developers and marketers in promoting the API.", + "category": "copywriting", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "The official name of the API for which content is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "apiDescription", + "type": "string", + "description": "A brief technical summary describing the API's purpose and capabilities.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "An array of objects describing each API endpoint including path, method, parameters, and example usage.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The intended audience for the copywriting such as developers, product managers, or marketers.", + "required": false, + "defaultValue": "developers" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone/style of the promotional text, e.g., formal, casual, persuasive.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include usage examples in the generated copywriting content.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing two main fields: 'marketingCopy' with engaging promotional text and 'technicalSummary' with a clear, structured API overview." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create clear, appealing, and structured promotional and documentation content for an API based on its technical specification. It's ideal to accelerate content creation for API platforms, developer portals, and marketing materials that require coherent integration of technical details and marketing appeal.", + "limitations": "This tool does not generate API implementation code or detailed technical tutorials. It relies on accurate and complete input data to produce quality output and may not fully capture complex API behaviors if poorly described.", + "examples": [ + "Create promotional content for a payment gateway API focusing on fast transactions and secure endpoints.", + "Generate developer-friendly marketing copy for a social media API with emphasis on easy integration and rich features.", + "Produce a professional summary and marketing highlights for a weather data API targeting mobile app developers." + ] + }, + "tags": [ + "copywriting", + "API", + "marketing", + "documentation", + "promotional", + "content-generation", + "developer-relations" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"WeatherPro API\",\"apiDescription\":\"Provides real-time and forecast weather data globally.\",\"endpoints\":[{\"path\":\"/current\",\"method\":\"GET\",\"parameters\":[{\"name\":\"location\",\"type\":\"string\",\"required\":true}],\"exampleUsage\":\"GET /current?location=London\"},{\"path\":\"/forecast\",\"method\":\"GET\",\"parameters\":[{\"name\":\"location\",\"type\":\"string\",\"required\":true},{\"name\":\"days\",\"type\":\"number\",\"required\":false}],\"exampleUsage\":\"GET /forecast?location=London&days=5\"}],\"targetAudience\":\"mobile developers\",\"tone\":\"casual\",\"includeExamples\":true}", + "description": "Generate engaging promotional and technical content for a global weather data API aimed at mobile developers, with a casual tone and usage examples included." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "copywriting.createMigration", + "description": "Generates clear, concise copywriting text explaining the purpose, benefits, and steps of a software database migration process. Accepts migration context details as input, then produces professional marketing-style text to communicate the migration plan effectively to stakeholders or customers.", + "category": "copywriting", + "parameters": [ + { + "name": "migrationName", + "type": "string", + "description": "The name or title of the migration project.", + "required": true, + "defaultValue": "" + }, + { + "name": "migrationGoal", + "type": "string", + "description": "A brief description of the goal or purpose of the migration.", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "List of systems, databases, or platforms affected by the migration.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "keyBenefits", + "type": "array", + "description": "Key advantages or improvements expected from the migration.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "migrationSteps", + "type": "array", + "description": "Outline of the main steps involved in the migration process.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the copy (e.g., technical team, executives, customers).", + "required": false, + "defaultValue": "general audience" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the copywriting output (e.g., professional, casual, persuasive).", + "required": false, + "defaultValue": "professional" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated copywriting text describing the migration plan in a clear, engaging manner." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create marketing or internal communication text that explains a software or database migration clearly and persuasively, highlighting goals, benefits, and processes to various stakeholders. Ideal for generating content for newsletters, announcements, or documentation summaries.", + "limitations": "This tool does not perform technical migration steps or validate migration plans. It only generates descriptive copywriting text based on provided inputs.", + "examples": [ + "Create copy to announce a database migration improving system reliability to customers.", + "Generate internal communication text describing the migration steps to IT staff.", + "Write a persuasive description of the benefits of migrating to a new data platform for executive briefing." + ] + }, + "tags": [ + "copywriting", + "migration", + "software", + "marketing", + "communication", + "database" + ], + "examples": [ + { + "inputJson": "{\"migrationName\":\"Q3 Database Upgrade\",\"migrationGoal\":\"Upgrade database infrastructure for improved performance and scalability.\",\"affectedSystems\":[\"CustomerDB\",\"OrdersDB\"],\"keyBenefits\":[\"Faster queries\",\"Increased uptime\",\"Better scalability\"],\"migrationSteps\":[\"Backup current databases\",\"Deploy new database servers\",\"Migrate data\",\"Run integrity checks\"],\"targetAudience\":\"customers\",\"tone\":\"professional\"}", + "description": "Generate professional copy for customers announcing an upcoming database upgrade with benefits and steps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Migration", + "context": null + } + }, + { + "name": "copywriting.createSchema", + "description": "Generates a structured JSON Schema for a marketing or promotional copywriting project based on input requirements. Accepts details about the content type, target audience, tone, and key messaging elements, then outputs a detailed, valid JSON Schema defining the expected data structure and content constraints for use in automated or AI-assisted copywriting workflows.", + "category": "copywriting", + "parameters": [ + { + "name": "contentType", + "type": "string", + "description": "Type of marketing content (e.g., 'email', 'ad', 'landing page') to define schema for.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience to customize the schema to relevant user demographics and preferences.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy (e.g., 'professional', 'friendly', 'urgent') to influence content attribute constraints in schema.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyMessages", + "type": "array", + "description": "List of main messages or product features that copy must include, to shape the content requirements in the schema.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether the schema should enforce presence of a call-to-action element in the content.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated JSON Schema defining the expected structure and content constraints for the copywriting project." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate or validate marketing copy content to ensure output matches a defined structure aligned with project requirements. It helps define and enforce input data and content rules before copy generation, improving quality and adherence to goals.", + "limitations": "This tool generates structural schemas for copywriting data but does not generate actual marketing copy text. It also cannot fully capture highly subjective or deeply creative nuances that require human interpretation.", + "examples": [ + "Create a schema for an email marketing campaign targeting young adults with a friendly tone including key product benefits and a call to action.", + "Define a schema for a landing page advertisement, professional tone, focus on security features with mandatory call to action.", + "Generate a schema for a social media ad, casual tone, highlight three main features without a required call to action." + ] + }, + "tags": [ + "copywriting", + "schema", + "marketing", + "content-structure", + "validation", + "json-schema" + ], + "examples": [ + { + "inputJson": "{\"contentType\":\"email\",\"targetAudience\":\"young adults\",\"tone\":\"friendly\",\"keyMessages\":[\"fast delivery\",\"eco-friendly packaging\"],\"includeCallToAction\":true}", + "description": "Generate a schema for a friendly-toned email marketing piece targeting young adults, emphasizing fast delivery and eco-friendly packaging with a call to action." + }, + { + "inputJson": "{\"contentType\":\"landing page\",\"tone\":\"professional\",\"keyMessages\":[\"data security\",\"24/7 support\"],\"includeCallToAction\":true}", + "description": "Create a schema for a professional landing page ad that highlights data security and 24/7 support and requires a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Schema", + "context": null + } + }, + { + "name": "copywriting.createQuery", + "description": "Generates optimized code query statements or search queries based on provided intent and technical context, aiding in crafting precise, effective queries for databases, APIs, or code search tools.", + "category": "copywriting", + "parameters": [ + { + "name": "intent", + "type": "string", + "description": "The goal or purpose of the query to be generated, describing what information to retrieve or filter.", + "required": true, + "defaultValue": "" + }, + { + "name": "technicalContext", + "type": "string", + "description": "Background context including programming language, database type, API type, or environment relevant to constructing the query.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Preferred format of the generated query, e.g., SQL, GraphQL, REST API call, or generic search syntax.", + "required": false, + "defaultValue": "SQL" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments in the generated query to enhance readability and maintainability.", + "required": false, + "defaultValue": "false" + }, + { + "name": "complexityLevel", + "type": "string", + "description": "Expected complexity of the query: simple, intermediate, or advanced, affecting structure and optimization techniques used.", + "required": false, + "defaultValue": "intermediate" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated query string and optional explanations or advantages for its usage." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or suggest precise and optimized code or search queries based on a clear user intent and given technical context, to automate or assist with database querying, API search, or codebase exploration.", + "limitations": "This tool cannot validate executions of generated queries or connect to live systems for testing; it may not perfectly interpret ambiguous or highly domain-specific intents without sufficient context.", + "examples": [ + "Generate an SQL query to retrieve all users registered after 2022-01-01.", + "Create a GraphQL query to fetch a list of products with price and availability.", + "Generate a simple search query to find 'error handling' examples in JavaScript code repositories." + ] + }, + "tags": [ + "copywriting", + "query generation", + "code", + "database", + "API", + "search" + ], + "examples": [ + { + "inputJson": "{\"intent\":\"Find all customers from New York who made purchases over $1000 in the last year\",\"technicalContext\":\"SQL, MySQL database\",\"outputFormat\":\"SQL\",\"includeComments\":true,\"complexityLevel\":\"intermediate\"}", + "description": "Generate an SQL query to find customers in New York with large purchases in the last year including comments" + }, + { + "inputJson": "{\"intent\":\"Fetch list of books with author and publication year\",\"technicalContext\":\"GraphQL\",\"outputFormat\":\"GraphQL\",\"includeComments\":false,\"complexityLevel\":\"simple\"}", + "description": "Create a basic GraphQL query for books with author and year" + }, + { + "inputJson": "{\"intent\":\"Search codebase for functions related to login authentication\",\"technicalContext\":\"JavaScript code repository\",\"outputFormat\":\"generic\",\"includeComments\":false,\"complexityLevel\":\"intermediate\"}", + "description": "Generate a search query to find login-related functions in JS repositories" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Query", + "context": null + } + }, + { + "name": "copywriting.createTest", + "description": "Generates realistic, well-structured software test case code snippets based on user input describing the functionality to be tested, preferred programming language, and test framework. Accepts textual test descriptions and outputs executable test code for use in development environments.", + "category": "copywriting", + "parameters": [ + { + "name": "testDescription", + "type": "string", + "description": "A detailed description of the functionality or behavior to be tested in plain English.", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language in which the test code should be generated (e.g., JavaScript, Python, Java).", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "The testing framework to use when generating the test code (e.g., Jest, Mocha, PyTest, JUnit).", + "required": false, + "defaultValue": "\"Jest\"" + }, + { + "name": "testType", + "type": "string", + "description": "Type of test to generate, such as unit, integration, or functional test.", + "required": false, + "defaultValue": "\"unit\"" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments in the generated test code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated test code as a string, along with metadata specifying language and framework." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly produce sample or starter test case code based on a textual description of desired test behavior, supporting multiple languages and frameworks. It helps automate initial test creation for developers or teams adopting automated testing practices.", + "limitations": "The tool cannot guarantee fully syntactically correct or executable tests for complex scenarios or unknown frameworks. It does not execute tests or verify their correctness. It best serves simple to moderately complex test cases.", + "examples": [ + "Generate a Jest unit test in JavaScript for validating email input format.", + "Create a PyTest functional test in Python to check user login behavior.", + "Produce a JUnit integration test in Java that verifies database record insertion." + ] + }, + "tags": [ + "copywriting", + "testCodeGeneration", + "softwareTesting", + "automation", + "unitTest", + "integrationTest", + "functionalTest" + ], + "examples": [ + { + "inputJson": "{\"testDescription\":\"Verify that the add function returns the sum of two numbers.\",\"programmingLanguage\":\"JavaScript\",\"testFramework\":\"Jest\",\"testType\":\"unit\",\"includeComments\":true}", + "description": "Generate a Jest unit test for a simple add function in JavaScript." + }, + { + "inputJson": "{\"testDescription\":\"Check that the user authentication fails with wrong password.\",\"programmingLanguage\":\"Python\",\"testFramework\":\"PyTest\",\"testType\":\"functional\",\"includeComments\":false}", + "description": "Create a PyTest functional test for authentication failure scenario." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Test", + "context": null + } + }, + { + "name": "copywriting.createCode", + "description": "Generates code snippets or templates tailored for marketing campaigns, promotional websites, or advertising tools based on user-specified programming languages, frameworks, and marketing objectives. Accepts inputs such as target language, desired code functionality, and style preferences to output ready-to-use code suitable for copywriting tech deployments.", + "category": "copywriting", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language for the generated code snippet, e.g., JavaScript, Python, HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "Optional framework or library to use, e.g., React, Django, Vue, or can be empty for plain code.", + "required": false, + "defaultValue": "" + }, + { + "name": "functionalityDescription", + "type": "string", + "description": "A textual description of the marketing or promotional feature to implement, e.g., 'dynamic promotional banner showing discounts'.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeStyle", + "type": "string", + "description": "Optional style preferences such as 'modular', 'functional', or 'class-based' to influence code structure.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Flag to include explanatory comments in the generated code for better understanding and maintainability.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated code as a string, the programming language used, and optional metadata such as estimated complexity or dependencies." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate code snippets or reusable templates that implement marketing-focused features, such as promotional widgets, dynamic text content, or campaign integration code, tailored to specific languages and frameworks. It helps automate coding tasks for marketing technology development.", + "limitations": "This tool generates basic to moderately complex code snippets; it does not create full applications or highly complex systems. It cannot guarantee fully bug-free code or perfect integration in all environments and requires developer review and customization.", + "examples": [ + "Create a React component that displays a flashing sale banner.", + "Generate Python code to send marketing emails with personalized discount offers.", + "Produce HTML and CSS code for a responsive promotional landing page section." + ] + }, + "tags": [ + "copywriting", + "code generation", + "marketing", + "promotional code", + "automation", + "templates", + "marketing technology" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"JavaScript\",\"framework\":\"React\",\"functionalityDescription\":\"dynamic promotional banner showing discount countdown\",\"codeStyle\":\"functional\",\"includeComments\":true}", + "description": "Generate a React functional component in JavaScript for a dynamic promotional banner with a discount countdown timer." + }, + { + "inputJson": "{\"programmingLanguage\":\"Python\",\"framework\":\"\",\"functionalityDescription\":\"send personalized marketing email with discount code\",\"codeStyle\":\"\",\"includeComments\":false}", + "description": "Create Python code that sends personalized marketing emails including individual discount codes, without extra comments." + }, + { + "inputJson": "{\"programmingLanguage\":\"HTML\",\"framework\":\"\",\"functionalityDescription\":\"responsive landing page section for upcoming sale\",\"codeStyle\":\"\",\"includeComments\":true}", + "description": "Produce HTML and CSS code for a responsive landing page section promoting an upcoming sale, with explanatory comments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Code", + "context": null + } + }, + { + "name": "copywriting.createModule", + "description": "Generates a complete marketing copywriting module for software projects, including tagline, feature highlights, value propositions, and call-to-action text. Accepts project details, target audience, tone, and key features; outputs a structured module ready for integration into promotional materials or websites.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "Name of the software project or product to create copywriting for.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or market segment for the module.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or benefits of the software to highlight in the copywriting module.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the write-up, e.g., professional, casual, witty, inspirational.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "moduleLength", + "type": "number", + "description": "Approximate length of the module in number of sentences or paragraphs.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a strong call-to-action section in the module.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Structured object containing the tagline, feature highlights, value proposition, and call-to-action text as strings." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate coherent, persuasive marketing copywriting modules for software products based on specific input parameters such as project details and audience characteristics. Ideal for automating content creation for websites, landing pages, or promotional campaigns.", + "limitations": "Cannot verify factual accuracy of provided product features; requires accurate input data. Output style may require human review to ensure brand voice consistency.", + "examples": [ + "Create a copywriting module for a productivity app targeting remote workers, highlighting real-time collaboration and offline mode.", + "Generate a marketing module with a casual tone for a gaming platform focusing on community features and exclusive content.", + "Produce a concise professional copywriting module for a cybersecurity tool emphasizing reliability and 24/7 support." + ] + }, + "tags": [ + "copywriting", + "marketing", + "module", + "software", + "promotional", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"FocusFlow\",\"targetAudience\":\"remote workers and freelancers\",\"keyFeatures\":[\"real-time collaboration\",\"offline mode\",\"task prioritization\"],\"tone\":\"professional\",\"moduleLength\":4,\"includeCallToAction\":true}", + "description": "Generate a professional marketing module for a productivity app targeting remote workers" + }, + { + "inputJson": "{\"projectName\":\"GameCircle\",\"targetAudience\":\"casual and hardcore gamers\",\"keyFeatures\":[\"community features\",\"exclusive content\",\"in-game events\"],\"tone\":\"casual\",\"moduleLength\":5,\"includeCallToAction\":true}", + "description": "Create a casual tone copywriting module for a gaming platform" + }, + { + "inputJson": "{\"projectName\":\"SecureSafe\",\"targetAudience\":\"small and medium businesses\",\"keyFeatures\":[\"reliable endpoint protection\",\"24/7 support\",\"advanced threat detection\"],\"tone\":\"professional\",\"moduleLength\":3,\"includeCallToAction\":false}", + "description": "Produce a concise and professional marketing module for a cybersecurity tool without call to action" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "copywriting.createSpec", + "description": "Generates a detailed specification document for a given product, feature, or service. Accepts inputs such as the domain context, target audience, key requirements, and goals. Processes these inputs to create a structured, clear, and persuasive spec document suitable for marketing and planning purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title or name of the specification document to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "domain", + "type": "string", + "description": "The domain or industry context of the product or feature (e.g., SaaS, ecommerce, fintech).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the primary audience for the spec (e.g., developers, marketing teams, customers).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of key features or components to highlight within the spec.", + "required": true, + "defaultValue": "" + }, + { + "name": "goals", + "type": "string", + "description": "The main goals or objectives that the spec aims to achieve or support.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone for the spec document (e.g., formal, persuasive, technical).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "lengthLimit", + "type": "number", + "description": "Approximate desired length of the spec document in words.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing a structured spec document in textual form with sections for overview, features, goals, and conclusion." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to produce a marketing or project specification document based on brief input parameters. It helps generate clear, coherent, and targeted spec docs suitable for internal or external communication without manual drafting.", + "limitations": "The tool cannot generate highly technical specs requiring deep domain expertise or include proprietary data not provided in inputs. It also does not create visual diagrams or editable formats beyond text.", + "examples": [ + "Create a product spec for a new mobile app targeting young adults in ecommerce.", + "Generate a feature specification document for an AI-powered customer support chatbot.", + "Write a marketing spec doc for launching a fintech service to small businesses." + ] + }, + "tags": [ + "copywriting", + "specification", + "marketing", + "document", + "product", + "feature" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Mobile App Feature Spec\",\"domain\":\"ecommerce\",\"targetAudience\":\"development and marketing teams\",\"keyFeatures\":[\"user login\",\"product search\",\"shopping cart\",\"payment gateway\"],\"goals\":\"Streamline user purchase flow and improve conversion rate.\",\"tone\":\"persuasive\",\"lengthLimit\":600}", + "description": "Create a persuasive spec document for an ecommerce mobile app focusing on key user features and business goals." + }, + { + "inputJson": "{\"title\":\"AI Chatbot Feature Specification\",\"domain\":\"customer service\",\"targetAudience\":\"technical leads and project managers\",\"keyFeatures\":[\"natural language understanding\",\"multi-language support\",\"ticket generation\",\"analytics dashboard\"],\"goals\":\"Enhance automated support capabilities and reduce human agent load.\",\"tone\":\"formal\",\"lengthLimit\":500}", + "description": "Generate a formal, structured spec document for an AI chatbot project highlighting features and objectives." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Spec", + "context": null + } + }, + { + "name": "copywriting.createReadme", + "description": "Generates a professional README.md document for software projects based on project details provided. Accepts input such as project name, description, installation instructions, usage examples, license, and contact info. Processes these inputs using structured templates to output a formatted markdown README suitable for GitHub or other repositories.", + "category": "copywriting", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to be included as the main title of the README.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A concise description summarizing the project's purpose and functionality.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step installation instructions or commands for users to set up the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageInformation", + "type": "string", + "description": "Examples and explanations of how to use the project once installed or configured.", + "required": false, + "defaultValue": "" + }, + { + "name": "license", + "type": "string", + "description": "The type of software license governing the project (e.g., MIT, GPL, Apache 2.0).", + "required": false, + "defaultValue": "" + }, + { + "name": "contributingGuidelines", + "type": "string", + "description": "Instructions detailing how other developers can contribute to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "contactInformation", + "type": "string", + "description": "Contact details such as email or website for users or contributors to reach the maintainer.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated README content as a markdown formatted string under the 'readmeMarkdown' property." + }, + "aiAgent": { + "useCase": "Use this tool when a README file is needed for a new or existing software project to provide clear, standardized documentation for users and contributors. Ideal for automatic documentation generation in project scaffolding, continuous integration pipelines, or project onboarding assistants.", + "limitations": "This tool generates generic README templates based on input text and cannot produce project-specific technical diagrams or highly customized documentation. The quality depends heavily on the clarity and completeness of input information provided.", + "examples": [ + "Generate a README for a Python library named 'DataUtils' that helps with data processing.", + "Create a README for a web app project with installation and usage instructions and MIT license.", + "Produce README markdown for an open-source CLI tool including contribution guidelines and contact info." + ] + }, + "tags": [ + "copywriting", + "documentation", + "readme", + "markdown", + "software", + "automation" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"DataUtils\",\"projectDescription\":\"A Python library for simple data processing and manipulation tasks.\",\"installationInstructions\":\"Run 'pip install datautils' to install the package.\",\"usageInformation\":\"Import DataUtils and use its functions to clean and transform datasets.\",\"license\":\"MIT\",\"contributingGuidelines\":\"Please fork the repo and create pull requests.\",\"contactInformation\":\"email@datacompany.com\"}", + "description": "Generate a README for a Python data processing library with full details including contributing and contact info." + }, + { + "inputJson": "{\"projectName\":\"QuickCLI\",\"projectDescription\":\"Command-line interface tool to automate daily tasks.\",\"installationInstructions\":\"Download the binary from releases and add to PATH.\",\"usageInformation\":\"Run 'quickcli --help' to see commands.\",\"license\":\"Apache 2.0\",\"contributingGuidelines\":\"Open issues or create pull requests.\",\"contactInformation\":\"maintainer@quickcli.io\"}", + "description": "Create README for a CLI tool project including installation, usage, license, and contribution instructions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Readme", + "context": null + } + }, + { + "name": "copywriting.createBrief", + "description": "Generates a concise marketing brief based on provided product details, target audience, tone, and campaign objectives. Accepts structured inputs describing the product and desired messaging tone, processes these to create a clear, focused brief for content creators or marketing teams. Outputs a formatted brief highlighting key messaging points and campaign goals.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "Name of the product or service to be promoted", + "required": true, + "defaultValue": "" + }, + { + "name": "productDescription", + "type": "string", + "description": "Detailed description highlighting product features and benefits", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience including demographics and psychographics", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignGoals", + "type": "string", + "description": "Primary objectives of the marketing campaign like brand awareness or sales increase", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the brief, e.g., professional, casual, enthusiastic", + "required": false, + "defaultValue": "professional" + }, + { + "name": "keyMessages", + "type": "array", + "description": "List of crucial messages or selling points to emphasize in the brief", + "required": false, + "defaultValue": "[]" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the output brief in number of words", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the marketing brief text, structured to highlight product overview, key messages, target audience insights, and campaign objectives." + }, + "aiAgent": { + "useCase": "Use this tool to create structured marketing briefs when given product details and campaign goals, to guide content creators, marketing teams, or strategists in aligning messaging consistently. Ideal for agencies or businesses needing clear campaign documents quickly.", + "limitations": "It cannot generate highly detailed marketing strategies or copy variations; it produces concise briefs only. It depends on the quality and completeness of input data; vague inputs produce general briefs.", + "examples": [ + "Create a marketing brief for a new eco-friendly water bottle targeting young adults, with a casual tone.", + "Generate a professional brief for a SaaS productivity tool aimed at small business owners emphasizing increased efficiency.", + "Produce a concise brief for a luxury skincare line aimed at middle-aged women focusing on anti-aging benefits." + ] + }, + "tags": [ + "copywriting", + "marketing", + "brief", + "content creation", + "campaign planning", + "branding" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"EcoSip Water Bottle\",\"productDescription\":\"A durable, BPA-free water bottle made from recycled materials that keeps drinks cold for 24 hours using advanced insulation.\",\"targetAudience\":\"Environmentally conscious young adults aged 18-30 who value sustainability and health.\",\"campaignGoals\":\"Increase brand awareness and drive pre-orders through social media channels.\",\"tone\":\"casual\",\"keyMessages\":[\"Sustainable and eco-friendly\",\"Keeps beverages cold all day\",\"Stylish and portable\"],\"length\":250}", + "description": "Brief for an eco-friendly reusable water bottle aimed at young adults, in a casual tone." + }, + { + "inputJson": "{\"productName\":\"TaskMaster Pro\",\"productDescription\":\"A cloud-based productivity software that integrates task management, calendar, and collaboration tools for small businesses.\",\"targetAudience\":\"Small business owners and their teams looking for efficient project management.\",\"campaignGoals\":\"Position as the go-to productivity app to improve team work and task tracking.\",\"tone\":\"professional\",\"keyMessages\":[\"All-in-one solution\",\"Improves team collaboration\",\"Easy to use interface\"],\"length\":300}", + "description": "Professional marketing brief for a productivity SaaS product targeting small businesses." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Brief", + "context": null + } + }, + { + "name": "copywriting.createFunction", + "description": "Generates a marketing-oriented function description and promotional text based on input function name, purpose, and target audience. Accepts a function name, a brief description of its role, and the intended user demographic, then outputs a compelling function summary suitable for marketing materials or documentation highlights.", + "category": "copywriting", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The exact name of the function to generate copy for.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionPurpose", + "type": "string", + "description": "A brief, clear explanation of what the function does or aims to achieve.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "The primary audience or user base that will use or benefit from the function (e.g., developers, marketers).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the promotional text such as professional, casual, enthusiastic, or technical.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include usage examples in the generated copy.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated marketing copy including a function summary and optional usage examples" + }, + "aiAgent": { + "useCase": "Use this tool when you need to create compelling, clear, and targeted promotional or descriptive copy for technical functions, particularly when preparing documentation or marketing materials that need to engage specific audiences effectively.", + "limitations": "This tool cannot generate actual working code or detailed technical specifications; it focuses solely on creating engaging descriptive text around a function.", + "examples": [ + "Generate marketing copy for a data processing function targeting software developers.", + "Create a promotional summary for a new AI prediction function aimed at business analysts with an enthusiastic tone.", + "Write a clear and professional description with an example usage for a sorting algorithm function." + ] + }, + "tags": [ + "copywriting", + "marketing", + "function", + "documentation", + "promotional", + "technical writing" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"calculateRevenue\",\"functionPurpose\":\"computes total revenue from sales data\",\"targetAudience\":\"financial analysts\",\"tone\":\"professional\",\"includeExamples\":true}", + "description": "Generate professional marketing text describing a financial calculation function with usage examples." + }, + { + "inputJson": "{\"functionName\":\"sendEmailNotification\",\"functionPurpose\":\"sends automated email alerts to users\",\"targetAudience\":\"product managers\",\"tone\":\"casual\",\"includeExamples\":false}", + "description": "Create casual promotional copy for a user notification function targeting product managers without examples." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "copywriting.createTemplate", + "description": "Creates a customizable marketing copywriting template based on specified campaign type, target audience, and tone. Accepts inputs defining template structure including headline, body, call-to-action sections and generates a reusable document template for consistent promotional content.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "The type of marketing campaign (e.g., Email, Social Media, Print) for which the template is designed.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience or customer segment.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the copy (e.g., Friendly, Professional, Urgent).", + "required": false, + "defaultValue": "Professional" + }, + { + "name": "includeSections", + "type": "array", + "description": "List of sections to include such as ['headline','body','callToAction','footer'].", + "required": false, + "defaultValue": "[\"headline\",\"body\",\"callToAction\"]" + }, + { + "name": "language", + "type": "string", + "description": "Language of the template to produce (e.g., English, Spanish).", + "required": false, + "defaultValue": "English" + } + ], + "returns": { + "type": "object", + "description": "An object containing the structured template with placeholders for copywriting sections, suitable for filling in campaign-specific content." + }, + "aiAgent": { + "useCase": "Use this tool when a consistent and reusable marketing copywriting structure is needed for campaigns targeting specific audiences with customized tone and sections. Ideal for automating template generation across channels to maintain brand voice and improve efficiency.", + "limitations": "Does not generate full copy content, only creates template structure with placeholders. Tone and style are limited to general presets and may not capture nuanced brand voice.", + "examples": [ + "Create a social media advertising copy template targeting young adults with a casual tone including headline, body, and call to action.", + "Generate an email marketing template for healthcare professionals with a formal tone including headline, body, call to action, and footer sections.", + "Produce a print ad template for luxury products targeting high-income customers with an elegant tone." + ] + }, + "tags": [ + "copywriting", + "template", + "marketing", + "content creation", + "automation" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"Email\",\"targetAudience\":\"Tech professionals aged 25-40\",\"tone\":\"Friendly\",\"includeSections\":[\"headline\",\"body\",\"callToAction\"],\"language\":\"English\"}", + "description": "Create an email marketing template for tech professionals with friendly tone" + }, + { + "inputJson": "{\"campaignType\":\"Social Media\",\"targetAudience\":\"Fitness enthusiasts\",\"tone\":\"Motivational\",\"includeSections\":[\"headline\",\"body\",\"callToAction\",\"footer\"],\"language\":\"English\"}", + "description": "Generate a social media copy template with motivational tone targeting fitness enthusiasts" + }, + { + "inputJson": "{\"campaignType\":\"Print\",\"targetAudience\":\"Luxury car buyers\",\"tone\":\"Elegant\",\"includeSections\":[\"headline\",\"body\",\"callToAction\"],\"language\":\"English\"}", + "description": "Produce an elegant print advertisement template for luxury car buyers" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Template", + "context": null + } + }, + { + "name": "copywriting.createFAQ", + "description": "This tool generates a structured Frequently Asked Questions (FAQ) document based on provided product or service details, target audience, and desired tone. It accepts inputs describing key topics and generates clear, concise Q&A pairs as output suitable for marketing or support materials.", + "category": "copywriting", + "parameters": [ + { + "name": "domainDescription", + "type": "string", + "description": "Detailed description of the product, service, or domain the FAQ will cover.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor the language and complexity accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyTopics", + "type": "array", + "description": "List of main topics or themes to be included in the FAQ, guiding question generation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "numberOfQuestions", + "type": "number", + "description": "Maximum number of FAQ questions to generate, to control FAQ length.", + "required": false, + "defaultValue": "10" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of writing to apply (e.g., formal, friendly, professional, casual).", + "required": false, + "defaultValue": "friendly" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of generated FAQ entries, each with a question and answer string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate customer-facing FAQ content for marketing websites, product launches, or customer support sections based on summarized domain information and key concerns. It helps automate content creation tailored to audience and tone preferences.", + "limitations": "The tool relies entirely on the input description and key topics; it cannot verify factual correctness or provide answers beyond provided context. It may not cover extremely technical or niche queries accurately.", + "examples": [ + "Generate an FAQ for a new eco-friendly water bottle targeting active millennials.", + "Create a professional FAQ for SaaS software help pages focusing on billing and security questions.", + "Produce a casual FAQ for a small business catering to pet owners about grooming services." + ] + }, + "tags": [ + "copywriting", + "FAQ", + "content generation", + "marketing", + "customer support", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"domainDescription\":\"A cloud-based project management tool that helps teams collaborate with task assignments, timelines, and file sharing.\",\"targetAudience\":\"Small to medium businesses, project managers, and team members.\",\"keyTopics\":[\"task management\",\"collaboration\",\"security\",\"pricing\"],\"numberOfQuestions\":5,\"tone\":\"professional\"}", + "description": "Generate a professional FAQ for a SaaS project management product focused on collaboration and pricing." + }, + { + "inputJson": "{\"domainDescription\":\"Organic skincare line using sustainable sourcing and cruelty-free ingredients.\",\"targetAudience\":\"Environmentally conscious consumers aged 25-40.\",\"keyTopics\":[\"ingredients\",\"sourcing\",\"usage\",\"pricing\"],\"numberOfQuestions\":7,\"tone\":\"friendly\"}", + "description": "Create a friendly FAQ for a new eco-friendly skincare brand highlighting ingredients and ethical practices." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "FAQ", + "context": null + } + }, + { + "name": "copywriting.createChecklist", + "description": "Generates a detailed marketing or promotional checklist based on user input about campaign goals, target audience, and key marketing channels. Accepts campaign type and objectives, and produces a structured, step-by-step checklist to guide content creation and marketing execution.", + "category": "copywriting", + "parameters": [ + { + "name": "campaignType", + "type": "string", + "description": "Type of marketing campaign (e.g., email campaign, social media launch, product promotion).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for the campaign.", + "required": true, + "defaultValue": "" + }, + { + "name": "marketingChannels", + "type": "array", + "description": "List of marketing channels to be included (e.g., ['email','social media','blog']).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "campaignObjectives", + "type": "array", + "description": "Specific objectives or goals of the campaign (e.g., ['increase brand awareness','boost sales']).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "includeTimeline", + "type": "boolean", + "description": "Whether to include estimated timeline steps in the checklist.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A structured checklist object including key action items, steps, and optionally timeline guidance tailored to the provided campaign parameters." + }, + "aiAgent": { + "useCase": "Use this tool when planning marketing or promotional campaigns requiring structured task checklists to ensure thorough execution across channels and objectives. It helps generate actionable steps and reminders to guide copywriting and marketing teams.", + "limitations": "This tool does not create the actual copy or creative content; it focuses on checklist generation only. It cannot replace detailed project management tools, and it relies on accurate input about campaign parameters.", + "examples": [ + "Create a checklist for an email campaign targeting small business owners to increase newsletter signups.", + "Generate a promotional checklist for a social media launch aimed at young adults focusing on brand awareness.", + "Provide a step-by-step checklist for a product promotion campaign across email and blog channels with defined sales goals." + ] + }, + "tags": [ + "copywriting", + "marketing", + "checklist", + "campaign planning", + "promotional content" + ], + "examples": [ + { + "inputJson": "{\"campaignType\":\"email campaign\",\"targetAudience\":\"small business owners\",\"marketingChannels\":[\"email\"],\"campaignObjectives\":[\"increase newsletter signups\"],\"includeTimeline\":true}", + "description": "Checklist for an email campaign targeting small business owners aimed at increasing newsletter signups." + }, + { + "inputJson": "{\"campaignType\":\"social media launch\",\"targetAudience\":\"young adults\",\"marketingChannels\":[\"social media\"],\"campaignObjectives\":[\"brand awareness\"],\"includeTimeline\":false}", + "description": "Promotional checklist for a social media launch focused on brand awareness among young adults." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Checklist", + "context": null + } + }, + { + "name": "copywriting.createComponent", + "description": "Generates a marketing copywriting text component tailored for UI inclusion, based on product details, target audience, tone, and component role. Accepts inputs like product features, audience profile, desired tone, and component type to produce an engaging, concise text snippet suitable for banners, cards, or calls-to-action.", + "category": "copywriting", + "parameters": [ + { + "name": "productName", + "type": "string", + "description": "The name of the product or service to promote.", + "required": true, + "defaultValue": "" + }, + { + "name": "productFeatures", + "type": "array", + "description": "List of key product features or benefits to highlight.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience for the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the copy e.g., friendly, professional, urgent.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "componentType", + "type": "string", + "description": "The type of UI component for which the text is intended, such as banner, card, or call-to-action.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length (in characters) for the generated text component to ensure fitting UI constraints.", + "required": false, + "defaultValue": "150" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text component string labeled as 'text'." + }, + "aiAgent": { + "useCase": "Use this tool when generating short marketing text snippets customized for specific UI components based on product details and audience context, to streamline content creation for web and app interfaces.", + "limitations": "This tool does not generate full-length articles or complex copywriting projects; it is focused on concise UI components only.", + "examples": [ + "Create a friendly banner text for a new fitness tracker highlighting its heart rate monitoring and waterproof features targeting active adults.", + "Generate a professional call-to-action text component encouraging small businesses to try cloud accounting software.", + "Produce a short card description for a new vegan snack product targeting environmentally-conscious consumers with an enthusiastic tone." + ] + }, + "tags": [ + "copywriting", + "marketing", + "UI component", + "text generation", + "promotional text", + "branding" + ], + "examples": [ + { + "inputJson": "{\"productName\":\"FitPulse Tracker\",\"productFeatures\":[\"accurate heart rate monitor\",\"waterproof up to 50m\",\"7-day battery life\"],\"targetAudience\":\"active adults who enjoy outdoor sports\",\"tone\":\"friendly\",\"componentType\":\"banner\",\"maxLength\":120}", + "description": "Generate a friendly banner text advertising a fitness tracker for active adults emphasizing heart rate monitoring and waterproof capability." + }, + { + "inputJson": "{\"productName\":\"CloudBooks Pro\",\"productFeatures\":[\"real-time invoicing\",\"expense tracking\",\"secure data encryption\"],\"targetAudience\":\"small business owners\",\"tone\":\"professional\",\"componentType\":\"call-to-action\",\"maxLength\":100}", + "description": "Create a professional call-to-action text for cloud accounting software aimed at small business owners." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Component", + "context": null + } + }, + { + "name": "copywriting.createMinutes", + "description": "This tool generates professional meeting minutes based on provided meeting details such as agenda, participants, discussion points, and action items. It organizes the input into a clear, concise document summarizing key points, decisions, and assigned tasks, suitable for distribution to meeting attendees.", + "category": "copywriting", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "Title or subject of the meeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "meetingDate", + "type": "string", + "description": "Date of the meeting in ISO format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "List of participant names or roles present at the meeting.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "agendaItems", + "type": "array", + "description": "Array of agenda items planned for discussion.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discussionPoints", + "type": "array", + "description": "Array of discussion points corresponding to agenda items, describing highlights and outcomes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "decisionsMade", + "type": "array", + "description": "List of formal decisions or conclusions reached during the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items assigned, including responsible person and due date if known.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any miscellaneous notes or remarks relevant to the meeting minutes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a well-structured meeting minutes document as a formal string and optionally summarized key points array." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create formal, professional meeting minutes from raw meeting data inputs. Ideal for converting agenda topics, discussions, decisions, and tasks into a clear, distributable summary that attendees or stakeholders can easily understand.", + "limitations": "This tool does not record audio or automatically transcribe spoken content. It requires manual input of meeting information. It may not capture implicit context or emotional nuances of discussions.", + "examples": [ + "Create minutes for a project kickoff meeting with listed participants, agenda, and assigned tasks.", + "Summarize key discussion points and decisions from a board meeting input.", + "Generate a formal minutes document from input notes and action items from a team meeting." + ] + }, + "tags": [ + "copywriting", + "documentation", + "meeting", + "minutes", + "summary", + "productivity" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Quarterly Sales Review\",\"meetingDate\":\"2024-05-10\",\"participants\":[\"Alice Johnson\",\"Bob Smith\",\"Claire Lee\"],\"agendaItems\":[\"Sales Performance\",\"Challenges\",\"Next Quarter Strategy\"],\"discussionPoints\":[\"Reviewed Q1 and Q2 sales figures.\",\"Discussed supply chain delays impacting orders.\",\"Outlined marketing plans for Q3.\"],\"decisionsMade\":[\"Increase budget for digital marketing.\",\"Negotiate with suppliers for faster deliveries.\"],\"actionItems\":[{\"task\":\"Prepare updated sales forecast\",\"assignee\":\"Alice Johnson\",\"dueDate\":\"2024-05-20\"},{\"task\":\"Contact alternative suppliers\",\"assignee\":\"Bob Smith\",\"dueDate\":\"2024-05-25\"}],\"additionalNotes\":\"Next meeting scheduled for August 15th.\"}", + "description": "Generate minutes summarizing a quarterly sales meeting including agenda, discussions, decisions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Minutes", + "context": null + } + }, + { + "name": "copywriting.createSummary", + "description": "Generates a coherent and concise summary from a provided source text or document. Accepts raw text or URL input, processes key information extraction and natural language generation to produce a clear, engaging summary. Output is a text string summarizing main points without losing important context.", + "category": "copywriting", + "parameters": [ + { + "name": "sourceText", + "type": "string", + "description": "The raw text content to summarize. If both sourceText and sourceUrl are provided, sourceText takes precedence.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceUrl", + "type": "string", + "description": "URL of the document or webpage to summarize if sourceText is not provided. The tool will fetch and extract main text content from this URL.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum desired length of the summary in words. Helps control the brevity or detail level.", + "required": false, + "defaultValue": "150" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone/style of the summary, e.g., neutral, persuasive, casual, professional. Influences writing style.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "includeKeyPoints", + "type": "boolean", + "description": "Whether to list bullet-point key points in addition to the paragraph summary.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summary text and optionally key bullet points." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate brief, readable summaries that capture essential ideas from longer documents or text sources, aiding quick understanding, marketing, or content previews. Ideal for summarizing articles, reports, or product descriptions to create marketing copy or executive summaries.", + "limitations": "Cannot ensure perfect accuracy if source content is ambiguous or poorly structured. Does not replace expert human summarization for legal or critical documents. May struggle with very short or highly technical texts.", + "examples": [ + "Summarize the latest company report into a 100-word professional summary.", + "Create a casual summary for a product description from a webpage URL.", + "Generate a neutral summary with key bullet points from provided text." + ] + }, + "tags": [ + "copywriting", + "summary", + "text", + "marketing", + "content", + "naturalLanguageProcessing" + ], + "examples": [ + { + "inputJson": "{\"sourceText\":\"Our innovative platform leverages AI to automate routine tasks, boosting productivity and improving accuracy across teams. With customizable modules, businesses can tailor workflows to specific needs, resulting in measurable efficiency gains. Continuous updates ensure cutting-edge performance and security.\",\"maxLength\":100,\"tone\":\"professional\",\"includeKeyPoints\":true}", + "description": "Summarize a product introduction with professional tone, including bullet points." + }, + { + "inputJson": "{\"sourceUrl\":\"https://example.com/2023-market-report\",\"maxLength\":150}", + "description": "Create a neutral summary of a market report fetched from a URL, capped at 150 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "copywriting.createTranscript", + "description": "Generates a detailed, readable transcript from a provided audio or video file or raw text input. Accepts audio/video URL or text content and processes it to produce a polished, structured transcript suitable for marketing, promotional, or documentation purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "inputSource", + "type": "string", + "description": "The URL or base64 encoded string of the audio or video file, or raw text content to transcribe or format. Required if rawText is empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "rawText", + "type": "string", + "description": "Raw text input to format into a clean transcript. Used if no audio/video file is provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en-US') of the audio or text content to improve transcription accuracy.", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps at regular intervals in the transcript.", + "required": false, + "defaultValue": "true" + }, + { + "name": "speakerLabels", + "type": "boolean", + "description": "If true, attempts to identify and label different speakers in the transcript.", + "required": false, + "defaultValue": "true" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Style of the output transcript formatting, e.g., 'paragraph', 'bullet', or 'dialogue'.", + "required": false, + "defaultValue": "dialogue" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum allowed length in characters for the generated transcript; longer inputs will be summarized.", + "required": false, + "defaultValue": "10000" + } + ], + "returns": { + "type": "object", + "description": "An object containing the cleaned and formatted transcript text, speaker metadata if identified, and optional timestamps." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to create clear, well-structured transcripts from multimedia content or raw text for marketing, promotional, or documentation purposes. It is useful for generating readable meeting notes, interviews, presentations, or promotional scripts from audio, video, or text sources.", + "limitations": "This tool does not perform advanced audio transcription beyond basic automatic speech recognition and formatting. It may not handle poor audio quality or multiple overlapping speakers accurately. It cannot generate transcripts without input content.", + "examples": [ + "Create a transcript from a marketing webinar video link with speaker labels and timestamps.", + "Format a raw interview text into dialogue style transcript without timestamps.", + "Generate a summarized transcript from a lengthy podcast audio file in English." + ] + }, + "tags": [ + "copywriting", + "transcript", + "audio-to-text", + "video-transcription", + "marketing", + "formatting", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"inputSource\":\"https://example.com/webinar.mp4\",\"language\":\"en-US\",\"includeTimestamps\":true,\"speakerLabels\":true,\"formatStyle\":\"dialogue\"}", + "description": "Transcribe a webinar video with speaker labels and timestamps in dialogue format." + }, + { + "inputJson": "{\"rawText\":\"Welcome to our product launch event. Today we will discuss the new features...\",\"formatStyle\":\"paragraph\",\"includeTimestamps\":false}", + "description": "Create a paragraph style transcript from raw text without timestamps." + }, + { + "inputJson": "{\"inputSource\":\"base64audiodatastring...\",\"language\":\"en-US\",\"maxLength\":5000}", + "description": "Generate a concise transcript summarizing a base64 encoded audio clip in English." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Transcript", + "context": null + } + }, + { + "name": "copywriting.createBlogPost", + "description": "Generates a detailed blog post based on a given topic, target audience, and desired tone. It accepts key inputs about the theme, length, style, keywords, and optional subtopics, then produces a structured, SEO-friendly blog post draft suitable for marketing or informational purposes.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the blog post to write.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor language and style.", + "required": false, + "defaultValue": "" + }, + { + "name": "postLength", + "type": "number", + "description": "Approximate desired word count of the blog post.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "tone", + "type": "string", + "description": "Writing tone such as formal, casual, enthusiastic, or professional.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keywords", + "type": "array", + "description": "List of SEO keywords or phrases to naturally include in the post.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subtopics", + "type": "array", + "description": "Optional array of subtopic titles or points to cover within the post.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to add a promotional call-to-action at the end of the blog post.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated blog post text and metadata such as word count and highlighted keywords." + }, + "aiAgent": { + "useCase": "Ideal for marketing teams, content creators, or AI agents needing to create engaging, SEO-optimized blog content for various industries and audiences. Useful when quick generation of well-structured and targeted marketing articles or informational posts is required.", + "limitations": "Cannot replace expert domain knowledge for highly technical or niche topics; generated content may require human review and editing for accuracy and style consistency.", + "examples": [ + "Write a professional blog post about sustainable fashion targeting environmentally conscious millennials.", + "Create a casual 800-word blog post on home gardening tips including the keywords 'organic', 'DIY', and 'urban farming'.", + "Generate a detailed marketing blog post about the benefits of cloud computing with a call-to-action to sign up for a webinar." + ] + }, + "tags": [ + "copywriting", + "blog", + "marketing", + "SEO", + "content creation", + "writing", + "AI generated" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"The Importance of Cybersecurity in Small Businesses\",\"targetAudience\":\"small business owners\",\"postLength\":1200,\"tone\":\"professional\",\"keywords\":[\"cybersecurity\",\"small business\",\"data protection\"],\"subtopics\":[\"common cyber threats\",\"best practices\",\"tools and resources\"],\"includeCallToAction\":true}", + "description": "Generate a professional blog post targeted at small business owners that covers cybersecurity importance, common threats, and best practices, including a call to action." + }, + { + "inputJson": "{\"topic\":\"Top 10 Hiking Trails in the Pacific Northwest\",\"targetAudience\":\"outdoor enthusiasts\",\"postLength\":800,\"tone\":\"casual\",\"keywords\":[\"hiking\",\"Pacific Northwest\",\"trails\"],\"subtopics\":[],\"includeCallToAction\":false}", + "description": "Create a casual, informative blog post listing top hiking trails for outdoor enthusiasts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "BlogPost", + "context": null + } + }, + { + "name": "copywriting.createInvoice", + "description": "Generates a professional, well-structured invoice text based on inputs such as client details, itemized services or products, pricing, taxes, and payment terms. It processes the given data to produce clear invoice content ready for usage in billing communications or document templates.", + "category": "copywriting", + "parameters": [ + { + "name": "senderName", + "type": "string", + "description": "Name of the individual or company issuing the invoice", + "required": true, + "defaultValue": "" + }, + { + "name": "senderAddress", + "type": "string", + "description": "Address of the sender to appear on the invoice", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientName", + "type": "string", + "description": "Name of the client or company receiving the invoice", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientAddress", + "type": "string", + "description": "Address of the recipient for billing purposes", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceNumber", + "type": "string", + "description": "Unique identifier for the invoice", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceDate", + "type": "string", + "description": "Date when the invoice is issued, preferably ISO format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "dueDate", + "type": "string", + "description": "Payment due date (ISO format)", + "required": false, + "defaultValue": "" + }, + { + "name": "lineItems", + "type": "array", + "description": "Array of objects describing each item or service billed. Each item should include description (string), quantity (number), unitPrice (number), and optionally taxRate (number)", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for prices, e.g., USD, EUR", + "required": false, + "defaultValue": "USD" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Text describing payment terms or instructions", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a full invoice text as a single formatted string and a summary with calculated totals including subtotal, tax, and total amount." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate human-readable, professional invoice text from structured billing details. It is suitable for business automation, customer invoicing, and generating billing documents to send to clients.", + "limitations": "This tool does not create PDF or formatted document files, only plain text invoice content. It also does not validate tax rules or local regulations.", + "examples": [ + "Create an invoice text for a consulting firm billing a client with multiple services detailed.", + "Generate an invoice for sale of products including quantities, prices, and applicable taxes.", + "Produce invoice text specifying payment terms and due date for freelance work." + ] + }, + "tags": [ + "copywriting", + "invoice", + "billing", + "finance", + "document generation", + "text generation" + ], + "examples": [ + { + "inputJson": "{ \"senderName\": \"Acme Corp\", \"senderAddress\": \"123 Business Rd, Metropolis\", \"recipientName\": \"John Doe\", \"recipientAddress\": \"456 Residential St, Gotham\", \"invoiceNumber\": \"INV-1001\", \"invoiceDate\": \"2024-06-01\", \"dueDate\": \"2024-06-15\", \"lineItems\": [ { \"description\": \"Website Design\", \"quantity\": 1, \"unitPrice\": 1500, \"taxRate\": 0.1 }, { \"description\": \"Hosting (6 months)\", \"quantity\": 6, \"unitPrice\": 20 } ], \"currency\": \"USD\", \"paymentTerms\": \"Payment due within 14 days via bank transfer.\" }", + "description": "Invoice text for a client including web design and hosting services with a tax rate on one item." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "copywriting.createReleaseNotes", + "description": "Generates professional release notes text based on provided software version details, feature descriptions, bug fixes, and known issues. Accepts a structured input outlining the version, date, and categorized updates, and outputs a polished, user-friendly release notes document suitable for product announcements or documentation.", + "category": "copywriting", + "parameters": [ + { + "name": "version", + "type": "string", + "description": "The software version identifier for this release (e.g., 'v2.3.1').", + "required": true, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "The release date in ISO format (YYYY-MM-DD) to include in the notes.", + "required": false, + "defaultValue": "" + }, + { + "name": "newFeatures", + "type": "array", + "description": "List of new feature descriptions introduced in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bugFixes", + "type": "array", + "description": "List of resolved bugs and issue fixes included in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "knownIssues", + "type": "array", + "description": "List of any known issues or limitations users should be aware of.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Optional additional notes or disclaimers to include at the end of the release notes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single 'releaseNotes' string value with well-structured, clear, and formatted release notes text suitable for publication." + }, + "aiAgent": { + "useCase": "When preparing documentation or communications for a software product's new release, an AI agent can use this tool to automatically create comprehensive and reader-friendly release notes from structured update data, saving time and ensuring consistency.", + "limitations": "The tool cannot extract release information from unstructured inputs or source code automatically, and it requires well-formed input data. It does not format outputs for specific platforms like HTML or Markdown automatically.", + "examples": [ + "Create release notes for version 1.0.0 including several new features and bug fixes with a release date.", + "Generate release notes for a patch release that only fixes bugs and includes known issues.", + "Produce release notes including additional disclaimers for an enterprise product release." + ] + }, + "tags": [ + "copywriting", + "release notes", + "software documentation", + "product update", + "marketing text" + ], + "examples": [ + { + "inputJson": "{\"version\":\"v2.3.1\",\"releaseDate\":\"2024-05-15\",\"newFeatures\":[\"Added multi-language support\",\"Improved user dashboard UI\"],\"bugFixes\":[\"Fixed crash when opening settings\",\"Resolved data sync issues\"],\"knownIssues\":[\"Login delays under heavy load\"],\"additionalNotes\":\"Please backup your data before updating.\"}", + "description": "Generate detailed release notes including new features, bug fixes, known issues, and additional instructions." + }, + { + "inputJson": "{\"version\":\"v1.0.0\",\"newFeatures\":[\"Initial product launch with core features\"],\"bugFixes\":[],\"knownIssues\":[]}", + "description": "Create initial release notes for the product launch with core features only." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "copywriting.createChangelog", + "description": "Generates a well-structured changelog document based on provided release notes and version details. It accepts inputs such as version number, release date, list of changes categorized by type (added, fixed, changed, removed), and outputs a formatted changelog text in markdown or plain text suitable for release documentation.", + "category": "copywriting", + "parameters": [ + { + "name": "version", + "type": "string", + "description": "The semantic version number for the release, e.g., '1.2.0'.", + "required": true, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "Release date in YYYY-MM-DD format. If omitted, no date is included.", + "required": false, + "defaultValue": "" + }, + { + "name": "changes", + "type": "object", + "description": "An object categorizing change descriptions by type, e.g., {'added': [...], 'fixed': [...], 'changed': [...], 'removed': [...]}. Each category is optional but values are arrays of strings describing the changes.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the changelog text, either 'markdown' or 'plaintext'. Defaults to 'markdown'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to include a header title like '## [version] - releaseDate' in the changelog output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted changelog text under the 'changelogText' property." + }, + "aiAgent": { + "useCase": "When an AI agent needs to produce professional and standardized changelogs from raw release notes or update descriptions, especially for software or product releases, use this tool to transform categorized changes into clear, formatted documents for publishing or developer communication.", + "limitations": "This tool generates textual changelogs based on input data but does not validate semantic versioning or automate gathering changes from version control commits. It also does not handle multilingual changelogs or graphical changelog formats.", + "examples": [ + "Create a markdown changelog for version 2.5.0 released on 2024-04-15 including added features and bug fixes.", + "Generate a plaintext changelog without a release date for version 1.0.0 with only removed and fixed changes.", + "Produce a changelog markdown including a header for version 3.0.1 with multiple change categories." + ] + }, + "tags": [ + "copywriting", + "changelog", + "release notes", + "documentation", + "marketing", + "software" + ], + "examples": [ + { + "inputJson": "{\"version\":\"2.0.0\",\"releaseDate\":\"2024-05-01\",\"changes\":{\"added\":[\"New user dashboard introduced\",\"Support for multi-factor authentication\"],\"fixed\":[\"Resolved login timeout issue\",\"Fixed typo in onboarding email\"]},\"format\":\"markdown\",\"includeHeader\":true}", + "description": "Generate a markdown changelog for version 2.0.0 with added features and fixes, including the release date and header." + }, + { + "inputJson": "{\"version\":\"1.0.0\",\"changes\":{\"removed\":[\"Deprecated legacy API endpoints\"]},\"format\":\"plaintext\",\"includeHeader\":false}", + "description": "Generate a plaintext changelog for version 1.0.0 listing removed features, without release date or header." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Changelog", + "context": null + } + }, + { + "name": "copywriting.createEmail", + "description": "Generates a professionally written marketing or promotional email based on specified input parameters such as target audience, product/service details, tone, and call-to-action. The tool processes the inputs to compose a coherent, engaging email content suitable for outreach, sales, or informational campaigns.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended recipients of the email (e.g., young professionals, existing customers)", + "required": true, + "defaultValue": "" + }, + { + "name": "productOrService", + "type": "string", + "description": "Name and brief description of the product or service being promoted", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email (e.g., friendly, formal, persuasive)", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "callToAction", + "type": "string", + "description": "The action you want the reader to take after reading the email (e.g., buy now, sign up)", + "required": true, + "defaultValue": "" + }, + { + "name": "emailLength", + "type": "string", + "description": "Preferred length of the email content (e.g., short, medium, long)", + "required": false, + "defaultValue": "medium" + }, + { + "name": "includeSubjectLine", + "type": "boolean", + "description": "Whether to generate an email subject line along with the body", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated email subject (if requested) and body content as strings" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate tailored, persuasive marketing or promotional emails quickly for various audiences and products, ensuring tone and message align with campaign goals. It efficiently creates structured email content based on provided details to aid in outreach and sales efforts.", + "limitations": "Cannot replace human review for compliance, cultural sensitivity, or highly specialized industry jargon. It does not send emails or handle responses.", + "examples": [ + "Generate a friendly email promoting a new online course for beginner photographers with a call-to-action to sign up.", + "Create a formal email to existing customers advertising a holiday sale with a prompt to visit the website.", + "Produce a short, persuasive email targeting young professionals to try a new fitness app with a download link call-to-action." + ] + }, + "tags": [ + "copywriting", + "email", + "marketing", + "promotional", + "sales", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"young professionals interested in fitness\",\"productOrService\":\"FitTrack App, a personalized fitness tracking application\",\"tone\":\"persuasive\",\"callToAction\":\"download the app now\",\"emailLength\":\"short\",\"includeSubjectLine\":true}", + "description": "Create a short, persuasive marketing email promoting a fitness app with a call to action to download." + }, + { + "inputJson": "{\"targetAudience\":\"existing customers of a tech gadget store\",\"productOrService\":\"Holiday Season 20% off Sale on all gadgets\",\"tone\":\"friendly\",\"callToAction\":\"visit our store today\",\"emailLength\":\"medium\",\"includeSubjectLine\":true}", + "description": "Generate a medium length friendly promotional email about a holiday sale for existing customers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "copywriting.createArticle", + "description": "Generates a tailored marketing article based on provided topic, target audience, tone, and desired length. Accepts inputs describing the article's purpose and style, processes content creation using AI language capabilities, and produces a coherent, engaging article ready for promotional use.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the article for content focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor language and tone appropriately.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the article, e.g., professional, friendly, persuasive, or casual.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "length", + "type": "number", + "description": "Approximate word count target for the article.", + "required": false, + "defaultValue": "500" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases to include for SEO and thematic emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call-to-action statement to conclude the article.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article text and metadata including word count and included keywords." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to generate original and engaging marketing content tailored to a specific topic and audience, saving time for content creators and marketers.", + "limitations": "The tool may not produce perfectly accurate or specialized technical content and cannot verify factual accuracy. It is also limited by provided parameters and may require human editing for best results.", + "examples": [ + "Write a persuasive article about the benefits of green energy for environmentally conscious consumers.", + "Create a friendly and casual blog post about new fitness apparel targeting young adults.", + "Generate a professional and concise article on cloud computing trends for IT decision makers." + ] + }, + "tags": [ + "copywriting", + "content creation", + "marketing", + "article", + "seo", + "writing", + "ai-generated" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of sustainable packaging\",\"targetAudience\":\"eco-conscious consumers and businesses\",\"tone\":\"persuasive\",\"length\":600,\"keywords\":[\"sustainable packaging\",\"environment\",\"eco-friendly\"],\"callToAction\":\"Switch to sustainable packaging today!\"}", + "description": "Generate a persuasive article about sustainable packaging targeting eco-conscious readers with specified keywords and a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Article", + "context": null + } + }, + { + "name": "copywriting.createResume", + "description": "Generates a professional resume document based on user-provided personal details, job history, education, and skills. Supports multiple formats and provides tailored output for different industries or job roles.", + "category": "copywriting", + "parameters": [ + { + "name": "fullName", + "type": "string", + "description": "The candidate's full name as it should appear on the resume.", + "required": true, + "defaultValue": "" + }, + { + "name": "contactInfo", + "type": "object", + "description": "Contact details including email, phone number, and optionally LinkedIn or portfolio links.", + "required": true, + "defaultValue": "" + }, + { + "name": "professionalSummary", + "type": "string", + "description": "A brief summary or objective statement highlighting the candidate's career goals or key qualifications.", + "required": false, + "defaultValue": "" + }, + { + "name": "workExperience", + "type": "array", + "description": "List of work experience entries, each with company, role, start and end dates, and key achievements.", + "required": true, + "defaultValue": "" + }, + { + "name": "education", + "type": "array", + "description": "Educational background including institutions, degrees earned, and graduation years.", + "required": true, + "defaultValue": "" + }, + { + "name": "skills", + "type": "array", + "description": "Array of skills or competencies relevant to the targeted job role.", + "required": false, + "defaultValue": "" + }, + { + "name": "industry", + "type": "string", + "description": "Industry or job sector to tailor the resume phrasing and keywords (e.g., software engineering, marketing).", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the resume (e.g., PDF, DOCX, plain text).", + "required": false, + "defaultValue": "PDF" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated resume file's content encoded as base64 string and the filename with extension." + }, + "aiAgent": { + "useCase": "Use this tool when a user needs to quickly generate a tailored, professional resume based on structured input data. It helps automate resume creation by formatting and organizing user data according to industry best practices and outputting in common document formats.", + "limitations": "This tool cannot evaluate the quality or accuracy of user-provided data. It cannot replace personalized career advice or job coaching. Complex layout customizations or creative designs beyond templates are not supported.", + "examples": [ + "Create a resume for a software engineer with three previous jobs and a skills list.", + "Generate a marketing resume emphasizing campaign management experience and social media skills.", + "Produce a simple text resume for a recent graduate including education and internships." + ] + }, + "tags": [ + "copywriting", + "resume", + "document generation", + "career", + "job application", + "professional writing" + ], + "examples": [ + { + "inputJson": "{\"fullName\":\"Jane Doe\",\"contactInfo\":{\"email\":\"jane.doe@example.com\",\"phone\":\"555-123-4567\",\"linkedin\":\"linkedin.com/in/janedoe\"},\"professionalSummary\":\"Experienced software developer specializing in full-stack web applications.\",\"workExperience\":[{\"company\":\"Tech Solutions\",\"role\":\"Software Engineer\",\"startDate\":\"2018-06\",\"endDate\":\"2022-04\",\"achievements\":[\"Developed scalable web apps\",\"Improved app performance by 30%\"]},{\"company\":\"Web Start\",\"role\":\"Junior Developer\",\"startDate\":\"2016-01\",\"endDate\":\"2018-05\",\"achievements\":[\"Assisted in front-end development\",\"Wrote unit tests\"]}],\"education\":[{\"institution\":\"State University\",\"degree\":\"BSc Computer Science\",\"graduationYear\":\"2015\"}],\"skills\":[\"JavaScript\",\"React\",\"Node.js\",\"SQL\"],\"industry\":\"software engineering\",\"outputFormat\":\"PDF\"}", + "description": "Generate a software engineering resume in PDF format with detailed work experience and skills for Jane Doe." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Resume", + "context": null + } + }, + { + "name": "content-creation.renderQuote", + "description": "Generates a styled HTML snippet for a given quote and optional author. It accepts quote text, author name, and styling options such as font size, color, and alignment, then returns a ready-to-use HTML string rendering the quote attractively for web content or social media.", + "category": "content-creation", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The main text of the quote to render, required, should be a meaningful sentence or phrase.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "The author or source of the quote to display below the quote text, optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "fontSize", + "type": "string", + "description": "CSS font size for the quote text, e.g., '16px', default is '18px'.", + "required": false, + "defaultValue": "18px" + }, + { + "name": "color", + "type": "string", + "description": "Text color for the quote, expressed in CSS format like hex or named color, default '#333'.", + "required": false, + "defaultValue": "#333" + }, + { + "name": "textAlign", + "type": "string", + "description": "Text alignment for the quote container: 'left', 'center', or 'right'.", + "required": false, + "defaultValue": "center" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color of the quote container in CSS format, default is transparent.", + "required": false, + "defaultValue": "transparent" + }, + { + "name": "maxWidth", + "type": "string", + "description": "Maximum width for the quote container (CSS units), defaults to '500px'.", + "required": false, + "defaultValue": "500px" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML string of the styled quote under the 'html' property." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create visually appealing, styled quote snippets for web pages, blogs, newsletters, or social media posts. It is useful to dynamically display inspirational, motivational, or cited quotes with optional author attribution and customizable styling.", + "limitations": "This tool only produces static HTML snippets and does not support advanced animations, external CSS linking, or interactive quote features.", + "examples": [ + "Render a quote by Albert Einstein with large font and centered alignment.", + "Generate a left-aligned quote with blue text and a light background.", + "Create a minimal styled quote without author attribution." + ] + }, + "tags": [ + "content creation", + "rendering", + "quote", + "HTML", + "styling", + "text formatting" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"The only limit to our realization of tomorrow is our doubts of today.\",\"author\":\"Franklin D. Roosevelt\",\"fontSize\":\"20px\",\"color\":\"#0055AA\",\"textAlign\":\"center\",\"backgroundColor\":\"#f0f8ff\",\"maxWidth\":\"600px\"}", + "description": "Render a centered, large blue quote with author and a light blue background." + }, + { + "inputJson": "{\"quoteText\":\"Simplicity is the ultimate sophistication.\",\"author\":\"Leonardo da Vinci\",\"fontSize\":\"16px\",\"color\":\"#444\",\"textAlign\":\"left\"}", + "description": "Render a left-aligned quote with muted dark text and default max width." + }, + { + "inputJson": "{\"quoteText\":\"Stay hungry, stay foolish.\",\"fontSize\":\"18px\",\"color\":\"#222\",\"textAlign\":\"right\",\"backgroundColor\":\"#fff0f5\"}", + "description": "Right-aligned quote without author and a faint pink background." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Quote", + "context": null + } + }, + { + "name": "copywriting.createContract", + "description": "Generates a customized contract document based on specified contract type, parties involved, key terms, and optional clauses. Accepts structured input to tailor agreement sections and outputs a well-organized, coherent contract text suitable for legal or business use.", + "category": "copywriting", + "parameters": [ + { + "name": "contractType", + "type": "string", + "description": "Type of contract to generate, such as 'Service Agreement', 'Non-Disclosure Agreement', or 'Sales Contract'.", + "required": true, + "defaultValue": "" + }, + { + "name": "parties", + "type": "array", + "description": "List of parties involved in the contract, each with a name and role.", + "required": true, + "defaultValue": "" + }, + { + "name": "effectiveDate", + "type": "string", + "description": "The date when the contract becomes effective, in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "terms", + "type": "object", + "description": "Key contractual terms including payment, duration, obligations, and termination conditions.", + "required": true, + "defaultValue": "" + }, + { + "name": "optionalClauses", + "type": "array", + "description": "Array of additional clauses to include, such as confidentiality, dispute resolution, or force majeure.", + "required": false, + "defaultValue": "" + }, + { + "name": "governingLaw", + "type": "string", + "description": "Jurisdiction law governing the contract (e.g., 'California, USA').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated contract text as a single formatted string and a summary of key contract elements extracted for quick reference." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce a legally styled contract document quickly and tailored to specific business arrangements by providing structured input describing contract parties, terms, and clauses. It can streamline contract creation, reduce drafting errors, and ensure consistency across contracts.", + "limitations": "This tool does not provide legal advice or replace consultation with qualified legal counsel. It generates draft contracts based on templates and input parameters, which may require legal review before execution.", + "examples": [ + "Create a service agreement contract between two companies with payment terms, confidentiality clause, and termination conditions.", + "Generate a non-disclosure agreement between an individual and a company effective on a specific date, governed by New York law.", + "Draft a sales contract including parties' details, delivery terms, payment schedule, and a force majeure clause." + ] + }, + "tags": [ + "copywriting", + "contract", + "legal", + "document generation", + "business", + "agreement" + ], + "examples": [ + { + "inputJson": "{\"contractType\":\"Service Agreement\",\"parties\":[{\"name\":\"Acme Corp.\",\"role\":\"Provider\"},{\"name\":\"Beta LLC\",\"role\":\"Client\"}],\"effectiveDate\":\"2024-07-01\",\"terms\":{\"payment\":\"Monthly fee of $5000\",\"duration\":\"12 months\",\"obligations\":\"Provider to supply consulting services\",\"termination\":\"30 days notice\"},\"optionalClauses\":[\"Confidentiality\",\"Dispute Resolution\"],\"governingLaw\":\"California, USA\"}", + "description": "Generate a service agreement with key terms between Acme Corp. and Beta LLC starting July 1, 2024, governed by California law." + }, + { + "inputJson": "{\"contractType\":\"Non-Disclosure Agreement\",\"parties\":[{\"name\":\"John Smith\",\"role\":\"Discloser\"},{\"name\":\"XYZ Inc.\",\"role\":\"Recipient\"}],\"terms\":{\"duration\":\"2 years\",\"obligations\":\"Protect all disclosed confidential information\"},\"governingLaw\":\"New York, USA\"}", + "description": "Create an NDA between an individual and a company with confidentiality obligations and a 2-year term." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "content-creation.renderReference", + "description": "Renders a formatted bibliographic reference string from structured reference data. Accepts input containing citation fields such as author, title, publication year, publisher, etc., and outputs a properly formatted reference string in the specified citation style (e.g., APA, MLA, Chicago).", + "category": "content-creation", + "parameters": [ + { + "name": "referenceData", + "type": "object", + "description": "An object containing the reference metadata fields such as authors, title, year, journal, volume, issue, pages, publisher, DOI, URL, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The citation style to format the reference in (e.g., apa, mla, chicago).", + "required": false, + "defaultValue": "apa" + }, + { + "name": "includeUrl", + "type": "boolean", + "description": "Whether to include URL or DOI links in the rendered reference if available.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en') for localized formatting or punctuation, optional.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single 'formattedReference' string property containing the fully formatted bibliographic reference." + }, + "aiAgent": { + "useCase": "Use this tool when you have structured bibliographic metadata for a reference and need a human-readable citation string formatted according to a specific academic or publication style. It is ideal for automatically generating reference lists and bibliographies in documents, research papers, or content management systems.", + "limitations": "This tool cannot verify the accuracy or completeness of the input reference data. It does not retrieve missing metadata from external databases. It only formats provided data according to style rules and does not produce inline citations.", + "examples": [ + "Render a reference in APA style from JSON metadata including authors, title and publication year.", + "Generate an MLA citation string for a journal article with volume, issue, and pages.", + "Format a book reference in Chicago style including publisher and DOI link." + ] + }, + "tags": [ + "content-creation", + "bibliography", + "citation", + "reference-formatting", + "academic", + "bibliographic-data", + "render" + ], + "examples": [ + { + "inputJson": "{\"referenceData\":{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Exploring AI\",\"year\":2022,\"publisher\":\"Tech Books Publishing\"},\"citationStyle\":\"apa\",\"includeUrl\":true}", + "description": "Render an APA style book reference with two authors and publisher." + }, + { + "inputJson": "{\"referenceData\":{\"authors\":[\"Brown, Lisa\"],\"title\":\"Deep Learning Advances\",\"journal\":\"Journal of AI Research\",\"year\":2021,\"volume\":45,\"issue\":3,\"pages\":\"123-145\",\"doi\":\"10.1000/jar.2021.45.3.123\"},\"citationStyle\":\"mla\",\"includeUrl\":true}", + "description": "Render an MLA style journal article citation including DOI." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Reference", + "context": null + } + }, + { + "name": "copywriting.createDocument", + "description": "Generates a tailored marketing or promotional document based on provided input such as target audience, product details, tone, and document type. Processes the input to create coherent, persuasive text suitable for emails, brochures, ads, or social media posts.", + "category": "copywriting", + "parameters": [ + { + "name": "targetAudience", + "type": "string", + "description": "Defines the intended audience for the document to tailor language and style accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "Name of the product or service being promoted, to include in the document.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyFeatures", + "type": "array", + "description": "List of main features or benefits of the product/service to highlight in the text.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "Type of document to create, e.g., 'email', 'brochure', 'advertisement', 'social media post'.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone/style of the writing, e.g., 'professional', 'friendly', 'urgent', 'casual'.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "wordCount", + "type": "number", + "description": "Approximate targeted word count for the document to control length and detail.", + "required": false, + "defaultValue": "200" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing document text and metadata such as word count and suggested headline." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate marketing or promotional content tailored to specific audiences, products, and communication channels. It assists with creating polished text for campaigns, advertisements, or outreach emails based on structured inputs.", + "limitations": "This tool generates text based on input parameters but does not conduct market research or verify product claims. It may require user revision to ensure factual accuracy and brand compliance.", + "examples": [ + "Create a social media post for a new eco-friendly water bottle targeting millennials with a casual tone.", + "Generate an email promoting a software update to existing customers with a professional but enthusiastic tone.", + "Produce a short ad copy highlighting key benefits of a fitness app for health-conscious individuals." + ] + }, + "tags": [ + "copywriting", + "marketing", + "document generation", + "promotional text", + "content creation", + "advertisement", + "brochure", + "email" + ], + "examples": [ + { + "inputJson": "{\"targetAudience\":\"millennials\",\"productName\":\"EcoSplash Water Bottle\",\"keyFeatures\":[\"BPA-free\",\"Keeps drinks cold for 24 hours\",\"Eco-friendly materials\"],\"documentType\":\"social media post\",\"tone\":\"casual\",\"wordCount\":100}", + "description": "Generate a casual social media post targeting millennials for an eco-friendly water bottle." + }, + { + "inputJson": "{\"targetAudience\":\"software users\",\"productName\":\"TaskMaster Pro v2.0\",\"keyFeatures\":[\"New UI\",\"Faster syncing\",\"Bug fixes\"],\"documentType\":\"email\",\"tone\":\"professional\",\"wordCount\":150}", + "description": "Create a professional promotional email about a software update to existing users." + }, + { + "inputJson": "{\"targetAudience\":\"fitness enthusiasts\",\"productName\":\"FitTrack App\",\"keyFeatures\":[\"Personalized workout plans\",\"Nutrition tracking\",\"Community challenges\"],\"documentType\":\"advertisement\",\"tone\":\"enthusiastic\",\"wordCount\":80}", + "description": "Write an enthusiastic ad copy highlighting benefits of a fitness app for health-conscious users." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Document", + "context": null + } + }, + { + "name": "copywriting.createProposal", + "description": "Generates a professional business proposal document based on provided client details, project scope, objectives, pricing, and timelines. Processes structured input to create a coherent, persuasive proposal text suitable for client submission.", + "category": "copywriting", + "parameters": [ + { + "name": "clientName", + "type": "string", + "description": "The name of the client or company the proposal is addressed to.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectTitle", + "type": "string", + "description": "The title of the project or engagement for which the proposal is created.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectScope", + "type": "string", + "description": "Detailed description of the work or services to be provided in the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "List of key goals or objectives the project aims to achieve.", + "required": true, + "defaultValue": "" + }, + { + "name": "pricingDetails", + "type": "object", + "description": "An object defining pricing structure, including cost breakdowns or total price.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeline", + "type": "string", + "description": "Expected project duration or milestones and delivery dates.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any extra important notes or terms to be included in the proposal.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated proposal text and metadata." + }, + "aiAgent": { + "useCase": "Use when needing to quickly generate polished, client-ready business proposals based on structured project input data, ensuring consistent tone and formatting while saving time on manual drafting.", + "limitations": "Cannot generate legal contracts or highly customized proposals requiring expert domain-specific knowledge; output should be reviewed by a human before client submission.", + "examples": [ + "Generate a proposal for a website redesign project for Acme Corp with specified objectives and pricing.", + "Create a proposal document for consulting services including timeline and pricing info.", + "Draft a business proposal for a mobile app development project with scope and goals outlined." + ] + }, + "tags": [ + "copywriting", + "proposal", + "business", + "marketing", + "document generation", + "client communication" + ], + "examples": [ + { + "inputJson": "{\"clientName\":\"Acme Corporation\",\"projectTitle\":\"Website Redesign Project\",\"projectScope\":\"Redesign the corporate website to improve UX and update branding.\",\"objectives\":[\"Improve site navigation\",\"Increase mobile responsiveness\",\"Modernize visual design\"],\"pricingDetails\":{\"totalPrice\":15000,\"currency\":\"USD\",\"paymentTerms\":\"50% upfront, 50% on delivery\"},\"timeline\":\"Completion within 3 months.\",\"additionalNotes\":\"Includes two rounds of revisions.\"}", + "description": "Generate a detailed proposal for Acme Corporation's website redesign including scope, objectives, pricing, timeline, and notes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Proposal", + "context": null + } + }, + { + "name": "copywriting.createReport", + "description": "Generates a comprehensive written report based on provided input data and user instructions. Accepts parameters such as report topic, key points, desired length, style, and target audience. Processes the input to compose a structured, coherent report suitable for marketing, business, or analytical contexts. Outputs the complete text of the report as a string.", + "category": "copywriting", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the report to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of essential points or data to be included and emphasized in the report.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired word count of the report; influences level of detail.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "style", + "type": "string", + "description": "The tone and style of the report; e.g., formal, persuasive, informational.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor the report's language and complexity.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full report text under the 'text' field." + }, + "aiAgent": { + "useCase": "Use this tool whenever a detailed marketing or business report needs to be generated quickly from key input points and context, such as for presentations, client proposals, or internal reviews. It helps focus writing efforts and produces structured drafts suitable for further editing.", + "limitations": "This tool cannot verify factual accuracy of input data or create visual elements like charts and images. It only generates textual content based on provided inputs and instructions.", + "examples": [ + "Create a formal annual sales report focusing on growth trends and key markets, about 1200 words.", + "Generate an informational report summarizing new product features for prospective clients in a persuasive style.", + "Produce a brief business analysis report highlighting strengths and weaknesses for internal stakeholders." + ] + }, + "tags": [ + "copywriting", + "report", + "marketing", + "business", + "writing", + "documentation", + "content generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Annual Marketing Performance\",\"keyPoints\":[\"Sales increased by 15% compared to last year\",\"Social media engagement grew by 30%\",\"Customer retention rate improved\",\"New market segments explored\"],\"length\":1200,\"style\":\"formal\",\"targetAudience\":\"company executives and board members\"}", + "description": "Create a formal annual marketing performance report for executives focusing on growth and key achievements." + }, + { + "inputJson": "{\"topic\":\"Product Launch Summary\",\"keyPoints\":[\"Features overview\",\"Target audience benefits\",\"Launch event reception\",\"Early sales data\"],\"length\":800,\"style\":\"persuasive\",\"targetAudience\":\"potential customers and partners\"}", + "description": "Generate a persuasive product launch summary report targeting potential customers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.renderCitation", + "description": "This tool accepts citation data in various input formats (such as JSON objects detailing author, title, publication, year, etc.) and renders it into a properly formatted citation string according to a specified citation style (APA, MLA, Chicago, etc.). It processes the input data, applies style rules, and outputs a ready-to-use citation text for academic or professional use.", + "category": "content-creation", + "parameters": [ + { + "name": "citationData", + "type": "object", + "description": "Structured bibliographic information including fields like author, title, publisher, year, etc., required to generate the citation.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The citation style to use for formatting (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The output format specifying how to render the citation text, e.g., 'plain' text or 'HTML' with markup.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "includeUrl", + "type": "boolean", + "description": "Whether to include the URL or DOI if present in the citation data.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'fr') for localized citation formatting if applicable.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered citation as a formatted string ready for display or insertion into documents." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to output bibliographic citations from structured data in a specific style for academic or publishing purposes, ensuring consistent citation formatting automatically.", + "limitations": "This tool does not validate the correctness of the citation data fields nor does it support all possible citation styles or very complex source types like legal or ancient texts. It assumes well-formed input data.", + "examples": [ + "Generate an APA citation string for a journal article using given metadata.", + "Render an MLA style citation for a book including URL if available.", + "Provide a Chicago style citation output in HTML format for a website reference." + ] + }, + "tags": [ + "content-creation", + "citation", + "formatting", + "academic", + "bibliography", + "rendering" + ], + "examples": [ + { + "inputJson": "{\"citationData\":{\"author\":\"Doe, John\",\"title\":\"The Example Book\",\"publisher\":\"Fictional Press\",\"year\":\"2020\",\"url\":\"https://example.com/book\"},\"style\":\"APA\",\"outputFormat\":\"plain\",\"includeUrl\":true,\"language\":\"en\"}", + "description": "Generate a plain text APA citation including URL." + }, + { + "inputJson": "{\"citationData\":{\"author\":\"Smith, Jane\",\"title\":\"Research Paper\",\"journal\":\"Science Journal\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"100-110\",\"year\":\"2019\"},\"style\":\"MLA\",\"outputFormat\":\"plain\",\"includeUrl\":false,\"language\":\"en\"}", + "description": "Generate an MLA citation for a journal article without URL." + }, + { + "inputJson": "{\"citationData\":{\"author\":\"Patel, Anil\",\"title\":\"Web Article\",\"website\":\"Example News\",\"year\":\"2021\",\"url\":\"https://examplenews.com/article\"},\"style\":\"Chicago\",\"outputFormat\":\"HTML\",\"includeUrl\":true,\"language\":\"en\"}", + "description": "Generate an HTML formatted Chicago style citation for a web article including URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.renderLink", + "description": "Generates an HTML hyperlink element as a string based on provided URL, display text, and optional attributes such as target, title, and CSS classes. Accepts URL and display text as inputs, processes attributes, and outputs a complete anchor tag string.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL for the hyperlink. Must be a valid URL.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "The text to display as the clickable link. If empty, the URL will be used as text.", + "required": false, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "If true, adds target='_blank' and rel='noopener' to open the link in a new browser tab.", + "required": false, + "defaultValue": "false" + }, + { + "name": "title", + "type": "string", + "description": "Optional title attribute for the link, providing additional info on hover.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "List of CSS class names to apply to the anchor element.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the 'html' field with the fully rendered anchor tag as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a safe, customizable HTML anchor tag string for embedding links in content dynamically, including defining how links open and styling them with CSS classes. It helps ensure consistent markup generation with optional attributes.", + "limitations": "Does not validate if the URL is reachable or safe beyond basic string use. Does not sanitize inputs for scripting vulnerabilities; the agent should validate inputs beforehand. Handles only basic anchor tag rendering.", + "examples": [ + "Generate a link to 'https://example.com' with display 'Example', opening in a new tab.", + "Create a link with no display text, so the URL is shown, and add CSS classes 'btn' and 'btn-primary'.", + "Render a link to 'https://openai.com' with a title attribute set to 'OpenAI Homepage'." + ] + }, + "tags": [ + "content", + "html", + "link", + "rendering", + "anchor", + "web", + "frontend" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"displayText\":\"Example\",\"openInNewTab\":true,\"title\":\"Visit example website\",\"cssClasses\":[\"link\",\"external\"]}", + "description": "Renders a link to example.com with display text 'Example', opens in new tab, has title and css classes." + }, + { + "inputJson": "{\"url\":\"https://openai.com\",\"displayText\":\"\",\"openInNewTab\":false,\"title\":\"OpenAI Homepage\",\"cssClasses\":[] }", + "description": "Renders a link to OpenAI homepage showing the URL as text and a title attribute, no new tab or classes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.renderHeading", + "description": "Renders a formatted HTML heading element based on the provided text content, heading level, and optional styling attributes. Accepts plain text or simple markdown-like inline markup and outputs a string containing the complete HTML heading tag with applied classes and styles, suitable for embedding in web pages or rich text documents.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text content to be included inside the heading. Supports plain text or basic inline markdown like *emphasis* or **strong**.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "The heading level indicating the HTML heading tag to use (1-6 correspond to-
).", + "required": true, + "defaultValue": "1" + }, + { + "name": "cssClass", + "type": "string", + "description": "Optional CSS class name(s) to add to the heading element for styling purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "inlineStyle", + "type": "string", + "description": "Optional inline CSS styles to apply directly to the heading element, e.g., \"color:red; font-weight:bold;\".", + "required": false, + "defaultValue": "" + }, + { + "name": "escapeHtml", + "type": "boolean", + "description": "Determines whether to escape HTML special characters in the text content to prevent injection; set to false if the text contains trusted HTML.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'html' with the rendered heading element as an HTML string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate semantic HTML heading elements programmatically from text inputs, including scenarios where configurable levels and styling are required such as dynamically generating content sections or preparing headings for a CMS or web app.", + "limitations": "This tool only generates heading elements; it does not generate or parse full documents or manage accessibility attributes beyond standard HTML tags. It does not support complex markdown or nested HTML elements inside the heading text.", + "examples": [ + "Render a level 2 heading with the text 'Welcome to Our Site'.", + "Render a level 3 heading with text containing *emphasis* and a custom CSS class.", + "Render a level 1 heading with red colored text using inline styles." + ] + }, + "tags": [ + "html", + "heading", + "rendering", + "content-creation", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Welcome to Our Site\",\"level\":2}", + "description": "Render a simple level 2 heading with default styling." + }, + { + "inputJson": "{\"text\":\"This is a **bold** heading\",\"level\":3,\"cssClass\":\"section-title\"}", + "description": "Render level 3 heading with markdown strong and a CSS class for styling." + }, + { + "inputJson": "{\"text\":\"Alert!\",\"level\":1,\"inlineStyle\":\"color:red; font-weight:bold;\"}", + "description": "Render level 1 heading with inline CSS styles for red, bold text." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.renderWord", + "description": "Renders a styled word or short text snippet as a high-quality image or SVG. Accepts input text and styling options such as font, size, color, background, and output format. Processes visual rendering and returns a URL or binary data encoding the rendered word graphic suitable for web or design use.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The word or short text snippet to render visually.", + "required": true, + "defaultValue": "" + }, + { + "name": "fontFamily", + "type": "string", + "description": "Font family to use for rendering the text (e.g., Arial, Times New Roman).", + "required": false, + "defaultValue": "Arial" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size in pixels for the rendered word.", + "required": false, + "defaultValue": "48" + }, + { + "name": "fontColor", + "type": "string", + "description": "Color of the text, as named color or hex code (e.g., '#000000').", + "required": false, + "defaultValue": "#000000" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color behind the text, as named color or hex code. Use transparent if empty.", + "required": false, + "defaultValue": "transparent" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output image format: 'png', 'jpeg', or 'svg'.", + "required": false, + "defaultValue": "png" + }, + { + "name": "bold", + "type": "boolean", + "description": "Whether to render the text in bold style.", + "required": false, + "defaultValue": "false" + }, + { + "name": "italic", + "type": "boolean", + "description": "Whether to render the text in italic style.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing a data URI string or URL to the rendered image and metadata including width, height, and format." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to programmatically generate a visual representation of a word or short text snippet as a styled image or vector graphic. Ideal for dynamic logo creation, styled labels, graphical buttons, or text-based visuals in content pipelines.", + "limitations": "This tool cannot render long passages of text or complex layouts. It focuses on single words or short phrases and does not support advanced typography features like kerning pairs or ligatures beyond standard font rendering.", + "examples": [ + "Render the word 'Hello' in bold italic red font on a transparent background as PNG.", + "Generate a 72px large blue 'Welcome' text with a white background saved as SVG.", + "Create the word 'Sale' in 100px black font with a yellow background in JPEG format." + ] + }, + "tags": [ + "rendering", + "text", + "graphics", + "image-generation", + "font", + "visual-content" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Hello\",\"fontFamily\":\"Helvetica\",\"fontSize\":60,\"fontColor\":\"#FF0000\",\"backgroundColor\":\"transparent\",\"outputFormat\":\"png\",\"bold\":true,\"italic\":true}", + "description": "Render 'Hello' in 60px bold italic Helvetica font, red color, transparent background as PNG." + }, + { + "inputJson": "{\"text\":\"Welcome\",\"fontSize\":72,\"fontColor\":\"blue\",\"backgroundColor\":\"white\",\"outputFormat\":\"svg\",\"bold\":false,\"italic\":false}", + "description": "Render 'Welcome' in 72px normal blue font with white background as SVG." + }, + { + "inputJson": "{\"text\":\"Sale\",\"fontSize\":100,\"fontColor\":\"#000000\",\"backgroundColor\":\"#FFFF00\",\"outputFormat\":\"jpeg\",\"bold\":false,\"italic\":false}", + "description": "Render 'Sale' in 100px black font with a bright yellow background as JPEG." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.renderDashboard", + "description": "Generates an interactive analytics dashboard based on provided data sources and configuration options. Accepts data inputs, visualization specifications, and user preferences to produce a rendered dashboard that can be embedded or displayed in web or app environments with customizable charts, tables, and filters.", + "category": "content-creation", + "parameters": [ + { + "name": "dataSources", + "type": "array", + "description": "List of data source objects detailing the datasets to be visualized, including connection strings, data types, and query definitions.", + "required": true, + "defaultValue": "" + }, + { + "name": "visualizationConfig", + "type": "object", + "description": "Configuration object specifying the type of charts, metrics, dimensions, and layout instructions for the dashboard.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Optional filters to apply on the data before rendering the dashboard, such as date ranges or attribute selectors.", + "required": false, + "defaultValue": "" + }, + { + "name": "theme", + "type": "string", + "description": "Theme name or style guide to apply to the dashboard visuals, e.g., 'light', 'dark', or custom theme identifier.", + "required": false, + "defaultValue": "light" + }, + { + "name": "refreshInterval", + "type": "number", + "description": "Time in seconds for automatic dashboard refresh from live data sources. Set 0 to disable auto-refresh.", + "required": false, + "defaultValue": "0" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the rendered dashboard output: 'html', 'json', or 'embedCode'.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered dashboard output as a string, plus metadata such as timestamp and any warnings." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create customizable, interactive dashboards for analytics purposes from multiple data inputs, supporting various chart types and user-driven filtering. Ideal for agents tasked with generating visual reports or embedding analytics views in applications or websites.", + "limitations": "Does not handle data ingestion or cleaning. Relies on preprocessed and valid input data sources. Complex data transformations must be done prior to providing input.", + "examples": [ + "Render a sales performance dashboard with bar charts and line graphs based on monthly sales data for the last year.", + "Generate an interactive KPI dashboard with filters for department and date ranges, themed in dark mode, outputting an embeddable HTML snippet.", + "Create a JSON-format dashboard representation for integration into a mobile analytics app with auto-refresh every 60 seconds." + ] + }, + "tags": [ + "dashboard", + "analytics", + "visualization", + "reporting", + "interactive", + "data", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"dataSources\":[{\"name\":\"salesData\",\"type\":\"csv\",\"url\":\"https://example.com/sales.csv\"}],\"visualizationConfig\":{\"charts\":[{\"type\":\"bar\",\"metric\":\"revenue\",\"dimension\":\"month\"},{\"type\":\"line\",\"metric\":\"units_sold\",\"dimension\":\"month\"}],\"layout\":{\"rows\":1,\"columns\":2}},\"filters\":{\"dateRange\":{\"start\":\"2023-01-01\",\"end\":\"2023-12-31\"}},\"theme\":\"light\",\"refreshInterval\":0,\"outputFormat\":\"html\"}", + "description": "Render a sales dashboard with bar and line charts for revenue and units sold across 2023." + }, + { + "inputJson": "{\"dataSources\":[{\"name\":\"employeeKPI\",\"type\":\"database\",\"connectionString\":\"Server=myServer;Database=myDB;User=myUser;Pwd=myPwd;\"}],\"visualizationConfig\":{\"charts\":[{\"type\":\"gauge\",\"metric\":\"employee_satisfaction_score\",\"dimension\":\"department\"}],\"layout\":{\"rows\":1,\"columns\":1}},\"filters\":{},\"theme\":\"dark\",\"refreshInterval\":120,\"outputFormat\":\"embedCode\"}", + "description": "Generate an embeddable dashboard showing employee satisfaction gauge chart by department, dark theme, auto-refresh every 2 minutes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Dashboard", + "context": null + } + }, + { + "name": "content-creation.renderChart", + "description": "Generates a chart image from provided structured data and configuration settings. Accepts data arrays or objects defining series, labels, and other chart elements; applies styling and formatting options; outputs a rendered chart image as base64-encoded PNG or SVG format suitable for embedding or saving.", + "category": "content-creation", + "parameters": [ + { + "name": "chartType", + "type": "string", + "description": "Type of chart to render, e.g., 'bar', 'line', 'pie', 'scatter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "object", + "description": "Structured data defining labels and datasets for the chart. Must follow a standard format with labels (array of strings) and datasets (array of objects with data arrays and labels).", + "required": true, + "defaultValue": "" + }, + { + "name": "options", + "type": "object", + "description": "Optional configuration object to customize chart appearance including colors, axis settings, legends, and dimensions.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output chart image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output chart image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output image, either 'png' or 'svg'.", + "required": false, + "defaultValue": "png" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing base64-encoded string of the rendered chart image and its MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to convert structured data into a visual chart for reports, presentations, or dashboards. It is ideal for generating dynamic visualizations programmatically from data sources or user input, enabling embedding in web or document formats.", + "limitations": "Cannot perform advanced data analysis or automatic data transformation. The tool expects data to be preprocessed and structured correctly. It does not support interactive charts or real-time updates.", + "examples": [ + "Generate a bar chart showing monthly sales data for 2023.", + "Create a pie chart to display percentage distribution of market segments.", + "Render a line chart comparing stock prices over time with custom colors and axis labels." + ] + }, + "tags": [ + "chart", + "visualization", + "data-visualization", + "image-generation", + "content-creation", + "rendering", + "media" + ], + "examples": [ + { + "inputJson": "{\"chartType\":\"bar\",\"data\":{\"labels\":[\"Jan\",\"Feb\",\"Mar\"],\"datasets\":[{\"label\":\"Sales\",\"data\":[150,200,170]}]},\"options\":{\"colors\":[\"#4e79a7\"]},\"width\":600,\"height\":400,\"outputFormat\":\"png\"}", + "description": "Render a 600x400 pixel bar chart in PNG format showing sales data for three months with a custom color." + }, + { + "inputJson": "{\"chartType\":\"pie\",\"data\":{\"labels\":[\"A\",\"B\",\"C\"],\"datasets\":[{\"label\":\"Segments\",\"data\":[30,45,25]}]},\"width\":500,\"height\":500,\"outputFormat\":\"svg\"}", + "description": "Create a 500x500 pixel pie chart in SVG format representing distribution percentages for three segments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Chart", + "context": null + } + }, + { + "name": "content-creation.renderParagraph", + "description": "Generates a formatted paragraph of text based on input content and optional styling preferences. Accepts a raw text string and styling options such as text alignment, font size, line spacing, and output format (HTML or plain text). Returns a rendered paragraph string with the specified formatting applied.", + "category": "content-creation", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The raw textual content to render as a paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "textAlignment", + "type": "string", + "description": "Specifies text alignment within the paragraph: 'left', 'right', 'center', or 'justify'.", + "required": false, + "defaultValue": "left" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size in pixels to apply to the paragraph text.", + "required": false, + "defaultValue": "14" + }, + { + "name": "lineHeight", + "type": "number", + "description": "Line height (spacing) multiplier for the paragraph text.", + "required": false, + "defaultValue": "1.5" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format of the rendered paragraph, either 'html' or 'plain'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "additionalStyles", + "type": "object", + "description": "An object specifying additional CSS styles as key-value pairs to apply to the paragraph (HTML output only).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered paragraph string in the specified format under the 'renderedParagraph' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a paragraph of text with specific formatting for inclusion in documents, web pages, or digital content. It is ideal for converting raw text into styled paragraphs with common formatting options. AI agents can utilize it for content presentation or when generating formatted HTML or plain text snippets.", + "limitations": "This tool does not support complex inline styling of individual words or phrases, nor does it process markdown or rich text input. It only applies general paragraph-level formatting.", + "examples": [ + "Render a paragraph with centered alignment and 16px font size in HTML format.", + "Generate a plain text paragraph with justified alignment and increased line spacing.", + "Create an HTML paragraph with custom CSS styles for color and background." + ] + }, + "tags": [ + "content", + "rendering", + "text-formatting", + "paragraph", + "HTML", + "plain-text" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"This is an example paragraph.\",\"textAlignment\":\"center\",\"fontSize\":16,\"lineHeight\":1.6,\"outputFormat\":\"html\"}", + "description": "Render a centered HTML paragraph with 16px font size and 1.6 line height." + }, + { + "inputJson": "{\"textContent\":\"Plain text paragraph\\nwith line breaks.\",\"textAlignment\":\"justify\",\"outputFormat\":\"plain\"}", + "description": "Generate a justified plain text paragraph without HTML formatting." + }, + { + "inputJson": "{\"textContent\":\"Styled paragraph.\",\"outputFormat\":\"html\",\"additionalStyles\":{\"color\":\"#333333\",\"background-color\":\"#f0f0f0\"}}", + "description": "Create an HTML paragraph with custom text color and background color styles." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.renderSentence", + "description": "Generates a grammatically correct and contextually appropriate sentence based on provided parameters such as keywords, desired tone, and language. Accepts input parameters that guide theme, style, and length, and outputs a natural language sentence suitable for digital content creation.", + "category": "content-creation", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "List of words or key phrases that the generated sentence should incorporate.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the sentence, e.g., formal, casual, humorous, or neutral.", + "required": false, + "defaultValue": "\"neutral\"" + }, + { + "name": "language", + "type": "string", + "description": "Language code (ISO 639-1) for the sentence's language output, e.g., 'en' for English.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length of the generated sentence. Defaults to 140 characters.", + "required": false, + "defaultValue": "140" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence string and metadata about the sentence, including its length and tone." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a coherent, contextually relevant sentence incorporating specific keywords with controlled tone and length, useful for drafting social media posts, captions, summaries, or creative content snippets.", + "limitations": "Cannot generate multiple sentences or paragraphs; output is limited to a single sentence. Accuracy depends on keyword relevance and may not always perfectly match intended tone or language subtleties.", + "examples": [ + "Generate a friendly sentence with keywords 'summer' and 'vacation'.", + "Create a formal sentence including the terms 'technology' and 'innovation'.", + "Produce a humorous sentence containing 'cat' and 'coffee'." + ] + }, + "tags": [ + "content-generation", + "sentence", + "natural-language", + "text-generation", + "tone-control", + "keyword-based" + ], + "examples": [ + { + "inputJson": "{\"keywords\": [\"summer\", \"vacation\"], \"tone\": \"friendly\", \"language\": \"en\", \"maxLength\": 100}", + "description": "Generate an English-friendly sentence that includes the keywords 'summer' and 'vacation' with a max length of 100." + }, + { + "inputJson": "{\"keywords\": [\"technology\", \"innovation\"], \"tone\": \"formal\"}", + "description": "Create a formal sentence in English that includes the keywords 'technology' and 'innovation'." + }, + { + "inputJson": "{\"keywords\": [\"cat\", \"coffee\"], \"tone\": \"humorous\", \"maxLength\": 80}", + "description": "Generate a humorous sentence containing the words 'cat' and 'coffee' limited to 80 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.renderText", + "description": "Renders input text by applying optional formatting styles such as bold, italic, underline, font size, and color. Accepts plain text and formatting instructions, then outputs HTML-formatted string reflecting the desired styles for use in web content or digital documents.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The plain text content to be formatted and rendered.", + "required": true, + "defaultValue": "" + }, + { + "name": "bold", + "type": "boolean", + "description": "Whether to apply bold styling to the entire text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "italic", + "type": "boolean", + "description": "Whether to apply italic styling to the entire text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "underline", + "type": "boolean", + "description": "Whether to underline the entire text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size in pixels to apply to the text, if specified.", + "required": false, + "defaultValue": "" + }, + { + "name": "color", + "type": "string", + "description": "Text color as a CSS-compatible string (e.g., '#000000' or 'red').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML string with the applied formatting under the key 'renderedHtml'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert plain text into formatted HTML for display in web pages, emails, or digital documents, with basic styling like bold, italic, underline, font size, and color applied consistently.", + "limitations": "This tool applies uniform styling to the entire text; it does not support partial or inline varied formatting within the same text input.", + "examples": [ + "Render the text 'Hello World' in bold and red color.", + "Render the text 'Sample Text' with italic, underline, and font size 18.", + "Render the text 'No formatting' with default style." + ] + }, + "tags": [ + "text", + "rendering", + "formatting", + "HTML", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Hello World\",\"bold\":true,\"color\":\"red\"}", + "description": "Render 'Hello World' in bold red text." + }, + { + "inputJson": "{\"text\":\"Sample Text\",\"italic\":true,\"underline\":true,\"fontSize\":18}", + "description": "Render 'Sample Text' italicized, underlined, with font size 18 pixels." + }, + { + "inputJson": "{\"text\":\"No formatting\"}", + "description": "Render 'No formatting' with default style (no special formatting)." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.renderGraph", + "description": "Renders customizable graphs from structured data inputs such as arrays or objects. Accepts parameters defining graph type, data points, labels, colors, and dimensions. Processes the data to produce an SVG or PNG image of the graph for embedding or display in digital content projects.", + "category": "content-creation", + "parameters": [ + { + "name": "graphType", + "type": "string", + "description": "Type of graph to render, e.g., 'line', 'bar', 'pie', 'scatter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataPoints", + "type": "array", + "description": "Array of data points or series to plot; format depends on graph type (e.g., array of numbers or objects with x,y).", + "required": true, + "defaultValue": "" + }, + { + "name": "labels", + "type": "array", + "description": "Optional array of labels corresponding to data points or axes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "colors", + "type": "array", + "description": "Optional array of colors for graph elements like bars, lines, or slices.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output graph image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output graph image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output image, e.g., 'svg' or 'png'.", + "required": false, + "defaultValue": "svg" + }, + { + "name": "title", + "type": "string", + "description": "Optional title to display above the graph.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered graph image encoded as a base64 string and the MIME type of the image." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate visualization graphics such as line charts, bar graphs, pie charts, or scatter plots from given numerical or categorical datasets to embed within reports, articles, dashboards, or presentations. It is useful for transforming raw data into visual summaries on demand.", + "limitations": "This tool cannot perform complex statistical analysis or dynamic interactive charting. It does not support 3D graphs or animations. It only produces static images in specified formats.", + "examples": [ + "Render a line graph showing monthly sales figures.", + "Create a pie chart representing market share percentages.", + "Generate a scatter plot with labeled points for data analysis." + ] + }, + "tags": [ + "graph", + "render", + "visualization", + "chart", + "data-visualization", + "content-creation", + "image", + "media" + ], + "examples": [ + { + "inputJson": "{\"graphType\":\"line\",\"dataPoints\":[10,20,15,30,25],\"labels\":[\"Jan\",\"Feb\",\"Mar\",\"Apr\",\"May\"],\"colors\":[\"#4caf50\"],\"width\":600,\"height\":400,\"outputFormat\":\"svg\",\"title\":\"Monthly Sales\"}", + "description": "Renders a line graph with sales data for five months with green line and labels." + }, + { + "inputJson": "{\"graphType\":\"pie\",\"dataPoints\":[40,30,20,10],\"labels\":[\"Product A\",\"Product B\",\"Product C\",\"Product D\"],\"colors\":[\"#f44336\",\"#2196f3\",\"#ffeb3b\",\"#9c27b0\"],\"width\":500,\"height\":500,\"outputFormat\":\"png\",\"title\":\"Product Market Share\"}", + "description": "Creates a colored pie chart in PNG representing product market shares." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Graph", + "context": null + } + }, + { + "name": "content-creation.renderScreenshot", + "description": "Generates a screenshot image of a specified web page URL or provided HTML content. Accepts URL or raw HTML input, waits until page load or specified delay, and outputs a PNG or JPEG image file encoded in Base64 or as a downloadable file URL.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The web page URL to capture as a screenshot. Either url or htmlContent must be provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "htmlContent", + "type": "string", + "description": "Raw HTML markup to render and capture as a screenshot. Used if url is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "The viewport width in pixels for rendering the page. Defaults to 1280.", + "required": false, + "defaultValue": "1280" + }, + { + "name": "height", + "type": "number", + "description": "The viewport height in pixels for rendering the page. Defaults to 720.", + "required": false, + "defaultValue": "720" + }, + { + "name": "delay", + "type": "number", + "description": "Delay in milliseconds to wait after page load before taking screenshot, allowing dynamic content to render. Defaults to 1000ms.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "fullPage", + "type": "boolean", + "description": "If true, captures the entire scrollable page, otherwise only the viewport.", + "required": false, + "defaultValue": "false" + }, + { + "name": "imageFormat", + "type": "string", + "description": "Image file format to output: 'png' or 'jpeg'. Defaults to 'png'.", + "required": false, + "defaultValue": "png" + }, + { + "name": "quality", + "type": "number", + "description": "Quality of the image output between 0-100 (only applies to JPEG). Defaults to 80.", + "required": false, + "defaultValue": "80" + }, + { + "name": "outputType", + "type": "string", + "description": "Output format: 'base64' for Base64 encoded string or 'url' for downloadable file URL.", + "required": false, + "defaultValue": "base64" + } + ], + "returns": { + "type": "object", + "description": "An object containing the screenshot result, including the image in the requested output format and metadata like width, height, format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate static visual captures of web pages or HTML markup for documentation, previews, testing, or archival purposes. It's ideal for capturing dynamic or static page states programmatically with configurable viewports and formats.", + "limitations": "Cannot interact with pages requiring authentication or complex client-side interactions beyond a simple delay. Does not support video or animated content capture. Rendering accuracy limited to what headless browser engine supports.", + "examples": [ + "Capture a screenshot of the homepage of example.com as a PNG base64 string.", + "Render provided HTML content with 1024x768 viewport and output JPEG image URL.", + "Take a full page screenshot of a news article URL after waiting 2 seconds for ads to load." + ] + }, + "tags": [ + "screenshot", + "rendering", + "webpage", + "content-creation", + "image", + "automation", + "html" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"width\":1280,\"height\":720,\"delay\":1000,\"fullPage\":false,\"imageFormat\":\"png\",\"outputType\":\"base64\"}", + "description": "Capture a 1280x720 viewport screenshot of https://example.com as PNG Base64 string" + }, + { + "inputJson": "{\"htmlContent\":\"
Hello World
\",\"width\":800,\"height\":600,\"imageFormat\":\"jpeg\",\"quality\":90,\"outputType\":\"url\"}", + "description": "Render simple HTML content with 800x600 viewport and output JPEG image URL with high quality" + }, + { + "inputJson": "{\"url\":\"https://news.example.com/article\",\"fullPage\":true,\"delay\":2000,\"outputType\":\"base64\"}", + "description": "Capture a full page screenshot of a news article URL after 2 seconds delay, output as Base64 PNG string" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Screenshot", + "context": null + } + }, + { + "name": "content-creation.renderAttachment", + "description": "Renders a digital attachment such as an image, video, audio, or document file within a web or application interface. Accepts the attachment's URL or base64 data along with optional metadata and rendering options to produce an embeddable HTML snippet or media element.", + "category": "content-creation", + "parameters": [ + { + "name": "attachmentUrl", + "type": "string", + "description": "The URL of the attachment to be rendered. Required if base64Data is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "base64Data", + "type": "string", + "description": "Base64 encoded data of the attachment. Required if attachmentUrl is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachmentType", + "type": "string", + "description": "Type of the attachment (e.g., image, video, audio, document). Used to determine rendering method.", + "required": true, + "defaultValue": "" + }, + { + "name": "altText", + "type": "string", + "description": "Alternative text for the attachment to improve accessibility, primarily for images and videos.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Desired width in pixels to render the attachment. Defaults to original or adaptive sizing if not specified.", + "required": false, + "defaultValue": "" + }, + { + "name": "height", + "type": "number", + "description": "Desired height in pixels to render the attachment. Defaults to original or adaptive sizing if not specified.", + "required": false, + "defaultValue": "" + }, + { + "name": "controls", + "type": "boolean", + "description": "For media like audio or video, whether to show playback controls. Default is true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "autoplay", + "type": "boolean", + "description": "Applicable for audio/video attachments, specifies if media should start playing automatically. Default is false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered HTML string for embedding the attachment and metadata used in rendering." + }, + "aiAgent": { + "useCase": "Use this tool when you need to embed or display media attachments dynamically in digital content environments, such as websites, email templates, or apps. It handles different media types and formats into standardized HTML elements for seamless rendering.", + "limitations": "Does not handle file uploads or downloads; expects attachment data or URLs already accessible. Not responsible for media transcoding or format conversion. Rendering varies by browser capability and media type support.", + "examples": [ + "Render an image attachment by URL with specific dimensions and alt text.", + "Render a base64 encoded audio clip with controls enabled and autoplay disabled.", + "Render a document attachment as a clickable embed or download link depending on type." + ] + }, + "tags": [ + "rendering", + "media", + "attachment", + "content-creation", + "embedding", + "image", + "video", + "audio", + "document" + ], + "examples": [ + { + "inputJson": "{\"attachmentUrl\":\"https://example.com/image.jpg\",\"attachmentType\":\"image\",\"altText\":\"Sample Image\",\"width\":600,\"height\":400}", + "description": "Render an image from a web URL with specified width, height, and alt text." + }, + { + "inputJson": "{\"base64Data\":\"data:audio/mp3;base64,//uQZAAA...\",\"attachmentType\":\"audio\",\"controls\":true,\"autoplay\":false}", + "description": "Render an audio attachment from base64 data with playback controls enabled but no autoplay." + }, + { + "inputJson": "{\"attachmentUrl\":\"https://example.com/doc.pdf\",\"attachmentType\":\"document\"}", + "description": "Render a document attachment as a downloadable link or embedded viewer based on type." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Attachment", + "context": null + } + }, + { + "name": "content-creation.renderVideo", + "description": "Generates a video file by rendering input assets such as images, video clips, text overlays, and audio tracks. It processes the inputs according to specified parameters like resolution, frame rate, and encoding format, producing a final video output file suitable for sharing or publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "sources", + "type": "array", + "description": "List of input media assets (images, video clips, audio, text overlays) with their sequence and timing details.", + "required": true, + "defaultValue": "" + }, + { + "name": "resolution", + "type": "string", + "description": "Output video resolution in WIDTHxHEIGHT format (e.g., 1920x1080).", + "required": true, + "defaultValue": "1920x1080" + }, + { + "name": "frameRate", + "type": "number", + "description": "Frame rate of the output video in frames per second (fps).", + "required": false, + "defaultValue": "30" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The container format of the output video file (e.g., mp4, mov, mkv).", + "required": true, + "defaultValue": "mp4" + }, + { + "name": "bitrate", + "type": "string", + "description": "Target video bitrate for encoding (e.g., 5M for 5 Mbps).", + "required": false, + "defaultValue": "5M" + }, + { + "name": "audioEnabled", + "type": "boolean", + "description": "Whether to include audio tracks in the output video.", + "required": false, + "defaultValue": "true" + }, + { + "name": "audioBitrate", + "type": "string", + "description": "Target audio bitrate for encoding (e.g., 192k).", + "required": false, + "defaultValue": "192k" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color code (hex or named) used when rendering images or text with transparency.", + "required": false, + "defaultValue": "black" + } + ], + "returns": { + "type": "object", + "description": "An object containing the path or URL to the rendered video file and metadata such as duration, resolution, and size." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a finalized video product from various multimedia inputs with specified output settings, such as creating promotional videos, tutorials, or social media content. It orchestrates rendering, encoding, and composition into a single shareable video file.", + "limitations": "This tool does not perform advanced video editing effects like 3D animations, real-time interactive content, or AI-driven content generation; it renders based on provided source assets and simple transformations.", + "examples": [ + "Create a 30-second promotional video compiling images and voiceover audio at 1080p resolution.", + "Generate a social media clip with text overlays and background music at 720p, 24 fps.", + "Render a recorded lecture video by combining video footage, presentation slides, and recorded audio into a single 1080p mp4 file." + ] + }, + "tags": [ + "video", + "rendering", + "content-creation", + "media", + "encoding", + "multimedia" + ], + "examples": [ + { + "inputJson": "{\"sources\":[{\"type\":\"image\",\"path\":\"/assets/image1.png\",\"duration\":5},{\"type\":\"video\",\"path\":\"/assets/clip1.mp4\",\"start\":0,\"end\":10},{\"type\":\"text\",\"content\":\"Welcome to our tutorial\",\"start\":0,\"end\":5,\"position\":\"bottom\"},{\"type\":\"audio\",\"path\":\"/assets/voiceover.mp3\",\"start\":0}],\"resolution\":\"1920x1080\",\"frameRate\":30,\"outputFormat\":\"mp4\",\"bitrate\":\"5M\",\"audioEnabled\":true,\"audioBitrate\":\"192k\",\"backgroundColor\":\"#FFFFFF\"}", + "description": "Render a 10-second video combining images, a video clip, text overlay, and voiceover audio into a 1080p mp4 file." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Video", + "context": null + } + }, + { + "name": "content-creation.renderDiagram", + "description": "Renders a visual diagram image from structured diagram data provided in JSON or Graphviz DOT format. Processes the input to generate a PNG or SVG output depicting flowcharts, UML diagrams, or network graphs according to the specified style and layout options.", + "category": "content-creation", + "parameters": [ + { + "name": "diagramData", + "type": "string", + "description": "The structured diagram input in JSON or Graphviz DOT format defining nodes, edges, and layout.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Output image format: 'png' or 'svg'.", + "required": false, + "defaultValue": "png" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "style", + "type": "object", + "description": "Optional styling options such as colors, fonts, and line styles.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered diagram image as a base64 encoded string and its MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate visual diagram representations from structured data inputs for documentation, presentations, or UI previews. It helps transform raw diagram specifications into graphical images in common formats.", + "limitations": "Does not support interactive or animated diagrams. Complex or very large diagrams may be rendered with simplified layouts. Input must be valid JSON or Graphviz DOT syntax; invalid inputs will cause errors.", + "examples": [ + "Render a flowchart diagram described in JSON to PNG for embedding in a report.", + "Generate an SVG UML class diagram from a Graphviz DOT format string.", + "Create a network graph image with custom colors and font styles from JSON input." + ] + }, + "tags": [ + "rendering", + "diagram", + "visualization", + "flowchart", + "uml", + "graph", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"diagramData\":\"{\\\"nodes\\\":[{\\\"id\\\":\\\"A\\\",\\\"label\\\":\\\"Start\\\"},{\\\"id\\\":\\\"B\\\",\\\"label\\\":\\\"End\\\"}],\\\"edges\\\":[{\\\"from\\\":\\\"A\\\",\\\"to\\\":\\\"B\\\"}]}\",\"format\":\"png\",\"width\":600,\"height\":400}", + "description": "Render a simple flowchart diagram from JSON to PNG image." + }, + { + "inputJson": "{\"diagramData\":\"digraph G { A -> B; B -> C; C -> A; }\",\"format\":\"svg\"}", + "description": "Generate a circular graph diagram in SVG format from Graphviz DOT input." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Diagram", + "context": null + } + }, + { + "name": "content-creation.renderFile", + "description": "Renders a multimedia or document file from an input source with optional transformations. Accepts file content as base64 string or URL, processes rendering options like format conversion, resizing, and optimization, and outputs the rendered file as a base64 encoded string or downloadable link.", + "category": "content-creation", + "parameters": [ + { + "name": "inputSource", + "type": "string", + "description": "Base64 encoded file content or URL of the source file to render", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output file format (e.g., png, jpeg, mp4, pdf)", + "required": false, + "defaultValue": "png" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Optional width to resize the output file in pixels (for images/video)", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Optional height to resize the output file in pixels (for images/video)", + "required": false, + "defaultValue": "" + }, + { + "name": "optimize", + "type": "boolean", + "description": "Whether to apply optimization/compression to reduce file size", + "required": false, + "defaultValue": "false" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color to apply when rendering images with transparency (hex code)", + "required": false, + "defaultValue": "#FFFFFF" + }, + { + "name": "outputType", + "type": "string", + "description": "Output type: 'base64' for encoded string, or 'downloadLink' for a URL to download the rendered file", + "required": false, + "defaultValue": "base64" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered file as a base64 string or a downloadable URL, along with metadata such as file size and format" + }, + "aiAgent": { + "useCase": "This tool is used when an agent needs to process and generate a specific file format from given input, optionally resizing or optimizing media files for better delivery or compatibility. It is suitable for preparing images, videos, or documents for display, download, or further processing.", + "limitations": "Does not support complex video editing or multi-page document rendering beyond format conversion and resizing. Large files may require asynchronous processing or external services.", + "examples": [ + "Render an input PNG image from a base64 string to a JPEG resized to 800x600 with optimization enabled.", + "Render a PDF document provided via URL to a base64 encoded PNG thumbnail image.", + "Convert an MP4 video URL to a smaller MP4 file with reduced resolution for mobile use." + ] + }, + "tags": [ + "rendering", + "file-processing", + "media", + "image", + "video", + "document", + "conversion", + "optimization" + ], + "examples": [ + { + "inputJson": "{\"inputSource\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA\",\"outputFormat\":\"jpeg\",\"resizeWidth\":800,\"resizeHeight\":600,\"optimize\":true,\"outputType\":\"base64\"}", + "description": "Convert a base64 encoded PNG image to optimized JPEG resized to 800x600." + }, + { + "inputJson": "{\"inputSource\":\"https://example.com/sample.pdf\",\"outputFormat\":\"png\",\"resizeWidth\":200,\"resizeHeight\":258,\"optimize\":false,\"outputType\":\"downloadLink\"}", + "description": "Render the first page of a PDF from URL to a PNG image with specified size, no optimization, returning a download link." + }, + { + "inputJson": "{\"inputSource\":\"https://example.com/video.mp4\",\"outputFormat\":\"mp4\",\"resizeWidth\":480,\"resizeHeight\":270,\"optimize\":true,\"outputType\":\"base64\"}", + "description": "Download and resize an MP4 video from a URL to 480x270 pixels with optimization, returning base64 encoded output." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "File", + "context": null + } + }, + { + "name": "content-creation.renderImage", + "description": "Renders a high-quality image based on specified parameters such as dimensions, background color, optional text with styling, and optional overlay graphics. Accepts structured input to produce a PNG or JPEG image output suitable for digital content creation and display.", + "category": "content-creation", + "parameters": [ + { + "name": "width", + "type": "number", + "description": "Width of the output image in pixels.", + "required": true, + "defaultValue": "" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output image in pixels.", + "required": true, + "defaultValue": "" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Background color of the image in hex or CSS color format (e.g., '#FFFFFF' or 'transparent').", + "required": false, + "defaultValue": "white" + }, + { + "name": "text", + "type": "string", + "description": "Optional text to render centered on the image.", + "required": false, + "defaultValue": "" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size in pixels for the optional text.", + "required": false, + "defaultValue": "24" + }, + { + "name": "fontColor", + "type": "string", + "description": "Font color for the text in hex or CSS color format.", + "required": false, + "defaultValue": "#000000" + }, + { + "name": "overlayImageUrl", + "type": "string", + "description": "Optional URL of an overlay image to place centered on top of the background.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output image format: 'png' or 'jpeg'.", + "required": false, + "defaultValue": "png" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a base64-encoded string of the rendered image and its MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create customized images for digital content, such as social media posts, banners, or placeholders. It is ideal when inputs specify image size, colors, text content, styling, and optional overlays, and quick generation of image data URI is required.", + "limitations": "This tool cannot generate complex graphic designs, detailed illustrations, or photos. It only supports basic rendering of plain backgrounds, centered text, and single overlay images with no advanced graphics manipulation.", + "examples": [ + "Generate a 800x600 banner image with a blue background and white centered text reading 'Welcome!'", + "Create a 400x400 transparent image with an overlay logo image URL in PNG format.", + "Render a 1080x1080 social media post with black text 'Sale 50%' in red font color on a yellow background as JPEG output." + ] + }, + "tags": [ + "image", + "render", + "content-creation", + "graphics", + "text", + "overlay", + "digital-media" + ], + "examples": [ + { + "inputJson": "{\"width\":800,\"height\":600,\"backgroundColor\":\"#0000FF\",\"text\":\"Welcome!\",\"fontSize\":48,\"fontColor\":\"#FFFFFF\",\"outputFormat\":\"png\"}", + "description": "Render a blue 800x600 image with white 'Welcome!' text centered." + }, + { + "inputJson": "{\"width\":400,\"height\":400,\"backgroundColor\":\"transparent\",\"overlayImageUrl\":\"https://example.com/logo.png\"}", + "description": "Render a 400x400 transparent image with a centered overlay image from URL." + }, + { + "inputJson": "{\"width\":1080,\"height\":1080,\"backgroundColor\":\"#FFFF00\",\"text\":\"Sale 50%\",\"fontSize\":64,\"fontColor\":\"#FF0000\",\"outputFormat\":\"jpeg\"}", + "description": "Create a 1080x1080 yellow background JPEG with red 'Sale 50%' text centered." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Image", + "context": null + } + }, + { + "name": "content-creation.renderBrief", + "description": "Generates a concise, structured brief document from provided textual inputs such as project goals, audience details, and key messages. Processes the input by organizing content into sections like overview, objectives, target audience, and deliverables, then outputs a formatted text brief suitable for stakeholder communication or project kickoff.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title or headline for the brief document.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectSummary", + "type": "string", + "description": "A short summary or background of the project to include in the brief.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "A list of specific objectives or goals the project aims to achieve.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or stakeholders for the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyMessages", + "type": "array", + "description": "Essential messages or points that should be conveyed in the brief.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "deliverables", + "type": "array", + "description": "List of expected deliverables or outputs associated with the project.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone for the brief text, e.g., formal, casual, persuasive.", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted brief text with sections such as title, overview, objectives, audience, key messages, and deliverables." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a clear, structured project brief from raw inputs describing goals, audience, and deliverables. It is useful for synthesizing scattered information into a professional summary for meetings, proposals, or documentation. It helps ensure all critical aspects of a project are captured in an organized way.", + "limitations": "Cannot generate detailed creative content or extensive reports beyond a concise summary. Does not include visual design or formatting beyond text arrangement. Requires clear input data to produce coherent output.", + "examples": [ + "Create a project brief with goals and audience for a new marketing campaign.", + "Generate a concise brief summarizing client requirements and deliverables for internal review.", + "Produce a formal brief outlining objectives and key messages for a technology rollout." + ] + }, + "tags": [ + "content-creation", + "brief", + "document", + "summary", + "project-management", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Marketing Campaign Brief\",\"projectSummary\":\"Launch of the new summer collection.\",\"objectives\":[\"Increase brand awareness\",\"Drive online sales\"],\"targetAudience\":\"Young adults aged 18-30 interested in fashion.\",\"keyMessages\":[\"Trendy and affordable\",\"Limited time offer\"],\"deliverables\":[\"Social media ads\",\"Email newsletter\"],\"tone\":\"formal\"}", + "description": "Generating a formal brief summarizing a marketing campaign's goals and target demographics." + }, + { + "inputJson": "{\"title\":\"Internal Project Kickoff\",\"projectSummary\":\"Development of the new mobile app.\",\"objectives\":[\"Complete MVP by Q3\",\"Ensure user-friendly interface\"],\"targetAudience\":\"Internal stakeholders and development team.\",\"keyMessages\":[],\"deliverables\":[\"Prototype\",\"Testing report\"],\"tone\":\"casual\"}", + "description": "Producing an internal brief to align team members on key project objectives and deliverables." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Brief", + "context": null + } + }, + { + "name": "content-creation.renderAudio", + "description": "Renders an audio file from given textual script and optional voice parameters. Accepts a text script or phonetic input, voice settings such as language, gender, and speed, then processes the input to synthesize and generate an audio file in the requested format (e.g., MP3, WAV). Outputs a downloadable audio file URL or binary data.", + "category": "content-creation", + "parameters": [ + { + "name": "script", + "type": "string", + "description": "The textual content or script to convert into speech audio.", + "required": true, + "defaultValue": "" + }, + { + "name": "voiceLanguage", + "type": "string", + "description": "Language code (e.g., 'en-US') specifying the language of the voice.", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "voiceGender", + "type": "string", + "description": "Preferred gender of the synthesized voice, e.g., 'male', 'female', or 'neutral'.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "speed", + "type": "number", + "description": "Speech speed rate; typical range 0.5 (slow) to 2.0 (fast).", + "required": false, + "defaultValue": "1.0" + }, + { + "name": "audioFormat", + "type": "string", + "description": "Output audio format such as 'mp3', 'wav', or 'ogg'.", + "required": false, + "defaultValue": "mp3" + }, + { + "name": "sampleRate", + "type": "number", + "description": "Sample rate of generated audio in Hz, e.g., 22050, 44100.", + "required": false, + "defaultValue": "44100" + }, + { + "name": "includeSilenceAtStartEnd", + "type": "boolean", + "description": "Whether to include short silence padding at beginning and end of audio for smoother playback.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the audio file URL or base64 encoded binary data, audio metadata such as duration and format." + }, + "aiAgent": { + "useCase": "Use this tool when generating speech audio from text for applications like podcasts, voiceovers, accessibility, or interactive voice response systems. It is ideal for converting any textual content into natural-sounding audio output with customizable voice parameters.", + "limitations": "Cannot generate audio from raw music notation or non-textual sound sources. Quality depends on underlying TTS engine; may not handle very long texts without segmentation. Does not support real-time audio streaming.", + "examples": [ + "Generate an English female voice MP3 file reading a short product description.", + "Create a slow male voice WAV file from a customer support script in Spanish.", + "Produce a neutral voice OGG audio for website accessibility announcements." + ] + }, + "tags": [ + "text-to-speech", + "audio-synthesis", + "content-creation", + "voice-generation", + "media", + "tts" + ], + "examples": [ + { + "inputJson": "{\"script\":\"Welcome to our website! We hope you enjoy your visit.\",\"voiceLanguage\":\"en-US\",\"voiceGender\":\"female\",\"speed\":1.0,\"audioFormat\":\"mp3\"}", + "description": "Generate a female US English voice speaking a welcome message as MP3." + }, + { + "inputJson": "{\"script\":\"Gracias por contactarnos. Su solicitud será atendida pronto.\",\"voiceLanguage\":\"es-ES\",\"voiceGender\":\"male\",\"speed\":0.9,\"audioFormat\":\"wav\"}", + "description": "Generate a male Spanish voice reading a customer service message slowly in WAV format." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Audio", + "context": null + } + }, + { + "name": "content-creation.renderDocument", + "description": "Generates a formatted document file from input content provided as text or structured data. Supports input in markdown or HTML and renders output as PDF, DOCX, or HTML file. Applies optional styling including templates and custom CSS. Produces a downloadable document with the rendered content-ready for sharing or printing.", + "category": "content-creation", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The main document content to render, can be in markdown or HTML format.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the input content; allowed values are 'markdown' or 'html'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output document format: 'pdf', 'docx', or 'html'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "title", + "type": "string", + "description": "Optional title to include in the rendered document's metadata or header.", + "required": false, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Optional author metadata to embed in the document.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "If true and output supports it, include a table of contents generated from headings.", + "required": false, + "defaultValue": "false" + }, + { + "name": "customCss", + "type": "string", + "description": "Optional custom CSS styles to apply when rendering HTML and PDF outputs.", + "required": false, + "defaultValue": "" + }, + { + "name": "templateName", + "type": "string", + "description": "Optional named template to apply for consistent styling and layout, if supported.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object with a base64-encoded string of the rendered document file and metadata." + }, + "aiAgent": { + "useCase": "Use this tool to convert raw text or structured content into polished, formatted document files in PDF, DOCX, or HTML formats, especially when styling and metadata are needed for professional sharing, printing, or archiving.", + "limitations": "Does not support complex interactive elements or embedded multimedia beyond what markdown/HTML can represent. Document templates must be predefined in the system; custom template uploading is not supported.", + "examples": [ + "Render a markdown blog post into a PDF with a title and author metadata.", + "Convert HTML-formatted content into a DOCX file with a custom CSS style applied.", + "Generate an HTML document including a table of contents from markdown input." + ] + }, + "tags": [ + "document", + "rendering", + "pdf", + "docx", + "html", + "content-creation", + "formatting", + "export" + ], + "examples": [ + { + "inputJson": "{\"content\":\"# Report\\nThis is the first section.\\n\\n## Subsection\\nDetails go here.\",\"inputFormat\":\"markdown\",\"outputFormat\":\"pdf\",\"title\":\"Monthly Report\",\"author\":\"Alice Smith\",\"includeTableOfContents\":true}", + "description": "Render markdown content with headings and a table of contents into a PDF document titled 'Monthly Report' authored by Alice Smith." + }, + { + "inputJson": "{\"content\":\"Project Plan
Outline of project milestones.
\",\"inputFormat\":\"html\",\"outputFormat\":\"docx\",\"title\":\"Project Plan\",\"author\":\"Bob Lee\",\"customCss\":\"body { font-family: Arial; }\"}", + "description": "Convert simple HTML content to a DOCX file with custom font styling and metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Document", + "context": null + } + }, + { + "name": "content-creation.renderReport", + "description": "Generates a formatted report document based on provided data and templates. Accepts raw data inputs and optional style or layout configurations, processes this information by populating templates, and outputs a structured report in PDF, HTML, or TXT format suitable for presentations, archives, or sharing.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "object", + "description": "The raw input data to be included and visualized in the report, such as statistics, tables, or content sections.", + "required": true, + "defaultValue": "" + }, + { + "name": "template", + "type": "string", + "description": "Identifier or content of the report template defining the layout and formatting to apply when rendering the report.", + "required": false, + "defaultValue": "default" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired format of the output report document. Supported formats include 'PDF', 'HTML', and 'TXT'.", + "required": false, + "defaultValue": "PDF" + }, + { + "name": "title", + "type": "string", + "description": "Optional title to use for the report's main header or cover page.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Determines whether to automatically generate and include a table of contents based on sections in the report data.", + "required": false, + "defaultValue": "true" + }, + { + "name": "author", + "type": "string", + "description": "Optional author name to display in the report metadata or footer section.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered report as a base64-encoded string along with metadata such as MIME type, file extension, and summary information." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a professional, structured report document from raw data or analytical content, enabling formatted output in common document file types for sharing, archiving, or presentation. Ideal for automating report generation pipelines or enhancing content creation workflows.", + "limitations": "Cannot generate interactive or dynamic reports beyond the specified static formats; complex visualizations require pre-processing before input; relies on existing template definitions or simple default layouts.", + "examples": [ + "Generate a quarterly sales report in PDF with a table of contents and custom title.", + "Create a simple report in HTML from given statistics data without author information.", + "Produce a plain text report summarizing input content using the default template." + ] + }, + "tags": [ + "content creation", + "document generation", + "reporting", + "rendering", + "PDF", + "HTML", + "TXT", + "automation" + ], + "examples": [ + { + "inputJson": "{\"data\":{\"summary\":\"Sales increased by 15% compared to last quarter.\",\"sections\":[{\"title\":\"Overview\",\"content\":\"Overall sales growth was strong.\"},{\"title\":\"Details\",\"content\":\"Top products: A, B, and C.\"}]},\"template\":\"modern\",\"outputFormat\":\"PDF\",\"title\":\"Quarterly Sales Report\",\"includeTableOfContents\":true,\"author\":\"Jane Doe\"}", + "description": "Generate a PDF quarterly sales report with a table of contents, using 'modern' template and specified author." + }, + { + "inputJson": "{\"data\":{\"summary\":\"Monthly website traffic summary.\",\"sections\":[{\"title\":\"Traffic Overview\",\"content\":\"Visits increased by 10%.\"},{\"title\":\"Source Breakdown\",\"content\":\"Majority from organic search.\"}]},\"outputFormat\":\"HTML\",\"includeTableOfContents\":false}", + "description": "Create an HTML report summarizing monthly website traffic without table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.renderSummary", + "description": "This tool accepts a textual document or multiple documents as input and generates a coherent, concise summary capturing the main points. It processes the input text using natural language understanding and summarization techniques and outputs a brief text summary that aids quick comprehension of the content.", + "category": "content-creation", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The main textual content to be summarized. This can be a document, article, or any text input.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Desired approximate length of the summary in number of sentences. Defaults to 3.", + "required": false, + "defaultValue": "3" + }, + { + "name": "language", + "type": "string", + "description": "The language of the input text and summary output, e.g., 'en' for English. Defaults to 'en'.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeHighlights", + "type": "boolean", + "description": "If true, the summary will include key highlighted phrases for emphasis. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and optional highlights if requested." + }, + "aiAgent": { + "useCase": "Use this tool when a concise summary of longer textual content is needed to enable faster understanding or decision-making. It is suitable for digesting articles, reports, emails, or multiple documents, especially when screening large volumes of text.", + "limitations": "This tool cannot interpret non-textual data (images, tables). The summary quality depends on input clarity and may omit nuanced details. It is not a substitute for full comprehensive reading.", + "examples": [ + "Summarize this 1000-word article into 3 sentences.", + "Generate a brief summary highlighting key points from this product manual.", + "Produce an English summary of this French document using about 5 sentences." + ] + }, + "tags": [ + "content-creation", + "summary", + "text-processing", + "natural-language", + "document", + "readability" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"The quarterly financial report indicates a steady increase in revenue across all sectors, particularly in e-commerce and cloud services. Expenses remained stable, with notable investments in research and development helping fuel innovation. Market analysts expect continued growth in the next fiscal quarter as new products are launched.\",\"summaryLength\":3,\"language\":\"en\",\"includeHighlights\":true}", + "description": "Summarizes a business report highlighting revenue growth and investments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "render", + "object": "Summary", + "context": null + } + }, + { + "name": "content-creation.formatReference", + "description": "Formats a bibliographic reference provided as structured data or plain text into a specified citation style (e.g., APA, MLA, Chicago). Accepts input as an object containing reference fields or raw reference string, processes the input according to the style rules, and outputs a properly formatted citation string.", + "category": "content-creation", + "parameters": [ + { + "name": "referenceData", + "type": "object", + "description": "Structured object representing bibliographic reference details such as author, title, year, publisher, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "referenceString", + "type": "string", + "description": "Raw reference text input to be formatted; used if structured data is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The citation style format to apply (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + }, + { + "name": "includeDOI", + "type": "boolean", + "description": "Whether to include the DOI or URL in the formatted reference when available.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code for localized formatting rules (e.g., 'en', 'fr').", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted reference string and metadata about the formatting." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert bibliographic reference data or strings into a specific citation style for inclusion in academic, professional, or publishing contexts. It automates consistent formatting to save time and reduce errors.", + "limitations": "Does not perform fuzzy parsing or extraction from unstructured source documents; input must be clean and complete. Limited to style guidelines supported in the implementation; complex corner cases of citation standards may not be fully handled.", + "examples": [ + "Format a book reference from structured data into MLA style.", + "Convert a raw reference string to APA formatted citation.", + "Include DOI information automatically if available in the reference object." + ] + }, + "tags": [ + "citation", + "bibliography", + "formatting", + "reference", + "academic", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"referenceData\":{\"author\":\"Jane Doe\",\"title\":\"Understanding AI\",\"year\":2021,\"publisher\":\"TechPress\"},\"citationStyle\":\"APA\",\"includeDOI\":false}", + "description": "Format a book reference from structured data into APA style without a DOI." + }, + { + "inputJson": "{\"referenceString\":\"Doe, J. (2021). Understanding AI. TechPress.\",\"citationStyle\":\"MLA\"}", + "description": "Format a raw reference string into MLA citation style." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Reference", + "context": null + } + }, + { + "name": "content-creation.formatCitation", + "description": "Formats bibliographic citation data into a specified citation style such as APA, MLA, or Chicago. It accepts structured citation details including author names, publication title, date, and other relevant fields, then outputs a properly formatted citation string ready for use in academic or professional documents.", + "category": "content-creation", + "parameters": [ + { + "name": "citationData", + "type": "object", + "description": "Structured object containing citation details such as authors, title, publisher, year, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Target citation style (e.g., 'APA', 'MLA', 'Chicago'). Determines formatting rules applied.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeDOI", + "type": "boolean", + "description": "Whether to include the DOI in the formatted citation if available in citationData.", + "required": false, + "defaultValue": "true" + }, + { + "name": "capitalizeTitle", + "type": "boolean", + "description": "Whether to apply title case capitalization to the title field as per style guidelines.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single 'formattedCitation' string field, which has the citation formatted according to the specified style." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to generate correctly formatted bibliographic citations from raw citation data for academic, publishing, or professional content creation tasks. It helps automate citation formatting to comply with style guides, reducing manual effort and errors.", + "limitations": "This tool cannot verify the correctness or completeness of citation data provided. It only formats given data according to style rules; it does not fetch missing citation metadata or validate sources.", + "examples": [ + "Format a citation in APA style for a journal article", + "Generate an MLA style citation including DOI for a book", + "Create a Chicago style citation with title capitalization for a conference paper" + ] + }, + "tags": [ + "citation", + "formatting", + "bibliography", + "academic", + "style-guide", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"citationData\":{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Exploring the Cosmos\",\"year\":2021,\"journal\":\"Astrophysics Today\",\"volume\":42,\"issue\":7,\"pages\":\"100-120\",\"doi\":\"10.1234/astro.2021.007\"},\"style\":\"APA\",\"includeDOI\":true,\"capitalizeTitle\":true}", + "description": "Format a journal article citation in APA style including DOI" + }, + { + "inputJson": "{\"citationData\":{\"authors\":[\"Brown, Alice\"],\"title\":\"History of Art\",\"publisher\":\"ArtPress\",\"year\":2018,\"location\":\"New York\"},\"style\":\"MLA\",\"includeDOI\":false,\"capitalizeTitle\":false}", + "description": "Format a book citation in MLA style without including DOI and without title capitalization" + }, + { + "inputJson": "{\"citationData\":{\"authors\":[\"Lee, Kevin\"],\"title\":\"Advances in Robotics\",\"conference\":\"International Robotics Conference\",\"year\":2023,\"pages\":\"50-60\"},\"style\":\"Chicago\",\"includeDOI\":false,\"capitalizeTitle\":true}", + "description": "Format a conference paper citation in Chicago style with title capitalization" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.formatQuote", + "description": "Formats a given quote text with optional attributes such as author name, source, citation style, and desired text formatting (e.g., bold, italic). Accepts raw quote and metadata, processes formatting rules, and outputs the quote as a styled string suitable for display or publication.", + "category": "content-creation", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The main textual content of the quote to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the author of the quote, if known, to include as attribution.", + "required": false, + "defaultValue": "" + }, + { + "name": "source", + "type": "string", + "description": "Source of the quote, such as book, speech, or article title, for citation purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style for formatting the source reference (e.g., APA, MLA, Chicago).", + "required": false, + "defaultValue": "APA" + }, + { + "name": "textFormatting", + "type": "array", + "description": "Array of text formatting options to apply to the quote, e.g., ['bold', 'italic'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeQuotationMarks", + "type": "boolean", + "description": "Whether to surround the quote text with quotation marks.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format of the formatted quote: plain text, HTML, or markdown.", + "required": false, + "defaultValue": "plain" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted quote string under 'formattedQuote' key and metadata fields for author and source if provided." + }, + "aiAgent": { + "useCase": "Use this tool when you need to present quotes in a consistent, styled manner including author and source attribution, formatted according to citation standards and output format preferences. Ideal for article drafting, content publishing, and educational material generation.", + "limitations": "This tool formats quotes only and does not perform quote extraction, verification, or fact-checking. It cannot generate citations beyond formatting author and source strings provided.", + "examples": [ + "Format a quote with author and source using APA style in markdown.", + "Generate a bolded, italicized quote text with quotation marks included.", + "Produce plain text quote output without any author attribution." + ] + }, + "tags": [ + "content-creation", + "formatting", + "quotes", + "text-styling", + "citation", + "publishing" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"To be, or not to be, that is the question.\",\"authorName\":\"William Shakespeare\",\"source\":\"Hamlet\",\"citationStyle\":\"MLA\",\"textFormatting\":[\"italic\"],\"includeQuotationMarks\":true,\"outputFormat\":\"markdown\"}", + "description": "Format a Shakespeare quote in MLA style with italic text and quotation marks in markdown output." + }, + { + "inputJson": "{\"quoteText\":\"Life is what happens when you're busy making other plans.\",\"authorName\":\"John Lennon\",\"includeQuotationMarks\":false,\"outputFormat\":\"plain\"}", + "description": "Format a plain text quote from John Lennon without quotation marks or source." + }, + { + "inputJson": "{\"quoteText\":\"Imagination is more important than knowledge.\",\"textFormatting\":[\"bold\"],\"outputFormat\":\"html\"}", + "description": "Format a quote with bold text and HTML output, no author or source included." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Quote", + "context": null + } + }, + { + "name": "content-creation.formatLink", + "description": "Formats a given URL string into various hyperlink styles suitable for digital content, such as Markdown, HTML anchor tags, and plain text with optional display text. Accepts raw URLs and optional parameters for display text and format type; outputs the correctly formatted link string.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The raw URL string to be formatted into a hyperlink.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "Optional text to display instead of the raw URL. If empty, the URL itself is used as the display text.", + "required": false, + "defaultValue": "" + }, + { + "name": "formatType", + "type": "string", + "description": "The desired output format of the link: markdown, html, or plainText.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "For HTML format, whether to include target='_blank' attribute to open the link in a new browser tab.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted link as a string under 'formattedLink' property." + }, + "aiAgent": { + "useCase": "Use when needing to convert raw URLs into properly formatted hyperlink strings for various content formats, enhancing readability and usability of links in generated digital content such as markdown documents, HTML pages, or plain text contexts.", + "limitations": "Does not validate the URL's reachability or safety; does not generate QR codes or link previews; limited to formatting links only, no URL shortening or metadata fetching.", + "examples": [ + "Format a raw URL as a Markdown link with display text", + "Generate an HTML anchor tag that opens the link in a new tab", + "Output a plain text string showing the URL with display text" + ] + }, + "tags": [ + "formatting", + "link", + "url", + "content-creation", + "markdown", + "html" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"displayText\":\"Example Site\",\"formatType\":\"markdown\"}", + "description": "Format a URL into a markdown link with custom display text." + }, + { + "inputJson": "{\"url\":\"https://example.com\",\"displayText\":\"Visit Example\",\"formatType\":\"html\",\"openInNewTab\":true}", + "description": "Format a URL into an HTML anchor tag that opens in a new tab." + }, + { + "inputJson": "{\"url\":\"https://example.com\",\"displayText\":\"\",\"formatType\":\"plainText\"}", + "description": "Show the URL as plain text with no display text specified, defaults to the URL itself." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.formatSentence", + "description": "This tool takes a raw sentence as input and formats it according to specified stylistic and grammatical rules, such as capitalization style, punctuation adjustment, and trimming whitespace. It produces a clean, properly formatted sentence output suitable for polished content creation.", + "category": "content-creation", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The raw sentence text to format. Required for processing.", + "required": true, + "defaultValue": "" + }, + { + "name": "capitalizeStyle", + "type": "string", + "description": "Defines capitalization style: 'none', 'sentenceCase', 'titleCase', or 'uppercase'.", + "required": false, + "defaultValue": "sentenceCase" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to trim leading and trailing whitespace from the sentence.", + "required": false, + "defaultValue": "true" + }, + { + "name": "ensureEndingPunctuation", + "type": "boolean", + "description": "Ensures the sentence ends with appropriate punctuation (., !, ?).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted sentence string." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw sentence text that needs consistent formatting such as adjusting capitalization styles, cleaning up whitespace, and ensuring proper sentence-ending punctuation. It is ideal when preparing text content for presentation, publishing, or readability enhancement.", + "limitations": "This tool does not perform semantic corrections or grammar checking beyond basic punctuation and capitalization. It also does not translate or paraphrase content.", + "examples": [ + "Format a user input sentence to title case with proper punctuation.", + "Clean up a sentence with excessive whitespace and inconsistent capitalization.", + "Ensure a given sentence ends with a punctuation mark and is trimmed for whitespace." + ] + }, + "tags": [ + "formatting", + "text", + "content-creation", + "sentence", + "capitalization", + "punctuation", + "whitespace" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\" this is a test sentence\",\"capitalizeStyle\":\"sentenceCase\",\"trimWhitespace\":true,\"ensureEndingPunctuation\":true}", + "description": "Formats a sentence with sentence case capitalization, trims whitespace, and ensures ending punctuation." + }, + { + "inputJson": "{\"sentence\":\"welcome to the jungle\",\"capitalizeStyle\":\"titleCase\",\"trimWhitespace\":false,\"ensureEndingPunctuation\":true}", + "description": "Formats input sentence to title case and ensures it ends with punctuation but does not trim whitespace." + }, + { + "inputJson": "{\"sentence\":\"HELLO WORLD!\",\"capitalizeStyle\":\"none\",\"trimWhitespace\":true,\"ensureEndingPunctuation\":false}", + "description": "Keeps original capitalization, trims whitespace, and does not alter ending punctuation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.formatHeading", + "description": "Formats a given text string as a heading with specified level and style. Accepts plain text input and returns a string formatted as a heading in Markdown, HTML, or plain text with optional capitalization and prefix symbols.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text content of the heading to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "The heading level (e.g., 1 for top-level heading, up to 6).", + "required": false, + "defaultValue": "1" + }, + { + "name": "format", + "type": "string", + "description": "The output format: 'markdown', 'html', or 'plain'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "capitalize", + "type": "boolean", + "description": "Whether to capitalize the heading text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "prefixSymbol", + "type": "string", + "description": "Optional symbol prefix for plain text format headings (e.g., '*', '-', '#'). Ignored in markdown and html formats.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted heading string under the key 'formattedHeading'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate headings in consistent, customizable formats for documents, web pages, or markdown files. It simplifies heading level styling and format conversion for content creation workflows.", + "limitations": "Cannot interpret or parse existing formatted headings; only formats plain text input as a heading. Does not support advanced styling such as colors or fonts.", + "examples": [ + "Format heading text 'Project Overview' as a Markdown h2 heading.", + "Generate an HTML h3 heading from text 'Introduction' with capitalization.", + "Create a plain text heading with a '#' prefix symbol for level 1." + ] + }, + "tags": [ + "content", + "formatting", + "heading", + "markdown", + "html", + "text", + "capitalization" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Project Overview\",\"level\":2,\"format\":\"markdown\"}", + "description": "Formats 'Project Overview' as a level 2 Markdown heading." + }, + { + "inputJson": "{\"text\":\"Introduction\",\"level\":3,\"format\":\"html\",\"capitalize\":true}", + "description": "Formats 'Introduction' as an HTML h3 heading with capitalization." + }, + { + "inputJson": "{\"text\":\"Summary\",\"level\":1,\"format\":\"plain\",\"prefixSymbol\":\"#\"}", + "description": "Formats 'Summary' as a plain text level 1 heading with # prefix symbol." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.formatText", + "description": "Formats input text according to specified styling options such as line width, indentation, text case, and bullet list style. Accepts raw string input and outputs a formatted string that adheres to the given parameters, improving readability and consistency for digital content.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw input text to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum number of characters per line; text will be wrapped accordingly.", + "required": false, + "defaultValue": "80" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to indent each line of the formatted text.", + "required": false, + "defaultValue": "0" + }, + { + "name": "textCase", + "type": "string", + "description": "Defines the case transformation to apply: 'none', 'uppercase', 'lowercase', or 'capitalize'.", + "required": false, + "defaultValue": "none" + }, + { + "name": "bulletStyle", + "type": "string", + "description": "Style of bullet points to apply if text represents a list; options include '*', '-', '+', or none for no bullets.", + "required": false, + "defaultValue": "*" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "If true, leading/trailing whitespace is trimmed from each line.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object with a single 'formattedText' property containing the fully formatted string output." + }, + "aiAgent": { + "useCase": "Use this tool when needing to consistently format raw textual content for improved readability, such as preparing paragraphs for display, creating bullet lists, setting indentation levels for code or prose, or converting text case for uniformity in content creation workflows.", + "limitations": "This tool does not perform semantic text corrections, grammar checking, or complex markdown transformations beyond basic bullet styling and case conversion.", + "examples": [ + "Format a paragraph to 60 characters wide with indentation of 4 spaces.", + "Convert input text to uppercase with no indentation, wrapping lines at 70 characters.", + "Create a bulleted list from input text lines using '+' as bullet character." + ] + }, + "tags": [ + "formatting", + "text-processing", + "content-creation", + "text-style", + "wrapping", + "indentation", + "case-conversion", + "bullets" + ], + "examples": [ + { + "inputJson": "{\"text\":\"This is an example paragraph of text that will be formatted by wrapping lines and indenting.\",\"lineWidth\":50,\"indentation\":2,\"textCase\":\"none\",\"bulletStyle\":\"none\",\"trimWhitespace\":true}", + "description": "Format paragraph with line width 50 and indent 2 spaces." + }, + { + "inputJson": "{\"text\":\"hello world! this should be uppercase.\",\"textCase\":\"uppercase\"}", + "description": "Convert text to uppercase with default formatting." + }, + { + "inputJson": "{\"text\":\"Item one\\nItem two\\nItem three\",\"bulletStyle\":\"-\",\"indentation\":4}", + "description": "Format a bulleted list with '-' bullets and indentation of 4 spaces." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.formatParagraph", + "description": "Formats a given paragraph of text according to specified style rules including alignment, indentation, line spacing, and font attributes. Accepts raw paragraph text and formatting options, processes these options, and outputs the formatted paragraph as a styled string or markup object.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw paragraph text to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "alignment", + "type": "string", + "description": "Paragraph alignment style: 'left', 'right', 'center', or 'justify'.", + "required": false, + "defaultValue": "left" + }, + { + "name": "lineSpacing", + "type": "number", + "description": "Line spacing multiplier for the paragraph (e.g., 1.0 for single-spaced, 1.5 for one-and-a-half).", + "required": false, + "defaultValue": "1.0" + }, + { + "name": "indentation", + "type": "number", + "description": "Indentation in spaces or pixels for the first line of the paragraph.", + "required": false, + "defaultValue": "0" + }, + { + "name": "fontName", + "type": "string", + "description": "Font family name to apply to the paragraph text (e.g., 'Arial', 'Times New Roman').", + "required": false, + "defaultValue": "" + }, + { + "name": "fontSize", + "type": "number", + "description": "Font size in points to use for the paragraph text.", + "required": false, + "defaultValue": "12" + }, + { + "name": "bold", + "type": "boolean", + "description": "Whether to make the paragraph text bold.", + "required": false, + "defaultValue": "false" + }, + { + "name": "italic", + "type": "boolean", + "description": "Whether to make the paragraph text italicized.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted paragraph as a styled HTML string or markup representation, including applied formatting properties." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically apply consistent paragraph formatting to text content for documents, reports, or UI displays. It standardizes text alignment, spacing, indentation, and font styling for improved readability and presentation. This is useful in content generation, document automation, or formatting user input.", + "limitations": "This tool does not perform grammar, spelling, or semantic editing; it only applies visual text formatting. It outputs markup or styled text but does not generate visual previews or handle multiple paragraphs at once.", + "examples": [ + "Format a paragraph with justified alignment, 1.5 line spacing, and indent the first line by 4 spaces.", + "Render text in bold italic Arial font, size 14, aligned center.", + "Apply single spacing and left alignment with no indentation to a blockquote paragraph." + ] + }, + "tags": [ + "formatting", + "text", + "paragraph", + "style", + "content-creation", + "typography" + ], + "examples": [ + { + "inputJson": "{\"text\":\"This is a sample paragraph.\",\"alignment\":\"justify\",\"lineSpacing\":1.5,\"indentation\":4,\"fontName\":\"Times New Roman\",\"fontSize\":12,\"bold\":false,\"italic\":false}", + "description": "Format text with justified alignment, 1.5 line spacing, 4 space indentation, Times New Roman 12pt font." + }, + { + "inputJson": "{\"text\":\"Important note.\",\"alignment\":\"center\",\"lineSpacing\":1.0,\"indentation\":0,\"fontName\":\"Arial\",\"fontSize\":14,\"bold\":true,\"italic\":true}", + "description": "Center aligned, bold italic Arial font, size 14 text with no indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.formatWord", + "description": "Formats a single word according to the specified style and locale settings. Accepts a word string as input and applies formatting options such as capitalization style, case conversion, and locale-specific transformations, outputting the formatted word as a string.", + "category": "content-creation", + "parameters": [ + { + "name": "word", + "type": "string", + "description": "The input word to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "The formatting style to apply: 'uppercase', 'lowercase', 'capitalize', or 'titleCase'", + "required": false, + "defaultValue": "capitalize" + }, + { + "name": "locale", + "type": "string", + "description": "Optional BCP 47 language tag for locale-specific formatting rules (e.g., 'en-US', 'tr-TR')", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted word as a string under the key 'formattedWord'" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to apply consistent capitalization or locale-sensitive formatting to single words within larger text processing workflows, such as generating user-facing content or normalizing inputs.", + "limitations": "Does not handle multi-word phrases or complex linguistic transformations such as stemming or translation. Limited to simple case and capitalization formatting for single words.", + "examples": [ + "Format the word 'example' to uppercase.", + "Capitalize the word 'straße' using German locale.", + "Convert the word 'iPhone' to title case." + ] + }, + "tags": [ + "formatting", + "content-creation", + "word", + "text-processing", + "capitalization", + "locale" + ], + "examples": [ + { + "inputJson": "{\"word\":\"example\",\"formatStyle\":\"uppercase\",\"locale\":\"\"}", + "description": "Convert the word 'example' to uppercase." + }, + { + "inputJson": "{\"word\":\"straße\",\"formatStyle\":\"capitalize\",\"locale\":\"de-DE\"}", + "description": "Capitalize German word 'straße' with locale-aware formatting." + }, + { + "inputJson": "{\"word\":\"iPhone\",\"formatStyle\":\"titleCase\",\"locale\":\"en-US\"}", + "description": "Apply title case formatting to the word 'iPhone'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.formatYAML", + "description": "This tool accepts a YAML string input and reformats it for improved readability and consistency, applying proper indentation, spacing, and optional styling preferences. It outputs a well-formatted YAML string that adheres to best practices, suitable for configuration files, documentation, or data exchange.", + "category": "content-creation", + "parameters": [ + { + "name": "yamlInput", + "type": "string", + "description": "The raw YAML string to be formatted. Must be valid YAML syntax.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for each indentation level. Typical is 2 or 4.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "Whether to sort mapping keys alphabetically for consistency.", + "required": false, + "defaultValue": "false" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line length before wrapping. Use 0 for no wrapping.", + "required": false, + "defaultValue": "80" + }, + { + "name": "useBlockStyle", + "type": "boolean", + "description": "Use block style for multiline strings instead of folded style.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted YAML string or error details if formatting failed. Contains 'formattedYAML' string and 'error' string if any." + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize or beautify YAML content for readability, sharing, or version control. It's helpful for developers or systems exchanging YAML config files to ensure consistent formatting and style.", + "limitations": "This tool cannot validate or fix semantic errors in YAML content beyond syntactic correctness. It does not transform or interpret the data, only refactors formatting. Invalid YAML input will cause an error output.", + "examples": [ + "Format raw YAML input with default indentation and styles.", + "Format YAML content with 4 spaces indentation and sorted keys.", + "Format YAML without line wrapping and using folded style for multiline strings." + ] + }, + "tags": [ + "formatting", + "YAML", + "content-creation", + "code-formatting", + "configuration", + "serialization" + ], + "examples": [ + { + "inputJson": "{\"yamlInput\":\"name:Test\\nage:30\\naddress:\\n city:New York\\n zip:10001\\n hobbies:\\n- reading\\n- hiking\",\"indentationSpaces\":2,\"sortKeys\":true,\"lineWidth\":80,\"useBlockStyle\":true}", + "description": "Format a YAML string with 2 spaces indentation and keys sorted alphabetically." + }, + { + "inputJson": "{\"yamlInput\":\"user:\\n name: Alice\\n occupation: Developer\\nnotes: |\\n Likes coding and reading\\n Enjoys hiking on weekends\",\"indentationSpaces\":4,\"sortKeys\":false,\"lineWidth\":0,\"useBlockStyle\":true}", + "description": "Format YAML with 4 spaces indentation, no line wrapping, and block style for multiline strings." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "YAML", + "context": null + } + }, + { + "name": "content-creation.formatMarkdown", + "description": "Formats raw text inputs into structured Markdown output. Accepts plain text or lightly structured content, applies specified Markdown formatting styles such as headings, lists, bold, italics, and code blocks, and returns well-formed Markdown text ready for rendering or saving.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw input text to be formatted into Markdown.", + "required": true, + "defaultValue": "" + }, + { + "name": "applyHeadings", + "type": "boolean", + "description": "Determines whether to detect and apply heading levels (e.g., #, ##) based on input markers or line patterns.", + "required": false, + "defaultValue": "true" + }, + { + "name": "convertLists", + "type": "boolean", + "description": "Whether to identify and format bullet or numbered lists from plain lines starting with list markers.", + "required": false, + "defaultValue": "true" + }, + { + "name": "emphasizeText", + "type": "boolean", + "description": "Apply bold or italic formatting to text between specific delimiters (e.g., * or _).", + "required": false, + "defaultValue": "true" + }, + { + "name": "codeBlockStyle", + "type": "string", + "description": "Type of code block to use for formatted code segments (e.g., fenced triple backticks or indented).", + "required": false, + "defaultValue": "fenced" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line width for wrapping paragraphs to improve readability in raw Markdown.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted Markdown text string under 'markdown' key." + }, + "aiAgent": { + "useCase": "Use this tool when the input is unstructured or loosely formatted text that needs to be transformed into clean, standardized Markdown suitable for documentation, blogs, or notes. It helps automate consistent formatting to Markdown syntax to improve readability and enable further processing or rendering.", + "limitations": "Cannot fully interpret complex document structures or semantic meaning beyond basic formatting rules. Not a Markdown linter or style enforcer, nor does it generate Markdown from non-text content like images or tables unless expressed in text form.", + "examples": [ + "Format plain notes into Markdown headings and lists.", + "Convert text with inline bold and italic markers into proper Markdown syntax.", + "Wrap paragraphs to specified line width and format fenced code blocks for code snippets." + ] + }, + "tags": [ + "markdown", + "formatting", + "content-creation", + "text-processing", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Meeting Notes\\nDiscuss project timeline\\n* Task 1\\n* Task 2\\nUse *emphasis* and **strong** text.\",\"applyHeadings\":true,\"convertLists\":true,\"emphasizeText\":true,\"codeBlockStyle\":\"fenced\",\"lineWidth\":80}", + "description": "Formats meeting notes with headings, bullet lists, and emphasis into Markdown." + }, + { + "inputJson": "{\"text\":\"Sample code:\\nfunction greet() {\\n console.log(\\\"Hello World\\\");\\n}\",\"applyHeadings\":false,\"convertLists\":false,\"emphasizeText\":false,\"codeBlockStyle\":\"fenced\",\"lineWidth\":80}", + "description": "Formats a code snippet with fenced code blocks and no other Markdown formatting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Markdown", + "context": null + } + }, + { + "name": "content-creation.formatTable", + "description": "Formats tabular data according to specified styling options. Accepts input as an array of objects or arrays representing rows, applies formatting such as column alignment, borders, header styles, and outputs the table as a formatted string in Markdown, HTML, or plain text.", + "category": "content-creation", + "parameters": [ + { + "name": "tableData", + "type": "array", + "description": "The tabular data to format; each element is a row represented as an array or object. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the table. Options: 'markdown', 'html', or 'plain'. Defaults to 'markdown'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "alignments", + "type": "array", + "description": "Array specifying column alignments: each element is 'left', 'center', or 'right'. Defaults to all 'left'.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Indicates if the first row is a header row to be formatted differently. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "borderStyle", + "type": "string", + "description": "Style of border for plain text tables: 'none', 'ascii', or 'unicode'. Defaults to 'ascii'. Ignored for HTML/Markdown.", + "required": false, + "defaultValue": "ascii" + }, + { + "name": "headerStyle", + "type": "string", + "description": "Style of header formatting: 'bold', 'underline', or 'none'. Defaults to 'bold'.", + "required": false, + "defaultValue": "bold" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing 'formattedTable', a string of the formatted table in the requested format." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate visually well-structured tables from raw tabular data within document generation, reporting, or UI presentation contexts. It supports transforming arrays or objects into formatted tables with customizable alignment and style in common output formats, facilitating readable content generation.", + "limitations": "Does not parse or validate complex nested data types; assumes uniform row structure. Not intended for large data processing or interactive table features.", + "examples": [ + "Format a small dataset as a Markdown table with centered columns.", + "Create an HTML table from array-of-objects with bold headers.", + "Generate a plain text table using Unicode borders with right-aligned numeric columns." + ] + }, + "tags": [ + "content-creation", + "table", + "formatting", + "markdown", + "html", + "plain-text", + "data-display" + ], + "examples": [ + { + "inputJson": "{\"tableData\":[{\"Name\":\"Alice\",\"Age\":30,\"City\":\"New York\"},{\"Name\":\"Bob\",\"Age\":25,\"City\":\"Los Angeles\"}],\"outputFormat\":\"markdown\",\"alignments\":[\"left\",\"center\",\"right\"],\"includeHeader\":true,\"borderStyle\":\"\",\"headerStyle\":\"bold\"}", + "description": "Format an array of objects as a Markdown table with left, center, and right alignments respectively." + }, + { + "inputJson": "{\"tableData\":[[\"Product\",\"Price\",\"Stock\"],[\"Pen\",1.2,100],[\"Notebook\",2.5,200]],\"outputFormat\":\"html\",\"alignments\":[\"left\",\"right\",\"center\"],\"includeHeader\":true,\"borderStyle\":\"\",\"headerStyle\":\"underline\"}", + "description": "Format a 2D array table with header underline style as an HTML table." + }, + { + "inputJson": "{\"tableData\":[[\"ID\",\"Score\"],[\"1\",88],[\"2\",92]],\"outputFormat\":\"plain\",\"alignments\":[\"left\",\"right\"],\"includeHeader\":true,\"borderStyle\":\"unicode\",\"headerStyle\":\"bold\"}", + "description": "Generate a plain text table with Unicode borders and bold headers, right-aligning the Score column." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Table", + "context": null + } + }, + { + "name": "content-creation.formatHTML", + "description": "Formats a given HTML string by properly indenting nested tags, optionally minifying or prettifying the HTML output. Accepts raw or poorly formatted HTML and produces clean, readable or compact HTML code according to parameters.", + "category": "content-creation", + "parameters": [ + { + "name": "html", + "type": "string", + "description": "Raw or unformatted HTML string input that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use per indentation level for pretty printing.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "If true, indentation uses tabs instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "minify", + "type": "boolean", + "description": "If true, removes unnecessary whitespace and line breaks to produce compact HTML.", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveNewLines", + "type": "boolean", + "description": "If true, preserves meaningful new lines inside pre or code tags when formatting.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted HTML string as 'formattedHtml'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to clean up raw or badly formatted HTML code, for example when ingesting user-generated or legacy HTML content, before further editing, displaying, or processing. It helps generate consistent and readable or compact HTML according to user preferences.", + "limitations": "Does not validate or correct invalid HTML syntax or fix broken tags, only formats existing HTML structure. It cannot transform non-HTML input or parse scripts/styles for correctness.", + "examples": [ + "Format a minified HTML snippet into readable indented code with 4 spaces indent.", + "Minify an already pretty HTML to reduce size before sending over network.", + "Preserve lines insidetags while pretty printing the rest." + ] + }, + "tags": [ + "formatting", + "html", + "content-creation", + "prettify", + "minify", + "web", + "code" + ], + "examples": [ + { + "inputJson": "{\"html\":\"\",\"indentSize\":4,\"useTabs\":false,\"minify\":false}", + "description": "Pretty print simple HTML with 4 spaces indentation." + }, + { + "inputJson": "{\"html\":\"Title
Paragraph.
\",\"minify\":true}", + "description": "Minify HTML by removing extra whitespace and line breaks." + }, + { + "inputJson": "{\"html\":\"Test
Line1\\nLine2Text
\",\"preserveNewLines\":true}", + "description": "Pretty print HTML but preserve new lines insidetag." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "HTML", + "context": null + } + }, + { + "name": "content-creation.formatMigration", + "description": "Formats database migration scripts or configuration files to adhere to specified coding standards and style guides. Accepts raw migration files or scripts as input, processes them to adjust indentation, naming conventions, and code layout, and outputs the formatted migration content ready for inclusion in a codebase or execution environment.", + "category": "content-creation", + "parameters": [ + { + "name": "migrationContent", + "type": "string", + "description": "The raw migration script or configuration content to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming or scripting language of the migration content (e.g., SQL, JavaScript, Python).", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Identifier for the style guide or formatting standard to apply (e.g., 'Airbnb', 'PSR-2', 'Google').", + "required": false, + "defaultValue": "default" + }, + { + "name": "indentStyle", + "type": "string", + "description": "Indentation style to use: 'spaces' or 'tabs'.", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces or tabs to use per indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "lineEnding", + "type": "string", + "description": "Preferred line ending format: 'LF' or 'CRLF'.", + "required": false, + "defaultValue": "LF" + }, + { + "name": "fixLintErrors", + "type": "boolean", + "description": "Whether to attempt fixing linting issues during formatting if tools allow.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted migration content string and a summary of formatting changes applied." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to standardize and format migration scripts or files before committing them to a repository, sharing with a team, or deploying. It is ideal to ensure consistent styling and reduce errors caused by inconsistent formatting in database or code migration tasks.", + "limitations": "This tool cannot validate the semantic correctness of migration scripts or guarantee that the migration will run successfully. It focuses only on formatting and style adjustments, not logic or syntax validation beyond basic formatting rules.", + "examples": [ + "Format a raw SQL migration script according to the Google style guide with 4 space indents.", + "Adjust a JavaScript-based migration file using Airbnb style, tabs for indentation, and fix lint errors if possible.", + "Format a Python Alembic migration file using default style with 2 spaces and LF line endings." + ] + }, + "tags": [ + "content-creation", + "formatting", + "migration", + "database", + "code-style", + "devops", + "automation" + ], + "examples": [ + { + "inputJson": "{\"migrationContent\":\"CREATE TABLE users(id INT PRIMARY KEY, name VARCHAR(100));\",\"language\":\"SQL\",\"styleGuide\":\"Google\",\"indentStyle\":\"spaces\",\"indentSize\":4,\"lineEnding\":\"LF\",\"fixLintErrors\":false}", + "description": "Format a simple SQL migration script using Google style guide with 4 spaces indentation and LF line endings." + }, + { + "inputJson": "{\"migrationContent\":\"module.exports = { up: function(knex) {return knex.schema.createTable('users', function(table) {table.increments('id').primary();table.string('name');});}, down: function(knex) {return knex.schema.dropTable('users');} };\",\"language\":\"JavaScript\",\"styleGuide\":\"Airbnb\",\"indentStyle\":\"tabs\",\"indentSize\":1,\"lineEnding\":\"LF\",\"fixLintErrors\":true}", + "description": "Format a JavaScript migration file using Airbnb style guide with tabs and fix lint errors." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Migration", + "context": null + } + }, + { + "name": "content-creation.formatTest", + "description": "Formats raw source code test snippets into a readable, standardized style according to specified test framework conventions (e.g., Jest, Mocha). Accepts string input of test code, language, and target framework, returning well-indented, cleanly styled test code as string output.", + "category": "content-creation", + "parameters": [ + { + "name": "testCode", + "type": "string", + "description": "Raw test code snippet as input to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the test code (e.g., 'javascript', 'typescript')", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "Target test framework to format the code for (e.g., 'jest', 'mocha')", + "required": true, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces used per indentation level", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs instead of spaces for indentation", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single property 'formattedTestCode' containing the formatted test code string." + }, + "aiAgent": { + "useCase": "Use when needing to convert raw or poorly formatted test code snippets into clean, readable, and standardized tests corresponding to the specified programming language and test framework. Useful for improving code readability, enforcing style guides, or preparing test code for integration into projects.", + "limitations": "Does not validate test logic correctness or test execution; focuses only on formatting style. Limited to known test frameworks and common languages. May not handle highly unconventional code structures.", + "examples": [ + "Format a raw JavaScript test snippet into Jest style with 2 spaces indentation.", + "Convert a TypeScript Mocha test snippet to use tabs for indentation.", + "Standardize formatting for a messy JavaScript test code snippet targeting Mocha." + ] + }, + "tags": [ + "formatting", + "test-code", + "code-style", + "unit-testing", + "javascript", + "typescript", + "jest", + "mocha" + ], + "examples": [ + { + "inputJson": "{\"testCode\":\"test('adds numbers',()=>{expect(add(1,2)).toBe(3)})\",\"language\":\"javascript\",\"testFramework\":\"jest\",\"indentSize\":2,\"useTabs\":false}", + "description": "Format a simple JavaScript test snippet to Jest conventions with 2 spaces indentation." + }, + { + "inputJson": "{\"testCode\":\"describe('math', function(){ it('adds',()=>{ expect(add(1,2)).to.equal(3); }) })\",\"language\":\"javascript\",\"testFramework\":\"mocha\",\"indentSize\":4,\"useTabs\":true}", + "description": "Format a JavaScript test snippet for Mocha with 4 spaces indentation replaced by tabs." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Test", + "context": null + } + }, + { + "name": "content-creation.formatDataset", + "description": "Formats a dataset by applying uniform data transformations such as trimming whitespace, standardizing date formats, normalizing numerical values, renaming fields, and filtering records based on criteria. Accepts input datasets as JSON arrays of objects and outputs the transformed dataset in the same structure.", + "category": "content-creation", + "parameters": [ + { + "name": "dataset", + "type": "array", + "description": "The input dataset to format, represented as an array of objects (records).", + "required": true, + "defaultValue": "" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to trim leading and trailing whitespace from all string fields in the dataset.", + "required": false, + "defaultValue": "true" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Target date format to standardize date fields (e.g., 'YYYY-MM-DD'). If empty, dates remain unchanged.", + "required": false, + "defaultValue": "" + }, + { + "name": "numericNormalization", + "type": "string", + "description": "Method to normalize numeric fields: 'min-max', 'z-score', or empty for no normalization.", + "required": false, + "defaultValue": "" + }, + { + "name": "fieldRenames", + "type": "object", + "description": "Object mapping existing field names to new field names for renaming dataset keys.", + "required": false, + "defaultValue": "" + }, + { + "name": "filterCriteria", + "type": "object", + "description": "Filter conditions specifying field-value pairs; records must match all to be included.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted dataset as an array of records under the 'formattedDataset' key." + }, + "aiAgent": { + "useCase": "Use this tool to clean and standardize datasets before analysis or integration. It helps in preparing data by enforcing consistent formatting, simplifying downstream processing or visualization tasks. Ideal when handling raw data with inconsistent entries or varying formats.", + "limitations": "Cannot perform complex data validations or infer transformations automatically beyond specified parameters. Does not handle nested objects or arrays within dataset records.", + "examples": [ + "Format a dataset by trimming whitespace and standardizing all date fields to 'YYYY-MM-DD'.", + "Rename fields 'fname' to 'firstName' and filter dataset to include only records where 'status' equals 'active'.", + "Normalize numerical fields using min-max scaling while cleaning string whitespace." + ] + }, + "tags": [ + "formatting", + "dataset", + "data-cleaning", + "data-normalization", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"dataset\":[{\"name\":\" Alice \",\"dob\":\"12/31/1990\",\"score\":10},{\"name\":\"Bob\",\"dob\":\"1991-01-15\",\"score\":15}],\"trimWhitespace\":true,\"dateFormat\":\"YYYY-MM-DD\",\"numericNormalization\":\"min-max\",\"fieldRenames\":{\"name\":\"fullName\"},\"filterCriteria\":{}}", + "description": "Normalize dates to 'YYYY-MM-DD', trim whitespace, rename 'name' to 'fullName' and apply min-max normalization to scores." + }, + { + "inputJson": "{\"dataset\":[{\"fname\":\"John\",\"status\":\"active\",\"age\":30},{\"fname\":\"Jane\",\"status\":\"inactive\",\"age\":25}],\"trimWhitespace\":false,\"dateFormat\":\"\",\"numericNormalization\":\"\",\"fieldRenames\":{\"fname\":\"firstName\"},\"filterCriteria\":{\"status\":\"active\"}}", + "description": "Rename field 'fname' to 'firstName' and filter dataset to include only records with status 'active'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Dataset", + "context": null + } + }, + { + "name": "content-creation.formatCSV", + "description": "Formats raw CSV data into a clean, consistent CSV string with options to customize delimiter, quote characters, line endings, and whether to include header rows. Accepts input as a CSV string or array of objects and outputs properly formatted CSV text suitable for file saving or data transfer.", + "category": "content-creation", + "parameters": [ + { + "name": "inputData", + "type": "string", + "description": "Raw CSV string or JSON array string to format into CSV.", + "required": true, + "defaultValue": "" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character to use as field delimiter (e.g., comma, semicolon).", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteChar", + "type": "string", + "description": "Character used to quote fields, typically double quotes (\").", + "required": false, + "defaultValue": "\"" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include column headers in output CSV (if input includes headers or an array of objects).", + "required": false, + "defaultValue": "true" + }, + { + "name": "lineEnding", + "type": "string", + "description": "String used for line breaks. Use '\\n' for Unix or '\\r\\n' for Windows.", + "required": false, + "defaultValue": "\\n" + } + ], + "returns": { + "type": "string", + "description": "A formatted CSV string matching the specified parameters, ready for file output or API transmission." + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize or reformat CSV data: for example, cleaning up inconsistent CSV inputs, changing delimiters, enforcing quoting, or preparing data for exporting or interoperation with CSV-consuming systems.", + "limitations": "Does not parse CSV into structured usable objects or validate data types; only formats given CSV or array input into consistent CSV text. Does not handle extremely large datasets efficiently in memory-limited environments.", + "examples": [ + "Format raw CSV string by changing delimiter from comma to semicolon.", + "Convert array of objects to CSV string including headers with double quotes as quote characters.", + "Normalize line endings to Windows style and ensure all fields are properly quoted." + ] + }, + "tags": [ + "content", + "csv", + "formatting", + "data-cleaning", + "export", + "delimiter", + "quote", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"inputData\":\"name,age,city\\nAlice,30,New York\\nBob,25,Los Angeles\",\"delimiter\":\";\",\"quoteChar\":\"\\\"\",\"includeHeaders\":true,\"lineEnding\":\"\\r\\n\"}", + "description": "Convert a CSV string with commas to semicolon delimiters and Windows line endings." + }, + { + "inputJson": "{\"inputData\":\"[{\\\"name\\\":\\\"Alice\\\",\\\"age\\\":30,\\\"city\\\":\\\"New York\\\"},{\\\"name\\\":\\\"Bob\\\",\\\"age\\\":25,\\\"city\\\":\\\"Los Angeles\\\"}]\",\"delimiter\":\",\",\"quoteChar\":\"\\\"\",\"includeHeaders\":true,\"lineEnding\":\"\\n\"}", + "description": "Format an array of objects into CSV with default comma delimiter and Unix line endings." + }, + { + "inputJson": "{\"inputData\":\"name;age;city\\nAlice;30;New York\\nBob;25;Los Angeles\",\"delimiter\":\";\",\"quoteChar\":\"'\",\"includeHeaders\":true,\"lineEnding\":\"\\n\"}", + "description": "Format CSV string with semicolon delimiter, single quote character, and Unix line endings." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "CSV", + "context": null + } + }, + { + "name": "content-creation.formatJSON", + "description": "Formats a JSON string or object input to produce a properly indented and human-readable JSON string output. Accepts raw JSON string or an object, applies indentation with customizable number of spaces, and optionally sorts object keys alphabetically for consistent formatting.", + "category": "content-creation", + "parameters": [ + { + "name": "inputJSON", + "type": "string", + "description": "The JSON string or serialized JSON input to format. Must be valid JSON.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces used for indentation in the output JSON. Typical values are 2 or 4.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "If true, object keys are sorted alphabetically in the output for consistency.", + "required": false, + "defaultValue": "false" + }, + { + "name": "spaceAfterColon", + "type": "boolean", + "description": "If true, inserts a space after the colon in key-value pairs for readability.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted JSON string under 'formattedJSON' key. Throws error if input JSON is invalid." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to tidy up or normalize JSON data for display, logging, configuration files, or ensuring consistent formatting before storage or transmission. It helps produce readable JSON output with customizable styling.", + "limitations": "Cannot validate semantic correctness beyond JSON syntax. Cannot transform JSON data beyond formatting (e.g., cannot restructure data or change values). Does not process extremely large JSON strings efficiently.", + "examples": [ + "Format a minified JSON string with 4 spaces indentation for readability.", + "Format JSON object input with sorted keys for consistent output.", + "Produce compact JSON by setting indentation to 0 and disabling extra spacing." + ] + }, + "tags": [ + "json", + "formatting", + "content-creation", + "pretty-print", + "data-formatting" + ], + "examples": [ + { + "inputJson": "{\"inputJSON\":\"{\\\"name\\\":\\\"Alice\\\",\\\"age\\\":30,\\\"city\\\":\\\"NY\\\"}\",\"indentationSpaces\":4,\"sortKeys\":true,\"spaceAfterColon\":true}", + "description": "Format a JSON string with 4-space indentation and keys sorted alphabetically." + }, + { + "inputJson": "{\"inputJSON\":\"[1,2,3,4]\",\"indentationSpaces\":2,\"sortKeys\":false,\"spaceAfterColon\":true}", + "description": "Format a JSON array string with 2-space indentation without sorting keys." + }, + { + "inputJson": "{\"inputJSON\":\"{\\\"b\\\":1,\\\"a\\\":2}\",\"indentationSpaces\":0,\"sortKeys\":true,\"spaceAfterColon\":false}", + "description": "Format JSON object with no indentation and no space after colon, sorting keys alphabetically for compactness." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "JSON", + "context": null + } + }, + { + "name": "content-creation.formatXML", + "description": "Formats an input XML string by applying consistent indentation and optional line breaks to improve readability. Accepts a raw XML string and returns a prettified XML string output. Can customize indentation style and size.", + "category": "content-creation", + "parameters": [ + { + "name": "xmlString", + "type": "string", + "description": "The raw XML string input that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces to use per indentation level in the formatted output.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "If true, uses tab characters for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeLineBreaks", + "type": "boolean", + "description": "Whether to include line breaks between elements for better readability.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted XML string under the key 'formattedXml'. If the input XML is invalid, an error message is included." + }, + "aiAgent": { + "useCase": "Use this tool when you need to transform raw, minified, or inconsistently formatted XML data into a human-readable, consistently indented XML format. This is useful for display, debugging, logging, or preparing XML content for editing and review.", + "limitations": "This tool does not validate XML syntax or correctness beyond basic structural assumptions and may not fix invalid XML. It only formats the XML string for readability without changing element ordering or content.", + "examples": [ + "Format a compacted XML string to be readable with standard 2-space indentation.", + "Convert an XML string to use tabs for indentation instead of spaces for editor compatibility.", + "Format XML for display ensuring line breaks between elements are present." + ] + }, + "tags": [ + "content-creation", + "formatting", + "XML", + "prettify", + "indentation", + "data-rendering" + ], + "examples": [ + { + "inputJson": "{\"xmlString\":\"\",\"indentationSize\":4,\"useTabs\":false,\"includeLineBreaks\":true}", + "description": "Format basic XML with 4 spaces indentation and line breaks." + }, + { + "inputJson": "{\"xmlString\":\" value value2 \",\"useTabs\":true}", + "description": "Format XML using tabs for indentation instead of spaces." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "XML", + "context": null + } + }, + { + "name": "content-creation.formatQuery", + "description": "Formats and standardizes database query strings according to specified style preferences. Accepts a raw query string and optional formatting options (such as indentation, uppercase keywords). Returns a clean, well-indented query string suitable for readability and consistent code style in SQL, NoSQL, or similar query languages.", + "category": "content-creation", + "parameters": [ + { + "name": "query", + "type": "string", + "description": "The raw database query string that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The query language of the input (e.g., 'sql', 'mongodb', 'graphql').", + "required": false, + "defaultValue": "sql" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces used for indentation of nested clauses or levels.", + "required": false, + "defaultValue": "4" + }, + { + "name": "uppercaseKeywords", + "type": "boolean", + "description": "If true, SQL keywords or language reserved words will be uppercased in the output for clarity.", + "required": false, + "defaultValue": "true" + }, + { + "name": "newlineAroundOperators", + "type": "boolean", + "description": "If true, places newlines before or after major operators (e.g., AND, OR, JOIN) for better readability.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a formattedQuery string with the cleaned and nicely formatted query based on the inputs." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to clean up, reformat, or standardize database queries for better readability, consistency, or downstream processing. Useful in generating human-readable SQL or NoSQL queries from user input or legacy sources.", + "limitations": "Currently supports only a limited set of query languages and basic formatting options; does not perform semantic validation or optimization of queries.", + "examples": [ + "Format this raw SQL query with 2-space indentation and uppercase keywords.", + "Reformat a MongoDB query string for better readability.", + "Standardize GraphQL queries with custom indentation and newlines around operators." + ] + }, + "tags": [ + "formatting", + "query", + "SQL", + "NoSQL", + "code-style", + "database", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"query\":\"select id,name from users where age>30 and status='active' order by name desc\",\"language\":\"sql\",\"indentationSpaces\":2,\"uppercaseKeywords\":true,\"newlineAroundOperators\":true}", + "description": "Formats a basic SQL SELECT query with 2-space indentation and uppercase keywords." + }, + { + "inputJson": "{\"query\":\"{ user(id: \\\"1\\\") { name, age, posts(limit:5) { title, date } } }\",\"language\":\"graphql\",\"indentationSpaces\":2,\"uppercaseKeywords\":false,\"newlineAroundOperators\":false}", + "description": "Formats a GraphQL query with 2-space indentation but without uppercasing keywords or extra newlines." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Query", + "context": null + } + }, + { + "name": "content-creation.formatEndpoint", + "description": "Formats raw API endpoint code snippets into consistent, readable, and standardized code blocks. Accepts endpoint definitions as strings in formats like REST or GraphQL, applies user-specified styling rules such as indentation size, syntax highlighting preference, and comment style, then outputs the formatted endpoint code as a string ready for integration or documentation.", + "category": "content-creation", + "parameters": [ + { + "name": "endpointCode", + "type": "string", + "description": "The raw code snippet defining the API endpoint to format. Can include REST, GraphQL, or similar endpoint code.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming or specification language of the endpoint code (e.g., 'REST', 'GraphQL', 'OpenAPI'). Used to apply correct syntax rules.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces to use for each indentation level in the formatted code.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs instead of spaces for indentation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "syntaxHighlighting", + "type": "boolean", + "description": "Whether to include syntax highlighting markup in the formatted output, for documentation purposes.", + "required": false, + "defaultValue": "false" + }, + { + "name": "commentStyle", + "type": "string", + "description": "Preferred comment style to apply ('line', 'block', or 'none') when formatting embedded comments in the endpoint code.", + "required": false, + "defaultValue": "line" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted endpoint code as a string, optionally including metadata such as detected language and formatting summary, suitable for display or further processing." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw or inconsistent API endpoint code snippets that need formatting for better readability, consistency in documentation, or codebase integration. Helpful for preparing clean endpoint definitions in REST, GraphQL, or similar formats before publishing or sharing internally.", + "limitations": "This tool does not validate endpoint correctness or semantics; it only formats code syntax for readability. It also cannot generate endpoint definitions from descriptions or translate between API specification languages.", + "examples": [ + "Format a raw REST endpoint code snippet with 4-space indentation and syntax highlighting.", + "Standardize GraphQL schema endpoint definitions to use tabs for indentation.", + "Convert endpoint code comments to block style formatting with 2 spaces indentation." + ] + }, + "tags": [ + "formatting", + "api", + "endpoint", + "code", + "content-creation", + "documentation", + "rest", + "graphql" + ], + "examples": [ + { + "inputJson": "{\"endpointCode\":\"GET /users/{id} HTTP/1.1\\nHost: api.example.com\\nAccept: application/json\",\"language\":\"REST\",\"indentationSize\":4,\"useTabs\":false,\"syntaxHighlighting\":true,\"commentStyle\":\"line\"}", + "description": "Format a simple REST endpoint snippet with 4 spaces indentation and syntax highlighting." + }, + { + "inputJson": "{\"endpointCode\":\"type Query {\\nuser(id: ID!): User\\n}\",\"language\":\"GraphQL\",\"indentationSize\":2,\"useTabs\":true,\"syntaxHighlighting\":false,\"commentStyle\":\"block\"}", + "description": "Format a GraphQL query definition using tabs and block comment style without syntax highlighting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Endpoint", + "context": null + } + }, + { + "name": "content-creation.formatSchema", + "description": "Formats a JSON schema string or object into a standardized, readable, and properly indented schema format. Accepts a JSON string or object representing a JSON Schema and returns a formatted JSON string with customizable indentation, ensuring consistent style suitable for documentation or further processing.", + "category": "content-creation", + "parameters": [ + { + "name": "schemaInput", + "type": "string", + "description": "The input JSON Schema as a raw JSON string to be parsed and formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted output. Typically 2 or 4.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortProperties", + "type": "boolean", + "description": "Whether to sort the properties of objects alphabetically to ensure consistent order in the output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formattedSchema as a JSON string with applied indentation and property ordering." + }, + "aiAgent": { + "useCase": "Use this tool when needing to produce a clean, human-readable version of a JSON Schema for documentation, code generation, review, or debugging. It helps standardize the schema format and improves readability by enforcing consistent indentation and optional property sorting.", + "limitations": "This tool formats existing valid JSON Schema inputs but does not validate schema correctness or resolve references within the schema. It does not transform schema semantics or generate schemas from non-schema data.", + "examples": [ + "Format a raw JSON Schema string into a neatly indented JSON string with 4 spaces indentation.", + "Format a JSON Schema object with sorted properties alphabetically for consistent documentation.", + "Reformat a minified schema string into human-readable form with default indentation." + ] + }, + "tags": [ + "formatting", + "json", + "json-schema", + "content-creation", + "code-style" + ], + "examples": [ + { + "inputJson": "{\"schemaInput\":\"{\\\"type\\\":\\\"object\\\",\\\"properties\\\":{\\\"b\\\":{\\\"type\\\":\\\"string\\\"},\\\"a\\\":{\\\"type\\\":\\\"number\\\"}}}\",\"indentation\":4,\"sortProperties\":true}", + "description": "Formats a JSON Schema string with 4 spaces indentation and properties sorted alphabetically." + }, + { + "inputJson": "{\"schemaInput\":\"{\\\"type\\\":\\\"array\\\",\\\"items\\\":{\\\"type\\\":\\\"integer\\\"}}\",\"indentation\":2,\"sortProperties\":false}", + "description": "Formats a simple JSON Schema array type with 2 spaces indentation without sorting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Schema", + "context": null + } + }, + { + "name": "content-creation.formatFunction", + "description": "Formats a given source code function string according to specified style rules. Accepts raw function code as a string and options such as indentation style, line width, and whether to use semicolons. Returns the formatted function code string, improved for readability and consistency with common coding standards.", + "category": "content-creation", + "parameters": [ + { + "name": "functionCode", + "type": "string", + "description": "The raw source code of the function to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentStyle", + "type": "string", + "description": "Indentation style to use: can be 'space' or 'tab'. Determines whether spaces or tabs are used for indentation.", + "required": false, + "defaultValue": "space" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces or tabs per indentation level. Ignored if indentStyle is 'tab'.", + "required": false, + "defaultValue": "2" + }, + { + "name": "maxLineWidth", + "type": "number", + "description": "Maximum line width before code lines are wrapped for better readability.", + "required": false, + "defaultValue": "80" + }, + { + "name": "useSemicolons", + "type": "boolean", + "description": "Whether to insert semicolons at the end of statements when applicable.", + "required": false, + "defaultValue": "true" + }, + { + "name": "braceStyle", + "type": "string", + "description": "Brace style to apply: '1tbs' (One True Brace Style), 'stroustrup', or 'allman'. Determines positioning of braces.", + "required": false, + "defaultValue": "1tbs" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function code as a string under the key 'formattedFunction'. The output is syntactically equivalent to the input but follows the specified formatting options." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to standardize or beautify code snippets of functions in various programming languages to improve readability, maintainability, or to conform to project style guidelines before displaying, storing, or further processing the code.", + "limitations": "The tool focuses on formatting a single function code string and does not perform linting, error checking, or transpilation. It may not fully support every edge-case syntax or all programming languages. It expects syntactically valid input function code.", + "examples": [ + "Format a raw JavaScript function with 4 spaces indentation and 'allman' brace style.", + "Reformat a Python function string using tabs and a max line width of 100 characters.", + "Apply semicolon-less formatting to a TypeScript function code snippet with 2 spaces indent." + ] + }, + "tags": [ + "formatting", + "code", + "function", + "beautify", + "code-style", + "source-code", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"functionCode\":\"function sum(a,b){return a+b}\",\"indentStyle\":\"space\",\"indentSize\":2,\"maxLineWidth\":80,\"useSemicolons\":true,\"braceStyle\":\"1tbs\"}", + "description": "Format a compact JavaScript function with standard 2-space indentation and semicolons." + }, + { + "inputJson": "{\"functionCode\":\"def greet(name):\\n print(f'Hello, {name}')\",\"indentStyle\":\"tab\",\"indentSize\":1,\"maxLineWidth\":80,\"useSemicolons\":false,\"braceStyle\":\"1tbs\"}", + "description": "Format a Python function using tabs for indentation without semicolons." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "content-creation.formatSpec", + "description": "This tool accepts a software or technical specification document as text or structured JSON input, formats it into a standardized, readable spec document according to chosen style guidelines (like Markdown, reStructuredText, or HTML), and outputs the formatted spec. It supports organizing sections, formatted code blocks, lists, and tables.", + "category": "content-creation", + "parameters": [ + { + "name": "inputSpec", + "type": "string", + "description": "The raw specification document content or structured data to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the input spec (e.g., 'plaintext', 'json'), to guide parsing if needed.", + "required": false, + "defaultValue": "plaintext" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the specification (e.g., 'markdown', 'html', 'rst').", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents in the formatted spec.", + "required": false, + "defaultValue": "true" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Optional style guide or template name to apply formatting rules from (e.g., 'default', 'IEEE', 'custom').", + "required": false, + "defaultValue": "default" + }, + { + "name": "sectionOrdering", + "type": "array", + "description": "An optional array of strings defining the order of sections to appear in the output, if applicable.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted specification document as a string under 'formattedSpec', and metadata such as content type or format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate or reformat technical specification documents into clean, standardized formats suitable for sharing, documentation, or presentation. Ideal for transforming raw or loosely structured spec content into professional formatted outputs.", + "limitations": "Cannot fully interpret ambiguous or incomplete specification inputs; expects reasonably well-structured or clearly sectionalized input. Does not generate spec content from scratch, only formats provided content.", + "examples": [ + "Format a JSON structured spec document into Markdown with a table of contents.", + "Convert a plaintext tech spec into HTML formatted document for web presentation.", + "Apply a custom style guide to a software specification and export as reStructuredText." + ] + }, + "tags": [ + "content-creation", + "formatting", + "documentation", + "specification", + "technical-document", + "markdown", + "html" + ], + "examples": [ + { + "inputJson": "{\"inputSpec\":\"# API Spec\\n## Authentication\\nUse OAuth2.0.\\n## Endpoints\\n- /users\\n- /posts\",\"inputFormat\":\"plaintext\",\"outputFormat\":\"markdown\",\"includeTableOfContents\":true,\"styleGuide\":\"default\",\"sectionOrdering\":[] }", + "description": "Format a plain text API specification into Markdown with a table of contents." + }, + { + "inputJson": "{\"inputSpec\":\"{\\\"title\\\":\\\"API Spec\\\",\\\"sections\\\":[{\\\"heading\\\":\\\"Authentication\\\",\\\"content\\\":\\\"Use OAuth2.0.\\\"},{\\\"heading\\\":\\\"Endpoints\\\",\\\"content\\\":\\\"/users, /posts\\\"}]}','inputFormat':'json','outputFormat':'html','includeTableOfContents':true,'styleGuide':'default','sectionOrdering':['Authentication','Endpoints'] }", + "description": "Format a JSON structured specification into an HTML document with sections ordered and a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Spec", + "context": null + } + }, + { + "name": "content-creation.formatAPI", + "description": "Formats provided API specification code snippets according to a specified programming language style (e.g., JavaScript, Python) and style guideline. Accepts raw or partial API code text input, applies syntax formatting and indentation rules, and outputs clean, standardized API code for improved readability and maintainability.", + "category": "content-creation", + "parameters": [ + { + "name": "apiCode", + "type": "string", + "description": "The raw or partial API specification code snippet to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Target programming language or specification format for the API code (e.g., 'JavaScript', 'Python', 'OpenAPI').", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "The style guideline to apply for formatting (e.g., 'Google', 'Airbnb', 'PEP8'); if unspecified, defaults to common conventions.", + "required": false, + "defaultValue": "" + }, + { + "name": "indentSpaces", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted code; overrides style guide indent if specified.", + "required": false, + "defaultValue": "2" + }, + { + "name": "preserveComments", + "type": "boolean", + "description": "Whether to preserve comments in the API code during formatting.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted API code as a string and any messages or warnings generated during formatting." + }, + "aiAgent": { + "useCase": "Use this tool when needing to cleanly format or standardize API code snippets or specifications for documentation, code review, or integration. It helps produce readable, style-consistent API code from raw or inconsistent inputs, supporting multiple languages and style guidelines.", + "limitations": "This tool formats the code text only; it does not validate semantic correctness or functional correctness of the API specification. It also cannot generate API code from scratch or fix logical errors.", + "examples": [ + "Format a raw JavaScript API method snippet to Airbnb style.", + "Convert and format OpenAPI specification fragment to Google style indentation.", + "Clean and uniformly indent a Python Flask API route handler snippet." + ] + }, + "tags": [ + "formatting", + "api", + "code", + "style", + "content-creation", + "programming", + "clean-code" + ], + "examples": [ + { + "inputJson": "{\"apiCode\":\"function getUser(id){return fetch('/user/'+id)}\",\"language\":\"JavaScript\",\"styleGuide\":\"Airbnb\",\"indentSpaces\":2,\"preserveComments\":true}", + "description": "Formats a raw JavaScript API function snippet to conform with Airbnb style guidelines using 2-space indentation and preserving comments." + }, + { + "inputJson": "{\"apiCode\":\"paths:\\n /users:\\n get:\\n summary: Retrieves list of users\\n\",\"language\":\"OpenAPI\",\"styleGuide\":\"Google\",\"indentSpaces\":4,\"preserveComments\":false}", + "description": "Formats an OpenAPI snippet with 4-space indentation according to Google style rules without preserving comments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "API", + "context": null + } + }, + { + "name": "content-creation.formatModule", + "description": "Formats source code modules by applying consistent code styling rules. Accepts raw source code as input along with the programming language and style preferences. Outputs the formatted source code string adhering to the specified style guidelines.", + "category": "content-creation", + "parameters": [ + { + "name": "sourceCode", + "type": "string", + "description": "Raw source code string of the module to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the source code (e.g., 'javascript', 'python', 'java').", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Named style guide to apply (e.g., 'Google', 'Airbnb', 'PEP8') or 'custom' for user-defined options.", + "required": false, + "defaultValue": "Google" + }, + { + "name": "customRules", + "type": "object", + "description": "Optional object specifying custom formatting rules to override the style guide. Keys and values depend on the language/style guide.", + "required": false, + "defaultValue": "" + }, + { + "name": "insertFinalNewline", + "type": "boolean", + "description": "Whether to ensure the file ends with a newline character.", + "required": false, + "defaultValue": "true" + }, + { + "name": "tabWidth", + "type": "number", + "description": "Number of spaces per indentation level.", + "required": false, + "defaultValue": "2" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted source code string and optionally a summary of changes made." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically format source code modules to enforce consistent styling and improve readability before committing code, code reviews, or publishing. It helps prepare code fragments or whole files to match a given style guide or custom format rules.", + "limitations": "Cannot fix semantic or logic errors, only formats code styling. Style guide support may be limited to common languages and predefined guides. Custom rule complexity depends on implementation.", + "examples": [ + "Format JavaScript module source code according to Airbnb style guide.", + "Format a Python module ensuring PEP8 compliance with 4 space indentation.", + "Format Java source code applying Google Java style with a final newline." + ] + }, + "tags": [ + "formatting", + "code", + "module", + "styleguide", + "development", + "source-code", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"sourceCode\":\"function sum(a,b){return a+b}\",\"language\":\"javascript\",\"styleGuide\":\"Airbnb\",\"insertFinalNewline\":true,\"tabWidth\":2}", + "description": "Formats a simple JavaScript function with Airbnb style guide and ensures a final newline." + }, + { + "inputJson": "{\"sourceCode\":\"def add(a,b):\\n return a+b\",\"language\":\"python\",\"styleGuide\":\"PEP8\",\"tabWidth\":4}", + "description": "Formats Python function according to PEP8 with 4 space indentation." + }, + { + "inputJson": "{\"sourceCode\":\"public class HelloWorld{public static void main(String[] args){System.out.println(\\\"Hello, World!\\\");}}\",\"language\":\"java\",\"styleGuide\":\"Google\",\"insertFinalNewline\":true}", + "description": "Formats a Java 'Hello World' class according to Google Java style guide, adding a final newline." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Module", + "context": null + } + }, + { + "name": "content-creation.formatReadme", + "description": "Formats a raw README markdown text or similar project description document by applying consistent styling, section ordering, and optional enhancement like badges or table of contents. Accepts raw markdown input and outputs cleaned, well-structured, and standardized markdown ready for repositories or documentation sites.", + "category": "content-creation", + "parameters": [ + { + "name": "rawMarkdown", + "type": "string", + "description": "The original README content in markdown format to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Optional style guide preset name to apply formatting rules (e.g., 'GitHub', 'Standard','Custom').", + "required": false, + "defaultValue": "GitHub" + }, + { + "name": "includeToc", + "type": "boolean", + "description": "Whether to add or update a Table of Contents based on headings.", + "required": false, + "defaultValue": "true" + }, + { + "name": "addBadges", + "type": "array", + "description": "An array of badge markdown strings to prepend to the README (e.g., build status, license badges).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "reorderSections", + "type": "array", + "description": "An array defining desired order of main sections by heading titles (e.g., ['Introduction','Installation','Usage','Contributing','License']).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length for wrapping text lines; 0 means no wrapping.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted README markdown as a string under 'formattedMarkdown'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize and improve the structure and presentation of README files or project documentation in markdown format. Helpful for cleaning up inconsistent formatting, adding table of contents, or preparing docs for open source release or publication.", + "limitations": "The tool does not validate markdown syntax beyond formatting, nor does it create content or fix spelling and grammar. It also cannot interpret deeply nested document logic or insert dynamic content beyond badges and TOC.", + "examples": [ + "Format a raw README to GitHub style, include TOC and badges.", + "Reorder README sections to a specified sequence and wrap lines at 100 characters.", + "Format a README without TOC or badges, preserving original section order." + ] + }, + "tags": [ + "content-creation", + "formatting", + "markdown", + "readme", + "documentation", + "developer-tools", + "open-source" + ], + "examples": [ + { + "inputJson": "{\"rawMarkdown\":\"# My Project\\nThis is a sample README.\\n## Usage\\nRun the app.\",\"styleGuide\":\"GitHub\",\"includeToc\":true,\"addBadges\":[\"\"],\"reorderSections\":[\"Introduction\",\"Usage\"],\"maxLineLength\":80}", + "description": "Format a basic README with GitHub style, adding TOC and build status badge, reorder Introduction and Usage sections." + }, + { + "inputJson": "{\"rawMarkdown\":\"# Project\\nSome description\",\"styleGuide\":\"Standard\",\"includeToc\":false,\"addBadges\":[],\"reorderSections\":[],\"maxLineLength\":0}", + "description": "Format README to Standard style without TOC or badges, no line wrapping." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Readme", + "context": null + } + }, + { + "name": "content-creation.formatComponent", + "description": "Formats source code components such as classes, functions, or modules in supported programming languages. Accepts raw component code and formatting options, applies consistent indentation, spacing, and style conventions, and outputs the formatted code string ready for inclusion in larger codebases.", + "category": "content-creation", + "parameters": [ + { + "name": "componentCode", + "type": "string", + "description": "The raw source code of the component to format, as a string.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the component code (e.g., 'javascript', 'python', 'java').", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Optional coding style guide or preset to follow (e.g., 'Airbnb', 'Google', 'PEP8').", + "required": false, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use per indentation level. Defaults to 2.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "semiColon", + "type": "boolean", + "description": "Whether to enforce semicolons at the end of statements (where applicable).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with the formatted component code as a string and optional parsing warnings or errors." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw or inconsistently styled source code for a component in a supported programming language and want to produce a clean, stylistically consistent formatted version following a specified style guide or customized formatting parameters. This helps maintain codebase quality and readability.", + "limitations": "Cannot fix semantic or functional code errors; focuses solely on stylistic formatting. Limited to supported languages and recognized style guides or presets. Does not generate documentation or analyze code logic.", + "examples": [ + "Format a raw JavaScript function component using the Airbnb style guide.", + "Format a Python class code string enforcing 4-space indentation and PEP8 style.", + "Format a Java method with tabs instead of spaces for indentation and no semicolons (if language allows)." + ] + }, + "tags": [ + "formatting", + "code", + "component", + "source-code", + "style", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"componentCode\":\"function add(a,b){return a+b}\",\"language\":\"javascript\",\"styleGuide\":\"Airbnb\",\"indentSize\":2,\"useTabs\":false,\"semiColon\":true}", + "description": "Format a JavaScript function to Airbnb style with 2 spaces indentation and semicolons." + }, + { + "inputJson": "{\"componentCode\":\"class Person:\\n def __init__(self,name):\\n self.name=name\",\"language\":\"python\",\"styleGuide\":\"PEP8\",\"indentSize\":4,\"useTabs\":false}", + "description": "Format a Python class to PEP8 style with 4 spaces indentation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Component", + "context": null + } + }, + { + "name": "content-creation.formatCode", + "description": "This tool takes source code as input, automatically formats it according to specified language style guidelines, and outputs the cleaned, consistently styled code. It supports multiple programming languages and customizable indentation, line length, and brace style settings to produce readable, standardized code blocks.", + "category": "content-creation", + "parameters": [ + { + "name": "sourceCode", + "type": "string", + "description": "The raw source code text that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the source code to apply appropriate formatting rules (e.g., 'javascript', 'python', 'java').", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationStyle", + "type": "string", + "description": "Style of indentation, such as 'spaces' or 'tabs'.", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces or tabs used for each indentation level.", + "required": false, + "defaultValue": "4" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed line length before wrapping the code lines.", + "required": false, + "defaultValue": "80" + }, + { + "name": "braceStyle", + "type": "string", + "description": "Brace placement style, e.g., '1tbs', 'allman', or 'stroustrup'.", + "required": false, + "defaultValue": "1tbs" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted code as a string and a summary of formatting changes applied." + }, + "aiAgent": { + "useCase": "Use this tool when raw or poorly formatted source code needs to be cleaned for readability, consistency, or to adhere to language-specific style guidelines before review or production deployment. It is especially useful for automated code formatting in CI/CD pipelines or IDE integrations.", + "limitations": "This tool reformats code style but does not perform semantic analysis, linting error detection, or code correctness checks. It supports common languages but may not cover every language syntax or variant.", + "examples": [ + "Format a JavaScript snippet with 2 spaces indentation and max line length 100.", + "Format Python code with tabs indentation following PEP 8 style.", + "Format Java code using Allman brace style and 4 spaces indentation." + ] + }, + "tags": [ + "formatting", + "code", + "programming", + "style", + "software development" + ], + "examples": [ + { + "inputJson": "{\"sourceCode\":\"function foo(){console.log('hello');}\",\"language\":\"javascript\",\"indentationStyle\":\"spaces\",\"indentationSize\":2,\"maxLineLength\":100,\"braceStyle\":\"1tbs\"}", + "description": "Format minimal JavaScript code with 2-space indentation" + }, + { + "inputJson": "{\"sourceCode\":\"def foo():\\n print('hello')\",\"language\":\"python\",\"indentationStyle\":\"tabs\",\"indentationSize\":1,\"maxLineLength\":80,\"braceStyle\":\"\"}", + "description": "Format Python code with tab indentation following PEP 8 standards" + }, + { + "inputJson": "{\"sourceCode\":\"public class Main{public static void main(String[] args){System.out.println(\\\"Hello\\\");}}\",\"language\":\"java\",\"indentationStyle\":\"spaces\",\"indentationSize\":4,\"maxLineLength\":80,\"braceStyle\":\"allman\"}", + "description": "Format Java code snippet with Allman brace style and 4 spaces indentation" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "content-creation.formatFAQ", + "description": "Formats a list of FAQ entries into a structured, user-friendly FAQ document. Accepts input as an array of objects, each with a question and answer, and produces a formatted string output with optional styling and numbering.", + "category": "content-creation", + "parameters": [ + { + "name": "faqEntries", + "type": "array", + "description": "An array of objects each containing 'question' and 'answer' strings representing FAQ items to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Output format style, such as 'markdown', 'html', or 'plainText' to control formatting syntax.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "numbered", + "type": "boolean", + "description": "Whether to number the FAQ entries sequentially. Defaults to false (bulleted style).", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeHeading", + "type": "boolean", + "description": "Whether to include a main heading 'Frequently Asked Questions' at the start of the output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxItems", + "type": "number", + "description": "Maximum number of FAQ entries to include in the output. If set, truncates the list to this number.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'formattedFAQ' string which is the complete formatted FAQ document in the specified style." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a clean, formatted FAQ section from raw question-answer pairs in various output formats like markdown for docs, HTML for web pages, or plaintext for simple display, optionally with numbering and a main heading.", + "limitations": "Does not generate content itself; requires pre-existing questions and answers. Formatting styles are limited to basic markdown, HTML, or plain text and may not support advanced styling or nested elements.", + "examples": [ + "Format an FAQ array into a markdown document with numbered questions.", + "Create a plain text FAQ list without numbering or heading, limited to top 5 questions.", + "Generate an HTML formatted FAQ with heading and unnumbered entries." + ] + }, + "tags": [ + "formatting", + "content-creation", + "FAQ", + "documentation", + "markdown", + "html", + "plainText" + ], + "examples": [ + { + "inputJson": "{\"faqEntries\":[{\"question\":\"What is your return policy?\",\"answer\":\"You can return any item within 30 days of purchase.\"},{\"question\":\"Do you offer technical support?\",\"answer\":\"Yes, 24/7 technical support is available.\"}],\"style\":\"markdown\",\"numbered\":true,\"includeHeading\":true}", + "description": "Format two FAQ items as a numbered markdown FAQ document including a heading." + }, + { + "inputJson": "{\"faqEntries\":[{\"question\":\"How to reset my password?\",\"answer\":\"Click 'Forgot Password' on the login page and follow instructions.\"},{\"question\":\"Is there a mobile app?\",\"answer\":\"Yes, available on both Android and iOS.\"}],\"style\":\"plainText\",\"numbered\":false,\"includeHeading\":false}", + "description": "Format a simple plain text FAQ without heading or numbering." + }, + { + "inputJson": "{\"faqEntries\":[{\"question\":\"Where are you located?\",\"answer\":\"Our headquarters are in New York.\"}],\"style\":\"html\",\"numbered\":false,\"includeHeading\":true}", + "description": "Generate a single entry FAQ formatted as HTML with a heading and bulleted entry." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "FAQ", + "context": null + } + }, + { + "name": "content-creation.formatChecklist", + "description": "Formats a checklist from a list of items and metadata into a standardized text or markdown document. Accepts an array of checklist items, each with optional status and description, and outputs a formatted checklist string with configurable options including output style, item prefixes, and status indicators.", + "category": "content-creation", + "parameters": [ + { + "name": "items", + "type": "array", + "description": "An array of checklist items, each item is an object with 'text' (string), optional 'isChecked' (boolean), and optional 'description' (string).", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The format of the output checklist document, e.g., 'markdown' or 'plainText'.", + "required": false, + "defaultValue": "\"markdown\"" + }, + { + "name": "title", + "type": "string", + "description": "Optional title string to be included at the top of the checklist.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "includeDescriptions", + "type": "boolean", + "description": "Whether to include item descriptions below each checklist item.", + "required": false, + "defaultValue": "false" + }, + { + "name": "checkedSymbol", + "type": "string", + "description": "Symbol or string to use for checked items (default is 'x' for markdown).", + "required": false, + "defaultValue": "\"x\"" + }, + { + "name": "uncheckedSymbol", + "type": "string", + "description": "Symbol or string to use for unchecked items (default is space for markdown).", + "required": false, + "defaultValue": "\" \"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single 'formattedChecklist' string property containing the formatted checklist document." + }, + "aiAgent": { + "useCase": "Use this tool when generating or formatting checklists for documentation, project management, or task tracking. It helps create consistent checklist output in markdown or plain text from raw checklist item data, supporting features like checked states, descriptions, and titles to improve clarity and presentation.", + "limitations": "This tool only formats checklist items into text formats (markdown or plain text). It does not integrate with external task management systems, does not support interactive or dynamic checklist behavior, and does not generate complex document formats like PDF or HTML with styling.", + "examples": [ + "Generate a markdown checklist with items and checkboxes from item data including checked states.", + "Create a plain text checklist with a title, without item descriptions, using custom symbols for checkboxes.", + "Format a checklist including item descriptions displayed below each item in markdown format." + ] + }, + "tags": [ + "content-creation", + "formatting", + "checklist", + "markdown", + "task-management", + "document" + ], + "examples": [ + { + "inputJson": "{\"items\":[{\"text\":\"Install dependencies\",\"isChecked\":true},{\"text\":\"Run tests\",\"isChecked\":false},{\"text\":\"Deploy to production\",\"isChecked\":false}],\"outputFormat\":\"markdown\",\"title\":\"Release Checklist\",\"includeDescriptions\":false}", + "description": "Format a checklist in markdown with a title and checked states." + }, + { + "inputJson": "{\"items\":[{\"text\":\"Buy groceries\",\"isChecked\":false,\"description\":\"Remember to buy fruits and veggies.\"},{\"text\":\"Call plumber\",\"isChecked\":true,\"description\":\"Fix kitchen sink leak.\"}],\"outputFormat\":\"markdown\",\"title\":\"Home Tasks\",\"includeDescriptions\":true}", + "description": "Format a markdown checklist including item descriptions below each item." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Checklist", + "context": null + } + }, + { + "name": "content-creation.formatTemplate", + "description": "Formats a provided document template by applying consistent styles, placeholders formatting, and layout adjustments. Accepts a template string with placeholders, formatting options, and outputs a formatted template string ready for content insertion or presentation.", + "category": "content-creation", + "parameters": [ + { + "name": "templateString", + "type": "string", + "description": "The raw template text which may include placeholders or tokens to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The style preset to apply such as 'formal', 'casual', or 'business'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "placeholderFormat", + "type": "string", + "description": "The formatting style for placeholders, e.g., double curly braces '{{placeholder}}', angle brackets ' value '.", + "required": false, + "defaultValue": "{{}}" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted template.", + "required": false, + "defaultValue": "4" + }, + { + "name": "capitalizeHeadings", + "type": "boolean", + "description": "Whether to capitalize all headings within the template.", + "required": false, + "defaultValue": "true" + }, + { + "name": "lineSpacing", + "type": "number", + "description": "Number of line breaks between paragraphs or sections.", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted template string as 'formattedTemplate'. This template is consistently styled and ready for content insertion." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI needs to prepare or normalize document templates by applying stylistic rules and placeholder formatting to ensure consistency before content insertion or distribution. It helps automate template standardization for reports, letters, emails, or other documents.", + "limitations": "It does not fill in placeholder values; it only formats the template structure and style. It cannot interpret or validate the correctness of placeholders' semantics.", + "examples": [ + "Format the supplied email template to have formal style with double curly braces for placeholders.", + "Apply business style template formatting using angle brackets for placeholders with 2 spaces indentation.", + "Produce a casually styled template with capitalized headings and single line spacing." + ] + }, + "tags": [ + "content", + "template", + "formatting", + "document", + "style", + "placeholder", + "automation" + ], + "examples": [ + { + "inputJson": "{\"templateString\":\"Dear {{recipient}},\\n\\nWe are pleased to offer you the position at our company.\",\"style\":\"formal\",\"placeholderFormat\":\"{{}}\",\"indentationSpaces\":4,\"capitalizeHeadings\":true,\"lineSpacing\":1}", + "description": "Format a job offer letter template with formal style and standard placeholder formatting." + }, + { + "inputJson": "{\"templateString\":\"Hello ,\\nPlease find your invoice below.\",\"style\":\"business\",\"placeholderFormat\":\"<>\"}", + "description": "Apply business style formatting with angle bracket placeholders on an invoice template." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Template", + "context": null + } + }, + { + "name": "content-creation.formatSummary", + "description": "Formats a plain text summary to improve readability and presentation based on specified style options. It accepts a raw text summary along with formatting preferences such as maximum line length, bullet style for lists, and capitalization rules, then outputs a well-structured, formatted summary string.", + "category": "content-creation", + "parameters": [ + { + "name": "rawSummary", + "type": "string", + "description": "The input plain text summary that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum length of each line in characters to wrap text appropriately. Use 0 for no wrapping.", + "required": false, + "defaultValue": "80" + }, + { + "name": "bulletStyle", + "type": "string", + "description": "Character(s) to use as bullet points for list items, e.g., '-', '*', or numbered lists.", + "required": false, + "defaultValue": "-" + }, + { + "name": "capitalizeFirstLetter", + "type": "boolean", + "description": "Whether to capitalize the first letter of each sentence in the summary.", + "required": false, + "defaultValue": "true" + }, + { + "name": "trimExtraWhitespace", + "type": "boolean", + "description": "Whether to remove extra spaces and normalize spacing in the summary.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted summary as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you have an unformatted or minimally formatted text summary that needs to be cleaned up for readability and presentation. Ideal for preparing summaries extracted from raw content or AI-generated text for reports, emails, or documentation where consistent formatting is required.", + "limitations": "This tool does not generate summaries or analyze content meaning, it only reformats existing plain text summaries. It does not support complex document structures such as tables or images.", + "examples": [ + "Format a summary text for a project report with 60 character line length and bullet points as '*'.", + "Clean up a rough summary removing extra spaces and capitalizing sentences.", + "Format a raw meeting summary text with no line length limit and dashes as bullets." + ] + }, + "tags": [ + "content", + "formatting", + "summary", + "text", + "presentation", + "cleanup" + ], + "examples": [ + { + "inputJson": "{\"rawSummary\":\"project status update includes the following points\\n- schedule on track \\n- budget under review \\n- risks identified\",\"maxLineLength\":60,\"bulletStyle\":\"*\",\"capitalizeFirstLetter\":true,\"trimExtraWhitespace\":true}", + "description": "Formats a project status update summary to 60 chars per line, using '*' bullet points and proper sentence capitalization." + }, + { + "inputJson": "{\"rawSummary\":\"this is a raw summary with inconsistent spacing. it should be cleaned.\",\"maxLineLength\":80,\"bulletStyle\":\"-\",\"capitalizeFirstLetter\":true,\"trimExtraWhitespace\":true}", + "description": "Cleans extra spaces and capitalizes first letters in a short summary with no specific line length wrapping." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Summary", + "context": null + } + }, + { + "name": "content-creation.formatBrief", + "description": "Formats a textual brief document by structuring its sections, applying consistent headings, and ensuring readability. Accepts raw brief text as input, processes it to identify headings, bullet points, and paragraphs, and outputs a cleanly formatted brief suitable for presentation or sharing.", + "category": "content-creation", + "parameters": [ + { + "name": "rawText", + "type": "string", + "description": "The unformatted brief text input to be structured and formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "headingStyle", + "type": "string", + "description": "The style of headings to apply (e.g., 'bold', 'underline', 'uppercase').", + "required": false, + "defaultValue": "bold" + }, + { + "name": "bulletStyle", + "type": "string", + "description": "Type of bullet points to use ('dash', 'asterisk', 'numbered').", + "required": false, + "defaultValue": "dash" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum characters per line for text wrapping and readability.", + "required": false, + "defaultValue": "80" + }, + { + "name": "applyNumbering", + "type": "boolean", + "description": "Whether to number main sections automatically.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted brief text as a single string with applied structure and styles." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to convert raw brief text into a well-structured, easy-to-read document, such as when preparing executive summaries or project briefs. It helps ensure consistent formatting before output or sharing.", + "limitations": "This tool formats the structure and appearance but does not rewrite or summarize the content, and cannot correct factual or grammatical errors.", + "examples": [ + "Format raw project brief text to a polished document with bold headings.", + "Apply numbered sections and dash-style bullet points to a meeting brief.", + "Wrap lines at 60 characters and use uppercase headings for emphasis." + ] + }, + "tags": [ + "formatting", + "document", + "brief", + "content-creation", + "text-processing", + "structure" + ], + "examples": [ + { + "inputJson": "{\"rawText\":\"Project Overview\\nThis project aims to improve user engagement.\\nKey Goals:\\n- Increase retention\\n- Enhance UI\\nTimeline\\nQ1: Research\\nQ2: Design\\nQ3: Development\",\"headingStyle\":\"bold\",\"bulletStyle\":\"dash\",\"maxLineLength\":80,\"applyNumbering\":true}", + "description": "Formats a project brief with bold headings, dash bullets, line wrapping at 80 chars, and numbered sections." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Brief", + "context": null + } + }, + { + "name": "content-creation.formatMinutes", + "description": "Formats raw meeting minutes text into a clean, standardized minutes document. Accepts raw text or JSON segments of notes, processes sections like attendees, agenda, discussions, decisions, and action items, and outputs a well-structured formatted meeting minutes document in text or Markdown format.", + "category": "content-creation", + "parameters": [ + { + "name": "rawMinutes", + "type": "string", + "description": "Raw meeting notes text or JSON string representing meeting segments to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Desired output format style, e.g., 'text', 'markdown', or 'html'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeSections", + "type": "array", + "description": "List of sections to include in the formatted output (e.g., ['attendees','agenda','decisions','actionItems']).", + "required": false, + "defaultValue": "[\"attendees\",\"agenda\",\"discussions\",\"decisions\",\"actionItems\"]" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Date format string to display dates consistently (e.g., 'YYYY-MM-DD').", + "required": false, + "defaultValue": "YYYY-MM-DD" + }, + { + "name": "title", + "type": "string", + "description": "Title to include at the top of the formatted meeting minutes document.", + "required": false, + "defaultValue": "Meeting Minutes" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted meeting minutes as a string under 'formattedMinutes' key, and optionally the used format style under 'formatStyle'." + }, + "aiAgent": { + "useCase": "Use this tool when you have unstructured or semi-structured meeting notes that need to be converted into a professional, readable meeting minutes document for sharing or archiving. It standardizes key sections like attendees, agenda, discussion points, decisions made, and action items into a clear and organized format.", + "limitations": "This tool does not transcribe audio or verify factual content; it relies on the input notes quality. It cannot interpret ambiguous or incomplete notes beyond basic formatting.", + "examples": [ + "Format raw meeting notes text into Markdown meeting minutes.", + "Generate a text-only formatted document from JSON segments of meeting notes.", + "Include only specific sections like attendees and action items in the output." + ] + }, + "tags": [ + "content-creation", + "formatting", + "meeting-minutes", + "document", + "productivity", + "collaboration" + ], + "examples": [ + { + "inputJson": "{\"rawMinutes\":\"Attendees: Alice, Bob\\nAgenda: Project kickoff\\nDiscussion: Reviewed project scope and deliverables.\\nDecisions: Approved timeline \\nAction Items: Bob to create project plan by next week.\",\"formatStyle\":\"markdown\",\"includeSections\":[\"attendees\",\"agenda\",\"discussions\",\"decisions\",\"actionItems\"],\"dateFormat\":\"YYYY-MM-DD\",\"title\":\"Project Kickoff Meeting\"}", + "description": "Formats raw meeting notes into a Markdown structured minutes document including all standard sections." + }, + { + "inputJson": "{\"rawMinutes\":\"{\\\"attendees\\\": [\\\"Alice\\\", \\\"Bob\\\"], \\\"agenda\\\": [\\\"Project kickoff\\\"], \\\"decisions\\\": [\\\"Approved timeline\\\"]}\",\"formatStyle\":\"text\",\"includeSections\":[\"attendees\",\"agenda\",\"decisions\"],\"dateFormat\":\"MM/DD/YYYY\",\"title\":\"Kickoff Meeting\"}", + "description": "Formats meeting notes provided as JSON segments into a plain text minutes document, including only attendees, agenda, and decisions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Minutes", + "context": null + } + }, + { + "name": "content-creation.formatTranscript", + "description": "Formats raw transcript text into well-structured formats such as plain text with timestamps, subtitle files (SRT), or JSON for easier readability or integration. Accepts raw transcript input with optional timestamps and speaker labels, processes formatting according to specified style and output type, and returns the formatted transcript as a string.", + "category": "content-creation", + "parameters": [ + { + "name": "rawTranscript", + "type": "string", + "description": "The raw transcript text input possibly containing timestamps and speaker labels.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: e.g., 'plain' for readable text, 'srt' for subtitles, or 'json' for structured data.", + "required": true, + "defaultValue": "plain" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps in the output when supported by the format.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSpeakerLabels", + "type": "boolean", + "description": "Whether to include speaker labels in the output if present in input, supported by format.", + "required": false, + "defaultValue": "true" + }, + { + "name": "timestampFormat", + "type": "string", + "description": "Format for timestamps if included, e.g., 'HH:MM:SS,ms' for SRT or 'HH:MM:SS' for plain text.", + "required": false, + "defaultValue": "HH:MM:SS" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum characters per line for plain text output to improve readability.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted transcript string under 'formattedTranscript' key and the format used under 'format' key." + }, + "aiAgent": { + "useCase": "Use this tool when raw, unstructured transcript text from audio or video sources needs to be converted into a standardized readable format such as subtitles (SRT), plain readable text, or structured JSON for integration with other applications. Ideal for preparing transcripts for publishing, editing, or subtitle generation.", + "limitations": "Does not perform transcription or speech-to-text itself, only formats existing transcript text. Cannot correct transcription errors or add timestamps if not present in input. Formatting output is limited to supported styles (plain, SRT, JSON).", + "examples": [ + "Format a raw meeting transcript into an SRT subtitle file for video.", + "Convert an interview transcript into readable plain text with timestamps.", + "Generate a JSON structured transcript from raw speaker-labeled text." + ] + }, + "tags": [ + "content-creation", + "transcript", + "formatting", + "subtitle", + "srt", + "text", + "json", + "media" + ], + "examples": [ + { + "inputJson": "{\"rawTranscript\":\"[00:00:01] Speaker 1: Hello, this is the start.\\n[00:00:05] Speaker 2: Hi! Glad to be here.\",\"outputFormat\":\"srt\",\"includeTimestamps\":true,\"includeSpeakerLabels\":true}", + "description": "Convert raw transcript including timestamps and speaker labels into an SRT subtitle format." + }, + { + "inputJson": "{\"rawTranscript\":\"Speaker 1: Welcome everyone to the session. Speaker 2: Thank you!\",\"outputFormat\":\"plain\",\"includeTimestamps\":false,\"includeSpeakerLabels\":true,\"maxLineLength\":50}", + "description": "Format raw transcript into plain readable text without timestamps, preserving speaker labels and wrapping lines to 50 characters." + }, + { + "inputJson": "{\"rawTranscript\":\"[00:00:01] Speaker 1: Good morning.\\n[00:00:04] Speaker 2: Morning!\",\"outputFormat\":\"json\",\"includeTimestamps\":true,\"includeSpeakerLabels\":true}", + "description": "Output transcript as a JSON object including timestamps and speaker labeling for integration with applications." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Transcript", + "context": null + } + }, + { + "name": "content-creation.formatReleaseNotes", + "description": "Formats raw release notes text or structured release information into a clean, professional, and standardized release notes document. Accepts plain text or release data object inputs, processes styling, sections, and versioning info, and outputs formatted markdown or HTML release notes suitable for publication.", + "category": "content-creation", + "parameters": [ + { + "name": "releaseData", + "type": "object", + "description": "Structured release information including version, date, highlights, fixes, and other notes.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the release notes document, e.g., 'markdown' or 'html'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeSections", + "type": "array", + "description": "Array of section names to include like ['Features','Bug Fixes','Known Issues']. If empty, includes all available sections.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeVersionHeader", + "type": "boolean", + "description": "Whether to include version and date header in the formatted output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxEntryLength", + "type": "number", + "description": "Maximum character length allowed per entry, longer entries will be truncated with ellipsis.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted release notes string and metadata such as content type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent receives either raw text or structured data for software release notes and needs to produce a polished, well-structured document in markdown or HTML, suitable for users, stakeholders, or publication on release platforms.", + "limitations": "This tool does not generate release notes content from unstructured changelogs or code diffs; it only formats provided release data or text. It cannot perform natural language summarization or content creation beyond formatting and truncation.", + "examples": [ + "Format a JSON release notes object into markdown, including only Features and Bug Fixes sections.", + "Produce HTML formatted release notes for version 2.1.0, including the version header.", + "Format plain text release notes input, truncating long entries to 300 characters." + ] + }, + "tags": [ + "formatting", + "release notes", + "content creation", + "documentation", + "markdown", + "html" + ], + "examples": [ + { + "inputJson": "{\"releaseData\":{\"version\":\"1.4.2\",\"date\":\"2024-05-20\",\"Features\":[\"Added new dashboard widgets\",\"Improved login security\"],\"Bug Fixes\":[\"Fixed crash on startup\",\"Resolved UI overlap issue\"],\"Known Issues\":[\"Minor delay in notifications\"]},\"outputFormat\":\"markdown\",\"includeSections\":[\"Features\",\"Bug Fixes\"],\"includeVersionHeader\":true,\"maxEntryLength\":500}", + "description": "Formats structured release data into markdown including only Features and Bug Fixes sections with version header." + }, + { + "inputJson": "{\"releaseData\":{\"version\":\"3.0.0\",\"date\":\"2024-06-01\",\"Highlights\":[\"Complete UI overhaul\",\"Performance improvements\"],\"Bug Fixes\":[\"Fixed memory leak in module X\"]},\"outputFormat\":\"html\",\"includeSections\":[],\"includeVersionHeader\":true,\"maxEntryLength\":300}", + "description": "Formats full release notes in HTML, truncating entries longer than 300 characters, including all sections with version header." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "content-creation.formatChangelog", + "description": "This tool accepts a raw changelog text or object representing software release notes, parses and formats it into a standardized, clean, and markdown-compatible changelog document. It supports customizable formatting styles and output as string or JSON object, facilitating consistent release documentation publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "rawChangelog", + "type": "string", + "description": "The raw changelog content as unformatted text or markdown string. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "The version number of the release to include in the changelog header. Optional; leaves header generic if empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "The release date in ISO format (YYYY-MM-DD) to include in the changelog header. Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Specifies the output formatting style (e.g., 'markdown', 'html', 'plaintext'). Defaults to 'markdown'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeSections", + "type": "array", + "description": "An array of changelog sections to include such as ['Added','Changed','Fixed']. If empty or omitted, includes all detected sections.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputType", + "type": "string", + "description": "The output format: 'string' returns formatted changelog text; 'json' returns structured JSON object representing the changelog. Default is 'string'.", + "required": false, + "defaultValue": "string" + } + ], + "returns": { + "type": "object", + "description": "Returns the formatted changelog content as a string or structured JSON object with version, date, and categorized changes depending on outputType." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to transform raw or inconsistently formatted changelog input into a clean, standardized, well-structured changelog document for display, release notes, or publication. Helpful for automating changelog generation in CI/CD pipelines or software documentation workflows.", + "limitations": "Cannot automatically generate changelog content from commit history or tickets; input changelog content must be provided. Does not translate or summarize changelog entries.", + "examples": [ + "Format a raw changelog string into markdown with version and date headers.", + "Generate a JSON structured changelog from raw text showing only 'Added' and 'Fixed' sections.", + "Convert existing changelog to plaintext for plain text release notes." + ] + }, + "tags": [ + "content-creation", + "formatting", + "changelog", + "release-notes", + "documentation", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"rawChangelog\":\"## Added\\n- New login feature\\n## Fixed\\n- Bugfix in user profile\",\"version\":\"1.4.2\",\"releaseDate\":\"2024-06-01\",\"formatStyle\":\"markdown\",\"includeSections\":[],\"outputType\":\"string\"}", + "description": "Formats a simple raw changelog with version and date into markdown string." + }, + { + "inputJson": "{\"rawChangelog\":\"## Added\\n- Dark mode support\\n## Changed\\n- Updated dependencies\",\"formatStyle\":\"plaintext\",\"outputType\":\"string\"}", + "description": "Formats given changelog content into plaintext without version/date header." + }, + { + "inputJson": "{\"rawChangelog\":\"## Fixed\\n- Security patch\",\"version\":\"1.5.0\",\"outputType\":\"json\"}", + "description": "Produces JSON object representing changelog document for version 1.5.0 with only fixed section." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Changelog", + "context": null + } + }, + { + "name": "content-creation.formatBlogPost", + "description": "Formats a raw blog post draft into a polished HTML or Markdown document. Accepts the blog post content and metadata, applies styling options, inserts headers, footers, images, and generates structured output ready for publication or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The raw textual content of the blog post as plain text or lightly formatted markup.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "The title of the blog post to be prominently included in the formatted output.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Author's name to include as metadata or in the byline section.", + "required": false, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Publication date of the blog post, formatted as ISO 8601 string (e.g., 2023-04-20).", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Desired output format for the blog post; supported options: 'html' or 'markdown'.", + "required": true, + "defaultValue": "html" + }, + { + "name": "includeImages", + "type": "boolean", + "description": "Whether to embed or link images referenced within the blog content as part of the formatting.", + "required": false, + "defaultValue": "false" + }, + { + "name": "theme", + "type": "string", + "description": "Styling theme applied to blog post formatting; influences colors, fonts, and layout styles.", + "required": false, + "defaultValue": "default" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted blog post text in the chosen format and metadata including word count and applied styles." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert raw blog draft text and metadata into a clean, publication-ready HTML or Markdown format with consistent styling and optional image embedding. It streamlines preparing posts for websites or content platforms requiring structured formats.", + "limitations": "Does not perform advanced content rewriting, SEO optimization, or plagiarism detection. Limited to formatting and structuring tasks. Does not validate external image URLs or guarantee accessibility compliance.", + "examples": [ + "Format a submitted blog draft from plain text to HTML with byline and date included.", + "Generate a Markdown version of a blog post with embedded images for a static site generator.", + "Apply a custom theme to a blog post text and output as HTML for CMS upload." + ] + }, + "tags": [ + "content-creation", + "formatting", + "blog", + "html", + "markdown", + "publication", + "styling" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Welcome to my new blog! This post covers AI advancements.\",\"title\":\"AI Advancements 2024\",\"author\":\"Jane Doe\",\"date\":\"2024-06-01\",\"format\":\"html\",\"includeImages\":false,\"theme\":\"modern\"}", + "description": "Format a simple AI blog post text into styled HTML including metadata and modern theme." + }, + { + "inputJson": "{\"content\":\"This is a technical post about APIs.\",\"title\":\"Understanding APIs\",\"format\":\"markdown\",\"includeImages\":true}", + "description": "Produce a Markdown blog post that embeds images and includes title with default theme." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "BlogPost", + "context": null + } + }, + { + "name": "content-creation.formatInvoice", + "description": "Formats raw invoice data into a professional, well-structured invoice document in PDF or HTML format. Accepts detailed invoice data including client info, line items, taxes, discounts, and branding elements, and outputs a polished invoice ready for delivery or printing.", + "category": "content-creation", + "parameters": [ + { + "name": "invoiceData", + "type": "object", + "description": "Complete invoice details including client information, itemized charges, taxes, discounts, invoice number, and dates.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the formatted invoice document, either 'PDF' or 'HTML'.", + "required": true, + "defaultValue": "PDF" + }, + { + "name": "includeLogo", + "type": "boolean", + "description": "Whether to include the company logo in the invoice header.", + "required": false, + "defaultValue": "true" + }, + { + "name": "logoUrl", + "type": "string", + "description": "URL of the company logo image to embed if includeLogo is true.", + "required": false, + "defaultValue": "" + }, + { + "name": "currencySymbol", + "type": "string", + "description": "The currency symbol to display alongside monetary amounts (e.g., '$', '€').", + "required": false, + "defaultValue": "$" + }, + { + "name": "language", + "type": "string", + "description": "Language code for localizing date formats and labels in the invoice (e.g., 'en', 'fr').", + "required": false, + "defaultValue": "en" + }, + { + "name": "showTotalsInWords", + "type": "boolean", + "description": "Option to display the invoice total amount also spelled out in words.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted invoice document as a base64 encoded string and metadata such as file type and recommended filename." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert raw structured invoice data from a system or form into a clean, professional invoice document for sending to clients or for record-keeping. Ideal for automated billing pipelines or digital invoicing platforms.", + "limitations": "Cannot generate invoices without all required invoice data fields. Does not handle payment processing or invoice numbering generation by itself. Complex multi-page invoices with very large item lists may affect formatting consistency.", + "examples": [ + "Generate a PDF invoice from raw invoice line items and client details to email a customer.", + "Create an HTML version of the invoice to display in a web portal with company branding.", + "Format invoice data into a PDF including logo and amounts spelled out in words for formal documentation." + ] + }, + "tags": [ + "formatting", + "invoice", + "document", + "PDF", + "HTML", + "billing", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"invoiceData\":{\"invoiceNumber\":\"INV-12345\",\"date\":\"2024-06-01\",\"dueDate\":\"2024-06-15\",\"client\":{\"name\":\"Acme Corp\",\"address\":\"123 Business Rd, Suite 100\"},\"items\":[{\"description\":\"Product A\",\"quantity\":10,\"unitPrice\":15.5},{\"description\":\"Service B\",\"quantity\":5,\"unitPrice\":40}],\"taxRate\":0.07,\"discount\":20},\"outputFormat\":\"PDF\",\"includeLogo\":true,\"logoUrl\":\"https://example.com/logo.png\",\"currencySymbol\":\"$\",\"language\":\"en\",\"showTotalsInWords\":true}", + "description": "Format a complete invoice with line items, tax, and discount into a professional PDF including company logo and amounts in words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Invoice", + "context": null + } + }, + { + "name": "content-creation.formatArticle", + "description": "Formats a raw article text input into a structured and styled HTML or Markdown output. Accepts article content, formatting preferences, and styling options to produce a cleanly formatted article suitable for publishing platforms or web display.", + "category": "content-creation", + "parameters": [ + { + "name": "articleText", + "type": "string", + "description": "The raw article text content to be formatted, including paragraphs and headings.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format for the formatted article, e.g., 'html' or 'markdown'.", + "required": true, + "defaultValue": "\"html\"" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents based on headings in the article.", + "required": false, + "defaultValue": "false" + }, + { + "name": "headingStyle", + "type": "string", + "description": "Style choice for headings, e.g., 'bold', 'underline', or 'default'.", + "required": false, + "defaultValue": "\"default\"" + }, + { + "name": "maxLineWidth", + "type": "number", + "description": "Maximum line width limit for text wrapping in the formatted output (applicable primarily for Markdown).", + "required": false, + "defaultValue": "80" + }, + { + "name": "customCss", + "type": "string", + "description": "Optional custom CSS styles to embed within the HTML output (ignored if outputFormat is Markdown).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted article as a string and metadata about the output format and any warnings or notes." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert plain or semi-structured article text into a well-formatted, stylized article output in HTML or Markdown. It assists in transforming raw content into publication-ready format with options such as table of contents, heading styles, and custom CSS injection.", + "limitations": "Does not perform content editing, grammar checking, or content generation. Focuses only on formatting given text. Complex layout features like multi-column or interactive content are not supported.", + "examples": [ + "Format raw article text into HTML with a table of contents and bold headings.", + "Convert article content into Markdown format with default heading style and a max line width of 100 characters.", + "Format article text into HTML embedding custom CSS for branding styles." + ] + }, + "tags": [ + "formatting", + "content-creation", + "article", + "html", + "markdown", + "text-processing", + "styling" + ], + "examples": [ + { + "inputJson": "{\"articleText\":\"# Introduction\\nThis is the first paragraph.\\n## Subheading\\nMore detailed information.\",\"outputFormat\":\"html\",\"includeTableOfContents\":true,\"headingStyle\":\"bold\",\"maxLineWidth\":80,\"customCss\":\"h1 { color: #2E86C1; }\"}", + "description": "Format a markdown style raw article into HTML with table of contents, bold headings, 80 char line width, and a custom blue heading CSS." + }, + { + "inputJson": "{\"articleText\":\"Introduction\\nThis is the first paragraph.\\nSubheading\\nMore details here.\",\"outputFormat\":\"markdown\",\"includeTableOfContents\":false,\"headingStyle\":\"default\",\"maxLineWidth\":100,\"customCss\":\"\"}", + "description": "Convert plaintext article content into Markdown format with default heading style and no table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Article", + "context": null + } + }, + { + "name": "content-creation.formatEmail", + "description": "Formats raw email content by applying specified style templates, adjusting layout, and optionally adding salutation and signature. Accepts plain text or HTML body, subject, recipient info, and formatting options; outputs a fully formatted email in HTML suitable for sending or previewing.", + "category": "content-creation", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content or body of the email, can be plain text or HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientName", + "type": "string", + "description": "The recipient's name to personalize the salutation, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderName", + "type": "string", + "description": "The sender's name to include in the signature or closing line.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to append a standard signature block at the end of the email.", + "required": false, + "defaultValue": "false" + }, + { + "name": "signatureText", + "type": "string", + "description": "Custom signature text to include if includeSignature is true; overrides default signature if provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "The email formatting style to apply, such as 'professional', 'casual', 'marketing', or 'newsletter'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "includeSalutation", + "type": "boolean", + "description": "Whether to prepend a salutation line addressing the recipient by name if given.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted email body in HTML format and the finalized subject line." + }, + "aiAgent": { + "useCase": "Use this tool when generating or refining email messages that require professional and consistent formatting, including templating of salutations, signatures, and style adjustments. Ideal for automating email communications to customers, partners, or teams where style uniformity and personalization are needed.", + "limitations": "This tool does not send emails or handle email protocol. It only formats the email content for display or sending via other systems. Complex dynamic content or inline media embedding is unsupported.", + "examples": [ + "Format a sales outreach email with a casual style and include a custom signature.", + "Generate a professional newsletter email body with default styling and standard signature.", + "Create a reminder email with recipient name in salutation and no signature." + ] + }, + "tags": [ + "content-creation", + "email", + "formatting", + "communication", + "templating", + "automation" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Meeting Agenda Update\",\"body\":\"Please find the updated agenda for tomorrow's meeting attached.\",\"recipientName\":\"Alice\",\"senderName\":\"Bob\",\"includeSignature\":true,\"signatureText\":\"Best regards, Bob Smith\\nCompany Inc.\",\"formatStyle\":\"professional\",\"includeSalutation\":true}", + "description": "Format a professional meeting email with personalized salutation and custom signature." + }, + { + "inputJson": "{\"subject\":\"Don't Miss Our Summer Sale!\",\"body\":\"Huge discounts on all products this week only. Shop now!\",\"recipientName\":\"\",\"senderName\":\"Marketing Team\",\"includeSignature\":false,\"formatStyle\":\"marketing\",\"includeSalutation\":false}", + "description": "Format a marketing promotional email with no salutation or signature for mass distribution." + }, + { + "inputJson": "{\"subject\":\"Quick Reminder\",\"body\":\"Just a quick reminder about the deadline next Monday.\",\"recipientName\":\"John\",\"senderName\":\"Sarah\",\"includeSignature\":true,\"signatureText\":\"\",\"formatStyle\":\"casual\",\"includeSalutation\":true}", + "description": "Format a casual reminder email including default signature and personalized greeting." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Email", + "context": null + } + }, + { + "name": "content-creation.formatResume", + "description": "Formats a resume provided as structured JSON data according to a specified style template (e.g., chronological, functional, hybrid). Accepts resume details including personal info, experience, education, and skills. Returns a formatted resume as a styled text string or PDF-ready output.", + "category": "content-creation", + "parameters": [ + { + "name": "resumeData", + "type": "object", + "description": "Structured JSON object containing resume details like personal information, work experience, education, skills, and certifications.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "Desired resume format style, such as 'chronological', 'functional', or 'hybrid' to structure the content accordingly.", + "required": true, + "defaultValue": "chronological" + }, + { + "name": "includeSections", + "type": "array", + "description": "List of resume sections to include, e.g., ['summary','experience','education','skills']. Determines which sections appear in the formatted resume.", + "required": false, + "defaultValue": "[\"summary\",\"experience\",\"education\",\"skills\"]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format of the formatted resume. Options include 'text' for plain formatted text or 'pdf' for PDF-ready content.", + "required": false, + "defaultValue": "text" + }, + { + "name": "highlightSkills", + "type": "boolean", + "description": "Whether to emphasize or visually highlight skills in the formatted resume (applicable for text and some PDF styles).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted resume as a string in the requested output format, along with metadata like page count for PDF." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert raw structured resume data into a professional, well-organized resume document, formatted per common industry styles. Ideal for automated resume building, batch formatting, or tailoring resumes to specific job applications.", + "limitations": "Does not perform resume content analysis or optimization beyond formatting. Cannot create resume data from unstructured input. Limited to predefined style templates.", + "examples": [ + "Format a chronological resume as plain text including all standard sections.", + "Generate a PDF formatted functional style resume highlighting skills section.", + "Create a hybrid resume excluding the summary section in text format." + ] + }, + "tags": [ + "content-creation", + "resume", + "formatting", + "document", + "career", + "pdf", + "text" + ], + "examples": [ + { + "inputJson": "{\"resumeData\":{\"personalInfo\":{\"name\":\"Jane Doe\",\"email\":\"jane@example.com\"},\"experience\":[{\"company\":\"ACME Corp\",\"position\":\"Engineer\",\"startDate\":\"2019-01\",\"endDate\":\"2022-06\",\"details\":\"Worked on systems.\"}],\"education\":[{\"school\":\"State University\",\"degree\":\"BSc Computer Science\",\"year\":\"2018\"}],\"skills\":[\"JavaScript\",\"Leadership\"]},\"formatStyle\":\"chronological\",\"includeSections\":[\"personalInfo\",\"experience\",\"education\",\"skills\"],\"outputFormat\":\"text\",\"highlightSkills\":false}", + "description": "Format a standard chronological resume as plain text including all key sections." + }, + { + "inputJson": "{\"resumeData\":{\"personalInfo\":{\"name\":\"John Smith\",\"email\":\"johnsmith@email.com\"},\"experience\":[{\"company\":\"Tech Solutions\",\"position\":\"Developer\",\"startDate\":\"2015-05\",\"endDate\":\"2020-08\",\"details\":\"Developed web apps.\"}],\"education\":[{\"school\":\"Tech Institute\",\"degree\":\"MSc Information Technology\",\"year\":\"2015\"}],\"skills\":[\"React\",\"Project Management\"]},\"formatStyle\":\"functional\",\"includeSections\":[\"personalInfo\",\"skills\",\"education\"],\"outputFormat\":\"pdf\",\"highlightSkills\":true}", + "description": "Generate a PDF functional resume highlighting skills and excluding experience details." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Resume", + "context": null + } + }, + { + "name": "content-creation.formatReport", + "description": "Formats a textual report document according to specified style guidelines. Accepts raw report content and customizable formatting options such as font style, font size, margins, header/footer text, and output file format. Produces a finalized, styled report document ready for printing or digital distribution.", + "category": "content-creation", + "parameters": [ + { + "name": "reportContent", + "type": "string", + "description": "The raw textual content of the report to be formatted, including sections, paragraphs, and data.", + "required": true, + "defaultValue": "" + }, + { + "name": "fontName", + "type": "string", + "description": "The desired font family to apply throughout the report (e.g., Arial, Times New Roman).", + "required": false, + "defaultValue": "Times New Roman" + }, + { + "name": "fontSize", + "type": "number", + "description": "The size of the font to use in points.", + "required": false, + "defaultValue": "12" + }, + { + "name": "marginInches", + "type": "object", + "description": "Margin sizes in inches for the report page. Should include top, bottom, left, and right keys.", + "required": false, + "defaultValue": "{\"top\":1,\"bottom\":1,\"left\":1,\"right\":1}" + }, + { + "name": "includeHeaderFooter", + "type": "boolean", + "description": "Whether to include header and footer sections in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "headerText", + "type": "string", + "description": "Custom text to appear in the header if headers are included.", + "required": false, + "defaultValue": "" + }, + { + "name": "footerText", + "type": "string", + "description": "Custom text to appear in the footer if footers are included.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The file format for the output report document (e.g., PDF, DOCX).", + "required": false, + "defaultValue": "PDF" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted report document as a base64-encoded string along with metadata such as filename and mime type." + }, + "aiAgent": { + "useCase": "Use this tool when you need to transform raw textual report content into a professional, visually consistent document with standardized formatting for sharing, printing, or archiving. It helps apply common styling conventions and outputs the result in popular document formats.", + "limitations": "This tool does not perform content analysis, summarization, or generate report content. It also doesn't support highly customized layout designs or complex interactive elements like tables of contents or embedded multimedia.", + "examples": [ + "Format a quarterly sales report with Times New Roman font, 12pt, one-inch margins, including company header and page number footer, output as PDF.", + "Convert raw text notes of a research summary into a formatted document using Arial font, 11pt, with custom header and footer text, output as DOCX." + ] + }, + "tags": [ + "content-creation", + "document-formatting", + "report", + "PDF", + "DOCX", + "text-styling" + ], + "examples": [ + { + "inputJson": "{\"reportContent\":\"Executive Summary:\\nThis quarter we achieved record growth...\",\"fontName\":\"Arial\",\"fontSize\":11,\"marginInches\":{\"top\":1,\"bottom\":1,\"left\":1,\"right\":1},\"includeHeaderFooter\":true,\"headerText\":\"Company Confidential\",\"footerText\":\"Page 1\",\"outputFormat\":\"PDF\"}", + "description": "Format an executive summary report in Arial 11pt with headers and footers for confidential distribution." + }, + { + "inputJson": "{\"reportContent\":\"Research Findings:\\nThe experiment yielded significant results...\",\"fontName\":\"Calibri\",\"fontSize\":12,\"marginInches\":{\"top\":1.25,\"bottom\":1.25,\"left\":1,\"right\":1},\"includeHeaderFooter\":false,\"outputFormat\":\"DOCX\"}", + "description": "Format a research findings report in Calibri 12pt without headers/footers, using slightly larger top and bottom margins." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.formatContract", + "description": "Formats a contract document by accepting raw contract text along with optional formatting options such as style templates, font sizes, and clause ordering rules. It processes the input by applying consistent styles, organizing clauses logically, and ensuring professional document structure. The output is a fully formatted contract ready for review or signing as a text string or a structured document object.", + "category": "content-creation", + "parameters": [ + { + "name": "contractText", + "type": "string", + "description": "The raw unformatted contract text that needs to be processed and structured into a properly formatted document.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleTemplate", + "type": "string", + "description": "Optional style template name to apply specific fonts, headings, and paragraph styles.", + "required": false, + "defaultValue": "Standard" + }, + { + "name": "fontSize", + "type": "number", + "description": "Base font size (in points) to use throughout the contract for consistent appearance.", + "required": false, + "defaultValue": "12" + }, + { + "name": "clauseOrder", + "type": "array", + "description": "An optional ordered list of clause titles specifying the sequence in which clauses should appear.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Flag to determine whether to generate a table of contents at the beginning of the contract.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output document format, e.g., 'text', 'markdown', or 'json' structured format.", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted contract document as a string or structured data depending on the output format, plus metadata such as applied style and document length." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to convert raw contract text into a professionally formatted legal document for presentation, review, or digital signing. Helpful in scenarios where consistent styling, clause organization, and optional additions like a table of contents improve readability and legal clarity.", + "limitations": "Cannot interpret or validate contract legal content for compliance; does not create contract text but only formats provided input.", + "examples": [ + "Format a raw service agreement text into a styled contract with a table of contents.", + "Apply corporate branding style to an NDA contract and reorder clauses per company standards.", + "Convert a plain text lease contract into markdown format for online publication." + ] + }, + "tags": [ + "content-creation", + "document-formatting", + "legal", + "contract", + "text-processing", + "formatting", + "document-management" + ], + "examples": [ + { + "inputJson": "{\"contractText\":\"This Agreement is made on... Section 1 Definitions... Section 2 Obligations...\",\"styleTemplate\":\"Corporate\",\"fontSize\":11,\"clauseOrder\":[\"Definitions\",\"Obligations\",\"Termination\"],\"includeTableOfContents\":true,\"outputFormat\":\"text\"}", + "description": "Formatting a corporate style contract with clause reordering and TOC." + }, + { + "inputJson": "{\"contractText\":\"Lease Contract... Parties... Terms...\",\"styleTemplate\":\"Standard\",\"fontSize\":12,\"includeTableOfContents\":false,\"outputFormat\":\"markdown\"}", + "description": "Formatting a lease contract into markdown without a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Contract", + "context": null + } + }, + { + "name": "content-creation.draftReference", + "description": "Generates a well-formatted academic or professional reference entry based on provided bibliographic details. Accepts parameters like author(s), title, publication year, source type, and more; processes them into a standardized citation string formatted in styles such as APA, MLA, or Chicago. Outputs the formatted reference ready for inclusion in documents or bibliographies.", + "category": "content-creation", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of authors for the reference, each as a string in 'Last, First' format.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work cited, e.g., book, article, or webpage title.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the work was published.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source, such as 'book', 'journal', 'website', 'conference paper'.", + "required": true, + "defaultValue": "book" + }, + { + "name": "publisher", + "type": "string", + "description": "Publisher name, relevant for book or report sources.", + "required": false, + "defaultValue": "" + }, + { + "name": "journalName", + "type": "string", + "description": "Name of the journal or magazine if sourceType is 'journal'.", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number for journal articles or multi-volume works.", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number of the journal if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page range of article or chapter, e.g., '23-45'.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL if the source is online or digital.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the online source was accessed, in ISO format YYYY-MM-DD.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The desired citation style (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'formattedReference' with the complete formatted citation string." + }, + "aiAgent": { + "useCase": "This tool helps generate properly formatted reference entries for academic papers, reports, or professional documents from structured bibliographic input. AI agents use it to automate citation creation ensuring consistency and adherence to style guides like APA, MLA, or Chicago when drafting content or assembling bibliographies.", + "limitations": "This tool cannot verify the accuracy of bibliographic data or access external databases to retrieve missing information; it formats only the supplied input. It also does not handle complex citation nuances such as legal or patent references.", + "examples": [ + "Draft an APA style reference for a journal article by two authors published in 2020.", + "Create an MLA citation for a book authored by a single author published by a known publisher.", + "Generate a Chicago style reference for a webpage with a URL and access date." + ] + }, + "tags": [ + "content-creation", + "citation", + "reference", + "academic", + "bibliography", + "formatting", + "drafting" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Innovations in AI\",\"publicationYear\":2020,\"sourceType\":\"journal\",\"journalName\":\"Journal of AI Research\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"134-150\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA citation for a journal article with two authors published in 2020." + }, + { + "inputJson": "{\"authors\":[\"Brown, Alice\"],\"title\":\"Modern Web Design\",\"publicationYear\":2018,\"sourceType\":\"book\",\"publisher\":\"Tech Press\",\"citationStyle\":\"MLA\"}", + "description": "Create an MLA citation for a book by a single author." + }, + { + "inputJson": "{\"authors\":[\"Green, Sarah\"],\"title\":\"Understanding Cloud Computing\",\"sourceType\":\"website\",\"url\":\"https://cloud.example.com/overview\",\"accessDate\":\"2023-11-05\",\"citationStyle\":\"Chicago\"}", + "description": "Generate a Chicago style reference for a webpage with URL and access date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Reference", + "context": null + } + }, + { + "name": "content-creation.draftCitation", + "description": "Generates a properly formatted citation string based on provided bibliographic details and citation style. Accepts input fields like author(s), title, publication year, source type, and optional details like volume and pages. Outputs a citation string formatted accordingly (e.g., APA, MLA, Chicago).", + "category": "content-creation", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of author names in 'Last, First' format; multiple authors supported.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "title", + "type": "string", + "description": "The title of the work being cited (article, book, etc.).", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the work was published or released.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source, e.g., 'book', 'journalArticle', 'website'.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationTitle", + "type": "string", + "description": "Name of journal, book publisher, or website, depending on source.", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number of the journal or book series, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number of the journal, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page range for articles or chapters, e.g., '23-45'.", + "required": false, + "defaultValue": "" + }, + { + "name": "doiOrUrl", + "type": "string", + "description": "Digital Object Identifier (DOI) or URL for online sources.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format output (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "Returns a single string field 'citation' containing the formatted citation text." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate accurate and properly formatted citations for academic or professional documents based on structured bibliographic details. It standardizes citation creation according to a specified style, saving manual formatting effort.", + "limitations": "Does not verify the correctness of bibliographic data nor fetch missing metadata automatically. Limited to common citation styles and may not cover all edge cases, such as unusual source types or complex multi-author rules.", + "examples": [ + "Generate an APA citation for a journal article with multiple authors.", + "Create a Chicago-style citation for a book with publisher info.", + "Draft an MLA citation for a website source including a URL." + ] + }, + "tags": [ + "citation", + "content-creation", + "academic", + "formatting", + "bibliography", + "reference", + "APA", + "MLA", + "Chicago" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Innovations in AI\",\"publicationYear\":2022,\"sourceType\":\"journalArticle\",\"publicationTitle\":\"Journal of AI Research\",\"volume\":\"15\",\"issue\":\"3\",\"pages\":\"123-145\",\"doiOrUrl\":\"10.1234/jair.2022.01503\",\"citationStyle\":\"APA\"}", + "description": "Drafts an APA citation for a journal article with two authors, volume, issue, pages, and DOI." + }, + { + "inputJson": "{\"authors\":[\"Brown, Lisa\"],\"title\":\"Understanding Modern Art\",\"publicationYear\":2018,\"sourceType\":\"book\",\"publicationTitle\":\"Modern Art Press\",\"citationStyle\":\"Chicago\"}", + "description": "Creates a Chicago-style citation for a book with a single author, publisher, and year." + }, + { + "inputJson": "{\"authors\":[],\"title\":\"Climate Change Effects\",\"publicationYear\":2020,\"sourceType\":\"website\",\"publicationTitle\":\"Environmental News\",\"doiOrUrl\":\"https://envnews.org/climate-change-effects\",\"citationStyle\":\"MLA\"}", + "description": "Generates an MLA citation for a website article without authors but with a URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.formatProposal", + "description": "Formats a textual proposal document into a structured, professional layout suitable for presentations or submissions. Accepts raw proposal text and optional formatting preferences, applies consistent styles like headings, bullet points, and sections, then outputs a formatted document in Markdown or HTML format.", + "category": "content-creation", + "parameters": [ + { + "name": "proposalText", + "type": "string", + "description": "Raw textual content of the proposal to be formatted, including all sections and paragraphs.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "string", + "description": "The desired output format style, e.g., 'markdown' or 'html'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate a table of contents based on proposal headings.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum number of characters per line for text wrapping, if applicable.", + "required": false, + "defaultValue": "80" + }, + { + "name": "highlightKeywords", + "type": "array", + "description": "List of keywords or phrases to emphasize in the formatted proposal, e.g., bold or italicize.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted proposal document in the specified format." + }, + "aiAgent": { + "useCase": "Use this tool when you have an unstructured or semi-structured proposal text that needs consistent formatting into a professional document format for sharing, reviewing or publishing. This helps convert plain text into readable, well-organized documents with sections and lists clearly styled.", + "limitations": "This tool does not generate or verify proposal content; it only formats provided text. It cannot create graphics or handle complex visual layouts outside basic Markdown or HTML styling.", + "examples": [ + "Format a raw proposal text into Markdown with a table of contents.", + "Convert a plain text proposal into HTML with keyword highlights.", + "Wrap lines at 100 characters while formatting a proposal." + ] + }, + "tags": [ + "content-creation", + "formatting", + "proposal", + "document", + "markdown", + "html", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"proposalText\":\"# Project Proposal\\n\\nThis project aims to develop an AI tool.\\n\\n## Objectives\\n- Automate document formatting\\n- Improve readability\\n\\n## Timeline\\nThe project will span 6 months.\",\"formatStyle\":\"markdown\",\"includeTableOfContents\":true,\"maxLineLength\":80,\"highlightKeywords\":[\"AI tool\",\"document formatting\"]}", + "description": "Formats a markdown proposal with headings, bullet points, a TOC, and highlights specified keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Proposal", + "context": null + } + }, + { + "name": "content-creation.formatDocument", + "description": "This tool takes raw text or document content as input along with formatting instructions or style guidelines, applies the specified formatting (such as headings, lists, fonts, alignments, and styles), and outputs a neatly formatted document in the desired output format like HTML, Markdown, or plain text. It streamlines document presentation based on user-defined style parameters.", + "category": "content-creation", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The raw text or document content to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatStyle", + "type": "object", + "description": "An object defining the formatting rules such as font size, headings, bullet points, bold, italic, alignment, and paragraph spacing.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format of the formatted document (e.g., 'html', 'markdown', 'plainText').", + "required": true, + "defaultValue": "html" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents in the document if applicable.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineWidth", + "type": "number", + "description": "Maximum number of characters per line for text wrapping in plain text output.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted document content as a string and the format type." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert raw or minimally formatted document content into a polished, styled document that adheres to specific formatting rules or style guides. It's especially useful for generating clean readable outputs for reports, articles, or documentation in various output formats.", + "limitations": "This tool does not perform content generation, grammar correction, or semantic analysis. It only applies structural and stylistic formatting based on provided instructions. It cannot handle complex layouts like multi-column pages or embedded media beyond text formatting.", + "examples": [ + "Format a raw article text into Markdown with headings and bullet lists.", + "Convert plain text meeting notes into an HTML report styled with company branding.", + "Apply specified font style and alignment to a document and output as plain text with line wrapping." + ] + }, + "tags": [ + "formatting", + "document", + "content creation", + "text styling", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Meeting notes:\\n- Discuss project timeline\\n- Assign tasks\",\"formatStyle\":{\"heading\":{\"level\":2,\"bold\":true},\"list\":{\"type\":\"bullet\"}},\"outputFormat\":\"markdown\",\"includeTableOfContents\":false,\"maxLineWidth\":80}", + "description": "Format meeting notes into Markdown with bold level 2 heading and bullet list." + }, + { + "inputJson": "{\"content\":\"Report Summary:\\nThis report outlines the quarterly results.\",\"formatStyle\":{\"paragraph\":{\"alignment\":\"justify\",\"fontSize\":12},\"heading\":{\"level\":1,\"underline\":true}},\"outputFormat\":\"html\",\"includeTableOfContents\":true}", + "description": "Format a summary report into HTML with justified paragraphs, underlined heading, and a table of contents included." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "format", + "object": "Document", + "context": null + } + }, + { + "name": "content-creation.draftQuote", + "description": "Generates a concise, well-formulated quote or inspirational statement based on a specified topic, author style mimic, or theme. Accepts keywords or themes as input, applies natural language generation techniques to produce a creative and meaningful quote, and returns the drafted text suitable for content creation or social media use.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the quote (e.g., 'perseverance', 'love', 'technology').", + "required": true, + "defaultValue": "" + }, + { + "name": "authorStyle", + "type": "string", + "description": "Optional. The name of a famous author or historical figure to mimic their style in the quote (e.g., 'Shakespeare', 'Einstein').", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Optional. Approximate desired length of the quote in words. Defaults to 15.", + "required": false, + "defaultValue": "15" + }, + { + "name": "includeCitation", + "type": "boolean", + "description": "Optional. Whether to include a generated citation or attribution if mimicking a famous author. Defaults false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Optional. Language code for the quote output (e.g., 'en' for English). Defaults to English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted quote text and optional citation information if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create original and creative quotes or aphorisms based on given topics or themes, especially for content creation, marketing materials, social media posts, or inspirational messaging. It helps generate stylistically unique quotes that suit specified author styles or remain neutral.", + "limitations": "The tool generates synthetic quotes and does not fetch actual existing quotes. Citation or author mimicry is stylistic and may not produce authentic historical quotes. Output quality depends on the clarity and specificity of input parameters.", + "examples": [ + "Draft a quote about resilience in the style of Maya Angelou.", + "Create an inspirational technology-related quote approximately 12 words long.", + "Generate a short love quote in English without author style." + ] + }, + "tags": [ + "content creation", + "quote generation", + "inspiration", + "text synthesis", + "creative writing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"resilience\",\"authorStyle\":\"Maya Angelou\",\"length\":20,\"includeCitation\":true,\"language\":\"en\"}", + "description": "Draft a 20-word inspirational quote about resilience mimicking Maya Angelou's style, with citation." + }, + { + "inputJson": "{\"topic\":\"technology\",\"length\":12,\"includeCitation\":false,\"language\":\"en\"}", + "description": "Create a concise 12-word quote related to technology without author style or citation." + }, + { + "inputJson": "{\"topic\":\"love\",\"language\":\"en\"}", + "description": "Generate a short neutral quote about love in English." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Quote", + "context": null + } + }, + { + "name": "content-creation.draftLink", + "description": "Generates a well-structured hyperlink HTML snippet or Markdown link based on provided URL, link text, and optional attributes such as title and CSS class. Accepts raw URL and descriptive text, processes them into a finalized link format ready for embedding in digital content.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The target URL the link should point to.", + "required": true, + "defaultValue": "" + }, + { + "name": "linkText", + "type": "string", + "description": "The visible text for the link.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title attribute text for the link, shown on hover.", + "required": false, + "defaultValue": "" + }, + { + "name": "cssClass", + "type": "string", + "description": "Optional CSS class attribute to style the link.", + "required": false, + "defaultValue": "" + }, + { + "name": "useMarkdown", + "type": "boolean", + "description": "Flag indicating if the output should be Markdown (true) or HTML (false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the final formatted link string in the specified markup format." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate link elements from raw URL and descriptive text for embedding in content, blog posts, or web pages, supporting both HTML and Markdown outputs to fit different publishing platforms.", + "limitations": "It cannot validate URL accessibility or correctness beyond basic syntax; it also does not automatically shorten URLs or handle complex link embedding scenarios such as dynamic parameters or tracking codes.", + "examples": [ + "Create an HTML anchor link with a tooltip title for a news article.", + "Generate a Markdown link for a documentation page using the given URL and text.", + "Produce a styled HTML link with a provided CSS class for a marketing email." + ] + }, + "tags": [ + "content", + "link", + "html", + "markdown", + "drafting", + "web", + "urls" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://www.example.com\",\"linkText\":\"Example Website\",\"title\":\"Visit Example\",\"cssClass\":\"external-link\",\"useMarkdown\":false}", + "description": "Generate a styled HTML link with title and CSS class" + }, + { + "inputJson": "{\"url\":\"https://docs.example.com\",\"linkText\":\"Documentation\",\"title\":\"Official Docs\",\"cssClass\":\"\",\"useMarkdown\":true}", + "description": "Create a Markdown formatted link with title as optional attribute ignored since Markdown does not support it" + }, + { + "inputJson": "{\"url\":\"https://news.example.com/article\",\"linkText\":\"Latest News\",\"title\":\"Read the latest news article\",\"cssClass\":\"news-link\",\"useMarkdown\":false}", + "description": "Produce an HTML anchor tag for a news article link with styling and title attribute" + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.draftHeading", + "description": "Generates a concise and relevant heading for a piece of content based on the provided topic, keywords, tone, and intended audience. Takes user inputs to produce a clear, engaging heading suitable for articles, blog posts, or documents.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the content for which a heading is needed.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of important keywords to include or emphasize in the heading.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the heading, e.g., formal, casual, professional, humorous.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience description to tailor the heading appropriately.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the heading in number of characters.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated heading text and metadata like length and keywords used." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate an engaging, contextually relevant heading for digital content such as articles, blog posts, or reports, ensuring it matches the topic, tone, and audience specified.", + "limitations": "Does not generate multi-level headings or subheadings; focuses only on a single, primary heading. It cannot guarantee SEO optimization beyond keyword inclusion.", + "examples": [ + "Generate a formal heading for a blog about sustainable living including the keyword 'eco-friendly'.", + "Draft a casual heading for a tech article aimed at beginners about AI advancements.", + "Create a short professional heading for a report on quarterly financial results." + ] + }, + "tags": [ + "content", + "heading", + "drafting", + "writing", + "headline", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of regular exercise\",\"keywords\":[\"health\",\"fitness\"],\"tone\":\"formal\",\"audience\":\"general public\",\"maxLength\":50}", + "description": "Generate a formal heading for an article on the health benefits of regular exercise targeting general readers." + }, + { + "inputJson": "{\"topic\":\"latest smartphone trends\",\"keywords\":[\"technology\",\"gadgets\"],\"tone\":\"casual\",\"audience\":\"tech enthusiasts\",\"maxLength\":60}", + "description": "Draft a casual heading for tech enthusiasts about the newest trends in smartphones." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.draftWord", + "description": "Generates a draft paragraph or short text segment focused on a given word or keyword. Accepts a core word and optional parameters such as tone, style, and context to create a coherent, contextually relevant draft output useful as a starting point for articles, marketing copy, or stories.", + "category": "content-creation", + "parameters": [ + { + "name": "word", + "type": "string", + "description": "The main word or keyword around which the draft content will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The emotional tone or mood of the draft (e.g., formal, casual, optimistic).", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "style", + "type": "string", + "description": "The writing style to adopt, such as descriptive, persuasive, or narrative.", + "required": false, + "defaultValue": "general" + }, + { + "name": "context", + "type": "string", + "description": "Brief background or setting information to give context to the word for more relevant content.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words or tokens to generate in the draft. Limits length of output.", + "required": false, + "defaultValue": "100" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted text segment associated with the input word, including metadata about tone and style used." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to create a first draft or idea expansion centered on a specific word or keyword. It helps rapidly produce thematic content snippets that can be further refined or expanded, particularly in content generation pipelines for blogging, marketing, or creative writing.", + "limitations": "The tool generates initial drafts only and may not produce polished or finalized text. It cannot ensure factual accuracy or complex logical structuring beyond short paragraphs.", + "examples": [ + "Draft a formal paragraph about 'innovation' with an optimistic tone.", + "Create a casual, narrative style draft around the word 'beach'.", + "Generate a short persuasive text centered on the keyword 'sustainability'." + ] + }, + "tags": [ + "content creation", + "writing", + "drafting", + "copywriting", + "text generation", + "creative writing" + ], + "examples": [ + { + "inputJson": "{\"word\":\"innovation\",\"tone\":\"optimistic\",\"style\":\"formal\",\"context\":\"technology industry\",\"maxLength\":80}", + "description": "Generate a formal, optimistic draft about 'innovation' within the technology industry context." + }, + { + "inputJson": "{\"word\":\"beach\",\"tone\":\"casual\",\"style\":\"narrative\",\"maxLength\":50}", + "description": "Create a casual narrative-style paragraph focused on the word 'beach'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.draftReadme", + "description": "Generates a well-structured README.md draft for software projects based on provided project details, including description, installation instructions, usage examples, and other relevant documentation sections. Accepts project metadata and outputs a formatted markdown string ready for review and use.", + "category": "content-creation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to be documented.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief description summarizing the purpose and features of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions on how to install or set up the project. Markdown formatting allowed.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "string", + "description": "Code snippets or textual examples demonstrating how to use the project. Markdown formatting allowed.", + "required": false, + "defaultValue": "" + }, + { + "name": "apiReference", + "type": "string", + "description": "Optional details about APIs or important interfaces provided by the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Guidelines for contributing to the project, including how to submit issues and pull requests.", + "required": false, + "defaultValue": "" + }, + { + "name": "licenseInfo", + "type": "string", + "description": "Information about the project license (e.g., MIT, GPL).", + "required": false, + "defaultValue": "" + }, + { + "name": "contactInformation", + "type": "string", + "description": "Contact details or links for users to reach project maintainers or support.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single field 'readmeContent' which is a complete README.md text in markdown format, ready to be used or further edited." + }, + "aiAgent": { + "useCase": "Use this tool when a clear and structured README file draft is needed to document a software project rapidly. This is especially useful for automating initial documentation creation from basic project data provided by a developer or team. The tool helps standardize README format and content for clarity and completeness.", + "limitations": "The generated README is a draft and may require manual refinement and validation for accuracy, completeness, and project-specific details not provided in input. It does not execute code or verify information correctness.", + "examples": [ + "Create a README draft for a new open source JavaScript library with installation instructions and usage examples.", + "Generate a README including contribution and license info for an internal tool.", + "Draft a minimal README with just project name and description when limited info is available." + ] + }, + "tags": [ + "content creation", + "documentation", + "README", + "markdown", + "software project", + "automation", + "developer tool" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"AwesomeLib\",\"projectDescription\":\"A JavaScript library for awesome animations.\",\"installationInstructions\":\"npm install awesomelib\",\"usageExamples\":\"import { animate } from 'awesomelib';\\nanimate('#element');\",\"contributionGuidelines\":\"Please open issues for bugs or feature requests.\",\"licenseInfo\":\"MIT License\",\"contactInformation\":\"email: dev@awesomelib.org\"}", + "description": "Generates a README draft for a JavaScript library with common sections filled." + }, + { + "inputJson": "{\"projectName\":\"DataCruncher\",\"projectDescription\":\"A Python tool to process and analyze large datasets efficiently.\"}", + "description": "Creates a minimal README draft with project name and description only." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Readme", + "context": null + } + }, + { + "name": "content-creation.draftText", + "description": "Generates a draft text based on a given prompt, desired length, tone, and target audience. Accepts parameters to tailor the writing style and content focus, then produces a coherent, contextually relevant draft suitable for further editing or publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "The initial idea or topic to base the draft text on.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the draft text in words.", + "required": false, + "defaultValue": "300" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone or style of the text, e.g., formal, casual, persuasive, neutral.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor content accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action at the end of the draft text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords to emphasize or include in the draft text for SEO or focus.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated draft text and metadata such as word count." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce initial content drafts on specified topics with customizable length, tone, and audience focus, enabling fast content generation for blogs, marketing, or documentation.", + "limitations": "Cannot guarantee final text quality or factual accuracy; drafts may require human review and editing; limited to text generation and not detailed domain-specific expertise.", + "examples": [ + "Draft a 500-word persuasive blog post on renewable energy for general audience.", + "Create a formal 200-word summary about a new software feature.", + "Generate a casual product description including specified keywords and a call to action." + ] + }, + "tags": [ + "content generation", + "text drafting", + "copywriting", + "AI writing", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"The benefits of meditation for mental health.\",\"length\":400,\"tone\":\"informative\",\"targetAudience\":\"general public\",\"includeCallToAction\":false,\"keywords\":[\"meditation\",\"mental health\",\"wellness\"]}", + "description": "Generate an informative 400-word draft about meditation's benefits for a general audience without call to action." + }, + { + "inputJson": "{\"prompt\":\"Introducing our new eco-friendly water bottle.\",\"length\":150,\"tone\":\"casual\",\"targetAudience\":\"outdoor enthusiasts\",\"includeCallToAction\":true,\"keywords\":[\"eco-friendly\",\"water bottle\",\"sustainability\"]}", + "description": "Create a casual promotional draft with call to action targeting outdoor enthusiasts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.draftBrief", + "description": "This tool drafts a concise business or project brief based on provided inputs such as purpose, target audience, key objectives, and background information. It processes the inputs to generate a structured, clear brief suitable for internal or client review.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "Title of the brief document, summarizing the project or topic.", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Main purpose or goal of the brief, explaining why it is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the brief, e.g., internal team, stakeholders, clients.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyObjectives", + "type": "array", + "description": "List of key objectives or goals that the project or initiative aims to achieve.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "background", + "type": "string", + "description": "Background information or context relevant to the project or topic of the brief.", + "required": false, + "defaultValue": "" + }, + { + "name": "deadline", + "type": "string", + "description": "Deadline or timeframe for the project or brief delivery in ISO date format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone for the brief content, e.g., formal, casual, persuasive.", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated brief including title, executive summary, objectives, and background sections as a single formatted string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to help draft a structured project or business brief based on user-provided key details to save time and ensure clarity. Ideal for generating summaries to guide team alignment or client communication.", + "limitations": "Cannot replace specialized domain expertise or generate highly technical content without sufficient detailed input from the user. The quality depends on completeness and clarity of inputs.", + "examples": [ + "Draft a brief for a new marketing campaign targeting millennials to increase brand awareness.", + "Create a project brief summarizing objectives and deadlines for a software development initiative.", + "Prepare a client presentation brief explaining project background and expected outcomes." + ] + }, + "tags": [ + "content-creation", + "drafting", + "brief", + "business", + "project", + "summary", + "document" + ], + "examples": [ + { + "inputJson": "{\"title\":\"New Product Launch\",\"purpose\":\"To inform the marketing team about the upcoming product and align on goals.\",\"targetAudience\":\"Marketing department and stakeholders\",\"keyObjectives\":[\"Increase awareness\",\"Generate leads\",\"Achieve sales target\"],\"background\":\"This product addresses a gap in the market for affordable smart home devices.\",\"deadline\":\"2024-09-30\",\"tone\":\"formal\"}", + "description": "Draft a formal brief for a marketing team regarding an upcoming product launch, including objectives and background." + }, + { + "inputJson": "{\"title\":\"Website Redesign Project\",\"purpose\":\"Provide an overview of the website redesign aims and milestones.\",\"targetAudience\":\"Project team and company executives\",\"keyObjectives\":[\"Improve user experience\",\"Update branding\",\"Increase site traffic\"],\"background\":\"Our current website is outdated and does not reflect the new brand strategy.\",\"deadline\":\"2024-12-15\",\"tone\":\"formal\"}", + "description": "Generate a structured project brief outlining objectives and context for a website redesign." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Brief", + "context": null + } + }, + { + "name": "content-creation.draftTranscript", + "description": "Generates a structured transcript draft from audio or video input along with optional metadata. Accepts media file URL or text subtitle input, analyzes or formats content, and produces a timestamped transcript text draft suitable for editing or publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "mediaUrl", + "type": "string", + "description": "URL to the audio or video file to transcribe or draft the transcript from.", + "required": false, + "defaultValue": "" + }, + { + "name": "subtitleText", + "type": "string", + "description": "Optional subtitle text input representing dialogue or narration to format as a transcript draft.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') specifying the spoken language for transcription or formatting.", + "required": true, + "defaultValue": "en" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps in the output transcript draft.", + "required": true, + "defaultValue": "true" + }, + { + "name": "speakerLabels", + "type": "boolean", + "description": "Whether to attempt to identify and label different speakers in the transcript draft.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxSegmentLength", + "type": "number", + "description": "Maximum length in seconds for each transcript segment before a timestamp break.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted transcript text with optional metadata such as timestamps and speaker labels." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to create a preliminary transcript draft from audio or video content to facilitate review, editing, or further processing. Helpful for generating readable, structured text from multimedia inputs or subtitle text to prepare transcripts for publishing or accessibility.", + "limitations": "This tool does not perform perfect speech-to-text transcription from audio or video; it may rely on provided subtitles or require additional transcription services. It cannot fully verify transcript accuracy or context beyond formatting and structuring input content.", + "examples": [ + "Draft a transcript from a webinar recording URL with English audio and timestamps included.", + "Format provided subtitle text into a clean transcript format labeling speakers.", + "Create a short segment-timestamped transcript draft from a podcast audio file." + ] + }, + "tags": [ + "content", + "transcript", + "drafting", + "audio", + "video", + "subtitle", + "text", + "media" + ], + "examples": [ + { + "inputJson": "{\"mediaUrl\":\"https://example.com/meeting.mp4\",\"language\":\"en\",\"includeTimestamps\":true,\"speakerLabels\":true}", + "description": "Draft a transcript including timestamps and speaker labels from an English meeting video." + }, + { + "inputJson": "{\"subtitleText\":\"[00:00:01] Hello and welcome.\\n[00:00:05] This is the project update.\",\"language\":\"en\",\"includeTimestamps\":true}", + "description": "Create a formatted transcript draft from given subtitle text with timestamps." + }, + { + "inputJson": "{\"mediaUrl\":\"https://example.com/podcast.mp3\",\"language\":\"en\",\"includeTimestamps\":false,\"maxSegmentLength\":30}", + "description": "Generate a transcript draft without timestamps from a podcast audio, splitting text into 30-second segments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Transcript", + "context": null + } + }, + { + "name": "content-creation.draftChecklist", + "description": "Generates a structured checklist based on a given topic, purpose, and desired number of items. Users provide a checklist topic and optional context; the tool produces an organized list of actionable steps or considerations tailored to the input, formatted for easy review and use.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or focus of the checklist to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "The intended use or goal of the checklist, providing context to guide content creation.", + "required": false, + "defaultValue": "" + }, + { + "name": "numberOfItems", + "type": "number", + "description": "Approximate number of checklist items to generate for thorough coverage.", + "required": false, + "defaultValue": "10" + }, + { + "name": "itemDetailLevel", + "type": "string", + "description": "Detail level for each item, e.g., 'brief' or 'detailed', affecting the length and depth of each checklist point.", + "required": false, + "defaultValue": "brief" + }, + { + "name": "includeTips", + "type": "boolean", + "description": "Whether to add extra tips or explanations alongside each checklist item.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the checklist title and an ordered array of checklist items, each optionally with explanatory tips." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a coherent and relevant checklist for a specific topic, such as project planning, event preparation, or quality assurance. It helps organize important tasks or considerations into a clear, actionable format for users to follow.", + "limitations": "The tool may produce generic or high-level checklist items and might not cover very specialized or highly technical domains in depth. It is not designed to replace expert consultation or detailed procedural manuals.", + "examples": [ + "Create a checklist for launching a new website project with about 8 items and include detailed points.", + "Draft a simple grocery shopping checklist focused on healthy eating with brief items.", + "Generate a handyman's home inspection checklist with tips included for each item." + ] + }, + "tags": [ + "content creation", + "checklist", + "task management", + "organization", + "planning" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Launching a new website project\",\"purpose\":\"Project management guidance\",\"numberOfItems\":8,\"itemDetailLevel\":\"detailed\",\"includeTips\":true}", + "description": "Generate a detailed project launch checklist for a new website with useful tips on each step." + }, + { + "inputJson": "{\"topic\":\"Healthy grocery shopping\",\"purpose\":\"Guide for nutrition-focused purchases\",\"numberOfItems\":10,\"itemDetailLevel\":\"brief\",\"includeTips\":false}", + "description": "Create a concise checklist for shopping groceries aimed at healthy eating." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Checklist", + "context": null + } + }, + { + "name": "content-creation.draftTemplate", + "description": "Generates a customized document template by accepting a template type, optional placeholders, and formatting preferences. Produces a structured template draft in JSON or text format suitable for further editing or immediate use.", + "category": "content-creation", + "parameters": [ + { + "name": "templateType", + "type": "string", + "description": "Specifies the kind of document template to create, such as 'business proposal', 'newsletter', or 'invoice'.", + "required": true, + "defaultValue": "" + }, + { + "name": "placeholders", + "type": "object", + "description": "Key-value pairs defining placeholder names and their default values to include in the template for personalization.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "format", + "type": "string", + "description": "The output format of the drafted template, such as 'json' for structured data or 'text' for plain text documents.", + "required": false, + "defaultValue": "json" + }, + { + "name": "includeInstructions", + "type": "boolean", + "description": "If true, includes usage instructions or comments within the template to guide users.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "The natural language for template text, e.g., 'en' for English, to localize generated content.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "A drafted template object containing the template content, metadata like type and language, and optional usage instructions." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a structured document template customized to a specific domain or purpose, optionally including placeholders for dynamic content. It enables efficient content creation workflows by providing a ready-to-edit or deployable template draft.", + "limitations": "This tool cannot fill in real-time data or generate complete documents from scratch; it produces template scaffolds requiring further population or customization.", + "examples": [ + "Create a business proposal template with placeholders for client name and project details.", + "Generate a newsletter template in text format including instructions for editors.", + "Draft an invoice template in English with placeholders for billing details." + ] + }, + "tags": [ + "content creation", + "template generation", + "document drafting", + "automation", + "placeholders", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"templateType\":\"business proposal\",\"placeholders\":{\"clientName\":\"[Client Name]\",\"projectName\":\"[Project Name]\"},\"format\":\"json\",\"includeInstructions\":true,\"language\":\"en\"}", + "description": "Draft a business proposal template in JSON including placeholders and usage instructions." + }, + { + "inputJson": "{\"templateType\":\"newsletter\",\"format\":\"text\",\"includeInstructions\":true,\"language\":\"en\"}", + "description": "Generate a plain text newsletter template with instructions in English." + }, + { + "inputJson": "{\"templateType\":\"invoice\",\"placeholders\":{\"invoiceNumber\":\"[Invoice No]\",\"dueDate\":\"[Due Date]\"},\"format\":\"json\"}", + "description": "Create a JSON invoice template including relevant placeholders." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Template", + "context": null + } + }, + { + "name": "content-creation.draftFAQ", + "description": "Generates a structured Frequently Asked Questions (FAQ) document draft based on a provided topic and optional detailed input such as target audience, product details, or common concerns. The tool synthesizes relevant questions and answers to produce a clear, organized FAQ output in JSON or plain text format.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Primary subject or domain for which the FAQ is to be generated, e.g., product name or service type.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers or customers to tailor the complexity and style of the FAQ (e.g., beginners, advanced users).", + "required": false, + "defaultValue": "" + }, + { + "name": "keyDetails", + "type": "string", + "description": "Supplementary information or context about the topic, such as feature descriptions or common customer questions, to enhance answer relevance.", + "required": false, + "defaultValue": "" + }, + { + "name": "numberOfEntries", + "type": "number", + "description": "Desired number of question-answer pairs in the drafted FAQ. Limits the output length.", + "required": false, + "defaultValue": "10" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the FAQ output, either 'json' for structured data or 'text' for plain formatted text.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted FAQ, including an array of question and answer pairs, and metadata like topic and entry count." + }, + "aiAgent": { + "useCase": "Use when a user or client needs to quickly generate an initial FAQ document for a new product, service, or domain based on limited input to streamline content creation. It helps draft relevant questions and articulate clear answers automatically. This is particularly useful for onboarding, website content, or customer support documentation.", + "limitations": "Cannot guarantee domain-expert accuracy; may require human review and refinement. Not designed to incorporate confidential or proprietary information without explicit input.", + "examples": [ + "Draft an FAQ for a new fitness app aimed at beginners covering 8 questions.", + "Create a FAQ document for an ecommerce platform focusing on shipping policies in plain text format.", + "Generate FAQs about a software product including key features and user concerns for advanced users." + ] + }, + "tags": [ + "content creation", + "FAQ", + "document drafting", + "customer support", + "knowledge base", + "automation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"electric bicycles\",\"targetAudience\":\"beginner commuters\",\"keyDetails\":\"advantages, charging time, safety features\",\"numberOfEntries\":5,\"outputFormat\":\"json\"}", + "description": "Generate a 5-entry FAQ tailored for beginners interested in electric bicycles focusing on advantages, charging, and safety." + }, + { + "inputJson": "{\"topic\":\"Cloud Storage Service\",\"targetAudience\":\"IT professionals\",\"numberOfEntries\":10,\"outputFormat\":\"text\"}", + "description": "Create a 10-question FAQ in plain text designed for IT professionals about features of a cloud storage service." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "FAQ", + "context": null + } + }, + { + "name": "content-creation.draftSummary", + "description": "Generates a concise summary from provided text content. Accepts raw text input, processes key information extraction and condensation using NLP techniques, and outputs a brief summary highlighting the main points, suitable for documents, articles, or reports.", + "category": "content-creation", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The full text content to summarize; can be a document, article, or any lengthy text.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the summary in words; controls summary brevity.", + "required": false, + "defaultValue": "100" + }, + { + "name": "language", + "type": "string", + "description": "Language of the input text to tailor summarization models accordingly (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyPhrases", + "type": "boolean", + "description": "Whether to extract and include key phrases in the summary output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary string and an optional list of key phrases if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a readable, concise summary from large blocks of text to present the main ideas quickly, such as summarizing articles, reports, or lengthy documents for easier consumption.", + "limitations": "May not capture nuanced or highly technical content accurately; summaries depend on input text quality and length; not suited for generating summaries of non-text inputs or multimedia content.", + "examples": [ + "Summarize a product review article into 100 words.", + "Create a summary of a meeting transcript highlighting key decisions.", + "Generate key phrases along with a short summary of a research paper." + ] + }, + "tags": [ + "summarization", + "content-creation", + "nlp", + "text-processing", + "document", + "summary", + "draft" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"In recent years, the field of artificial intelligence has seen rapid advancements with applications ranging from healthcare to autonomous vehicles. These developments are driven by improved algorithms, larger datasets, and better hardware capabilities, enabling machines to learn and make decisions more effectively than ever before.\",\"maxLength\":50,\"language\":\"en\",\"includeKeyPhrases\":false}", + "description": "Summarize a paragraph about AI advancements into a brief summary." + }, + { + "inputJson": "{\"textContent\":\"The quarterly report highlights a 15% increase in revenue, driven primarily by growth in the Asia-Pacific region. Operational costs were reduced by 5%, boosting overall profitability. Key initiatives included expanding product lines and improving customer service.\",\"maxLength\":70,\"language\":\"en\",\"includeKeyPhrases\":true}", + "description": "Summarize a financial report paragraph and include key phrases." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Summary", + "context": null + } + }, + { + "name": "content-creation.draftParagraph", + "description": "Generates a coherent paragraph of text based on a given topic and optional stylistic preferences. Accepts a theme or subject, tone, and target length, then drafts a focused paragraph matching the input parameters.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the paragraph to draft.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired style or emotional tone of the paragraph, e.g., formal, casual, persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of words the paragraph should contain.", + "required": false, + "defaultValue": "100" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of specific words to include within the paragraph for emphasis or SEO purposes.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted paragraph as a string under the key 'paragraph'." + }, + "aiAgent": { + "useCase": "Use this tool when a concise, themed paragraph is needed quickly, such as for content drafts, marketing messages, summaries, or writing assistance. It is ideal for generating coherent, stylistically consistent text on a specified topic with control over tone and length.", + "limitations": "The tool cannot guarantee in-depth technical accuracy or extensive creative composition beyond a single paragraph. It may not adhere perfectly to highly specialized jargon or extremely long content requirements.", + "examples": [ + "Draft a persuasive paragraph about renewable energy.", + "Create a casual paragraph describing a new smartphone feature.", + "Write a formal paragraph on the importance of cybersecurity." + ] + }, + "tags": [ + "content-creation", + "text-generation", + "paragraph", + "drafting", + "writing-assistance" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of daily exercise\",\"tone\":\"motivational\",\"length\":80,\"keywords\":[\"health\",\"energy\"]}", + "description": "Draft a motivational paragraph about the benefits of daily exercise including keywords \"health\" and \"energy\"." + }, + { + "inputJson": "{\"topic\":\"Artificial Intelligence in healthcare\",\"tone\":\"formal\",\"length\":120}", + "description": "Generate a formal paragraph discussing the role of artificial intelligence in healthcare." + }, + { + "inputJson": "{\"topic\":\"Tips for remote work productivity\",\"tone\":\"casual\",\"length\":100}", + "description": "Create a casual paragraph giving tips for improving productivity while working remotely." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.draftSentence", + "description": "Generates a coherent, contextually relevant sentence based on a provided prompt, desired tone, and length constraints. It accepts a text prompt and optional parameters for style and complexity, and returns a single drafted sentence as output.", + "category": "content-creation", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "A short text prompt or seed phrase to guide sentence generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the sentence, e.g., formal, casual, optimistic.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "complexity", + "type": "string", + "description": "Level of sentence complexity, e.g., simple, intermediate, complex.", + "required": false, + "defaultValue": "intermediate" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the sentence in characters.", + "required": false, + "defaultValue": "140" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted sentence as a string." + }, + "aiAgent": { + "useCase": "Use this tool when a natural, context-aware sentence is needed based on a given text seed or prompt. It is ideal for content creation workflows requiring brief, stylistically tailored text generation, such as writing assistance or chatbot responses.", + "limitations": "The tool generates one sentence at a time and may produce generic or less accurate content for highly specialized or ambiguous prompts. It does not generate paragraphs or multiple sentences in one call.", + "examples": [ + "Draft a formal sentence about climate change.", + "Create a casual sentence expressing excitement about a new project.", + "Generate a complex sentence starting with 'Despite the challenges...'" + ] + }, + "tags": [ + "content generation", + "text creation", + "sentence drafting", + "natural language", + "writing assistance" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"Advancements in AI\",\"tone\":\"formal\",\"complexity\":\"complex\",\"maxLength\":150}", + "description": "Draft a formal, complex sentence about AI advancements." + }, + { + "inputJson": "{\"prompt\":\"Weekend plans\",\"tone\":\"casual\",\"maxLength\":100}", + "description": "Create a casual and short sentence about weekend plans." + }, + { + "inputJson": "{\"prompt\":\"Despite the challenges\",\"complexity\":\"complex\"}", + "description": "Generate a complex sentence starting with 'Despite the challenges...'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.draftInvoice", + "description": "Generates a professional invoice draft based on provided client, services, and payment details. Accepts inputs including client information, itemized list of products or services with quantities and prices, invoice number, and due date. Outputs a structured invoice ready for review or further formatting.", + "category": "content-creation", + "parameters": [ + { + "name": "invoiceNumber", + "type": "string", + "description": "Unique identifier for the invoice to distinguish it from others.", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceDate", + "type": "string", + "description": "Date when the invoice is issued (ISO 8601 format recommended).", + "required": true, + "defaultValue": "" + }, + { + "name": "dueDate", + "type": "string", + "description": "Payment due date for the invoice (ISO 8601 format recommended).", + "required": true, + "defaultValue": "" + }, + { + "name": "clientInfo", + "type": "object", + "description": "Details of the client including name, address, and contact information.", + "required": true, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "List of items or services, each with description, quantity, unit price, and optional tax rate.", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code (ISO 4217) used for invoice amounts, e.g., USD, EUR.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "notes", + "type": "string", + "description": "Additional comments or terms to appear on the invoice.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured invoice object containing header, client details, itemized charges with totals and taxes, notes, and payment terms suitable for rendering or exporting." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create a draft invoice document from structured input data for clients and services rendered, especially when automating billing workflows or generating templated invoices for review.", + "limitations": "This tool does not perform payment processing or legal validation of invoice terms. It creates draft invoices but does not manage invoice tracking or integrate with accounting software directly.", + "examples": [ + "Create an invoice draft for a client with three services including quantities and unit prices.", + "Generate an invoice with client contact details, invoice and due dates, and include payment notes.", + "Draft an invoice in EUR currency for goods sold with itemized tax calculations." + ] + }, + "tags": [ + "invoice", + "billing", + "content-creation", + "document-generation", + "finance", + "automation" + ], + "examples": [ + { + "inputJson": "{\"invoiceNumber\":\"INV-1001\",\"invoiceDate\":\"2024-06-01\",\"dueDate\":\"2024-06-30\",\"clientInfo\":{\"name\":\"Acme Corp.\",\"address\":\"123 Market St, Springfield\",\"email\":\"billing@acmecorp.com\"},\"items\":[{\"description\":\"Consultation Services\",\"quantity\":10,\"unitPrice\":150,\"taxRate\":0.1},{\"description\":\"Software License\",\"quantity\":2,\"unitPrice\":2000,\"taxRate\":0.2}],\"currency\":\"USD\",\"notes\":\"Payment due within 30 days.\"}", + "description": "Draft an invoice for Acme Corp. for consultation and software license fees with taxes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Invoice", + "context": null + } + }, + { + "name": "content-creation.draftMinutes", + "description": "This tool generates a structured draft of meeting minutes based on provided meeting details such as agenda items, participants, and notes. It processes the input to create organized minutes including attendance, discussion summaries, decisions made, and action items, outputting a formatted textual draft suitable for review and distribution.", + "category": "content-creation", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "Title or subject of the meeting to be documented", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Date of the meeting in ISO format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "List of participant names who attended the meeting", + "required": true, + "defaultValue": "[]" + }, + { + "name": "agendaItems", + "type": "array", + "description": "List of agenda item titles or topics discussed during the meeting", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discussionPoints", + "type": "array", + "description": "Array of objects summarizing discussion per agenda item, each including 'agendaItem' and 'points' as string", + "required": false, + "defaultValue": "[]" + }, + { + "name": "decisions", + "type": "array", + "description": "List of key decisions made during the meeting", + "required": false, + "defaultValue": "[]" + }, + { + "name": "actionItems", + "type": "array", + "description": "List of action items with assigned responsible persons and deadlines", + "required": false, + "defaultValue": "[]" + }, + { + "name": "meetingLeader", + "type": "string", + "description": "Name of the person leading or chairing the meeting", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted meeting minutes as a formatted text string under the 'minutesText' key" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a clear, professional draft of meeting minutes from structured input data collected before or during a meeting. It helps in quickly generating consistent and organized minutes from agenda and discussion data, facilitating efficient meeting documentation.", + "limitations": "The tool cannot infer content not provided; accuracy depends on input detail quality. It does not transcribe audio or extract facts automatically from recordings.", + "examples": [ + "Generate meeting minutes draft from the agenda, participants, summary of topics discussed, decisions, and assigned actions.", + "Create a formatted meeting minutes document after manually entering notes from a project status meeting.", + "Produce a drafts of minutes emphasizing decisions and next steps for team distribution after a client meeting." + ] + }, + "tags": [ + "content creation", + "meeting minutes", + "documentation", + "productivity", + "office tools" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Monthly Marketing Strategy Meeting\",\"date\":\"2024-06-05\",\"participants\":[\"Alice Johnson\",\"Bob Smith\",\"Carol Lee\"],\"agendaItems\":[\"Campaign Review\",\"Budget Allocation\",\"New Product Launch\"],\"discussionPoints\":[{\"agendaItem\":\"Campaign Review\",\"points\":\"Reviewed last quarter’s campaign results; noted increased engagement on social media.\"},{\"agendaItem\":\"Budget Allocation\",\"points\":\"Discussed proposed budget increase for digital ads.\"},{\"agendaItem\":\"New Product Launch\",\"points\":\"Planned launch timeline and assigned marketing tasks.\"}],\"decisions\":[\"Approve 15% increase in digital ad budget.\",\"Launch new product on September 1st.\"],\"actionItems\":[{\"task\":\"Prepare detailed ad budget proposal\",\"assignee\":\"Bob Smith\",\"deadline\":\"2024-06-12\"},{\"task\":\"Create launch event plan\",\"assignee\":\"Carol Lee\",\"deadline\":\"2024-07-01\"}],\"meetingLeader\":\"Alice Johnson\"}", + "description": "Draft meeting minutes for a marketing strategy meeting with agenda topics, discussions, decisions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Minutes", + "context": null + } + }, + { + "name": "content-creation.draftBlogPost", + "description": "Generates a draft blog post based on the given topic, target audience, desired tone, and optional keywords. Processes the inputs to create a coherent, engaging, and structured blog post comprising an introduction, main body, and conclusion. Outputs the draft blog content as plain text.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the blog post to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers to tailor the post style and complexity.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the blog post, e.g., professional, casual, persuasive.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "keywords", + "type": "array", + "description": "Relevant keywords or phrases to include for SEO and thematic emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "wordCount", + "type": "number", + "description": "Approximate desired length of the blog post in words.", + "required": false, + "defaultValue": "800" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to add a call-to-action section at the end of the blog post.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated blog post text as a string and metadata such as estimated word count." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a structured, readable draft blog post from minimal input, such as topic and audience, to accelerate content creation workflows. Ideal for content marketing, blogs, and web articles requiring engaging and audience-tailored writing.", + "limitations": "Cannot guarantee factual accuracy or replace expert content reviewers; generated content may require editing for nuance, tone, and SEO optimization beyond initial drafting.", + "examples": [ + "Create a 1000-word blog post about sustainable gardening for beginner gardeners with a friendly tone.", + "Draft a professional blog post explaining recent blockchain trends focused on financial investors.", + "Generate a casual tech blog discussing the benefits of AI in daily life, including the keywords AI, automation, smart devices." + ] + }, + "tags": [ + "content-creation", + "blog", + "drafting", + "writing", + "SEO", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Tips for effective remote work\",\"targetAudience\":\"remote employees and freelancers\",\"tone\":\"professional\",\"keywords\":[\"remote work\",\"productivity\",\"home office\"],\"wordCount\":900,\"includeCallToAction\":true}", + "description": "Generate a professional blog post to help remote workers improve productivity and office setup." + }, + { + "inputJson": "{\"topic\":\"Best budget travel destinations 2024\",\"targetAudience\":\"young adults and students\",\"tone\":\"casual\",\"keywords\":[\"budget travel\",\"2024 vacations\",\"cheap destinations\"],\"wordCount\":750,\"includeCallToAction\":false}", + "description": "Create a casual blog post suggesting affordable travel places for the upcoming year without a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "BlogPost", + "context": null + } + }, + { + "name": "content-creation.draftContract", + "description": "Generates a preliminary contract document based on provided contract type, key terms, and optional clauses. Accepts inputs such as contract type, parties involved, effective dates, payment terms, confidentiality clauses, and other relevant provisions. Produces a formatted draft contract text suitable for review and editing.", + "category": "content-creation", + "parameters": [ + { + "name": "contractType", + "type": "string", + "description": "Specifies the type of contract to draft (e.g., 'NDA', 'Service Agreement').", + "required": true, + "defaultValue": "" + }, + { + "name": "parties", + "type": "array", + "description": "List of parties involved in the contract, each as an object with name and role.", + "required": true, + "defaultValue": "" + }, + { + "name": "effectiveDate", + "type": "string", + "description": "The contract's effective date as an ISO 8601 date string (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "termLengthMonths", + "type": "number", + "description": "Duration of the contract term in months.", + "required": false, + "defaultValue": "" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Details of payment terms such as amounts, schedules, and methods.", + "required": false, + "defaultValue": "" + }, + { + "name": "confidentialityClause", + "type": "boolean", + "description": "Flag to include a standard confidentiality clause in the contract.", + "required": false, + "defaultValue": "true" + }, + { + "name": "terminationConditions", + "type": "string", + "description": "Conditions under which the contract may be terminated.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalClauses", + "type": "array", + "description": "An array of additional clause texts to be appended to the contract.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns draft contract with full text and metadata including contract type and involved parties." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a first draft of a legal contract quickly by providing structured inputs such as contract type, parties, and key terms. It helps automate creation of standard contract templates and preliminary wording for review and negotiation.", + "limitations": "This tool does not provide legally vetted or jurisdiction-specific contracts, nor does it replace professional legal advice. It cannot enforce or validate legal compliance or custom complex clauses beyond provided input.", + "examples": [ + "Draft a service agreement contract between two companies specifying payment terms and confidentiality.", + "Generate an NDA between two parties with a 12-month term and termination conditions.", + "Create a freelance work contract including additional clauses about intellectual property rights." + ] + }, + "tags": [ + "content-creation", + "contract", + "legal", + "drafting", + "automation", + "document-generation" + ], + "examples": [ + { + "inputJson": "{\"contractType\":\"NDA\",\"parties\":[{\"name\":\"Alpha Corp\",\"role\":\"Disclosing Party\"},{\"name\":\"Beta LLC\",\"role\":\"Receiving Party\"}],\"effectiveDate\":\"2024-06-01\",\"termLengthMonths\":12,\"confidentialityClause\":true}", + "description": "Drafts a 12-month NDA between two companies including confidentiality clause." + }, + { + "inputJson": "{\"contractType\":\"Service Agreement\",\"parties\":[{\"name\":\"Tech Solutions\",\"role\":\"Provider\"},{\"name\":\"RetailCo\",\"role\":\"Client\"}],\"paymentTerms\":\"Monthly payments of $5000 due by the 5th day.\",\"terminationConditions\":\"Either party may terminate with 30 days written notice.\"}", + "description": "Creates a service agreement with specific payment terms and termination conditions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Contract", + "context": null + } + }, + { + "name": "content-creation.draftArticle", + "description": "Generates a structured draft article based on input topic, keywords, and desired length. Accepts topic string, optional keywords array, target word count, and tone style. Produces a coherent article draft suitable for further editing or publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The primary subject or title of the article to draft.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of important keywords to be naturally included in the article.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetWordCount", + "type": "number", + "description": "Approximate desired length of the article in words.", + "required": false, + "defaultValue": "800" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of writing: e.g., formal, casual, persuasive, informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "includeSubheadings", + "type": "boolean", + "description": "Whether to organize the article into sections with subheadings for clarity.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full article draft text and a list of suggested sections or subheadings." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to rapidly generate comprehensive article drafts from minimal input such as topic and keywords, ideal for content creation workflows requiring structured, human-readable text. It is helpful for generating well-organized initial drafts that can be refined further.", + "limitations": "This tool does not perform fact-checking or source citation automatically, and the generated content may require human review before publication to ensure accuracy and appropriateness.", + "examples": [ + "Draft an article about sustainable urban farming emphasizing environmental benefits, targeting 1200 words, with a persuasive tone.", + "Create a casual style article draft on the topic of electric vehicles that includes keywords: \"EV,\" \"charging stations,\" and \"range anxiety.\"", + "Generate an informative article draft on the history of jazz music around 900 words, including subheadings for key periods." + ] + }, + "tags": [ + "content creation", + "article drafting", + "text generation", + "writing assistant", + "content marketing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Sustainable urban farming\",\"keywords\":[\"environment\",\"green spaces\",\"local food\"],\"targetWordCount\":1200,\"tone\":\"persuasive\",\"includeSubheadings\":true}", + "description": "Generate a 1200-word persuasive article draft focusing on sustainable urban farming and its environmental benefits." + }, + { + "inputJson": "{\"topic\":\"Electric vehicles\",\"keywords\":[\"EV\",\"charging stations\",\"range anxiety\"],\"targetWordCount\":800,\"tone\":\"casual\",\"includeSubheadings\":false}", + "description": "Create a casual tone article draft about electric vehicles including specified keywords, approximately 800 words, without subheadings." + }, + { + "inputJson": "{\"topic\":\"History of jazz music\",\"keywords\":[],\"targetWordCount\":900,\"tone\":\"informative\",\"includeSubheadings\":true}", + "description": "Produce an informative article draft on the history of jazz music structured with subheadings, around 900 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Article", + "context": null + } + }, + { + "name": "content-creation.draftReport", + "description": "Generates a structured draft report based on provided topic, key points, and optional data summary. Accepts input including report title, target audience, sections with content outlines, and data summaries. Processes inputs to produce a coherent multi-section textual report draft suitable for review or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "reportTitle", + "type": "string", + "description": "The main title or subject of the report to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience to tailor tone and complexity (e.g., executives, technical staff).", + "required": false, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects, each containing a header and key points or bullet outlines to cover in that section.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSummary", + "type": "string", + "description": "Optional summarized data or results to incorporate as factual content within the report.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeExecutiveSummary", + "type": "boolean", + "description": "Flag to include an executive summary section at the beginning of the report.", + "required": false, + "defaultValue": "false" + }, + { + "name": "languageTone", + "type": "string", + "description": "Preferred tone of the report, e.g., formal, informal, persuasive, neutral.", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete textual draft of the report, with sections and optional executive summary in a structured format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to quickly generate a structured, coherent draft of a report document from prescribed inputs such as key topics, audience type, and data points. Useful for automating content creation workflows in business, research, or project reporting with minimal manual writing.", + "limitations": "Cannot generate highly specialized technical content requiring domain expertise beyond provided inputs. Does not perform detailed fact-checking or real-time data integration.", + "examples": [ + "Draft a quarterly sales report for executive team highlighting revenue trends and regional performance.", + "Create a project status report with sections on progress, risks, and next steps for stakeholders.", + "Generate a marketing campaign report draft in persuasive tone based on campaign metrics and outcomes." + ] + }, + "tags": [ + "content creation", + "report drafting", + "document generation", + "automation", + "business reporting", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"reportTitle\":\"Q1 Financial Overview\",\"targetAudience\":\"Senior Management\",\"sections\":[{\"header\":\"Revenue Analysis\",\"keyPoints\":[\"Total revenue growth\",\"Revenue by region\"]},{\"header\":\"Expense Breakdown\",\"keyPoints\":[\"Operational expenses\",\"Marketing costs\"]}],\"dataSummary\":\"Q1 showed a 10% revenue increase compared to Q4, driven primarily by North America and APAC regions.\",\"includeExecutiveSummary\":true,\"languageTone\":\"formal\"}", + "description": "Draft a formal Q1 financial overview report with executive summary for senior management including revenue and expenses." + }, + { + "inputJson": "{\"reportTitle\":\"Project Phoenix Status Update\",\"targetAudience\":\"Project Stakeholders\",\"sections\":[{\"header\":\"Progress\",\"keyPoints\":[\"Completed milestones\",\"Current sprint objectives\"]},{\"header\":\"Risks and Issues\",\"keyPoints\":[\"Identified roadblocks\",\"Mitigation plans\"]},{\"header\":\"Next Steps\",\"keyPoints\":[\"Upcoming tasks\",\"Resource allocation\"]}],\"includeExecutiveSummary\":false,\"languageTone\":\"neutral\"}", + "description": "Generate a neutral-tone project status report covering progress, risks and next steps without executive summary." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.draftResume", + "description": "Generates a professional resume by accepting personal details, work experience, education, skills, and optionally a job description to tailor the resume. Processes structured input to create a well-formatted and concise resume draft ready for review or customization.", + "category": "content-creation", + "parameters": [ + { + "name": "personalInfo", + "type": "object", + "description": "Personal information including name, contact details, and summary statement.", + "required": true, + "defaultValue": "" + }, + { + "name": "workExperience", + "type": "array", + "description": "List of work experiences, each with company, role, dates, and achievements.", + "required": true, + "defaultValue": "" + }, + { + "name": "education", + "type": "array", + "description": "List of educational qualifications with institution, degree, and dates.", + "required": true, + "defaultValue": "" + }, + { + "name": "skills", + "type": "array", + "description": "List of professional skills relevant to the candidate.", + "required": true, + "defaultValue": "" + }, + { + "name": "jobDescription", + "type": "string", + "description": "Optional job description or role to tailor the resume towards specific job requirements.", + "required": false, + "defaultValue": "" + }, + { + "name": "templateStyle", + "type": "string", + "description": "Optional parameter to select resume style template (e.g., 'modern', 'classic').", + "required": false, + "defaultValue": "classic" + } + ], + "returns": { + "type": "object", + "description": "An object containing a formatted resume text and optionally the structure used for further edits." + }, + "aiAgent": { + "useCase": "This tool is ideal for generating initial professional resumes quickly from structured inputs, helping users or AI agents produce tailored resume drafts ready for customization or submission. It supports creating resumes for diverse industries by adjusting content and format.", + "limitations": "This tool cannot extract information from unstructured text or documents, nor perform precise graphic design layouts. It provides a textual formatted draft best suited for standard text-based resume creation.", + "examples": [ + "Draft a resume with my personal info, work experience in software engineering, education background in computer science, key skills, and tailor it to a data scientist position.", + "Generate a classic style resume draft for a marketing professional using provided job history and education.", + "Create a modern style resume for a recent graduate including personal summary and skills relevant to entry-level positions." + ] + }, + "tags": [ + "content-creation", + "resume", + "career", + "drafting", + "document-generation" + ], + "examples": [ + { + "inputJson": "{\"personalInfo\":{\"name\":\"Jane Doe\",\"email\":\"jane.doe@example.com\",\"phone\":\"123-456-7890\",\"summary\":\"Experienced software engineer specialized in backend systems.\"},\"workExperience\":[{\"company\":\"Tech Corp\",\"role\":\"Software Engineer\",\"startDate\":\"2018-06\",\"endDate\":\"2023-01\",\"achievements\":[\"Developed scalable APIs\",\"Led migration to cloud infrastructure\"]}],\"education\":[{\"institution\":\"State University\",\"degree\":\"BSc Computer Science\",\"startDate\":\"2014-09\",\"endDate\":\"2018-05\"}],\"skills\":[\"Python\",\"Java\",\"AWS\",\"Docker\"],\"jobDescription\":\"Data Scientist role involving machine learning and data visualization.\",\"templateStyle\":\"modern\"}", + "description": "Draft a modern style resume for an experienced software engineer, tailored for a data scientist role." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Resume", + "context": null + } + }, + { + "name": "content-creation.draftEmail", + "description": "Generates a professionally structured email draft based on recipient information, subject, purpose, and optional tone. Accepts parameters such as recipient name, subject, and email body points, then composes a coherent email draft text.", + "category": "content-creation", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the primary email recipient to personalize the greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email to indicate the topic.", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Main intent or reason for the email to guide the content tone and focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of important points or details to include in the email body.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the email (e.g., formal, friendly, concise).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "closing", + "type": "string", + "description": "Optional closing line or sign-off to end the email professionally.", + "required": false, + "defaultValue": "Best regards," + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete email draft text with greeting, body, and closing formatted as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a clear, professional email draft given a recipient, subject, and a set of key points or purpose. It helps automate drafting in business or personal communication scenarios requiring customized, tone-appropriate emails.", + "limitations": "Cannot send emails or manage email clients. It produces text only and may not fully capture complex emotional nuance or highly technical content without detailed input.", + "examples": [ + "Draft a formal email to a client summarizing project updates.", + "Create a friendly invitation email for a team meeting.", + "Generate a concise follow-up email after a job interview." + ] + }, + "tags": [ + "content creation", + "email", + "drafting", + "communication", + "automation" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"John Smith\",\"subject\":\"Project Update\",\"purpose\":\"Inform the client about the latest progress and next steps.\",\"keyPoints\":[\"Completed phase one\",\"Started phase two\",\"Expected completion next month\"],\"tone\":\"formal\",\"closing\":\"Sincerely,\"}", + "description": "Formal project update email to a client with key status points." + }, + { + "inputJson": "{\"recipientName\":\"Emma\",\"subject\":\"Team Lunch Invitation\",\"purpose\":\"Invite teammates to lunch this Friday.\",\"keyPoints\":[\"Date and time: Friday at noon\",\"Location: Downtown Bistro\",\"RSVP by Wednesday\"],\"tone\":\"friendly\",\"closing\":\"Cheers,\"}", + "description": "Friendly invitation email for a casual team lunch." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "content-creation.draftProposal", + "description": "Generates a structured project proposal draft based on provided key details such as project objectives, stakeholders, timeline, and budget. Accepts inputs defining scope, goals, and requirements; processes them to create a coherent proposal document outline and content suggestions; outputs a draft proposal text in markdown or plain text format.", + "category": "content-creation", + "parameters": [ + { + "name": "projectTitle", + "type": "string", + "description": "The title of the project for the proposal.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectSummary", + "type": "string", + "description": "A brief summary describing the purpose and main goal of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "List of specific objectives or goals the project aims to achieve.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "stakeholders", + "type": "array", + "description": "List of key stakeholders or involved parties with their roles or importance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeline", + "type": "string", + "description": "General timeline or schedule overview for project milestones.", + "required": false, + "defaultValue": "" + }, + { + "name": "budgetEstimate", + "type": "string", + "description": "Estimated budget for the project, including funding sources if available.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Optional additional information or requirements to be considered in the proposal.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired format of the output draft, e.g. 'markdown' or 'plain'.", + "required": false, + "defaultValue": "markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing the proposal draft text under 'proposalDraft' key and meta information about sections included." + }, + "aiAgent": { + "useCase": "Use this tool when an initial draft of a project proposal document is needed from key project details to help structure ideas, define goals, and create a ready-to-edit document outline quickly.", + "limitations": "Cannot replace detailed expert-written proposals or legal/financial advice. Does not generate highly customized technical content or consult on feasibility. Outputs a draft to be reviewed and refined by humans.", + "examples": [ + "Draft a proposal for a community recycling initiative covering goals and stakeholders.", + "Generate a project proposal draft summarizing a software development plan with timeline and budget.", + "Create an initial proposal document for a marketing campaign highlighting objectives and estimated costs." + ] + }, + "tags": [ + "content creation", + "proposal drafting", + "project management", + "document generation", + "writing assistant" + ], + "examples": [ + { + "inputJson": "{\"projectTitle\":\"EcoPark Revitalization\",\"projectSummary\":\"A project aimed at renovating the local park to improve community access and green space.\",\"objectives\":[\"Improve accessibility\",\"Add new playground equipment\",\"Increase green landscaping\"],\"stakeholders\":[\"City Council\",\"Local Community Groups\"],\"timeline\":\"6 months from approval to completion\",\"budgetEstimate\":\"$150,000\",\"additionalNotes\":\"Focus on sustainable, eco-friendly materials.\",\"outputFormat\":\"markdown\"}", + "description": "Draft proposal for a local park renovation project with objectives and budget." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Proposal", + "context": null + } + }, + { + "name": "content-creation.composeReference", + "description": "Generates a properly formatted reference citation based on provided source details and citation style. Accepts input including author names, title, publication date, source type, and outputs a formatted reference string according to popular academic styles like APA, MLA, or Chicago.", + "category": "content-creation", + "parameters": [ + { + "name": "sourceType", + "type": "string", + "description": "Type of source (e.g., book, journal, website, article).", + "required": true, + "defaultValue": "" + }, + { + "name": "authorNames", + "type": "array", + "description": "List of authors' full names in preferred order.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work to be cited.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the source was published.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or publishing organization.", + "required": false, + "defaultValue": "" + }, + { + "name": "journalName", + "type": "string", + "description": "Name of the journal if sourceType is journal article.", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page range if applicable (e.g., 12-34).", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL if source is online and applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the online source was accessed (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format output (e.g., APA, MLA, Chicago).", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "Contains the formatted reference string compatible with the requested citation style and source type, ready for inclusion in bibliographies or reference lists." + }, + "aiAgent": { + "useCase": "Use this tool when composing academic papers, articles, or reports requiring properly formatted citations from detailed source metadata. It ensures consistent, style-accurate references automatically, saving time and reducing manual errors.", + "limitations": "This tool cannot verify the accuracy of source metadata or retrieve missing data; input must be complete and correct. It does not support uncommon or highly customized citation styles beyond popular standards like APA, MLA, and Chicago.", + "examples": [ + "Create an APA reference for a book with multiple authors.", + "Generate an MLA citation for a journal article including volume and issue.", + "Format a Chicago style reference for a website with URL and access date." + ] + }, + "tags": [ + "content creation", + "citation", + "reference formatting", + "academic writing", + "bibliography" + ], + "examples": [ + { + "inputJson": "{\"sourceType\":\"book\",\"authorNames\":[\"John Smith\",\"Jane Doe\"],\"title\":\"Understanding AI\",\"publicationYear\":2021,\"publisher\":\"Tech Press\",\"citationStyle\":\"APA\"}", + "description": "Formatting an APA style book reference with two authors." + }, + { + "inputJson": "{\"sourceType\":\"journal\",\"authorNames\":[\"Emily Johnson\"],\"title\":\"Deep Learning Advances\",\"publicationYear\":2020,\"journalName\":\"AI Research Journal\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"234-250\",\"citationStyle\":\"MLA\"}", + "description": "Creating an MLA citation for a journal article including volume and issue details." + }, + { + "inputJson": "{\"sourceType\":\"website\",\"authorNames\":[\"Tech Editor\"],\"title\":\"Future of Robotics\",\"publicationYear\":2023,\"url\":\"https://www.techsite.com/robotics\",\"accessDate\":\"2024-05-01\",\"citationStyle\":\"Chicago\"}", + "description": "Generating a Chicago style reference for an online article with URL and accessed date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reference", + "context": null + } + }, + { + "name": "content-creation.draftDocument", + "description": "Generates a preliminary draft of a document based on an input outline or topic description. Processes text prompts, structural requirements, and style preferences and produces a coherent draft text in specified format, ready for further editing or refinement.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title or subject of the document to be drafted.", + "required": true, + "defaultValue": "" + }, + { + "name": "outlinePoints", + "type": "array", + "description": "An ordered list of key points or headings to structure the document around.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "style", + "type": "string", + "description": "The writing style or tone (e.g., formal, informal, technical, persuasive) to apply to the draft.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "audience", + "type": "string", + "description": "Intended readership or audience type (e.g., general public, experts, students).", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code indicating the desired language of the draft (e.g., 'en', 'es').", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the draft document in words. If omitted, defaults to 1000 words.", + "required": false, + "defaultValue": "1000" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted document text and metadata such as word count and detected language." + }, + "aiAgent": { + "useCase": "Use this tool when needing a first-pass draft document generated from a high-level input such as a title, outline, or topic description. It helps in quickly producing base content for reports, articles, briefs, or proposals that require structured text based on user guidance.", + "limitations": "The draft is a generated initial version and may contain inaccuracies or lack detailed domain expertise. It should be reviewed and edited by a human before finalization. It cannot incorporate external or real-time data sources by itself.", + "examples": [ + "Generate a formal report draft on climate change impacts based on provided key points.", + "Create an informal blog post draft about hiking tips for beginners.", + "Draft a technical memo summarizing new software architecture concepts." + ] + }, + "tags": [ + "content-generation", + "document", + "drafting", + "writing", + "text-generation", + "automation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Impact of Renewable Energy Adoption\",\"outlinePoints\":[\"Introduction\",\"Environmental Benefits\",\"Economic Considerations\",\"Challenges and Solutions\",\"Conclusion\"],\"style\":\"formal\",\"audience\":\"policy makers\",\"language\":\"en\",\"maxLength\":1200}", + "description": "Draft a formal policy report on renewable energy using provided outline points." + }, + { + "inputJson": "{\"title\":\"Tips for First-Time Hikers\",\"style\":\"informal\",\"audience\":\"general public\",\"language\":\"en\",\"maxLength\":800}", + "description": "Create an informal blog post draft giving tips for beginner hikers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "draft", + "object": "Document", + "context": null + } + }, + { + "name": "content-creation.composeCitation", + "description": "Composes a formatted citation string from structured bibliographic information following specified citation styles such as APA, MLA, or Chicago. Accepts inputs including author names, title, publication date, and source details, then outputs a correctly formatted citation text.", + "category": "content-creation", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of author names in order, each as a string (e.g., ['John Smith', 'Jane Doe']).", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the cited work such as article, book, or webpage.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationDate", + "type": "string", + "description": "Date of publication in ISO format or other recognizable date string.", + "required": false, + "defaultValue": "" + }, + { + "name": "source", + "type": "string", + "description": "Name of the publication, journal, website, or publisher of the work.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format the output, e.g., 'APA', 'MLA', or 'Chicago'.", + "required": true, + "defaultValue": "APA" + }, + { + "name": "url", + "type": "string", + "description": "URL of the online source if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date when the online source was accessed, for online citations.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string as 'formattedCitation'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a properly formatted citation from given bibliographic data for inclusion in academic or professional documents. It helps convert raw citation metadata into standardized citation text for styles like APA, MLA, or Chicago.", + "limitations": "This tool cannot fetch bibliographic data automatically or verify the accuracy of input data. It only formats the citation string based on provided inputs and the selected style.", + "examples": [ + "Generate an APA citation for a journal article with two authors.", + "Create an MLA citation for a website accessed today.", + "Produce a Chicago style citation for a book with known author and publication date." + ] + }, + "tags": [ + "citation", + "formatting", + "academic", + "bibliography", + "reference", + "style guide", + "APA", + "MLA", + "Chicago" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Jane Doe\",\"John Smith\"],\"title\":\"Innovations in AI Research\",\"publicationDate\":\"2022-08-15\",\"source\":\"Journal of AI Studies\",\"citationStyle\":\"APA\"}", + "description": "Create an APA citation for a journal article with two authors." + }, + { + "inputJson": "{\"authors\":[\"Alice Johnson\"],\"title\":\"Exploring the Cosmos\",\"publicationDate\":\"2019\",\"source\":\"Space Exploration Press\",\"citationStyle\":\"Chicago\"}", + "description": "Produce a Chicago style citation for a book with one author." + }, + { + "inputJson": "{\"authors\":[\"Emily Brown\"],\"title\":\"Climate Change Effects\",\"url\":\"https://climateexample.org\",\"accessDate\":\"2024-06-01\",\"citationStyle\":\"MLA\"}", + "description": "Generate an MLA citation for a web page including accessed date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.composeHeading", + "description": "Generates well-structured and relevant headings for documents, articles, or web pages based on a given topic, desired tone, and heading level. Accepts a short textual topic and formatting preferences, and produces a concise heading text appropriate for the specified context.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or theme for the heading to be generated. Required for context relevance.", + "required": true, + "defaultValue": "" + }, + { + "name": "headingLevel", + "type": "number", + "description": "Desired heading level from 1 (largest) to 6 (smallest), reflecting document structure and importance.", + "required": false, + "defaultValue": "2" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the heading, e.g., formal, casual, technical, or persuasive, to match the target audience.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters allowed in the heading to ensure conciseness and formatting consistency.", + "required": false, + "defaultValue": "60" + }, + { + "name": "includeKeyword", + "type": "string", + "description": "Optional keyword that should be included in the heading to improve SEO or relevance.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed heading text and its corresponding heading level used." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate appropriate, concise, and formatted headings for digital content such as articles, blogs, reports, or web pages based on thematic input and formatting constraints. It helps maintain consistency in document structure and enhances content readability and SEO.", + "limitations": "Cannot generate full section content or paragraphs, only single-line headings. Quality depends on specificity of input topic and parameters. It does not replace editorial review for nuance or cultural context.", + "examples": [ + "Generate a level 1 heading with a formal tone on 'Climate Change Effects'.", + "Create a casual, level 3 heading for a blog post about 'Healthy Eating Tips'.", + "Produce a technical level 2 heading including keyword 'AI Optimization' within 50 characters." + ] + }, + "tags": [ + "content-creation", + "heading", + "text-generation", + "SEO", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of Meditation\",\"headingLevel\":2,\"tone\":\"formal\",\"maxLength\":50}", + "description": "Generate a formal level 2 heading about 'Benefits of Meditation' with max 50 characters." + }, + { + "inputJson": "{\"topic\":\"Summer Travel Tips\",\"headingLevel\":3,\"tone\":\"casual\"}", + "description": "Generate a casual level 3 heading focusing on summer travel." + }, + { + "inputJson": "{\"topic\":\"Quantum Computing Basics\",\"includeKeyword\":\"Quantum\",\"maxLength\":40}", + "description": "Generate a heading including 'Quantum' keyword, max 40 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.composeLink", + "description": "Creates a formatted hyperlink for digital content by accepting a URL, display text, and optional attributes like title and target. It processes these inputs to generate a valid HTML anchor tag or Markdown link as output, suitable for embedding within web or text content.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL the link should point to.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "The text to display for the link; if empty, the URL is used as display text.", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional tooltip text that appears when hovering over the link.", + "required": false, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "Whether the link should open in a new browser tab or window (adds target attribute).", + "required": false, + "defaultValue": "false" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the link: 'html' for anchor tag or 'markdown' for markdown syntax.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated link string in the requested format under the 'link' key." + }, + "aiAgent": { + "useCase": "Use this tool when composing or formatting links for inclusion in digital content such as web pages, blogs, or markdown documents. It helps standardize link creation with customizable display text, titles, and open-in-new-tab behavior, outputting clean HTML or markdown syntax as needed.", + "limitations": "This tool does not validate URLs for accessibility or check if the link destination is safe or live. It does not support advanced HTML attributes such as classes or styles beyond title and target.", + "examples": [ + "Create an HTML anchor tag linking to 'https://example.com' with display text 'Example Site' that opens in a new tab.", + "Generate a markdown formatted link for 'https://docs.example.com' using the default display text (the URL).", + "Create an HTML link with a tooltip title attribute and no special target behavior." + ] + }, + "tags": [ + "content-creation", + "link", + "html", + "markdown", + "formatting", + "hyperlink" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://openai.com\",\"displayText\":\"OpenAI Website\",\"title\":\"Visit OpenAI\",\"openInNewTab\":true,\"format\":\"html\"}", + "description": "Create an HTML link to 'https://openai.com' with display text 'OpenAI Website', a title tooltip, that opens in a new tab." + }, + { + "inputJson": "{\"url\":\"https://github.com\",\"displayText\":\"\",\"title\":\"GitHub Homepage\",\"openInNewTab\":false,\"format\":\"markdown\"}", + "description": "Generate a markdown link to 'https://github.com' using the URL as display text, with a title attribute (ignored in markdown)." + }, + { + "inputJson": "{\"url\":\"https://news.example.com\",\"displayText\":\"Latest News\",\"title\":\"Read the latest news\",\"openInNewTab\":false,\"format\":\"html\"}", + "description": "Create a standard HTML anchor with custom display text and title, opening in the same tab." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.composeQuote", + "description": "This tool generates a well-structured quote based on user input. It accepts optional text fragments or themes and can produce quotes with specified tone, length, and attribution. The output is a formatted quote string with optional author attribution.", + "category": "content-creation", + "parameters": [ + { + "name": "theme", + "type": "string", + "description": "The central theme or subject of the quote to guide composition, e.g., 'inspiration', 'wisdom'.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the quote such as 'motivational', 'humorous', or 'philosophical'.", + "required": false, + "defaultValue": "inspirational" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the quote in characters to ensure brevity if needed.", + "required": false, + "defaultValue": "140" + }, + { + "name": "includeAttribution", + "type": "boolean", + "description": "Whether to append an author or source attribution to the quote.", + "required": false, + "defaultValue": "false" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the person to attribute the quote to if includeAttribution is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated quote text and optional author attribution." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate original or inspired quotes for content creation, social media posts, presentations, or motivational materials. It helps produce meaningful, contextual quotes tailored by theme and tone to enrich digital content.", + "limitations": "The tool cannot generate or verify historically accurate quotes or attribute quotes to real persons reliably when custom authorName is provided. It does not support multi-language quotes beyond English.", + "examples": [ + "Generate a motivational quote about perseverance.", + "Compose a humorous quote related to technology.", + "Create a short inspirational quote with attribution to 'Anonymous'." + ] + }, + "tags": [ + "content", + "quote", + "composition", + "inspiration", + "text-generation", + "attribution" + ], + "examples": [ + { + "inputJson": "{\"theme\":\"perseverance\",\"tone\":\"motivational\",\"maxLength\":120,\"includeAttribution\":false,\"authorName\":\"\"}", + "description": "Generate a motivational quote about perseverance up to 120 characters without attribution." + }, + { + "inputJson": "{\"theme\":\"technology\",\"tone\":\"humorous\",\"maxLength\":140,\"includeAttribution\":true,\"authorName\":\"Tech Guru\"}", + "description": "Create a humorous technology-related quote with attribution to 'Tech Guru'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Quote", + "context": null + } + }, + { + "name": "content-creation.composeWord", + "description": "Generates a new English word based on given parameters such as meaning, part of speech, length constraints, and style preferences. Accepts semantic and stylistic inputs, processes through word-formation heuristics and language models, and returns a unique word with definition and linguistic attributes.", + "category": "content-creation", + "parameters": [ + { + "name": "meaning", + "type": "string", + "description": "The semantic concept or idea the generated word should represent.", + "required": true, + "defaultValue": "" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "Grammatical category of the word: noun, verb, adjective, adverb, etc.", + "required": false, + "defaultValue": "noun" + }, + { + "name": "minLength", + "type": "number", + "description": "Minimum length of the generated word in characters.", + "required": false, + "defaultValue": "3" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word in characters.", + "required": false, + "defaultValue": "12" + }, + { + "name": "style", + "type": "string", + "description": "Preferred style of the word: formal, informal, scientific, poetic, or fantasy.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeRealWords", + "type": "boolean", + "description": "If true, the output word may use or combine existing real words; if false, the word will be entirely artificial.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word, its definition, part of speech, length, and style attributes." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create new English words to capture novel concepts, brand names, fictional terms, or jargon based on specified meanings and stylistic requirements. It aids in content creation that requires unique or evocative terminology.", + "limitations": "Cannot guarantee dictionary-valid or widely accepted words; the generated words may be novel and require validation for use. Does not translate or generate words in languages other than English.", + "examples": [ + "Generate a new noun meaning 'a device that cleans the air silently' that sounds scientific.", + "Create a poetic adjective that conveys 'radiant and mysterious' with length between 5 and 10 letters.", + "Compose a fantasy style verb for 'to teleport quickly and unexpectedly'." + ] + }, + "tags": [ + "content-creation", + "word-generation", + "linguistics", + "creative-writing", + "naming", + "branding" + ], + "examples": [ + { + "inputJson": "{\"meaning\":\"a device that cleans the air silently\",\"partOfSpeech\":\"noun\",\"minLength\":6,\"maxLength\":10,\"style\":\"scientific\",\"includeRealWords\":false}", + "description": "Generate a scientific noun for a silent air cleaning device with length between 6 and 10 characters." + }, + { + "inputJson": "{\"meaning\":\"radiant and mysterious\",\"partOfSpeech\":\"adjective\",\"minLength\":5,\"maxLength\":10,\"style\":\"poetic\",\"includeRealWords\":false}", + "description": "Create a poetic adjective word that conveys being radiant and mysterious with length between 5 and 10." + }, + { + "inputJson": "{\"meaning\":\"to teleport quickly and unexpectedly\",\"partOfSpeech\":\"verb\",\"minLength\":5,\"maxLength\":8,\"style\":\"fantasy\",\"includeRealWords\":false}", + "description": "Generate a fantasy-style verb for rapid and unexpected teleportation with word length between 5 and 8." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.composeSentence", + "description": "Generates a coherent and contextually appropriate sentence based on given input parameters such as topic, style, tone, and desired length. It processes the inputs to compose a natural language sentence suitable for content creation, summarization, or communication purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme the sentence should be about.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "The writing style for the sentence, e.g., formal, casual, academic, conversational.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "tone", + "type": "string", + "description": "The emotional tone of the sentence, such as neutral, positive, negative, humorous, or serious.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "maxLength", + "type": "number", + "description": "The maximum number of words the sentence should contain.", + "required": false, + "defaultValue": "20" + }, + { + "name": "includeKeywords", + "type": "array", + "description": "An optional list of keywords to include in the sentence for emphasis or relevance.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed sentence text and metadata about its parameters." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate a single coherent sentence that accurately and succinctly conveys a specific topic or message, customizable by style and tone. Ideal for tasks like writing assistants, content generation snippets, or generating illustrative example sentences.", + "limitations": "This tool produces only single sentences, not paragraphs or multi-sentence text. It may not capture deep domain-specific jargon nuances if overly specialized. Output depends on input clarity and parameter constraints.", + "examples": [ + "Compose a formal sentence about climate change with a serious tone.", + "Generate a casual, positive sentence about coffee including the keywords 'morning' and 'energizing'.", + "Create a short academic sentence summarizing the importance of biodiversity." + ] + }, + "tags": [ + "content", + "generation", + "sentence", + "writing", + "text", + "style", + "tone" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"climate change\",\"style\":\"formal\",\"tone\":\"serious\",\"maxLength\":25}", + "description": "Generate a formal and serious sentence on climate change up to 25 words." + }, + { + "inputJson": "{\"topic\":\"coffee\",\"style\":\"casual\",\"tone\":\"positive\",\"maxLength\":15,\"includeKeywords\":[\"morning\",\"energizing\"]}", + "description": "Create a casual and positive sentence mentioning morning and energizing about coffee." + }, + { + "inputJson": "{\"topic\":\"biodiversity\",\"style\":\"academic\",\"tone\":\"neutral\",\"maxLength\":20}", + "description": "Compose an academic style sentence about the importance of biodiversity, neutral tone, max 20 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.composeParagraph", + "description": "Generates a coherent paragraph of text based on a given topic, style, and length preference. Accepts input parameters to specify the subject matter, the tone of writing, target audience, and approximate paragraph length. Outputs a well-structured paragraph suitable for digital content creation or editing.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the paragraph content.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the paragraph such as formal, casual, persuasive, informative, or friendly.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "audience", + "type": "string", + "description": "Intended audience for the paragraph to tailor language and complexity such as general public, experts, students, or children.", + "required": false, + "defaultValue": "general public" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of sentences to be generated in the paragraph.", + "required": false, + "defaultValue": "5" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of keywords to emphasize in the paragraph for SEO or thematic focus.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to quickly generate a focused and coherent paragraph on a specified topic, matching a particular tone and suited to a defined audience. Useful for drafting articles, reports, summaries, or content blocks requiring consistent style and readability.", + "limitations": "This tool cannot produce highly specialized technical jargon without error, may lack deep domain expertise, and does not generate multi-paragraph or fully structured articles. It also may not perfectly optimize SEO or citation specifics.", + "examples": [ + "Compose a friendly paragraph about the benefits of daily exercise for a general audience.", + "Write a formal paragraph explaining the importance of cybersecurity for IT professionals.", + "Generate an informative paragraph of about 7 sentences on climate change targeted at high school students." + ] + }, + "tags": [ + "content", + "generation", + "writing", + "paragraph", + "AI", + "text", + "creative", + "composition" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"benefits of meditation\",\"tone\":\"friendly\",\"audience\":\"general public\",\"length\":5}", + "description": "Generate a friendly paragraph about benefits of meditation for a general audience with about 5 sentences." + }, + { + "inputJson": "{\"topic\":\"solar energy adoption\",\"tone\":\"informative\",\"audience\":\"students\",\"length\":6,\"keywords\":[\"renewable energy\",\"sustainability\"]}", + "description": "Generate an informative paragraph on solar energy adoption for students emphasizing renewable energy and sustainability." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.composeText", + "description": "Generates original, coherent text content based on a given prompt, tone, and length constraints. Accepts parameters like topic, style, target audience, and optional keywords to incorporate. Produces text output suitable for articles, blog posts, marketing copy, or creative writing.", + "category": "content-creation", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "The initial text or idea to inspire the composition (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or voice of the text such as formal, casual, persuasive, or friendly.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words or characters for the generated text.", + "required": false, + "defaultValue": "500" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience demographic (e.g., professionals, teenagers, general public) to tailor the language style.", + "required": false, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of important keywords or phrases to incorporate into the generated text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action in the text if appropriate.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text content as a string and metadata such as word count." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate original and contextually relevant textual content for articles, blogs, marketing materials, or other creative writing tasks, especially when a specific tone or audience focus is desired. It helps automate writing based on prompts and parameters to save time while maintaining style consistency.", + "limitations": "May not produce perfectly factual or deeply specialized content without further editing; not suitable for generating highly technical or sensitive information without expert review.", + "examples": [ + "Generate a persuasive marketing paragraph about a new eco-friendly product.", + "Write a casual blog introduction on healthy eating habits.", + "Create a formal summary article about recent technological advancements." + ] + }, + "tags": [ + "content", + "generation", + "writing", + "text", + "creative", + "marketing", + "blog" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"The benefits of daily meditation\",\"tone\":\"informative\",\"maxLength\":300,\"targetAudience\":\"general public\",\"keywords\":[\"mindfulness\",\"stress reduction\"],\"includeCallToAction\":true}", + "description": "Generate an informative article on meditation benefits incorporating specific keywords with a call to action." + }, + { + "inputJson": "{\"prompt\":\"Introducing our latest smartphone model\",\"tone\":\"persuasive\",\"maxLength\":150,\"targetAudience\":\"tech enthusiasts\",\"keywords\":[\"camera\",\"battery life\"],\"includeCallToAction\":true}", + "description": "Create a persuasive marketing text highlighting smartphone features for tech enthusiasts." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.composeReply", + "description": "Generates a context-aware, coherent reply message based on an input conversation snippet and specified tone and style preferences. Accepts original message text, optional conversation history, desired tone, and style parameters; outputs a natural language reply suitable for communications such as emails, chats, or social media responses.", + "category": "content-creation", + "parameters": [ + { + "name": "originalMessage", + "type": "string", + "description": "The primary message or query that requires a reply.", + "required": true, + "defaultValue": "" + }, + { + "name": "conversationHistory", + "type": "array", + "description": "Array of previous messages in the conversation providing context, each as a string. Optional but improves reply relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the reply (e.g., formal, friendly, professional, casual).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "style", + "type": "string", + "description": "Writing style preference (e.g., concise, detailed, empathetic).", + "required": false, + "defaultValue": "concise" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the reply (e.g., en, es). Defaults to English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the generated reply. If omitted, no strict limit.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single property 'replyMessage' which holds the generated reply text string." + }, + "aiAgent": { + "useCase": "Use this tool to generate suitable replies when an AI agent needs to respond to messages in diverse communication channels, ensuring tone and style match user or context preferences. Ideal for email assistants, chatbots, or social media response automation, enhancing engagement and professional communication.", + "limitations": "May not capture nuanced emotional context perfectly, or replace deep personal judgment in sensitive communications. Effectiveness depends on provided conversation context and clarity of tone/style parameters.", + "examples": [ + "Compose a friendly reply to a customer complaint.", + "Generate a brief professional answer to an internal email.", + "Create a casual response to a chat message about event plans." + ] + }, + "tags": [ + "content-generation", + "reply", + "communication", + "message", + "email", + "chat", + "tone", + "style" + ], + "examples": [ + { + "inputJson": "{\"originalMessage\":\"Thank you for your update on the project timeline.\",\"tone\":\"professional\",\"style\":\"concise\"}", + "description": "Generate a professional, concise reply to an email update message." + }, + { + "inputJson": "{\"originalMessage\":\"Can you help me understand the recent changes?\",\"conversationHistory\":[\"Sure, what changes are you referring to?\"],\"tone\":\"friendly\",\"style\":\"detail\",\"language\":\"en\"}", + "description": "Compose a friendly and detailed reply to clarify recent changes in a conversation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Reply", + "context": null + } + }, + { + "name": "content-creation.composeMessage", + "description": "Generates a well-structured message based on provided parameters including recipient information, message purpose, tone, and content details. It processes inputs to create a coherent message text suitable for emails, notifications, or informal communication, returning the composed message string.", + "category": "content-creation", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the person receiving the message, used to personalize content.", + "required": true, + "defaultValue": "" + }, + { + "name": "messagePurpose", + "type": "string", + "description": "The main intent of the message, such as 'meeting request', 'thank you note', or 'reminder'.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageTone", + "type": "string", + "description": "Desired tone of the message like 'formal', 'friendly', or 'urgent' to affect wording style.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "contentDetails", + "type": "string", + "description": "Additional details or key points to include in the message body.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to include a standard closing signature in the message.", + "required": false, + "defaultValue": "true" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the message sender, used in signature or closing if included.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed message as a text string under the key 'messageText'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a customized message for communication, adapting style and content to specific recipients and purposes. Ideal for automating email drafts, customer notifications, or personalized outreach messages requiring coherent and context-aware text generation.", + "limitations": "This tool does not send or deliver the message; it only composes text. It cannot personalize messages based on recipient behavior or history beyond provided inputs, and does not support multilingual composition beyond the input language.", + "examples": [ + "Compose a formal meeting invitation email to a project stakeholder named Alice including meeting agenda details.", + "Generate a friendly thank-you note to a colleague named Bob after receiving assistance on a task.", + "Create an urgent reminder message about an approaching deadline for a client named Carol with polite closing." + ] + }, + "tags": [ + "content-creation", + "message-composition", + "email-drafting", + "communication", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Alice\",\"messagePurpose\":\"meeting invitation\",\"messageTone\":\"formal\",\"contentDetails\":\"Please join the project update call scheduled for Wednesday at 3 PM.\",\"includeSignature\":true,\"senderName\":\"John\"}", + "description": "Compose a formal meeting invitation email for recipient Alice with meeting details and signature." + }, + { + "inputJson": "{\"recipientName\":\"Bob\",\"messagePurpose\":\"thank you note\",\"messageTone\":\"friendly\",\"contentDetails\":\"Thanks for helping with the report last week!\",\"includeSignature\":true,\"senderName\":\"John\"}", + "description": "Generate a friendly thank-you note to Bob expressing gratitude and including sender signature." + }, + { + "inputJson": "{\"recipientName\":\"Carol\",\"messagePurpose\":\"deadline reminder\",\"messageTone\":\"urgent\",\"contentDetails\":\"The submission deadline is tomorrow at noon.\",\"includeSignature\":false,\"senderName\":\"\"}", + "description": "Create an urgent reminder message for Carol about an approaching deadline without signature." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Message", + "context": null + } + }, + { + "name": "content-creation.composeComment", + "description": "Generates a coherent and contextually relevant comment based on given input parameters such as the topic, tone, and length preferences. The tool accepts a subject and optional style instructions to compose a natural language comment suitable for social media, forums, or feedback sections.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The subject or theme on which to base the comment.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the comment, e.g., friendly, professional, humorous, or critical.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the comment in words.", + "required": false, + "defaultValue": "50" + }, + { + "name": "targetPlatform", + "type": "string", + "description": "The platform where the comment will be posted, influencing style (e.g., Twitter, Reddit, Blog).", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call-to-action in the comment if relevant.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed comment text as a string under the 'commentText' field." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate human-like comments related to a specific topic, adjusting tone and length for social media posts, blog feedback, or discussion forums. It helps automate thoughtful responses or engagement messages suited for various platforms.", + "limitations": "This tool cannot guarantee the factual accuracy of the comment content and should not be used to generate comments requiring expert domain knowledge without verification. It may also not handle extremely niche or ambiguous topics effectively.", + "examples": [ + "Generate a friendly 40-word comment about environmental conservation for a Reddit post.", + "Write a professional 100-word comment giving feedback on a product review.", + "Create a humorous short comment about a new tech gadget announcement." + ] + }, + "tags": [ + "content creation", + "comment generation", + "social media", + "feedback", + "natural language generation", + "tone control" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"The benefits of meditation\",\"tone\":\"friendly\",\"length\":60}", + "description": "Compose a friendly comment approximately 60 words long about the benefits of meditation." + }, + { + "inputJson": "{\"topic\":\"New company policy changes\",\"tone\":\"professional\",\"length\":100,\"includeCallToAction\":true}", + "description": "Generate a professional, about 100-word comment discussing new company policy changes including a call to action." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Comment", + "context": null + } + }, + { + "name": "content-creation.composeNotification", + "description": "Generates a formatted notification message based on input parameters including recipient info, notification type, message content, urgency level, and optional actions. Produces a structured notification object ready for sending or display in apps.", + "category": "content-creation", + "parameters": [ + { + "name": "recipient", + "type": "object", + "description": "Details of the notification recipient including id and optional name or contact.", + "required": true, + "defaultValue": "" + }, + { + "name": "notificationType", + "type": "string", + "description": "Category of the notification such as 'alert', 'reminder', or 'update'.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The main text content of the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "urgencyLevel", + "type": "string", + "description": "Indicates urgency, e.g., 'low', 'medium', or 'high'.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "actions", + "type": "array", + "description": "Array of optional action buttons or links the user can engage with, each with label and url.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for message localization, e.g., 'en', 'es'.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Structured notification object including recipient, type, content, urgency, actions, and metadata ready for use in notification systems." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically compose notifications for users in different contexts such as alerts, reminders, or updates, ensuring consistent formatting and inclusion of optional interactive actions and proper urgency tagging. It supports multi-language content and personalized recipient data to tailor the notification.", + "limitations": "Does not send or deliver notifications; only composes and formats message content. It does not generate rich media or attachments beyond plain text and action links.", + "examples": [ + "Compose a high urgency alert notification for user id 123 with a link to view details.", + "Generate a reminder notification in Spanish with two action buttons for confirming or rescheduling.", + "Create an update notification with medium urgency and no actions for multiple recipients." + ] + }, + "tags": [ + "content", + "notification", + "compose", + "messaging", + "alerts", + "reminders" + ], + "examples": [ + { + "inputJson": "{\"recipient\":{\"id\":\"user123\",\"name\":\"Alice\"},\"notificationType\":\"alert\",\"messageContent\":\"Your account password has been changed successfully.\",\"urgencyLevel\":\"high\",\"actions\":[{\"label\":\"Review Activity\",\"url\":\"https://example.com/activity\"}],\"language\":\"en\"}", + "description": "Compose a high urgency alert notification for user Alice with an action to review activity." + }, + { + "inputJson": "{\"recipient\":{\"id\":\"user456\"},\"notificationType\":\"reminder\",\"messageContent\":\"No olvides tu cita mañana a las 10 AM.\",\"urgencyLevel\":\"medium\",\"actions\":[{\"label\":\"Confirmar\",\"url\":\"https://example.com/confirm\"},{\"label\":\"Reprogramar\",\"url\":\"https://example.com/reschedule\"}],\"language\":\"es\"}", + "description": "Generate a reminder notification in Spanish with two action buttons for confirming or rescheduling." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Notification", + "context": null + } + }, + { + "name": "content-creation.composeChannel", + "description": "Generates a detailed communication channel plan for content distribution. Accepts inputs such as channel type (e.g., email, social media), target audience demographics, message objectives, and scheduling preferences. Outputs a structured content channel plan including recommended message formats, posting schedules, and audience targeting recommendations.", + "category": "content-creation", + "parameters": [ + { + "name": "channelType", + "type": "string", + "description": "Type of communication channel to compose content for, e.g., 'email', 'socialMedia', 'blog', or 'sms'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "object", + "description": "Demographic and psychographic information describing the intended audience, e.g., age range, interests, location.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageObjectives", + "type": "array", + "description": "List of objectives the message should accomplish, e.g., ['brand awareness', 'lead generation'].", + "required": true, + "defaultValue": "" + }, + { + "name": "postingFrequencyPerWeek", + "type": "number", + "description": "Number of content pieces to post per week on this channel.", + "required": false, + "defaultValue": "3" + }, + { + "name": "preferredContentFormats", + "type": "array", + "description": "Preferred content formats suitable for the channel such as ['text', 'image', 'video'].", + "required": false, + "defaultValue": "[\"text\"]" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 date string representing the starting date for the channel content schedule.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Structured content channel plan including recommended message formats, posting schedules with timestamps, targeting recommendations, and channel-specific best practices." + }, + "aiAgent": { + "useCase": "Use this tool when designing or optimizing digital communication strategies across multiple channels. It helps AI agents recommend tailored content distribution plans based on audience and marketing objectives, improving engagement and reach.", + "limitations": "This tool does not generate actual message content or creative copy. It focuses on planning and scheduling strategy, not content creation itself.", + "examples": [ + "Create a social media channel plan targeting millennials interested in fitness with 5 posts per week focusing on brand awareness.", + "Compose an email channel strategy for B2B clients emphasizing lead generation with bi-weekly newsletters starting next Monday.", + "Design a blog content channel for local audiences focusing on community events with 2 posts per week." + ] + }, + "tags": [ + "content-creation", + "channel-planning", + "communication", + "marketing", + "strategy", + "social-media", + "email", + "scheduling" + ], + "examples": [ + { + "inputJson": "{\"channelType\":\"socialMedia\",\"targetAudience\":{\"ageRange\":\"18-35\",\"interests\":[\"fitness\",\"wellness\"],\"location\":\"USA\"},\"messageObjectives\":[\"brand awareness\"],\"postingFrequencyPerWeek\":5,\"preferredContentFormats\":[\"image\",\"video\"],\"startDate\":\"2024-07-01\"}", + "description": "Plan a social media channel content strategy targeting US millennials interested in fitness with 5 posts per week starting July 1, using images and videos." + }, + { + "inputJson": "{\"channelType\":\"email\",\"targetAudience\":{\"industry\":\"technology\",\"jobTitles\":[\"CTO\",\"Developer\"]},\"messageObjectives\":[\"lead generation\"],\"postingFrequencyPerWeek\":2,\"preferredContentFormats\":[\"text\"],\"startDate\":\"2024-06-15\"}", + "description": "Compose an email communication channel plan targeting tech professionals for lead generation purposes, sending 2 emails per week starting June 15." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Channel", + "context": null + } + }, + { + "name": "content-creation.composeMention", + "description": "Generates a properly formatted mention string for a user or entity within digital content, such as social media posts, comments, or documentation. It accepts a username or entity identifier and optional display text to create a mention string compatible with platforms that support '@' mentions or customizable mention syntaxes.", + "category": "content-creation", + "parameters": [ + { + "name": "username", + "type": "string", + "description": "The exact username or identifier to mention. Required for generating a valid mention.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "Optional text to display instead of the raw username in the mention. If empty, the username is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "Target platform or system for which to format the mention (e.g., 'twitter', 'slack', 'github'). Determines mention syntax. Defaults to 'generic' which uses '@username'.", + "required": false, + "defaultValue": "generic" + }, + { + "name": "includeAtSymbol", + "type": "boolean", + "description": "Whether to prepend an '@' symbol to the mention. Defaults to true, but some platforms may not use '@'.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted mention string compatible with the specified platform." + }, + "aiAgent": { + "useCase": "Use this tool when generating user or entity mentions within digital content that require proper formatting for specific platforms or standardized '@' notation. It ensures mentions are syntactically correct to trigger notifications or highlight users appropriately.", + "limitations": "This tool does not verify the validity or existence of usernames, nor does it handle multiple mentions in one call. It is limited to formatting a single mention string based on input parameters and known platform syntaxes.", + "examples": [ + "Generate a Twitter mention for user 'johndoe'.", + "Create a Slack mention with custom display text for user id 'U12345'.", + "Format a generic mention without the '@' symbol for a username 'alice'." + ] + }, + "tags": [ + "content-creation", + "mention", + "social", + "communication", + "text-formatting", + "platform-specific" + ], + "examples": [ + { + "inputJson": "{\"username\":\"johndoe\",\"platform\":\"twitter\"}", + "description": "Generate a Twitter mention for 'johndoe', should output '@johndoe'." + }, + { + "inputJson": "{\"username\":\"U12345\",\"displayText\":\"John Doe\",\"platform\":\"slack\"}", + "description": "Create a Slack platform mention using user ID with display text, e.g., '<@U12345|John Doe>'." + }, + { + "inputJson": "{\"username\":\"alice\",\"includeAtSymbol\":false}", + "description": "Generate a generic mention without '@', just 'alice'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Mention", + "context": null + } + }, + { + "name": "content-creation.composeThread", + "description": "Generates a structured communication thread based on given topic, initial message, and participant details. Accepts topic string, starter message, participant list, and optional thread style settings, then outputs a formatted thread object ready for digital communication platforms.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or title of the communication thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "initialMessage", + "type": "string", + "description": "The first message initiating the thread, providing context or a question.", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "List of participant user IDs or names involved in the thread.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "threadStyle", + "type": "object", + "description": "Optional settings to customize thread formatting such as message order, anonymity, or priority flags.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A complete thread object including topic, messages array starting with the initial message, participant details, and metadata for thread management." + }, + "aiAgent": { + "useCase": "Use this tool to create new discussion threads or conversations in messaging, forum, or collaboration platforms where structured initial content and participant metadata are required to initialize a thread.", + "limitations": "This tool cannot post the thread to external platforms or manage live real-time messaging; it only prepares the structured thread data object.", + "examples": [ + "Create a new project discussion thread with a kickoff message and specified team members.", + "Generate a customer support thread starting with an initial inquiry message and a list of assigned agents.", + "Compose a forum topic thread with a detailed question and participant list for a specialized community." + ] + }, + "tags": [ + "content creation", + "thread", + "communication", + "messaging", + "discussion", + "collaboration" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Q2 Marketing Strategy\",\"initialMessage\":\"Let's discuss the main goals and campaigns for Q2.\",\"participants\":[\"alice\",\"bob\",\"carol\"],\"threadStyle\":{\"messageOrder\":\"chronological\",\"priority\":\"high\"}}", + "description": "Creating a marketing discussion thread with three participants and prioritized as high." + }, + { + "inputJson": "{\"topic\":\"Support Ticket #4567\",\"initialMessage\":\"Customer reported an issue with login.\",\"participants\":[\"agent_john\",\"agent_mary\"],\"threadStyle\":{\"anonymity\":false}}", + "description": "Composing a support ticket thread starting with initial customer problem and two support agents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Thread", + "context": null + } + }, + { + "name": "content-creation.composeReadme", + "description": "Generates a professional README.md file for software projects by accepting inputs like project name, description, installation instructions, usage guidelines, contribution rules, license info, and contact details. Processes these inputs to compose a well-structured markdown document ready for repository inclusion.", + "category": "content-creation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the software project to include in the README title.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief description summarizing the project's purpose and functionality.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions for installing the project or dependencies.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageInformation", + "type": "string", + "description": "Details on how to use the project after installation, including example commands or code snippets.", + "required": false, + "defaultValue": "" + }, + { + "name": "contributionGuidelines", + "type": "string", + "description": "Guidelines for contributing to the project like pull request process and code style.", + "required": false, + "defaultValue": "" + }, + { + "name": "license", + "type": "string", + "description": "The license under which the project is released (e.g., MIT, Apache 2.0).", + "required": false, + "defaultValue": "" + }, + { + "name": "contactInformation", + "type": "string", + "description": "Contact details or links for users needing help or wanting to get in touch with maintainers.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object with one key 'readmeContent' containing the full README.md text string formatted in markdown." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a clear, well-structured README file for a software project based on provided project metadata. Ideal to assist developers in creating consistent documentation without manually formatting markdown. It handles typical sections and organizes content for repository display.", + "limitations": "Does not create highly customized or dynamic badges, build status links, or deeply technical API documentation sections. It produces a general README template but not project-specific advanced docs.", + "examples": [ + "Create a README for a Python library named 'DataCleaner' with installation, usage, and MIT license.", + "Generate README content for a web app project with contribution guidelines and contact info.", + "Make a simple README including project name and description only." + ] + }, + "tags": [ + "content-creation", + "documentation", + "markdown", + "readme", + "software-project", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"DataCleaner\",\"projectDescription\":\"A Python library for efficient data cleaning and preprocessing.\",\"installationInstructions\":\"pip install datacleaner\",\"usageInformation\":\"import datacleaner\\ncleaned = datacleaner.clean(data)\",\"contributionGuidelines\":\"Please fork the repo and submit pull requests.\",\"license\":\"MIT\",\"contactInformation\":\"email: dev@datacleaner.com\"}", + "description": "Generating a full README for a Python library with all common sections." + }, + { + "inputJson": "{\"projectName\":\"MyWebApp\",\"projectDescription\":\"A modern web application built with React and Node.js.\",\"installationInstructions\":\"npm install && npm start\",\"usageInformation\":\"Navigate to localhost:3000 to view the app.\",\"contributionGuidelines\":\"Open issues or pull requests are welcome.\",\"license\":\"Apache 2.0\",\"contactInformation\":\"https://github.com/mywebapp\"}", + "description": "Creating README for a web app with usage and contribution guidelines." + }, + { + "inputJson": "{\"projectName\":\"QuickScript\",\"projectDescription\":\"Simple command-line tool to automate tasks.\"}", + "description": "Minimal README with only name and description provided." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Readme", + "context": null + } + }, + { + "name": "content-creation.composeFAQ", + "description": "Generates a structured Frequently Asked Questions (FAQ) document based on a provided list of questions and answers, optionally tailored to a specific topic or style. Accepts an array of Q&A pairs and outputs a formatted FAQ suitable for web or document inclusion.", + "category": "content-creation", + "parameters": [ + { + "name": "questionsAnswers", + "type": "array", + "description": "An array of objects each containing 'question' and 'answer' strings to include in the FAQ.", + "required": true, + "defaultValue": "" + }, + { + "name": "topic", + "type": "string", + "description": "Optional topic or subject to contextualize and focus the FAQ content.", + "required": false, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Optional style of the FAQ output, e.g., 'formal', 'conversational', or 'technical'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeIntro", + "type": "boolean", + "description": "Whether to include a brief introduction paragraph summarizing the FAQ content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxAnswerLength", + "type": "number", + "description": "Maximum character length for answers; longer answers will be summarized to this length.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed FAQ as a formatted string and optionally metadata like question count." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly create a clear, organized FAQ document from a list of questions and answers, especially to enhance content clarity on websites, help documents, or product manuals. It helps in providing consistent answers in a user-friendly format.", + "limitations": "Cannot generate questions or answers from scratch; requires input Q&A pairs. It does not handle multimedia content or highly technical formatting like collapsible sections or embedded links.", + "examples": [ + "Generate a FAQ for a software product based on given user questions and support answers.", + "Create a conversational style FAQ for a website's customer support page.", + "Summarize long answers to keep the FAQ concise and clear." + ] + }, + "tags": [ + "content creation", + "FAQ", + "documentation", + "customer support", + "content formatting" + ], + "examples": [ + { + "inputJson": "{\"questionsAnswers\":[{\"question\":\"How do I reset my password?\",\"answer\":\"To reset your password, click on the 'Forgot Password' link on the login page and follow the instructions sent to your email.\"},{\"question\":\"What payment methods do you accept?\",\"answer\":\"We accept all major credit cards, PayPal, and bank transfers.\"}],\"topic\":\"Account Management\",\"style\":\"formal\",\"includeIntro\":true,\"maxAnswerLength\":300}", + "description": "Creating a formal FAQ about account management with two Q&A pairs and including an introductory paragraph." + }, + { + "inputJson": "{\"questionsAnswers\":[{\"question\":\"Can I use this software offline?\",\"answer\":\"Yes, the software supports offline usage except for features that require internet access like real-time collaboration.\"}],\"topic\":\"Software Usage\",\"style\":\"conversational\",\"includeIntro\":false,\"maxAnswerLength\":200}", + "description": "Generating a short conversational FAQ entry about software offline capabilities without an intro." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "FAQ", + "context": null + } + }, + { + "name": "content-creation.composeTemplate", + "description": "Generates a document template based on a specified type and optional content placeholders. Accepts template type and customizable fields, applies predefined layouts and formats, and outputs a structured template string ready for further editing or use.", + "category": "content-creation", + "parameters": [ + { + "name": "templateType", + "type": "string", + "description": "The category of template to compose, e.g., 'invoice', 'report', 'letter'. Determines the layout and included sections.", + "required": true, + "defaultValue": "" + }, + { + "name": "placeholders", + "type": "object", + "description": "Key-value pairs defining placeholder names and default text or variable markers to include in the template.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "includeInstructions", + "type": "boolean", + "description": "Whether to include inline instructions or comments describing each section or placeholder in the template.", + "required": false, + "defaultValue": "false" + }, + { + "name": "format", + "type": "string", + "description": "Output document format. Options include 'plainText', 'markdown', 'html'. Controls how template is rendered.", + "required": false, + "defaultValue": "plainText" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the composed template as a string under 'templateContent', and metadata such as templateType and placeholders included." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce standardized document templates with customizable placeholders for users, such as creating invoices, reports, or letters with a defined structure. It helps automate template generation for digital content management workflows.", + "limitations": "It cannot fill placeholders with real data; it only composes the template skeleton. Complex formatting beyond basic layouts is not supported. It does not generate fully final documents but reusable templates.", + "examples": [ + "Generate a basic invoice template with predefined placeholders.", + "Create a report template including inline instructions for sections.", + "Compose a letter template formatted in markdown with placeholders for recipient and date." + ] + }, + "tags": [ + "template", + "document", + "content-creation", + "automation", + "compose", + "layout", + "placeholders" + ], + "examples": [ + { + "inputJson": "{\"templateType\":\"invoice\",\"placeholders\":{\"clientName\":\"[Client Name]\",\"invoiceNumber\":\"[Invoice Number]\",\"date\":\"[Date]\"},\"includeInstructions\":true,\"format\":\"plainText\"}", + "description": "Compose a plain text invoice template with placeholders and inline instructions." + }, + { + "inputJson": "{\"templateType\":\"report\",\"placeholders\":{\"title\":\"[Report Title]\",\"summary\":\"[Executive Summary]\",\"date\":\"[Date]\"},\"includeInstructions\":false,\"format\":\"markdown\"}", + "description": "Generate a markdown report template with basic placeholders but no instructions." + }, + { + "inputJson": "{\"templateType\":\"letter\",\"placeholders\":{\"recipient\":\"[Recipient Name]\",\"sender\":\"[Sender Name]\",\"date\":\"[Date]\"},\"includeInstructions\":true,\"format\":\"html\"}", + "description": "Create an HTML letter template including placeholders and inline instructional comments." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Template", + "context": null + } + }, + { + "name": "content-creation.composeChecklist", + "description": "Generates a structured checklist document based on a given title, description, and a list of items. Accepts checklist metadata and tasks, and produces a formatted checklist with optional item priorities and completion status fields for task tracking.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title or heading of the checklist to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A brief description or purpose of the checklist to provide context.", + "required": false, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "An array of checklist item objects, each specifying the task description and optional properties like priority and completion status.", + "required": true, + "defaultValue": "" + }, + { + "name": "includePriority", + "type": "boolean", + "description": "Flag indicating whether to include priority levels for each item in the checklist.", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeCompletionStatus", + "type": "boolean", + "description": "Flag indicating whether to include a completion status field (e.g., checkbox) for each checklist item.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed checklist with title, description, and an array of formatted checklist items including optional priority and completion status fields." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a clear and organized checklist document for task tracking, onboarding, quality control, or project management based on user-provided tasks and metadata. It helps structure raw tasks into a formal checklist format suitable for presentation or further processing.", + "limitations": "This tool does not support dynamic updating of checklist item states after creation or integrate with external project management systems. It only formats the provided input into a checklist structure.", + "examples": [ + "Create a daily onboarding checklist with tasks and indicate priority for each.", + "Generate a quality assurance checklist with completion status for each step.", + "Compose a packing checklist for travel without priorities but with checkboxes." + ] + }, + "tags": [ + "content", + "checklist", + "task management", + "document generation", + "productivity", + "workflow" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Website Launch Checklist\",\"description\":\"Steps to complete before launching the new website.\",\"items\":[{\"task\":\"Finalize design mockups\",\"priority\":\"High\"},{\"task\":\"Test all links and forms\",\"priority\":\"Medium\"},{\"task\":\"Prepare press release\"}],\"includePriority\":true,\"includeCompletionStatus\":true}", + "description": "Generating a website launch checklist including task priorities and completion checkboxes." + }, + { + "inputJson": "{\"title\":\"Daily Health Checklist\",\"items\":[{\"task\":\"Take vitamins\"},{\"task\":\"Drink 8 glasses of water\"},{\"task\":\"30 minutes exercise\"}],\"includePriority\":false,\"includeCompletionStatus\":true}", + "description": "Creating a simple daily health checklist with checkboxes but no priorities." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Checklist", + "context": null + } + }, + { + "name": "content-creation.composeTranscript", + "description": "Composes a structured written transcript from audio/video input or text segments. Accepts raw media files or timestamped subtitle snippets, processes speech recognition and formatting, and outputs a clean, readable transcript suitable for documentation, accessibility, and archival purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "mediaUrl", + "type": "string", + "description": "URL of the audio or video file to transcribe. Provide either mediaUrl or subtitleSegments.", + "required": false, + "defaultValue": "" + }, + { + "name": "subtitleSegments", + "type": "array", + "description": "Array of subtitle segment objects with startTime, endTime, and text to compose transcript from pre-existing text segments.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the audio or text segments to optimize transcription accuracy. Defaults to 'en'.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include timestamps inline in the transcript output. Defaults to false for cleaner text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "formattingStyle", + "type": "string", + "description": "Formatting style for the output transcript such as 'plain', 'paragraph', or 'subtitle'. Defaults to 'paragraph'.", + "required": false, + "defaultValue": "paragraph" + }, + { + "name": "speakerLabels", + "type": "boolean", + "description": "Whether to attempt speaker diarization and label speakers in the transcript. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object containing the composed transcript text and metadata such as word count and detected language." + }, + "aiAgent": { + "useCase": "Use this tool to generate accurate and well-formatted transcripts from media files or subtitle data for meetings, interviews, lectures, or video content. It is helpful when creating accessible content, searchable records, or textual documentation from audio or video sources.", + "limitations": "The tool depends on the quality of input audio or text segments. It cannot correct errors in the original recording nor generate transcripts without any input media or text. Speaker diarization may be imperfect for overlapping speech or noisy environments.", + "examples": [ + "Generate a written transcript from this conference video URL.", + "Compose a transcript from provided timestamped subtitle segments in English.", + "Produce a paragraph formatted transcript with speaker labels from this podcast audio file." + ] + }, + "tags": [ + "transcription", + "content-creation", + "media-processing", + "accessibility", + "document-generation" + ], + "examples": [ + { + "inputJson": "{\"mediaUrl\":\"https://example.com/meeting_audio.mp3\",\"language\":\"en\",\"includeTimestamps\":true,\"formattingStyle\":\"paragraph\",\"speakerLabels\":true}", + "description": "Generate a paragraph-formatted transcript with speaker labels and timestamps from an English meeting audio file." + }, + { + "inputJson": "{\"subtitleSegments\":[{\"startTime\":0.0,\"endTime\":2.5,\"text\":\"Welcome everyone.\"},{\"startTime\":2.5,\"endTime\":5.0,\"text\":\"Let's start the presentation.\"}],\"formattingStyle\":\"subtitle\",\"includeTimestamps\":false}", + "description": "Compose a transcript from an array of subtitle segments, outputting subtitle-style format without timestamps." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Transcript", + "context": null + } + }, + { + "name": "content-creation.composeMinutes", + "description": "This tool generates structured meeting minutes from provided meeting details such as agenda topics, participants, discussion points, decisions, and action items. It processes input data to produce a clear, organized minutes document in text or JSON format suitable for record-keeping and sharing.", + "category": "content-creation", + "parameters": [ + { + "name": "meetingTitle", + "type": "string", + "description": "The title or subject of the meeting to be documented.", + "required": true, + "defaultValue": "" + }, + { + "name": "meetingDate", + "type": "string", + "description": "The date of the meeting in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "participants", + "type": "array", + "description": "List of participant names attending the meeting.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "agendaItems", + "type": "array", + "description": "Array of agenda topics to be covered during the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discussionPoints", + "type": "array", + "description": "Discussion details for each agenda item, including key points raised.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "decisions", + "type": "array", + "description": "List of decisions made during the meeting, linked to agenda items if applicable.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "actionItems", + "type": "array", + "description": "Tasks assigned during the meeting, with responsible persons and deadlines if available.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format for the minutes document: 'text' for plain text or 'json' for structured JSON.", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted meeting minutes as a string in the requested format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent must generate clear and formal meeting minutes from raw meeting data inputs, such as agendas, discussions, and decisions, to provide a summary suitable for participants and record-keeping. It is ideal for automating documentation after virtual or in-person meetings.", + "limitations": "This tool generates minutes based on provided structured inputs and does not perform raw transcription from audio or video. It cannot infer missing information not supplied by the user.", + "examples": [ + "Generate minutes from a weekly team meeting with agendas, discussions, and actions.", + "Create a text summary of decisions and tasks from project kickoff meeting data.", + "Provide JSON formatted minutes for automated workflow integration." + ] + }, + "tags": [ + "content creation", + "document generation", + "meeting documentation", + "automation", + "minutes", + "productivity" + ], + "examples": [ + { + "inputJson": "{\"meetingTitle\":\"Weekly Team Sync\",\"meetingDate\":\"2024-06-01\",\"participants\":[\"Alice\",\"Bob\",\"Charlie\"],\"agendaItems\":[\"Project Status\",\"Risk Review\"],\"discussionPoints\":[{\"topic\":\"Project Status\",\"points\":[\"Alice reported progress on milestone 1\",\"Bob highlighted delay due to vendor\"],\"decisions\":[\"Adjust deadline for milestone 2\"]}],\"decisions\":[\"Approve revised timeline\"],\"actionItems\":[{\"task\":\"Bob to contact vendor\",\"owner\":\"Bob\",\"dueDate\":\"2024-06-05\"}],\"outputFormat\":\"text\"}", + "description": "Compose detailed text minutes for a weekly team sync meeting with agenda, discussions, decisions, and action items." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Minutes", + "context": null + } + }, + { + "name": "content-creation.composeBrief", + "description": "Generates a concise briefing document based on provided key points, target audience, and purpose. Accepts inputs like topic, objectives, key messages, and intended length, then produces a structured brief that can be used for project kickoffs, marketing plans, or meeting overviews.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or theme of the brief to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "List of goals or objectives the brief should address.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "keyMessages", + "type": "array", + "description": "Core messages or points to highlight in the brief.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience for the brief.", + "required": false, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Overall purpose or intention of the brief (e.g., inform, persuade, instruct).", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the brief in words.", + "required": false, + "defaultValue": "300" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the brief (e.g., formal, casual, motivational).", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated brief text and its metadata, including word count and summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a succinct, structured overview document that captures main points and objectives for internal or external communication, aiding users in quickly creating professional briefs without manual drafting.", + "limitations": "This tool cannot replace subject matter expertise and may produce generalized content that requires user review. It does not provide detailed analyses or deep research content.", + "examples": [ + "Create a brief for a product launch targeting marketing team members to align on key messages.", + "Generate a 250-word briefing to summarize project goals and deliverables for stakeholders.", + "Compose a casual tone briefing for an internal team meeting outlining objectives and agenda." + ] + }, + "tags": [ + "content creation", + "document generation", + "brief", + "summary", + "business", + "marketing", + "communication" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"New Mobile App Launch\",\"objectives\":[\"Inform the marketing team\",\"Align on messaging\",\"Define launch goals\"],\"keyMessages\":[\"Innovative features\",\"User-friendly design\",\"Competitive pricing\"],\"targetAudience\":\"Marketing team\",\"purpose\":\"Align internal communication\",\"length\":300,\"tone\":\"formal\"}", + "description": "Generate a formal brief for marketing team to align on a new app launch." + }, + { + "inputJson": "{\"topic\":\"Quarterly Sales Review\",\"objectives\":[\"Summarize sales data\",\"Highlight challenges\",\"Plan next quarter\"],\"keyMessages\":[\"Revenue increased by 10%\",\"Customer retention improved\",\"Expand sales team\"],\"targetAudience\":\"Sales department\",\"purpose\":\"Inform and motivate team\",\"length\":250,\"tone\":\"motivational\"}", + "description": "Create a motivational brief summarizing quarterly sales for the sales team." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Brief", + "context": null + } + }, + { + "name": "content-creation.composeArticle", + "description": "Generates a coherent and structured article based on given topics, keywords, and style preferences. Accepts parameters to tailor article length, tone, and target audience, then produces a well-organized article text and summary suitable for publishing or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the article to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of key terms that should be covered or emphasized in the article.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the article in words.", + "required": false, + "defaultValue": "800" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of the article, such as formal, casual, persuasive, or informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readership, e.g., general public, experts, students.", + "required": false, + "defaultValue": "general public" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to generate a short summary or abstract for the article.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete article text and an optional summary if requested." + }, + "aiAgent": { + "useCase": "Use this tool to create original articles from scratch or based on provided topics and keywords. Ideal for generating blog posts, informational content, or drafts that require customization in tone and length. Useful when a structured, coherent article is needed without manual writing.", + "limitations": "Does not guarantee factual accuracy or citations. May require human review for complex or technical topics. Cannot create articles with multimedia content or interactive elements.", + "examples": [ + "Compose an 800-word informative article titled 'The Future of Renewable Energy' targeting general readers, emphasizing solar and wind power.", + "Generate a formal article about the impact of AI in healthcare for an expert audience, with a persuasive tone.", + "Create a casual blog post titled 'Top 5 Travel Destinations for 2024' with a summary, focusing on keywords like 'adventure', 'culture', and 'budget-friendly'." + ] + }, + "tags": [ + "content-creation", + "article-generation", + "writing", + "blog", + "informational", + "text-generation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Future of Renewable Energy\",\"keywords\":[\"solar power\",\"wind power\",\"sustainability\"],\"length\":800,\"tone\":\"informative\",\"targetAudience\":\"general public\",\"includeSummary\":true}", + "description": "Generate an informative article about renewable energy focusing on solar and wind power for general readers, about 800 words, with a summary." + }, + { + "inputJson": "{\"title\":\"Impact of AI in Healthcare\",\"keywords\":[\"AI\",\"healthcare\",\"technology\",\"patient care\"],\"length\":1000,\"tone\":\"formal\",\"targetAudience\":\"experts\",\"includeSummary\":false}", + "description": "Create a formal article addressing the impact of AI on healthcare intended for expert readers, about 1000 words, no summary." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Article", + "context": null + } + }, + { + "name": "content-creation.composeBlogPost", + "description": "Generates a complete blog post based on provided topics, keywords, desired length, and style preferences. It processes the input parameters to create a coherent, structured article including title, introduction, body sections, and conclusion. Outputs the blog post content as formatted text ready for publishing or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the blog post to focus the content.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases to be incorporated naturally throughout the blog post to improve SEO relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the blog post (e.g., casual, professional, humorous).", + "required": false, + "defaultValue": "professional" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target readership to tailor language and complexity (e.g., beginners, experts).", + "required": false, + "defaultValue": "" + }, + { + "name": "wordCount", + "type": "number", + "description": "Approximate desired word count for the entire blog post.", + "required": false, + "defaultValue": "800" + }, + { + "name": "includeSections", + "type": "array", + "description": "Optional list of section headings to structure the blog post (e.g., Introduction, Benefits, Conclusion).", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated blog post with title, full content, and optionally structured sections as text." + }, + "aiAgent": { + "useCase": "When needing to rapidly generate a coherent, SEO-friendly blog post tailored to specific topics, keywords, and audience preferences, this tool provides a streamlined content creation starting point. Ideal for content marketing, rapid prototyping, draft creation, or bulk blog writing automation.", + "limitations": "The tool cannot replace expert domain knowledge or human editing for accuracy and creativity. It may produce generic or formulaic content and might require fact-checking and style polishing by a human editor.", + "examples": [ + "Create a blog post about sustainable living incorporating keywords like 'eco-friendly,' 'carbon footprint,' and 'renewable energy' with a casual tone for beginners.", + "Generate a professional blog article targeting software developers explaining the benefits of TypeScript with approximately 1200 words.", + "Compose a blog post titled 'The Future of Remote Work' with sections Introduction, Challenges, Opportunities, and Conclusion." + ] + }, + "tags": [ + "content creation", + "blog writing", + "SEO", + "content marketing", + "article generation", + "AI writing", + "digital content" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Benefits of Meditation\",\"keywords\":[\"mindfulness\",\"stress relief\",\"mental health\"],\"tone\":\"calm\",\"targetAudience\":\"general public\",\"wordCount\":700}", + "description": "Generate a 700-word calm toned blog post aimed at the general public about the benefits of meditation including mindfulness, stress relief, and mental health." + }, + { + "inputJson": "{\"title\":\"Top 10 JavaScript Frameworks in 2024\",\"keywords\":[\"JavaScript\",\"frameworks\",\"web development\"],\"tone\":\"professional\",\"targetAudience\":\"web developers\",\"wordCount\":1000,\"includeSections\":[\"Introduction\",\"Framework List\",\"Comparison\",\"Conclusion\"]}", + "description": "Create a 1000-word professional blog post for web developers listing and comparing the top 10 JavaScript frameworks in 2024 with specified sections." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "BlogPost", + "context": null + } + }, + { + "name": "content-creation.composeSummary", + "description": "Generates a concise summary from a given text or document. Accepts input text, summarizes key points, optionally targets a specific summary length or style, and outputs a clear, coherent summary suitable for quick understanding or content preview.", + "category": "content-creation", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The full text or document content to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length (in characters) for the summary. If not set, defaults to a moderate length summary.", + "required": false, + "defaultValue": "500" + }, + { + "name": "style", + "type": "string", + "description": "The tone or style of the summary, e.g. 'formal', 'informal', 'technical'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeHighlights", + "type": "boolean", + "description": "Whether to include bullet point highlights in addition to the summary text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summary text and optionally bullet points if requested." + }, + "aiAgent": { + "useCase": "Use this tool to generate quick, human-readable summaries of long documents or articles to help users grasp key information efficiently. Useful for briefing, content curation, or preview generation.", + "limitations": "May not capture highly nuanced or context-dependent meanings accurately. Not intended for summarizing very short texts or texts full of ambiguous references.", + "examples": [ + "Summarize a research paper abstract into a 200-character formal summary.", + "Generate an informal, bullet-point summary of a news article for social media posting.", + "Create a brief technical summary from long software documentation." + ] + }, + "tags": [ + "summary", + "content-creation", + "document", + "text-processing", + "abstraction" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"Artificial intelligence (AI) is intelligence demonstrated by machines, unlike the natural intelligence displayed by humans and animals. AI applications include advanced web search engines, recommendation systems, and autonomous vehicles.\",\"maxLength\":150,\"style\":\"formal\",\"includeHighlights\":false}", + "description": "Generate a formal summary of an AI-focused text with max length 150 characters without highlights." + }, + { + "inputJson": "{\"inputText\":\"The quarterly sales report shows a 15% increase in revenue compared to the last quarter. Marketing campaigns have been effective in new customer acquisition, but supply chain delays remain a challenge.\",\"maxLength\":200,\"style\":\"informal\",\"includeHighlights\":true}", + "description": "Create an informal summary with bullet point highlights for a sales report." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Summary", + "context": null + } + }, + { + "name": "content-creation.composeEmail", + "description": "This tool composes a professional email based on input parameters including recipient details, subject, body content, tone, and optional attachments. It processes the inputs to generate a complete email draft ready for sending or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "recipientEmail", + "type": "string", + "description": "The email address of the recipient. Required to specify the email target.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientName", + "type": "string", + "description": "The name of the recipient, used for personalized greetings. Not strictly required.", + "required": false, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email, summarizing its purpose.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyContent", + "type": "string", + "description": "The main body text of the email, can include detailed information or message.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email such as formal, informal, friendly, or urgent, influencing the style of the composition.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "attachments", + "type": "array", + "description": "List of filenames or URLs to include as attachments in the email, optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "ccEmails", + "type": "array", + "description": "Array of email addresses to be CC'd on the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccEmails", + "type": "array", + "description": "Array of email addresses to be BCC'd on the email.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object representing the composed email with fields for recipient, subject, body, tone, attachments, CC and BCC lists." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or draft professional emails with customization for tone, recipient details, and attachments, especially useful in automated communication workflows or personal assistant scenarios.", + "limitations": "This tool does not send emails or validate email addresses; it only generates email content draft format.", + "examples": [ + "Compose an email to a client with a formal tone requesting a project update.", + "Create a friendly follow-up email to a colleague including an attached report.", + "Draft an urgent email to the manager notifying about a deadline change." + ] + }, + "tags": [ + "email", + "content creation", + "communication", + "automated writing", + "professional", + "message drafting" + ], + "examples": [ + { + "inputJson": "{\"recipientEmail\":\"client@example.com\",\"recipientName\":\"Alice\",\"subject\":\"Project Update Request\",\"bodyContent\":\"Dear Alice, I hope this message finds you well. Could you please provide the latest update on the project status at your earliest convenience? Thanks in advance.\",\"tone\":\"formal\",\"attachments\":[],\"ccEmails\":[],\"bccEmails\":[]}", + "description": "Formal email requesting a project update from a client." + }, + { + "inputJson": "{\"recipientEmail\":\"colleague@example.com\",\"recipientName\":\"Bob\",\"subject\":\"Weekly Report Attached\",\"bodyContent\":\"Hi Bob, Please find attached the weekly performance report. Let me know if you have any questions.\",\"tone\":\"friendly\",\"attachments\":[\"report.pdf\"],\"ccEmails\":[\"teamlead@example.com\"],\"bccEmails\":[]}", + "description": "Friendly email to a colleague sending a weekly report with CC to team lead." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "content-creation.composeReport", + "description": "This tool generates a detailed written report based on structured input data and a specified report template. It accepts content sections, metadata such as title, author, and date, and formatting preferences, then composes a coherent, well-organized report document in Markdown or PDF format as output.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the report to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "The author or creator name to include in the report metadata.", + "required": false, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "The date to display on the report, typically in YYYY-MM-DD format.", + "required": false, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of content sections; each section is an object with a heading and body text to include in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Desired output format of the report document, e.g., 'markdown' or 'pdf'.", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to automatically generate and include a table of contents.", + "required": false, + "defaultValue": "false" + }, + { + "name": "pageSize", + "type": "string", + "description": "Page size for PDF output, e.g., 'A4', 'Letter'. Effective only if format is 'pdf'.", + "required": false, + "defaultValue": "A4" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report content as a string and the format indicating the file type." + }, + "aiAgent": { + "useCase": "Use this tool when a structured, formal report needs to be programmatically generated from raw data or section content. It helps automate report writing by formatting and assembling sections into a polished document in the desired format, saving time on manual composition.", + "limitations": "This tool cannot perform complex data analysis or generate content beyond the provided input sections. It also does not handle multimedia embedding beyond text and simple formatting.", + "examples": [ + "Generate a project status report with sections for overview, milestones, and risks.", + "Compose a research summary report in PDF format with a title, author, and date.", + "Create a meeting minutes document in markdown with a table of contents included." + ] + }, + "tags": [ + "reporting", + "document-generation", + "content-creation", + "automation", + "markdown", + "pdf" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Q2 Financial Report\",\"author\":\"Jane Smith\",\"date\":\"2024-06-15\",\"sections\":[{\"heading\":\"Executive Summary\",\"body\":\"This quarter showed 10% growth in revenue...\"},{\"heading\":\"Detailed Analysis\",\"body\":\"The sales increased primarily in the North America region...\"}],\"format\":\"pdf\",\"includeTableOfContents\":true,\"pageSize\":\"Letter\"}", + "description": "Generate a PDF financial report with two sections, including a table of contents and author/date metadata." + }, + { + "inputJson": "{\"title\":\"Weekly Team Meeting Minutes\",\"sections\":[{\"heading\":\"Attendees\",\"body\":\"List of attendees...\"},{\"heading\":\"Discussion Points\",\"body\":\"Summary of topics discussed...\"},{\"heading\":\"Action Items\",\"body\":\"Tasks assigned with deadlines...\"}],\"format\":\"markdown\",\"includeTableOfContents\":false}", + "description": "Compose a markdown document for meeting minutes without a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.composeDocument", + "description": "This tool accepts structured inputs including a title, sections with headings and content, and optional metadata to compose a coherent, formatted document. It processes the inputs to generate a plain text or markdown formatted document string suitable for reports, articles, or notes.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the document to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects, each containing a heading and associated content for that section.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata for the document such as author, date, and keywords.", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "The desired output format: 'plain' for plain text or 'markdown' for markdown formatting.", + "required": false, + "defaultValue": "markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document string under the 'document' key, formatted as requested." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a structured and readable document from user-provided outlines, sections, and metadata. It is suitable for creating reports, summaries, articles, or notes in plain text or markdown format. The agent can rely on this tool to produce organized textual content without manual formatting.", + "limitations": "This tool does not perform natural language generation beyond assembling and formatting given inputs. It cannot rewrite, summarize, or generate content autonomously and requires structured section content as input.", + "examples": [ + "Compose a markdown report with given title and three sections, including author metadata.", + "Create a plain text meeting notes document with a title and bulleted action items sections.", + "Generate an article using provided section headings and paragraphs, output formatted in markdown." + ] + }, + "tags": [ + "content creation", + "document generation", + "markdown", + "report writing", + "text formatting" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Quarterly Sales Report\",\"sections\":[{\"heading\":\"Introduction\",\"content\":\"Overview of sales performance.\"},{\"heading\":\"Data Analysis\",\"content\":\"Detailed data insights.\"},{\"heading\":\"Conclusion\",\"content\":\"Summary and future outlook.\"}],\"metadata\":{\"author\":\"Jane Doe\",\"date\":\"2024-05-31\"},\"format\":\"markdown\"}", + "description": "Compose a quarterly sales report with three sections and author metadata in markdown format." + }, + { + "inputJson": "{\"title\":\"Team Meeting Notes\",\"sections\":[{\"heading\":\"Attendees\",\"content\":\"John, Sarah, Ahmed.\"},{\"heading\":\"Discussion Points\",\"content\":\"Project deadlines, resource allocation.\"},{\"heading\":\"Action Items\",\"content\":\"Assign tasks, schedule follow-up.\"}],\"format\":\"plain\"}", + "description": "Generate plain text meeting notes with multiple sections, no metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "content-creation.generateReference", + "description": "Generates a formatted reference citation based on bibliographic details provided as input, supporting various citation styles such as APA, MLA, and Chicago. The tool accepts key data fields including author(s), title, publication year, source type, and outputs a properly formatted reference string suitable for academic and professional documents.", + "category": "content-creation", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of authors, each as a full name string, used to create the author portion of the reference.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "title", + "type": "string", + "description": "The title of the work being referenced (article, book, report, etc.).", + "required": true, + "defaultValue": "" + }, + { + "name": "year", + "type": "number", + "description": "Year of publication or release.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of source (e.g., book, journalArticle, website, report) to determine formatting rules.", + "required": true, + "defaultValue": "" + }, + { + "name": "publication", + "type": "string", + "description": "Name of the publication, publisher, or website where the source appears, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number of the source (for journal articles, etc.), if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number of the source (for journals), if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page numbers or range for the referenced material, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL for online sources, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "The citation style to format the reference in, e.g., APA, MLA, Chicago.", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted reference string under the key 'formattedReference'." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI needs to generate a scholarly or professional reference based on structured bibliographic data. It ensures citations comply with standard styles for consistent and accurate references in documents, research papers, or bibliographies.", + "limitations": "Cannot verify the correctness or existence of source data; formatting may not cover all edge case rules of citation styles or very specialized source types.", + "examples": [ + "Generate an APA citation for a journal article with multiple authors and volume/issue info.", + "Create an MLA style reference for an online report with a URL.", + "Format a Chicago style citation for a book given author, year, publisher." + ] + }, + "tags": [ + "citation", + "reference", + "bibliography", + "formatting", + "academic", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Jane Doe\",\"John Smith\"],\"title\":\"Insights into Quantum Computing\",\"year\":2022,\"sourceType\":\"journalArticle\",\"publication\":\"Journal of Computing Research\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"123-145\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA style reference for a journal article with two authors and volume/issue." + }, + { + "inputJson": "{\"authors\":[\"Anne Brown\"],\"title\":\"Modern Web Design Trends\",\"year\":2020,\"sourceType\":\"website\",\"publication\":\"WebDesign Weekly\",\"url\":\"https://webdesignweekly.example.com/article123\",\"citationStyle\":\"MLA\"}", + "description": "Create an MLA style citation for an online article with a URL." + }, + { + "inputJson": "{\"authors\":[\"Robert Green\"],\"title\":\"Effective Project Management\",\"year\":2018,\"sourceType\":\"book\",\"publication\":\"TechPress\",\"citationStyle\":\"Chicago\"}", + "description": "Format a Chicago style reference for a book with author, title, year, and publisher." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Reference", + "context": null + } + }, + { + "name": "content-creation.generateCitation", + "description": "Generates properly formatted citations for various source types (e.g., books, articles, websites) based on provided bibliographic information and desired citation style such as APA, MLA, or Chicago. Accepts details like author names, title, publication year, and outputs a formatted citation string.", + "category": "content-creation", + "parameters": [ + { + "name": "sourceType", + "type": "string", + "description": "Type of source to cite (e.g., book, journalArticle, website)", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "array", + "description": "List of authors, each as a string in 'Last, First' format", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the source material", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year the source was published", + "required": false, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Publisher name for books or organizations responsible for content", + "required": false, + "defaultValue": "" + }, + { + "name": "journalName", + "type": "string", + "description": "Journal or periodical name for articles", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number for journal articles", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number for journal articles", + "required": false, + "defaultValue": "" + }, + { + "name": "pages", + "type": "string", + "description": "Page range for articles or book chapters", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL for online sources", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date the online source was accessed (format YYYY-MM-DD)", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format output (e.g., APA, MLA, Chicago)", + "required": true, + "defaultValue": "APA" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string and the citation style used" + }, + "aiAgent": { + "useCase": "Use this tool when you need to produce a correctly formatted citation string for a source based on its bibliographic details, supporting multiple source types and citation styles. Essential for academic content generation, reference list creation, or document automation where standardized citations are required.", + "limitations": "This tool generates citations based on common fields but does not verify source accuracy or handle extremely niche citation types. It requires correct input data; incomplete or incorrect data will affect output formatting.", + "examples": [ + "Generate an APA book citation with author names, title, publisher, and year.", + "Create an MLA citation for a journal article including volume, issue, pages, and journal name.", + "Format a Chicago-style citation for a website with author, title, URL, and access date." + ] + }, + "tags": [ + "citation", + "reference", + "content-creation", + "academic", + "formatting", + "bibliography" + ], + "examples": [ + { + "inputJson": "{\"sourceType\":\"book\",\"author\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"The Art of Testing\",\"publicationYear\":2020,\"publisher\":\"Tech Press\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA citation for a book with two authors." + }, + { + "inputJson": "{\"sourceType\":\"journalArticle\",\"author\":[\"Brown, Lisa\"],\"title\":\"Innovations in AI\",\"journalName\":\"AI Journal\",\"volume\":\"15\",\"issue\":\"4\",\"pages\":\"123-145\",\"publicationYear\":2022,\"citationStyle\":\"MLA\"}", + "description": "Generate an MLA citation for a journal article with volume and issue." + }, + { + "inputJson": "{\"sourceType\":\"website\",\"author\":[\"Green, Alice\"],\"title\":\"Understanding Quantum Computing\",\"url\":\"https://example.com/quantum\",\"accessDate\":\"2023-05-01\",\"citationStyle\":\"Chicago\"}", + "description": "Generate a Chicago style citation for a website with access date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.generateWord", + "description": "Generates a single word based on optional criteria such as language, part of speech, word length, and thematic category. Accepts parameters to customize the word output and returns a relevant word as a string.", + "category": "content-creation", + "parameters": [ + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en' for English) to generate the word in.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "The desired part of speech such as noun, verb, adjective, or adverb.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "minLength", + "type": "number", + "description": "Minimum number of characters for the generated word.", + "required": false, + "defaultValue": "1" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters for the generated word.", + "required": false, + "defaultValue": "20" + }, + { + "name": "theme", + "type": "string", + "description": "Optional thematic category to influence the word's meaning or domain (e.g., 'technology', 'nature').", + "required": false, + "defaultValue": "\"\"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated word as a string and the details of the parameters used." + }, + "aiAgent": { + "useCase": "Use this tool when a single, contextually relevant word is needed for creative writing, branding, game development, or natural language generation. It helps generate words tailored by language, meaning, or stylistic constraints.", + "limitations": "This tool does not generate phrases or sentences, nor does it guarantee the word is common or easily recognized. Complex semantic or contextual usage beyond part of speech and theme is not supported.", + "examples": [ + "Generate a noun in English with 5 to 7 letters related to technology.", + "Generate a short adjective describing a natural theme.", + "Generate any verb in French without length restriction." + ] + }, + "tags": [ + "content-creation", + "word-generation", + "language", + "text", + "nlp", + "creative-writing" + ], + "examples": [ + { + "inputJson": "{\"language\":\"en\",\"partOfSpeech\":\"noun\",\"minLength\":4,\"maxLength\":8,\"theme\":\"technology\"}", + "description": "Generate a technology-related noun in English between 4 and 8 characters." + }, + { + "inputJson": "{\"language\":\"en\",\"partOfSpeech\":\"adjective\",\"minLength\":3,\"maxLength\":6,\"theme\":\"nature\"}", + "description": "Generate a short adjective describing something natural." + }, + { + "inputJson": "{\"language\":\"fr\",\"partOfSpeech\":\"verb\",\"minLength\":2,\"maxLength\":10,\"theme\":\"\"}", + "description": "Generate a verb in French with no theme and a character length between 2 and 10." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.generateQuote", + "description": "Generates an inspirational or motivational quote based on optional themes or subjects provided as input. Processes user-defined topics or styles to create a relevant, original quote output as a string suitable for digital content use.", + "category": "content-creation", + "parameters": [ + { + "name": "theme", + "type": "string", + "description": "Optional theme or subject to guide the generated quote (e.g., 'perseverance', 'happiness').", + "required": false, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Optional stylistic preference for the quote (e.g., 'philosophical', 'humorous', 'poetic').", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated quote in characters. Limits the output size.", + "required": false, + "defaultValue": "200" + }, + { + "name": "includeAuthor", + "type": "boolean", + "description": "Whether to append a fictional author name to the quote for stylistic effect.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated quote text and optionally the author name." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to create original, motivational or thematic quotes for digital content such as social media posts, blogs, presentations, or creative projects. It helps generate concise, relevant quotes based on user-defined themes and styles, facilitating content creation without relying on existing famous quotes.", + "limitations": "The generated quotes are original but may lack deep philosophical rigor or novelty. It cannot verify or produce quotes attributed to real historical figures accurately. It should not be used for generating quotes that require factual or historical authenticity.", + "examples": [ + "Generate a motivational quote about perseverance with a poetic style.", + "Create a humorous quote related to technology.", + "Produce a short inspirational quote without any specific theme." + ] + }, + "tags": [ + "content-creation", + "generate", + "quote", + "inspiration", + "motivational", + "creative-writing" + ], + "examples": [ + { + "inputJson": "{\"theme\":\"courage\",\"style\":\"philosophical\",\"maxLength\":150,\"includeAuthor\":true}", + "description": "Generate a philosophical quote about courage with a maximum length of 150 characters, including a fictional author." + }, + { + "inputJson": "{\"theme\":\"technology\",\"style\":\"humorous\",\"maxLength\":100,\"includeAuthor\":false}", + "description": "Create a humorous technology-themed quote without author attribution, limited to 100 characters." + }, + { + "inputJson": "{\"theme\":\"\",\"style\":\"\",\"maxLength\":120,\"includeAuthor\":false}", + "description": "Produce a general inspirational quote with no specified theme or style, limited to 120 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Quote", + "context": null + } + }, + { + "name": "content-creation.generateLink", + "description": "Generates a secure, customized URL link based on input parameters such as base URL, query parameters, short link preference, and expiration time. Processes the inputs to produce a ready-to-use hyperlink that optionally includes encoded parameters, shortened URLs, and expiration metadata in the output.", + "category": "content-creation", + "parameters": [ + { + "name": "baseUrl", + "type": "string", + "description": "The base URL to which parameters will be appended to form the full link.", + "required": true, + "defaultValue": "" + }, + { + "name": "queryParams", + "type": "object", + "description": "An object representing key-value pairs to be converted into URL query parameters.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "shorten", + "type": "boolean", + "description": "If true, the generated URL will be shortened using a built-in shortening algorithm.", + "required": false, + "defaultValue": "false" + }, + { + "name": "expirationSeconds", + "type": "number", + "description": "Optional time in seconds after which the link will expire and become invalid.", + "required": false, + "defaultValue": "0" + }, + { + "name": "customAlias", + "type": "string", + "description": "Optional custom alias for the shortened URL for easier recall, if supported and available.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the full generated URL, optionally the shortened URL, expiration timestamp if set, and a flag indicating if the link is shortened." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a shareable link that includes dynamic query parameters, may require shortening for brevity, and/or needs expiration controls for limited time access. It is ideal for generating promotional links, personalized referral URLs, or temporary access links.", + "limitations": "This tool does not provide real external URL shortening or hosting; shortened URLs are algorithmically generated and may not resolve outside this environment. It does not verify link accessibility or enforce expiration beyond metadata.", + "examples": [ + "Generate a promotional link with campaign parameters and a 24-hour expiration.", + "Create a short URL with a custom alias for an internal document.", + "Generate a link with multiple query parameters without shortening." + ] + }, + "tags": [ + "content", + "link generation", + "URL", + "shortening", + "query parameters", + "expiration" + ], + "examples": [ + { + "inputJson": "{\"baseUrl\":\"https://example.com/product\",\"queryParams\":{\"utm_source\":\"newsletter\",\"utm_campaign\":\"spring_sale\"},\"shorten\":true,\"expirationSeconds\":86400}", + "description": "Generate a shortened URL for a product page with marketing campaign parameters and a 24-hour expiration." + }, + { + "inputJson": "{\"baseUrl\":\"https://docs.example.com/view\",\"queryParams\":{\"docId\":\"12345\",\"user\":\"abc\"},\"shorten\":false}", + "description": "Generate a full URL with query parameters pointing to a document view without shortening." + }, + { + "inputJson": "{\"baseUrl\":\"https://app.example.com/r\",\"shorten\":true,\"customAlias\":\"specialoffer\"}", + "description": "Generate a shortened URL using a custom alias for a special offer landing page." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.generateKPI", + "description": "Generates customized Key Performance Indicator (KPI) reports based on specified analytics data inputs. Accepts raw dataset or summary statistics along with KPI definitions and outputs a structured KPI report highlighting trends, targets, and performance evaluations.", + "category": "content-creation", + "parameters": [ + { + "name": "dataSource", + "type": "object", + "description": "An object representing the analytics data; can include raw data arrays or summarized metrics.", + "required": true, + "defaultValue": "" + }, + { + "name": "kpiDefinitions", + "type": "array", + "description": "An array of KPI descriptor objects specifying the KPI name, calculation formula, target value, and evaluation criteria.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeframe", + "type": "object", + "description": "Defines the start and end date/time for the KPI calculation period.", + "required": false, + "defaultValue": "" + }, + { + "name": "compareWithPreviousPeriod", + "type": "boolean", + "description": "If true, includes comparison metrics against a previous timeframe for trend analysis.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the KPI report, e.g., JSON, CSV, or formatted text.", + "required": false, + "defaultValue": "JSON" + } + ], + "returns": { + "type": "object", + "description": "A structured KPI report object containing calculated KPI values, target comparisons, trend insights, and optionally formatted according to outputFormat." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate performance metrics reports from analytics data, summarizing key business or operational indicators for decision making. It can create tailored KPI summaries based on definitions and target thresholds.", + "limitations": "This tool does not fetch or clean raw data, nor does it provide advanced predictive analytics beyond simple trend comparisons. It requires pre-processed data input and cannot automatically define KPIs.", + "examples": [ + "Generate monthly sales KPIs showing total revenue vs target and previous month comparison.", + "Create a user engagement KPI report for the last quarter including churn and retention rates.", + "Produce a CSV KPI summary report for a manufacturing process with efficiency and defect rate KPIs." + ] + }, + "tags": [ + "content-creation", + "kpi", + "analytics", + "reporting", + "performance", + "data-analysis", + "business-intelligence" + ], + "examples": [ + { + "inputJson": "{\"dataSource\":{\"sales\":[{\"date\":\"2024-01-01\",\"revenue\":10000},{\"date\":\"2024-01-02\",\"revenue\":12000}]},\"kpiDefinitions\":[{\"name\":\"Total Revenue\",\"formula\":\"sum(sales.revenue)\",\"target\":15000}],\"timeframe\":{\"start\":\"2024-01-01\",\"end\":\"2024-01-31\"},\"compareWithPreviousPeriod\":true,\"outputFormat\":\"JSON\"}", + "description": "Generate January total revenue KPI with target comparison and previous period trend." + }, + { + "inputJson": "{\"dataSource\":{\"engagement\":{\"dailyActiveUsers\":1000,\"churnRate\":0.05}},\"kpiDefinitions\":[{\"name\":\"Churn Rate\",\"formula\":\"engagement.churnRate\",\"target\":0.04}],\"outputFormat\":\"CSV\"}", + "description": "Create a KPI report for user churn rate with CSV output format." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "KPI", + "context": null + } + }, + { + "name": "content-creation.generateHeading", + "description": "Generates a well-structured heading based on provided keywords and desired heading level. Accepts keywords or a brief description, processes context, and outputs a text heading formatted appropriately for digital documents or web content.", + "category": "content-creation", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "An array of keywords or key phrases that should be included or influence the heading content.", + "required": true, + "defaultValue": "" + }, + { + "name": "headingLevel", + "type": "number", + "description": "The desired heading level (e.g., 1 for H1, 2 for H2), determining the heading's importance and size.", + "required": false, + "defaultValue": "2" + }, + { + "name": "style", + "type": "string", + "description": "The stylistic tone or style of the heading, such as 'formal', 'informal', 'technical', or 'marketing'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters allowed in the generated heading to ensure concise output.", + "required": false, + "defaultValue": "60" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated heading text and its HTML tag representation" + }, + "aiAgent": { + "useCase": "Use this tool when you need to create contextual and visually hierarchical headings for articles, web pages, or digital content based on keywords or ideas for better structure and user readability. It helps maintain SEO-friendly and semantically correct headings at the specified level and style.", + "limitations": "Cannot generate full paragraphs or multiple headings at once; it focuses on a single heading. It also cannot guarantee perfect SEO optimization beyond keyword usage and simple style guidelines.", + "examples": [ + "Generate a concise H1 heading for an article about sustainable gardening using keywords 'sustainability', 'gardening', 'tips'.", + "Create a formal H3 heading for a technical document section about cloud computing basics.", + "Produce a marketing style H2 heading with a maximum length of 50 characters incorporating 'email campaigns' and 'conversion rates'." + ] + }, + "tags": [ + "content-creation", + "heading", + "text-generation", + "seo", + "digital-content", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"sustainability\",\"gardening\",\"tips\"],\"headingLevel\":1,\"style\":\"formal\",\"maxLength\":60}", + "description": "Generate a formal H1 heading containing keywords related to sustainable gardening." + }, + { + "inputJson": "{\"keywords\":[\"cloud computing\",\"basics\"],\"headingLevel\":3,\"style\":\"technical\",\"maxLength\":50}", + "description": "Create a technical-style H3 heading about cloud computing basics." + }, + { + "inputJson": "{\"keywords\":[\"email campaigns\",\"conversion rates\"],\"headingLevel\":2,\"style\":\"marketing\",\"maxLength\":50}", + "description": "Generate a marketing style H2 heading focused on email campaigns and improving conversion rates within 50 characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.generateParagraph", + "description": "Generates a coherent and contextually relevant paragraph of text based on a given topic, tone, and optional keywords. Accepts parameters to control length and style, then produces a well-structured paragraph suitable for articles, blogs, or reports.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the paragraph to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the paragraph in number of sentences.", + "required": false, + "defaultValue": "5" + }, + { + "name": "tone", + "type": "string", + "description": "Tone or style of writing, such as formal, casual, persuasive, or informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "keywords", + "type": "array", + "description": "An optional array of keywords or phrases to incorporate into the paragraph.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the output text (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text as a string, matching the requested topic and style." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a standalone paragraph that explains, describes, or elaborates on a specific topic in a chosen style and length, such as for content creation, draft writing, or summarization tasks.", + "limitations": "This tool generates text based on topic and style but does not verify factual accuracy or provide citations. It is less suited for highly technical or domain-specialized paragraphs requiring expert input.", + "examples": [ + "Generate a formal paragraph about the benefits of renewable energy.", + "Create a casual paragraph describing a day at the beach including the keywords 'sun', 'waves', and 'fun'.", + "Write a persuasive paragraph about the importance of healthy eating, approximately 7 sentences long." + ] + }, + "tags": [ + "content creation", + "text generation", + "paragraph", + "writing assistant", + "AI writing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of renewable energy\",\"length\":5,\"tone\":\"formal\",\"keywords\":[\"sustainability\",\"carbon footprint\"],\"language\":\"en\"}", + "description": "Generate a formal paragraph about renewable energy benefits incorporating sustainability and carbon footprint keywords." + }, + { + "inputJson": "{\"topic\":\"A day at the beach\",\"length\":4,\"tone\":\"casual\",\"keywords\":[\"sun\",\"waves\",\"fun\"],\"language\":\"en\"}", + "description": "Create a casual paragraph describing a day at the beach using specified keywords." + }, + { + "inputJson": "{\"topic\":\"Importance of healthy eating\",\"length\":7,\"tone\":\"persuasive\",\"keywords\":[],\"language\":\"en\"}", + "description": "Write a persuasive paragraph about healthy eating approximately seven sentences long." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.generateSentence", + "description": "Generates a coherent and contextually relevant sentence based on specified parameters such as topic, style, length, and language. It accepts inputs defining the desired content characteristics and produces a natural language sentence accordingly.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The subject or theme for the sentence to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Writing style or tone of the sentence, e.g., formal, casual, poetic.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the sentence in words.", + "required": false, + "defaultValue": "15" + }, + { + "name": "language", + "type": "string", + "description": "Language code to generate the sentence in, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeywords", + "type": "array", + "description": "List of keywords that should appear in the sentence if possible.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence as a string under the key 'sentence'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a single, contextually relevant sentence for content creation tasks such as writing prompts, summaries, or filler text in various styles and languages. It helps generate natural language output fitting user specifications.", + "limitations": "The tool generates single sentences only and does not produce paragraphs or longer text. It may not always perfectly integrate all keywords depending on length constraints and coherence. It cannot verify factual accuracy or provide multiple sentences as output.", + "examples": [ + "Generate a formal English sentence about climate change approximately 20 words long.", + "Create a casual sentence including the keywords 'coffee' and 'morning' in English.", + "Produce a poetic style sentence on the topic of hope in English." + ] + }, + "tags": [ + "content creation", + "text generation", + "sentence", + "NLP", + "writing assistant" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"artificial intelligence\",\"style\":\"formal\",\"length\":20,\"language\":\"en\",\"includeKeywords\":[\"machine learning\"]}", + "description": "Generate a formal English sentence about artificial intelligence including the keyword 'machine learning', approximately 20 words." + }, + { + "inputJson": "{\"topic\":\"morning routine\",\"style\":\"casual\",\"length\":15,\"language\":\"en\",\"includeKeywords\":[\"coffee\",\"sunrise\"]}", + "description": "Create a casual sentence about morning routine including 'coffee' and 'sunrise' in English, about 15 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.generateText", + "description": "Generates original text content based on a provided prompt and optional constraints such as length, style, and tone. It accepts input parameters defining the topic or seed text, desired text length, writing style, and tone, then processes these to output coherent, contextually relevant text for content creation purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "Initial text or topic to generate content about.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters or tokens to generate in the output text.", + "required": false, + "defaultValue": "500" + }, + { + "name": "style", + "type": "string", + "description": "Writing style to apply, such as formal, informal, technical, or conversational.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the generated text, e.g., friendly, professional, neutral, or persuasive.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en' for English) for the output text.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeReferences", + "type": "boolean", + "description": "Whether to include or simulate references or citations in the generated text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text string and metadata about the generation process, such as length and applied style or tone." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to create natural language text content from a user-provided prompt or seed. It is suitable for generating articles, blogs, summaries, or creative writing with customizable style and tone. Agents can specify content parameters to tailor the output for the intended audience or purpose.", + "limitations": "The tool cannot guarantee factual accuracy or up-to-date information and may produce generic or less creative text depending on input quality. It is not designed for generating highly specialized technical documents or confidential/legal content without expert review.", + "examples": [ + "Generate a friendly blog post introduction about sustainable living.", + "Create a professional summary of recent sales data trends.", + "Write a conversational product description for a new smartphone model." + ] + }, + "tags": [ + "content creation", + "text generation", + "natural language", + "writing", + "creative", + "automated content", + "blogging", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"The benefits of daily meditation\",\"maxLength\":300,\"style\":\"informal\",\"tone\":\"friendly\",\"language\":\"en\",\"includeReferences\":false}", + "description": "Generate a friendly, informal text about meditation benefits suitable for a blog post." + }, + { + "inputJson": "{\"prompt\":\"Quarterly financial report summary\",\"maxLength\":250,\"style\":\"formal\",\"tone\":\"professional\",\"language\":\"en\"}", + "description": "Produce a formal and professional summary text for a business report." + }, + { + "inputJson": "{\"prompt\":\"Introducing the new XPhone 12\",\"maxLength\":200,\"style\":\"conversational\",\"tone\":\"persuasive\",\"language\":\"en\"}", + "description": "Create a persuasive and conversational product description for marketing purposes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.generateConversion", + "description": "Generates a conversion report from provided digital marketing campaign data, calculating key metrics like conversion rate, cost per conversion, and total conversions. Accepts arrays of campaign performance entries and processes them to produce a summary JSON report for analytics and decision making.", + "category": "content-creation", + "parameters": [ + { + "name": "campaignData", + "type": "array", + "description": "An array of campaign objects each containing clicks, conversions, and cost metrics.", + "required": true, + "defaultValue": "" + }, + { + "name": "conversionGoalName", + "type": "string", + "description": "The name of the conversion goal to label the report with.", + "required": false, + "defaultValue": "\"Primary Conversion\"" + }, + { + "name": "includeCostMetrics", + "type": "boolean", + "description": "Whether to include cost per conversion and total cost metrics in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "decimalPlaces", + "type": "number", + "description": "Number of decimal places to round numeric metrics to.", + "required": false, + "defaultValue": "2" + } + ], + "returns": { + "type": "object", + "description": "A report object containing total clicks, total conversions, conversion rate percentage, total cost, and cost per conversion, labeled by the conversion goal name." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a concise conversion analytics report from raw campaign performance data to understand effectiveness and ROI of digital marketing efforts. It helps transform raw clicks, conversions, and cost inputs into actionable conversion metrics for business analysis.", + "limitations": "This tool does not track individual user journeys or provide advanced statistical modeling; it operates on aggregated campaign data only.", + "examples": [ + "Generate a conversion report from multiple campaigns to find overall conversion rate and cost per conversion.", + "Produce a summary conversion metric output filtering by a specific conversion goal name.", + "Calculate conversion metrics without including cost-related data." + ] + }, + "tags": [ + "conversion", + "analytics", + "digital-marketing", + "reporting", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"campaignData\":[{\"clicks\":1000,\"conversions\":50,\"cost\":200},{\"clicks\":500,\"conversions\":25,\"cost\":100}],\"conversionGoalName\":\"Signup\",\"includeCostMetrics\":true,\"decimalPlaces\":2}", + "description": "Generate a conversion report for a signup goal including cost metrics with 2 decimal precision." + }, + { + "inputJson": "{\"campaignData\":[{\"clicks\":1500,\"conversions\":75,\"cost\":350}],\"conversionGoalName\":\"Purchase\",\"includeCostMetrics\":false,\"decimalPlaces\":1}", + "description": "Generate a conversion report for a purchase goal excluding cost data and rounding to 1 decimal place." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Conversion", + "context": null + } + }, + { + "name": "content-creation.generateTrend", + "description": "This tool analyzes input datasets such as social media posts, search queries, or sales metrics over specified time frames to identify emerging or declining trends. It accepts raw data arrays along with parameters to define the focus area and time scope, processes patterns using statistical methods and natural language analysis, and outputs a structured summary of detected trends, their strength, and temporal evolution.", + "category": "content-creation", + "parameters": [ + { + "name": "dataSourceType", + "type": "string", + "description": "Type of the data provided, e.g., 'socialMedia', 'searchQueries', 'salesData'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "array", + "description": "Array of data points relevant to the chosen dataSourceType; e.g., posts, queries, or sales records with timestamps.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeWindowDays", + "type": "number", + "description": "Number of past days to analyze for trends, defining the time scope of analysis.", + "required": false, + "defaultValue": "30" + }, + { + "name": "trendFocus", + "type": "string", + "description": "Optional keyword or category to focus the trend analysis, e.g., a hashtag, product category, or topic.", + "required": false, + "defaultValue": "" + }, + { + "name": "minTrendStrength", + "type": "number", + "description": "Minimum threshold to report a trend based on strength score (0 to 1).", + "required": false, + "defaultValue": "0.2" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to analyze and include sentiment trends if input data contains text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing identified trends with details: trend name, strength score, growth direction, associated keywords, and optionally sentiment orientation over time." + }, + "aiAgent": { + "useCase": "Use this tool when needing to detect and summarize significant emerging or fading trends from temporal datasets such as social media activity, search behavior, or sales figures. It enables strategic content creation, marketing adjustments, or market analysis based on evolving user interests and behaviors.", + "limitations": "Does not perform real-time streaming analysis; requires input data to be structured and timestamped. Trend focus requires relevant keywords for targeted results. Sentiment analysis is only supported for text-based data and may have language limitations.", + "examples": [ + "Identify top 5 rising topics on Twitter in last 14 days containing the hashtag #climatechange.", + "Analyze product sales data from last quarter to find declining categories.", + "Generate sentiment trends on customer reviews mentioning 'battery life' over the past month." + ] + }, + "tags": [ + "content-creation", + "trend-analysis", + "analytics", + "social-media", + "marketing", + "time-series", + "sentiment-analysis" + ], + "examples": [ + { + "inputJson": "{\"dataSourceType\":\"socialMedia\",\"data\":[{\"text\":\"Exploring new eco-friendly gadgets! #climatechange\",\"timestamp\":\"2024-05-20T10:00:00Z\"},{\"text\":\"Solar power is gaining traction #climatechange\",\"timestamp\":\"2024-05-21T12:30:00Z\"}],\"timeWindowDays\":14,\"trendFocus\":\"climatechange\",\"minTrendStrength\":0.3,\"includeSentiment\":true}", + "description": "Analyze social media posts with #climatechange over past 14 days including sentiment." + }, + { + "inputJson": "{\"dataSourceType\":\"salesData\",\"data\":[{\"product\":\"smartphone\",\"unitsSold\":1500,\"date\":\"2024-04-01\"},{\"product\":\"smartphone\",\"unitsSold\":1200,\"date\":\"2024-04-15\"},{\"product\":\"tablet\",\"unitsSold\":700,\"date\":\"2024-04-01\"},{\"product\":\"tablet\",\"unitsSold\":1300,\"date\":\"2024-04-15\"}],\"timeWindowDays\":30,\"minTrendStrength\":0.25}", + "description": "Detect sales trends for electronics products over last 30 days to find growth or decline." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Trend", + "context": null + } + }, + { + "name": "content-creation.generateSession", + "description": "Generates a detailed analytics session report based on user activity data. Accepts inputs such as user identifiers, time ranges, and event types to process interaction logs. Outputs a structured session summary including duration, event counts, engagement metrics, and common paths.", + "category": "content-creation", + "parameters": [ + { + "name": "userId", + "type": "string", + "description": "Identifier for the user whose session data is to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "Start timestamp (ISO 8601) for filtering session data.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "End timestamp (ISO 8601) for filtering session data.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventTypes", + "type": "array", + "description": "List of event types to include in the session analysis, e.g., ['click', 'navigation'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includePaths", + "type": "boolean", + "description": "Whether to include detailed user navigation paths in the output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "minEventCount", + "type": "number", + "description": "Minimum number of events user must have in the session to be included in the summary.", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "An object summarizing the session analytics including session duration, total events, event breakdown by type, engagement score, and optionally user navigation paths." + }, + "aiAgent": { + "useCase": "Use this tool when generating summarized user session analytics from raw interaction logs within a specified period. It helps produce meaningful metrics like session length, event counts, and behavioral patterns for content engagement analysis or user behavior research.", + "limitations": "This tool does not process raw logs itself; it expects preprocessed or queryable event data. It cannot handle live streaming data and does not generate predictive analytics or user segmentation beyond the session scope.", + "examples": [ + "Generate a session report for user 'user123' from 2024-04-01T00:00:00Z to 2024-04-01T23:59:59Z including click and navigation events.", + "Create a session summary for a user with minimum 5 events in their session, including detailed navigation paths.", + "Produce engagement metrics for events of type 'play' and 'pause' over the last week for user 'abc789'." + ] + }, + "tags": [ + "analytics", + "session", + "user-behavior", + "content-creation", + "report-generation", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"userId\":\"user123\",\"startTime\":\"2024-04-01T00:00:00Z\",\"endTime\":\"2024-04-01T23:59:59Z\",\"eventTypes\":[\"click\",\"navigation\"],\"includePaths\":true}", + "description": "Generate a detailed session report for user123 on April 1, 2024 with click and navigation events, including navigation paths." + }, + { + "inputJson": "{\"userId\":\"abc789\",\"startTime\":\"2024-03-25T00:00:00Z\",\"endTime\":\"2024-03-31T23:59:59Z\",\"eventTypes\":[\"play\",\"pause\"],\"includePaths\":false,\"minEventCount\":3}", + "description": "Create a session summary with engagement metrics for play/pause events over the last week for user abc789, with sessions having at least 3 events." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Session", + "context": null + } + }, + { + "name": "content-creation.generateAnomaly", + "description": "This tool accepts numerical time-series data or datasets with timestamps and metrics, analyzes the data to detect unusual patterns or anomalies using statistical and machine learning methods, and generates a detailed anomaly report highlighting anomalies, their severity, timestamps, and possible explanations.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of objects each representing a timestamped data point containing numeric metrics to analyze for anomalies.", + "required": true, + "defaultValue": "" + }, + { + "name": "timestampField", + "type": "string", + "description": "The key name in each data object that contains the timestamp (ISO 8601 format preferred).", + "required": true, + "defaultValue": "timestamp" + }, + { + "name": "metricFields", + "type": "array", + "description": "List of key names in data objects representing numeric metrics to analyze for anomalies.", + "required": true, + "defaultValue": "" + }, + { + "name": "sensitivity", + "type": "number", + "description": "Parameter to adjust anomaly detection sensitivity; higher values detect more subtle anomalies. Typical range 0.1 to 1.0.", + "required": false, + "defaultValue": "0.5" + }, + { + "name": "detectionMethod", + "type": "string", + "description": "Anomaly detection algorithm to use: 'statistical', 'machineLearning', or 'hybrid'.", + "required": false, + "defaultValue": "hybrid" + }, + { + "name": "explainability", + "type": "boolean", + "description": "If true, includes explanations for detected anomalies based on feature contribution or patterns.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxAnomalies", + "type": "number", + "description": "Maximum number of anomalies to report. If zero or omitted, report all detected anomalies.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a list of detected anomalies with timestamps, related metric values, anomaly scores, severity categorizations, and optional explanations." + }, + "aiAgent": { + "useCase": "Use when an AI agent needs to identify unusual or unexpected events in time-series or metric data to flag potential issues, deviations from normal behavior, or opportunities for investigation. Common in monitoring, fraud detection, or data quality validation.", + "limitations": "Cannot guarantee detection of all anomaly types; effectiveness depends on input data quality and choice of parameters. Not designed for unstructured or categorical data without proper numerical encoding.", + "examples": [ + "Detect anomalies in server CPU usage metrics over a week.", + "Analyze transaction volume to find fraud signals in payment data.", + "Identify dips and spikes in website traffic relative to historical patterns." + ] + }, + "tags": [ + "anomaly-detection", + "analytics", + "time-series", + "machine-learning", + "data-quality", + "monitoring" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-05-01T00:00:00Z\",\"cpu\":20.5,\"memory\":30.1},{\"timestamp\":\"2024-05-01T01:00:00Z\",\"cpu\":75.3,\"memory\":32.0},{\"timestamp\":\"2024-05-01T02:00:00Z\",\"cpu\":22.0,\"memory\":29.9}],\"timestampField\":\"timestamp\",\"metricFields\":[\"cpu\",\"memory\"],\"sensitivity\":0.6,\"detectionMethod\":\"statistical\",\"explainability\":true}", + "description": "Detect CPU and memory usage anomalies in hourly server metrics for May 1st." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Anomaly", + "context": null + } + }, + { + "name": "content-creation.generateDashboard", + "description": "Generates a customizable analytics dashboard by processing provided data sources and visualization preferences. Accepts multiple data inputs, filters, and chart configurations, and outputs a structured dashboard layout in JSON suitable for rendering in web or app interfaces.", + "category": "content-creation", + "parameters": [ + { + "name": "dataSources", + "type": "array", + "description": "Array of data source objects containing raw data or query info to populate dashboard charts.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Optional object defining filter criteria to apply on data before visualization, e.g., date ranges or categories.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "chartTypes", + "type": "array", + "description": "List of chart types (e.g., line, bar, pie) to be included in the dashboard and their configuration details.", + "required": true, + "defaultValue": "" + }, + { + "name": "layout", + "type": "string", + "description": "Layout mode or template identifier to arrange the charts on the dashboard (e.g., grid, freeform).", + "required": false, + "defaultValue": "grid" + }, + { + "name": "theme", + "type": "string", + "description": "Visual theme or color scheme for the dashboard, enhancing presentation aesthetics.", + "required": false, + "defaultValue": "light" + }, + { + "name": "title", + "type": "string", + "description": "Optional title for the generated dashboard for display purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "refreshInterval", + "type": "number", + "description": "Optional refresh interval in seconds for live dashboards to update data automatically.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "An object containing the dashboard configuration including charts, layout, filters, and metadata structured for rendering or further processing." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to create a data analytics dashboard from given datasets and visualization preferences, enabling data-driven insights display in a customizable format. Suitable for generating dashboards for web interfaces, reporting tools, or business intelligence platforms.", + "limitations": "This tool does not perform data extraction or cleaning; input data must be preprocessed and valid. It also does not render the visualizations but outputs a configuration JSON to be used by front-end components.", + "examples": [ + "Generate a sales dashboard with bar and line charts segmented by region and time.", + "Create a marketing KPI dashboard using pie charts with filters for campaign and date range.", + "Build a real-time server metrics dashboard updating every minute using a predefined layout and dark theme." + ] + }, + "tags": [ + "content-creation", + "dashboard", + "analytics", + "data-visualization", + "reporting", + "business-intelligence", + "generate" + ], + "examples": [ + { + "inputJson": "{\"dataSources\":[{\"name\":\"salesData\",\"type\":\"csv\",\"data\":\"...\"}],\"filters\":{\"dateRange\":\"lastQuarter\"},\"chartTypes\":[{\"type\":\"bar\",\"dataSource\":\"salesData\",\"xAxis\":\"region\",\"yAxis\":\"revenue\"},{\"type\":\"line\",\"dataSource\":\"salesData\",\"xAxis\":\"month\",\"yAxis\":\"profit\"}],\"layout\":\"grid\",\"theme\":\"light\",\"title\":\"Quarterly Sales Dashboard\",\"refreshInterval\":0}", + "description": "Generate a quarterly sales dashboard displaying revenue by region as bar chart and profit trends by month as line chart in a grid layout with light theme." + }, + { + "inputJson": "{\"dataSources\":[{\"name\":\"marketingData\",\"type\":\"json\",\"data\":\"...\"}],\"filters\":{\"campaign\":\"Summer2023\"},\"chartTypes\":[{\"type\":\"pie\",\"dataSource\":\"marketingData\",\"categoryField\":\"channel\",\"valueField\":\"engagement\"}],\"layout\":\"freeform\",\"theme\":\"dark\",\"title\":\"Marketing Campaign Engagement\",\"refreshInterval\":300}", + "description": "Create a marketing campaign engagement dashboard using a pie chart to show engagement by channel, with dark theme and auto-refresh every 5 minutes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Dashboard", + "context": null + } + }, + { + "name": "content-creation.generateEvent", + "description": "Generates a structured digital event object for analytics or event tracking systems based on input parameters such as event type, timestamp, user metadata, and event properties. It validates and compiles this data into a JSON-compatible event payload ready for ingestion or further processing.", + "category": "content-creation", + "parameters": [ + { + "name": "eventType", + "type": "string", + "description": "The name or type of the event to be generated (e.g., 'page_view', 'purchase').", + "required": true, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp representing when the event occurred. Defaults to current time if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier for the user related to this event, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "properties", + "type": "object", + "description": "An object containing key-value pairs that detail specific attributes or metadata of the event.", + "required": false, + "defaultValue": "" + }, + { + "name": "anonymousId", + "type": "string", + "description": "An anonymous identifier for the user, used when userId is not available.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the fully constructed event payload with eventType, timestamp, user info, and properties." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create standardized event data objects for analytics tracking or event logging. It helps in synthesizing structured event messages suitable for insertion into analytics pipelines or databases based on user inputs describing the event.", + "limitations": "This tool does not send or store events; it only generates the event object. It does not validate the semantic correctness of custom event properties or handle integration with external analytics services.", + "examples": [ + "Generate a 'purchase' event including user ID, purchase details, and timestamp.", + "Create a 'page_view' event with anonymous user ID and page metadata.", + "Produce a custom event with a specific timestamp and multiple properties describing user interaction." + ] + }, + "tags": [ + "content-creation", + "event", + "analytics", + "tracking", + "data-generation" + ], + "examples": [ + { + "inputJson": "{\"eventType\":\"purchase\",\"timestamp\":\"2024-06-01T14:52:00Z\",\"userId\":\"user_12345\",\"properties\":{\"itemId\":\"sku_9876\",\"price\":29.99,\"currency\":\"USD\"}}", + "description": "Generating a purchase event with user details and purchase properties." + }, + { + "inputJson": "{\"eventType\":\"page_view\",\"anonymousId\":\"anon_67890\",\"properties\":{\"pageUrl\":\"https://example.com/home\",\"referrer\":\"https://google.com\"}}", + "description": "Generating a page view event for an anonymous user with page metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Event", + "context": null + } + }, + { + "name": "content-creation.generateGraph", + "description": "Generates customizable graphs based on input datasets and specified chart types. Accepts structured data (e.g., arrays of data points), chart configuration options (such as type, labels, colors), and outputs a graph image or SVG suitable for embedding in documents or web pages.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of data points or objects representing the data to plot; each element should conform to the expected structure for the chosen chart type.", + "required": true, + "defaultValue": "" + }, + { + "name": "chartType", + "type": "string", + "description": "The type of graph to generate, e.g., 'line', 'bar', 'pie', 'scatter'. Determines the chart rendering style.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "The title displayed on the graph for context or identification.", + "required": false, + "defaultValue": "" + }, + { + "name": "xAxisLabel", + "type": "string", + "description": "Label for the X-axis to explain the data dimension represented horizontally.", + "required": false, + "defaultValue": "" + }, + { + "name": "yAxisLabel", + "type": "string", + "description": "Label for the Y-axis to explain the data dimension represented vertically.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output graph image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output graph image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "colors", + "type": "array", + "description": "An array of color strings to apply to various data series or slices for customization.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output format of the generated graph: 'PNG', 'JPEG', or 'SVG'.", + "required": false, + "defaultValue": "SVG" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated graph image encoded as a base64 string along with metadata; includes 'imageBase64', 'format', 'width', and 'height'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create visual representations of numerical or categorical data to enhance reports, presentations, or web content dynamically. Ideal for summarizing trends, distributions, comparisons, and proportions with clear, customizable graphs.", + "limitations": "Cannot process unstructured or very large datasets beyond typical memory limits; does not perform complex statistical analysis or interactive chart functionalities; requires correctly formatted input data to produce meaningful graphs.", + "examples": [ + "Generate a bar chart showing quarterly sales data with labeled axes and custom colors.", + "Create a pie chart representing market share distribution among competitors with a title and small dimensions for embedding.", + "Produce a scatter plot to visualize correlation between two variables with axis labels and output as PNG image." + ] + }, + "tags": [ + "graph generation", + "data visualization", + "chart creation", + "content-creation", + "media", + "reporting", + "presentation", + "image generation" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"label\":\"Q1\",\"value\":150},{\"label\":\"Q2\",\"value\":200},{\"label\":\"Q3\",\"value\":180},{\"label\":\"Q4\",\"value\":220}],\"chartType\":\"bar\",\"title\":\"Quarterly Sales\",\"xAxisLabel\":\"Quarter\",\"yAxisLabel\":\"Sales ($K)\",\"width\":800,\"height\":600,\"colors\":[\"#4a90e2\",\"#50e3c2\",\"#f5a623\",\"#d0021b\"],\"outputFormat\":\"SVG\"}", + "description": "Bar chart of quarterly sales with axis labels and custom colors." + }, + { + "inputJson": "{\"data\":[{\"category\":\"Brand A\",\"value\":40},{\"category\":\"Brand B\",\"value\":25},{\"category\":\"Brand C\",\"value\":20},{\"category\":\"Brand D\",\"value\":15}],\"chartType\":\"pie\",\"title\":\"Market Share\",\"width\":400,\"height\":400,\"colors\":[\"#3498db\",\"#2ecc71\",\"#e74c3c\",\"#9b59b6\"],\"outputFormat\":\"PNG\"}", + "description": "Pie chart showing market share distribution among brands." + }, + { + "inputJson": "{\"data\":[{\"x\":1,\"y\":2},{\"x\":2,\"y\":3},{\"x\":3,\"y\":5},{\"x\":4,\"y\":4}],\"chartType\":\"scatter\",\"title\":\"Variable Correlation\",\"xAxisLabel\":\"Variable X\",\"yAxisLabel\":\"Variable Y\",\"width\":600,\"height\":400,\"outputFormat\":\"JPEG\"}", + "description": "Scatter plot visualizing correlation between two variables." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Graph", + "context": null + } + }, + { + "name": "content-creation.generateDiagram", + "description": "Generates a structured diagram image based on textual description and optional customization parameters. Accepts input defining diagram type, nodes, connections, styles, and layout preferences, then produces a visual diagram file (SVG or PNG) representing the specified structure and relationships.", + "category": "content-creation", + "parameters": [ + { + "name": "diagramType", + "type": "string", + "description": "Specifies the diagram type to generate, e.g., flowchart, mindmap, orgChart, networkGraph", + "required": true, + "defaultValue": "" + }, + { + "name": "nodes", + "type": "array", + "description": "Array of node objects defining each node's id, label, and optional attributes for the diagram", + "required": true, + "defaultValue": "" + }, + { + "name": "edges", + "type": "array", + "description": "Array of edge objects defining connections, each with sourceNodeId, targetNodeId, and optional label or style", + "required": false, + "defaultValue": "[]" + }, + { + "name": "layoutStyle", + "type": "string", + "description": "Preferred layout style: hierarchical, radial, forceDirected, or grid", + "required": false, + "defaultValue": "hierarchical" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output image format, e.g., svg or png", + "required": false, + "defaultValue": "svg" + }, + { + "name": "theme", + "type": "string", + "description": "Visual theme for diagram colors and fonts, e.g., light, dark, corporate", + "required": false, + "defaultValue": "light" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output diagram image in pixels", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output diagram image in pixels", + "required": false, + "defaultValue": "600" + } + ], + "returns": { + "type": "object", + "description": "An object containing the base64 encoded diagram image data, output format, and metadata like node and edge counts" + }, + "aiAgent": { + "useCase": "Use this tool when you need to create visual diagrams from structured textual or data descriptions, such as flowcharts for workflows, organizational charts, mind maps for brainstorming, or network graphs for system relationships, especially when a quick visual representation is desired without manual drawing.", + "limitations": "Cannot interpret ambiguous or incomplete diagram descriptions; does not generate interactive diagrams; limited to predefined diagram types and simple styles; complex graphical customizations require external tools.", + "examples": [ + "Generate a flowchart diagram for a sales process with labeled nodes and directional edges.", + "Create an organizational chart diagram from a list of employees and their managers.", + "Produce a mind map diagram based on topics and subtopics with radial layout." + ] + }, + "tags": [ + "content-creation", + "diagram", + "visualization", + "flowchart", + "mindmap", + "orgChart", + "networkGraph", + "image-generation" + ], + "examples": [ + { + "inputJson": "{\"diagramType\":\"flowchart\",\"nodes\":[{\"id\":\"start\",\"label\":\"Start\"},{\"id\":\"step1\",\"label\":\"Submit Request\"},{\"id\":\"step2\",\"label\":\"Approve Request\"},{\"id\":\"end\",\"label\":\"End\"}],\"edges\":[{\"sourceNodeId\":\"start\",\"targetNodeId\":\"step1\"},{\"sourceNodeId\":\"step1\",\"targetNodeId\":\"step2\"},{\"sourceNodeId\":\"step2\",\"targetNodeId\":\"end\"}],\"layoutStyle\":\"hierarchical\",\"outputFormat\":\"svg\",\"theme\":\"corporate\",\"width\":1024,\"height\":768}", + "description": "A flowchart diagram illustrating a simple request approval process with start, steps, and end nodes." + }, + { + "inputJson": "{\"diagramType\":\"orgChart\",\"nodes\":[{\"id\":\"ceo\",\"label\":\"CEO\"},{\"id\":\"cto\",\"label\":\"CTO\"},{\"id\":\"dev1\",\"label\":\"Developer 1\"},{\"id\":\"dev2\",\"label\":\"Developer 2\"}],\"edges\":[{\"sourceNodeId\":\"ceo\",\"targetNodeId\":\"cto\"},{\"sourceNodeId\":\"cto\",\"targetNodeId\":\"dev1\"},{\"sourceNodeId\":\"cto\",\"targetNodeId\":\"dev2\"}],\"layoutStyle\":\"hierarchical\",\"outputFormat\":\"png\",\"theme\":\"light\",\"width\":800,\"height\":600}", + "description": "An organizational chart with CEO at the top, CTO reporting to CEO, and two developers reporting to CTO." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Diagram", + "context": null + } + }, + { + "name": "content-creation.generateChart", + "description": "Generates a customizable chart image based on input data and user-specified chart type, labels, and styling options. Accepts structured data arrays and configuration parameters, processes them to create charts such as bar, line, pie, or scatter, and outputs a URL or base64 image data of the generated chart.", + "category": "content-creation", + "parameters": [ + { + "name": "chartType", + "type": "string", + "description": "The type of chart to generate. Supported types include 'bar', 'line', 'pie', and 'scatter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "array", + "description": "An array of data points or series objects to plot on the chart. For bar and line charts, arrays of numbers or objects with labels and values are supported. For pie charts, an array of label-value pairs is required.", + "required": true, + "defaultValue": "" + }, + { + "name": "labels", + "type": "array", + "description": "An array of category labels for the data points (e.g., x-axis labels). Applies primarily to bar, line, and scatter charts.", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title text to display on the chart.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output chart image in pixels, default is 800.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output chart image in pixels, default is 600.", + "required": false, + "defaultValue": "600" + }, + { + "name": "backgroundColor", + "type": "string", + "description": "Hex or named color string for the chart background. Defaults to white (#FFFFFF).", + "required": false, + "defaultValue": "#FFFFFF" + }, + { + "name": "showLegend", + "type": "boolean", + "description": "Whether to display a legend on the chart. Useful for multi-series data. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a dataURL string with the chart image encoded in Base64 and optionally a direct image URL if hosted externally." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create visual graphical representations of numerical or categorical data for reports, dashboards, or presentations. It enables the generation of various chart types directly from structured data inputs, supporting customization of styling and labeling.", + "limitations": "Does not support highly complex or interactive charts (e.g., 3D, animated, GIS maps). Chart types are limited to common simple visualization forms. Large datasets may not render optimally. Does not interpret raw unstructured text data; input must be structured appropriately.", + "examples": [ + "Generate a bar chart showing monthly sales figures with labeled months and a title.", + "Create a pie chart representing market share percentages with distinct colors and a legend.", + "Produce a scatter plot from X/Y coordinate arrays to analyze data distribution." + ] + }, + "tags": [ + "chart", + "visualization", + "generate", + "content-creation", + "data-visualization", + "image" + ], + "examples": [ + { + "inputJson": "{\"chartType\":\"bar\",\"data\":[150, 200, 175, 225],\"labels\":[\"Q1\",\"Q2\",\"Q3\",\"Q4\"],\"title\":\"Quarterly Revenue\",\"width\":600,\"height\":400}", + "description": "Generate a bar chart of quarterly revenue with labels and a title." + }, + { + "inputJson": "{\"chartType\":\"pie\",\"data\":[{\"label\":\"Product A\",\"value\":40},{\"label\":\"Product B\",\"value\":25},{\"label\":\"Product C\",\"value\":35}],\"title\":\"Market Share\",\"backgroundColor\":\"#FAFAFA\",\"showLegend\":true}", + "description": "Create a pie chart illustrating market share by product with a legend." + }, + { + "inputJson": "{\"chartType\":\"scatter\",\"data\":[{\"x\":5,\"y\":20},{\"x\":10,\"y\":40},{\"x\":15,\"y\":25}],\"labels\":[],\"title\":\"Sample Scatter Plot\",\"width\":700,\"height\":500}", + "description": "Produce a scatter plot using x and y coordinate pairs without axis labels." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Chart", + "context": null + } + }, + { + "name": "content-creation.generateMetric", + "description": "Generates key performance metrics from given content analytics data. Accepts an array of content engagement records (such as views, clicks, shares) over a time range, applies aggregation and filtering based on parameters, and outputs calculated metrics like average engagement rate, growth trends, or content reach summaries in a structured format.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of engagement records with timestamps and metric values used for computation.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date of the time range for which to generate metrics, in ISO format.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date of the time range for which to generate metrics, in ISO format.", + "required": false, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of specific metric names to calculate (e.g., ['views', 'clicks', 'shares']). If empty, computes all available metrics.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "Aggregation method to apply (e.g., 'sum', 'average', 'max'). Defaults to 'sum'.", + "required": false, + "defaultValue": "sum" + }, + { + "name": "filterCriteria", + "type": "object", + "description": "Optional filters to apply on data fields (e.g., {'region':'NA', 'device':'mobile'}).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing calculated metrics and analysis results, including aggregated values, trends, and summaries." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quantify content performance by generating relevant metrics from raw engagement data. It helps summarize user interactions over specified periods or segments, supporting data-driven content strategy and reporting.", + "limitations": "Cannot directly collect raw data; assumes input data is pre-collected and correctly formatted. Does not perform advanced predictive analytics or visualizations.", + "examples": [ + "Generate average views and clicks metrics for last month's video content.", + "Calculate total shares and engagement growth between two dates for a given dataset.", + "Filter and summarize mobile user engagement metrics from the provided raw data array." + ] + }, + "tags": [ + "content", + "analytics", + "metric", + "engagement", + "aggregation", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-05-01T10:00:00Z\",\"views\":150,\"clicks\":30,\"shares\":5},{\"timestamp\":\"2024-05-02T10:00:00Z\",\"views\":200,\"clicks\":45,\"shares\":10}],\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-02\",\"metrics\":[\"views\",\"clicks\"],\"aggregationMethod\":\"sum\",\"filterCriteria\":{}}", + "description": "Sum views and clicks over two days for content engagement data." + }, + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-04-10T09:00:00Z\",\"views\":100,\"clicks\":20,\"shares\":2},{\"timestamp\":\"2024-04-15T15:00:00Z\",\"views\":220,\"clicks\":50,\"shares\":12}],\"startDate\":\"2024-04-01\",\"endDate\":\"2024-04-30\",\"metrics\":[\"shares\"],\"aggregationMethod\":\"average\",\"filterCriteria\":{\"region\":\"EU\"}}", + "description": "Average shares in April filtered by region 'EU'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Metric", + "context": null + } + }, + { + "name": "content-creation.generateHTML", + "description": "Generates custom HTML markup based on structured input data and options. Accepts content elements such as text, images, links, and layout preferences, processes these to create a well-formed HTML string suitable for web pages or email templates.", + "category": "content-creation", + "parameters": [ + { + "name": "contentElements", + "type": "array", + "description": "An array of content element objects describing the HTML components to generate, including type and content details.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeStyles", + "type": "boolean", + "description": "Whether to include basic CSS styles inline in the generated HTML for layout and formatting.", + "required": false, + "defaultValue": "false" + }, + { + "name": "doctype", + "type": "string", + "description": "The document type declaration to use, e.g., 'html' for or empty to omit.", + "required": false, + "defaultValue": "html" + }, + { + "name": "language", + "type": "string", + "description": "The language code for the HTML document's lang attribute, e.g. 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "title", + "type": "string", + "description": "The title text to include in the HTML head section.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a single property 'html' which holds the generated HTML string representing the requested content structure." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate structured HTML output from abstract content definitions, such as creating web page templates, email newsletter content, or any customizable HTML documents based on input data. It helps automate HTML creation without manual coding.", + "limitations": "Does not support generating interactive JavaScript functionality or complex dynamic content. Focused on static HTML and simple inline styles only.", + "examples": [ + "Generate a basic webpage with a title, header, paragraph, and image.", + "Create an HTML email template with inline styles and links.", + "Produce localized HTML content by specifying the document language and title." + ] + }, + "tags": [ + "html", + "content-generation", + "web", + "email", + "template", + "markup" + ], + "examples": [ + { + "inputJson": "{\"contentElements\":[{\"type\":\"header\",\"level\":1,\"text\":\"Welcome to Our Site\"},{\"type\":\"paragraph\",\"text\":\"This is an introductory paragraph describing our services.\"},{\"type\":\"image\",\"src\":\"https://example.com/image.jpg\",\"alt\":\"Example Image\"}],\"includeStyles\":true,\"doctype\":\"html\",\"language\":\"en\",\"title\":\"Home Page\"}", + "description": "Generate a simple English webpage with a header, paragraph, and image including basic styles." + }, + { + "inputJson": "{\"contentElements\":[{\"type\":\"paragraph\",\"text\":\"Dear subscriber, check out our latest news!\"},{\"type\":\"link\",\"href\":\"https://news.example.com\",\"text\":\"Latest Updates\"}],\"includeStyles\":true,\"doctype\":\"html\",\"language\":\"en\",\"title\":\"Newsletter\"}", + "description": "Generate an HTML email template with styled paragraph and link content." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "HTML", + "context": null + } + }, + { + "name": "content-creation.generateForecast", + "description": "Generates a detailed business forecast report based on historical sales data, market trends, and user-defined parameters such as forecast period and confidence interval. The tool analyzes input data, applies forecasting models, and outputs projections including expected sales, revenue, and growth metrics in structured JSON format.", + "category": "content-creation", + "parameters": [ + { + "name": "historicalData", + "type": "array", + "description": "Array of past sales or revenue records with date and value pairs used for training the forecast model.", + "required": true, + "defaultValue": "" + }, + { + "name": "forecastPeriodMonths", + "type": "number", + "description": "Number of months ahead for which to generate the forecast.", + "required": true, + "defaultValue": "12" + }, + { + "name": "confidenceLevel", + "type": "number", + "description": "Statistical confidence level (in percent) for forecast intervals, e.g., 95 for 95% confidence.", + "required": false, + "defaultValue": "95" + }, + { + "name": "includeMarketTrends", + "type": "boolean", + "description": "Flag indicating whether to incorporate external market trend factors into the forecast.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format for the output report, options include 'json' or 'csv'.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "An object containing forecast projections by month, confidence intervals, summary statistics including predicted revenue, growth rate, and a brief explanation of the forecast methodology." + }, + "aiAgent": { + "useCase": "Use this tool when a user needs to predict future sales and revenue based on their historical data combined optionally with market trends, allowing for business planning, budgeting, or risk assessment. It is suitable for generating time-series forecasts with confidence intervals for decision support.", + "limitations": "Cannot replace domain expert analysis; accuracy depends on quality and completeness of historical data; does not incorporate unexpected disruptive events or qualitative factors beyond provided inputs.", + "examples": [ + "Generate a 6-month sales forecast with 90% confidence using the provided past two years of sales data.", + "Produce a 12-month revenue projection including market trends for a new product line.", + "Create a JSON report of upcoming quarterly revenue forecast with standard 95% confidence intervals." + ] + }, + "tags": [ + "forecasting", + "business", + "sales", + "revenue", + "time-series", + "analytics" + ], + "examples": [ + { + "inputJson": "{\"historicalData\":[{\"date\":\"2022-01\",\"value\":10000},{\"date\":\"2022-02\",\"value\":10500},{\"date\":\"2022-03\",\"value\":11000}],\"forecastPeriodMonths\":6,\"confidenceLevel\":90,\"includeMarketTrends\":true,\"outputFormat\":\"json\"}", + "description": "Six-month sales forecast with a 90% confidence interval using recent quarterly data with market trends." + }, + { + "inputJson": "{\"historicalData\":[{\"date\":\"2021-01\",\"value\":5000},{\"date\":\"2021-02\",\"value\":5200},{\"date\":\"2021-03\",\"value\":5100},{\"date\":\"2021-04\",\"value\":5300}],\"forecastPeriodMonths\":12,\"confidenceLevel\":95,\"includeMarketTrends\":false,\"outputFormat\":\"csv\"}", + "description": "One-year forecast without market trends producing CSV formatted report for export." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Forecast", + "context": null + } + }, + { + "name": "content-creation.generateCSV", + "description": "Generates a CSV-formatted string from structured data input. Accepts an array of objects or arrays representing rows. Supports custom delimiter, optional inclusion of headers, and configurable text quoting. Outputs valid CSV content as a string suitable for file creation or data exchange.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects or arrays where each item represents a CSV row. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include the headers as the first CSV row. Ignored if data is array of arrays. Optional.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate values in the CSV, default is a comma. Optional.", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteAllFields", + "type": "boolean", + "description": "Whether to quote all fields in the CSV. If false, quotes only necessary fields. Optional.", + "required": false, + "defaultValue": "false" + }, + { + "name": "lineSeparator", + "type": "string", + "description": "String to separate lines, default is \"\\n\". Optional.", + "required": false, + "defaultValue": "\n" + } + ], + "returns": { + "type": "object", + "description": "Object containing a single string field 'csv' representing the complete CSV content." + }, + "aiAgent": { + "useCase": "Use this tool when needing to transform structured data such as JSON arrays of objects or arrays into CSV format for spreadsheet compatibility, data export, or interoperability. Ideal for generating CSV content to supply to users, downstream systems, or for file generation.", + "limitations": "This tool does not handle extremely large datasets that exceed memory limits, nor does it perform validation of input data structure correctness. It also does not generate CSV files but returns CSV content as a string only.", + "examples": [ + "Generate CSV from array of objects with headers.", + "Generate CSV from array of arrays without headers.", + "Generate CSV using semicolon delimiter and quoting all fields." + ] + }, + "tags": [ + "content-creation", + "csv", + "data-export", + "formatting", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"includeHeaders\":true,\"delimiter\":\",\",\"quoteAllFields\":false,\"lineSeparator\":\"\\n\"}", + "description": "Generate a CSV string from an array of objects including headers with default comma delimiter." + }, + { + "inputJson": "{\"data\":[[\"name\",\"age\",\"city\"],[\"Alice\",30,\"New York\"],[\"Bob\",25,\"Los Angeles\"]],\"includeHeaders\":false,\"delimiter\":\",\",\"quoteAllFields\":false,\"lineSeparator\":\"\\n\"}", + "description": "Generate a CSV string from an array of arrays without adding headers." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Widget\",\"price\":19.99,\"quantity\":10},{\"product\":\"Gadget\",\"price\":29.99,\"quantity\":5}],\"includeHeaders\":true,\"delimiter\":\";\",\"quoteAllFields\":true,\"lineSeparator\":\"\\r\\n\"}", + "description": "Generate CSV with semicolon delimiter and all fields quoted, using CRLF as line separator." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "CSV", + "context": null + } + }, + { + "name": "content-creation.generateMarkdown", + "description": "Generates Markdown formatted text based on structured input content including headings, paragraphs, lists, links, images, code blocks, and other common Markdown elements. Accepts inputs describing the document structure and content, then produces a complete Markdown string output suitable for documentation, blogging, or note-taking.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "Primary title of the Markdown document, rendered as an H1 heading.", + "required": false, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects defining headers, content paragraphs, lists, code blocks, images, and links, which together form the Markdown document body.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Flag to indicate whether to prepend a generated table of contents based on section headers.", + "required": false, + "defaultValue": "false" + }, + { + "name": "codeLanguageDefault", + "type": "string", + "description": "Default programming language label to use for code blocks if not specified in individual sections.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single property 'markdown' which is a string of the assembled Markdown content representing the provided input structure." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create well-structured Markdown documents from abstract content descriptions or templates, such as for automating documentation, blog post drafts, reports, or notes.", + "limitations": "Cannot generate Markdown content from unstructured raw text or natural language descriptions directly without pre-formatted sections input. It does not apply advanced semantic understanding or writing style refinement.", + "examples": [ + "Generate a README file with sections for Introduction, Installation, Usage, and License.", + "Create a blog post draft with headings, paragraphs, and embedded images and code examples.", + "Produce a project summary document with a table of contents and multiple nested list items." + ] + }, + "tags": [ + "content", + "markdown", + "document", + "generation", + "writing", + "automation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Sample Document\",\"sections\":[{\"header\":\"Introduction\",\"content\":[{\"type\":\"paragraph\",\"text\":\"This is an example introduction.\"},{\"type\":\"list\",\"ordered\":false,\"items\":[\"Point one\",\"Point two\"]}]},{\"header\":\"Code Example\",\"content\":[{\"type\":\"code\",\"text\":\"console.log('Hello, world!');\",\"language\":\"javascript\"}]}],\"includeTableOfContents\":true}", + "description": "Generates a Markdown document with title, introduction, bullet list, code example, and a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Markdown", + "context": null + } + }, + { + "name": "content-creation.generateXML", + "description": "Generates well-formed XML documents based on provided data and structure definitions. Accepts an input object representing the hierarchical data or a predefined schema, processes it to create valid XML string output suitable for data exchange, configuration files, or content storage.", + "category": "content-creation", + "parameters": [ + { + "name": "rootElementName", + "type": "string", + "description": "Name of the root XML element in the generated document.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataObject", + "type": "object", + "description": "Hierarchical object representing the nested elements and their values or attributes to construct the XML content.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeDeclaration", + "type": "boolean", + "description": "Flag to include the XML declaration header (e.g. ).", + "required": false, + "defaultValue": "true" + }, + { + "name": "attributesMap", + "type": "object", + "description": "Optional mapping that defines XML attributes for specific elements identified by their path or key in the dataObject.", + "required": false, + "defaultValue": "" + }, + { + "name": "prettyPrint", + "type": "boolean", + "description": "If true, the output XML will be indented and formatted for readability; otherwise, it is minified.", + "required": false, + "defaultValue": "true" + }, + { + "name": "encoding", + "type": "string", + "description": "Character encoding to declare in the XML header if included (e.g., 'UTF-8').", + "required": false, + "defaultValue": "UTF-8" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated XML string and metadata such as success status and error messages if any." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert structured data into a standardized XML format for interoperability, configuration files generation, or content export. It is ideal for preparing XML outputs from JSON-like data structures, providing control over elements, attributes, and formatting.", + "limitations": "Does not perform XML schema validation or enforce complex data constraints beyond structural conversion. Input must be serializable to XML elements; complex data types like functions or circular references are unsupported.", + "examples": [ + "Generate an XML configuration file from a nested data object specifying settings and attributes.", + "Create XML content representing a catalog of products, including elements with attributes and nested child elements.", + "Produce a pretty-printed XML document with a custom root element name and specific encoding header." + ] + }, + "tags": [ + "content-creation", + "XML", + "data-format", + "serialization", + "configuration", + "export" + ], + "examples": [ + { + "inputJson": "{\"rootElementName\":\"library\",\"dataObject\":{\"book\":[{\"title\":\"1984\",\"author\":\"George Orwell\",\"year\":1949},{\"title\":\"Brave New World\",\"author\":\"Aldous Huxley\",\"year\":1932}]},\"includeDeclaration\":true,\"prettyPrint\":true}", + "description": "Generate a pretty XML catalog with books inside a library root element including XML declaration." + }, + { + "inputJson": "{\"rootElementName\":\"config\",\"dataObject\":{\"database\":{\"host\":\"localhost\",\"port\":3306},\"debug\":true},\"attributesMap\":{\"database\":{\"type\":\"sql\"}},\"includeDeclaration\":false,\"prettyPrint\":false}", + "description": "Generate a compact XML config file without declaration, adding an attribute to the database element." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "XML", + "context": null + } + }, + { + "name": "content-creation.generateYAML", + "description": "Generates YAML formatted text from input data provided as an object or string. Accepts structured JSON or plain text input, converts it into properly indented YAML syntax, and outputs a YAML string suitable for configuration, data serialization, or documentation purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "inputData", + "type": "object", + "description": "The input data to convert to YAML format; must be a JSON-serializable object representing the data structure.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to prepend a YAML document start marker ('---') at the beginning of the output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for indentation in the YAML output, improving readability.", + "required": false, + "defaultValue": "2" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line width before folding long lines in the YAML output; set 0 for no line wrapping.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single property 'yamlString' which is the generated YAML string representing the input data." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert structured data represented as JSON or similar objects into YAML format for configuration files, data exchange, or documentation. Particularly useful when preparing input for systems or tools that consume YAML.", + "limitations": "This tool does not validate the business logic of the input data beyond structural conversion. Extremely large or deeply nested data may have performance impact or require additional handling.", + "examples": [ + "Convert a JSON object describing an application configuration into YAML for deployment.", + "Generate a YAML manifest from structured input to provide configuration documentation.", + "Create a YAML representation of nested data received from an API for easier human reading or editing." + ] + }, + "tags": [ + "content-creation", + "data-conversion", + "YAML", + "serialization", + "configuration", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"inputData\":{\"appName\":\"ExampleApp\",\"version\":\"1.2.3\",\"features\":[\"featureA\",\"featureB\"],\"settings\":{\"debug\":true,\"maxUsers\":100}},\"includeHeader\":true,\"indentation\":2,\"lineWidth\":80}", + "description": "Generate a YAML document from an application config object including document start marker and default indentation." + }, + { + "inputJson": "{\"inputData\":{\"database\":{\"host\":\"localhost\",\"port\":5432,\"credentials\":{\"user\":\"admin\",\"password\":\"secret\"}}},\"includeHeader\":false,\"indentation\":4,\"lineWidth\":0}", + "description": "Generate YAML from a nested database config object with 4 spaces indentation and no line wrapping." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "YAML", + "context": null + } + }, + { + "name": "content-creation.generateJSON", + "description": "Generates structured JSON data based on a user-defined schema, data templates, or simple property-value inputs. Accepts an object describing desired keys, types, and optionally sample values or constraints, then produces a JSON string or object adhering to those specifications, useful for mock data generation or API response simulation.", + "category": "content-creation", + "parameters": [ + { + "name": "schema", + "type": "object", + "description": "An object defining keys, their data types (string, number, boolean, array, object), and optionally sample values or constraints for generating the JSON structure.", + "required": true, + "defaultValue": "" + }, + { + "name": "numberOfEntries", + "type": "number", + "description": "The number of JSON objects to generate if an array output is desired.", + "required": false, + "defaultValue": "1" + }, + { + "name": "outputAsString", + "type": "boolean", + "description": "Whether to output the generated JSON as a string (true) or a parsed object (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeNulls", + "type": "boolean", + "description": "Flag to include null values for optional fields not specified with samples or constraints.", + "required": false, + "defaultValue": "false" + }, + { + "name": "randomSeed", + "type": "number", + "description": "Optional seed for random data generation to allow reproducible outputs.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns a JSON object or JSON string (based on outputAsString) containing generated data adhering to the input schema and constraints. If numberOfEntries > 1, returns an array of such objects." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate mock JSON data based on explicit schema definitions or templates, for testing, development, or prototyping APIs and content structures. It helps produce structured samples without manual JSON coding.", + "limitations": "Cannot generate deeply complex nested objects without explicit schema detail. Does not synthesize meaningful textual content beyond provided samples or simple random generation. Does not validate business logic constraints beyond type and basic value rules.", + "examples": [ + "Generate a single JSON object with user profile fields: name (string), age (number), email (string).", + "Create an array of 5 JSON objects representing product items with id (number), name (string), price (number), and inStock (boolean).", + "Output formatted JSON string representing configuration settings with optional null fields included." + ] + }, + "tags": [ + "content-creation", + "generate", + "json", + "mock-data", + "schema-based", + "data-generation" + ], + "examples": [ + { + "inputJson": "{\"schema\":{\"name\":{\"type\":\"string\"},\"age\":{\"type\":\"number\"},\"email\":{\"type\":\"string\"}},\"numberOfEntries\":1,\"outputAsString\":true}", + "description": "Generate a single JSON object with user profile information, output as JSON string." + }, + { + "inputJson": "{\"schema\":{\"id\":{\"type\":\"number\"},\"name\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"},\"inStock\":{\"type\":\"boolean\"}},\"numberOfEntries\":5,\"outputAsString\":false}", + "description": "Generate an array of 5 product JSON objects as parsed object." + }, + { + "inputJson": "{\"schema\":{\"settingName\":{\"type\":\"string\"},\"enabled\":{\"type\":\"boolean\"},\"value\":{\"type\":\"string\"}},\"numberOfEntries\":2,\"outputAsString\":true,\"includeNulls\":true}", + "description": "Generate 2 JSON configuration objects as strings, including null fields where applicable." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "JSON", + "context": null + } + }, + { + "name": "content-creation.generateDataset", + "description": "Generates synthetic datasets based on user-defined schema and parameters. Accepts input such as field definitions, data types, number of records, and optional data constraints to produce a structured JSON or CSV dataset suitable for testing, training, or prototyping.", + "category": "content-creation", + "parameters": [ + { + "name": "schema", + "type": "array", + "description": "An array of field definitions specifying each field's name, type, and constraints; e.g., [{\"fieldName\":\"age\",\"type\":\"number\",\"min\":18,\"max\":65}].", + "required": true, + "defaultValue": "" + }, + { + "name": "recordCount", + "type": "number", + "description": "The total number of data records to generate in the dataset.", + "required": true, + "defaultValue": "100" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: 'json' for JSON array, or 'csv' for CSV string.", + "required": false, + "defaultValue": "json" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include headers as first row in CSV output; ignored for JSON output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "seed", + "type": "number", + "description": "Optional random seed for reproducibility of the generated dataset.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated dataset as a string under the 'data' key, formatted as specified, and a 'meta' key with information about the schema and record count." + }, + "aiAgent": { + "useCase": "Use this tool when synthetic or mock data is required for software testing, machine learning model training, or prototyping applications without exposing real user information. It helps generate customizable datasets quickly based on user-defined field types and constraints.", + "limitations": "This tool cannot generate meaningful real-world relationships between fields beyond the specified field constraints. It does not validate complex schema dependencies or ensure semantic correctness between fields.", + "examples": [ + "Generate a dataset of 500 user profiles with fields: name (string), age (number between 18 and 80), and email (string).", + "Create 1000 records of product data with fields: productId (string), price (number between 5 and 500), and inStock (boolean).", + "Produce a CSV dataset of 200 entries with fields: date (date string), temperature (number between -20 and 40), and condition (string from list: sunny, rainy, cloudy)." + ] + }, + "tags": [ + "content-creation", + "dataset-generation", + "synthetic-data", + "mock-data", + "data-science", + "testing" + ], + "examples": [ + { + "inputJson": "{\"schema\":[{\"fieldName\":\"age\",\"type\":\"number\",\"min\":18,\"max\":65},{\"fieldName\":\"gender\",\"type\":\"string\",\"values\":[\"Male\",\"Female\",\"Other\"]}],\"recordCount\":10,\"outputFormat\":\"json\"}", + "description": "Generate 10 records with age numbers between 18 and 65 and gender as categorical values." + }, + { + "inputJson": "{\"schema\":[{\"fieldName\":\"productId\",\"type\":\"string\"},{\"fieldName\":\"price\",\"type\":\"number\",\"min\":5,\"max\":500},{\"fieldName\":\"inStock\",\"type\":\"boolean\"}],\"recordCount\":5,\"outputFormat\":\"csv\",\"includeHeaders\":true}", + "description": "Generate 5 product records in CSV format including headers." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Dataset", + "context": null + } + }, + { + "name": "content-creation.generateTest", + "description": "Generates automated test code based on input specifications such as programming language, test framework, function or class details, and test scenarios. Processes structured input to produce syntactically correct and logically relevant unit or integration test code snippets for software development purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "language", + "type": "string", + "description": "Programming language for the generated test code (e.g., 'JavaScript', 'Python').", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "Testing framework to target (e.g., 'Jest', 'Mocha', 'PyTest').", + "required": true, + "defaultValue": "" + }, + { + "name": "functionName", + "type": "string", + "description": "Name of the function or method to be tested.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputParameters", + "type": "array", + "description": "Array of input parameter names and sample values for the function under test.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "testCases", + "type": "array", + "description": "Array of test case objects each specifying description, inputs, and expected output for test scenarios.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "includeSetupTeardown", + "type": "boolean", + "description": "Whether to include setup and teardown methods in the generated test code.", + "required": false, + "defaultValue": "false" + }, + { + "name": "testType", + "type": "string", + "description": "Type of test to generate: 'unit' or 'integration'.", + "required": false, + "defaultValue": "unit" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated test code as a string under the 'code' key and optionally the language and framework metadata." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automate the creation of software test code based on detailed input about the functions and expected behaviors to be tested. It helps developers save time by producing boilerplate test code consistent with a specified language and testing framework.", + "limitations": "Cannot generate tests for undocumented or highly complex behaviors that lack clear expected outputs. Does not replace thorough manual test design in complex systems. Quality of generated tests depends on input completeness and accuracy.", + "examples": [ + "Generate unit tests in JavaScript using Jest for a function that adds two numbers.", + "Create PyTest integration tests for a database access class with multiple scenarios.", + "Produce Mocha test code with setup and teardown for a function validating email addresses." + ] + }, + "tags": [ + "testing", + "code-generation", + "software-development", + "unit-tests", + "integration-tests", + "automation", + "programming" + ], + "examples": [ + { + "inputJson": "{\"language\":\"JavaScript\",\"testFramework\":\"Jest\",\"functionName\":\"addNumbers\",\"inputParameters\":[{\"name\":\"a\",\"value\":1},{\"name\":\"b\",\"value\":2}],\"testCases\":[{\"description\":\"adds positive numbers\",\"inputs\":{\"a\":1,\"b\":2},\"expected\":3},{\"description\":\"adds negative numbers\",\"inputs\":{\"a\":-1,\"b\":-2},\"expected\":-3}],\"includeSetupTeardown\":false,\"testType\":\"unit\"}", + "description": "Generate Jest unit tests for a simple addNumbers function with positive and negative input cases." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Test", + "context": null + } + }, + { + "name": "content-creation.generateQuery", + "description": "Generates a structured query string based on provided parameters like keywords, filters, and sort options. Accepts an object detailing query criteria, processes these to build a valid query (e.g., SQL, GraphQL, or search engine query) string, which can be used to retrieve targeted data or content.", + "category": "content-creation", + "parameters": [ + { + "name": "queryType", + "type": "string", + "description": "The type of query to generate, e.g., 'SQL', 'GraphQL', 'search'. Determines the syntax and structure of the output query string.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "An array of keywords or key phrases to include in the query for matching relevant content or data.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "filters", + "type": "object", + "description": "Optional filters as key-value pairs to narrow down the query results, e.g., {status: 'active', dateFrom: '2023-01-01'}.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "sortBy", + "type": "string", + "description": "Optional field name to sort the query results by, e.g., 'date', 'relevance'.", + "required": false, + "defaultValue": "" + }, + { + "name": "sortOrder", + "type": "string", + "description": "Sort order direction: 'asc' for ascending or 'desc' for descending. Defaults to 'asc'.", + "required": false, + "defaultValue": "asc" + }, + { + "name": "limit", + "type": "number", + "description": "Maximum number of results to return in the query output. Useful for pagination or performance.", + "required": false, + "defaultValue": "10" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated query string formatted according to the specified query type. Includes the 'queryString' key with the constructed query." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create structured queries dynamically based on user input or contextual parameters to fetch data or content. Particularly useful when the target data source supports SQL, GraphQL, or search engine queries, enabling precise retrieval without manual query construction.", + "limitations": "This tool does not execute queries or validate against specific database schemas. It generates generic queries based on provided parameters but does not guarantee syntax compatibility with all database dialects or APIs.", + "examples": [ + "Generate a SQL query to find active users created after a certain date, sorted by creation date descending.", + "Create a GraphQL query filtering products by category and price range.", + "Build a search engine query string to find articles containing specific keywords with relevance sorting." + ] + }, + "tags": [ + "content-creation", + "query-generation", + "search", + "SQL", + "GraphQL", + "filtering", + "sorting" + ], + "examples": [ + { + "inputJson": "{\"queryType\":\"SQL\",\"keywords\":[\"customer\",\"subscription\"],\"filters\":{\"status\":\"active\",\"createdAfter\":\"2023-01-01\"},\"sortBy\":\"createdAt\",\"sortOrder\":\"desc\",\"limit\":50}", + "description": "Generate a SQL query to find active customer subscriptions created after January 1, 2023, sorted by creation date descending, limited to 50 results." + }, + { + "inputJson": "{\"queryType\":\"GraphQL\",\"keywords\":[\"product\",\"inStock\"],\"filters\":{\"category\":\"electronics\",\"priceRange\":{\"min\":100,\"max\":500}},\"sortBy\":\"price\",\"sortOrder\":\"asc\",\"limit\":20}", + "description": "Generate a GraphQL query to find electronic products in stock priced between 100 and 500, sorted by price ascending, limited to 20." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Query", + "context": null + } + }, + { + "name": "content-creation.generateCode", + "description": "Generates syntactically correct source code snippets based on natural language prompts or specified requirements. Accepts programming language, functional description, coding style preferences, and optional input/output examples; produces executable code snippets suitable for integration or learning.", + "category": "content-creation", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "Target programming language for the generated code, e.g., 'Python', 'JavaScript', 'Java'.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionalityDescription", + "type": "string", + "description": "Natural language description of the functionality or task the generated code should perform.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeStylePreferences", + "type": "object", + "description": "Optional preferences for code style such as indentation, variable naming conventions, or use of libraries.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "inputExamples", + "type": "array", + "description": "Optional array of example inputs used to guide the code generation (e.g., sample function inputs).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputExamples", + "type": "array", + "description": "Optional array of expected outputs corresponding to inputExamples for testing correctness.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLines", + "type": "number", + "description": "Maximum number of lines of code to generate to limit output size.", + "required": false, + "defaultValue": "50" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated code snippet as a string, language identified, and optionally explanation or notes." + }, + "aiAgent": { + "useCase": "This tool is ideal when an agent needs to programmatically generate executable code snippets from natural language specifications for rapid prototyping, learning examples, or to augment automation pipelines with custom code modules. It simplifies code creation based on clear functional requirements without manual coding.", + "limitations": "It cannot guarantee fully optimized performance or perfect security. It may not generate complex multi-file projects or applications requiring deep architectural design. Generated code should be reviewed and tested before production use.", + "examples": [ + "Generate a Python function to compute factorial of a number.", + "Create a JavaScript snippet to validate email format.", + "Provide a Java method that reverses a string using recursion." + ] + }, + "tags": [ + "code generation", + "programming", + "automation", + "snippet", + "source code", + "developer tools" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"Python\",\"functionalityDescription\":\"Compute the factorial of a non-negative integer.\",\"codeStylePreferences\":{\"indentation\":\"4 spaces\"},\"inputExamples\":[5],\"outputExamples\":[120],\"maxLines\":20}", + "description": "Generate a Python function calculating factorial of a number." + }, + { + "inputJson": "{\"programmingLanguage\":\"JavaScript\",\"functionalityDescription\":\"Validate if an input string is a valid email address.\",\"codeStylePreferences\":{\"variableNaming\":\"camelCase\"},\"maxLines\":30}", + "description": "Create a JavaScript code snippet for email validation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Code", + "context": null + } + }, + { + "name": "content-creation.generateSchema", + "description": "Generates a JSON Schema draft from a provided simplified object definition or example data. Accepts a JSON object or string example, processes its structure, types, and constraints, and outputs a detailed JSON Schema draft compliant with the JSON Schema specification.", + "category": "content-creation", + "parameters": [ + { + "name": "inputExample", + "type": "object", + "description": "The JSON object or example structure from which to generate the JSON Schema.", + "required": true, + "defaultValue": "" + }, + { + "name": "schemaVersion", + "type": "string", + "description": "The JSON Schema draft version to generate, e.g., \"draft07\" or \"draft2019-09\".", + "required": false, + "defaultValue": "draft07" + }, + { + "name": "includeDescriptions", + "type": "boolean", + "description": "Whether to include placeholder description fields for each property in the generated schema.", + "required": false, + "defaultValue": "false" + }, + { + "name": "requiredFields", + "type": "array", + "description": "An optional array listing property names to explicitly mark as required in the schema. If empty or omitted, properties are inferred as required if present in the inputExample.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object representing the generated JSON Schema including $schema field, properties with types, and constraints extracted from the input." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create a JSON Schema draft from example JSON data or simple object definitions to validate data inputs, generate documentation, or scaffold schema-driven interfaces. It helps automate schema creation for APIs, configurations, or data validation layers.", + "limitations": "This tool cannot perfectly infer complex validation rules like pattern matching, advanced dependencies, or conditional schemas. It also does not generate schemas from unstructured text or non-JSON inputs.", + "examples": [ + "Generate a JSON Schema draft07 for API request validation from a sample payload.", + "Create a schema to validate config files based on typical example data.", + "Produce a schema draft2019-09 including descriptions for all fields to use in frontend form generation." + ] + }, + "tags": [ + "generation", + "schema", + "json", + "validation", + "content-creation", + "automation" + ], + "examples": [ + { + "inputJson": "{\"inputExample\":{\"name\":\"John Doe\",\"age\":30,\"email\":\"john@example.com\",\"isActive\":true},\"schemaVersion\":\"draft07\",\"includeDescriptions\":false,\"requiredFields\":[\"name\",\"email\"]}", + "description": "Generate a draft07 JSON Schema from a user profile example marking 'name' and 'email' as required without descriptions." + }, + { + "inputJson": "{\"inputExample\":{\"productId\":12345,\"price\":99.99,\"tags\":[\"new\",\"sale\"]},\"schemaVersion\":\"draft2019-09\",\"includeDescriptions\":true,\"requiredFields\":[]}", + "description": "Generate a draft2019-09 schema including descriptions for product data with inferred required fields." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Schema", + "context": null + } + }, + { + "name": "content-creation.generateReadme", + "description": "Generates a professional README.md file for software projects based on detailed project information provided. Accepts inputs such as project name, description, installation instructions, usage examples, features, license, and author details, processing these to output a structured markdown README document.", + "category": "content-creation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project to be displayed as the main title in the README.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A concise description summarizing the purpose and scope of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions for installing the project or necessary dependencies.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageInformation", + "type": "string", + "description": "Examples or commands explaining how to use the project effectively.", + "required": false, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "A list of key features or highlights of the project to showcase.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "license", + "type": "string", + "description": "The license under which the project is released (e.g., MIT, GPL).", + "required": false, + "defaultValue": "" + }, + { + "name": "contributingGuidelines", + "type": "string", + "description": "Instructions or rules for contributing to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the project author or maintainer to be displayed in the README.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalSections", + "type": "array", + "description": "Optional custom sections with titles and content to be appended to the README. Each item should be an object with 'title' and 'content' string properties.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete README content as a markdown string, ready to be saved or displayed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent receives a request to create or update a comprehensive README.md file for a software project based on structured input about project details. It helps generate consistent, professional documentation automatically.", + "limitations": "This tool cannot verify technical accuracy of the content nor generate code snippets beyond provided usage info. It also cannot replace human review for style or completeness.", + "examples": [ + "Create a README for a new CLI tool called 'FastBuild' with installation and usage instructions.", + "Generate a README including project features, license, and contribution guidelines for an open-source library.", + "Produce a README file using just project name and description with optional additional custom sections." + ] + }, + "tags": [ + "content-creation", + "documentation", + "README", + "markdown", + "software", + "project", + "generate" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"FastBuild\",\"projectDescription\":\"A fast and efficient build tool for modern JavaScript projects.\",\"installationInstructions\":\"Run npm install -g fastbuild\",\"usageInformation\":\"fastbuild build --watch\",\"features\":[\"Blazing fast incremental builds\",\"Built-in caching\",\"Easy CLI interface\"],\"license\":\"MIT\",\"contributingGuidelines\":\"Please open issues for bugs and submit pull requests.\",\"authorName\":\"Jane Developer\",\"additionalSections\":[]}", + "description": "Generate a full README with detailed installation, usage, features, license, contribution guidelines, and author." + }, + { + "inputJson": "{\"projectName\":\"MyLibrary\",\"projectDescription\":\"A lightweight utility library for data manipulation.\",\"installationInstructions\":\"npm install mylibrary\",\"usageInformation\":\"const lib = require('mylibrary');\\nlib.doSomething();\",\"features\":[],\"license\":\"Apache-2.0\",\"contributingGuidelines\":\"\",\"authorName\":\"\",\"additionalSections\":[{\"title\":\"FAQ\",\"content\":\"Q: Is this library compatible with Node.js?\\nA: Yes, fully compatible.\"}]}", + "description": "Create README with minimal feature list but includes a custom FAQ section." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Readme", + "context": null + } + }, + { + "name": "content-creation.generateTemplate", + "description": "Generates customizable document templates based on user-defined parameters such as template type, sections, and styling preferences. Accepts parameters defining the template's intended use (e.g., report, invoice), desired sections, and formatting options, then outputs a structured template object including placeholders for dynamic content.", + "category": "content-creation", + "parameters": [ + { + "name": "templateType", + "type": "string", + "description": "The type of template to generate, e.g., 'report', 'invoice', 'letter', or 'presentation'.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section names to include in the template, such as ['Introduction','Summary','Details','Conclusion'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to include a header section with title and date placeholders.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeFooter", + "type": "boolean", + "description": "Whether to include a footer section with page numbers and copyright info.", + "required": false, + "defaultValue": "true" + }, + { + "name": "styleSettings", + "type": "object", + "description": "An object defining styling preferences, e.g., {fontFamily:'Arial', fontSize:12, colorScheme:'light'}.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A structured template object containing metadata, defined sections with placeholders, and styling information suitable for rendering or further editing." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create document templates dynamically according to user specifications, such as generating a business report layout with specific sections or styling. Ideal for automating template creation to streamline document generation workflows.", + "limitations": "This tool cannot fill templates with actual content; it only defines the structure and style. It does not support real-time collaborative editing or advanced graphic layouts.", + "examples": [ + "Generate a project status report template with sections: Introduction, Progress, Issues, Next Steps and corporate style.", + "Create an invoice template including header and footer with default styling.", + "Produce a minimal letter template without footer but with custom font and color scheme." + ] + }, + "tags": [ + "template", + "document", + "content creation", + "automation", + "dynamic", + "layout", + "style" + ], + "examples": [ + { + "inputJson": "{\"templateType\":\"report\",\"sections\":[\"Introduction\",\"Summary\",\"Details\",\"Conclusion\"],\"includeHeader\":true,\"includeFooter\":true,\"styleSettings\":{\"fontFamily\":\"Times New Roman\",\"fontSize\":12,\"colorScheme\":\"light\"}}", + "description": "Generate a professional report template with typical sections and default header/footer, styled in Times New Roman." + }, + { + "inputJson": "{\"templateType\":\"invoice\",\"sections\":[\"Billing Details\",\"Itemized Charges\",\"Total\"],\"includeHeader\":true,\"includeFooter\":true,\"styleSettings\":{\"fontFamily\":\"Arial\",\"fontSize\":10,\"colorScheme\":\"dark\"}}", + "description": "Create an invoice template with billing and charges sections and dark theme styling." + }, + { + "inputJson": "{\"templateType\":\"letter\",\"sections\":[\"Salutation\",\"Body\",\"Closing\"],\"includeHeader\":true,\"includeFooter\":false,\"styleSettings\":{\"fontFamily\":\"Calibri\",\"fontSize\":11,\"colorScheme\":\"light\"}}", + "description": "Generate a letter template with header but no footer, using Calibri font and light color scheme." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Template", + "context": null + } + }, + { + "name": "content-creation.generateBrief", + "description": "Generates a structured brief document based on provided project details, target audience, objectives, and key points. Accepts input parameters describing the scope and requirements, processes them to create a concise, clear summary brief suitable for internal or client use.", + "category": "content-creation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project or initiative for which the brief is generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "An array of strings describing the main goals or objectives of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience or users of the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of key points, features, or ideas to be included in the brief.", + "required": false, + "defaultValue": "" + }, + { + "name": "deadline", + "type": "string", + "description": "Optional deadline or timeline for project completion (ISO 8601 date or descriptive string).", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any additional information or context to include in the brief.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated brief text and a structured summary of key elements for easy integration." + }, + "aiAgent": { + "useCase": "Use this tool when a concise, structured brief document is needed to summarize project objectives, target users, and key points. It helps automate the initial documentation phase for projects across marketing, product development, or content creation by transforming raw input into a clear, usable brief.", + "limitations": "The tool cannot generate highly detailed project plans or technical specifications. It relies on the quality and completeness of input data and does not validate external factual accuracy.", + "examples": [ + "Generate a marketing campaign brief based on objectives and target audience.", + "Create a project brief for a new software feature with key points and timeline.", + "Summarize client's requirements into a clear internal brief document." + ] + }, + "tags": [ + "content-creation", + "brief", + "summary", + "documentation", + "project-planning", + "automation" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"Website Redesign\",\"objectives\":[\"Improve user engagement\",\"Increase mobile traffic\"],\"targetAudience\":\"Young professionals aged 25-35\",\"keyPoints\":[\"Responsive mobile design\",\"Faster loading times\"],\"deadline\":\"2024-09-30\",\"additionalNotes\":\"Focus on accessibility compliance.\"}", + "description": "Generating a project brief for a website redesign with specific goals, audience, and deadline." + }, + { + "inputJson": "{\"projectName\":\"Social Media Campaign Q3\",\"objectives\":[\"Boost brand awareness\",\"Increase follower count by 20%\"],\"targetAudience\":\"Millennials and Gen Z\",\"keyPoints\":[\"Influencer partnerships\",\"Regular video content\"],\"deadline\":\"2024-07-15\",\"additionalNotes\":\"Align with new product launch.\"}", + "description": "Creating a marketing brief for a social media campaign with clear objectives and strategic points." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Brief", + "context": null + } + }, + { + "name": "content-creation.generateFAQ", + "description": "Generates a formatted FAQ document based on provided information and topics. Accepts product or service details, common questions, and relevant keywords and outputs a structured FAQ text suitable for websites, manuals, or support portals.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or product the FAQ focuses on, such as a software name or service category.", + "required": true, + "defaultValue": "" + }, + { + "name": "questions", + "type": "array", + "description": "List of common questions or queries related to the topic that the FAQ should address.", + "required": true, + "defaultValue": "" + }, + { + "name": "backgroundInfo", + "type": "string", + "description": "Detailed description or background information about the product or service to inform accurate answers.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') in which the FAQ should be generated.", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxQuestions", + "type": "number", + "description": "Maximum number of questions to include in the FAQ; if fewer questions provided, uses those.", + "required": false, + "defaultValue": "10" + }, + { + "name": "includeIntro", + "type": "boolean", + "description": "Whether to generate a brief introduction paragraph before the FAQ list.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted FAQ text, including optional introduction and each question paired with its generated answer." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create or expand a Frequently Asked Questions document to assist users by providing clear answers about a product, service, or topic, especially when given domain-specific details and user questions. It's ideal for automating support content generation from knowledge bases or product documentation.", + "limitations": "Cannot verify factual accuracy beyond input data; may generate generic answers if background info is insufficient. Does not tailor answers for individual users or handle complex legal or medical advice.", + "examples": [ + "Generate FAQ for a new software product from key features and common user questions.", + "Create an FAQ for a website's return policy based on policy text to help customer support.", + "Produce a bilingual FAQ where questions and answers are provided in specified language." + ] + }, + "tags": [ + "content-creation", + "document-generation", + "FAQ", + "support", + "customer-service", + "automation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"SuperApp Pro\",\"questions\":[\"How do I install SuperApp Pro?\",\"What are the system requirements?\",\"Is there a trial version available?\"],\"backgroundInfo\":\"SuperApp Pro is a productivity application compatible with Windows and Mac. Users require 4GB RAM and 500MB disk space. A 14-day free trial is offered.\",\"language\":\"en\",\"maxQuestions\":5,\"includeIntro\":true}", + "description": "Generate an English FAQ for a productivity app based on provided features and common questions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "FAQ", + "context": null + } + }, + { + "name": "content-creation.generateChecklist", + "description": "Generates a structured checklist document based on provided topics, subtopics, and item details. Accepts input parameters to customize checklist title, sections, individual items with descriptions, and priorities. Outputs a JSON-formatted checklist suitable for task management or documentation purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the checklist document.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects, each containing a section title and an array of checklist items.", + "required": true, + "defaultValue": "" + }, + { + "name": "includePriorities", + "type": "boolean", + "description": "Flag to indicate whether priority levels should be included in checklist items.", + "required": false, + "defaultValue": "false" + }, + { + "name": "defaultPriority", + "type": "string", + "description": "Default priority level assigned to checklist items if none specified (e.g., 'Medium').", + "required": false, + "defaultValue": "Medium" + }, + { + "name": "formatAsMarkdown", + "type": "boolean", + "description": "If true, generate checklist output formatted as markdown text instead of JSON.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated checklist represented as JSON and optionally as a markdown string if requested." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to create organized, multi-section checklists for project plans, quality assurance, event planning, or instructional guides based on user-provided topics and items. It helps automate production of clear, actionable checklist documents with customizable priorities and formatting.", + "limitations": "Does not generate checklist content from unstructured text or automatically infer checklist items. It requires structured input. It cannot handle real-time task tracking or integrations with external task management apps.", + "examples": [ + "Generate a product launch checklist with sections for pre-launch, launch day, and post-launch tasks.", + "Create a QA checklist for software testing with items marked by priority and detailed descriptions.", + "Produce a markdown formatted event planning checklist including venue, catering, and invitations sections." + ] + }, + "tags": [ + "content-creation", + "checklist", + "document-generation", + "task-management", + "planning" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Website Launch Checklist\",\"sections\":[{\"sectionTitle\":\"Pre-launch Tasks\",\"items\":[{\"description\":\"Complete final design review\",\"priority\":\"High\"},{\"description\":\"Set up hosting environment\",\"priority\":\"Medium\"}]},{\"sectionTitle\":\"Launch Day Tasks\",\"items\":[{\"description\":\"Deploy website to production\",\"priority\":\"High\"},{\"description\":\"Announce launch on social media\",\"priority\":\"Medium\"}]}],\"includePriorities\":true,\"formatAsMarkdown\":false}", + "description": "Generate a checklist for a website launch with prioritized tasks formatted as JSON." + }, + { + "inputJson": "{\"title\":\"Event Planning Checklist\",\"sections\":[{\"sectionTitle\":\"Venue\",\"items\":[{\"description\":\"Book venue\",\"priority\":\"High\"},{\"description\":\"Arrange seating\",\"priority\":\"Low\"}]},{\"sectionTitle\":\"Catering\",\"items\":[{\"description\":\"Choose menu\",\"priority\":\"Medium\"},{\"description\":\"Confirm dietary restrictions\",\"priority\":\"High\"}]}],\"includePriorities\":true,\"formatAsMarkdown\":true}", + "description": "Create a markdown formatted event planning checklist including priorities." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Checklist", + "context": null + } + }, + { + "name": "content-creation.generateReleaseNotes", + "description": "Generates detailed and well-structured release notes documents from provided release metadata and change logs. Accepts inputs such as version number, release date, list of features, bug fixes, and known issues, and produces formatted release notes suitable for product documentation or publication.", + "category": "content-creation", + "parameters": [ + { + "name": "version", + "type": "string", + "description": "The version number of the release (e.g., 'v2.3.0').", + "required": true, + "defaultValue": "" + }, + { + "name": "releaseDate", + "type": "string", + "description": "The release date in ISO 8601 format (e.g., '2024-05-01').", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "An array of strings describing new features introduced in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bugFixes", + "type": "array", + "description": "An array of strings listing bug fixes included in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "knownIssues", + "type": "array", + "description": "An array of strings to note known issues that remain in this release.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Optional additional notes or comments to include in the release notes.", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the release notes document: 'markdown', 'html', or 'plaintext'.", + "required": false, + "defaultValue": "markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted release notes string in the specified format, under the key 'releaseNotes'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create professional and consistent release notes documents automatically based on structured input data about a new product or software version. This helps streamline publishing, saves time, and ensures clarity for end users or stakeholders.", + "limitations": "This tool does not generate content beyond the input provided, such as interpreting code changes or creating summaries without explicit data. It also does not localize or translate contents automatically.", + "examples": [ + "Generate release notes for a new software version including features and bug fixes.", + "Create HTML formatted release notes from a detailed change list.", + "Produce a simple plaintext release note summary for an internal patch." + ] + }, + "tags": [ + "content-creation", + "release-notes", + "documentation", + "software", + "automation" + ], + "examples": [ + { + "inputJson": "{\"version\":\"v3.1.0\",\"releaseDate\":\"2024-05-15\",\"features\":[\"Added user authentication support\",\"Improved performance of data queries\"],\"bugFixes\":[\"Fixed crash on startup\",\"Resolved memory leak issue\"],\"knownIssues\":[\"Minor UI glitch on settings page\"],\"format\":\"markdown\"}", + "description": "Generate markdown release notes for version v3.1.0 with features, fixes, and known issues." + }, + { + "inputJson": "{\"version\":\"1.0.0\",\"releaseDate\":\"2024-01-01\",\"features\":[\"Initial release with core functionalities\"],\"format\":\"plaintext\"}", + "description": "Generate a plaintext release note for the initial release of a product." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "ReleaseNotes", + "context": null + } + }, + { + "name": "content-creation.generateTranscript", + "description": "Generates a textual transcript from an uploaded audio or video file, using speech-to-text processing. Accepts media file input and optional parameters for language and speaker diarization. Outputs a structured transcript with timestamps and speaker labels if enabled.", + "category": "content-creation", + "parameters": [ + { + "name": "mediaUrl", + "type": "string", + "description": "URL or path to the audio/video file to transcribe", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the spoken language in the media (e.g., 'en-US')", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "enableSpeakerDiarization", + "type": "boolean", + "description": "Whether to separate transcript by speaker voices", + "required": false, + "defaultValue": "false" + }, + { + "name": "timestampInterval", + "type": "number", + "description": "Interval in seconds to insert timestamps in the transcript", + "required": false, + "defaultValue": "30" + }, + { + "name": "format", + "type": "string", + "description": "Output format of the transcript, e.g., 'text' or 'json' with metadata", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full transcript text, optionally segmented by timestamps and speakers, plus metadata if requested" + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert audio or video content into readable, searchable text. It is useful for meeting notes, content indexing, accessibility, and content repurposing. It supports multiple languages and can optionally separate speakers and add timestamps for clarity.", + "limitations": "This tool cannot generate transcripts without clear audio input or from files without speech (e.g., music only). It may have lower accuracy in noisy environments or with overlapping speech. It does not perform translations or summarize content.", + "examples": [ + "Generate a transcript from an English podcast episode URL.", + "Create a diarized transcript with speaker labels for a recorded webinar.", + "Produce a JSON-formatted transcript with timestamps every 10 seconds from a video file URL." + ] + }, + "tags": [ + "transcription", + "speech-to-text", + "audio-processing", + "video-processing", + "content-creation", + "accessibility" + ], + "examples": [ + { + "inputJson": "{\"mediaUrl\":\"https://example.com/meeting-recording.mp4\",\"language\":\"en-US\",\"enableSpeakerDiarization\":true,\"timestampInterval\":60,\"format\":\"json\"}", + "description": "Generate a JSON transcript with speaker labels and timestamps every 60 seconds from an English meeting video." + }, + { + "inputJson": "{\"mediaUrl\":\"https://example.com/podcast-episode.mp3\",\"language\":\"en-US\",\"enableSpeakerDiarization\":false,\"format\":\"text\"}", + "description": "Generate plain text transcript from an English podcast audio without speaker separation." + }, + { + "inputJson": "{\"mediaUrl\":\"https://example.com/webinar.mkv\",\"language\":\"es-ES\",\"enableSpeakerDiarization\":true,\"timestampInterval\":30,\"format\":\"json\"}", + "description": "Generate a diarized Spanish transcript with timestamps every 30 seconds from a webinar video." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Transcript", + "context": null + } + }, + { + "name": "content-creation.generateChangelog", + "description": "Generates a structured changelog document by parsing commit messages or a list of versioned changes. Accepts inputs such as raw commit logs or an array of change entries, processes to group changes by categories (e.g., Added, Fixed, Changed), and outputs a formatted markdown or plain text changelog suitable for release notes.", + "category": "content-creation", + "parameters": [ + { + "name": "commitMessages", + "type": "array", + "description": "An array of commit message strings to extract changes from. Each message should be a conventional commit or descriptive note.", + "required": false, + "defaultValue": "" + }, + { + "name": "changeEntries", + "type": "array", + "description": "An array of structured change objects with fields like type (Added, Fixed), description, and optional scope. Used if commitMessages not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "The version string for the release, e.g., '1.2.3'. This is included in the changelog heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Release date in ISO 8601 format (YYYY-MM-DD). Included in the changelog heading.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The format for the output changelog: 'markdown' or 'text'. Defaults to markdown.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeUncategorized", + "type": "boolean", + "description": "Whether to include changes that do not fit into standard categories under an 'Uncategorized' section.", + "required": false, + "defaultValue": "true" + }, + { + "name": "categoriesOrder", + "type": "array", + "description": "Defines the order and names of categories in the changelog. Defaults to ['Added','Changed','Deprecated','Removed','Fixed','Security'].", + "required": false, + "defaultValue": "[\"Added\",\"Changed\",\"Deprecated\",\"Removed\",\"Fixed\",\"Security\"]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the changelog string under the 'changelog' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate a standardized changelog document from commit logs or a list of changes for software releases or project updates. It helps in formatting and grouping changes by type, preparing release notes efficiently.", + "limitations": "The tool relies on structured commit messages or well-formed change entries. It cannot infer changes without descriptive inputs and does not automatically fetch commits from repositories.", + "examples": [ + "Generate a markdown changelog from recent conventional commits for version 2.0.0.", + "Create a plain text changelog from an array of change entries without a date.", + "Produce a changelog including uncategorized changes and specifying a custom category order." + ] + }, + "tags": [ + "content-creation", + "changelog", + "release-notes", + "documentation", + "automation", + "project-management" + ], + "examples": [ + { + "inputJson": "{\"commitMessages\":[\"feat: add user login feature\",\"fix: correct typo in README\",\"docs: update API documentation\"],\"version\":\"1.4.0\",\"date\":\"2024-05-15\",\"outputFormat\":\"markdown\"}", + "description": "Generate a markdown changelog for version 1.4.0 using commit messages including feature, fix, and docs updates." + }, + { + "inputJson": "{\"changeEntries\":[{\"type\":\"Added\",\"description\":\"Support for multi-factor authentication\"},{\"type\":\"Fixed\",\"description\":\"Crash on startup on Windows devices\"},{\"type\":\"Changed\",\"description\":\"Updated database schema\"}],\"version\":\"2.0.0\",\"outputFormat\":\"text\",\"includeUncategorized\":false}", + "description": "Create a plain text changelog for version 2.0.0 from explicit change entries, excluding uncategorized changes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Changelog", + "context": null + } + }, + { + "name": "content-creation.generateMinutes", + "description": "Generates detailed meeting minutes from meeting transcripts or notes by extracting key points, decisions, action items, attendees, and summaries. Accepts plain text or structured input and outputs a formatted summary document suitable for distribution.", + "category": "content-creation", + "parameters": [ + { + "name": "meetingTranscript", + "type": "string", + "description": "Raw text transcript or detailed notes of the meeting to process for minutes generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "meetingDate", + "type": "string", + "description": "Date of the meeting in ISO 8601 format (YYYY-MM-DD) to include in the minutes header.", + "required": false, + "defaultValue": "" + }, + { + "name": "attendees", + "type": "array", + "description": "List of attendees' names who participated in the meeting.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeActionItems", + "type": "boolean", + "description": "Whether to extract and highlight action items from the meeting content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language of the meeting content for accurate processing (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated minutes output, e.g., 'text', 'markdown', or 'json'.", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted meeting minutes with structured sections such as summary, decisions, action items, attendees, and date." + }, + "aiAgent": { + "useCase": "Use this tool when you have a meeting transcript or detailed notes and need to quickly generate clear, organized meeting minutes for sharing or archiving without manual summarization. It helps teams maintain records of decisions, tasks, and attendance efficiently.", + "limitations": "Cannot replace the accuracy of official meeting transcription; quality depends on the input transcript clarity. May miss nuances or implicit decisions not clearly stated in the input.", + "examples": [ + "Generate meeting minutes from a text transcript capturing all key discussion points and action items.", + "Create a markdown formatted summary of meeting notes including the date and a list of attendees.", + "Extract and highlight action items from a raw meeting note document in JSON output format." + ] + }, + "tags": [ + "content-creation", + "meeting", + "minutes", + "document-generation", + "summarization", + "productivity" + ], + "examples": [ + { + "inputJson": "{\"meetingTranscript\":\"Project kickoff meeting started with introductions. Decision to adopt Agile methodology was made. John will lead the development team.\",\"meetingDate\":\"2024-04-15\",\"attendees\":[\"Alice\",\"Bob\",\"John\"],\"includeActionItems\":true,\"language\":\"en\",\"outputFormat\":\"text\"}", + "description": "Generate text format meeting minutes from a short project kickoff meeting transcript including attendees and date." + }, + { + "inputJson": "{\"meetingTranscript\":\"Discussed quarterly budget review and allocation. Decided to increase marketing budget by 10%. Action item assigned to Sarah to prepare new budget proposal.\",\"attendees\":[\"Mike\",\"Sarah\"],\"includeActionItems\":true,\"outputFormat\":\"markdown\"}", + "description": "Create markdown formatted minutes summarizing budget decisions and action items with attendee names." + }, + { + "inputJson": "{\"meetingTranscript\":\"Review of last sprint goals. All goals met except for backend API updates. Action item: Dev team to prioritize API completion next sprint.\",\"includeActionItems\":true,\"outputFormat\":\"json\"}", + "description": "Produce json structured meeting minutes including identified action items from sprint review notes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Minutes", + "context": null + } + }, + { + "name": "content-creation.generateSummary", + "description": "Generates a concise, coherent summary from a provided text document or content. Accepts raw text input and optional parameters to control summary length and style. Outputs a summarized text capturing the key points, suitable for quick understanding or previews.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The full text content to be summarized. Required for summary generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the summary in number of words. Optional; defaults to 100.", + "required": false, + "defaultValue": "100" + }, + { + "name": "summaryStyle", + "type": "string", + "description": "Style of the summary; can be 'concise', 'detailed', or 'bulleted'. Defaults to 'concise'.", + "required": false, + "defaultValue": "concise" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text for accurate summarization. Defaults to 'en' for English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summary text, its word count, and the original language code." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a brief, readable synopsis of long texts like articles, reports, or documents to enable quick comprehension or preview. It is useful for content summarization in content management, news aggregation, or research.", + "limitations": "Cannot replace specialized domain expert summaries. Quality depends on input text clarity and language support. May not capture nuanced or highly technical details accurately.", + "examples": [ + "Summarize a research article into a concise paragraph.", + "Generate a bulleted summary of a product review.", + "Create a brief summary from a lengthy news report." + ] + }, + "tags": [ + "content", + "summarization", + "text", + "document", + "summary", + "content-creation", + "generate" + ], + "examples": [ + { + "inputJson": "{\"text\":\"The quick brown fox jumps over the lazy dog. This sentence is often used as a pangram in the English language to test fonts and keyboards.\",\"maxLength\":20,\"summaryStyle\":\"concise\"}", + "description": "Summarize a well-known pangram sentence with a concise summary limited to 20 words." + }, + { + "inputJson": "{\"text\":\"In 2023, renewable energy sources saw unprecedented growth due to technological advances and policy changes worldwide.\",\"maxLength\":30,\"summaryStyle\":\"bulleted\"}", + "description": "Create a bulleted summary highlighting the main points about renewable energy growth in 2023." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "content-creation.generateArticle", + "description": "Generates a coherent, structured article based on a given topic, intended audience, and desired length. Accepts inputs detailing topic, style, keywords, and language, then produces a formatted article text with an optional title and summary.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or theme for the article to cover.", + "required": true, + "defaultValue": "" + }, + { + "name": "audience", + "type": "string", + "description": "Target audience profile or demographic for tailoring content tone and complexity.", + "required": false, + "defaultValue": "general" + }, + { + "name": "articleLength", + "type": "number", + "description": "Approximate desired length of the article in words.", + "required": false, + "defaultValue": "500" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the article output, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "style", + "type": "string", + "description": "Writing style or tone, such as formal, casual, technical, or persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keywords", + "type": "array", + "description": "List of important keywords or phrases that should be included in the article.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a brief summary paragraph at the start of the article.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete article text, including title, body, and optional summary." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a full-length article on a specified topic for presentations, blogs, newsletters, or reports, customized by audience, length, and style. It helps quickly generate structured, coherent content ready for editing or publication.", + "limitations": "The tool may produce generic or overly formal content and might not replace expert-authored articles requiring deep domain knowledge or citations. It does not perform fact-checking or source attribution.", + "examples": [ + "Generate a 1000-word article on climate change targeted to high school students in a casual style including keywords 'global warming', 'carbon emissions'.", + "Produce a technical article about machine learning in English, approx. 1500 words, formal tone, with a summary.", + "Create a brief persuasive article about the benefits of remote work for a general audience, around 700 words." + ] + }, + "tags": [ + "content creation", + "article writing", + "text generation", + "writing assistant", + "blog content", + "AI writing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of Urban Gardening\",\"audience\":\"home gardeners\",\"articleLength\":800,\"language\":\"en\",\"style\":\"casual\",\"keywords\":[\"sustainability\",\"health benefits\"],\"includeSummary\":true}", + "description": "Generate an 800-word casual article on urban gardening emphasizing sustainability and health benefits for home gardeners, including a summary." + }, + { + "inputJson": "{\"topic\":\"Advancements in Renewable Energy Technologies\",\"articleLength\":1200,\"style\":\"technical\",\"includeSummary\":false}", + "description": "Generate a 1200-word technical article about recent advancements in renewable energy technologies without a summary." + }, + { + "inputJson": "{\"topic\":\"Tips for Effective Remote Team Communication\",\"audience\":\"business professionals\",\"articleLength\":600,\"style\":\"formal\",\"includeSummary\":true}", + "description": "Generate a formal 600-word article with a summary on best practices for remote team communication aimed at business professionals." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Article", + "context": null + } + }, + { + "name": "content-creation.generateBlogPost", + "description": "Generates a detailed blog post based on a given topic, target audience, and style preferences. Accepts inputs including topic keywords, desired length, writing tone, and additional sections. Processes this data to create a structured, coherent blog post draft suitable for digital publishing.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or theme for the blog post to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended readers or demographic for tailoring language and style.", + "required": false, + "defaultValue": "" + }, + { + "name": "postLength", + "type": "number", + "description": "Approximate length of the blog post in words.", + "required": false, + "defaultValue": "800" + }, + { + "name": "tone", + "type": "string", + "description": "Writing style or tone such as formal, casual, or conversational.", + "required": false, + "defaultValue": "conversational" + }, + { + "name": "includeSections", + "type": "array", + "description": "Optional list of specific sections to include such as introduction, FAQ, conclusion.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases to emphasize for SEO purposes.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated blog post content including title, formatted body text divided by sections, and a summary." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly draft comprehensive blog posts tailored by topic, audience, tone, or length, especially for content marketing, SEO, or thought leadership. It supports generating content frameworks efficiently by providing structured text areas.", + "limitations": "Cannot replace expert domain-specific knowledge or fact-checking; generated posts may require review and editing for accuracy and style conformity.", + "examples": [ + "Generate a 1000-word blog post about benefits of remote work for tech professionals in a formal tone.", + "Create a casual, 600-word blog entry introducing beginner yoga poses, including an FAQ section.", + "Write a conversational blog post on healthy meal prep tips targeting college students." + ] + }, + "tags": [ + "content-creation", + "generation", + "blog", + "writing", + "SEO", + "marketing", + "digital-content" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"sustainable travel\",\"targetAudience\":\"eco-conscious travelers\",\"postLength\":900,\"tone\":\"informative\",\"includeSections\":[\"introduction\",\"tips\",\"conclusion\"],\"keywords\":[\"eco-friendly travel\",\"carbon footprint\",\"green hotels\"]}", + "description": "Generate a 900-word informative blog post on sustainable travel for eco-conscious travelers including introduction, tips, and conclusion sections focusing on eco-friendly travel keywords." + }, + { + "inputJson": "{\"topic\":\"home workout routines\",\"postLength\":700,\"tone\":\"casual\",\"keywords\":[\"no equipment\",\"quick workouts\"]}", + "description": "Create a 700-word casual blog post about home workout routines emphasizing quick workouts requiring no equipment." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "BlogPost", + "context": null + } + }, + { + "name": "content-creation.generateDocument", + "description": "Generates a structured digital document based on provided content, style preferences, and formatting options. Accepts text inputs such as title, sections, and optional images or tables, then produces a formatted document output in specified file formats such as PDF, DOCX, or HTML.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the document to be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects containing headings and content paragraphs for the document body.", + "required": true, + "defaultValue": "" + }, + { + "name": "style", + "type": "string", + "description": "Optional design style for the document (e.g., formal, modern, minimalist).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to include a table of contents based on section headings.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The file format for the generated document output (pdf, docx, html).", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "authorName", + "type": "string", + "description": "Optional author name to include in the document metadata or header/footer.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated document as a base64 encoded string along with metadata such as file name and format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a well-structured document for reports, proposals, summaries, or presentations based on given textual content and formatting preferences. Ideal for automating document creation workflows and producing outputs in common file formats.", + "limitations": "Does not support complex media embedding such as videos or interactive content. Cannot perform extensive graphic design or layout customization beyond provided styles.", + "examples": [ + "Create a business report document with sections and export as PDF.", + "Generate a project proposal in DOCX with a professional style and table of contents.", + "Produce an HTML formatted document for web publishing based on provided article text." + ] + }, + "tags": [ + "content-creation", + "document", + "generate", + "pdf", + "docx", + "report", + "automation", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Annual Sales Report\",\"sections\":[{\"heading\":\"Executive Summary\",\"content\":\"This year sales increased by 20%.\"},{\"heading\":\"Detailed Analysis\",\"content\":\"Our top performing region was...\"}],\"style\":\"formal\",\"includeTableOfContents\":true,\"outputFormat\":\"pdf\",\"authorName\":\"Jane Doe\"}", + "description": "Generate a formal PDF sales report with title, multiple sections, table of contents, and author name." + }, + { + "inputJson": "{\"title\":\"Project Proposal\",\"sections\":[{\"heading\":\"Introduction\",\"content\":\"The project aims to...\"},{\"heading\":\"Budget\",\"content\":\"Estimated cost is...\"}],\"style\":\"modern\",\"includeTableOfContents\":false,\"outputFormat\":\"docx\"}", + "description": "Create a modern style project proposal document as a DOCX file without a table of contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "content-creation.createReference", + "description": "Creates a formatted bibliographic reference entry from structured input data. Accepts source details such as author names, title, publication date, and source type, then returns a properly formatted reference string in a selected citation style (e.g., APA, MLA, Chicago).", + "category": "content-creation", + "parameters": [ + { + "name": "sourceType", + "type": "string", + "description": "Type of source to reference, such as book, journal, website, or report.", + "required": true, + "defaultValue": "" + }, + { + "name": "authors", + "type": "array", + "description": "List of author objects, each with 'firstName' and 'lastName' strings.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the source or document.", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationDate", + "type": "string", + "description": "Publication date in ISO format (YYYY-MM-DD) or year only.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or publishing organization.", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of the source if it is an online reference.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format the reference (e.g. APA, MLA, Chicago).", + "required": true, + "defaultValue": "APA" + }, + { + "name": "edition", + "type": "string", + "description": "Edition information if applicable (e.g. 2nd edition).", + "required": false, + "defaultValue": "" + }, + { + "name": "volume", + "type": "string", + "description": "Volume number if applicable for journals or multi-volume works.", + "required": false, + "defaultValue": "" + }, + { + "name": "issue", + "type": "string", + "description": "Issue number if applicable for journals.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted reference string under 'formattedReference' key." + }, + "aiAgent": { + "useCase": "Use this tool when generating bibliographic references for academic papers, articles, reports, or digital content requiring standardized source citations. It automates the creation of properly styled references from detailed source metadata to ensure formatting accuracy and save time.", + "limitations": "This tool does not fetch or validate source metadata automatically; all input details must be provided accurately. It supports common citation styles but may not cover all niche or updated style variants.", + "examples": [ + "Create an APA format reference for a book with authors, title, publication year, and publisher.", + "Generate an MLA citation for a journal article including volume and issue numbers.", + "Produce a Chicago style citation for an online report with URL and publication date." + ] + }, + "tags": [ + "content creation", + "reference", + "citation", + "bibliography", + "academic", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"sourceType\":\"book\",\"authors\":[{\"firstName\":\"John\",\"lastName\":\"Doe\"},{\"firstName\":\"Jane\",\"lastName\":\"Smith\"}],\"title\":\"Introduction to Testing\",\"publicationDate\":\"2018-05-01\",\"publisher\":\"Tech Press\",\"citationStyle\":\"APA\",\"edition\":\"2nd edition\"}", + "description": "Create an APA style reference for a book with two authors, publisher, and edition." + }, + { + "inputJson": "{\"sourceType\":\"journal\",\"authors\":[{\"firstName\":\"Alice\",\"lastName\":\"Brown\"}],\"title\":\"Advances in AI Research\",\"publicationDate\":\"2023\",\"publisher\":\"Science Journal\",\"citationStyle\":\"MLA\",\"volume\":\"34\",\"issue\":\"2\"}", + "description": "Generate an MLA citation for a journal article with volume and issue numbers." + }, + { + "inputJson": "{\"sourceType\":\"website\",\"authors\":[{\"firstName\":\"Mark\",\"lastName\":\"Lee\"}],\"title\":\"Understanding Web Security\",\"publicationDate\":\"2022-11-15\",\"url\":\"https://www.websec.com/article\",\"citationStyle\":\"Chicago\"}", + "description": "Produce a Chicago style citation for an online article with URL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reference", + "context": null + } + }, + { + "name": "content-creation.generateReport", + "description": "Generates a structured written report based on user-provided data, topic, and formatting preferences. The tool accepts input content (text, data summary, or analytics), report type, and optional sections to include. It processes these inputs to produce a coherent report document in text or markdown format, suitable for business, technical, or summary purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the report to generate.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentData", + "type": "string", + "description": "Raw textual content, data summary, or analytics to incorporate into the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportType", + "type": "string", + "description": "The style or category of the report, such as business, technical, summary, or progress.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "includeSections", + "type": "array", + "description": "List of specific sections to include in the report, e.g., ['Introduction', 'Analysis', 'Conclusion'].", + "required": false, + "defaultValue": "[]" + }, + { + "name": "format", + "type": "string", + "description": "The output format for the report, such as 'text' or 'markdown'.", + "required": false, + "defaultValue": "text" + }, + { + "name": "language", + "type": "string", + "description": "The language code for the report content, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "pageLength", + "type": "number", + "description": "Approximate desired length of the report in pages or sections.", + "required": false, + "defaultValue": "3" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report text and metadata including topic and format." + }, + "aiAgent": { + "useCase": "Use this tool when a concise, structured report is needed from provided data or content inputs, such as for generating business progress reports, technical reviews, or executive summaries automatically extracted from raw inputs. It aids in converting unstructured or semi-structured information into readable documents.", + "limitations": "This tool does not perform deep domain-specific analysis or data validation. It cannot replace expert-written reports needing complex domain knowledge or highly customized formatting beyond the basic templates.", + "examples": [ + "Generate a business report summarizing quarterly sales data.", + "Create a technical report analyzing system performance logs.", + "Produce a concise project summary report with key milestones and risks." + ] + }, + "tags": [ + "content", + "report", + "generation", + "summary", + "business", + "technical", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Quarterly Sales Analysis\",\"contentData\":\"Sales increased by 15% compared to last quarter with significant growth in the EMEA region.\",\"reportType\":\"business\",\"includeSections\":[\"Introduction\",\"Data Analysis\",\"Conclusion\"],\"format\":\"markdown\",\"language\":\"en\",\"pageLength\":4}", + "description": "Generate a markdown formatted business report on quarterly sales with specified sections." + }, + { + "inputJson": "{\"topic\":\"Server Performance Review\",\"contentData\":\"CPU usage spiked during peak hours causing latency issues. Memory usage remained stable.\",\"reportType\":\"technical\",\"format\":\"text\",\"language\":\"en\"}", + "description": "Create a plain text technical report focusing on server performance with provided observations." + }, + { + "inputJson": "{\"topic\":\"Project Summary\",\"contentData\":\"All milestones met on time; budget usage at 95%. Minor risks associated with resource allocation.\",\"reportType\":\"summary\",\"pageLength\":2}", + "description": "Produce a brief project summary report with key achievements and risks." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "generate", + "object": "Report", + "context": null + } + }, + { + "name": "content-creation.createCitation", + "description": "Generates a properly formatted citation string based on provided bibliographic information and the specified citation style. Accepts details like author(s), title, publication year, publisher, and outputs the citation according to styles such as APA, MLA, or Chicago.", + "category": "content-creation", + "parameters": [ + { + "name": "authors", + "type": "array", + "description": "List of author names in 'LastName, FirstName' format for the citation.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the work to be cited (e.g., book title, article title).", + "required": true, + "defaultValue": "" + }, + { + "name": "publicationYear", + "type": "number", + "description": "Year when the work was published.", + "required": true, + "defaultValue": "" + }, + { + "name": "publisher", + "type": "string", + "description": "Name of the publisher or journal name where the work was published.", + "required": false, + "defaultValue": "" + }, + { + "name": "citationStyle", + "type": "string", + "description": "Citation style to format the citation in (e.g., 'APA', 'MLA', 'Chicago').", + "required": true, + "defaultValue": "APA" + }, + { + "name": "edition", + "type": "string", + "description": "Edition information of the work if applicable (e.g., '2nd edition').", + "required": false, + "defaultValue": "" + }, + { + "name": "url", + "type": "string", + "description": "URL of online sources, if applicable, included in the citation.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessDate", + "type": "string", + "description": "Date when an online source was accessed, in YYYY-MM-DD format, if applicable.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted citation string and the style used." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate accurately formatted citations from bibliographic data for academic papers, articles, or digital content in various citation styles. It helps automate citation creation to ensure correctness and saves time compared to manual formatting.", + "limitations": "This tool cannot verify the factual accuracy of the bibliographic data provided or fetch missing metadata automatically. It also does not support highly specialized or less common citation styles beyond core popular ones.", + "examples": [ + "Generate an APA style citation for a book with authors, title, year, and publisher.", + "Create an MLA format citation for an online article including URL and access date.", + "Produce a Chicago style citation with multiple authors and edition info." + ] + }, + "tags": [ + "citation", + "content-creation", + "academic-writing", + "bibliography", + "reference", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"authors\":[\"Smith, John\",\"Doe, Jane\"],\"title\":\"Understanding AI\",\"publicationYear\":2021,\"publisher\":\"Tech Publishers\",\"citationStyle\":\"APA\"}", + "description": "Generate an APA citation for a book with two authors, title, year, and publisher." + }, + { + "inputJson": "{\"authors\":[\"Brown, Lisa\"],\"title\":\"Advances in Machine Learning\",\"publicationYear\":2020,\"url\":\"https://example.com/article\",\"accessDate\":\"2023-04-12\",\"citationStyle\":\"MLA\"}", + "description": "Generate an MLA citation for an online article with one author, URL, and access date." + }, + { + "inputJson": "{\"authors\":[\"Green, Michael\",\"Taylor, Anne\"],\"title\":\"Data Science Handbook\",\"publicationYear\":2019,\"publisher\":\"Data Press\",\"edition\":\"3rd edition\",\"citationStyle\":\"Chicago\"}", + "description": "Generate a Chicago style citation for a third edition book with two authors." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Citation", + "context": null + } + }, + { + "name": "content-creation.createLink", + "description": "Generates a formatted hyperlink based on input parameters including URL, display text, and optional attributes such as title, target, and CSS classes. It validates the URL and outputs a properly constructed HTML anchor tag string for embedding in digital content.", + "category": "content-creation", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL for the link. Must be a valid URL starting with http:// or https://", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "The text to display for the hyperlink. If empty, the URL itself will be used as the display text.", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional tooltip text that appears on hover over the link.", + "required": false, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "Whether the link should open in a new browser tab or window. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "cssClasses", + "type": "array", + "description": "An array of CSS class names to apply to the anchor tag for styling purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "rel", + "type": "string", + "description": "Optional value for the 'rel' attribute specifying the relationship between current page and the linked URL (e.g., 'nofollow', 'noopener').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full HTML anchor tag string as 'htmlString' representing the link ready for content embedding." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create standardized, well-formed HTML links programmatically from raw input parameters such as URL and link text, ensuring attributes like target and CSS classes are consistently applied for web content creation or editing.", + "limitations": "This tool does not verify the availability or safety of the URL beyond basic format checking, nor does it generate URLs or fetch metadata from the link target.", + "examples": [ + "Create a link to https://example.com with the display text 'Example Website' opening in a new tab and styled with classes 'btn' and 'primary'.", + "Generate a simple link for the URL https://openai.com with no display text to default to showing the URL itself.", + "Build a link with title tooltip 'Go to Documentation', opening in the current tab, and rel attribute 'noopener' to ensure security." + ] + }, + "tags": [ + "content creation", + "HTML", + "link generation", + "web", + "hyperlink", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"displayText\":\"Example Website\",\"openInNewTab\":true,\"cssClasses\":[\"btn\",\"primary\"]}", + "description": "Creates a link to example.com with custom display text, that opens in a new tab and includes button styling classes." + }, + { + "inputJson": "{\"url\":\"https://openai.com\",\"displayText\":\"\"}", + "description": "Generates a simple link using the URL itself as the display text, with default behavior opening in the same tab." + }, + { + "inputJson": "{\"url\":\"https://docs.example.org\",\"displayText\":\"Documentation\",\"title\":\"Go to Documentation\",\"openInNewTab\":false,\"rel\":\"noopener\"}", + "description": "Creates a link to documentation with a title attribute, that opens in the same tab with a security-related rel attribute." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Link", + "context": null + } + }, + { + "name": "content-creation.createQuote", + "description": "Generates a formatted inspirational or thematic quote based on provided text or keywords. Accepts input as a custom quote or keywords and outputs a styled quote object with text, author, and theme metadata.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The exact quote text to create. If empty, keywords will be used to generate a relevant quote.", + "required": false, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the person who said the quote. Defaults to 'Unknown' if not provided.", + "required": false, + "defaultValue": "\"Unknown\"" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords to generate a quote about if 'text' is empty. Ignored if 'text' is provided.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "theme", + "type": "string", + "description": "Theme or category of the quote such as 'motivation', 'love', or 'wisdom' for styling and context.", + "required": false, + "defaultValue": "" + }, + { + "name": "citation", + "type": "string", + "description": "Optional citation or source info for the quote (e.g., book title or speech).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted quote text, author, theme, and optional citation metadata." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate or format quotes for content such as articles, social media posts, presentations, or creative projects. It assists in creating customized or generated quotes with metadata, suitable for inspirational or thematic contexts.", + "limitations": "The tool cannot verify the authenticity of quotes or provide real-time citations. Generated quotes based on keywords are approximations and not guaranteed to be original or accurate.", + "examples": [ + "Create an inspirational quote about perseverance by specifying keywords ['perseverance', 'strength'].", + "Format a provided quote text with author and theme metadata.", + "Generate a quote with a custom citation from a famous speech." + ] + }, + "tags": [ + "content creation", + "quote", + "inspirational", + "text generation", + "formatting", + "creative writing" + ], + "examples": [ + { + "inputJson": "{\"text\":\"The only limit to our realization of tomorrow is our doubts of today.\",\"author\":\"Franklin D. Roosevelt\",\"theme\":\"motivation\"}", + "description": "Format a known motivational quote with author and theme." + }, + { + "inputJson": "{\"keywords\":[\"courage\",\"challenge\"],\"theme\":\"strength\"}", + "description": "Generate a custom quote about courage and challenge with a strength theme." + }, + { + "inputJson": "{\"text\":\"To be, or not to be, that is the question.\",\"author\":\"William Shakespeare\",\"citation\":\"Hamlet, Act 3, Scene 1\",\"theme\":\"philosophy\"}", + "description": "Format a classic philosophical quote with citation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Quote", + "context": null + } + }, + { + "name": "content-creation.createHeading", + "description": "Generates a formatted heading string based on the provided text, heading level, and optional style attributes. It accepts plain text input and outputs a heading formatted for HTML or markdown, supporting customization of heading level (1-6), text alignment, and additional CSS classes or markdown syntax.", + "category": "content-creation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text content to be used as the heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "Heading level from 1 to 6, indicating the importance and size of the heading.", + "required": true, + "defaultValue": "1" + }, + { + "name": "format", + "type": "string", + "description": "Output format for the heading, e.g., 'html' or 'markdown'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "textAlign", + "type": "string", + "description": "Optional text alignment: 'left', 'center', or 'right'. Applies CSS styles in HTML or alignment hints in markdown.", + "required": false, + "defaultValue": "left" + }, + { + "name": "cssClasses", + "type": "array", + "description": "Optional array of CSS class names to add to the heading element (only applicable in HTML format).", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted heading string as 'headingString'." + }, + "aiAgent": { + "useCase": "Use this tool when generating structured content documents, web pages, or markdown files where headings with specific levels and styles are required to organize content clearly and semantically. It helps format headings consistently across content types, supporting output customization.", + "limitations": "This tool only produces formatted heading strings and does not create full documents or validate surrounding content context. It does not support complex styling beyond text alignment and CSS classes in HTML or basic formatting in markdown.", + "examples": [ + "Create a level 2 HTML heading titled 'Introduction' centered with a CSS class 'main-heading'.", + "Generate a markdown level 3 heading reading 'Features' with left alignment.", + "Produce a plain level 1 heading 'Welcome' in HTML with default left alignment and no extra classes." + ] + }, + "tags": [ + "content", + "heading", + "formatting", + "html", + "markdown", + "text", + "web" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Introduction\",\"level\":2,\"format\":\"html\",\"textAlign\":\"center\",\"cssClasses\":[\"main-heading\"]}", + "description": "Create a centered level 2 HTML heading with class 'main-heading'." + }, + { + "inputJson": "{\"text\":\"Features\",\"level\":3,\"format\":\"markdown\",\"textAlign\":\"left\"}", + "description": "Generate a left aligned level 3 heading in markdown format." + }, + { + "inputJson": "{\"text\":\"Welcome\",\"level\":1}", + "description": "Produce a level 1 HTML heading with default alignment and no CSS classes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Heading", + "context": null + } + }, + { + "name": "content-creation.createConversion", + "description": "Generates a conversion analytics report by processing raw event or user interaction data. Accepts input datasets including visitor actions, timestamps, and outcomes, calculates conversion rates for specified goals or funnels, and outputs a detailed summary with key metrics and visualizations in JSON format.", + "category": "content-creation", + "parameters": [ + { + "name": "inputData", + "type": "array", + "description": "Array of event objects representing user interactions and outcomes, each with timestamp and event type.", + "required": true, + "defaultValue": "" + }, + { + "name": "conversionGoal", + "type": "string", + "description": "The specific goal or event name that defines a conversion (e.g., 'purchase', 'signup').", + "required": true, + "defaultValue": "" + }, + { + "name": "timeframeStart", + "type": "string", + "description": "ISO 8601 formatted start datetime for filtering events to analyze.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeframeEnd", + "type": "string", + "description": "ISO 8601 formatted end datetime for filtering events to analyze.", + "required": false, + "defaultValue": "" + }, + { + "name": "funnelSteps", + "type": "array", + "description": "Ordered list of event names that define the conversion funnel steps, to calculate drop-off rates if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeVisualizations", + "type": "boolean", + "description": "Whether to include basic data visualizations (e.g., conversion rate over time) in output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "minEventsThreshold", + "type": "number", + "description": "Minimum number of events required to generate reliable metrics; below this, warnings are included.", + "required": false, + "defaultValue": "10" + } + ], + "returns": { + "type": "object", + "description": "An object containing conversion metrics including total visitors, conversions count, conversion rate, funnel step drop-offs, and optional visualizations as base64 encoded images or data URLs." + }, + "aiAgent": { + "useCase": "Use this tool when needing to compute and report conversion metrics and funnel analytics from raw event data in marketing, sales, or user engagement scenarios. It is suitable for generating summaries that inform campaign effectiveness and optimize user journeys.", + "limitations": "This tool does not perform real-time data streaming analysis, advanced predictive modeling, or detailed user segmentation beyond funnel steps. It assumes input data is already cleaned and formatted appropriately.", + "examples": [ + "Calculate the conversion rate for 'purchase' events between two dates.", + "Analyze funnel drop-off rates for a multi-step signup process.", + "Generate a conversion report including visual graphs from website clickstream data." + ] + }, + "tags": [ + "conversion", + "analytics", + "content-creation", + "reporting", + "marketing", + "funnel", + "metrics" + ], + "examples": [ + { + "inputJson": "{\"inputData\":[{\"userId\":\"u1\",\"event\":\"pageView\",\"timestamp\":\"2024-06-01T10:00:00Z\"},{\"userId\":\"u1\",\"event\":\"signup\",\"timestamp\":\"2024-06-01T10:05:00Z\"},{\"userId\":\"u2\",\"event\":\"pageView\",\"timestamp\":\"2024-06-01T11:00:00Z\"}],\"conversionGoal\":\"signup\",\"timeframeStart\":\"2024-06-01T00:00:00Z\",\"timeframeEnd\":\"2024-06-02T00:00:00Z\",\"includeVisualizations\":true}", + "description": "Calculate sign-up conversion rate between June 1 and June 2 with visualizations." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Conversion", + "context": null + } + }, + { + "name": "content-creation.createText", + "description": "Generates customized textual content based on user-provided prompts and content parameters. Accepts inputs like topic, style, length, and tone, then produces coherent and contextually appropriate text output suitable for articles, posts, or other written materials.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme for the generated text.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the text in words.", + "required": false, + "defaultValue": "300" + }, + { + "name": "tone", + "type": "string", + "description": "The style or mood of the text, such as formal, casual, or persuasive.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "format", + "type": "string", + "description": "The output format for the text, e.g. plain, markdown, or html.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "keywords", + "type": "array", + "description": "A list of key terms or phrases to be included in the text.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text content as a string and metadata about the generation." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create coherent, contextually relevant written content from scratch based on a topic and style parameters. Ideal for generating articles, blog posts, summaries, or other textual content automatically.", + "limitations": "Cannot guarantee factual accuracy or up-to-date information; not suitable for complex technical writing requiring precise domain expertise or sensitive content.", + "examples": [ + "Create an engaging blog post about climate change in a casual tone about 500 words.", + "Generate a formal summary of machine learning advancements including specified keywords.", + "Write a persuasive text encouraging reading of a new book with specified tone and length." + ] + }, + "tags": [ + "text-generation", + "content-creation", + "writing", + "article", + "blogging", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of daily meditation\",\"length\":400,\"tone\":\"informal\",\"format\":\"markdown\",\"keywords\":[\"mindfulness\",\"stress reduction\"]}", + "description": "Generate an informal 400-word markdown article on daily meditation and include keywords mindfulness and stress reduction." + }, + { + "inputJson": "{\"topic\":\"Latest trends in AI\",\"length\":200,\"tone\":\"formal\",\"format\":\"plain\",\"keywords\":[]}", + "description": "Create a formal 200-word plain text summary discussing the latest AI trends without specific keywords." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "content-creation.createTrend", + "description": "Generates a data-driven trend report based on input datasets or keywords. Accepts time-series data or keyword lists related to a topic, analyzes frequency and growth patterns over a specified period, and outputs a structured summary of trend dynamics with relevant metrics and visualization pointers.", + "category": "content-creation", + "parameters": [ + { + "name": "dataSource", + "type": "string", + "description": "URL or identifier of the data source containing time-series or keyword frequency data to analyze for trend creation.", + "required": true, + "defaultValue": "" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases to focus the trend analysis on when dataset contains multiple topics.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 formatted date string to define the start of the analysis period.", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 formatted date string to define the end of the analysis period.", + "required": true, + "defaultValue": "" + }, + { + "name": "granularity", + "type": "string", + "description": "Time granularity for trend analysis such as 'daily', 'weekly', or 'monthly'.", + "required": false, + "defaultValue": "weekly" + }, + { + "name": "includeVisualHints", + "type": "boolean", + "description": "Flag indicating whether to include suggestions for visualizations that represent the trend clearly.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the trend analysis summary including trend strength metrics, growth rates, key data points, and optional visualization hints." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a clear, data-based summary of trend patterns over time for specific keywords or topics from actual datasets. It helps synthesize complex frequency data into actionable insights, supporting content creation such as market reports, social media strategy, or research briefs.", + "limitations": "This tool does not fetch raw data automatically and requires properly formatted input data sources. It cannot perform real-time trend prediction beyond given data or analyze sentiment beyond frequency and growth patterns.", + "examples": [ + "Generate a trend report for 'electric vehicles' keyword frequency on Twitter over the last year with weekly granularity.", + "Create a trend summary from a time-series dataset of product sales data from Jan 1 2023 to Jun 1 2023 to identify emerging consumer interests.", + "Analyze multiple keywords related to 'home fitness' for the past six months to spot rising trends and generate visualization suggestions." + ] + }, + "tags": [ + "content-creation", + "analytics", + "trend-analysis", + "data-driven", + "report-generation", + "time-series", + "keywords" + ], + "examples": [ + { + "inputJson": "{\"dataSource\":\"https://example.com/datasets/twitter_keyword_freq.json\",\"keywords\":[\"electric vehicles\"],\"startDate\":\"2023-01-01\",\"endDate\":\"2023-12-31\",\"granularity\":\"weekly\",\"includeVisualHints\":true}", + "description": "Generate a weekly trend report on the popularity of 'electric vehicles' from Twitter data for 2023." + }, + { + "inputJson": "{\"dataSource\":\"dataset://sales_2023_q1\",\"keywords\":[\"fitness tracker\",\"smartwatch\"],\"startDate\":\"2023-01-01\",\"endDate\":\"2023-03-31\",\"granularity\":\"daily\",\"includeVisualHints\":false}", + "description": "Create a detailed daily trend analysis for 'fitness tracker' and 'smartwatch' product sales in Q1 2023 without visualization hints." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Trend", + "context": null + } + }, + { + "name": "content-creation.createEvent", + "description": "Creates a structured analytics event definition for digital content tracking. Accepts event name, properties, timestamp, user info, and optional metadata. Processes inputs to generate a standardized event object ready for logging or downstream analytics processing.", + "category": "content-creation", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the event to create, e.g., 'page_view' or 'button_click'", + "required": true, + "defaultValue": "" + }, + { + "name": "properties", + "type": "object", + "description": "Key-value pairs describing event attributes, e.g., {'buttonColor': 'red', 'page': 'homepage'}", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp of when the event occurred (e.g., '2024-04-25T10:20:30Z'). Defaults to current time if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier of the user who performed the event, if known", + "required": false, + "defaultValue": "" + }, + { + "name": "sessionId", + "type": "string", + "description": "Session identifier to link related events from the same user session", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional metadata for the event (e.g., device info, app version)", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A structured event object containing all provided inputs normalized with standard fields: eventName, properties, timestamp, userId, sessionId, and metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate a structured event object to log or send to an analytics system, based on given details about the event, user, and context. It standardizes event creation to ensure consistency in analytics workflows.", + "limitations": "This tool does not send events to analytics platforms or ensure schema validity beyond basic structure. It also does not generate events from raw logs or infer missing data automatically.", + "examples": [ + "Create an event for a user clicking a signup button with button color and page info.", + "Generate an event representing a page view with timestamp and session ID.", + "Build an event for a purchase completed with user ID and additional metadata like payment method." + ] + }, + "tags": [ + "content-creation", + "analytics", + "event-tracking", + "data-logging", + "user-interaction", + "digital-marketing" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"button_click\",\"properties\":{\"buttonColor\":\"blue\",\"buttonText\":\"Subscribe\"},\"timestamp\":\"2024-04-25T15:22:10Z\",\"userId\":\"user_1234\",\"sessionId\":\"session_5678\",\"metadata\":{\"device\":\"mobile\",\"appVersion\":\"1.5.2\"}}", + "description": "Create an event for a button click with detailed properties and user/session context." + }, + { + "inputJson": "{\"eventName\":\"page_view\",\"properties\":{\"pageUrl\":\"https://example.com/home\"}}", + "description": "Generate a simple page view event with default timestamp and no user info." + }, + { + "inputJson": "{\"eventName\":\"purchase\",\"properties\":{\"itemId\":\"sku_9876\",\"price\":29.99,\"currency\":\"USD\"},\"userId\":\"user_4321\",\"metadata\":{\"paymentMethod\":\"credit_card\"}}", + "description": "Create a purchase event with pricing details and user identity." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "content-creation.createDashboard", + "description": "Creates a customizable analytics dashboard by processing provided datasets and user preferences. Accepts data sources and configuration settings, processes metrics and visualizations, and outputs a structured dashboard layout with charts, tables, and summary widgets suitable for web or app integration.", + "category": "content-creation", + "parameters": [ + { + "name": "dashboardTitle", + "type": "string", + "description": "The title of the dashboard to be displayed prominently.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "Array of objects representing data sources, each with identifiers and query details to fetch analytics data.", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of metrics to be calculated and displayed, such as total sales, user engagement, conversion rate.", + "required": true, + "defaultValue": "" + }, + { + "name": "widgets", + "type": "array", + "description": "Configuration of visual components like charts, tables, and summary cards including type and data binding info.", + "required": true, + "defaultValue": "" + }, + { + "name": "theme", + "type": "string", + "description": "Visual theme for the dashboard UI (e.g., light, dark, corporate).", + "required": false, + "defaultValue": "light" + }, + { + "name": "refreshInterval", + "type": "number", + "description": "Time interval in seconds for automatic data refresh on the dashboard; 0 to disable auto-refresh.", + "required": false, + "defaultValue": "0" + }, + { + "name": "includeFilters", + "type": "boolean", + "description": "Whether to include filter controls for users to dynamically query dashboard data.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object representing the fully configured dashboard including layout, data bindings, and visual elements, ready for rendering or integration." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate an interactive and customizable analytics overview from multiple data sources, supporting various metrics and visualizations, to deliver insights in a user-friendly dashboard format.", + "limitations": "Does not perform raw data extraction or complex data cleaning; assumes input data sources are preprocessed and accessible. Does not implement rendering but provides structured layout and configuration only.", + "examples": [ + "Create a sales performance dashboard showing total revenue, sales by region, and customer acquisition metrics.", + "Generate a user engagement dashboard with charts for daily active users and session duration.", + "Build a marketing campaign dashboard displaying conversion rates and ad spend with filters for date range." + ] + }, + "tags": [ + "dashboard", + "analytics", + "content-creation", + "visualization", + "data", + "metrics", + "business-intelligence" + ], + "examples": [ + { + "inputJson": "{\"dashboardTitle\":\"Sales Overview\",\"dataSources\":[{\"id\":\"ds1\",\"type\":\"database\",\"query\":\"SELECT * FROM sales_data\"}],\"metrics\":[\"totalSales\",\"salesByRegion\"],\"widgets\":[{\"type\":\"barChart\",\"metric\":\"salesByRegion\",\"title\":\"Sales by Region\"},{\"type\":\"summaryCard\",\"metric\":\"totalSales\",\"title\":\"Total Sales\"}],\"theme\":\"corporate\",\"refreshInterval\":300,\"includeFilters\":true}", + "description": "Create a corporate-themed sales overview dashboard with bar chart and summary card, auto-refresh every 5 minutes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Dashboard", + "context": null + } + }, + { + "name": "content-creation.createAnomaly", + "description": "This tool accepts a dataset containing time-series or multi-dimensional metrics and applies anomaly detection algorithms to identify unusual patterns or deviations. It processes input data to highlight anomalies based on statistical thresholds, machine learning models, or user-defined criteria, and outputs a structured report listing detected anomalies with timestamps, severity scores, and contextual metadata.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of data points representing observations or metric values over time or related contexts. Each data point should be an object with timestamp and metric values.", + "required": true, + "defaultValue": "" + }, + { + "name": "algorithm", + "type": "string", + "description": "The anomaly detection algorithm to apply, e.g., 'statistical', 'isolationForest', 'LSTM','seasonalHybrid'.", + "required": false, + "defaultValue": "statistical" + }, + { + "name": "sensitivity", + "type": "number", + "description": "A number between 0 and 1 indicating how sensitive the anomaly detection should be; higher values detect more anomalies but may increase false positives.", + "required": false, + "defaultValue": "0.5" + }, + { + "name": "timeField", + "type": "string", + "description": "The name of the field in data objects that represents the timestamp or time index for each metric record.", + "required": false, + "defaultValue": "timestamp" + }, + { + "name": "metricsFields", + "type": "array", + "description": "List of field names in the data objects to analyze for anomalies. If empty, all numeric fields will be used.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "threshold", + "type": "number", + "description": "A specific threshold value to classify an anomaly if using statistical methods; overrides sensitivity thresholds if provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of anomalies detected. Each anomaly includes a timestamp, the metric(s) involved, the anomaly score, and a severity level or classification." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically identify irregular or unexpected patterns in metric data such as system logs, user activity, financial transactions, or sensor readings to support monitoring, alerting, or root cause analysis. It is suited for scenarios requiring scalable anomaly detection based on statistical or machine learning approaches, allowing configuration of detection sensitivity and algorithms.", + "limitations": "The tool requires input data to be well-structured and time-indexed. It may not perform well on highly sparse or unstructured data. Domain-specific contextual interpretation of anomalies is outside its scope. The tool does not automatically explain the cause of anomalies, only identifies them.", + "examples": [ + "Detect anomalies in web server request counts to identify traffic spikes or drops.", + "Analyze sensor data from IoT devices for unusual readings that may indicate faults.", + "Scan financial transactions across multiple metrics to flag suspicious activities." + ] + }, + "tags": [ + "anomaly-detection", + "analytics", + "content-creation", + "machine-learning", + "time-series", + "monitoring" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"timestamp\":\"2024-06-01T00:00:00Z\",\"cpu\":20,\"memory\":30},{\"timestamp\":\"2024-06-01T01:00:00Z\",\"cpu\":85,\"memory\":32},{\"timestamp\":\"2024-06-01T02:00:00Z\",\"cpu\":22,\"memory\":31}],\"algorithm\":\"statistical\",\"sensitivity\":0.7,\"timeField\":\"timestamp\",\"metricsFields\":[\"cpu\"]}", + "description": "Detect CPU usage anomalies in hourly server metrics using default statistical method and a higher sensitivity." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Anomaly", + "context": null + } + }, + { + "name": "content-creation.createSession", + "description": "Creates a new analytics session record based on input parameters including user ID, session start time, device info, and optional metadata. Validates inputs and returns a structured session object with a unique session ID and timestamps for tracking user activity.", + "category": "content-creation", + "parameters": [ + { + "name": "userId", + "type": "string", + "description": "Unique identifier for the user whose session is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 formatted timestamp indicating when the session started.", + "required": true, + "defaultValue": "" + }, + { + "name": "deviceInfo", + "type": "object", + "description": "An object containing details about the user's device such as device type, operating system, and browser.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional data related to the session, such as campaign info or entry URL.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "isNewUser", + "type": "boolean", + "description": "Flag to indicate if this session belongs to a new user or returning user.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object representing the newly created session including sessionId, userId, startTime, deviceInfo, metadata, and isNewUser flag." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create and record user interaction sessions for analytics purposes, including tracking start time, device context, and custom metadata. It's suitable for logging sessions in web or mobile applications to support analytics and activity monitoring.", + "limitations": "This tool only creates the session object but does not handle session updates or termination tracking. It does not store the session in a database; that requires external integration.", + "examples": [ + "Create a session when a user logs in to start tracking their activity.", + "Log a session with device and campaign metadata on a marketing landing page visit.", + "Start a session for a new user with basic device info for analytics collection." + ] + }, + "tags": [ + "content-creation", + "session", + "analytics", + "user-tracking", + "data-collection" + ], + "examples": [ + { + "inputJson": "{\"userId\":\"user_12345\",\"startTime\":\"2024-04-27T12:00:00Z\",\"deviceInfo\":{\"deviceType\":\"mobile\",\"os\":\"iOS 16\",\"browser\":\"Safari\"},\"metadata\":{\"campaign\":\"spring_sale\"},\"isNewUser\":true}", + "description": "Creating a session for a new iOS mobile user coming from a spring sale campaign." + }, + { + "inputJson": "{\"userId\":\"user_67890\",\"startTime\":\"2024-04-27T15:30:00Z\"}", + "description": "Creating a simple session record for a returning user with minimal data." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Session", + "context": null + } + }, + { + "name": "content-creation.createParagraph", + "description": "Generates a coherent paragraph of text based on a given topic and style. Accepts inputs like topic keywords and tone, and outputs a fully formed paragraph suitable for articles, blogs, or reports.", + "category": "content-creation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme the paragraph should focus on.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the paragraph, e.g., formal, casual, persuasive, informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of sentences to generate in the paragraph.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include examples or illustrative details in the paragraph.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "The language for the generated paragraph, defaults to English.", + "required": false, + "defaultValue": "English" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text as a string under the 'paragraph' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a focused paragraph of prose about a specific topic, adapting tone and length based on context for content creation tasks such as article writing, summarization, or report generation.", + "limitations": "The tool cannot generate highly specialized technical paragraphs requiring deep domain expertise, nor can it guarantee factual accuracy; it is best suited for general content creation and illustrative writing.", + "examples": [ + "Create an informative 5-sentence paragraph about climate change.", + "Generate a casual paragraph about the benefits of meditation including examples.", + "Write a formal paragraph on data privacy in English, 7 sentences long." + ] + }, + "tags": [ + "content creation", + "text generation", + "paragraph writing", + "creative writing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"climate change\",\"tone\":\"informative\",\"length\":5,\"includeExamples\":false,\"language\":\"English\"}", + "description": "Generate an informative paragraph about climate change with 5 sentences." + }, + { + "inputJson": "{\"topic\":\"benefits of meditation\",\"tone\":\"casual\",\"length\":6,\"includeExamples\":true,\"language\":\"English\"}", + "description": "Create a casual paragraph explaining meditation benefits with illustrative examples." + }, + { + "inputJson": "{\"topic\":\"data privacy\",\"tone\":\"formal\",\"length\":7,\"includeExamples\":false,\"language\":\"English\"}", + "description": "Write a formal 7 sentence paragraph about data privacy in English." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "content-creation.createSentence", + "description": "Generates a coherent and contextually relevant sentence based on provided keywords, tone, and complexity level. Accepts keywords as an array of strings, a tone specifying the style (e.g., formal, casual), and a complexity level (simple, intermediate, advanced). Outputs a well-formed sentence incorporating the inputs.", + "category": "content-creation", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "An array of keywords that should be included or reflected in the generated sentence.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the sentence, e.g., formal, casual, informative, persuasive.", + "required": false, + "defaultValue": "\"neutral\"" + }, + { + "name": "complexity", + "type": "string", + "description": "The complexity level of the sentence, such as simple, intermediate, or advanced vocabulary and structure.", + "required": false, + "defaultValue": "\"intermediate\"" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words allowed in the generated sentence.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence as a string and metadata: word count and applied tone." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a single, clear, and contextually appropriate sentence based on specific keywords or desired writing style, such as for summarizing key points, writing prompts, or creative content generation.", + "limitations": "Cannot generate multiple sentences or paragraphs. May produce sentences that lack deep factual accuracy. Does not handle non-English languages or specialized jargon well.", + "examples": [ + "Create a formal sentence including keywords 'climate change' and 'policy'.", + "Generate a casual sentence using keywords 'coffee' and 'morning'.", + "Produce a simple sentence with keywords 'dog' and 'park' and a max length of 10 words." + ] + }, + "tags": [ + "content-creation", + "sentence-generation", + "text", + "natural-language", + "writing", + "creative", + "AI" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"climate change\",\"policy\"],\"tone\":\"formal\",\"complexity\":\"advanced\"}", + "description": "Generate an advanced formal sentence containing 'climate change' and 'policy'." + }, + { + "inputJson": "{\"keywords\":[\"coffee\",\"morning\"],\"tone\":\"casual\",\"complexity\":\"simple\"}", + "description": "Generate a simple casual sentence including 'coffee' and 'morning'." + }, + { + "inputJson": "{\"keywords\":[\"dog\",\"park\"],\"maxLength\":10}", + "description": "Generate a sentence about 'dog' and 'park' with a maximum length of 10 words." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Sentence", + "context": null + } + }, + { + "name": "content-creation.createWord", + "description": "Generates a new word based on specified linguistic properties such as length, parts of speech, or phonetic style. The tool accepts parameters defining the word's characteristics and produces either a neologism or a plausible word fitting the input criteria, useful for creative writing, branding, or language experiments.", + "category": "content-creation", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Desired length of the generated word (number of characters). Ignored if zero or not provided.", + "required": false, + "defaultValue": "0" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "Target part of speech for the word (e.g., noun, verb, adjective). Optional parameter to guide generation.", + "required": false, + "defaultValue": "" + }, + { + "name": "phoneticStyle", + "type": "string", + "description": "Preferred phonetic style or pattern (e.g., soft, harsh, harmonious). Helps shape word phonology, optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "seedWord", + "type": "string", + "description": "An optional existing word to influence or base the new word on, for inspiration or morphing.", + "required": false, + "defaultValue": "" + }, + { + "name": "quantity", + "type": "number", + "description": "Number of unique words to generate in one call, from 1 to 10.", + "required": false, + "defaultValue": "1" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a list of generated words that meet the specified criteria." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to generate original or creative words for content such as brand names, fictional character names, or new terminology. It helps add originality and linguistic variety to digital content creation workflows.", + "limitations": "The tool does not guarantee that generated words exist in any language or their semantic meaning. It cannot generate full definitions or ensure words are suitable for all cultural contexts.", + "examples": [ + "Generate a new brand name with 8 letters and a soft phonetic style.", + "Create three new adjectives related to speed.", + "Produce a single noun inspired by the word 'stream'." + ] + }, + "tags": [ + "content-creation", + "word-generation", + "creative-writing", + "branding", + "linguistics" + ], + "examples": [ + { + "inputJson": "{\"length\":7,\"partOfSpeech\":\"noun\",\"phoneticStyle\":\"soft\",\"quantity\":1}", + "description": "Generate one soft-sounding noun of length 7." + }, + { + "inputJson": "{\"seedWord\":\"light\",\"quantity\":3}", + "description": "Generate three words inspired by the seed word 'light'." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "content-creation.createKPI", + "description": "Creates a customized Key Performance Indicator (KPI) definition based on specified business objectives and measurement parameters. Accepts input such as KPI name, target metrics, calculation logic, data sources, and reporting frequency, then outputs a structured KPI object that can be integrated into analytics dashboards or performance tracking systems.", + "category": "content-creation", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The descriptive name of the KPI to be created (e.g., Monthly Revenue Growth)", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed explanation of what the KPI measures and its business relevance", + "required": false, + "defaultValue": "" + }, + { + "name": "targetMetric", + "type": "string", + "description": "The specific metric or data field this KPI will track (e.g., revenue, conversion rate)", + "required": true, + "defaultValue": "" + }, + { + "name": "calculationFormula", + "type": "string", + "description": "The formula or logic used to calculate the KPI value from raw data (e.g., sum(revenue)/count(days))", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "List of data source names or identifiers required to compute the KPI", + "required": true, + "defaultValue": "[]" + }, + { + "name": "reportingFrequency", + "type": "string", + "description": "How often the KPI should be updated or reported (e.g., daily, weekly, monthly)", + "required": true, + "defaultValue": "monthly" + }, + { + "name": "thresholds", + "type": "object", + "description": "Optional performance thresholds defining success, warning, and failure levels (e.g., {\"success\":90,\"warning\":75})", + "required": false, + "defaultValue": "" + }, + { + "name": "owner", + "type": "string", + "description": "Person or team responsible for the KPI monitoring and actions", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured KPI object containing all defined attributes, ready for storage or integration into analytics platforms" + }, + "aiAgent": { + "useCase": "Use this tool when needing to formalize and create well-defined KPIs for monitoring performance against business objectives. It is ideal for generating standardized KPI definitions from user inputs to ensure consistent analytics and reporting setup.", + "limitations": "This tool does not collect or process raw performance data; it only creates the KPI definition structure. The calculation formula should be validated externally for correctness.", + "examples": [ + "Create a KPI tracking the weekly active users with a formula counting unique user IDs per week and monthly reporting.", + "Define a sales conversion rate KPI using the ratio of completed purchases to total visits updated daily.", + "Generate a KPI to measure customer satisfaction using survey score averages with quarterly reporting." + ] + }, + "tags": [ + "content-creation", + "analytics", + "KPI", + "performance-metrics", + "business-intelligence", + "data-analytics", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"Monthly Revenue Growth\",\"description\":\"Measures the percentage increase in revenue compared to the previous month.\",\"targetMetric\":\"revenue\",\"calculationFormula\":\"(current_month_revenue - previous_month_revenue) / previous_month_revenue * 100\",\"dataSources\":[\"salesDatabase\"],\"reportingFrequency\":\"monthly\",\"thresholds\":{\"success\":10,\"warning\":5},\"owner\":\"finance-team\"}", + "description": "Create a monthly revenue growth KPI with success and warning thresholds." + }, + { + "inputJson": "{\"kpiName\":\"Weekly Active Users\",\"targetMetric\":\"activeUsers\",\"calculationFormula\":\"count(distinct userId) per week\",\"dataSources\":[\"userActivityLogs\"],\"reportingFrequency\":\"weekly\"}", + "description": "Define a weekly active users KPI based on unique user count." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "content-creation.createDatabase", + "description": "Creates a new database schema definition for content management systems. Accepts parameters such as database type, schema name, and table definitions including fields and data types. Processes these inputs to generate a JSON-structured database schema template suitable for integration with content creation platforms or CMS backends.", + "category": "content-creation", + "parameters": [ + { + "name": "databaseType", + "type": "string", + "description": "Type of the database to create schema for, e.g., SQL, NoSQL", + "required": true, + "defaultValue": "" + }, + { + "name": "schemaName", + "type": "string", + "description": "Name of the database schema or project", + "required": true, + "defaultValue": "" + }, + { + "name": "tables", + "type": "array", + "description": "Array of table definitions, each with name, fields (name and data type), and optional indexes", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTimestamps", + "type": "boolean", + "description": "Whether to include standard created_at and updated_at timestamp fields in each table", + "required": false, + "defaultValue": "true" + }, + { + "name": "primaryKeyType", + "type": "string", + "description": "Data type for primary keys in tables, e.g., integer, UUID", + "required": false, + "defaultValue": "integer" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated database schema as a JSON string and metadata about the schema such as total tables and example table definitions" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to design or scaffold a database schema for a content management system or digital content platform, based on user specifications about structure and data types. It helps automate the initial creation of structured, consistent database definitions, streamlining backend content infrastructure setup.", + "limitations": "This tool generates schema definitions but does not create the actual physical databases or manage migrations. It also does not perform data validation rules beyond basic types.", + "examples": [ + "Create a database schema with tables for articles, authors, and categories including respective fields.", + "Generate a NoSQL database schema suitable for a content platform tracking posts and user metadata.", + "Produce a SQL schema with UUID primary keys and timestamp fields included for all tables." + ] + }, + "tags": [ + "content creation", + "database", + "schema generation", + "CMS", + "infrastructure", + "backend" + ], + "examples": [ + { + "inputJson": "{\"databaseType\":\"SQL\",\"schemaName\":\"ContentManagement\",\"tables\":[{\"name\":\"Articles\",\"fields\":[{\"name\":\"id\",\"type\":\"integer\"},{\"name\":\"title\",\"type\":\"string\"},{\"name\":\"content\",\"type\":\"text\"},{\"name\":\"authorId\",\"type\":\"integer\"}]},{\"name\":\"Authors\",\"fields\":[{\"name\":\"id\",\"type\":\"integer\"},{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"email\",\"type\":\"string\"}]}],\"includeTimestamps\":true,\"primaryKeyType\":\"integer\"}", + "description": "Create a SQL database schema named ContentManagement with Articles and Authors tables, including timestamp fields and integer primary keys." + }, + { + "inputJson": "{\"databaseType\":\"NoSQL\",\"schemaName\":\"BlogPlatform\",\"tables\":[{\"name\":\"Posts\",\"fields\":[{\"name\":\"_id\",\"type\":\"UUID\"},{\"name\":\"title\",\"type\":\"string\"},{\"name\":\"body\",\"type\":\"string\"},{\"name\":\"tags\",\"type\":\"array\"}]},{\"name\":\"Users\",\"fields\":[{\"name\":\"_id\",\"type\":\"UUID\"},{\"name\":\"username\",\"type\":\"string\"}]}],\"includeTimestamps\":false,\"primaryKeyType\":\"UUID\"}", + "description": "Generate a NoSQL schema named BlogPlatform with Posts and Users collections using UUIDs as primary keys and no timestamp fields." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Database", + "context": null + } + }, + { + "name": "content-creation.createQueue", + "description": "Creates a managed message queue for content creation workflows. Accepts parameters defining queue name, type (e.g., FIFO or standard), visibility timeout, and optional metadata. Returns a queue object with a unique identifier and configuration details to enable buffering, ordering, and asynchronous processing of content creation tasks.", + "category": "content-creation", + "parameters": [ + { + "name": "queueName", + "type": "string", + "description": "The unique name for the queue to be created, used to identify it in the system.", + "required": true, + "defaultValue": "" + }, + { + "name": "queueType", + "type": "string", + "description": "The type of queue to create; options include 'FIFO' for ordered processing or 'Standard' for best-effort ordering.", + "required": true, + "defaultValue": "Standard" + }, + { + "name": "visibilityTimeout", + "type": "number", + "description": "The duration (in seconds) that a message received from the queue will be invisible to other consumers while being processed.", + "required": false, + "defaultValue": "30" + }, + { + "name": "maxMessageSize", + "type": "number", + "description": "Maximum size (in bytes) of a message allowed in the queue.", + "required": false, + "defaultValue": "262144" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs to attach metadata or tags to the queue for organizational purposes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing queueId, queueName, queueType, creationTimestamp, visibilityTimeout, maxMessageSize, and any metadata provided." + }, + "aiAgent": { + "useCase": "Use this tool when an AI system needs to setup a dedicated message queue to manage asynchronous tasks or events related to content creation processes such as rendering, publishing, or moderation. It is suitable for orchestrating content workflows requiring reliability, ordering, and scalable throughput.", + "limitations": "This tool does not handle message publishing or consumption within the queue — it only sets up and configures the queue itself. It cannot manage queue monitoring or scaling dynamically.", + "examples": [ + "Create a FIFO queue named 'ContentRenderQueue' with a visibility timeout of 60 seconds.", + "Set up a standard queue with a 256KB message size limit named 'PublishingTasks'.", + "Create a queue with custom metadata tags for department 'marketing' and project 'summer_campaign'." + ] + }, + "tags": [ + "content-creation", + "queue", + "infrastructure", + "message-queue", + "async-processing", + "workflow-management" + ], + "examples": [ + { + "inputJson": "{\"queueName\":\"ContentRenderQueue\",\"queueType\":\"FIFO\",\"visibilityTimeout\":60}", + "description": "Creates a FIFO queue named ContentRenderQueue with a 60 seconds visibility timeout." + }, + { + "inputJson": "{\"queueName\":\"PublishingTasks\",\"queueType\":\"Standard\",\"maxMessageSize\":131072}", + "description": "Creates a standard type queue with max message size of 128KB named PublishingTasks." + }, + { + "inputJson": "{\"queueName\":\"MarketingQueue\",\"queueType\":\"Standard\",\"metadata\":{\"department\":\"marketing\",\"project\":\"summer_campaign\"}}", + "description": "Creates a standard queue with metadata tags for organizational purposes." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Queue", + "context": null + } + }, + { + "name": "content-creation.createCache", + "description": "Creates and manages an in-memory or persistent cache for digital content to speed up retrieval and reduce redundant processing. Accepts configuration parameters defining cache type, size limits, eviction policy, and optional persistence options. Returns a cache instance identifier and status indicating readiness.", + "category": "content-creation", + "parameters": [ + { + "name": "cacheName", + "type": "string", + "description": "Unique name identifier for the cache instance to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "cacheType", + "type": "string", + "description": "Type of cache to create, e.g., 'memory' for in-memory cache or 'disk' for persistent cache storage.", + "required": true, + "defaultValue": "memory" + }, + { + "name": "maxSize", + "type": "number", + "description": "Maximum size of the cache in megabytes to limit memory or disk usage.", + "required": false, + "defaultValue": "100" + }, + { + "name": "evictionPolicy", + "type": "string", + "description": "Cache eviction policy to use when the max size is reached, such as 'LRU' (Least Recently Used), 'FIFO' (First In First Out), or 'LFU' (Least Frequently Used).", + "required": false, + "defaultValue": "LRU" + }, + { + "name": "persistencePath", + "type": "string", + "description": "File system path to store cache data if cacheType is 'disk'. Ignored otherwise.", + "required": false, + "defaultValue": "" + }, + { + "name": "defaultTTL", + "type": "number", + "description": "Default time-to-live for cached items in seconds. Items expire and are removed after this time unless refreshed.", + "required": false, + "defaultValue": "3600" + }, + { + "name": "enableCompression", + "type": "boolean", + "description": "Option to enable compression of cached content to reduce storage size at the cost of additional CPU usage.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the created cache's unique identifier and a status message confirming cache creation and configuration." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to establish a cache layer to improve performance in digital content generation or delivery pipelines. Typical scenarios include caching generated images, text snippets, or other frequently requested data to reduce recomputation or repeated fetches from slower storage.", + "limitations": "This tool does not handle distributed cache synchronization or multi-node cluster cache consistency. It also does not directly manage cache retrieval; it only creates and configures the cache instance.", + "examples": [ + "Create a memory cache named 'imageCache' with max size 200MB and LRU eviction.", + "Create a persistent disk cache 'contentCache' stored at '/var/cache/content' with compression enabled.", + "Create a small 50MB cache for ephemeral data with a short TTL of 300 seconds." + ] + }, + "tags": [ + "cache", + "content-creation", + "performance", + "infrastructure", + "memory", + "disk", + "eviction", + "compression" + ], + "examples": [ + { + "inputJson": "{\"cacheName\":\"imageCache\",\"cacheType\":\"memory\",\"maxSize\":200,\"evictionPolicy\":\"LRU\",\"defaultTTL\":3600}", + "description": "Create a memory cache named 'imageCache' with 200MB max size and LRU eviction policy." + }, + { + "inputJson": "{\"cacheName\":\"contentCache\",\"cacheType\":\"disk\",\"maxSize\":500,\"evictionPolicy\":\"FIFO\",\"persistencePath\":\"/var/cache/content\",\"enableCompression\":true}", + "description": "Create a persistent disk cache called 'contentCache' at the specified path with FIFO eviction and compression enabled." + }, + { + "inputJson": "{\"cacheName\":\"tempCache\",\"cacheType\":\"memory\",\"maxSize\":50,\"defaultTTL\":300}", + "description": "Create a small, short-lived memory cache for ephemeral data with 50MB size and 5 minutes TTL." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cache", + "context": null + } + }, + { + "name": "content-creation.createMetric", + "description": "Generates a customized analytic metric definition based on input parameters such as metric name, formula, description, data sources, and aggregation method. Processes these inputs to create a structured metric object usable in content analytics platforms for tracking and reporting purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "metricName", + "type": "string", + "description": "The unique name identifier for the metric to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "formula", + "type": "string", + "description": "The calculation formula or expression defining how the metric value is computed.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A human-readable explanation of what the metric measures and its significance.", + "required": false, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "List of data source identifiers used by this metric for calculation.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "The aggregation method applied to raw data (e.g., sum, average, count).", + "required": false, + "defaultValue": "sum" + }, + { + "name": "timeFrame", + "type": "string", + "description": "The time interval over which the metric is calculated or aggregated, e.g., daily, weekly.", + "required": false, + "defaultValue": "daily" + }, + { + "name": "filters", + "type": "object", + "description": "Optional filtering parameters defining subset of data used for metric calculation.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A structured JSON object representing the metric definition including name, formula, description, sources, aggregation, timeframe, and filters." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to define new analytic metrics for digital content performance measurement, for example, to track user engagement, conversion rates, or custom KPIs based on multiple data sources and aggregation rules.", + "limitations": "Cannot calculate or fetch real-time metric values; only generates metric definitions. The tool requires valid formula syntax and compatible data source identifiers to produce usable metrics.", + "examples": [ + "Create a metric named 'AvgSessionDuration' with a formula calculating average session time from session logs, aggregated daily.", + "Define a custom conversion rate metric combining page views and signups data sources with a count aggregation.", + "Generate a metric measuring 'ContentShares' filtered by social media channels for weekly reporting." + ] + }, + "tags": [ + "analytics", + "metrics", + "content-creation", + "data-aggregation", + "performance-tracking" + ], + "examples": [ + { + "inputJson": "{\"metricName\":\"UserEngagementScore\",\"formula\":\"(likes + comments + shares) / views\",\"description\":\"Engagement score representing user interactions per content view.\",\"dataSources\":[\"likesDB\",\"commentsDB\",\"sharesDB\",\"viewsDB\"],\"aggregationMethod\":\"sum\",\"timeFrame\":\"daily\",\"filters\":{}}", + "description": "Create a daily engagement score metric summing likes, comments, and shares normalized by views." + }, + { + "inputJson": "{\"metricName\":\"WeeklyConversionRate\",\"formula\":\"conversions / visits\",\"description\":\"Rate of conversions per visit over a week.\",\"dataSources\":[\"conversionDB\",\"visitDB\"],\"aggregationMethod\":\"average\",\"timeFrame\":\"weekly\",\"filters\":{\"region\":\"NA\"}}", + "description": "Define a weekly average conversion rate metric filtered for North American region." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Metric", + "context": null + } + }, + { + "name": "content-creation.createCluster", + "description": "This tool accepts configuration parameters to create and initialize a computing cluster tailored for content creation workflows. It processes inputs like cluster size, node specifications, software environment, and access settings to set up a scalable infrastructure cluster. The output confirms cluster creation status and provides connection details and resource summaries.", + "category": "content-creation", + "parameters": [ + { + "name": "clusterName", + "type": "string", + "description": "Unique name identifier for the cluster to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "nodeCount", + "type": "number", + "description": "Number of nodes to include in the cluster, determining its size and capacity.", + "required": true, + "defaultValue": "" + }, + { + "name": "nodeType", + "type": "string", + "description": "Specification of node hardware or virtual machine type, defining compute and memory resources per node.", + "required": true, + "defaultValue": "" + }, + { + "name": "softwareStack", + "type": "array", + "description": "List of software packages or environments to install on each cluster node relevant for content creation tasks.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "autoScalingEnabled", + "type": "boolean", + "description": "Whether to enable automatic scaling of cluster nodes based on workload demand.", + "required": false, + "defaultValue": "false" + }, + { + "name": "region", + "type": "string", + "description": "Geographic region where the cluster will be provisioned to optimize latency and compliance.", + "required": true, + "defaultValue": "" + }, + { + "name": "accessControl", + "type": "object", + "description": "Defines users or groups with access permissions and their permission levels for managing the cluster.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "networkSettings", + "type": "object", + "description": "Network configuration details such as VPC, subnets, and firewall rules for the cluster.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "Returns a clusterStatus object including clusterId, creationTimestamp, connectionEndpoints, nodeDetails array, and overall status message confirming the creation outcome." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to provision a dedicated computing cluster for content creation workloads, such as rendering farms, video processing clusters, or collaborative media editing environments. It helps automate infrastructure setup with specified configurations.", + "limitations": "Does not manage ongoing cluster monitoring or advanced orchestration beyond initial creation. It cannot modify clusters once created or handle integration with external resource managers.", + "examples": [ + "Create a scalable render farm with 10 GPU nodes in US-West region.", + "Set up a small content creation cluster with predefined software for video editing and storage access.", + "Provision a development cluster with auto-scaling enabled in Europe region for collaborative media workflows." + ] + }, + "tags": [ + "content-creation", + "cluster", + "infrastructure", + "provisioning", + "automation", + "media", + "rendering", + "scalable" + ], + "examples": [ + { + "inputJson": "{\"clusterName\":\"mediaRenderFarm\",\"nodeCount\":10,\"nodeType\":\"gpu-optimized\",\"softwareStack\":[\"ffmpeg\",\"blender\"],\"autoScalingEnabled\":true,\"region\":\"us-west\",\"accessControl\":{\"admin\":\"full\"},\"networkSettings\":{\"vpcId\":\"vpc-123\",\"subnets\":[\"subnet-1\",\"subnet-2\"]}}", + "description": "Create a GPU-optimized render farm cluster with auto-scaling in the US-West region configured for media rendering." + }, + { + "inputJson": "{\"clusterName\":\"videoEditCluster\",\"nodeCount\":3,\"nodeType\":\"standard\",\"softwareStack\":[\"adobe-premiere\",\"davinci-resolve\"],\"autoScalingEnabled\":false,\"region\":\"eu-central\"}", + "description": "Set up a small content creation cluster for video editing software in the EU-Central region without auto-scaling." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Cluster", + "context": null + } + }, + { + "name": "content-creation.createContainer", + "description": "Creates a digital content container that serves as a structured workspace or repository for organizing related media and documents. Accepts parameters defining container type, access controls, metadata tags, and initial contents, then provisions a container with corresponding storage and metadata for use in content workflows.", + "category": "content-creation", + "parameters": [ + { + "name": "containerType", + "type": "string", + "description": "Specifies the type of container to create, such as 'folder', 'album', or 'project'.", + "required": true, + "defaultValue": "" + }, + { + "name": "name", + "type": "string", + "description": "The display name for the container.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Optional descriptive text explaining the container’s purpose.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Array of strings for categorizing or labeling the container for search and filtering.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "accessControl", + "type": "object", + "description": "Defines access permissions as an object specifying roles or users with read/write rights.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "initialContents", + "type": "array", + "description": "Optional array of identifiers or URLs for initial media or documents to include in the container.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the unique container ID, type, name, creation timestamp, and access control summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a dedicated and organized container to store or manage digital content such as images, documents, or mixed media for projects or workflows. It suits scenarios requiring structured grouping with metadata and access permissions.", + "limitations": "Does not handle content editing or manipulation within the container; only creates and configures the container infrastructure.", + "examples": [ + "Create a photo album container named 'Summer Vacation 2024' with tags 'travel','photos' and read access for user group 'friends'.", + "Set up a project folder container called 'Q3 Marketing' with description and access limited to the marketing team.", + "Create a generic container of type 'folder' named 'Archive' without initial contents and default access permissions." + ] + }, + "tags": [ + "content-creation", + "container", + "organization", + "media-management", + "access-control", + "metadata" + ], + "examples": [ + { + "inputJson": "{\"containerType\":\"album\",\"name\":\"Summer Vacation 2024\",\"description\":\"Photos from the summer trip\",\"tags\":[\"travel\",\"photos\"],\"accessControl\":{\"read\":[\"group:friends\"],\"write\":[\"user:owner\"]},\"initialContents\":[\"img12345\",\"img67890\"]}", + "description": "Create a photo album container with specific tags and access controls, preloaded with two images." + }, + { + "inputJson": "{\"containerType\":\"folder\",\"name\":\"Q3 Marketing\",\"description\":\"Marketing materials for Q3\",\"tags\":[\"project\",\"Q3\"],\"accessControl\":{\"read\":[\"group:marketing\"],\"write\":[\"group:marketing\"]},\"initialContents\":[]}", + "description": "Create a project folder container restricted to the marketing team for collaboration." + }, + { + "inputJson": "{\"containerType\":\"folder\",\"name\":\"Archive\",\"tags\":[],\"accessControl\":{},\"initialContents\":[]}", + "description": "Create a generic folder container named Archive with default access and no initial contents." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "content-creation.createService", + "description": "Creates a new content creation service instance with specified configurations, such as service name, type (e.g., blog, video, podcast), target platform, and access permissions. It processes inputs to provision the service infrastructure and returns service details including endpoints and credentials.", + "category": "content-creation", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The unique name identifier for the content creation service to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "serviceType", + "type": "string", + "description": "The type of content service to create, e.g., blog, videoChannel, podcast.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetPlatform", + "type": "string", + "description": "The platform where the content service will be deployed or integrated, e.g., YouTube, WordPress.", + "required": false, + "defaultValue": "" + }, + { + "name": "accessPermissions", + "type": "object", + "description": "Object defining user roles and permissions for access control within the service.", + "required": false, + "defaultValue": "" + }, + { + "name": "storageSizeGB", + "type": "number", + "description": "The allocated storage size in gigabytes for the service content.", + "required": false, + "defaultValue": "10" + }, + { + "name": "enableAnalytics", + "type": "boolean", + "description": "Flag to enable or disable built-in analytics tracking for the content service.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with serviceId, serviceName, serviceType, endpoints, credentials, and status indicating the provisioning result." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create and configure a new digital content creation service infrastructure, including setting roles, storage, and platform integration details. Ideal for automating setup in content management workflows.", + "limitations": "This tool cannot generate or upload actual content, nor manage ongoing service operations beyond initial creation and configuration.", + "examples": [ + "Create a new video content channel service named 'TechReviews' targeting YouTube with default permissions.", + "Set up a podcast service called 'DailyNews' with specific access permissions and 50GB storage.", + "Provision a blogging service for WordPress platform with analytics disabled." + ] + }, + "tags": [ + "content-creation", + "service-provisioning", + "automation", + "infrastructure", + "media", + "platform-integration" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"TechReviews\",\"serviceType\":\"videoChannel\",\"targetPlatform\":\"YouTube\",\"accessPermissions\":{\"admin\":[\"user1\"],\"editor\":[\"user2\",\"user3\"]},\"storageSizeGB\":20,\"enableAnalytics\":true}", + "description": "Creates a YouTube video channel service named TechReviews with specific admin and editor permissions, 20GB storage and analytics enabled." + }, + { + "inputJson": "{\"serviceName\":\"DailyNews\",\"serviceType\":\"podcast\",\"accessPermissions\":{\"admin\":[\"hostUser\"]},\"storageSizeGB\":50,\"enableAnalytics\":true}", + "description": "Sets up a podcast content creation service called DailyNews with 50GB storage, admin access for hostUser, and analytics enabled." + }, + { + "inputJson": "{\"serviceName\":\"FoodBlog\",\"serviceType\":\"blog\",\"targetPlatform\":\"WordPress\",\"enableAnalytics\":false}", + "description": "Creates a WordPress blog service named FoodBlog with default storage size and analytics disabled." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Service", + "context": null + } + }, + { + "name": "content-creation.createInstance", + "description": "Creates a new digital content instance (e.g., blog post, article, page) by accepting metadata and content input. Processes the data to initialize a structured instance with tags and status, returning the created instance's ID and summary for management or publishing workflows.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the content instance to be created, representing the main heading or identifier.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentBody", + "type": "string", + "description": "The main textual or markup content of the instance, containing the detailed information or narrative.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name or identifier of the author or creator of the instance.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "List of tags or keywords associated with the content for categorization and search optimization.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "status", + "type": "string", + "description": "Current state of the instance such as 'draft', 'published', or 'archived'.", + "required": false, + "defaultValue": "\"draft\"" + }, + { + "name": "publishDate", + "type": "string", + "description": "Optional ISO 8601 date string indicating when the content should be or was published.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing unique instance ID, summary info including title, creation timestamp, author, tags, and current status of the created instance." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or initialize a new digital content object within a content management or creation workflow, accepting basic metadata and body text to produce a managed instance ready for editing, tagging, or publishing.", + "limitations": "This tool does not itself perform content editing, formatting beyond plain input acceptance, or publishing automation; it only creates an instance with provided input data.", + "examples": [ + "Create a new blog post instance titled 'Introduction to AI' with specified content and author.", + "Initialize a content page with tags for categorization and mark it as draft.", + "Generate a news article instance scheduled for future publication date." + ] + }, + "tags": [ + "content-creation", + "instance", + "creation", + "cms", + "digital-content", + "metadata" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Welcome to Our Platform\",\"contentBody\":\"This is the first page content.\",\"author\":\"Alice\",\"tags\":[\"welcome\",\"homepage\"],\"status\":\"draft\",\"publishDate\":\"\"}", + "description": "Create a draft homepage content instance authored by Alice with welcome tags." + }, + { + "inputJson": "{\"title\":\"Deep Learning Basics\",\"contentBody\":\"Deep learning is a subset of ML...\",\"author\":\"Bob\",\"tags\":[\"AI\",\"machine learning\"],\"status\":\"published\",\"publishDate\":\"2024-06-01T08:00:00Z\"}", + "description": "Create a published article instance with tags and scheduled publish date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Instance", + "context": null + } + }, + { + "name": "content-creation.createServer", + "description": "Creates and configures a virtual server instance based on specified parameters such as server type, operating system, and resource allocations. Accepts settings like CPU count, RAM size, storage, and network config, then provisions the server and returns its access details and status.", + "category": "content-creation", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "Type of server to create, e.g., web, database, application (defines preset settings).", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system image to install on the server, e.g., Ubuntu 22.04, CentOS 8.", + "required": true, + "defaultValue": "" + }, + { + "name": "cpuCores", + "type": "number", + "description": "Number of CPU cores allocated to the server.", + "required": true, + "defaultValue": "2" + }, + { + "name": "ramGB", + "type": "number", + "description": "Amount of RAM in gigabytes allocated to the server.", + "required": true, + "defaultValue": "4" + }, + { + "name": "storageGB", + "type": "number", + "description": "Disk storage size in gigabytes attached to the server.", + "required": true, + "defaultValue": "50" + }, + { + "name": "networkConfig", + "type": "object", + "description": "Network configuration settings including firewall rules and public IP assignment.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "autoStart", + "type": "boolean", + "description": "Whether to start the server automatically after creation.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the server ID, IP address, access credentials, status, and creation timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to programmatically generate a new virtual server with specified resources and software environment for hosting or testing content dynamically. It automates infrastructure provisioning for content-related workflows.", + "limitations": "Does not configure application-level software or deploy content beyond OS and basic roles. Does not manage scaling or lifecycle beyond initial creation.", + "examples": [ + "Create a Linux-based web server with 4 CPU cores and 8GB RAM.", + "Provision a database server with CentOS, 2 CPUs, and 16GB RAM.", + "Create a development server with Ubuntu and 100GB storage that starts automatically." + ] + }, + "tags": [ + "server", + "virtual-machine", + "provisioning", + "cloud", + "infrastructure", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"web\",\"operatingSystem\":\"Ubuntu 22.04\",\"cpuCores\":4,\"ramGB\":8,\"storageGB\":100,\"networkConfig\":{\"publicIP\":true,\"firewallRules\":[{\"port\":80,\"protocol\":\"tcp\"}]}},", + "description": "Creates a web server running Ubuntu with 4 CPUs, 8GB RAM, 100GB disk, public IP and port 80 open." + }, + { + "inputJson": "{\"serverType\":\"database\",\"operatingSystem\":\"CentOS 8\",\"cpuCores\":2,\"ramGB\":16,\"storageGB\":200,\"autoStart\":false}", + "description": "Provisions a database server with CentOS, 2 CPU cores, 16GB RAM, 200GB storage, set to not start automatically." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Server", + "context": null + } + }, + { + "name": "content-creation.createMention", + "description": "This tool generates a formatted mention string for a user or entity to be embedded in digital content such as messages, posts, or comments. It accepts the mention target's type (user, group, or role), identifier, and optional display name, then outputs a standardized mention string or object suitable for platforms supporting mentions.", + "category": "content-creation", + "parameters": [ + { + "name": "mentionType", + "type": "string", + "description": "Type of the mention target, e.g., 'user', 'group', or 'role'", + "required": true, + "defaultValue": "" + }, + { + "name": "identifier", + "type": "string", + "description": "Unique identifier for the mention target, such as user ID or group ID", + "required": true, + "defaultValue": "" + }, + { + "name": "displayName", + "type": "string", + "description": "Optional name to display instead of default when mentioning", + "required": false, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "Target platform to format the mention for (e.g., 'Slack', 'Discord', 'MicrosoftTeams')", + "required": false, + "defaultValue": "" + }, + { + "name": "asObject", + "type": "boolean", + "description": "Whether to return the mention as a structured object rather than a formatted string", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted mention string or structured mention object depending on parameters" + }, + "aiAgent": { + "useCase": "Use this tool when generating or composing digital content that requires mentioning users, groups, or roles dynamically within messaging platforms or collaborative tools, ensuring proper mention formatting for the target platform.", + "limitations": "Cannot verify if the identifier is valid or if the target entity exists on the platform; does not send or post the mention but only generates the mention format.", + "examples": [ + "Create a mention string for user with ID 'U123456' in Slack.", + "Generate a mention object for a group with ID 'G98765' to embed in Microsoft Teams message.", + "Produce a display name mention for role 'Admin' on Discord." + ] + }, + "tags": [ + "content", + "mention", + "communication", + "platform-formatting", + "digital-content" + ], + "examples": [ + { + "inputJson": "{\"mentionType\":\"user\",\"identifier\":\"U123456\",\"displayName\":\"Alice\",\"platform\":\"Slack\",\"asObject\":false}", + "description": "Generate a Slack-formatted mention string for user Alice with ID U123456." + }, + { + "inputJson": "{\"mentionType\":\"group\",\"identifier\":\"G98765\",\"platform\":\"MicrosoftTeams\",\"asObject\":true}", + "description": "Generate a Microsoft Teams mention object for a group with ID G98765." + }, + { + "inputJson": "{\"mentionType\":\"role\",\"identifier\":\"Admin\",\"displayName\":\"Administrator\",\"platform\":\"Discord\",\"asObject\":false}", + "description": "Generate a Discord mention string for role Admin with a display name." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Mention", + "context": null + } + }, + { + "name": "content-creation.createThread", + "description": "Creates a new communication thread for digital interactions such as forums, chat rooms, or discussion boards. Accepts inputs including a title, initial message content, creator information, and optional tags. Processes this information to initialize and return a thread object with a unique thread ID, timestamps, and metadata.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title or subject of the thread to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "initialMessage", + "type": "string", + "description": "The content of the first message initiating the thread.", + "required": true, + "defaultValue": "" + }, + { + "name": "creatorId", + "type": "string", + "description": "Identifier for the user creating the thread (e.g., username or user ID).", + "required": true, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "An array of tags or keywords to categorize or label the thread.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isPrivate", + "type": "boolean", + "description": "Whether the thread is private (true) or public (false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created thread, including a unique threadId (string), title (string), creatorId (string), createdAt timestamp (ISO string), initialMessage (string), tags (array of strings), and privacy status (boolean)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to start a new communication or discussion context, such as initiating a forum topic, creating a new chat thread, or opening a conversation channel. It's useful for organizing messages under a cohesive subject and enabling subsequent user interactions within that thread.", + "limitations": "This tool does not handle posting subsequent messages in the thread or managing user permissions beyond the initial privacy flag. It also does not support multimedia content or rich formatting in the initial message.", + "examples": [ + "Create a new forum thread titled \"Project Launch Updates\" with an initial welcome message, tagged with \"project\" and \"updates\".", + "Start a private chat thread for a support ticket with the user ID and the issue description as the first message.", + "Initiate a public discussion thread titled \"Book Club April Reads\" with a short introduction message." + ] + }, + "tags": [ + "content creation", + "communication", + "thread management", + "discussion", + "forum", + "chat" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Project Launch Updates\",\"initialMessage\":\"Welcome to the project launch discussion! Share your updates here.\",\"creatorId\":\"user123\",\"tags\":[\"project\",\"updates\"],\"isPrivate\":false}", + "description": "Creating a public discussion thread for project updates." + }, + { + "inputJson": "{\"title\":\"Support Ticket 5542\",\"initialMessage\":\"User reports an issue with login.\",\"creatorId\":\"supportAgent7\",\"tags\":[],\"isPrivate\":true}", + "description": "Creating a private support chat thread for a ticket." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Thread", + "context": null + } + }, + { + "name": "content-creation.createReply", + "description": "Generates a contextually relevant and coherent reply message based on an input prompt or conversation history. Accepts a string or array of message objects representing previous dialogue, processes natural language understanding and generation, and outputs a structured reply text suitable for communication applications.", + "category": "content-creation", + "parameters": [ + { + "name": "conversationHistory", + "type": "array", + "description": "Array of message objects representing previous messages in the conversation, each with sender and content, to provide context for generating the reply.", + "required": true, + "defaultValue": "" + }, + { + "name": "replyTone", + "type": "string", + "description": "Desired tone or style of the reply, such as formal, casual, friendly, or professional, to tailor the response accordingly.", + "required": false, + "defaultValue": "\"neutral\"" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum character length for the reply to keep responses concise and within limits.", + "required": false, + "defaultValue": "500" + }, + { + "name": "includeReferences", + "type": "boolean", + "description": "Flag indicating whether to include references or citations in the reply if applicable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated reply text that is contextually relevant and appropriately styled based on given parameters." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate natural language replies in conversation or messaging systems that require coherent, context-aware responses. It helps automate and assist in communication by producing text replies based on prior messages and desired tone.", + "limitations": "Cannot guarantee perfect factual accuracy or domain-specific expert knowledge; may produce plausible but incorrect information. Not suitable for highly sensitive or legal communications without review.", + "examples": [ + "Generate a friendly reply to this customer message about a delayed order.", + "Create a concise professional email response summarizing the project update.", + "Provide a casual text message reply continuing the ongoing chat conversation." + ] + }, + "tags": [ + "content-creation", + "reply-generation", + "natural-language-processing", + "communication", + "chatbot", + "dialogue", + "response" + ], + "examples": [ + { + "inputJson": "{\"conversationHistory\":[{\"sender\":\"user\",\"content\":\"Hi, can you update me on the status of my order?\"}],\"replyTone\":\"friendly\",\"maxLength\":200,\"includeReferences\":false}", + "description": "Generate a friendly reply to a customer's query about order status." + }, + { + "inputJson": "{\"conversationHistory\":[{\"sender\":\"client\",\"content\":\"Could you please send the final report by tomorrow?\"}],\"replyTone\":\"professional\",\"maxLength\":300,\"includeReferences\":true}", + "description": "Create a professional, formal response promising delivery of a report by the requested deadline." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Reply", + "context": null + } + }, + { + "name": "content-creation.createComment", + "description": "Generates a coherent and contextually relevant comment based on provided content and optional tone and length preferences. Accepts a text input or URL reference, analyzes the content, and produces a suitable comment string for use in discussions, reviews, or social media.", + "category": "content-creation", + "parameters": [ + { + "name": "contentText", + "type": "string", + "description": "The main text content the comment should relate to or respond to.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentUrl", + "type": "string", + "description": "Optional URL of the content source for context; if provided, the tool may fetch or consider this additional information.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the comment such as friendly, professional, casual, or critical.", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "length", + "type": "string", + "description": "Preferred length of the comment; valid options are short, medium, and long.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "includeQuestion", + "type": "boolean", + "description": "Whether to include a question in the comment to encourage engagement.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated comment text suitable for posting or further processing." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate natural language comments related to given content, such as for social media posts, article discussions, or review replies. It aids in producing human-like, context-aware commentary that aligns with the specified tone and length preferences.", + "limitations": "The tool cannot verify real-time external content or guarantee factual correctness. It assumes content relevance based on input text and may not handle ambiguous or incomplete contexts well.", + "examples": [ + "Generate a friendly, medium-length comment responding to a product review text.", + "Create a short, casual comment that encourages discussion about a blog post.", + "Make a professional, long comment including a question based on the summary of an article." + ] + }, + "tags": [ + "content-creation", + "comment-generation", + "social-media", + "natural-language", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"contentText\":\"I recently tried the new smartphone model and found its battery life disappointing.\",\"tone\":\"critical\",\"length\":\"medium\",\"includeQuestion\":true}", + "description": "Generate a critical comment of medium length that includes a question responding to user feedback about a smartphone battery." + }, + { + "inputJson": "{\"contentText\":\"Check out my latest blog post about sustainable gardening techniques.\",\"tone\":\"friendly\",\"length\":\"short\",\"includeQuestion\":false}", + "description": "Create a short and friendly comment to promote engagement on a blog post about gardening." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Comment", + "context": null + } + }, + { + "name": "content-creation.createNotification", + "description": "Creates a structured notification message based on input parameters such as title, message body, notification type, and target audience. Processes these inputs to format a consistent notification object that can be used for sending in-app alerts, emails, or push notifications.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The headline or title of the notification, briefly summarizing its purpose.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "Detailed content of the notification providing the main information to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "notificationType", + "type": "string", + "description": "Category of notification (e.g., info, warning, success, error) to specify its intent and appearance.", + "required": true, + "defaultValue": "info" + }, + { + "name": "targetAudience", + "type": "array", + "description": "List of recipient identifiers (user IDs, roles, or groups) for whom this notification is intended.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "channel", + "type": "string", + "description": "Delivery method for the notification such as email, push, or in-app. Defaults to in-app.", + "required": false, + "defaultValue": "in-app" + }, + { + "name": "priority", + "type": "string", + "description": "Defines the urgency level of the notification (e.g., low, normal, high).", + "required": false, + "defaultValue": "normal" + }, + { + "name": "sendTime", + "type": "string", + "description": "Optional ISO 8601 timestamp when the notification should be sent; if omitted, send immediately.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the finalized notification with metadata including ID, formatted content, target audience, channel, priority, and scheduled send time." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate user-facing notifications from dynamic content or system events, ensuring consistent structure and delivery information for different channels and audiences. It is ideal for creating alerts, reminders, or informational messages in apps or platforms.", + "limitations": "This tool does not handle the actual sending of notifications, user preferences management, or real-time delivery tracking.", + "examples": [ + "Create a warning notification about upcoming maintenance targeted to admin users via email.", + "Generate a promotional in-app notification to all users highlighting a new feature.", + "Schedule a high priority error alert to be sent immediately to support staff via push notification." + ] + }, + "tags": [ + "notification", + "content-creation", + "messaging", + "alerts", + "communication" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Server Maintenance\",\"messageBody\":\"Scheduled maintenance will occur at 2 AM UTC.\",\"notificationType\":\"warning\",\"targetAudience\":[\"admin\",\"devops\"],\"channel\":\"email\",\"priority\":\"high\",\"sendTime\":\"2024-06-30T01:45:00Z\"}", + "description": "Create a high-priority warning email notification about server maintenance targeting admin and devops teams." + }, + { + "inputJson": "{\"title\":\"Welcome!\",\"messageBody\":\"Thank you for joining our platform.\",\"notificationType\":\"info\",\"targetAudience\":[\"allUsers\"],\"channel\":\"in-app\"}", + "description": "Create a general informational in-app notification welcoming all users." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Notification", + "context": null + } + }, + { + "name": "content-creation.createChannel", + "description": "Creates a new communication channel within a digital content platform or system. Accepts parameters like channel name, description, privacy settings, and initial members. Processes inputs to set up and configure the channel, then returns a summary of the created channel including its unique identifier and access info.", + "category": "content-creation", + "parameters": [ + { + "name": "channelName", + "type": "string", + "description": "The name to assign to the new communication channel.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A short description explaining the purpose of the channel.", + "required": false, + "defaultValue": "" + }, + { + "name": "isPrivate", + "type": "boolean", + "description": "Determines if the channel is private (true) or public (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "initialMembers", + "type": "array", + "description": "An array of user IDs to be added as initial members of the channel.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "topic", + "type": "string", + "description": "Optional topic or subject the channel focuses on.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing details of the newly created channel, including channel ID, name, description, privacy status, member count, and creation timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically establish new communication channels for teams, content groups, or communities within a platform. It streamlines onboarding by configuring channel metadata, membership, and access settings automatically.", + "limitations": "This tool cannot send messages within the channel or manage channel content beyond initial creation. It also does not handle permissions beyond the basic public/private distinction.", + "examples": [ + "Create a private channel named 'Project X' with the initial team members.", + "Set up a public discussion channel about 'AI Research' with a descriptive topic.", + "Make a general announcements channel that is public and has no initial members." + ] + }, + "tags": [ + "content creation", + "communication", + "channel management", + "collaboration", + "automation" + ], + "examples": [ + { + "inputJson": "{\"channelName\":\"Project Phoenix\",\"description\":\"Channel for Project Phoenix team coordination.\",\"isPrivate\":true,\"initialMembers\":[\"user123\",\"user456\"],\"topic\":\"Development updates\"}", + "description": "Creates a private channel with initial members and topic for project coordination." + }, + { + "inputJson": "{\"channelName\":\"General Announcements\",\"description\":\"Company-wide announcements.\",\"isPrivate\":false,\"initialMembers\":[],\"topic\":\"Company news\"}", + "description": "Sets up a public announcements channel without initial members." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Channel", + "context": null + } + }, + { + "name": "content-creation.createMessage", + "description": "Generates a formatted message based on input parameters such as recipient, subject, body content, tone, and message type. Accepts plain text or structured inputs, processes them to create a coherent message suitable for email, SMS, or chat, and outputs the finalized message as a string.", + "category": "content-creation", + "parameters": [ + { + "name": "recipient", + "type": "string", + "description": "The primary recipient of the message, such as an email address or phone number.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject or headline of the message, applicable mainly for emails.", + "required": false, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content or body text of the message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the message, e.g., formal, casual, friendly, urgent, persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "messageType", + "type": "string", + "description": "The type of message to create, such as 'email', 'sms', or 'chat'. Determines formatting.", + "required": true, + "defaultValue": "email" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachment URLs or filenames to reference within the message, if applicable.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "signature", + "type": "string", + "description": "A signature or sign-off text to append at the end of the message.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete formatted message string and metadata such as character count and message type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to compose a professional or casual message for communication via email, SMS, or chat. It helps generate coherent messages based on structured inputs, adjusting tone and formatting to fit the delivery method and context.", + "limitations": "This tool does not send messages or validate contact information. It does not generate responses or handle complex conversational flows independently.", + "examples": [ + "Create a formal email to a client inviting them to a meeting.", + "Generate a short SMS message notifying a user about a delivery update.", + "Compose a friendly chat message to welcome a new team member." + ] + }, + "tags": [ + "content-creation", + "message-generation", + "communication", + "email", + "sms", + "chat", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"recipient\":\"jane.doe@example.com\",\"subject\":\"Meeting Invitation\",\"body\":\"Dear Jane, I would like to invite you to a project meeting scheduled for Monday at 10 am.\",\"tone\":\"formal\",\"messageType\":\"email\",\"attachments\":[],\"signature\":\"Best regards, John\"}", + "description": "Generate a formal email message inviting a recipient to a meeting." + }, + { + "inputJson": "{\"recipient\":\"+1234567890\",\"body\":\"Your package has been shipped and will arrive tomorrow.\",\"tone\":\"informal\",\"messageType\":\"sms\",\"attachments\":[],\"signature\":\"\"}", + "description": "Generate a brief SMS notification about a delivery." + }, + { + "inputJson": "{\"recipient\":\"team_channel\",\"body\":\"Welcome to the team, Alex! Looking forward to working together.\",\"tone\":\"friendly\",\"messageType\":\"chat\",\"attachments\":[],\"signature\":\"\"}", + "description": "Compose a friendly chat message welcoming a new team member." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Message", + "context": null + } + }, + { + "name": "content-creation.createCertificate", + "description": "Generates a digitally signed certificate document based on user-provided details such as recipient name, issuer, date, and certificate type. It processes the inputs to create a formatted certificate in PDF or image format, optionally embedding a QR code linking to verification data, and returns the completed certificate file data and metadata.", + "category": "content-creation", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Full name of the certificate recipient to appear on the certificate.", + "required": true, + "defaultValue": "" + }, + { + "name": "issuerName", + "type": "string", + "description": "Name of the organization or individual issuing the certificate.", + "required": true, + "defaultValue": "" + }, + { + "name": "certificateType", + "type": "string", + "description": "Type or title of the certificate (e.g., 'Completion', 'Achievement').", + "required": true, + "defaultValue": "" + }, + { + "name": "issueDate", + "type": "string", + "description": "Date when the certificate is issued, in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "expiryDate", + "type": "string", + "description": "Optional expiration date for the certificate, in ISO 8601 format.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeQRCode", + "type": "boolean", + "description": "Whether to embed a QR code that links to certificate verification information.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output file format of the certificate, either 'PDF' or 'PNG'.", + "required": false, + "defaultValue": "PDF" + }, + { + "name": "backgroundTemplate", + "type": "string", + "description": "Optional identifier or URL referencing a background template to use for styling the certificate.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the certificate content encoded as a base64 string, the MIME type, and metadata such as issue date, expiry date, and verification link if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create official-looking certificate documents for achievements, completions, or recognitions from provided participant and issuer information. It is suitable for generating digital certificates with optional verification QR codes for education, training programs, or events.", + "limitations": "This tool does not perform cryptographic signature validations or store certificates; it only generates the visual certificate file. It does not issue certificates on blockchain or securely manage certificate revocation.", + "examples": [ + "Create a certificate of completion for a student named John Doe issued by ABC Training on 2024-05-01.", + "Generate an achievement certificate for Jane Smith with a QR code linking to verification data.", + "Produce a PDF certificate with a custom background for employee of the month." + ] + }, + "tags": [ + "certificate", + "content-creation", + "document-generation", + "digital-certificate", + "PDF", + "image-generation", + "verification" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"John Doe\",\"issuerName\":\"ABC Training\",\"certificateType\":\"Completion\",\"issueDate\":\"2024-05-01\",\"includeQRCode\":true,\"outputFormat\":\"PDF\"}", + "description": "Create a PDF completion certificate for John Doe with a QR code for verification." + }, + { + "inputJson": "{\"recipientName\":\"Jane Smith\",\"issuerName\":\"XYZ Corp\",\"certificateType\":\"Achievement\",\"issueDate\":\"2024-06-10\",\"expiryDate\":\"2026-06-10\",\"includeQRCode\":false,\"outputFormat\":\"PNG\",\"backgroundTemplate\":\"corporateTemplate1\"}", + "description": "Generate a PNG achievement certificate with a corporate background and expiration date for Jane Smith." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Certificate", + "context": null + } + }, + { + "name": "content-creation.createAlert", + "description": "Generates a structured security alert message based on input parameters specifying the alert type, severity, affected systems, and message details. Processes the inputs to construct a standardized alert notification object that can be used for internal tracking, notifications, or incident response workflows.", + "category": "content-creation", + "parameters": [ + { + "name": "alertType", + "type": "string", + "description": "The category or type of the alert, e.g., 'Intrusion', 'Malware', or 'Unauthorized Access'.", + "required": true, + "defaultValue": "" + }, + { + "name": "severity", + "type": "string", + "description": "The severity level of the alert, such as 'Low', 'Medium', 'High', or 'Critical'.", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "A list of system names or IDs that are affected by this alert.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "message", + "type": "string", + "description": "A detailed descriptive message explaining the alert and relevant context.", + "required": true, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "The ISO 8601 formatted date-time string when the alert was generated. Defaults to current time if empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "sourceIp", + "type": "string", + "description": "Optional IP address related to the alert source, such as an attacker IP or affected system IP.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalData", + "type": "object", + "description": "Optional object containing any extra relevant data as key-value pairs to include in the alert.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured alert object including all input details, a unique alert ID, and formatted timestamp for tracking and notification." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a formal and structured security alert message from raw event data or summarized threat intelligence to inform monitoring teams or trigger incident response. It is particularly useful for generating standardized alerts for varied security domains.", + "limitations": "This tool does not perform any automatic threat analysis or validation of the alert data; it only constructs the alert object from given inputs. It also does not send or distribute the alert, which requires separate integration.", + "examples": [ + "Create a high severity alert for an intrusion detected on multiple servers, including details about the attack and affected IPs.", + "Generate a malware alert with medium severity targeting specific systems with a detailed description.", + "Create a critical unauthorized access alert containing source IP and custom metadata for incident tracking." + ] + }, + "tags": [ + "security", + "alert", + "notification", + "incident-response", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"alertType\":\"Intrusion\",\"severity\":\"High\",\"affectedSystems\":[\"server01\",\"server02\"],\"message\":\"Multiple failed login attempts detected indicating potential brute force attack.\",\"timestamp\":\"2024-06-01T14:30:00Z\",\"sourceIp\":\"192.168.1.100\",\"additionalData\":{\"attackVector\":\"ssh\",\"detectedBy\":\"IDS\"}}", + "description": "Generate a high severity intrusion alert for servers 'server01' and 'server02' with source IP and extra metadata." + }, + { + "inputJson": "{\"alertType\":\"Malware\",\"severity\":\"Medium\",\"affectedSystems\":[\"workstation05\"],\"message\":\"Malware signature detected in email attachment.\",\"timestamp\":\"2024-06-01T09:45:00Z\"}", + "description": "Create a medium severity malware alert for a single affected workstation without source IP or additional data." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Alert", + "context": null + } + }, + { + "name": "content-creation.createKey", + "description": "Generates a cryptographic key for content encryption or signing. Accepts parameters defining key type (e.g., symmetric or asymmetric), algorithm, key size, and optional passphrase. Outputs the generated key material encoded in base64 along with metadata about the key.", + "category": "content-creation", + "parameters": [ + { + "name": "keyType", + "type": "string", + "description": "Type of key to generate, either 'symmetric' or 'asymmetric'.", + "required": true, + "defaultValue": "" + }, + { + "name": "algorithm", + "type": "string", + "description": "Cryptographic algorithm to use (e.g., AES, RSA, ECDSA).", + "required": true, + "defaultValue": "" + }, + { + "name": "keySize", + "type": "number", + "description": "Size of the key in bits, depends on algorithm (e.g., 256 for AES, 2048 for RSA).", + "required": false, + "defaultValue": "256" + }, + { + "name": "passphrase", + "type": "string", + "description": "Optional passphrase to encrypt the generated key material.", + "required": false, + "defaultValue": "" + }, + { + "name": "exportFormat", + "type": "string", + "description": "Format to export the key material, e.g., 'base64', 'hex', or 'pem'.", + "required": false, + "defaultValue": "base64" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated key material as a string and metadata including algorithm, key size, key type, and export format." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to programmatically generate cryptographic keys for securing digital content via encryption, signing, or other cryptographic operations. It is suitable for creating keys for symmetric encryption like AES or asymmetric keys like RSA or ECDSA, with optional passphrase protection.", + "limitations": "This tool does not perform key storage or key management beyond generation and export. It does not manage key lifecycle or integrate with hardware security modules or external key stores.", + "examples": [ + "Generate a 256-bit AES symmetric key for encrypting content.", + "Create a 2048-bit RSA key pair for digital signing.", + "Generate an ECDSA key with a passphrase and export it in PEM format." + ] + }, + "tags": [ + "security", + "key-generation", + "cryptography", + "content-protection", + "encryption", + "digital-signature" + ], + "examples": [ + { + "inputJson": "{\"keyType\":\"symmetric\",\"algorithm\":\"AES\",\"keySize\":256,\"exportFormat\":\"base64\"}", + "description": "Generate a 256-bit AES symmetric key with base64 encoding." + }, + { + "inputJson": "{\"keyType\":\"asymmetric\",\"algorithm\":\"RSA\",\"keySize\":2048,\"exportFormat\":\"pem\"}", + "description": "Generate a 2048-bit RSA key pair and export in PEM format." + }, + { + "inputJson": "{\"keyType\":\"asymmetric\",\"algorithm\":\"ECDSA\",\"keySize\":256,\"passphrase\":\"mySecret123\",\"exportFormat\":\"pem\"}", + "description": "Generate a 256-bit ECDSA key encrypted with a passphrase and export as PEM." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Key", + "context": null + } + }, + { + "name": "content-creation.createCredential", + "description": "Generates a digital security credential based on specified parameters including credential type, identity details, issuance and expiration dates, and optional metadata. Processes input to produce a signed, verifiable credential JSON object that can be used for authentication or authorization purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "credentialType", + "type": "string", + "description": "Type of the credential to be created, e.g., 'VerifiableCredential', 'AccessToken'.", + "required": true, + "defaultValue": "" + }, + { + "name": "identityData", + "type": "object", + "description": "Object containing identity attributes such as name, id, or email required for the credential subject.", + "required": true, + "defaultValue": "" + }, + { + "name": "issuer", + "type": "string", + "description": "Identifier or DID of the credential issuer creating the credential.", + "required": true, + "defaultValue": "" + }, + { + "name": "issuedAt", + "type": "string", + "description": "ISO 8601 formatted issuance date of the credential. If not provided, current date-time is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "expirationDate", + "type": "string", + "description": "Optional ISO 8601 formatted expiration date, after which the credential is no longer valid.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional metadata fields to include in the credential.", + "required": false, + "defaultValue": "" + }, + { + "name": "signingKey", + "type": "string", + "description": "Private key or key reference used to cryptographically sign the credential ensuring authenticity.", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the created credential, including all input data, digital signature, and metadata compliant with credential standards (e.g., W3C Verifiable Credentials)." + }, + "aiAgent": { + "useCase": "Use this tool when an application or agent needs to programmatically generate security credentials for identities, such as issuing verifiable credentials for user authentication, access tokens, or badges. It helps automate creation of standardized signed credentials with metadata and expiry.", + "limitations": "This tool does not handle key management or secure storage of signing keys and assumes valid keys are provided. It does not verify identity data correctness nor handle credential revocation. External infrastructure needed for full lifecycle management.", + "examples": [ + "Create a verifiable credential for a user with name and email, issued by my organization, expiring in one year.", + "Generate an access token credential for API authorization with specific scope metadata.", + "Issue a badge credential for event attendance with issuance time but no expiration." + ] + }, + "tags": [ + "content-creation", + "security", + "credential", + "digital-identity", + "authentication", + "authorization" + ], + "examples": [ + { + "inputJson": "{\"credentialType\":\"VerifiableCredential\",\"identityData\":{\"name\":\"Alice Doe\",\"email\":\"alice@example.com\"},\"issuer\":\"did:example:12345\",\"issuedAt\":\"2024-06-01T12:00:00Z\",\"expirationDate\":\"2025-06-01T12:00:00Z\",\"metadata\":{\"role\":\"member\"},\"signingKey\":\"-----BEGIN PRIVATE KEY-----\\nMIIEv...\"}", + "description": "Create a verifiable credential for Alice with email and role member, issued on June 1, 2024, valid for one year." + }, + { + "inputJson": "{\"credentialType\":\"AccessToken\",\"identityData\":{\"userId\":\"user-7890\"},\"issuer\":\"did:example:issuer456\",\"signingKey\":\"privkey123\"}", + "description": "Generate an access token credential for user ID 'user-7890' without expiration date." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Credential", + "context": null + } + }, + { + "name": "content-creation.createSecret", + "description": "Generates a secure secret string suitable for use as passwords, API keys, or cryptographic tokens. Accepts parameters defining secret length, character types to include, and whether to use symbols, digits, uppercase, and lowercase letters. Outputs the generated secret string ready for immediate use in secure applications.", + "category": "content-creation", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Length of the secret string to generate, typically between 8 and 128 characters.", + "required": true, + "defaultValue": "32" + }, + { + "name": "includeUppercase", + "type": "boolean", + "description": "Whether to include uppercase alphabetic characters in the secret.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeLowercase", + "type": "boolean", + "description": "Whether to include lowercase alphabetic characters in the secret.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeDigits", + "type": "boolean", + "description": "Whether to include numeric digits in the secret.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSymbols", + "type": "boolean", + "description": "Whether to include symbol characters (e.g., !@#$%^&*) in the secret.", + "required": false, + "defaultValue": "true" + }, + { + "name": "excludeSimilarCharacters", + "type": "boolean", + "description": "Exclude characters that can be visually confused (like 0 and O, 1 and l).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated secret string under the key 'secret'." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to generate strong, customized secret strings for securing user accounts, API authentication, encryption keys, or other security-sensitive applications requiring random yet controlled character sets. It helps maintain best practices by enabling configurable complexity parameters to conform with password policies.", + "limitations": "Does not store or manage secrets after generation; it only produces secret strings. The tool cannot assess or guarantee the appropriateness of the secret for all security policies or environments.", + "examples": [ + "Generate a 64-character API key including uppercase, lowercase, digits, and symbols, excluding similar characters.", + "Create a short 12-character password that uses only uppercase and digits without symbols.", + "Generate a 128-character cryptographic token including all character types for maximum entropy." + ] + }, + "tags": [ + "security", + "secret", + "password", + "token", + "key-generation", + "random", + "encryption", + "crypto" + ], + "examples": [ + { + "inputJson": "{\"length\":64,\"includeUppercase\":true,\"includeLowercase\":true,\"includeDigits\":true,\"includeSymbols\":true,\"excludeSimilarCharacters\":true}", + "description": "Generate a 64-character secret with all character sets excluding ambiguous chars." + }, + { + "inputJson": "{\"length\":12,\"includeUppercase\":true,\"includeLowercase\":false,\"includeDigits\":true,\"includeSymbols\":false,\"excludeSimilarCharacters\":true}", + "description": "Generate a 12-character secret with uppercase letters and digits only, no symbols." + }, + { + "inputJson": "{\"length\":128,\"includeUppercase\":true,\"includeLowercase\":true,\"includeDigits\":true,\"includeSymbols\":true,\"excludeSimilarCharacters\":false}", + "description": "Generate a 128-character secret using all character types including similar looking characters." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Secret", + "context": null + } + }, + { + "name": "content-creation.createThreat", + "description": "Generates a detailed threat scenario description based on specified parameters such as threat type, target environment, and potential impact. Accepts inputs on threat characteristics and outputs a structured threat report useful for security analysis and risk assessment.", + "category": "content-creation", + "parameters": [ + { + "name": "threatType", + "type": "string", + "description": "Type of threat to describe, e.g., phishing, malware, DDoS, insider threat.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetEnvironment", + "type": "string", + "description": "The environment or system targeted by the threat, e.g., enterprise network, cloud service, IoT device.", + "required": true, + "defaultValue": "" + }, + { + "name": "potentialImpact", + "type": "string", + "description": "Expected impact of the threat if successful, e.g., data theft, service disruption, financial loss.", + "required": false, + "defaultValue": "" + }, + { + "name": "threatActor", + "type": "string", + "description": "Description of the attacker or threat actor type, e.g., criminal group, hacktivist, insider.", + "required": false, + "defaultValue": "" + }, + { + "name": "attackVector", + "type": "string", + "description": "Means or method through which the threat is delivered or exploited, e.g., email, exploit kit, social engineering.", + "required": false, + "defaultValue": "" + }, + { + "name": "urgencyLevel", + "type": "string", + "description": "Estimated urgency or immediacy of the threat, e.g., low, medium, high.", + "required": false, + "defaultValue": "medium" + } + ], + "returns": { + "type": "object", + "description": "Structured threat scenario report including a summary, attack details, potential impacts, and mitigation suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to construct realistic or hypothetical security threat scenarios for simulation, training, or risk assessment purposes. It helps generate detailed, coherent threat descriptions based on specified parameters to assist security analysis or preparedness planning.", + "limitations": "This tool does not perform actual threat detection or analysis on real-time data; it generates descriptive scenarios only based on input parameters. It cannot guarantee precise threat mitigation strategies or real-world accuracy beyond general descriptions.", + "examples": [ + "Generate a detailed phishing threat targeting corporate email environments with potential data loss impact.", + "Create a DDoS threat scenario affecting cloud services with high urgency.", + "Describe an insider threat with social engineering attack vector causing financial fraud." + ] + }, + "tags": [ + "content-creation", + "security", + "threat modeling", + "risk assessment", + "scenario generation" + ], + "examples": [ + { + "inputJson": "{\"threatType\":\"phishing\",\"targetEnvironment\":\"corporate email system\",\"potentialImpact\":\"data theft\",\"threatActor\":\"criminal group\",\"attackVector\":\"email link\",\"urgencyLevel\":\"high\"}", + "description": "Generate a high-urgency phishing threat scenario targeting corporate email that may lead to data theft." + }, + { + "inputJson": "{\"threatType\":\"DDoS\",\"targetEnvironment\":\"cloud service platform\",\"potentialImpact\":\"service disruption\",\"urgencyLevel\":\"medium\"}", + "description": "Create a medium urgency DDoS threat scenario affecting a cloud service platform with possible disruption." + }, + { + "inputJson": "{\"threatType\":\"insider threat\",\"targetEnvironment\":\"financial systems\",\"potentialImpact\":\"financial fraud\",\"threatActor\":\"disgruntled employee\",\"attackVector\":\"social engineering\",\"urgencyLevel\":\"low\"}", + "description": "Describe a low urgency insider threat scenario involving social engineering causing financial fraud." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Threat", + "context": null + } + }, + { + "name": "content-creation.createIncident", + "description": "Creates a detailed security incident report based on provided information such as incident type, description, impact, affected systems, and timestamps. Processes input data to generate a structured incident record suitable for tracking and further analysis.", + "category": "content-creation", + "parameters": [ + { + "name": "incidentType", + "type": "string", + "description": "The category or type of the security incident (e.g., phishing, malware, data breach).", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed description of the incident, including observed behaviors and context.", + "required": true, + "defaultValue": "" + }, + { + "name": "impactSeverity", + "type": "string", + "description": "Severity level of the incident impact (e.g., low, medium, high, critical).", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "List of system names, IP addresses, or components affected by the incident.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "detectedTime", + "type": "string", + "description": "Timestamp when the incident was detected, in ISO 8601 format.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportedBy", + "type": "string", + "description": "Name or identifier of the person or system reporting the incident.", + "required": false, + "defaultValue": "" + }, + { + "name": "incidentStatus", + "type": "string", + "description": "Current status of the incident (e.g., open, in progress, resolved).", + "required": false, + "defaultValue": "open" + } + ], + "returns": { + "type": "object", + "description": "A structured incident record including a unique incident ID, summary, timestamps, and all provided details for tracking and management." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a comprehensive and structured security incident report based on raw incident details provided by users or monitoring systems. It helps standardize incident documentation to facilitate tracking, prioritization, and response coordination.", + "limitations": "This tool does not automatically detect or analyze incidents; it only formats and structures incident data that must be supplied as input. It also does not update or close existing incidents.", + "examples": [ + "Create a new phishing incident with high impact affecting email servers.", + "Report a malware infection detected on multiple workstations with medium severity.", + "Log a data breach with detailed description and affected systems list." + ] + }, + "tags": [ + "incident", + "security", + "reporting", + "creation", + "content-creation", + "security-incident" + ], + "examples": [ + { + "inputJson": "{\"incidentType\":\"Phishing\",\"description\":\"Multiple users reported suspicious emails requesting credentials.\",\"impactSeverity\":\"high\",\"affectedSystems\":[\"email-server-01\",\"user-mailbox-123\"],\"detectedTime\":\"2024-06-15T10:30:00Z\",\"reportedBy\":\"security-team\",\"incidentStatus\":\"open\"}", + "description": "Reporting a high severity phishing incident affecting email infrastructure." + }, + { + "inputJson": "{\"incidentType\":\"Malware\",\"description\":\"Detected ransomware on several workstation endpoints.\",\"impactSeverity\":\"critical\",\"affectedSystems\":[\"workstation-101\",\"workstation-102\",\"workstation-103\"],\"detectedTime\":\"2024-06-14T22:15:00Z\",\"reportedBy\":\"endpoint-protection\",\"incidentStatus\":\"in progress\"}", + "description": "Logging a critical ransomware incident detected by security software." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Incident", + "context": null + } + }, + { + "name": "content-creation.createVulnerability", + "description": "Generates a detailed vulnerability report based on provided technical inputs, including vulnerability type, affected software versions, severity, description, and remediation steps. Outputs a structured vulnerability report suitable for documentation or security advisories.", + "category": "content-creation", + "parameters": [ + { + "name": "vulnerabilityName", + "type": "string", + "description": "The concise name or identifier of the vulnerability (e.g., SQL Injection).", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed explanation of the vulnerability, including how it can be exploited.", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedSoftware", + "type": "array", + "description": "List of affected software products and versions (each entry is a string, e.g., 'WordPress 5.8').", + "required": true, + "defaultValue": "[]" + }, + { + "name": "severity", + "type": "string", + "description": "The severity classification (e.g., Low, Medium, High, Critical).", + "required": true, + "defaultValue": "Medium" + }, + { + "name": "cvssScore", + "type": "number", + "description": "The CVSS (Common Vulnerability Scoring System) score as a numeric value (0.0 to 10.0).", + "required": false, + "defaultValue": "" + }, + { + "name": "cweId", + "type": "string", + "description": "The Common Weakness Enumeration identifier related to the vulnerability (e.g., CWE-79).", + "required": false, + "defaultValue": "" + }, + { + "name": "remediationSteps", + "type": "string", + "description": "Recommended remediation or mitigation measures to address the vulnerability.", + "required": true, + "defaultValue": "" + }, + { + "name": "disclosureDate", + "type": "string", + "description": "Date when the vulnerability was first disclosed (ISO format, e.g., 2023-11-15).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured vulnerability report including all provided details and formatted fields for easy integration into security documentation systems." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate formal vulnerability reports from technical inputs, such as summarizing new security flaws, preparing advisories, or documenting findings consistently for developers and security teams. It standardizes vulnerability information into a coherent report format.", + "limitations": "This tool does not discover or detect vulnerabilities automatically; it requires accurate input details. It also does not validate CVSS scores or CWE identifiers but formats given data into a report.", + "examples": [ + "Create a vulnerability report for a Cross-Site Scripting (XSS) flaw detected in web app versions 3.1 to 3.5.", + "Generate a detailed description and remediation steps for a buffer overflow vulnerability found in a networking library.", + "Produce a vulnerability advisory for a critical SQL Injection issue affecting multiple CMS platforms." + ] + }, + "tags": [ + "content-creation", + "security", + "vulnerability", + "reporting", + "documentation", + "remediation" + ], + "examples": [ + { + "inputJson": "{\"vulnerabilityName\":\"SQL Injection\",\"description\":\"Allows attackers to execute arbitrary SQL commands via input fields without proper sanitization.\",\"affectedSoftware\":[\"CMS v2.3\",\"WebApp v1.0 to v1.4\"],\"severity\":\"Critical\",\"cvssScore\":9.8,\"cweId\":\"CWE-89\",\"remediationSteps\":\"Implement parameterized queries and input validation.\",\"disclosureDate\":\"2024-05-10\"}", + "description": "Generate a vulnerability report for a critical SQL Injection issue on specific software versions." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Vulnerability", + "context": null + } + }, + { + "name": "content-creation.createRisk", + "description": "Generates a detailed risk report based on provided project or system information. Accepts inputs like risk type, description, likelihood, impact, affected components, and mitigation strategies. Processes these to create a structured risk assessment output, including risk severity and suggested actions.", + "category": "content-creation", + "parameters": [ + { + "name": "riskType", + "type": "string", + "description": "Category of the risk such as security, operational, financial, or compliance.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed description of the identified risk and its context.", + "required": true, + "defaultValue": "" + }, + { + "name": "likelihood", + "type": "string", + "description": "Estimated probability of the risk occurring (e.g., low, medium, high).", + "required": true, + "defaultValue": "" + }, + { + "name": "impact", + "type": "string", + "description": "Potential impact level if the risk occurs (e.g., low, medium, high).", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedComponents", + "type": "array", + "description": "List of affected systems, processes, or business units.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "mitigationStrategies", + "type": "array", + "description": "Proposed strategies or actions to mitigate the risk.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "discoveryDate", + "type": "string", + "description": "Date the risk was identified in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured risk object including severity score, risk summary, and mitigation plan." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to create formal risk assessments from raw or summarized inputs about potential issues in projects, systems, or processes. It helps generate clear risk profiles with severity evaluation and mitigation suggestions to support risk management decisions.", + "limitations": "This tool does not perform real-time risk detection or dynamic threat analysis. It relies on input accuracy and does not replace expert risk evaluation or domain-specific risk modeling.", + "examples": [ + "Create a security risk report for the new authentication system with high likelihood and medium impact.", + "Assess operational risk for the supply chain process with specified mitigation strategies.", + "Generate a compliance risk entry for missing regulatory documentation with low likelihood but high impact." + ] + }, + "tags": [ + "content-creation", + "risk-management", + "security", + "project-management", + "assessment", + "mitigation" + ], + "examples": [ + { + "inputJson": "{\"riskType\":\"security\",\"description\":\"Unauthorized access due to weak authentication controls.\",\"likelihood\":\"high\",\"impact\":\"high\",\"affectedComponents\":[\"Authentication System\",\"User Database\"],\"mitigationStrategies\":[\"Implement multi-factor authentication\",\"Regular access reviews\"],\"discoveryDate\":\"2024-06-15\"}", + "description": "Create a detailed security risk report concerning authentication vulnerabilities with mitigation steps." + }, + { + "inputJson": "{\"riskType\":\"operational\",\"description\":\"Potential delay in supply chain delivery due to vendor disruptions.\",\"likelihood\":\"medium\",\"impact\":\"medium\",\"affectedComponents\":[\"Supply Chain\"],\"mitigationStrategies\":[\"Establish backup vendors\",\"Increase inventory buffer\"],\"discoveryDate\":\"2024-06-10\"}", + "description": "Generate an operational risk assessment for supply chain delays and propose mitigation." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Risk", + "context": null + } + }, + { + "name": "content-creation.createBudget", + "description": "Creates a detailed business budget document from given inputs including revenue streams, fixed and variable costs, and financial goals. Processes the inputs to calculate total income, expenses, net profit, and provides a structured budget overview as output.", + "category": "content-creation", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the project or business for which the budget is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "The currency code (e.g., USD, EUR) to format monetary values.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "timePeriod", + "type": "string", + "description": "The time period the budget covers, such as a month, quarter, or year.", + "required": true, + "defaultValue": "" + }, + { + "name": "revenueStreams", + "type": "array", + "description": "An array of objects each containing name and amount representing sources of income.", + "required": true, + "defaultValue": "" + }, + { + "name": "fixedCosts", + "type": "array", + "description": "An array of objects representing fixed costs with name and amount properties.", + "required": true, + "defaultValue": "" + }, + { + "name": "variableCosts", + "type": "array", + "description": "An array of objects representing variable costs with name and estimated amount properties.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "financialGoals", + "type": "array", + "description": "Optional array of financial goals or targets to highlight in the budget report.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured budget summary including total revenue, total fixed and variable costs, net profit, breakdowns, and notes on financial goals." + }, + "aiAgent": { + "useCase": "Use this tool when generating comprehensive business budgets from raw income and expense data. It helps produce clear financial reports for planning and analysis, supporting decisions with precise profit calculations and goal tracking. Ideal for startups, project planning, and financial reporting.", + "limitations": "Does not perform advanced financial forecasting or integrate real-time data feeds. It relies on accurate input data and does not handle tax calculations or investment analysis.", + "examples": [ + "Create a monthly budget for a software startup with fixed office rent, variable cloud service costs, and multiple revenue streams.", + "Generate a quarterly budget report for a marketing project including expected sales and promotional expenses.", + "Build an annual budget outlining revenue goals and corresponding fixed and variable operational costs for a small business." + ] + }, + "tags": [ + "content-creation", + "budget", + "business", + "finance", + "reporting", + "planning" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"EcoFriendly Startup\",\"currency\":\"USD\",\"timePeriod\":\"2024 Q2\",\"revenueStreams\":[{\"name\":\"Product Sales\",\"amount\":50000},{\"name\":\"Consulting Services\",\"amount\":15000}],\"fixedCosts\":[{\"name\":\"Office Rent\",\"amount\":7000},{\"name\":\"Salaries\",\"amount\":25000}],\"variableCosts\":[{\"name\":\"Marketing\",\"amount\":5000},{\"name\":\"Cloud Services\",\"amount\":2000}],\"financialGoals\":[\"Achieve 20% profit margin\"]}", + "description": "Creates a quarterly budget for a startup including revenue, fixed and variable costs, and financial goals." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Budget", + "context": null + } + }, + { + "name": "content-creation.createForecast", + "description": "Generates a business forecast based on historical data and specified parameters. Accepts input data including time series sales or revenue figures, optional external factors, and forecasting horizon. Applies statistical or machine learning models to project future business metrics, and outputs a structured forecast with point estimates and confidence intervals.", + "category": "content-creation", + "parameters": [ + { + "name": "historicalData", + "type": "array", + "description": "Array of historical data points, each with timestamp and value, to use as input for forecasting.", + "required": true, + "defaultValue": "" + }, + { + "name": "forecastHorizon", + "type": "number", + "description": "Number of future periods (e.g., days, weeks, months) to forecast.", + "required": true, + "defaultValue": "12" + }, + { + "name": "timeInterval", + "type": "string", + "description": "Time interval for the data points and forecast (e.g., daily, weekly, monthly).", + "required": true, + "defaultValue": "monthly" + }, + { + "name": "modelType", + "type": "string", + "description": "Type of forecasting model to use, such as 'ARIMA', 'ExponentialSmoothing', or 'Prophet'.", + "required": false, + "defaultValue": "Prophet" + }, + { + "name": "externalFactors", + "type": "object", + "description": "Optional object with external factors (e.g. marketing spend, holidays) keyed by date to improve forecast accuracy.", + "required": false, + "defaultValue": "" + }, + { + "name": "confidenceLevel", + "type": "number", + "description": "Confidence level for forecast intervals as a decimal (e.g., 0.95 for 95%).", + "required": false, + "defaultValue": "0.95" + } + ], + "returns": { + "type": "object", + "description": "Returns a forecast object containing predicted values for each period, confidence intervals, and metadata about the model applied." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate future business metric projections, such as sales or revenue, based on historical data and optional external factors. It helps in planning, budgeting, and decision-making by providing statistically sound forecasts with uncertainty quantification.", + "limitations": "This tool cannot access real-time data feeds automatically. It requires properly formatted historical data and assumes continuity in patterns unless external factors are well-defined. It does not replace expert human judgment or domain-specific adjustments.", + "examples": [ + "Create a 6-month sales forecast using monthly sales data and holiday effects.", + "Generate a weekly revenue forecast for the next 12 weeks based on 3 years of weekly historical data.", + "Produce a revenue forecast with 95% confidence intervals applying the ARIMA model." + ] + }, + "tags": [ + "forecasting", + "business", + "content-creation", + "time-series", + "data-analysis", + "sales", + "revenue" + ], + "examples": [ + { + "inputJson": "{\"historicalData\":[{\"timestamp\":\"2023-01\",\"value\":100},{\"timestamp\":\"2023-02\",\"value\":110},{\"timestamp\":\"2023-03\",\"value\":105},{\"timestamp\":\"2023-04\",\"value\":115}],\"forecastHorizon\":6,\"timeInterval\":\"monthly\",\"modelType\":\"Prophet\",\"confidenceLevel\":0.95}", + "description": "Monthly sales data for 4 months, forecasting next 6 months using Prophet with 95% confidence." + }, + { + "inputJson": "{\"historicalData\":[{\"timestamp\":\"2023-01-01\",\"value\":2000},{\"timestamp\":\"2023-01-08\",\"value\":2500},{\"timestamp\":\"2023-01-15\",\"value\":2300}],\"forecastHorizon\":4,\"timeInterval\":\"weekly\",\"modelType\":\"ARIMA\",\"confidenceLevel\":0.90}", + "description": "Weekly revenue data for 3 weeks, forecasting next 4 weeks with ARIMA model and 90% confidence." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Forecast", + "context": null + } + }, + { + "name": "content-creation.createPayment", + "description": "Creates a payment record by accepting details such as payer information, amount, currency, and payment method. The tool validates input parameters and outputs a structured payment object containing a unique payment ID, status, timestamp, and relevant transaction details for further processing or record-keeping.", + "category": "content-creation", + "parameters": [ + { + "name": "payerName", + "type": "string", + "description": "Full name of the payer initiating the payment", + "required": true, + "defaultValue": "" + }, + { + "name": "payerEmail", + "type": "string", + "description": "Email address of the payer for contact and receipt purposes", + "required": true, + "defaultValue": "" + }, + { + "name": "amount", + "type": "number", + "description": "The monetary amount to be paid, expressed as a positive number", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Three-letter ISO currency code representing the currency of the payment", + "required": true, + "defaultValue": "USD" + }, + { + "name": "paymentMethod", + "type": "string", + "description": "Method of payment such as 'credit_card', 'bank_transfer', or 'paypal'", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Optional description or memo related to the payment", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional data related to the payment stored as key-value pairs", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the processed payment with ID, status, timestamp, and input details confirmed" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate a payment record during e-commerce transactions, invoicing workflows, or financial operations. It is useful for validating input payment details and creating a structured payment entity that integrates into broader payment processing pipelines.", + "limitations": "This tool does not process actual payment authorization or transaction clearing; it only creates and returns payment data records for further external handling.", + "examples": [ + "Create a payment record for a buyer named John Doe paying $150 USD via credit_card.", + "Generate a payment entry with metadata for an invoice payment using PayPal.", + "Record a bank transfer payment of 500 EUR including a payment description." + ] + }, + "tags": [ + "payment", + "content-creation", + "business", + "transaction", + "finance", + "record-generation", + "e-commerce" + ], + "examples": [ + { + "inputJson": "{\"payerName\":\"John Doe\",\"payerEmail\":\"john.doe@example.com\",\"amount\":150.00,\"currency\":\"USD\",\"paymentMethod\":\"credit_card\",\"description\":\"Order #12345 payment\",\"metadata\":{\"orderId\":\"12345\",\"customerType\":\"regular\"}}", + "description": "Creating a payment record for a credit card purchase by John Doe." + }, + { + "inputJson": "{\"payerName\":\"Alice Smith\",\"payerEmail\":\"alice.smith@example.com\",\"amount\":500,\"currency\":\"EUR\",\"paymentMethod\":\"bank_transfer\",\"description\":\"Invoice payment for consulting services\"}", + "description": "Record a bank transfer payment including a descriptive memo." + }, + { + "inputJson": "{\"payerName\":\"Bob Lee\",\"payerEmail\":\"bob.lee@example.com\",\"amount\":75.5,\"currency\":\"USD\",\"paymentMethod\":\"paypal\",\"metadata\":{\"invoiceId\":\"INV7890\"}}", + "description": "Generate a payment entry with PayPal payment method and additional metadata." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Payment", + "context": null + } + }, + { + "name": "content-creation.createExpense", + "description": "Creates a detailed expense record based on input parameters such as amount, currency, category, date, description, and optionally attached receipts. Processes the input to generate a structured expense entry including metadata for accounting or reimbursement purposes.", + "category": "content-creation", + "parameters": [ + { + "name": "amount", + "type": "number", + "description": "Monetary value of the expense.", + "required": true, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code in ISO 4217 format (e.g., USD, EUR) for the expense amount.", + "required": true, + "defaultValue": "USD" + }, + { + "name": "category", + "type": "string", + "description": "Category of the expense, like Travel, Meals, Office Supplies.", + "required": true, + "defaultValue": "" + }, + { + "name": "date", + "type": "string", + "description": "Date of the expense in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed description or notes about the expense.", + "required": false, + "defaultValue": "" + }, + { + "name": "merchant", + "type": "string", + "description": "Name of the merchant or payee where the expense occurred.", + "required": false, + "defaultValue": "" + }, + { + "name": "receiptUrls", + "type": "array", + "description": "Optional list of URLs pointing to image or PDF receipts associated with the expense.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "taxAmount", + "type": "number", + "description": "Tax amount included in the expense, if applicable.", + "required": false, + "defaultValue": "0" + }, + { + "name": "paymentMethod", + "type": "string", + "description": "Payment method used, e.g., credit card, cash, company account.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created expense record with a unique identifier, full details from input parameters, calculated fields if any, and timestamp of creation." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create and log a new expense. This can be part of financial workflow automation, reimbursement processing, or expense tracking. The agent provides required and optional details and receives a structured expense record for subsequent handling.", + "limitations": "This tool does not perform currency conversion, receipt image processing (such as OCR), or validation against company policies. It creates the structured expense entry only.", + "examples": [ + "Create an expense record for a business meal with a partner including receipts.", + "Log a travel expense with amount, category, date and specify payment method.", + "Add a new office supplies expense with a description and tax amount." + ] + }, + "tags": [ + "expense", + "finance", + "content-creation", + "create", + "accounting", + "reimbursement" + ], + "examples": [ + { + "inputJson": "{\"amount\":123.45,\"currency\":\"USD\",\"category\":\"Meals\",\"date\":\"2024-05-01\",\"description\":\"Business lunch with client\",\"merchant\":\"The Seafood Place\",\"receiptUrls\":[\"https://example.com/receipts/123.pdf\"],\"paymentMethod\":\"Corporate Credit Card\"}", + "description": "Create a meal expense including metadata and receipt link." + }, + { + "inputJson": "{\"amount\":2500,\"currency\":\"EUR\",\"category\":\"Travel\",\"date\":\"2024-04-20\",\"description\":\"Flight ticket to Conference\",\"paymentMethod\":\"Company Account\"}", + "description": "Record a travel expense for a flight ticket without receipt attachment." + }, + { + "inputJson": "{\"amount\":87.5,\"currency\":\"GBP\",\"category\":\"Office Supplies\",\"date\":\"2024-03-30\",\"taxAmount\":7.5,\"description\":\"Printer ink purchase\",\"merchant\":\"Stationery Store\"}", + "description": "Add an office supply expense including tax and merchant information." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Expense", + "context": null + } + }, + { + "name": "content-creation.createOrder", + "description": "This tool accepts order details including customer info, item list, quantities, prices, and shipping data to generate a structured order record. It validates and processes the input to produce a standardized order output suitable for use in content management or e-commerce workflows.", + "category": "content-creation", + "parameters": [ + { + "name": "customerName", + "type": "string", + "description": "Full name of the customer placing the order", + "required": true, + "defaultValue": "" + }, + { + "name": "customerEmail", + "type": "string", + "description": "Email address of the customer for notifications", + "required": true, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "List of ordered items, each with product ID, quantity, and unit price", + "required": true, + "defaultValue": "" + }, + { + "name": "shippingAddress", + "type": "object", + "description": "Shipping address details including street, city, postal code, and country", + "required": true, + "defaultValue": "" + }, + { + "name": "orderDate", + "type": "string", + "description": "Date when the order was placed in ISO 8601 format", + "required": false, + "defaultValue": "" + }, + { + "name": "notes", + "type": "string", + "description": "Optional special instructions or notes related to the order", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured order object including order ID, customer info, itemized list with totals, shipping info, order date, and status" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create and structure orders for customers in digital content systems, online stores, or CRM platforms. It ensures the necessary fields are collected and a complete order record is produced for further processing, integration, or communication.", + "limitations": "This tool does not perform payment processing or inventory management. It only creates and formats the order record; additional services are needed to handle fulfillment or payment.", + "examples": [ + "Create a new customer order with two items, shipping details, and optional notes.", + "Generate an order record from a customer's purchase including email and delivery address.", + "Produce an order summary object with calculated totals ready for export to a system." + ] + }, + "tags": [ + "content-creation", + "order-management", + "e-commerce", + "business", + "customer", + "purchase" + ], + "examples": [ + { + "inputJson": "{\"customerName\":\"Alice Johnson\",\"customerEmail\":\"alice.johnson@example.com\",\"items\":[{\"productId\":\"P1001\",\"quantity\":2,\"unitPrice\":29.99},{\"productId\":\"P2054\",\"quantity\":1,\"unitPrice\":99.95}],\"shippingAddress\":{\"street\":\"123 Elm St\",\"city\":\"Springfield\",\"postalCode\":\"62704\",\"country\":\"USA\"},\"orderDate\":\"2024-06-15T10:30:00Z\",\"notes\":\"Leave package at front door.\"}", + "description": "Create an order for Alice Johnson with two distinct products, including full shipping info and a delivery note." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Order", + "context": null + } + }, + { + "name": "content-creation.createAccount", + "description": "Creates a new business account profile by accepting essential details such as company name, contact information, industry, and optional metadata. Processes and validates input to generate a standardized account record including a unique identifier, timestamps, and profile status. Returns the created account details for integration or further processing.", + "category": "content-creation", + "parameters": [ + { + "name": "companyName", + "type": "string", + "description": "The official name of the business entity to create an account for.", + "required": true, + "defaultValue": "" + }, + { + "name": "contactEmail", + "type": "string", + "description": "Primary email address for account contact and notifications.", + "required": true, + "defaultValue": "" + }, + { + "name": "contactPhone", + "type": "string", + "description": "Optional phone number for additional contact method.", + "required": false, + "defaultValue": "" + }, + { + "name": "industry", + "type": "string", + "description": "The industry sector to which the business belongs, e.g., Technology, Retail.", + "required": true, + "defaultValue": "" + }, + { + "name": "address", + "type": "object", + "description": "Physical address details including street, city, state, postal code, and country.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs for additional customizable data related to the account.", + "required": false, + "defaultValue": "" + }, + { + "name": "isActive", + "type": "boolean", + "description": "Flag to specify if the account should be created as active or inactive.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the detailed created account, including generated accountId, input data, timestamps for creation, and current account status." + }, + "aiAgent": { + "useCase": "Use this tool whenever a new business entity profile needs to be created within a content management or CRM system. Suitable for automating account onboarding based on provided business data inputs, ensuring records are consistently structured and validated before further processing.", + "limitations": "This tool does not verify the legal existence of the business or validate contact details beyond basic formatting checks. It also does not assign permissions or link accounts to users; those must be handled separately.", + "examples": [ + "Create a new account for a tech startup with contact email and industry classification.", + "Add a retail store profile including full address and optional metadata for marketing preferences.", + "Set up an inactive account entry for a business partner pending verification." + ] + }, + "tags": [ + "content-creation", + "account", + "business", + "profile", + "onboarding", + "crm", + "data-entry" + ], + "examples": [ + { + "inputJson": "{\"companyName\":\"GreenTech Solutions\",\"contactEmail\":\"contact@greentech.com\",\"contactPhone\":\"+1234567890\",\"industry\":\"Technology\",\"address\":{\"street\":\"456 Elm St\",\"city\":\"Springfield\",\"state\":\"IL\",\"postalCode\":\"62701\",\"country\":\"USA\"},\"metadata\":{\"preferredLanguage\":\"en\",\"segment\":\"SMB\"},\"isActive\":true}", + "description": "Create an active account for a technology company with contact details and address." + }, + { + "inputJson": "{\"companyName\":\"FreshMart Grocery\",\"contactEmail\":\"info@freshmart.com\",\"industry\":\"Retail\",\"metadata\":{\"loyaltyMember\":true},\"isActive\":false}", + "description": "Create an inactive retail account with minimal contact info and metadata indicating loyalty membership." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Account", + "context": null + } + }, + { + "name": "content-creation.createDeal", + "description": "Generates a comprehensive deal document based on input parameters including deal title, parties involved, financial terms, deal duration, confidentiality clauses, and special conditions. The tool processes these inputs to produce a structured deal summary or contract draft as an output, suitable for review or further editing.", + "category": "content-creation", + "parameters": [ + { + "name": "dealTitle", + "type": "string", + "description": "The title or name of the deal.", + "required": true, + "defaultValue": "" + }, + { + "name": "partiesInvolved", + "type": "array", + "description": "A list of parties involved in the deal, each with name and role.", + "required": true, + "defaultValue": "" + }, + { + "name": "financialTerms", + "type": "object", + "description": "Key financial details such as price, payment schedule, currency.", + "required": true, + "defaultValue": "" + }, + { + "name": "dealDurationMonths", + "type": "number", + "description": "Duration of the deal in months.", + "required": false, + "defaultValue": "12" + }, + { + "name": "confidentialityClause", + "type": "boolean", + "description": "Whether to include a confidentiality clause in the deal document.", + "required": false, + "defaultValue": "true" + }, + { + "name": "specialConditions", + "type": "array", + "description": "Any special terms or conditions to be included in the deal as text entries.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted deal document text, a summary of key terms, and a status flag indicating success or errors." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a formalized deal or contract draft from structured input data for business negotiations, contract reviews, or proposal creation. Ideal for automating routine deal creation or generating standardized contract drafts based on user inputs.", + "limitations": "This tool does not perform legal validation or compliance checking and cannot customize highly complex legal language beyond templated clauses. It is intended for draft generation and requires human review.", + "examples": [ + "Create a deal draft between two companies for software licensing with payment terms and confidentiality.", + "Generate a short-term service agreement including special conditions and no confidentiality clause.", + "Draft a purchase deal for equipment with detailed financial terms and 24-month duration." + ] + }, + "tags": [ + "deal", + "contract", + "business", + "content-generation", + "document-creation", + "legal-draft" + ], + "examples": [ + { + "inputJson": "{\"dealTitle\":\"Software Licensing Agreement\",\"partiesInvolved\":[{\"name\":\"Alpha Corp\",\"role\":\"Licensor\"},{\"name\":\"Beta LLC\",\"role\":\"Licensee\"}],\"financialTerms\":{\"price\":50000,\"paymentSchedule\":\"quarterly\",\"currency\":\"USD\"},\"dealDurationMonths\":12,\"confidentialityClause\":true,\"specialConditions\":[\"Support included for first 12 months\",\"Renewal on mutual agreement\"]}", + "description": "Creating a software license deal between two companies including payment terms and confidentiality." + }, + { + "inputJson": "{\"dealTitle\":\"Consulting Services Deal\",\"partiesInvolved\":[{\"name\":\"Gamma Consulting\",\"role\":\"Service Provider\"},{\"name\":\"Delta Inc\",\"role\":\"Client\"}],\"financialTerms\":{\"price\":20000,\"paymentSchedule\":\"monthly\",\"currency\":\"USD\"},\"dealDurationMonths\":6,\"confidentialityClause\":false,\"specialConditions\":[]}", + "description": "Drafting a consulting service agreement without confidentiality clause for six months duration." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Deal", + "context": null + } + }, + { + "name": "content-creation.createGraph", + "description": "Creates a customizable graph image based on provided data points and configuration. Accepts an array of data sets with labels and values, graph type (e.g., line, bar, pie), axis labels, colors, title, and other stylistic options. Generates and returns a graph image URL or base64-encoded image for use in presentations, reports, or web content.", + "category": "content-creation", + "parameters": [ + { + "name": "graphType", + "type": "string", + "description": "Type of graph to create, e.g., 'line', 'bar', 'pie', 'scatter'.", + "required": true, + "defaultValue": "line" + }, + { + "name": "dataSets", + "type": "array", + "description": "An array of data objects each containing a label (string) and values (array of numbers) to plot.", + "required": true, + "defaultValue": "" + }, + { + "name": "xAxisLabel", + "type": "string", + "description": "Label for the X-axis (ignored for pie charts).", + "required": false, + "defaultValue": "" + }, + { + "name": "yAxisLabel", + "type": "string", + "description": "Label for the Y-axis (ignored for pie charts).", + "required": false, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title text to display above the graph.", + "required": false, + "defaultValue": "" + }, + { + "name": "colors", + "type": "array", + "description": "Array of color strings to use for each data set or pie slice.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the generated graph image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the generated graph image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "showLegend", + "type": "boolean", + "description": "Whether to display a legend describing the data sets.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the graph image data, including a URL or a base64-encoded PNG image string for embedding." + }, + "aiAgent": { + "useCase": "This tool is ideal when needing to visualize numeric data in various common graph formats for reports, dashboards, or content creation. Agents should use it to transform structured data inputs into clear graphical representations for enhanced comprehension.", + "limitations": "The tool generates standard graph types and supports basic customization but cannot create highly complex or interactive charts (e.g., 3D graphs or real-time data streaming charts).", + "examples": [ + "Create a bar graph showing quarterly sales for three products.", + "Generate a pie chart displaying market share percentages across segments.", + "Produce a line graph tracking website traffic over a year with monthly data points." + ] + }, + "tags": [ + "graph", + "chart", + "data-visualization", + "content-creation", + "image-generation", + "reporting", + "analytics" + ], + "examples": [ + { + "inputJson": "{\"graphType\":\"bar\",\"dataSets\":[{\"label\":\"Product A\",\"values\":[120,150,180,200]},{\"label\":\"Product B\",\"values\":[80,90,100,110]}],\"xAxisLabel\":\"Quarter\",\"yAxisLabel\":\"Sales ($k)\",\"title\":\"Quarterly Sales Comparison\",\"colors\":[\"#1f77b4\",\"#ff7f0e\"],\"width\":800,\"height\":600,\"showLegend\":true}", + "description": "Generate a bar chart comparing sales of two products over four quarters with labeled axes and legend." + }, + { + "inputJson": "{\"graphType\":\"pie\",\"dataSets\":[{\"label\":\"North America\",\"values\":[40]},{\"label\":\"Europe\",\"values\":[30]},{\"label\":\"Asia\",\"values\":[20]},{\"label\":\"Other\",\"values\":[10]}],\"title\":\"Regional Market Share\",\"colors\":[\"#4daf4a\",\"#377eb8\",\"#ff7f00\",\"#984ea3\"],\"width\":600,\"height\":600,\"showLegend\":true}", + "description": "Create a pie chart illustrating market share by region with distinct colors and a legend." + }, + { + "inputJson": "{\"graphType\":\"line\",\"dataSets\":[{\"label\":\"Website Visitors\",\"values\":[1000,1200,1500,1700,1600,1800,2000,2200,2100,2300,2500,2700]}],\"xAxisLabel\":\"Month\",\"yAxisLabel\":\"Visitors\",\"title\":\"Monthly Website Traffic 2023\",\"width\":900,\"height\":500,\"showLegend\":false}", + "description": "Produce a line graph showing the monthly visitor counts throughout the year with axis labels, no legend." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Graph", + "context": null + } + }, + { + "name": "content-creation.createOpportunity", + "description": "Creates a detailed business opportunity record based on provided inputs such as title, description, target market, expected revenue, and timeline. The tool processes the inputs to generate a structured opportunity object that can be used for tracking, evaluation, or inclusion in CRM systems.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The name or title of the business opportunity.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed description of the opportunity including key features and value proposition.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetMarket", + "type": "string", + "description": "The primary market or customer segment the opportunity is aimed at.", + "required": true, + "defaultValue": "" + }, + { + "name": "expectedRevenue", + "type": "number", + "description": "Estimated revenue in USD that this opportunity is expected to generate.", + "required": false, + "defaultValue": "0" + }, + { + "name": "timelineStart", + "type": "string", + "description": "Start date of the opportunity timeline in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "timelineEnd", + "type": "string", + "description": "End date of the opportunity timeline in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the opportunity (e.g., Low, Medium, High).", + "required": false, + "defaultValue": "Medium" + }, + { + "name": "tags", + "type": "array", + "description": "Tags or keywords associated with the opportunity for categorization or search.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A structured business opportunity object containing all input data plus a generated unique identifier and creation timestamp." + }, + "aiAgent": { + "useCase": "Use this tool to create clear, consistent records of new business opportunities whenever the AI agent identifies a user intent to propose, log, or document potential business ventures or sales leads. It helps in organizing opportunity data systematically for follow-up or analysis.", + "limitations": "This tool does not validate financial accuracy or market feasibility; it creates structured data based solely on input parameters without assessing opportunity viability.", + "examples": [ + "Create a new sales opportunity for a cloud software product targeting SMBs with expected revenue $100,000 starting next month.", + "Add an opportunity for a partnership deal with a vendor including timeline and priority information.", + "Generate a detailed entry of a new market expansion opportunity with relevant tags." + ] + }, + "tags": [ + "content-creation", + "business", + "opportunity", + "CRM", + "lead-management", + "sales", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Cloud Migration Service\",\"description\":\"Offering cloud migration consulting and managed services for SMBs.\",\"targetMarket\":\"Small and Medium Businesses\",\"expectedRevenue\":100000,\"timelineStart\":\"2024-07-01\",\"timelineEnd\":\"2024-12-31\",\"priority\":\"High\",\"tags\":[\"cloud\",\"migration\",\"SMB\"]}", + "description": "Creating a high priority cloud migration service opportunity for small and medium businesses with expected revenue and timeline." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Opportunity", + "context": null + } + }, + { + "name": "content-creation.createLead", + "description": "Generates a new business lead record based on provided contact details, company information, and lead qualification data. Processes the input to structure a standardized lead profile suitable for CRM ingestion or marketing outreach, outputting a complete lead object with unique ID, contact info, status, and tags.", + "category": "content-creation", + "parameters": [ + { + "name": "firstName", + "type": "string", + "description": "Lead's first name", + "required": true, + "defaultValue": "" + }, + { + "name": "lastName", + "type": "string", + "description": "Lead's last name", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Lead's email address", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Lead's phone number", + "required": false, + "defaultValue": "" + }, + { + "name": "company", + "type": "string", + "description": "Lead's company name", + "required": false, + "defaultValue": "" + }, + { + "name": "jobTitle", + "type": "string", + "description": "Lead's job title or role", + "required": false, + "defaultValue": "" + }, + { + "name": "leadSource", + "type": "string", + "description": "Origin of the lead (e.g., conference, website, referral)", + "required": false, + "defaultValue": "" + }, + { + "name": "status", + "type": "string", + "description": "Current lead status (e.g., new, contacted, qualified)", + "required": false, + "defaultValue": "new" + }, + { + "name": "tags", + "type": "array", + "description": "Optional list of tags to categorize the lead", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Standardized lead object including unique leadId, full contact info, status, and metadata" + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a structured business lead from raw contact and company data. Ideal for automating CRM entry or preparing leads for marketing/sales outreach. It helps standardize disparate input details into a usable lead entity.", + "limitations": "Does not verify contact validity or enrich lead data with third party sources. It assumes input correctness and completeness for best results.", + "examples": [ + "Create a lead from conference sign-up data", + "Generate a new lead from website form submission", + "Add a new sales lead with contact and company details" + ] + }, + "tags": [ + "content-creation", + "lead-generation", + "business", + "crm", + "marketing", + "sales", + "contact-management" + ], + "examples": [ + { + "inputJson": "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"email\":\"jane.doe@example.com\",\"phoneNumber\":\"+1234567890\",\"company\":\"ExampleCorp\",\"jobTitle\":\"Marketing Manager\",\"leadSource\":\"webinar\",\"status\":\"new\",\"tags\":[\"webinar\",\"marketing\"]}", + "description": "Create a new marketing lead from webinar signup data with basic contact and company info." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Lead", + "context": null + } + }, + { + "name": "content-creation.createCustomer", + "description": "Creates a new customer profile for a business by accepting essential details such as name, contact info, address, and optional metadata. Validates inputs and returns the created customer's unique identifier and summary.", + "category": "content-creation", + "parameters": [ + { + "name": "firstName", + "type": "string", + "description": "Customer's first name", + "required": true, + "defaultValue": "" + }, + { + "name": "lastName", + "type": "string", + "description": "Customer's last name", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Customer's email address for communication", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Customer's phone number", + "required": false, + "defaultValue": "" + }, + { + "name": "address", + "type": "object", + "description": "Physical address including street, city, state, postalCode, and country", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs for additional customer attributes or tags", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique customer ID, full name, contact info, and stored metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to register or update a new customer profile within a CRM or business system by providing required personal and contact details. Helpful for onboarding, account creation workflows, or customer data management scenarios.", + "limitations": "This tool does not handle customer authentication, credit checks, or complex validations beyond basic input format checks. It also does not integrate with payment systems or external databases automatically.", + "examples": [ + "Create a new customer profile for John Doe with email and address.", + "Register a customer with metadata tags for marketing segmentation.", + "Add a phone number to a new customer profile creation request." + ] + }, + "tags": [ + "customer", + "creation", + "profile", + "contact", + "crm", + "business", + "management" + ], + "examples": [ + { + "inputJson": "{\"firstName\":\"Jane\",\"lastName\":\"Smith\",\"email\":\"jane.smith@example.com\",\"phoneNumber\":\"123-456-7890\",\"address\":{\"street\":\"123 Main St\",\"city\":\"Anytown\",\"state\":\"CA\",\"postalCode\":\"12345\",\"country\":\"USA\"},\"metadata\":{\"preferredContactMethod\":\"email\",\"customerTier\":\"gold\"}}", + "description": "Create a complete customer profile with contact info and metadata tags." + }, + { + "inputJson": "{\"firstName\":\"Mike\",\"lastName\":\"Brown\",\"email\":\"mike.brown@example.com\"}", + "description": "Create a minimal customer profile with just required fields." + }, + { + "inputJson": "{\"firstName\":\"Anna\",\"lastName\":\"Lee\",\"email\":\"anna.lee@example.com\",\"metadata\":{\"newsletterSubscribed\":true}}", + "description": "Create customer profile including a subscription metadata flag." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Customer", + "context": null + } + }, + { + "name": "content-creation.createChart", + "description": "Generates a customizable chart image based on provided data and parameters. Accepts data series, chart type, labels, and styling options to produce a chart in PNG or SVG format suitable for embedding in documents or web pages.", + "category": "content-creation", + "parameters": [ + { + "name": "chartType", + "type": "string", + "description": "Type of chart to create, e.g., 'bar', 'line', 'pie'.", + "required": true, + "defaultValue": "" + }, + { + "name": "data", + "type": "array", + "description": "Array of data series objects {name:string, values:number[]} representing datasets to plot.", + "required": true, + "defaultValue": "" + }, + { + "name": "labels", + "type": "array", + "description": "Array of strings labeling the data points on the axis or pie slices.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the chart shown prominently above the chart area.", + "required": false, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output chart image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output chart image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "colorScheme", + "type": "array", + "description": "Array of color strings to style each data series distinctively.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Output image format, either 'png' or 'svg'.", + "required": false, + "defaultValue": "png" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the base64-encoded chart image string and its MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when generating visual data representations like bar charts, line graphs, or pie charts from structured numeric data to embed as images in reports, presentations, or web content.", + "limitations": "Does not support interactive or animated charts, limited to standard chart types, and assumes data is numeric and properly preprocessed.", + "examples": [ + "Create a bar chart comparing monthly sales figures for multiple products.", + "Generate a pie chart showing market share percentages for different brands.", + "Produce a line chart illustrating temperature changes over time." + ] + }, + "tags": [ + "chart", + "visualization", + "image", + "data", + "content", + "creation", + "graph", + "report" + ], + "examples": [ + { + "inputJson": "{\"chartType\":\"bar\",\"data\":[{\"name\":\"Q1 Sales\",\"values\":[150,200,170]},{\"name\":\"Q2 Sales\",\"values\":[180,210,160]}],\"labels\":[\"January\",\"February\",\"March\"],\"title\":\"Quarterly Sales Comparison\",\"width\":800,\"height\":600,\"colorScheme\":[\"#4caf50\",\"#2196f3\"],\"outputFormat\":\"png\"}", + "description": "Bar chart comparing Q1 and Q2 sales across three months." + }, + { + "inputJson": "{\"chartType\":\"pie\",\"data\":[{\"name\":\"Share\",\"values\":[40,30,20,10]}],\"labels\":[\"Brand A\",\"Brand B\",\"Brand C\",\"Brand D\"],\"title\":\"Market Share Distribution\",\"outputFormat\":\"svg\"}", + "description": "Pie chart illustrating market share distribution for four brands." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Chart", + "context": null + } + }, + { + "name": "content-creation.createScreenshot", + "description": "Captures a screenshot of a specified web page or screen area on a device. Accepts URL or screen coordinates and optional viewport size, delay, and image format parameters. Returns the screenshot image encoded as base64 along with metadata such as dimensions and format.", + "category": "content-creation", + "parameters": [ + { + "name": "targetUrl", + "type": "string", + "description": "The full URL of the web page to capture a screenshot from. Required if areaCoordinates is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "areaCoordinates", + "type": "object", + "description": "An object defining the rectangular screen area to capture with top, left, width, and height properties in pixels. Required if targetUrl is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "viewportWidth", + "type": "number", + "description": "Width of the virtual viewport to render the page for screenshot, in pixels. Defaults to 1280.", + "required": false, + "defaultValue": "1280" + }, + { + "name": "viewportHeight", + "type": "number", + "description": "Height of the virtual viewport to render the page for screenshot, in pixels. Defaults to 720.", + "required": false, + "defaultValue": "720" + }, + { + "name": "delaySeconds", + "type": "number", + "description": "Time in seconds to wait after page load or before capturing area to allow dynamic content to render. Defaults to 0.", + "required": false, + "defaultValue": "0" + }, + { + "name": "imageFormat", + "type": "string", + "description": "The image format to output: png or jpeg. Defaults to png.", + "required": false, + "defaultValue": "png" + }, + { + "name": "quality", + "type": "number", + "description": "Quality of the output image for jpeg format, from 0 to 100. Defaults to 80. Ignored for png.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the captured screenshot image as a base64 string, the image format, width, and height in pixels." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to visually capture the current state of a web page or a specific area on a screen for documentation, analysis, or content creation purposes. It works well for generating visual data from URLs or screen coordinates, supporting optional viewport sizing and delays for dynamic content.", + "limitations": "Cannot capture screenshots of local files or pages behind authentication without additional setup. Does not support video or interactive content capture. Image quality depends on viewport and format settings.", + "examples": [ + "Capture a full-page screenshot of https://example.com in PNG format with default viewport.", + "Capture a 300x200 pixel area at coordinates (100,100) on the screen, output as JPEG with quality 70.", + "Capture https://news.example.com screenshot waiting 2 seconds after load to allow ads to appear." + ] + }, + "tags": [ + "screenshot", + "image", + "web-capture", + "content-creation", + "media" + ], + "examples": [ + { + "inputJson": "{\"targetUrl\":\"https://example.com\",\"viewportWidth\":1280,\"viewportHeight\":720,\"imageFormat\":\"png\"}", + "description": "Capture a full-page screenshot of example.com in PNG with default viewport." + }, + { + "inputJson": "{\"areaCoordinates\":{\"top\":100,\"left\":100,\"width\":300,\"height\":200},\"imageFormat\":\"jpeg\",\"quality\":70}", + "description": "Capture a 300x200 pixels area on screen at (100,100) output as JPEG with quality 70." + }, + { + "inputJson": "{\"targetUrl\":\"https://news.example.com\",\"delaySeconds\":2,\"imageFormat\":\"png\"}", + "description": "Capture https://news.example.com with 2 seconds delay after load to ensure dynamic content is rendered." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Screenshot", + "context": null + } + }, + { + "name": "content-creation.createDiagram", + "description": "Generates vector-based diagrams from structured input defining nodes, edges, styles, and layout preferences. Accepts JSON to specify diagram type (flowchart, network, UML), elements, and design options. Outputs a scalable SVG or PNG image file representing the constructed diagram suitable for embedding or download.", + "category": "content-creation", + "parameters": [ + { + "name": "diagramType", + "type": "string", + "description": "Type of diagram to create (e.g., flowchart, network, UML)", + "required": true, + "defaultValue": "" + }, + { + "name": "nodes", + "type": "array", + "description": "Array of node objects each with id, label, and optional properties like shape or color", + "required": true, + "defaultValue": "" + }, + { + "name": "edges", + "type": "array", + "description": "Array of edge objects defining source and target node ids, labels, and optional style attributes", + "required": true, + "defaultValue": "" + }, + { + "name": "layout", + "type": "string", + "description": "Preferred layout style (e.g., hierarchical, radial, force-directed) to arrange the diagram automatically", + "required": false, + "defaultValue": "hierarchical" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output image format: 'svg' (default) or 'png'", + "required": false, + "defaultValue": "svg" + }, + { + "name": "width", + "type": "number", + "description": "Width of the output image in pixels", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the output image in pixels", + "required": false, + "defaultValue": "600" + }, + { + "name": "includeLegend", + "type": "boolean", + "description": "Whether to include a legend describing node and edge types", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object containing the diagram image as a base64 string and metadata describing format, width, height, and type" + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate clear, structured diagrams for documentation, reports, visual explanations, or presentations from defined node and edge data. It is ideal when you require vector output with customizable styling and layout from raw data inputs.", + "limitations": "This tool does not perform freeform drawing or recognize hand-drawn shapes; it requires structured input data. It cannot generate complex animations or interactive diagrams but static images only.", + "examples": [ + "Create a flowchart diagram from a list of steps and connections.", + "Generate a UML class diagram representing classes and their relationships.", + "Produce a network topology visualization from node and edge lists with specified layout." + ] + }, + "tags": [ + "diagram", + "visualization", + "content-creation", + "flowchart", + "UML", + "network", + "vector-graphics" + ], + "examples": [ + { + "inputJson": "{\"diagramType\":\"flowchart\",\"nodes\":[{\"id\":\"start\",\"label\":\"Start\",\"shape\":\"circle\",\"color\":\"green\"},{\"id\":\"step1\",\"label\":\"Do Task A\",\"shape\":\"rectangle\"},{\"id\":\"end\",\"label\":\"End\",\"shape\":\"circle\",\"color\":\"red\"}],\"edges\":[{\"source\":\"start\",\"target\":\"step1\"},{\"source\":\"step1\",\"target\":\"end\"}],\"layout\":\"hierarchical\",\"outputFormat\":\"svg\",\"width\":800,\"height\":600,\"includeLegend\":true}", + "description": "Generate a simple flowchart diagram illustrating a process from start to end with a single task." + } + ], + "qualityScore": 1, + "skeleton": { + "verb": "create", + "object": "Diagram", + "context": null + } + }, + { + "name": "content-creation.createHTML", + "description": "Generates customizable HTML code based on specified parameters such as title, body content, styles, and scripts. Accepts input for key HTML components and outputs a complete HTML document string that can be used directly in web pages or projects.", + "category": "content-creation", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title text for the HTML document's tag, displayed in the browser tab.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyContent", + "type": "string", + "description": "HTML content to be placed inside the tag, including text, images, or other HTML elements.", + "required": true, + "defaultValue": "" + }, + { + "name": "inlineCSS", + "type": "string", + "description": "CSS styles to be included within a \",\"inlineStyles\":[\"p { color: red; }\"],\"nonce\":\"abc123\"}", + "description": "Includes inline styles with a CSP nonce." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "HTML", + "context": null + } + }, + { + "name": "security-tools.createSpec", + "description": "This tool generates a comprehensive security specification document based on provided application architecture details, security requirements, and compliance standards. Users input system components, threat models, and desired security controls; the tool processes these to produce a detailed security spec outlining risks, mitigations, and implementation recommendations.", + "category": "security-tools", + "parameters": [ + { + "name": "applicationArchitecture", + "type": "object", + "description": "Detailed description of the application's components, data flows, and infrastructure setup.", + "required": true, + "defaultValue": "" + }, + { + "name": "securityRequirements", + "type": "array", + "description": "List of the security requirements and goals the application must satisfy, e.g., confidentiality, integrity, availability.", + "required": true, + "defaultValue": "" + }, + { + "name": "complianceStandards", + "type": "array", + "description": "Applicable regulatory and compliance standards to incorporate, e.g., GDPR, HIPAA, PCI-DSS.", + "required": false, + "defaultValue": "" + }, + { + "name": "threatModels", + "type": "array", + "description": "Threat modeling inputs identifying potential risks and attack vectors relevant to the system.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the security specification document, e.g., PDF, Markdown, HTML.", + "required": false, + "defaultValue": "PDF" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated security specification document content as a string and metadata such as format and summary." + }, + "aiAgent": { + "useCase": "AI agents should invoke this tool when tasked with creating or updating security specification documents that define the security posture and controls for software systems based on architecture and risk inputs. It helps automate documentation needed for security reviews, audits, and development guidance.", + "limitations": "This tool does not perform real-time vulnerability scanning or penetration testing; it only generates specifications based on provided inputs. It cannot guarantee compliance or security without human expert review.", + "examples": [ + "Create a security spec for a web app with microservices architecture ensuring PCI-DSS compliance.", + "Generate a security specification document including threat analysis for a healthcare data platform.", + "Produce a Markdown format security spec based on given application architecture and GDPR requirements." + ] + }, + "tags": [ + "security", + "documentation", + "compliance", + "risk-management", + "specification", + "automation" + ], + "examples": [ + { + "inputJson": "{\"applicationArchitecture\":{\"components\":[{\"name\":\"WebApp\",\"type\":\"frontend\"},{\"name\":\"API\",\"type\":\"backend\"},{\"name\":\"Database\",\"type\":\"storage\"}],\"dataFlows\":[{\"from\":\"WebApp\",\"to\":\"API\"},{\"from\":\"API\",\"to\":\"Database\"}]},\"securityRequirements\":[\"confidentiality\",\"integrity\",\"availability\"],\"complianceStandards\":[\"PCI-DSS\"],\"threatModels\":[{\"threat\":\"SQL Injection\",\"severity\":\"high\"}],\"outputFormat\":\"PDF\"}", + "description": "Generate a PCI-DSS compliant security spec for a web app architecture with threat modeling." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Spec", + "context": null + } + }, + { + "name": "legal-tools.generateDocument", + "description": "Generates a tailored legal document based on the specified document type and input details. Accepts documentType (e.g., NDA, contract, will), relevant parties' information, key terms, and optional clauses as inputs. Outputs a complete, formatted legal document text ready for review or signing.", + "category": "legal-tools", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of legal document to generate (e.g., NDA, employment contract, lease agreement).", + "required": true, + "defaultValue": "" + }, + { + "name": "parties", + "type": "array", + "description": "Array of party objects involved in the document, each with name and role properties.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyTerms", + "type": "object", + "description": "Key terms and conditions specific to the document type, such as dates, payment terms, and obligations.", + "required": true, + "defaultValue": "" + }, + { + "name": "optionalClauses", + "type": "array", + "description": "List of optional clauses to include, specified as strings, such as confidentiality, termination, or arbitration clauses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "jurisdiction", + "type": "string", + "description": "Jurisdiction or governing law applicable to the document, to ensure compliance with local legal standards.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated legal document text and metadata such as documentType and parties involved." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly create a standardized legal document tailored to specific parties and terms, such as NDAs, contracts, or agreements, ensuring consistency and reducing manual drafting time.", + "limitations": "Does not replace professional legal advice; may not cover all jurisdiction-specific requirements or handle highly complex bespoke agreements; legality depends on final review and compliance check.", + "examples": [ + "Generate an NDA between two companies with confidentiality and termination clauses.", + "Create an employment contract specifying job title, salary, and probation period.", + "Draft a lease agreement including rent, term, and maintenance responsibilities." + ] + }, + "tags": [ + "legal", + "document generation", + "contract", + "compliance", + "agreement", + "automation" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"NDA\",\"parties\":[{\"name\":\"Company A\",\"role\":\"Disclosing Party\"},{\"name\":\"Company B\",\"role\":\"Receiving Party\"}],\"keyTerms\":{\"startDate\":\"2024-07-01\",\"durationMonths\":24},\"optionalClauses\":[\"confidentiality\",\"termination\"],\"jurisdiction\":\"California, USA\"}", + "description": "Generate a Non-Disclosure Agreement between two companies with confidentiality and termination clauses under California law." + }, + { + "inputJson": "{\"documentType\":\"Employment Contract\",\"parties\":[{\"name\":\"John Doe\",\"role\":\"Employee\"},{\"name\":\"ABC Corp\",\"role\":\"Employer\"}],\"keyTerms\":{\"position\":\"Software Engineer\",\"salary\":90000,\"probationPeriodMonths\":3},\"optionalClauses\":[\"nonCompete\"],\"jurisdiction\":\"New York, USA\"}", + "description": "Create an employment contract for a software engineer including salary and probation period with a non-compete clause." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "customer-support.analyzeTable", + "description": "Analyzes tabular customer support data (e.g., tickets, chat logs, survey results) to identify key metrics like common issues, response times, sentiment trends, and agent performance. Accepts data tables in JSON array format and outputs a structured analysis report with actionable insights to improve support quality.", + "category": "customer-support", + "parameters": [ + { + "name": "dataTable", + "type": "array", + "description": "An array of objects representing customer support records, such as tickets or chat logs, each with relevant fields like 'issue', 'responseTime', 'sentiment', and 'agent'.", + "required": true, + "defaultValue": "" + }, + { + "name": "analysisType", + "type": "string", + "description": "Specifies the type of analysis to perform, e.g., 'summary', 'trend', 'sentiment', or 'agentPerformance'.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "timeRange", + "type": "object", + "description": "Optional object with 'startDate' and 'endDate' strings in ISO format to filter data within a date range.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to include sentiment analysis results in the output report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "topNIssues", + "type": "number", + "description": "Number of top frequent issues to identify and highlight.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "A detailed analysis report containing metrics like issue frequencies, average response times, sentiment distribution, trend charts data, and agent performance summaries depending on selected analysisType." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing structured customer support data tables to extract actionable insights like top issues, customer sentiment trends, and agent response quality, helping improve overall support effectiveness.", + "limitations": "Does not perform raw data extraction or unstructured text parsing; input must be pre-structured JSON arrays representing tabular data. Complex natural language understanding beyond basic sentiment analysis is not supported.", + "examples": [ + "Analyze summary metrics from last quarter's support tickets to find common problems.", + "Identify sentiment trends over the past month in chat support logs.", + "Evaluate agent performance metrics based on resolution times and customer feedback." + ] + }, + "tags": [ + "customer-support", + "analysis", + "data-table", + "sentiment", + "agent-performance", + "metrics", + "support-tickets" + ], + "examples": [ + { + "inputJson": "{\"dataTable\":[{\"issue\":\"Login failure\",\"responseTime\":120,\"sentiment\":\"negative\",\"agent\":\"Alice\"},{\"issue\":\"Password reset\",\"responseTime\":90,\"sentiment\":\"neutral\",\"agent\":\"Bob\"},{\"issue\":\"Login failure\",\"responseTime\":110,\"sentiment\":\"negative\",\"agent\":\"Alice\"}],\"analysisType\":\"summary\",\"topNIssues\":2}", + "description": "Summarize the most frequent issues, average response times, and sentiment for a small support ticket dataset." + }, + { + "inputJson": "{\"dataTable\":[{\"date\":\"2024-05-01\",\"sentimentScore\":0.2},{\"date\":\"2024-05-02\",\"sentimentScore\":0.7},{\"date\":\"2024-05-03\",\"sentimentScore\":0.5}],\"analysisType\":\"sentiment\",\"timeRange\":{\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-03\"},\"includeSentiment\":true}", + "description": "Analyze sentiment trend over 3 days from chat support logs." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Table", + "context": null + } + }, + { + "name": "customer-support.draftReport", + "description": "This tool generates a comprehensive customer support report based on provided case data. It accepts an array of customer interactions, including timestamps, issue categories, agent notes, and resolutions, then compiles a structured report summarizing trends, outstanding issues, and agent performance metrics in text format.", + "category": "customer-support", + "parameters": [ + { + "name": "caseData", + "type": "array", + "description": "Array of customer support case objects containing interaction details, issue type, agent handling, timestamps, and resolution status.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportType", + "type": "string", + "description": "Specifies the type of report to generate, e.g., 'summary', 'detailed', or 'performance'.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "dateRange", + "type": "object", + "description": "Object with 'startDate' and 'endDate' string fields in ISO format to filter case data by date.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include AI-generated recommendations for improving support processes in the report.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report text and metadata such as reportType, totalCases analyzed, and key issue summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to synthesize multiple customer support interactions into a readable report that highlights trends, performance insights, or issue summaries over a specified timeframe. It helps automate generating routine support reports for managers or QA teams.", + "limitations": "Cannot replace detailed human analysis; insights are limited to provided data quality. It does not perform actual customer sentiment analysis or handle real-time case tracking.", + "examples": [ + "Generate a monthly summary report of all support tickets closed in May.", + "Create a detailed report focusing on agent performance during the last quarter.", + "Draft a report including recommendations for reducing resolution times based on last week's cases." + ] + }, + "tags": [ + "reporting", + "customer-support", + "summary", + "performance", + "automation" + ], + "examples": [ + { + "inputJson": "{\"caseData\":[{\"caseId\":\"1234\",\"timestamp\":\"2024-05-01T10:00:00Z\",\"issueCategory\":\"Login Problem\",\"agent\":\"Agent A\",\"resolution\":\"Password reset\",\"status\":\"Closed\"},{\"caseId\":\"1235\",\"timestamp\":\"2024-05-02T11:30:00Z\",\"issueCategory\":\"Billing\",\"agent\":\"Agent B\",\"resolution\":\"Refund issued\",\"status\":\"Closed\"}],\"reportType\":\"summary\",\"dateRange\":{\"startDate\":\"2024-05-01\",\"endDate\":\"2024-05-31\"},\"includeRecommendations\":false}", + "description": "Generate a summary report of support cases closed in May." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Report", + "context": null + } + }, + { + "name": "customer-support.formatContract", + "description": "Formats a customer contract document by applying standardized templates and styles. Accepts raw contract text and formatting preferences, processes them to produce a polished, consistently styled contract ready for presentation or storage.", + "category": "customer-support", + "parameters": [ + { + "name": "contractText", + "type": "string", + "description": "The raw text content of the contract to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "templateStyle", + "type": "string", + "description": "The name of the template style to apply (e.g., 'Standard', 'Professional', 'Minimalist').", + "required": false, + "defaultValue": "Standard" + }, + { + "name": "includeSignatureBlock", + "type": "boolean", + "description": "Whether to append a signature block section at the end of the contract.", + "required": false, + "defaultValue": "true" + }, + { + "name": "companyName", + "type": "string", + "description": "The name of the company issuing the contract, used in headers or footers if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "effectiveDate", + "type": "string", + "description": "Optional effective date to include in the contract in YYYY-MM-DD format.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted contract text as HTML and optionally as plain text for further use." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to take a raw or partially drafted contract text and produce a visually structured and consistent contract document for customer review or record keeping. This is useful for automating contract generation workflows with styling and optional signature sections.", + "limitations": "This tool does not analyze legal content or validate contract terms; it only formats text according to templates. It cannot generate contract content from scratch or interpret contract clauses.", + "examples": [ + "Format a raw contract text with the 'Professional' style and include a signature block.", + "Prepare a contract with company name and effective date included, using default template.", + "Format a contract without a signature block for an internal draft." + ] + }, + "tags": [ + "formatting", + "customer-support", + "contracts", + "document-generation", + "templates", + "legal-documents" + ], + "examples": [ + { + "inputJson": "{\"contractText\":\"This agreement is made between...\",\"templateStyle\":\"Professional\",\"includeSignatureBlock\":true,\"companyName\":\"ACME Corp\",\"effectiveDate\":\"2024-06-01\"}", + "description": "Format a contract with professional style, including company name, effective date, and signature block." + }, + { + "inputJson": "{\"contractText\":\"Terms and conditions...\",\"templateStyle\":\"Minimalist\",\"includeSignatureBlock\":false}", + "description": "Generate a minimalist style contract without a signature block for internal use." + }, + { + "inputJson": "{\"contractText\":\"Contract content here.\",\"companyName\":\"Beta LLC\"}", + "description": "Format contract using default template, including company name, with signature block by default." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Contract", + "context": null + } + }, + { + "name": "customer-support.composeText", + "description": "Generates professionally crafted customer support text responses based on input parameters including customer query, context, tone, and language. Processes input to produce tailored, polite, and contextually relevant message drafts suitable for help desk and support agents to send.", + "category": "customer-support", + "parameters": [ + { + "name": "customerQuery", + "type": "string", + "description": "The customer's original query or issue.", + "required": true, + "defaultValue": "" + }, + { + "name": "contextDetails", + "type": "string", + "description": "Additional context to understand the customer's situation or prior interactions.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the response text (e.g., formal, friendly, empathetic).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the response (e.g., en, es, fr).", + "required": false, + "defaultValue": "en" + }, + { + "name": "responseType", + "type": "string", + "description": "Type of response to compose (e.g., apology, information, instruction, escalation).", + "required": false, + "defaultValue": "information" + }, + { + "name": "includeFAQLinks", + "type": "boolean", + "description": "Whether to include relevant FAQ or knowledge base links in the response.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed text message fitting the input parameters and ready for sending to the customer." + }, + "aiAgent": { + "useCase": "Use this tool when a customer support AI agent needs to draft clear, polite, and contextually appropriate response messages customized for the customer's query, tone preferences, and language. It aids in faster, high-quality message composition for support tickets and live chats.", + "limitations": "Cannot replace human judgment for complex cases requiring manual investigation or sensitive handling. It generates text drafts, but factual correctness and policy compliance should be verified before sending.", + "examples": [ + "Compose a friendly apology message addressing a delayed shipment query.", + "Write a brief technical instruction in Spanish to troubleshoot a connectivity issue.", + "Generate a formal escalation notice including FAQ links for an unresolved billing complaint." + ] + }, + "tags": [ + "customer-support", + "text-composition", + "response-generation", + "multilingual", + "tone-adaptive" + ], + "examples": [ + { + "inputJson": "{\"customerQuery\":\"My order hasn’t arrived and it’s already past the estimated delivery date.\",\"tone\":\"empathetic\",\"responseType\":\"apology\",\"includeFAQLinks\":true}", + "description": "Compose an empathetic apology message addressing a delayed order and including helpful FAQ links." + }, + { + "inputJson": "{\"customerQuery\":\"How do I reset my password?\",\"language\":\"en\",\"responseType\":\"instruction\"}", + "description": "Generate clear step-by-step instructions in English for a password reset query." + }, + { + "inputJson": "{\"customerQuery\":\"Tengo problemas para conectar a mi cuenta.\",\"language\":\"es\",\"tone\":\"formal\"}", + "description": "Write a formal response in Spanish for a connectivity issue reported by a customer." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Text", + "context": null + } + }, + { + "name": "customer-support.generateArticle", + "description": "Generates a detailed customer support article based on a given topic, issue description, and optional target audience or product context. Accepts textual inputs describing the problem or feature and outputs a structured, easy-to-understand article that can be published to help centers or FAQs.", + "category": "customer-support", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main topic or issue that the article should address, e.g., 'Password Reset' or 'Using Multi-Factor Authentication'.", + "required": true, + "defaultValue": "" + }, + { + "name": "issueDescription", + "type": "string", + "description": "A detailed description of the issue or subject matter that needs support documentation, including common questions or troubleshooting steps.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Optional. The intended audience for the article, such as 'end users', 'administrators', or 'developers'.", + "required": false, + "defaultValue": "" + }, + { + "name": "productName", + "type": "string", + "description": "Optional. The specific product or service name to tailor the article content accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTroubleshootingSteps", + "type": "boolean", + "description": "Whether to include a troubleshooting section with common fixes and diagnostics steps in the article.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "The language code for the generated article, e.g., 'en' for English, 'es' for Spanish. Defaults to English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated support article with title, content body formatted in markdown, and optionally sections like troubleshooting and FAQs." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically generate clear, user-friendly customer support articles from brief problem descriptions or topics. Ideal for maintaining or expanding help center documentation without manual writing.", + "limitations": "The generated article may need review for accuracy, compliance, and style consistency. It cannot replace expert technical manuals or guarantee resolution for all complex issues.", + "examples": [ + "Generate an article on resetting passwords for end users.", + "Create a support article explaining multi-factor authentication setup for administrators.", + "Produce a troubleshooting guide about login failures on ProductX." + ] + }, + "tags": [ + "customer-support", + "documentation", + "article-generation", + "help-center", + "knowledge-base", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Password Reset\",\"issueDescription\":\"Steps users need to follow in order to reset their forgotten passwords securely.\",\"targetAudience\":\"end users\",\"productName\":\"ExampleApp\",\"includeTroubleshootingSteps\":true,\"language\":\"en\"}", + "description": "Generate a comprehensive article guiding end users on how to reset their passwords in ExampleApp, including troubleshooting tips." + }, + { + "inputJson": "{\"topic\":\"Multi-Factor Authentication Setup\",\"issueDescription\":\"How administrators can enable and configure MFA for user accounts to improve security.\",\"targetAudience\":\"administrators\",\"productName\":\"SecurePortal\",\"includeTroubleshootingSteps\":false,\"language\":\"en\"}", + "description": "Create an instructional article for administrators on setting up MFA in SecurePortal, without troubleshooting sections." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Article", + "context": null + } + }, + { + "name": "customer-support.createLink", + "description": "Creates a customizable hyperlink for use in customer support communications or help desk systems. Accepts parameters to define the link URL, display text, optionally set target behaviors, tracking parameters, and accessibility attributes. Outputs a formatted HTML anchor tag string ready to embed in messages, emails, or web content.", + "category": "customer-support", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL the link will point to, must be a valid HTTP(s) URL.", + "required": true, + "defaultValue": "" + }, + { + "name": "displayText", + "type": "string", + "description": "The text that will be displayed for the link to customers or users.", + "required": true, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "Determines if the link should open in a new browser tab when clicked.", + "required": false, + "defaultValue": "false" + }, + { + "name": "trackingCode", + "type": "string", + "description": "Optional tracking code or UTM parameters appended to the URL for analytics purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "ariaLabel", + "type": "string", + "description": "Optional ARIA label to improve accessibility by providing descriptive text for screen readers.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete HTML anchor tag string for embedding in customer support content, with all specified attributes and encoding applied." + }, + "aiAgent": { + "useCase": "Use this tool when generating hyperlinks to include in customer support tickets, chat messages, FAQs or email templates. It enables dynamically creating accessible and trackable links that improve user interaction and analytics in customer support contexts.", + "limitations": "This tool does not validate the safety or legitimacy of URLs beyond basic schema checks, nor does it generate shortened URLs automatically.", + "examples": [ + "Create a link to a troubleshooting article opening in a new tab with tracking for newsletter clicks.", + "Generate a plain link with custom display text for embedding in a live chat response.", + "Create an accessible link with an ARIA label describing the destination clearly for screen reader users." + ] + }, + "tags": [ + "customer-support", + "link-creation", + "html", + "accessibility", + "tracking", + "communication" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://support.example.com/help/123\",\"displayText\":\"Help Article\",\"openInNewTab\":true,\"trackingCode\":\"?utm_source=newsletter&utm_medium=email\",\"ariaLabel\":\"Open Help Article about troubleshooting\"}", + "description": "Creates a tracked hyperlink to a help article that opens in a new tab with accessibility label." + }, + { + "inputJson": "{\"url\":\"https://faq.example.com\",\"displayText\":\"FAQ\",\"openInNewTab\":false,\"trackingCode\":\"\",\"ariaLabel\":\"\"}", + "description": "Creates a simple inline hyperlink to FAQ without new tab or tracking." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Link", + "context": null + } + }, + { + "name": "marketing-automation.uploadImage", + "description": "Uploads an image file to the marketing automation platform for use in campaigns, landing pages, or advertisements. Accepts an image file path or URL, processes it to validate format and size, and returns an image ID and metadata confirming successful upload.", + "category": "marketing-automation", + "parameters": [ + { + "name": "imageUrl", + "type": "string", + "description": "URL of the image to upload if available online. Either imageUrl or imageFilePath is required.", + "required": false, + "defaultValue": "" + }, + { + "name": "imageFilePath", + "type": "string", + "description": "Local file path to the image to upload. Either imageFilePath or imageUrl is required.", + "required": false, + "defaultValue": "" + }, + { + "name": "imageName", + "type": "string", + "description": "Optional name or title to assign to the uploaded image for easy identification.", + "required": false, + "defaultValue": "" + }, + { + "name": "altText", + "type": "string", + "description": "Alternative text description for accessibility and SEO purposes, associated with the image.", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Optional target width in pixels to resize the image maintaining aspect ratio before upload.", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Optional target height in pixels to resize the image maintaining aspect ratio before upload.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional list of tags or keywords to categorize the image within the marketing system.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing details about the uploaded image including a unique image ID, URL, dimensions, and confirmation status." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically upload images into a marketing platform for use in campaigns, newsletters, landing pages, or advertisements. It handles image validation, optional resizing, and returns metadata needed for referencing the image in further marketing activities.", + "limitations": "This tool cannot edit images beyond resizing, cannot upload unsupported file formats, and does not manage image copyright or licensing.", + "examples": [ + "Upload a local promotional banner image and assign descriptive alt text.", + "Upload an image from an external URL to be used in an email campaign.", + "Resize a product photo to specific dimensions before uploading to the media library." + ] + }, + "tags": [ + "marketing", + "image", + "upload", + "automation", + "media", + "campaign", + "resize" + ], + "examples": [ + { + "inputJson": "{\"imageFilePath\":\"/user/photos/spring_sale.jpg\",\"imageName\":\"Spring Sale Banner\",\"altText\":\"Banner promoting spring sale discounts\",\"resizeWidth\":1200,\"tags\":[\"sale\",\"spring\",\"banner\"]}", + "description": "Upload a local spring sale banner image with resize and tags." + }, + { + "inputJson": "{\"imageUrl\":\"https://example.com/images/product1.png\",\"altText\":\"New product image\",\"tags\":[\"product\",\"launch\"]}", + "description": "Upload product image from URL with alt text and tags." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Image", + "context": null + } + }, + { + "name": "marketing-automation.formatJSON", + "description": "Formats and validates marketing campaign data represented as JSON. Accepts raw JSON input along with options for indentation, sorting keys, and removing null or empty values, then outputs a neatly formatted JSON string ready for reporting or further processing.", + "category": "marketing-automation", + "parameters": [ + { + "name": "rawJson", + "type": "string", + "description": "Raw JSON string containing marketing campaign data to format and validate.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces for indentation in the output formatted JSON.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "If true, keys in all objects are sorted alphabetically in the output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "removeEmptyValues", + "type": "boolean", + "description": "If true, removes keys with null, empty string, or empty array values from the output JSON.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted JSON string and a boolean flag indicating whether the input was valid JSON." + }, + "aiAgent": { + "useCase": "Use this tool when you have marketing campaign data in raw or messy JSON format that needs to be validated and consistently formatted before analytics, reporting, or import into other systems. It helps clean and standardize JSON data automatically.", + "limitations": "This tool does not perform semantic validation or enrichment of marketing data (e.g., no campaign performance analysis). It only formats and cleans JSON structure.", + "examples": [ + "Format raw JSON marketing campaign data with 4 spaces indentation.", + "Sort keys alphabetically and remove empty values from the JSON input.", + "Validate a JSON string and output a neatly indented version for reporting." + ] + }, + "tags": [ + "marketing", + "automation", + "json", + "formatting", + "data-cleaning", + "campaign-data" + ], + "examples": [ + { + "inputJson": "{\"rawJson\":\"{\\\"campaign\\\":\\\"Spring Sale\\\",\\\"startDate\\\":\\\"2024-04-01\\\",\\\"budget\\\":null}\",\"indentation\":4,\"sortKeys\":false,\"removeEmptyValues\":true}", + "description": "Format JSON with 4 spaces indentation and remove keys with null values." + }, + { + "inputJson": "{\"rawJson\":\"{\\\"budget\\\":5000,\\\"campaign\\\":\\\"Holiday Promo\\\",\\\"channels\\\":[\\\"email\\\",\\\"social\\\"]}\",\"indentation\":2,\"sortKeys\":true,\"removeEmptyValues\":false}", + "description": "Format and sort keys alphabetically with 2 spaces indentation." + }, + { + "inputJson": "{\"rawJson\":\"{\\\"campaign\\\":\\\"Launch\\\",\\\"details\\\":{\\\"startDate\\\":\\\"2024-06-01\\\",\\\"endDate\\\":\\\"2024-06-30\\\"},\\\"notes\\\":\\\"\\\"}\",\"indentation\":2,\"sortKeys\":false,\"removeEmptyValues\":true}", + "description": "Format JSON removing empty string values without sorting keys." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "JSON", + "context": null + } + }, + { + "name": "marketing-automation.generateLink", + "description": "Generates a personalized marketing URL with embedded tracking parameters based on campaign details, target audience segments, and optional custom tags. Accepts base URL and marketing parameters, processes them to append UTM tags and personalized tokens, outputs a trackable, ready-to-use link for campaign distribution.", + "category": "marketing-automation", + "parameters": [ + { + "name": "baseUrl", + "type": "string", + "description": "The original URL to which tracking parameters will be appended.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignName", + "type": "string", + "description": "The name of the marketing campaign for UTM tagging and identification.", + "required": true, + "defaultValue": "" + }, + { + "name": "source", + "type": "string", + "description": "Marketing source (e.g., newsletter, social, paid) to include in tracking parameters.", + "required": true, + "defaultValue": "" + }, + { + "name": "medium", + "type": "string", + "description": "Marketing medium (e.g., email, cpc, banner) for UTM parameters.", + "required": true, + "defaultValue": "" + }, + { + "name": "term", + "type": "string", + "description": "Keyword term for paid search campaigns, added to the URL as a UTM parameter.", + "required": false, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "Content descriptor for differentiating ads or links pointing to the same URL.", + "required": false, + "defaultValue": "" + }, + { + "name": "audienceSegment", + "type": "string", + "description": "Identifier for the targeted audience segment, embedded as a URL parameter for personalization or tracking.", + "required": false, + "defaultValue": "" + }, + { + "name": "customParameters", + "type": "object", + "description": "Additional custom key-value parameters to append to the URL for advanced tracking or personalization.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated URL as a string with all specified tracking and custom parameters properly URL-encoded and appended." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate marketing campaign URLs with UTM and custom tracking parameters for accurate source attribution and audience segmentation in analytics platforms. Ideal for automating link generation across multiple campaigns, mediums, or audience groups.", + "limitations": "Does not validate the target URL's reachability or the correctness of marketing parameter values; does not shorten URLs; assumes parameters are URL-safe strings or appropriately encoded.", + "examples": [ + "Generate a URL for a new email campaign targeting segment A with custom parameters for A/B testing.", + "Create trackable links for a paid social campaign with differing content tags for multiple ads.", + "Produce personalized URLs embedding audience segment IDs for dynamic website content delivery." + ] + }, + "tags": [ + "marketing", + "automation", + "URL generation", + "tracking", + "campaign", + "UTM", + "personalization" + ], + "examples": [ + { + "inputJson": "{\"baseUrl\":\"https://example.com/landing\",\"campaignName\":\"spring_sale\",\"source\":\"newsletter\",\"medium\":\"email\",\"term\":\"discount\",\"content\":\"header_banner\",\"audienceSegment\":\"segmentA\",\"customParameters\":{\"ref\":\"newsletter_01\",\"promoCode\":\"SPRING10\"}}", + "description": "Generating a trackable link for a spring sale email campaign with keywords, content differentiation, audience segmentation, and custom promo codes." + }, + { + "inputJson": "{\"baseUrl\":\"https://shop.example.com/product\",\"campaignName\":\"summer_launch\",\"source\":\"social\",\"medium\":\"cpc\",\"content\":\"video_ad\",\"customParameters\":{\"creativeId\":\"vid123\",\"placement\":\"feed_top\"}}", + "description": "Create a tracked URL for a paid social campaign with custom ad creative identifiers for an e-commerce product launch." + }, + { + "inputJson": "{\"baseUrl\":\"https://example.com/signup\",\"campaignName\":\"webinar_invite\",\"source\":\"paid_search\",\"medium\":\"cpc\",\"term\":\"webinar+signup\"}", + "description": "Generate a URL for a paid search campaign targeting webinar sign-ups with specific keyword tracking." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Link", + "context": null + } + }, + { + "name": "marketing-automation.createArticle", + "description": "Generates a marketing article based on provided topic, target audience, keywords, and tone. Accepts structured input parameters to guide content style and focus. Outputs a fully formed article text suitable for use in marketing campaigns or blogs.", + "category": "marketing-automation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the article to generate.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers or customer segment for the article.", + "required": false, + "defaultValue": "general public" + }, + { + "name": "keywords", + "type": "array", + "description": "List of important keywords or phrases to include within the article content for SEO or emphasis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the article, e.g., formal, casual, persuasive, informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "wordCount", + "type": "number", + "description": "Approximate length of the article in words.", + "required": false, + "defaultValue": "500" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to append a marketing call-to-action at the end of the article.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article text, title, and optionally summary or key points." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate marketing articles tailored to specific topics, audience segments, and SEO strategies. Ideal for automating content creation workflows or dynamically producing blog posts and campaign materials based on structured inputs.", + "limitations": "The tool cannot verify factual accuracy or provide complex data analysis. It may produce generic or repetitive content if inputs are too vague or broad.", + "examples": [ + "Create a 700-word persuasive article about eco-friendly packaging targeted at young adults with keywords: sustainable, biodegradable, green packaging.", + "Generate an informative blog post about digital marketing trends including keywords: SEO, social media, content marketing, tone formal.", + "Produce a short 300-word article introducing a new product launch with a casual tone and a call-to-action to visit the website." + ] + }, + "tags": [ + "marketing", + "content-generation", + "article-writing", + "SEO", + "automation", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of remote work\",\"targetAudience\":\"HR managers\",\"keywords\":[\"remote work\",\"productivity\",\"flexibility\"],\"tone\":\"informative\",\"wordCount\":600,\"includeCallToAction\":true}", + "description": "Generate an informative article on the benefits of remote work for HR managers, including key SEO keywords and a call-to-action." + }, + { + "inputJson": "{\"topic\":\"New vegan protein powder launch\",\"targetAudience\":\"fitness enthusiasts\",\"keywords\":[\"vegan protein\",\"plant-based\",\"healthy lifestyle\"],\"tone\":\"persuasive\",\"wordCount\":500,\"includeCallToAction\":true}", + "description": "Create a persuasive marketing article introducing a new vegan protein powder, targeting fitness enthusiasts with relevant keywords and CTA." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Article", + "context": null + } + }, + { + "name": "sales-automation.createOrder", + "description": "Creates a new sales order by accepting customer details, a list of products with quantities, and payment information. It processes the input to generate a validated order record with pricing, taxes, and order ID, then returns the complete order summary including status and estimated delivery.", + "category": "sales-automation", + "parameters": [ + { + "name": "customerId", + "type": "string", + "description": "Unique identifier of the customer placing the order.", + "required": true, + "defaultValue": "" + }, + { + "name": "products", + "type": "array", + "description": "Array of objects representing products to order, each with productId (string) and quantity (number).", + "required": true, + "defaultValue": "" + }, + { + "name": "shippingAddress", + "type": "object", + "description": "Shipping address details including street, city, state, postalCode, and country.", + "required": true, + "defaultValue": "" + }, + { + "name": "paymentMethod", + "type": "string", + "description": "Type of payment method chosen, e.g., credit_card, paypal, or bank_transfer.", + "required": true, + "defaultValue": "" + }, + { + "name": "promoCode", + "type": "string", + "description": "Optional promotional code to apply discounts to the order.", + "required": false, + "defaultValue": "" + }, + { + "name": "priorityShipping", + "type": "boolean", + "description": "Flag indicating whether the order should be shipped with priority handling.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the orderId, customerId, list of purchased items with prices, total amount including taxes and discounts, order status, estimated delivery date, and payment confirmation details." + }, + "aiAgent": { + "useCase": "Use when you need to automate the creation of a sales order from structured input including customer info, product selections, and payment details. Ideal for CRM or sales workflow integration to generate validated orders and provide confirmation data.", + "limitations": "This tool does not process payment transactions or handle inventory stock validation beyond basic checks. It assumes product IDs and customer IDs are valid and exists in the system.", + "examples": [ + "CreateOrder for customer 123 with 2 units of product A and 1 unit of product B, paying via credit card.", + "Generate a priority shipping order applying a promo code for a returning customer with shipping address updated.", + "Make a bulk order without promo code but with bank_transfer payment method and standard shipping." + ] + }, + "tags": [ + "sales", + "orderManagement", + "automation", + "leadConversion", + "customerOrders", + "paymentProcessing" + ], + "examples": [ + { + "inputJson": "{\"customerId\":\"cust_001\",\"products\":[{\"productId\":\"prod_100\",\"quantity\":2},{\"productId\":\"prod_101\",\"quantity\":1}],\"shippingAddress\":{\"street\":\"123 Elm St\",\"city\":\"Springfield\",\"state\":\"IL\",\"postalCode\":\"62704\",\"country\":\"USA\"},\"paymentMethod\":\"credit_card\",\"promoCode\":\"SUMMER21\",\"priorityShipping\":true}", + "description": "Create a priority shipping order for customer cust_001 buying 2 units of prod_100 and 1 unit of prod_101 using a promo code and credit card payment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Order", + "context": null + } + }, + { + "name": "finance-tools.generateText", + "description": "Generates customized financial reports or summary texts based on input data such as transaction history, account balances, or investment portfolios. Processes the provided financial data and templates to produce clear, concise textual outputs suitable for reports, presentations, or client updates.", + "category": "finance-tools", + "parameters": [ + { + "name": "reportType", + "type": "string", + "description": "Type of financial report or summary text to generate, e.g., 'monthly statement', 'investment summary', or 'budget analysis'.", + "required": true, + "defaultValue": "" + }, + { + "name": "financialData", + "type": "object", + "description": "Structured financial data object including transactions, balances, or other numerical information to base the text on.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language for the generated text output, e.g., 'en' for English, 'es' for Spanish.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Indicates whether to include textual descriptions of charts or graphs in the generated text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "dateRange", + "type": "object", + "description": "Date range filter for the financial data to be included in the report, with 'start' and 'end' date strings in ISO format.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text string as 'reportText', optionally including a summary and metadata such as generation timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when needing an automatically generated narrative or summary from raw financial data, to produce human-readable text reports for client communication, internal reviews, or documentation. It helps transform structured financial data into clear, formatted textual content tailored to financial contexts and report types.", + "limitations": "This tool does not create graphical charts or visual content, nor does it perform advanced financial analysis beyond summarizing input data. It requires accurate and well-structured input financial data to produce meaningful text.", + "examples": [ + "Generate a monthly financial statement text summary for a client's checking and savings account transactions for April 2024.", + "Produce an investment portfolio summary report text highlighting gains, losses, and asset allocation in English.", + "Create a budget analysis text report for the Q2 2024 time frame including transaction data and categorical spending breakdown." + ] + }, + "tags": [ + "finance", + "report-generation", + "text-synthesis", + "financial-summary", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"reportType\":\"monthly statement\",\"financialData\":{\"accounts\":[{\"id\":\"acc123\",\"type\":\"checking\",\"transactions\":[{\"date\":\"2024-04-05\",\"amount\":-60.00,\"description\":\"Groceries\"},{\"date\":\"2024-04-10\",\"amount\":1000.00,\"description\":\"Salary Deposit\"}]}]},\"dateRange\":{\"start\":\"2024-04-01\",\"end\":\"2024-04-30\"},\"language\":\"en\"}", + "description": "Generate a monthly statement text report summarizing checking account transactions for April 2024." + }, + { + "inputJson": "{\"reportType\":\"investment summary\",\"financialData\":{\"portfolio\":{\"stocks\":[{\"symbol\":\"AAPL\",\"quantity\":50,\"avgPrice\":140}],\"bonds\":[],\"cash\":5000,\"gains\":350}},\"language\":\"en\"}", + "description": "Generate an English investment summary report outlining portfolio holdings and gains." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "finance-tools.formatDocument", + "description": "Formats various financial documents such as invoices, receipts, and financial statements. Accepts raw document data in JSON or text form, applies formatting rules based on document type and locale settings, and outputs a standardized, human-readable document ready for presentation or printing.", + "category": "finance-tools", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of financial document to format (e.g., invoice, receipt, statement).", + "required": true, + "defaultValue": "" + }, + { + "name": "documentData", + "type": "object", + "description": "Raw data object containing the financial information to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "locale", + "type": "string", + "description": "Locale code to format numbers, currency, and dates accordingly (e.g., 'en-US', 'fr-FR').", + "required": false, + "defaultValue": "en-US" + }, + { + "name": "currencyCode", + "type": "string", + "description": "ISO currency code (e.g., USD, EUR) to format monetary values appropriately.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "includeLogo", + "type": "boolean", + "description": "Whether to include a company or brand logo in the formatted document if available.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format, such as 'pdf', 'html', or 'plaintext'.", + "required": false, + "defaultValue": "html" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted document as a string in the specified output format, along with metadata about the formatting applied." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to convert raw financial data into a professionally formatted financial document. It is useful for generating invoices, receipts, or financial statements that comply with locale-specific standards and present financial info clearly and accurately.", + "limitations": "This tool does not generate financial data or validate accounting correctness. It cannot perform computations or audit data integrity. It also does not support custom template designs beyond preset formatting rules.", + "examples": [ + "Format a JSON invoice object into a PDF invoice document localized for German customers.", + "Generate an HTML receipt from raw receipt data applying US locale and USD currency formatting.", + "Create a plain text financial statement report from provided data for quick review." + ] + }, + "tags": [ + "finance", + "document", + "formatting", + "invoices", + "receipts", + "localization", + "currency", + "pdf" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"invoice\",\"documentData\":{\"invoiceNumber\":\"INV-1001\",\"date\":\"2024-05-30\",\"customer\":{\"name\":\"Acme Corp\"},\"items\":[{\"description\":\"Consulting Services\",\"quantity\":10,\"unitPrice\":150}],\"taxRate\":0.2},\"locale\":\"de-DE\",\"currencyCode\":\"EUR\",\"includeLogo\":true,\"outputFormat\":\"pdf\"}", + "description": "Format an invoice in PDF for a German locale with Euro currency and include company logo." + }, + { + "inputJson": "{\"documentType\":\"receipt\",\"documentData\":{\"receiptNumber\":\"RCPT-4578\",\"date\":\"2024-06-01\",\"paymentMethod\":\"Credit Card\",\"items\":[{\"description\":\"Office Supplies\",\"amount\":79.99}]},\"locale\":\"en-US\",\"currencyCode\":\"USD\",\"includeLogo\":false,\"outputFormat\":\"html\"}", + "description": "Create an HTML receipt in US English without logo and USD currency formatting." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Document", + "context": null + } + }, + { + "name": "finance-tools.formatCode", + "description": "Formats financial code snippets such as formulas, scripts, or configuration code used in financial management systems. Accepts raw code as string input, processes it for consistent indentation, line breaks, and style according to specified language rules, and outputs the well-formatted code string ready for use or presentation.", + "category": "finance-tools", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The raw financial code snippet or script that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming or scripting language of the code, e.g., 'Python', 'ExcelFormula', 'JavaScript'. Used to apply language-specific formatting rules.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use per indentation level.", + "required": false, + "defaultValue": "4" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tab characters instead of spaces for indentation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "The maximum allowed line length before wrapping or breaking lines.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted code string with applied indentation and line breaks, or error messages if formatting failed." + }, + "aiAgent": { + "useCase": "When an AI agent encounters unformatted or messy financial code snippets — such as Excel formulas, custom scripts for financial calculations, or configuration code for financial software — it can use this tool to clean and standardize the code to improve readability, maintainability, and integration into reports or financial applications.", + "limitations": "Cannot execute or validate the financial logic correctness of the code, only formats syntax and style. Limited language support mainly for common financial scripting languages or formula notations.", + "examples": [ + "Format this unindented Python script calculating net present value.", + "Clean up this Excel formula to be more readable.", + "Apply consistent formatting to JavaScript code for a financial dashboard." + ] + }, + "tags": [ + "formatting", + "finance", + "code", + "script", + "formula", + "financial-calculations" + ], + "examples": [ + { + "inputJson": "{\"code\":\"NPV = 0\\nrate = 0.05\\nfor i in range(1,6):NPV += 1000/(1+rate)**i\",\"language\":\"Python\",\"indentSize\":2,\"useTabs\":false,\"maxLineLength\":80}", + "description": "Formats a Python script calculating net present value with consistent indentation and line breaks." + }, + { + "inputJson": "{\"code\":\"=SUM(A1:A5)/COUNT(A1:A5)\",\"language\":\"ExcelFormula\",\"indentSize\":4,\"useTabs\":false,\"maxLineLength\":40}", + "description": "Formats an Excel formula to ensure consistent spacing and readability." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "finance-tools.generateDataset", + "description": "Generates a synthetic financial dataset based on specified parameters including dataset size, date range, transaction categories, and currency. The tool creates realistic transaction records with fields such as transaction ID, date, amount, category, and description, useful for financial analysis, testing, or training models.", + "category": "finance-tools", + "parameters": [ + { + "name": "numRecords", + "type": "number", + "description": "Number of financial transaction records to generate.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date for transaction timestamps in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date for transaction timestamps in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "categories", + "type": "array", + "description": "List of transaction categories to include (e.g., ['Groceries','Utilities','Salary']).", + "required": false, + "defaultValue": "[\"Salary\",\"Groceries\",\"Utilities\",\"Entertainment\",\"Rent\"]" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for transaction amounts, e.g., USD, EUR.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "includeDescription", + "type": "boolean", + "description": "Whether to include a short description for each transaction.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array named 'transactions', where each transaction includes an ID, date, amount, category, optionally a description, and currency code." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create realistic, configurable financial transaction datasets for testing software, training machine learning models, analyzing financial workflows without sensitive real data, or demonstrating financial management processes.", + "limitations": "This tool generates synthetic rather than real or historical financial data and does not support integration with live financial feeds or personal financial records.", + "examples": [ + "Generate a dataset of 1000 transactions between 2023-01-01 and 2023-06-30 including default categories, in USD.", + "Create 500 transactions from 2022-01-01 to 2022-12-31 with categories 'Salary' and 'Rent' only, without descriptions.", + "Produce 200 transactions in EUR currency spanning past 3 months including all categories and descriptions." + ] + }, + "tags": [ + "finance", + "dataset generation", + "synthetic data", + "financial transactions", + "testing data", + "machine learning" + ], + "examples": [ + { + "inputJson": "{\"numRecords\":1000,\"startDate\":\"2023-01-01\",\"endDate\":\"2023-06-30\"}", + "description": "Generate 1000 transactions within first half of 2023 using default categories and USD currency." + }, + { + "inputJson": "{\"numRecords\":500,\"startDate\":\"2022-01-01\",\"endDate\":\"2022-12-31\",\"categories\":[\"Salary\",\"Rent\"],\"includeDescription\":false}", + "description": "Generate 500 transactions for year 2022 limited to Salary and Rent categories with no descriptions." + }, + { + "inputJson": "{\"numRecords\":200,\"startDate\":\"2024-03-01\",\"endDate\":\"2024-05-31\",\"currency\":\"EUR\"}", + "description": "Generate 200 transactions over last three months in Euro currency including descriptions." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Dataset", + "context": null + } + }, + { + "name": "finance-tools.createServer", + "description": "Creates and configures a dedicated server optimized for hosting financial management and accounting applications. Accepts parameters for server specs, security protocols, and software stack. Provisions the server with specified OS and finance-related software, and outputs server details including access credentials and configuration summary.", + "category": "finance-tools", + "parameters": [ + { + "name": "serverName", + "type": "string", + "description": "A unique name identifier for the server instance.", + "required": true, + "defaultValue": "" + }, + { + "name": "cpuCores", + "type": "number", + "description": "Number of CPU cores to allocate for processing power.", + "required": true, + "defaultValue": "4" + }, + { + "name": "memoryGB", + "type": "number", + "description": "Amount of RAM in gigabytes to allocate for the server.", + "required": true, + "defaultValue": "16" + }, + { + "name": "storageGB", + "type": "number", + "description": "Size of SSD storage in gigabytes for data and applications.", + "required": true, + "defaultValue": "100" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "The operating system to install on the server (e.g., Ubuntu 22.04, Windows Server 2019).", + "required": true, + "defaultValue": "Ubuntu 22.04" + }, + { + "name": "enableFirewall", + "type": "boolean", + "description": "Whether to enable and configure a firewall with recommended security settings.", + "required": false, + "defaultValue": "true" + }, + { + "name": "financeSoftwareStack", + "type": "array", + "description": "List of financial management or accounting software to pre-install (e.g., QuickBooks, Odoo ERP).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "backupEnabled", + "type": "boolean", + "description": "Flag indicating if automated backups should be configured.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing server deployment details, including serverId, IP address, admin access credentials, installed software, and configuration summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to provision a dedicated server environment tailored for financial management or accounting applications, especially when specific hardware specs, OS, and software installations are required to ensure compliance, security, and performance.", + "limitations": "This tool does not manage continuous server maintenance, real-time monitoring, or dynamic scaling. It only creates initial server infrastructure and setups. Post-deployment management must be handled separately.", + "examples": [ + "Create a high-performance server with 8 CPU cores and 32GB RAM, pre-installed with QuickBooks for accounting.", + "Set up a secure Ubuntu server with firewall and backup enabled for hosting financial applications.", + "Provision a Windows Server 2019 machine with 16GB RAM and Odoo ERP installed for finance operations." + ] + }, + "tags": [ + "server", + "infrastructure", + "financial management", + "accounting", + "deployment", + "automation", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"serverName\":\"FinanceProdServer1\",\"cpuCores\":8,\"memoryGB\":32,\"storageGB\":200,\"operatingSystem\":\"Ubuntu 22.04\",\"enableFirewall\":true,\"financeSoftwareStack\":[\"QuickBooks\"],\"backupEnabled\":true}", + "description": "Create a production-grade server with 8 CPUs and 32GB RAM, firewall and backup, pre-installed QuickBooks." + }, + { + "inputJson": "{\"serverName\":\"AccountingTestServer\",\"cpuCores\":4,\"memoryGB\":16,\"storageGB\":100,\"operatingSystem\":\"Windows Server 2019\",\"enableFirewall\":true,\"financeSoftwareStack\":[\"Odoo ERP\"],\"backupEnabled\":false}", + "description": "Set up a test server with Windows Server 2019 and Odoo ERP installed, firewall enabled, no backup." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Server", + "context": null + } + }, + { + "name": "translation.uploadFile", + "description": "Uploads a text or document file for the purpose of translating its contents from a source language to a target language. The tool accepts file inputs (TXT, DOCX, PDF), extracts text content, performs machine translation, and returns the translated text as a string or downloadable document link.", + "category": "translation", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Path or URL to the file to be uploaded and translated. Supports TXT, DOCX, PDF formats.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceLanguage", + "type": "string", + "description": "ISO language code representing the source language of the document. If omitted, auto-detection is attempted.", + "required": false, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "ISO language code representing the target language to translate the document into.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the translation, e.g., 'text' for plain text output or 'docx' for formatted document output.", + "required": false, + "defaultValue": "text" + }, + { + "name": "preserveFormatting", + "type": "boolean", + "description": "Whether to preserve original document formatting (applicable for DOCX and PDF inputs).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object including the translated text as a string and, if applicable, a URL to download the translated document in the requested format." + }, + "aiAgent": { + "useCase": "Use this tool when you need to upload a document file to be translated from one language to another including handling various document formats and optionally preserving formatting. It is suitable for translating reports, letters, contracts, or educational materials provided as files.", + "limitations": "Cannot translate scanned images or handwritten documents effectively. Large files may have size limits. Formatting preservation is limited to standard styles; complex layouts might not be fully preserved.", + "examples": [ + "Translate a DOCX proposal from English to Spanish preserving formatting.", + "Upload a PDF report in French and get plain text translation in English.", + "Translate a TXT file from auto-detected language to German without preserving formatting." + ] + }, + "tags": [ + "translation", + "upload", + "file", + "document", + "language", + "multilingual", + "document-translation", + "machine-translation" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/documents/contract.docx\",\"sourceLanguage\":\"en\",\"targetLanguage\":\"es\",\"outputFormat\":\"docx\",\"preserveFormatting\":true}", + "description": "Translate an English contract DOCX file to Spanish, keeping formatting." + }, + { + "inputJson": "{\"filePath\":\"https://example.com/report.pdf\",\"sourceLanguage\":\"fr\",\"targetLanguage\":\"en\",\"outputFormat\":\"text\",\"preserveFormatting\":false}", + "description": "Translate a French PDF report to English as plain text." + }, + { + "inputJson": "{\"filePath\":\"/texts/notes.txt\",\"sourceLanguage\":\"\",\"targetLanguage\":\"de\",\"outputFormat\":\"text\",\"preserveFormatting\":false}", + "description": "Upload a TXT file with unknown source language and translate it to German." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "File", + "context": null + } + }, + { + "name": "translation.composeEmail", + "description": "This tool generates a professionally composed email in a specified target language. It accepts key email elements such as recipient, subject, body content summary, and desired tone, translates the content if needed, and returns a fully written email ready to send, respecting linguistic and cultural conventions of the target language.", + "category": "translation", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the email recipient to personalize the greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Email subject line to be translated and included.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodySummary", + "type": "string", + "description": "A brief summary or key points to include in the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceLanguage", + "type": "string", + "description": "Language code of the original content (e.g., 'en' for English).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "Language code into which the email should be composed (e.g., 'fr' for French).", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email, such as formal, informal, friendly, or professional.", + "required": false, + "defaultValue": "formal" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed email with subject and body text translated and styled according to the target language and tone." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a complete email in a different language based on key information and desired tone. It helps in crafting culturally appropriate and fluent emails that do not just translate but also compose content. Ideal for cross-lingual communication tasks.", + "limitations": "This tool does not send emails or handle email metadata such as attachments or headers. It may not perfectly capture idiomatic expressions or very technical language requiring human review, especially for complex or sensitive correspondence.", + "examples": [ + "Compose a formal business email in Spanish introducing a product to a client named Carlos.", + "Generate a friendly invitation email in French for an event, addressed to Sophie.", + "Create an informal thank-you email in Japanese for a colleague named Takashi." + ] + }, + "tags": [ + "translation", + "email", + "language", + "communication", + "composition", + "multilingual", + "formal", + "informal" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Carlos\",\"subject\":\"Product Launch\",\"bodySummary\":\"Introducing our new software product with key features and pricing details.\",\"sourceLanguage\":\"en\",\"targetLanguage\":\"es\",\"tone\":\"formal\"}", + "description": "Compose a formal Spanish email introducing a product launch to Carlos." + }, + { + "inputJson": "{\"recipientName\":\"Sophie\",\"subject\":\"Birthday Party Invitation\",\"bodySummary\":\"Inviting to a casual birthday party next Saturday evening.\",\"sourceLanguage\":\"en\",\"targetLanguage\":\"fr\",\"tone\":\"friendly\"}", + "description": "Generate a friendly French invitation email for Sophie." + }, + { + "inputJson": "{\"recipientName\":\"Takashi\",\"subject\":\"Thank You\",\"bodySummary\":\"Expressing gratitude for help on recent project.\",\"sourceLanguage\":\"en\",\"targetLanguage\":\"ja\",\"tone\":\"informal\"}", + "description": "Create an informal Japanese thank-you email to Takashi." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "translation.composeDocument", + "description": "This tool accepts a source text document in one language and translates it into a specified target language. It processes the input to produce a coherent, linguistically accurate translated document while maintaining the original formatting and context. The output is the translated document text suitable for professional or casual use.", + "category": "translation", + "parameters": [ + { + "name": "sourceText", + "type": "string", + "description": "The complete text content of the document to be translated.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceLanguage", + "type": "string", + "description": "The language code of the source text (e.g., 'en' for English).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "The language code into which the document should be translated (e.g., 'fr' for French).", + "required": true, + "defaultValue": "" + }, + { + "name": "formalTone", + "type": "boolean", + "description": "If true, translates the document using a formal tone; otherwise informal tone is used.", + "required": false, + "defaultValue": "false" + }, + { + "name": "preserveFormatting", + "type": "boolean", + "description": "Indicates whether to preserve the original document formatting such as paragraphs and lists during translation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "glossary", + "type": "object", + "description": "Optional user-provided dictionary mapping source terms to preferred translation terms to ensure consistency.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the translated document text and metadata including detected language, word count, and translation quality score." + }, + "aiAgent": { + "useCase": "Use this tool when you need to translate entire documents from one language to another, ensuring the output preserves the original meaning, style, and formatting, useful for multi-lingual document preparation, localization, and communications.", + "limitations": "Cannot translate extremely technical or domain-specific jargon without specialized glossaries. May not perfectly preserve complex formatting like images or tables.", + "examples": [ + "Translate a marketing brochure from English to Spanish keeping a formal tone.", + "Convert an informal blog post from French to English.", + "Translate a legal document from German to English with a glossary for legal terms." + ] + }, + "tags": [ + "translation", + "document", + "language", + "localization", + "multilingual", + "text-processing" + ], + "examples": [ + { + "inputJson": "{\"sourceText\":\"Welcome to our annual company event. We hope you enjoy the presentations and networking opportunities.\",\"sourceLanguage\":\"en\",\"targetLanguage\":\"es\",\"formalTone\":true,\"preserveFormatting\":true}", + "description": "Translating an English company event introduction into formal Spanish, keeping paragraph structure." + }, + { + "inputJson": "{\"sourceText\":\"Salut! Je vais au marché demain.\",\"sourceLanguage\":\"fr\",\"targetLanguage\":\"en\",\"formalTone\":false,\"preserveFormatting\":true}", + "description": "Translating an informal French sentence into English with informal tone preserved." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "translation.createContract", + "description": "This tool accepts source contract text and target language code, then translates the entire contract text accurately while preserving legal terminology and formatting suited for contracts. It produces a translated contract document as plain text, suitable for legal review or localization.", + "category": "translation", + "parameters": [ + { + "name": "sourceText", + "type": "string", + "description": "The full contract text to be translated, including all clauses and sections.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "The language code (ISO 639-1) specifying the target language for the contract translation.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceLanguage", + "type": "string", + "description": "Optional ISO 639-1 code for the source language to improve translation accuracy; if empty, auto-detection is used.", + "required": false, + "defaultValue": "" + }, + { + "name": "preserveFormatting", + "type": "boolean", + "description": "Indicates whether to keep original formatting such as headings and bullet points in the translated text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "legalDomain", + "type": "string", + "description": "Optional specification of legal domain (e.g., employment, sales, real estate) to optimize terminology accuracy.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the translated contract text and metadata such as detected source language and any translation notes." + }, + "aiAgent": { + "useCase": "Use when a user needs to translate a legal contract document from one language to another while maintaining precise legal terminology and document structure to support localization or international legal processes. Especially useful for ensuring contracts remain legally coherent after translation.", + "limitations": "This tool does not provide legal advice, validate the legality of translated content, or certify documents. It may not handle extremely complex formatted documents perfectly and should be reviewed by a qualified legal translator.", + "examples": [ + "Translate an employment contract from English to Spanish preserving all legal terms.", + "Convert a sales contract written in French into German with proper clause formatting.", + "Localize a real estate lease agreement from Spanish to English ensuring the terminology fits that legal domain." + ] + }, + "tags": [ + "translation", + "legal", + "contract", + "document", + "localization", + "multilingual", + "legal-translation" + ], + "examples": [ + { + "inputJson": "{\"sourceText\":\"This Employment Contract is made between Employer and Employee...\",\"targetLanguage\":\"es\",\"sourceLanguage\":\"en\",\"preserveFormatting\":true,\"legalDomain\":\"employment\"}", + "description": "Translate an employment contract from English to Spanish while preserving structure and terminology." + }, + { + "inputJson": "{\"sourceText\":\"Ce contrat de vente est conclu entre le vendeur et l'acheteur...\",\"targetLanguage\":\"de\",\"sourceLanguage\":\"fr\",\"preserveFormatting\":true,\"legalDomain\":\"sales\"}", + "description": "Translate a sales contract from French to German maintaining legal terms and organization." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "copywriting.analyzeMessage", + "description": "Analyzes a marketing or promotional message to evaluate its tone, clarity, persuasiveness, and emotional impact. Accepts a text message as input, processes linguistic and semantic features to generate a detailed report assessing effectiveness and suggesting improvements, and outputs a structured analysis summary.", + "category": "copywriting", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The marketing or promotional message text to analyze for effectiveness and style.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en' for English) of the input message to tailor analysis accordingly.", + "required": false, + "defaultValue": "en" + }, + { + "name": "analyzeTone", + "type": "boolean", + "description": "Whether to analyze the message tone (e.g., friendly, urgent).", + "required": false, + "defaultValue": "true" + }, + { + "name": "analyzeClarity", + "type": "boolean", + "description": "Whether to evaluate the clarity and simplicity of the message.", + "required": false, + "defaultValue": "true" + }, + { + "name": "analyzePersuasiveness", + "type": "boolean", + "description": "Whether to assess the persuasiveness and call-to-action strength.", + "required": false, + "defaultValue": "true" + }, + { + "name": "returnSuggestions", + "type": "boolean", + "description": "Whether to include suggestions for improving the message in the output.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report including tone classification, clarity score, persuasiveness rating, emotional impact summary, and optionally suggestions for improvement." + }, + "aiAgent": { + "useCase": "Use this tool when you need to evaluate the quality and effectiveness of marketing communications such as ad copy, promotional emails, or social media posts to optimize messaging. It provides linguistic and psychological insights that help refine tone, clarity, and motivation power based on the input text.", + "limitations": "Does not perform cultural sensitivity or legal compliance checks. May not accurately interpret niche industry jargon without customization.", + "examples": [ + "Analyze the tone and persuasiveness of this advertisement text.", + "Evaluate clarity and provide suggestions to improve this marketing email.", + "Check emotional impact and recommend improvements for our social media campaign message." + ] + }, + "tags": [ + "copywriting", + "message analysis", + "marketing", + "tone analysis", + "persuasiveness", + "clarity", + "content optimization" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"Buy one get one free! Limited time offer until Sunday. Don’t miss out!\",\"language\":\"en\"}", + "description": "A promotional sales message to analyze for tone, persuasiveness, and clarity." + }, + { + "inputJson": "{\"messageText\":\"Our new software improves productivity by 50% in just one month.\",\"analyzeTone\":true,\"analyzePersuasiveness\":true}", + "description": "Marketing message highlighting product benefits to evaluate effectiveness and emotional appeal." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "content-creation.downloadJSON", + "description": "This tool generates a downloadable JSON file from provided structured data. It accepts an object or array as input, optionally formats the output with indentation for readability, and returns a downloadable file link or base64 content that can be used to save the JSON data to the user's device or further processed in applications.", + "category": "content-creation", + "parameters": [ + { + "name": "data", + "type": "object", + "description": "The JavaScript object or array that will be converted into JSON and prepared for download.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "The desired filename for the downloaded JSON file, including extension (e.g., 'data.json').", + "required": false, + "defaultValue": "\"data.json\"" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for JSON pretty-printing indentation. Use 0 or omit for minified output.", + "required": false, + "defaultValue": "2" + }, + { + "name": "returnBase64", + "type": "boolean", + "description": "If true, returns the JSON content as a base64-encoded string instead of a download URL.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing either a 'downloadUrl' string for the JSON file or a 'base64Content' string of the JSON data, depending on 'returnBase64' parameter." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert structured data into a properly formatted JSON file that the end user or system can download or store. Useful in content management, exporting settings, or sharing data snapshots in JSON format. Supports pretty-printing and flexible output modes for diverse application requirements.", + "limitations": "This tool does not validate the data against JSON schema or sanitize content. It assumes input is serializable without circular references. Large datasets may impact performance or memory during conversion.", + "examples": [ + "Generate and download a pretty-printed JSON file named 'userSettings.json' from a user preferences object.", + "Generate a minified JSON file for lightweight export with filename 'export.json'.", + "Return the JSON content as a base64 string without creating a download link." + ] + }, + "tags": [ + "content-export", + "json", + "download", + "file-generation", + "serialization" + ], + "examples": [ + { + "inputJson": "{\"data\":{\"users\":[{\"id\":1,\"name\":\"Alice\"},{\"id\":2,\"name\":\"Bob\"}],\"meta\":{\"count\":2}},\"fileName\":\"users.json\",\"indentation\":4,\"returnBase64\":false}", + "description": "Download a pretty-formatted JSON file named 'users.json' containing user objects and metadata." + }, + { + "inputJson": "{\"data\":[1,2,3,4,5],\"fileName\":\"numbers.json\",\"indentation\":0,\"returnBase64\":false}", + "description": "Download a minified JSON file named 'numbers.json' representing an array of numbers." + }, + { + "inputJson": "{\"data\":{\"status\":\"ok\",\"code\":200},\"fileName\":\"response.json\",\"indentation\":2,\"returnBase64\":true}", + "description": "Return base64 encoded JSON content of an object with status and code fields, no download link." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "JSON", + "context": null + } + }, + { + "name": "content-creation.buildService", + "description": "This tool assists in building and deploying a digital content service by accepting service configuration details such as service name, content types supported, storage options, and deployment environment. It processes these inputs to provision infrastructure, configure content management, and output a deployment status report with service endpoints and resource details.", + "category": "content-creation", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The unique name identifier for the content service to be built.", + "required": true, + "defaultValue": "" + }, + { + "name": "contentTypes", + "type": "array", + "description": "List of content types (e.g., articles, images, videos) the service should support.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "storageType", + "type": "string", + "description": "Type of storage backend for content, such as 'database', 'objectStorage', or 'filesystem'.", + "required": true, + "defaultValue": "database" + }, + { + "name": "deploymentEnvironment", + "type": "string", + "description": "Target environment to deploy the service, e.g., 'development', 'staging', 'production'.", + "required": true, + "defaultValue": "development" + }, + { + "name": "autoScalingEnabled", + "type": "boolean", + "description": "Whether to enable auto-scaling of the service based on load.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxInstances", + "type": "number", + "description": "Maximum number of instances to run if auto-scaling is enabled.", + "required": false, + "defaultValue": "1" + }, + { + "name": "enableCaching", + "type": "boolean", + "description": "Flag to enable caching mechanisms to improve content delivery performance.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing deployment status, service endpoints, resource allocations, and any errors encountered during build." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the setup and deployment of a content delivery service tailored to specific content types and infrastructure preferences. It is ideal for scenarios involving rapid provisioning of services for digital content management and distribution with customizable deployment environments and scaling options.", + "limitations": "This tool does not handle content creation or editing itself, only the infrastructure and service deployment aspects. It also does not support manual configuration beyond the supplied parameters and cannot diagnose runtime service issues post-deployment.", + "examples": [ + "Build a content service named 'MediaHub' supporting images and videos with object storage on production environment.", + "Set up a development content service named 'TestDocs' for articles, with database storage and auto-scaling enabled.", + "Deploy a service named 'BlogStore' supporting text and images with caching disabled and a max of 3 instances." + ] + }, + "tags": [ + "content-creation", + "service-deployment", + "content-management", + "infrastructure", + "automation", + "scaling" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"MediaHub\",\"contentTypes\":[\"images\",\"videos\"],\"storageType\":\"objectStorage\",\"deploymentEnvironment\":\"production\",\"autoScalingEnabled\":true,\"maxInstances\":5,\"enableCaching\":true}", + "description": "Deploy a production content service 'MediaHub' supporting images and videos with object storage, auto-scaling enabled, and caching." + }, + { + "inputJson": "{\"serviceName\":\"TestDocs\",\"contentTypes\":[\"articles\"],\"storageType\":\"database\",\"deploymentEnvironment\":\"development\",\"autoScalingEnabled\":false,\"maxInstances\":1,\"enableCaching\":true}", + "description": "Build a development environment content service 'TestDocs' supporting articles with database storage and caching enabled without auto-scaling." + }, + { + "inputJson": "{\"serviceName\":\"BlogStore\",\"contentTypes\":[\"text\",\"images\"],\"storageType\":\"filesystem\",\"deploymentEnvironment\":\"staging\",\"autoScalingEnabled\":true,\"maxInstances\":3,\"enableCaching\":false}", + "description": "Create a staging content service 'BlogStore' supporting text and images stored on filesystem, with auto-scaling up to 3 instances and caching disabled." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Service", + "context": null + } + }, + { + "name": "content-creation.sendNotification", + "description": "Sends a customizable notification message to specified recipients using different delivery channels such as email, SMS, or push notification. Accepts recipients, message content, subject, and optional channel preference to dispatch the notification and returns the success status for each recipient.", + "category": "content-creation", + "parameters": [ + { + "name": "recipients", + "type": "array", + "description": "List of recipient identifiers such as email addresses or phone numbers to whom the notification will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "The main content of the notification message to be delivered.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject or title of the notification, applicable mainly for email and push notifications.", + "required": false, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "Preferred delivery channel for the notification; options include 'email', 'sms', or 'push'. If unspecified, a default or all channels may be used.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier or name that appears as the sender of the notification.", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification such as 'normal' or 'high' to influence delivery handling.", + "required": false, + "defaultValue": "normal" + }, + { + "name": "scheduledTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule when the notification should be sent; if empty, sends immediately.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of notification delivery per recipient including success boolean and optional error messages." + }, + "aiAgent": { + "useCase": "Use this tool when needing to dispatch notifications to users or clients across multiple channels (email, SMS, push) with customized messages. Ideal for alerts, updates, reminders, or promotional content requiring confirmation of delivery or status tracking.", + "limitations": "Does not generate message content; requires preformatted messages. Cannot guarantee delivery due to external channel dependencies. Limited to supported channels and recipient formats.", + "examples": [ + "Send a high-priority email notification about a system outage to a list of users.", + "Dispatch an SMS reminder about an upcoming appointment to a client's phone number.", + "Schedule a push notification for a promotional offer to be sent at a specific future time." + ] + }, + "tags": [ + "notification", + "messaging", + "content-creation", + "communication", + "email", + "sms", + "push", + "reminder" + ], + "examples": [ + { + "inputJson": "{\"recipients\":[\"user1@example.com\"],\"messageBody\":\"Your account password will expire in 3 days.\",\"subject\":\"Password Expiry Notice\",\"channel\":\"email\",\"priority\":\"high\"}", + "description": "Send a high priority email notification about password expiration to a user." + }, + { + "inputJson": "{\"recipients\":[\"+12345556789\"],\"messageBody\":\"Your appointment is scheduled for tomorrow at 3 PM.\",\"channel\":\"sms\"}", + "description": "Send an SMS appointment reminder to a phone number." + }, + { + "inputJson": "{\"recipients\":[\"device_token_98765\"],\"messageBody\":\"Flash Sale starts in 1 hour! Don't miss out.\",\"channel\":\"push\",\"scheduledTime\":\"2024-07-01T08:00:00Z\"}", + "description": "Schedule a push notification about a flash sale to a device token to be sent at a future time." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "content-creation.buildConfig", + "description": "Generates a structured configuration file based on provided settings and template options. Accepts an input object describing config parameters and generates a complete config file content in JSON, YAML, or INI format for software deployment or application setup.", + "category": "content-creation", + "parameters": [ + { + "name": "configParameters", + "type": "object", + "description": "Key-value pairs representing configuration settings to include in the config file.", + "required": true, + "defaultValue": "" + }, + { + "name": "templateType", + "type": "string", + "description": "Config file format to generate, such as 'json', 'yaml', or 'ini'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments in the generated config file.", + "required": false, + "defaultValue": "false" + }, + { + "name": "envPrefix", + "type": "string", + "description": "Optional prefix to add to environment variable names inside the config.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated configuration file as a string and its format type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a complete configuration file for an application or service based on user-supplied parameters. It helps in automating creation of deployment or runtime configurations in common formats, reducing manual editing and errors.", + "limitations": "This tool cannot validate the semantic correctness of the configuration values for specific software beyond formatting. It also does not handle nested complex schema validations automatically.", + "examples": [ + "Generate a JSON config for a web server with port and logging settings.", + "Produce a YAML config file including environment variable placeholders with a prefix.", + "Create an INI config file with default values and inline comments explaining each setting." + ] + }, + "tags": [ + "configuration", + "file-generation", + "automation", + "content-creation", + "devops", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"configParameters\":{\"serverPort\":8080,\"enableLogging\":true,\"logLevel\":\"debug\"},\"templateType\":\"json\",\"includeComments\":false,\"envPrefix\":\"APP_\"}", + "description": "Generate a basic JSON config with environment variable prefix and no comments." + }, + { + "inputJson": "{\"configParameters\":{\"databaseHost\":\"localhost\",\"databasePort\":5432,\"useSSL\":false},\"templateType\":\"yaml\",\"includeComments\":true,\"envPrefix\":\"DB_\"}", + "description": "Create a YAML config with explanatory comments for a database connection." + }, + { + "inputJson": "{\"configParameters\":{\"path\":\"/var/www\",\"maxClients\":200,\"timeout\":60},\"templateType\":\"ini\",\"includeComments\":true,\"envPrefix\":\"\"}", + "description": "Produce an INI format config file with comments for a server application." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Config", + "context": null + } + }, + { + "name": "documentation-tools.analyzeSession", + "description": "Analyzes user interaction sessions with documentation to extract insights on navigation patterns, search queries, page visits, and user engagement metrics. Accepts raw session logs or structured event data as input, processes this data to identify frequent paths, bottlenecks, and drop-off points, and outputs a comprehensive report summarizing user behavior and recommendations for improving documentation usability.", + "category": "documentation-tools", + "parameters": [ + { + "name": "sessionData", + "type": "array", + "description": "An array of session event objects representing user interactions with the documentation, including timestamps, event types (e.g., pageView, search), and metadata. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 formatted timestamp to filter session events starting from this time. Optional, defaults to include all.", + "required": false, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 formatted timestamp to filter session events up to this time. Optional, defaults to include all.", + "required": false, + "defaultValue": "" + }, + { + "name": "minSessionDuration", + "type": "number", + "description": "Minimum duration in seconds for sessions to be included in the analysis. Optional, defaults to 0 (include all).", + "required": false, + "defaultValue": "0" + }, + { + "name": "includeSearchAnalysis", + "type": "boolean", + "description": "Whether to analyze and report on search queries made during sessions. Optional, default true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "generateRecommendations", + "type": "boolean", + "description": "If true, the tool will produce actionable recommendations based on session analysis. Optional, default true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object containing summarized metrics including number of sessions analyzed, average session duration, common navigation paths, search term statistics, drop-off points, and optionally recommendations for documentation improvements." + }, + "aiAgent": { + "useCase": "Use this tool when you want to understand how users interact with your documentation in sessions by analyzing event logs or telemetry data. It helps identify which pages are most visited, common session flows, user search behavior, and points where users abandon sessions, enabling data-driven improvements to the documentation. It is especially useful for product managers, documentation teams, and UX researchers monitoring documentation effectiveness.", + "limitations": "This tool cannot track individual user identities due to privacy concerns and does not perform sentiment analysis. It requires properly structured session event data as input and does not collect raw data itself.", + "examples": [ + "Analyze the last week's documentation sessions to find common user navigation paths and search terms.", + "Provide insights on documentation sessions longer than 5 minutes including recommendations to improve user engagement.", + "Summarize session events between two given timestamps focusing on search query effectiveness." + ] + }, + "tags": [ + "documentation", + "analytics", + "session", + "user behavior", + "usability", + "search", + "engagement" + ], + "examples": [ + { + "inputJson": "{\"sessionData\":[{\"timestamp\":\"2024-04-01T10:00:00Z\",\"eventType\":\"pageView\",\"page\":\"Getting Started\"},{\"timestamp\":\"2024-04-01T10:01:00Z\",\"eventType\":\"search\",\"query\":\"installation\"},{\"timestamp\":\"2024-04-01T10:02:30Z\",\"eventType\":\"pageView\",\"page\":\"Installation Guide\"}],\"startTime\":\"2024-04-01T00:00:00Z\",\"endTime\":\"2024-04-02T00:00:00Z\",\"minSessionDuration\":30,\"includeSearchAnalysis\":true,\"generateRecommendations\":true}", + "description": "Analyze documentation session events from April 1, 2024, filtering sessions at least 30 seconds long, including search analysis and recommendations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Session", + "context": null + } + }, + { + "name": "documentation-tools.analyzeHeading", + "description": "Analyzes headings within a documentation file or content block to evaluate structure, hierarchy, and consistency. Accepts text input containing headings (e.g., Markdown or HTML) and returns an analysis identifying heading levels used, ordering integrity, missing levels, and suggestions for improved semantic structure.", + "category": "documentation-tools", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The documentation content containing headings to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Format of the input content (e.g., 'markdown', 'html', or 'plain').", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "maxHeadingLevel", + "type": "number", + "description": "Maximum heading level to consider in the analysis, e.g., 6 for h1 to h6.", + "required": false, + "defaultValue": "6" + }, + { + "name": "checkOrderConsistency", + "type": "boolean", + "description": "Whether to check if heading levels increase or decrease in proper sequential order.", + "required": false, + "defaultValue": "true" + }, + { + "name": "checkMissingLevels", + "type": "boolean", + "description": "Whether to identify any missing heading levels in the document hierarchy.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object summarizing heading statistics, detected structure issues, and recommendations for improving heading hierarchy and usage." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing documentation to ensure heading usage conforms to best practices for semantic structure, readability, and accessibility. It assists in detecting improper heading sequences, missing levels, and inconsistent hierarchy in Markdown or HTML docs.", + "limitations": "Does not modify the source content; does not analyze heading content quality or relevance; limited to structural and hierarchical analysis only.", + "examples": [ + "Analyze headings in a Markdown README to check for missing heading levels and incorrect order.", + "Evaluate HTML documentation to identify inconsistent heading usage.", + "Check a plain text document for heading structure and suggest improvements." + ] + }, + "tags": [ + "documentation", + "heading", + "analysis", + "structure", + "markdown", + "html", + "accessibility" + ], + "examples": [ + { + "inputJson": "{\"content\":\"# Title\\n## Introduction\\n### Details\\n#### Subdetails\\n## Conclusion\",\"format\":\"markdown\"}", + "description": "Analyze a simple Markdown document for heading hierarchy consistency." + }, + { + "inputJson": "{\"content\":\"Main Title
Skipped Level
Came Back\",\"format\":\"html\"}", + "description": "Detect issues with heading level skipping and ordering in HTML content." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Heading", + "context": null + } + }, + { + "name": "documentation-tools.analyzeThreat", + "description": "Analyzes security threat descriptions provided in text or structured format to identify key threat elements such as severity, affected components, and recommended mitigations. Accepts threat reports or briefings as input and returns a structured threat analysis summary useful for documentation or risk assessment.", + "category": "documentation-tools", + "parameters": [ + { + "name": "threatDescription", + "type": "string", + "description": "A detailed textual description of the security threat to analyze, including context, indicators, and impact.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the threatDescription input, e.g., 'text' or 'json'. Determines parsing approach.", + "required": false, + "defaultValue": "text" + }, + { + "name": "severityLevels", + "type": "array", + "description": "Optional list of predefined severity levels to categorize the threat, e.g., ['Low','Medium','High','Critical'].", + "required": false, + "defaultValue": "" + }, + { + "name": "includeMitigations", + "type": "boolean", + "description": "Flag to include recommended mitigation measures in the output analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language of the threat description to support multilingual analysis; default is English.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object summarizing the analyzed threat details including severity, impacted systems, threat type, description highlights, and recommended mitigations if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert free-form or semi-structured threat descriptions into a structured, actionable summary that highlights critical elements for documentation or security decision making. Especially helpful for security documentation workflows requiring concise threat overviews.", + "limitations": "The tool cannot replace expert threat intelligence analysis or detect unknown/unreported threats from raw data. It relies on provided descriptions and may miss nuances if input is incomplete.", + "examples": [ + "Analyze the text of a recent phishing threat report to extract key impact and mitigation steps.", + "Summarize a JSON-formatted threat bulletin to produce a severity level and suggested actions.", + "Process a multi-language threat advisory to generate a documentation-ready summary." + ] + }, + "tags": [ + "documentation", + "security", + "threat analysis", + "risk assessment", + "cybersecurity", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"threatDescription\":\"A new ransomware variant targeting Windows servers encrypts files and demands payment in cryptocurrency. Impacted systems include SQL databases and file shares. Severity assessed as high due to rapid propagation.\",\"inputFormat\":\"text\",\"includeMitigations\":true}", + "description": "Analyze a plain text ransomware threat report including impact and severity." + }, + { + "inputJson": "{\"threatDescription\":\"{\\\"type\\\": \\\"phishing\\\", \\\"description\\\": \\\"Spear phishing emails targeting finance department employees asking for wire transfer approvals.\\\", \\\"affectedSystems\\\": [\\\"email\\\", \\\"finance systems\\\"], \\\"severity\\\": \\\"Medium\\\"}\",\"inputFormat\":\"json\",\"includeMitigations\":true}", + "description": "Analyze a JSON structured threat alert describing a phishing campaign with specified severity." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Threat", + "context": null + } + }, + { + "name": "documentation-tools.buildComponent", + "description": "This tool automates the generation of code component documentation based on provided source code files and additional metadata. It accepts inputs such as component source files, configuration for documentation style, and optional examples or usage notes. The tool parses the code, extracts relevant comments, and combines them with metadata to output comprehensive, formatted documentation files for the component.", + "category": "documentation-tools", + "parameters": [ + { + "name": "sourceFiles", + "type": "array", + "description": "Array of file paths or code snippets representing the component source code to document.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format to generate documentation in, such as 'markdown', 'html', or 'json'.", + "required": false, + "defaultValue": "markdown" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include usage examples in the generated documentation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "componentName", + "type": "string", + "description": "The official name of the component to use in documentation headers and references.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional metadata about the component, such as author, version, and tags, to include in the documentation.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated documentation content and the format type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce or update detailed, well-structured documentation for a software component based on its source code and metadata. It is ideal for maintaining consistent and clear component documentation automatically, especially in CI/CD pipelines or developer tools.", + "limitations": "The tool cannot fully understand undocumented code logic or generate content beyond what is inferable from provided code comments and metadata. It may not handle highly dynamic or generated code well.", + "examples": [ + "Generate markdown documentation for a React component with examples and metadata.", + "Create HTML docs for a set of JavaScript utility functions without usage examples.", + "Produce JSON formatted docs for a backend API component including author and version info." + ] + }, + "tags": [ + "documentation", + "component", + "code", + "generator", + "automation" + ], + "examples": [ + { + "inputJson": "{\"sourceFiles\":[\"./src/Button.jsx\"],\"outputFormat\":\"markdown\",\"includeExamples\":true,\"componentName\":\"Button\",\"metadata\":{\"author\":\"Jane Doe\",\"version\":\"1.2.0\",\"tags\":[\"UI\",\"button\"]}}", + "description": "Generate Markdown documentation with examples and metadata for a Button React component." + }, + { + "inputJson": "{\"sourceFiles\":[\"./lib/utils.js\"],\"outputFormat\":\"html\",\"includeExamples\":false}", + "description": "Generate HTML documentation for utility functions without usage examples." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Component", + "context": null + } + }, + { + "name": "data-analytics.renderReport", + "description": "Generates a comprehensive visual report from structured input data by applying specified templates and visualization preferences. Accepts JSON arrays or objects representing datasets, processes data into charts, tables, and summaries, then renders a report document in PDF or HTML format suitable for presentation and analysis.", + "category": "data-analytics", + "parameters": [ + { + "name": "data", + "type": "object", + "description": "The input dataset to be visualized and analyzed, provided as a JSON object or array of objects.", + "required": true, + "defaultValue": "" + }, + { + "name": "template", + "type": "string", + "description": "The report template name or preset defining layout and styling for the report.", + "required": false, + "defaultValue": "standard" + }, + { + "name": "visualizations", + "type": "array", + "description": "An array specifying types of visualizations (e.g., barChart, lineGraph, pieChart) to include in the report.", + "required": false, + "defaultValue": "[\"barChart\",\"table\"]" + }, + { + "name": "title", + "type": "string", + "description": "The title to display on the generated report.", + "required": false, + "defaultValue": "Data Report" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output file format: 'pdf' or 'html'.", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Flag indicating whether to include an automated summary or insights section.", + "required": false, + "defaultValue": "true" + }, + { + "name": "author", + "type": "string", + "description": "Name of the report author to be displayed in the report metadata.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "The generated report file as a base64 encoded string along with metadata including format, size, and report title." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate presentation-ready reports from raw or processed data, especially when visual insights like charts and tables are required for decision making or sharing results. It is valuable for business analytics, research summaries, and periodic performance reports.", + "limitations": "Does not support unstructured data like raw text logs. Visualization options depend on supported templates and may not cover highly customized chart types. Requires clean, structured input data.", + "examples": [ + "Generate a sales report in PDF with bar charts and summaries for Q1 dataset.", + "Create an HTML report visualizing user engagement metrics using line graphs and tables.", + "Produce a standard styled report with default template showing financial data for monthly review." + ] + }, + "tags": [ + "data", + "analytics", + "reporting", + "visualization", + "pdf", + "html", + "charts", + "summary" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"month\":\"Jan\",\"sales\":1000,\"expenses\":400},{\"month\":\"Feb\",\"sales\":1100,\"expenses\":450}],\"template\":\"business\",\"visualizations\":[\"barChart\",\"table\"],\"title\":\"Q1 Sales Report\",\"outputFormat\":\"pdf\",\"includeSummary\":true,\"author\":\"Jane Doe\"}", + "description": "Generate a PDF report for Q1 sales with bar charts, tables, and a summary by Jane Doe." + }, + { + "inputJson": "{\"data\":[{\"date\":\"2024-01-01\",\"users\":1200,\"active\":300},{\"date\":\"2024-01-02\",\"users\":1300,\"active\":320}],\"template\":\"standard\",\"visualizations\":[\"lineGraph\"],\"title\":\"User Engagement Report\",\"outputFormat\":\"html\",\"includeSummary\":false,\"author\":\"\"}", + "description": "Create an HTML report showing user engagement trends over dates using line graphs." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "render", + "object": "Report", + "context": null + } + }, + { + "name": "data-analytics.createRisk", + "description": "Analyzes structured input data related to assets, vulnerabilities, threats, and controls to generate a quantified risk assessment report. Accepts JSON-formatted data describing system components and their security parameters, processes risk scoring using configurable methodologies, and outputs a detailed risk profile including risk levels and suggested mitigations.", + "category": "data-analytics", + "parameters": [ + { + "name": "assetData", + "type": "object", + "description": "Structured JSON object containing asset details including types, values, and classifications to evaluate.", + "required": true, + "defaultValue": "" + }, + { + "name": "vulnerabilityData", + "type": "object", + "description": "JSON object listing known vulnerabilities with severity scores linked to assets.", + "required": true, + "defaultValue": "" + }, + { + "name": "threatData", + "type": "object", + "description": "JSON object describing potential threats and their likelihoods related to the assets or environment.", + "required": true, + "defaultValue": "" + }, + { + "name": "controlData", + "type": "object", + "description": "JSON object specifying current security controls in place, including effectiveness ratings.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "riskCalculationMethod", + "type": "string", + "description": "The methodology to calculate risk such as 'CVSS', 'DREAD', or 'custom'.", + "required": false, + "defaultValue": "CVSS" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired format of risk assessment output, e.g. 'JSON' or 'PDF'.", + "required": false, + "defaultValue": "JSON" + } + ], + "returns": { + "type": "object", + "description": "An object containing the risk assessment results, including risk scores per asset, overall risk levels, and actionable recommendations for mitigation." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate a comprehensive risk assessment based on detailed input data about assets, vulnerabilities, threats, and controls. It helps quantify security risks to prioritize mitigation efforts and supports security decision-making in enterprises.", + "limitations": "This tool cannot discover vulnerabilities or threats autonomously; it depends on accurate input data. It also does not perform real-time monitoring or incident response.", + "examples": [ + "Create a risk assessment for a set of corporate servers with known vulnerabilities and applied controls.", + "Generate risk scores for IoT devices in a smart building using custom risk calculation.", + "Produce a PDF report summarizing risks for cloud assets with threat and control data." + ] + }, + "tags": [ + "risk-assessment", + "security", + "data-analysis", + "threat-modeling", + "vulnerability-management", + "risk-calculation" + ], + "examples": [ + { + "inputJson": "{\"assetData\":{\"server1\":{\"type\":\"webserver\",\"value\":\"high\",\"importance\":\"critical\"}},\"vulnerabilityData\":{\"vuln1\":{\"asset\":\"server1\",\"severity\":7.5}},\"threatData\":{\"threat1\":{\"description\":\"DDoS attack\",\"likelihood\":\"medium\"}},\"controlData\":{\"firewall\":{\"effectiveness\":0.8}},\"riskCalculationMethod\":\"CVSS\",\"outputFormat\":\"JSON\"}", + "description": "Generate a basic CVSS-based risk assessment for one critical webserver with vulnerabilities and firewall control." + }, + { + "inputJson": "{\"assetData\":{\"deviceA\":{\"type\":\"IoT\",\"value\":\"medium\"}},\"vulnerabilityData\":{\"vulnA\":{\"asset\":\"deviceA\",\"severity\":5.0}},\"threatData\":{\"threatA\":{\"description\":\"Data Exfiltration\",\"likelihood\":\"high\"}},\"controlData\":{},\"riskCalculationMethod\":\"DREAD\",\"outputFormat\":\"JSON\"}", + "description": "Create a risk profile for an IoT device using the DREAD model without existing controls." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Risk", + "context": null + } + }, + { + "name": "data-analytics.createComponent", + "description": "Creates a reusable data visualization or analytic UI component based on provided data source and configuration options. Accepts data inputs and component settings, generates a component object that can be integrated into dashboards or web apps for interactive data insights.", + "category": "data-analytics", + "parameters": [ + { + "name": "componentType", + "type": "string", + "description": "Specifies the type of visualization or component to create, e.g. 'barChart', 'lineGraph', 'dataTable'.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSource", + "type": "object", + "description": "The structured data or query parameters that provide the data to visualize. Supports arrays or query definitions.", + "required": true, + "defaultValue": "" + }, + { + "name": "configOptions", + "type": "object", + "description": "Customization options such as color schemes, axis labels, filters, and interactivity settings for the component.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "width", + "type": "number", + "description": "Width of the component in pixels. Optional; defaults to automatic sizing.", + "required": false, + "defaultValue": "0" + }, + { + "name": "height", + "type": "number", + "description": "Height of the component in pixels. Optional; defaults to automatic sizing.", + "required": false, + "defaultValue": "0" + }, + { + "name": "interactive", + "type": "boolean", + "description": "Indicates if the component should support user interactions like hover effects or filtering.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns a component definition object including type, rendered markup or configuration, and metadata suitable for embedding into analytic dashboards or frameworks." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate data analytic UI components from datasets, facilitating automated dashboard creation or dynamic report generation in applications.", + "limitations": "Does not perform data cleaning or complex data transformations—input data should be preprocessed. Visualization types are limited to supported componentType values.", + "examples": [ + "Create a bar chart component from sales data with custom colors and axis labels.", + "Generate an interactive line graph component for time series data with specified size.", + "Produce a data table component with filtering enabled for a customer dataset." + ] + }, + "tags": [ + "data-analytics", + "visualization", + "component", + "UI", + "dashboard", + "reporting", + "interactive" + ], + "examples": [ + { + "inputJson": "{\"componentType\": \"barChart\", \"dataSource\": {\"data\": [{\"month\": \"Jan\", \"sales\": 100}, {\"month\": \"Feb\", \"sales\": 150}]}, \"configOptions\": {\"color\": \"blue\", \"xAxisLabel\": \"Month\", \"yAxisLabel\": \"Sales\"}, \"width\": 600, \"height\": 400, \"interactive\": true}", + "description": "Creates a blue bar chart showing sales by month, with axis labels and interactive features, sized 600x400." + }, + { + "inputJson": "{\"componentType\": \"dataTable\", \"dataSource\": {\"data\": [{\"name\": \"Alice\", \"age\": 30}, {\"name\": \"Bob\", \"age\": 25}]}, \"configOptions\": {\"sortable\": true, \"filterable\": true}, \"interactive\": true}", + "description": "Creates an interactive data table component from user data that supports sorting and filtering." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Component", + "context": null + } + }, + { + "name": "data-analytics.createQuery", + "description": "Creates a structured data query based on specified dataset, filters, selected fields, and aggregation functions. Accepts dataset identifier and query parameters, processes these to build a query string or object usable by data engines, and outputs the constructed query ready for execution or further processing.", + "category": "data-analytics", + "parameters": [ + { + "name": "datasetId", + "type": "string", + "description": "Identifier of the dataset or database to query against.", + "required": true, + "defaultValue": "" + }, + { + "name": "fields", + "type": "array", + "description": "List of field names to include in the query output.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Filter conditions defining constraints on data selection, specified as field-value mappings or operators.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "aggregations", + "type": "array", + "description": "List of aggregation operations such as SUM, AVG, COUNT applied to fields.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "groupBy", + "type": "array", + "description": "Fields to group the query results by.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "limit", + "type": "number", + "description": "Maximum number of records to return.", + "required": false, + "defaultValue": "100" + }, + { + "name": "sortBy", + "type": "array", + "description": "Fields and sort directions (ASC/DESC) to order the results, e.g. [{field:'date', direction:'DESC'}].", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object representing the constructed query, including queryString and optional metadata describing the query components." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate data queries from user or system defined parameters for datasets, enabling automated data retrieval and analysis. Ideal for building dynamic, parameterized queries in data analytics workflows and dashboards.", + "limitations": "This tool does not execute the query against databases; it only constructs the query representation. It may not support highly complex nested queries or database-specific dialects without additional customization.", + "examples": [ + "Create a query to retrieve sales and customer info with filters on date and region, grouped by product category.", + "Generate an aggregation query to count distinct users per country, sorted by user count descending.", + "Build a query selecting specific fields with a limit for preview purposes." + ] + }, + "tags": [ + "data", + "query", + "analytics", + "aggregation", + "filtering", + "grouping", + "visualization" + ], + "examples": [ + { + "inputJson": "{\"datasetId\":\"sales_db\",\"fields\":[\"customer_id\",\"purchase_amount\"],\"filters\":{\"purchase_date\":{\"gte\":\"2023-01-01\"},\"region\":\"EMEA\"},\"groupBy\":[\"product_category\"],\"aggregations\":[{\"function\":\"SUM\",\"field\":\"purchase_amount\"}],\"limit\":100,\"sortBy\":[{\"field\":\"purchase_amount\",\"direction\":\"DESC\"}]}", + "description": "Query sales database for total purchase amount by product category for EMEA region after 2023-01-01, sorted by purchase amount descending." + }, + { + "inputJson": "{\"datasetId\":\"user_data\",\"fields\":[\"country\"],\"aggregations\":[{\"function\":\"COUNT_DISTINCT\",\"field\":\"user_id\"}],\"groupBy\":[\"country\"],\"sortBy\":[{\"field\":\"COUNT_DISTINCT_user_id\",\"direction\":\"DESC\"}]}", + "description": "Generate a query to count distinct users per country, ordered by user counts descending." + }, + { + "inputJson": "{\"datasetId\":\"inventory\",\"fields\":[\"item_id\",\"stock_level\"],\"limit\":10}", + "description": "Create a simple query to preview first 10 inventory items with their stock levels." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Query", + "context": null + } + }, + { + "name": "data-analytics.createVariable", + "description": "Creates a new derived variable in a dataset based on existing data columns using specified transformation or calculation rules. Accepts dataset as array of objects, applies the defined formula or logic, and outputs the original dataset augmented with the new variable for further analysis.", + "category": "data-analytics", + "parameters": [ + { + "name": "dataset", + "type": "array", + "description": "Array of data records, each an object representing a row with key-value pairs for columns", + "required": true, + "defaultValue": "" + }, + { + "name": "variableName", + "type": "string", + "description": "The name of the new variable to create and add to each data record", + "required": true, + "defaultValue": "" + }, + { + "name": "formula", + "type": "string", + "description": "A JavaScript expression or formula using existing columns to compute the new variable's value", + "required": true, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "If true, overwrite existing variable with the same name; if false, raises error or skips", + "required": false, + "defaultValue": "false" + }, + { + "name": "missingValueStrategy", + "type": "string", + "description": "Strategy to handle missing or undefined inputs in formula: 'skip', 'default', or 'error'", + "required": false, + "defaultValue": "skip" + }, + { + "name": "defaultValue", + "type": "string", + "description": "Default value to assign when missingValueStrategy is 'default' and inputs are missing", + "required": false, + "defaultValue": "null" + } + ], + "returns": { + "type": "object", + "description": "Returns the updated dataset as an array of objects, each including the new variable with computed values" + }, + "aiAgent": { + "useCase": "Use this tool when you need to augment raw datasets with new calculated variables or features derived from existing columns, enabling enhanced analytics, modeling, or reporting workflows. It helps in feature engineering and data transformation scenarios.", + "limitations": "The formula must be a valid JavaScript expression referencing existing column names exactly. Complex data types or external data sources cannot be accessed within the formula. Large datasets may require optimized execution beyond the tool's scope.", + "examples": [ + "Create a new variable 'BMI' based on 'weight' and 'height' columns using the formula 'weight / (height/100) ** 2'.", + "Add a binary flag variable 'isAdult' setting 1 if 'age' >= 18 else 0.", + "Generate a new variable 'totalPrice' by multiplying 'unitPrice' and 'quantity'." + ] + }, + "tags": [ + "data", + "variable", + "transformation", + "feature-engineering", + "analytics", + "calculation", + "dataset" + ], + "examples": [ + { + "inputJson": "{\"dataset\":[{\"age\":25,\"height\":175,\"weight\":70},{\"age\":32,\"height\":160,\"weight\":60}],\"variableName\":\"BMI\",\"formula\":\"weight / ((height/100) * (height/100))\"}", + "description": "Calculate Body Mass Index (BMI) for each record based on weight and height fields." + }, + { + "inputJson": "{\"dataset\":[{\"age\":17},{\"age\":20}],\"variableName\":\"isAdult\",\"formula\":\"age >= 18 ? 1 : 0\"}", + "description": "Create a binary indicator variable 'isAdult' based on age." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Variable", + "context": null + } + }, + { + "name": "data-transformation.generateCSV", + "description": "Generates a CSV formatted string from an array of objects. Accepts structured data as an array of JSON objects, converts each object's fields into CSV columns, supports optional headers and custom delimiters, and produces a CSV string as output.", + "category": "data-transformation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects representing rows to convert to CSV, each object should have consistent fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Determines whether to include a header row with column names extracted from object keys.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate values in each row; defaults to comma (,).", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteChar", + "type": "string", + "description": "Character to use for quoting fields containing delimiters or special characters; defaults to double quote (\").", + "required": false, + "defaultValue": "\"" + }, + { + "name": "lineEnding", + "type": "string", + "description": "String to use for line breaks between rows; defaults to '\\n'.", + "required": false, + "defaultValue": "\\n" + }, + { + "name": "fieldsOrder", + "type": "array", + "description": "Optional array specifying the order of fields (columns) in the CSV output; if omitted, field order is derived from the first object's keys.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated CSV string under the 'csv' property." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert structured JSON data into a standardized CSV format for purposes like data export, interoperability, reporting, or feeding CSV-compatible downstream applications. Ideal for automating the creation of CSV files from API responses or in-memory datasets.", + "limitations": "Does not perform data validation or complex transformations such as nested object flattening; fields must be flat key-value pairs. It also does not handle streaming large datasets and assumes all data fits in memory.", + "examples": [ + "Convert an array of user objects into CSV with headers included.", + "Generate CSV without headers and use semicolon as delimiter.", + "Specify a custom column order in the output CSV." + ] + }, + "tags": [ + "data transformation", + "csv", + "export", + "format conversion", + "json to csv" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"includeHeaders\":true}", + "description": "Convert a simple array of user objects to CSV including headers." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Book\",\"price\":12.99,\"stock\":100},{\"product\":\"Pen\",\"price\":1.99,\"stock\":500}],\"includeHeaders\":false,\"delimiter\":\";\"}", + "description": "Generate CSV from product data without headers and using semicolon delimiter." + }, + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"fieldsOrder\":[\"city\",\"name\",\"age\"]}", + "description": "Generate CSV specifying custom column order different from object key order." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "CSV", + "context": null + } + }, + { + "name": "data-transformation.createParagraph", + "description": "Creates a well-formed paragraph by combining an array of sentences or text fragments. It accepts an array of strings, optionally formats text with capitalization and punctuation, and outputs a single coherent paragraph string.", + "category": "data-transformation", + "parameters": [ + { + "name": "sentences", + "type": "array", + "description": "An array of strings where each item is a sentence or fragment to be combined into a paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "capitalizeSentences", + "type": "boolean", + "description": "Whether to capitalize the first letter of each sentence.", + "required": false, + "defaultValue": "true" + }, + { + "name": "addPeriods", + "type": "boolean", + "description": "Whether to append periods to sentences that don't already end with proper punctuation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "separator", + "type": "string", + "description": "String used to separate sentences in the paragraph, usually a space.", + "required": false, + "defaultValue": " " + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to trim leading and trailing whitespace from sentences before combining.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the combined paragraph string as 'paragraph', properly formatted." + }, + "aiAgent": { + "useCase": "Use this tool when you have multiple sentences or text snippets that need to be combined into a single, coherent paragraph for display, storage, or further processing. It helps standardize paragraph formatting by capitalizing sentences and ensuring punctuation consistency, ensuring output is readable and well-formed.", + "limitations": "Does not perform deep grammatical corrections or text rewriting; cannot fix sentence meaning or style beyond basic capitalization and punctuation handling.", + "examples": [ + "Create a paragraph from an array of unformatted sentences.", + "Combine text fragments into a formatted paragraph for a report section.", + "Generate a paragraph by ensuring all sentences end with periods and start capitalized." + ] + }, + "tags": [ + "data-transformation", + "text-processing", + "paragraph", + "formatting", + "combining", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"sentences\":[\"this is the first sentence\",\"here is the second\",\"finally the last one\"],\"capitalizeSentences\":true,\"addPeriods\":true}", + "description": "Combine three lowercase sentences into a properly capitalized paragraph with periods." + }, + { + "inputJson": "{\"sentences\":[\"already formatted sentence.\",\"Second sentence!\"]}", + "description": "Combine sentences that already have punctuation without adding new periods." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "data-transformation.generateParagraph", + "description": "Generates a coherent paragraph of text based on a given topic, desired length, and tone. Accepts a topic string and optional parameters for length (number of sentences) and tone to produce a natural-language paragraph suitable for content creation, summaries or explanations.", + "category": "data-transformation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The central theme or subject the paragraph should focus on.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of sentences in the generated paragraph.", + "required": false, + "defaultValue": "5" + }, + { + "name": "tone", + "type": "string", + "description": "The style or tone of the paragraph such as formal, casual, or informative.", + "required": false, + "defaultValue": "informative" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text under the 'paragraph' key." + }, + "aiAgent": { + "useCase": "Use this tool to generate concise, contextually relevant paragraphs for a given topic when you need to create written content, summaries, or explanatory text programmatically. It helps automate content generation while allowing control over length and tone to fit various applications like reports, blogs, or assistive writing.", + "limitations": "Cannot guarantee factual accuracy or deep expertise on specialized topics; may produce generic or plausible-sounding but incorrect information. Not suitable for very short or highly technical texts requiring expert-level detail.", + "examples": [ + "Generate a 5-sentence formal paragraph about climate change.", + "Create a casual 3-sentence paragraph explaining photosynthesis.", + "Write an informative paragraph on the benefits of meditation, about 7 sentences long." + ] + }, + "tags": [ + "text-generation", + "content-creation", + "data-transformation", + "natural-language", + "paragraph", + "writing", + "automation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Renewable energy\",\"length\":6,\"tone\":\"informative\"}", + "description": "Generate an informative paragraph about renewable energy with 6 sentences." + }, + { + "inputJson": "{\"topic\":\"Benefits of exercise\",\"length\":4,\"tone\":\"casual\"}", + "description": "Create a casual paragraph with 4 sentences explaining the benefits of exercise." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "data-transformation.createSummary", + "description": "This tool accepts a textual document or multiple documents as input and generates a concise summary highlighting the key points. It processes the input text using natural language processing techniques to extract main ideas and produce a shortened, coherent summary text output suitable for quick understanding or briefing.", + "category": "data-transformation", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The full text document or concatenated documents to be summarized. Required for summarization.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Desired maximum length of the summary in number of sentences. If omitted, defaults to 3 sentences.", + "required": false, + "defaultValue": "3" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text for accurate processing (e.g., 'en' for English). Defaults to 'en'.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyPhrases", + "type": "boolean", + "description": "Whether to include a list of key phrases or keywords extracted from the document along with the summary. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "useAdvancedModel", + "type": "boolean", + "description": "Whether to use a more advanced summarization model, which may improve quality but require more processing time and resources. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and optional key phrases if requested. The summary is a string and keyPhrases is an array of strings." + }, + "aiAgent": { + "useCase": "Use this tool when needing to condense large textual documents into shorter, digestible summaries for briefings, reports, or quick review. It helps summarize articles, reports, emails, or any text data needing abstraction of main points.", + "limitations": "The tool cannot ensure comprehensive understanding of highly technical or ambiguous text. Summaries are approximate and may omit nuanced details. The quality depends on input text clarity and language support.", + "examples": [ + "Summarize a long research article to extract main findings in about five sentences.", + "Create a short summary and key phrases from a user-provided meeting transcript.", + "Generate a three-sentence summary from multiple concatenated news stories in English." + ] + }, + "tags": [ + "summary", + "text-processing", + "natural-language", + "document", + "abstraction", + "key-phrases", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"Artificial intelligence (AI) is the simulation of human intelligence processes by machines, especially computer systems. These processes include learning (the acquisition of information and rules for using the information), reasoning (using rules to reach approximate or definite conclusions), and self-correction.\",\"summaryLength\":2,\"language\":\"en\",\"includeKeyPhrases\":true}", + "description": "Summarize a short definition of artificial intelligence, returning two sentences and key phrases." + }, + { + "inputJson": "{\"inputText\":\"The quarterly financial report shows an increase in revenue by 15% compared to the previous quarter, driven mainly by growth in the Asia-Pacific market segment.\",\"summaryLength\":1,\"includeKeyPhrases\":false}", + "description": "Create a one-sentence summary of a financial report snippet without key phrases." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "data-validation.analyzeSentence", + "description": "Analyzes a given English sentence to validate its grammar, assess readability, check for common writing issues, and provide detailed feedback. Accepts a string input sentence and returns a structured report including grammar correctness, readability score, detected errors, and suggestions.", + "category": "data-validation", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The English sentence text to analyze for validation and feedback.", + "required": true, + "defaultValue": "" + }, + { + "name": "checkGrammar", + "type": "boolean", + "description": "Whether to perform grammatical correctness checking.", + "required": false, + "defaultValue": "true" + }, + { + "name": "checkReadability", + "type": "boolean", + "description": "Whether to compute a readability score (e.g., Flesch-Kincaid).", + "required": false, + "defaultValue": "true" + }, + { + "name": "detectIssues", + "type": "array", + "description": "Specific writing issues to detect such as passive voice, repeated words, clichés. Empty array means detect all.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Detailed analysis report including grammar correctness, a readability score, specific detected issues with explanations, and improvement suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when validating the quality of English sentences, such as in content moderation, writing assistance, or data preprocessing pipelines. It helps verify grammatical soundness, measure readability, and identify common writing issues to improve text quality before publishing or further analysis.", + "limitations": "This tool analyzes only single English sentences. It does not handle multi-sentence paragraphs, other languages, or domain-specific jargon. It cannot replace full grammar checkers or advanced semantic analysis.", + "examples": [ + "Analyze the sentence 'The quick brown fox jumps over the lazy dog.' for grammar and readability.", + "Check the sentence 'This sentence are not correct' for grammatical errors and passive voice.", + "Provide suggestions to improve the readability and fix clichés in 'At the end of the day, it was a win-win situation.'" + ] + }, + "tags": [ + "data-validation", + "text-analysis", + "grammar-check", + "readability", + "writing-assistance" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\"The cat sit on the mat.\"}", + "description": "Analyze a simple grammatically incorrect sentence for grammar errors and readability." + }, + { + "inputJson": "{\"sentence\":\"Due to the fact that he was late, the meeting started without him.\",\"detectIssues\":[\"cliches\",\"passiveVoice\"]}", + "description": "Check a sentence for clichés and passive voice usage." + }, + { + "inputJson": "{\"sentence\":\"AI language models have improved a lot in recent years.\"}", + "description": "Evaluate a grammatically correct sentence for readability and grammar correctness." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Sentence", + "context": null + } + }, + { + "name": "data-validation.createEvent", + "description": "Validates and constructs a structured analytics event object from input parameters. It accepts event metadata, user attributes, and event properties, checks for required fields and correct data types, and outputs a validated event object ready for analytics ingestion.", + "category": "data-validation", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the analytics event to create (e.g., 'button_click').", + "required": true, + "defaultValue": "" + }, + { + "name": "eventTimestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp indicating when the event occurred.", + "required": false, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier for the user who triggered the event.", + "required": true, + "defaultValue": "" + }, + { + "name": "userProperties", + "type": "object", + "description": "Key-value pairs of user attributes (e.g., {'age': 30, 'subscription': 'premium'}).", + "required": false, + "defaultValue": "" + }, + { + "name": "eventProperties", + "type": "object", + "description": "Key-value pairs detailing event-specific properties (e.g., {'buttonColor': 'red', 'page': 'homepage'}).", + "required": false, + "defaultValue": "" + }, + { + "name": "validateSchema", + "type": "boolean", + "description": "Whether to validate the event against a predefined schema for completeness and correctness.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the validated event data with metadata about validation status and error details if any." + }, + "aiAgent": { + "useCase": "Use this tool to create and validate analytics events before sending them to downstream systems to ensure data quality and integrity. It helps prevent malformed or incomplete event data from polluting analytics databases.", + "limitations": "Does not enrich event data from external sources; schema validation depends on predefined schemas being available; cannot process streamed events in real-time.", + "examples": [ + "Create a page view event with user properties.", + "Generate a button click event and validate required fields.", + "Create a purchase event including event and user attributes with timestamp." + ] + }, + "tags": [ + "validation", + "analytics", + "event", + "data-quality", + "user-attributes", + "schema-validation" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"page_view\",\"eventTimestamp\":\"2024-06-20T15:30:00Z\",\"userId\":\"user123\",\"userProperties\":{\"age\":29,\"premiumUser\":true},\"eventProperties\":{\"page\":\"home\"},\"validateSchema\":true}", + "description": "Create a validated 'page_view' event with user and event properties including timestamp." + }, + { + "inputJson": "{\"eventName\":\"button_click\",\"userId\":\"user456\",\"eventProperties\":{\"buttonColor\":\"green\",\"buttonId\":\"signup\"},\"validateSchema\":true}", + "description": "Create a 'button_click' event with button properties and validate it without providing timestamp." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "data-validation.createCSV", + "description": "Generates a CSV formatted string from input data, typically an array of objects or arrays. Processes the data by converting given input records and headers into properly escaped CSV text, supporting custom delimiters and optional inclusion of header row. Outputs a CSV string ready for saving or transmission.", + "category": "data-validation", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of objects (dictionaries) or arrays representing rows of data to be converted into CSV format.", + "required": true, + "defaultValue": "" + }, + { + "name": "headers", + "type": "array", + "description": "An optional array of strings specifying the CSV header row; if omitted and data is array of objects, headers are inferred from keys of first object.", + "required": false, + "defaultValue": "" + }, + { + "name": "delimiter", + "type": "string", + "description": "The character used to separate CSV fields, default is comma (,).", + "required": false, + "defaultValue": "," + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include the header row in the CSV output. Defaults to true if headers are present or inferred.", + "required": false, + "defaultValue": "true" + }, + { + "name": "quoteFields", + "type": "boolean", + "description": "If true, all fields will be enclosed in quotes; otherwise only fields containing delimiters, quotes, or newlines are quoted. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the CSV formatted string in 'csvString' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to prepare or export data from structured objects/arrays into a CSV format for data exchange, reporting, or file generation. It is useful for generating clean CSV text with customizable options like delimiters and headers.", + "limitations": "This tool does not validate data semantics or types beyond formatting for CSV output, nor does it support complex nested structures or streaming large datasets.", + "examples": [ + "Convert an array of objects to CSV string including headers.", + "Generate CSV with a custom delimiter (e.g., tab \\t) without headers.", + "Export array of arrays to CSV with all fields quoted." + ] + }, + "tags": [ + "data", + "csv", + "export", + "formatting", + "validation" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30},{\"name\":\"Bob\",\"age\":25}]}", + "description": "Basic usage converting array of objects to CSV string with inferred headers." + }, + { + "inputJson": "{\"data\":[[\"Alice\",30],[\"Bob\",25]],\"headers\":[\"name\",\"age\"],\"delimiter\":\"\\t\",\"includeHeaders\":true}", + "description": "Create tab-delimited CSV from array of arrays with explicit headers." + }, + { + "inputJson": "{\"data\":[{\"city\":\"New York\",\"state\":\"NY\"},{\"city\":\"Los Angeles\",\"state\":\"CA\"}],\"quoteFields\":true}", + "description": "CSV generation with all fields quoted." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "CSV", + "context": null + } + }, + { + "name": "etl-processes.analyzeTable", + "description": "This tool accepts a structured tabular dataset (as an array of objects or a CSV string) and performs comprehensive data analysis including summary statistics, missing value detection, data type inference, and basic distribution insights for each column. It outputs a detailed report to help understand the data quality and characteristics for informed ETL decisions.", + "category": "etl-processes", + "parameters": [ + { + "name": "tableData", + "type": "array", + "description": "The table data to analyze, given as an array of objects where each object represents a row with key-value pairs for columns.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "The format of the input table data; accepts 'json' (array of objects) or 'csv' string. Default is 'json'.", + "required": false, + "defaultValue": "json" + }, + { + "name": "includeNullAnalysis", + "type": "boolean", + "description": "Whether to include analysis of missing/null values per column. Default is true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "sampleSize", + "type": "number", + "description": "Number of rows to sample for analysis to improve performance. If 0 or omitted, analyzes all rows. Default is 0.", + "required": false, + "defaultValue": "0" + }, + { + "name": "columnsToAnalyze", + "type": "array", + "description": "Optional list of column names to restrict analysis to. If empty or omitted, analyzes all columns.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object including summary statistics (count, mean, median, mode, std deviation) for numeric columns, frequency counts for categorical columns, detected data types, and missing value statistics." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to quickly understand the structure, quality, and key statistics of an input tabular dataset to guide further ETL steps such as cleaning, transformation, or validation. It is especially helpful for exploratory data profiling before pipeline development.", + "limitations": "This tool does not perform data cleaning, transformation, or visualization. It only analyzes and summarizes data characteristics. It may not handle extremely large datasets efficiently without sampling.", + "examples": [ + "Analyze this JSON table data and provide summary statistics and missing value analysis.", + "Provide a detailed type inference and distribution report for these CSV rows.", + "Analyze only the columns 'age' and 'income' from this dataset for data quality insights." + ] + }, + "tags": [ + "etl", + "data-analysis", + "table", + "profiling", + "data-quality", + "summary", + "statistics" + ], + "examples": [ + { + "inputJson": "{\"tableData\":[{\"name\":\"Alice\",\"age\":30,\"income\":70000},{\"name\":\"Bob\",\"age\":null,\"income\":48000},{\"name\":\"Charlie\",\"age\":25,\"income\":null}],\"dataFormat\":\"json\",\"includeNullAnalysis\":true}", + "description": "Analyze a small JSON table to get statistics and null value report." + }, + { + "inputJson": "{\"tableData\":\"name,age,income\\nAlice,30,70000\\nBob,,48000\\nCharlie,25,\",\"dataFormat\":\"csv\",\"includeNullAnalysis\":true}", + "description": "Analyze a CSV string input including missing values." + }, + { + "inputJson": "{\"tableData\":[{\"id\":1,\"score\":88},{\"id\":2,\"score\":92},{\"id\":3,\"score\":85}],\"columnsToAnalyze\":[\"score\"]}", + "description": "Analyze only the 'score' column from JSON table data." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Table", + "context": null + } + }, + { + "name": "etl-processes.formatText", + "description": "Formats input text according to specified rules such as trimming whitespace, changing case (uppercase, lowercase, title case), replacing substrings, and normalizing spacing. Accepts raw text and outputs the transformed text string.", + "category": "etl-processes", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The input text string to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "trimWhitespace", + "type": "boolean", + "description": "Whether to remove leading and trailing whitespace from the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "caseFormat", + "type": "string", + "description": "The case transformation to apply: 'none', 'uppercase', 'lowercase', or 'titleCase'.", + "required": false, + "defaultValue": "none" + }, + { + "name": "replaceRules", + "type": "array", + "description": "An array of objects each with 'from' and 'to' strings to replace all occurrences of 'from' with 'to' in the text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "normalizeSpaces", + "type": "boolean", + "description": "If true, replaces multiple consecutive whitespace characters with a single space.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted text string in the 'formattedText' property." + }, + "aiAgent": { + "useCase": "Use this tool when needing to clean and format raw text data as part of an ETL process or pre-processing pipeline, such as standardizing case, trimming unwanted whitespace, normalizing spacing, or applying bulk substring replacements.", + "limitations": "This tool does not perform grammar correction, semantic transformations, or language translation.", + "examples": [ + "Format the raw text by trimming spaces and converting all letters to lowercase.", + "Replace all occurrences of 'foo' with 'bar' in a given text and convert to title case.", + "Normalize multiple spaces to single spaces and trim leading/trailing whitespace." + ] + }, + "tags": [ + "text", + "formatting", + "ETL", + "preprocessing", + "string manipulation" + ], + "examples": [ + { + "inputJson": "{\"text\":\" Hello World! \",\"trimWhitespace\":true,\"caseFormat\":\"uppercase\",\"replaceRules\":[],\"normalizeSpaces\":true}", + "description": "Trim whitespace and convert to uppercase." + }, + { + "inputJson": "{\"text\":\"hello foo foo world\",\"trimWhitespace\":false,\"caseFormat\":\"titleCase\",\"replaceRules\":[{\"from\":\"foo\",\"to\":\"bar\"}],\"normalizeSpaces\":false}", + "description": "Replace 'foo' with 'bar' and convert to title case without trimming whitespace." + }, + { + "inputJson": "{\"text\":\"Multiple spaces here.\",\"trimWhitespace\":true,\"caseFormat\":\"none\",\"replaceRules\":[],\"normalizeSpaces\":true}", + "description": "Normalize multiple spaces into single spaces and trim whitespace." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Text", + "context": null + } + }, + { + "name": "etl-processes.buildEndpoint", + "description": "Constructs a fully configured API endpoint for ETL workflows by accepting source and target data specifications, transformation logic, and protocol settings. Processes inputs to generate deployable endpoint code or configuration that extracts data, applies transformations, and loads it to target systems.", + "category": "etl-processes", + "parameters": [ + { + "name": "sourceConfig", + "type": "object", + "description": "Configuration object specifying the data source details including type, connection parameters, and query or extraction method.", + "required": true, + "defaultValue": "" + }, + { + "name": "transformations", + "type": "array", + "description": "Array of transformation definitions that specify how source data should be manipulated before loading, e.g., filtering, mapping, or aggregation.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetConfig", + "type": "object", + "description": "Configuration object defining the target system for loading data including type, connection info, and destination details.", + "required": true, + "defaultValue": "" + }, + { + "name": "protocol", + "type": "string", + "description": "The communication protocol for the endpoint, such as REST, gRPC, or websocket.", + "required": false, + "defaultValue": "REST" + }, + { + "name": "endpointPath", + "type": "string", + "description": "The URL path where the endpoint will be accessible.", + "required": false, + "defaultValue": "/etl-endpoint" + }, + { + "name": "authentication", + "type": "object", + "description": "Optional authentication settings such as API keys, OAuth tokens, or basic auth to secure the endpoint.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum allowed duration in seconds for the ETL operation before timeout.", + "required": false, + "defaultValue": "60" + }, + { + "name": "enableLogging", + "type": "boolean", + "description": "Flag to enable detailed logging of ETL endpoint operations for monitoring or debugging.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated endpoint code or configuration string, status message, and endpoint metadata including accessible URL and protocol." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically build or configure an API endpoint that performs ETL by extracting data from a source, applying transformations, and loading results to a target system. Ideal for automating data integration pipelines and exposing them as APIs.", + "limitations": "This tool does not execute or deploy the endpoint, nor does it handle runtime errors beyond configuration. It expects valid source and target configurations beforehand.", + "examples": [ + "Create a REST API endpoint to extract sales data from a SQL database, filter it for the last month, transform currency fields, and load into a reporting data warehouse.", + "Generate a gRPC endpoint that pulls JSON data from a web API, applies mapping transformations, and writes the output to a cloud storage bucket.", + "Build an authenticated websocket endpoint for streaming IoT sensor data, performing aggregation, before loading into a time-series database." + ] + }, + "tags": [ + "etl", + "endpoint", + "api", + "data-integration", + "automation", + "build", + "transform", + "load" + ], + "examples": [ + { + "inputJson": "{\"sourceConfig\":{\"type\":\"sql\",\"connectionString\":\"Server=myserver;Database=sales;User Id=admin;Password=pass;\",\"query\":\"SELECT * FROM transactions WHERE date >= '2024-01-01'\"},\"transformations\":[{\"type\":\"filter\",\"field\":\"amount\",\"operator\":\">\", \"value\":100},{\"type\":\"map\",\"field\":\"currency\",\"mapping\":{\"USD\":\"usd\",\"EUR\":\"eur\"}}],\"targetConfig\":{\"type\":\"datawarehouse\",\"connectionString\":\"warehouse://load?db=analytics\"},\"protocol\":\"REST\",\"endpointPath\":\"/api/sales-data\",\"authentication\":{\"apiKey\":\"abcdef12345\"},\"timeoutSeconds\":120,\"enableLogging\":true}", + "description": "Build a REST API endpoint that extracts large transactions since 2024-01-01 from SQL, transforms currency fields, loads to data warehouse, secured with API key." + }, + { + "inputJson": "{\"sourceConfig\":{\"type\":\"http\",\"endpoint\":\"https://api.example.com/sensors\",\"method\":\"GET\"},\"transformations\":[{\"type\":\"aggregate\",\"field\":\"temperature\",\"operation\":\"avg\"}],\"targetConfig\":{\"type\":\"timeseriesdb\",\"connectionString\":\"tsdb://host:port/db\"},\"protocol\":\"WebSocket\",\"endpointPath\":\"/ws/sensors\",\"authentication\":{},\"timeoutSeconds\":30,\"enableLogging\":false}", + "description": "Create a websocket endpoint that pulls sensor data from HTTP API, averages temperature values, and loads into timeseries DB without authentication." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Endpoint", + "context": null + } + }, + { + "name": "etl-processes.buildModule", + "description": "Builds a reusable ETL (Extract, Transform, Load) module from user specifications. Accepts configuration inputs describing data sources, transformation rules, and target destinations. Processes the inputs to generate a code module/script that automates the ETL workflow, outputting the complete module as a source code string for integration or deployment.", + "category": "etl-processes", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "Name of the ETL module to be generated, used as a class or function name in code.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceType", + "type": "string", + "description": "Type of the source system (e.g., 'database', 'csv', 'api').", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceConfig", + "type": "object", + "description": "Configuration details needed to connect/read from the source system (e.g., connection strings, file paths).", + "required": true, + "defaultValue": "" + }, + { + "name": "transformations", + "type": "array", + "description": "List of transformation steps or rules to apply to the extracted data (e.g., mapping fields, filtering, aggregating).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationType", + "type": "string", + "description": "Type of the target system where data should be loaded (e.g., 'database', 'dataWarehouse', 'file').", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationConfig", + "type": "object", + "description": "Connection or write configuration details for the destination system.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeErrorHandling", + "type": "boolean", + "description": "Flag to include error handling and logging code in the generated ETL module.", + "required": false, + "defaultValue": "true" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Programming language for the generated ETL module (e.g., 'Python', 'JavaScript').", + "required": false, + "defaultValue": "Python" + } + ], + "returns": { + "type": "object", + "description": "An object containing source code of the ETL module as a string along with metadata such as language and module name." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate a custom ETL module quickly based on detailed source, transformation, and destination specifications. Ideal for automating data pipeline assembly, enabling rapid integration of varying data sources and load targets without manual coding.", + "limitations": "It cannot connect to or validate live data sources or perform actual data extraction/load at runtime—only generates the module code. Complex transformations requiring user-defined functions outside basic mapping/filtering may need manual editing after generation.", + "examples": [ + "Build an ETL module named 'UserDataSync' extracting from a MySQL database, transforming user fields, and loading into a PostgreSQL table.", + "Create a CSV to JSON loader ETL module with filtering and field renaming steps, targeting a file storage destination.", + "Generate a simple ETL process module in JavaScript to pull data from a REST API, capitalize certain string fields, and load it to a MongoDB database." + ] + }, + "tags": [ + "etl", + "code-generation", + "data-pipelines", + "automation", + "transformation", + "loading", + "extraction" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"CustomerDataETL\",\"sourceType\":\"database\",\"sourceConfig\":{\"host\":\"db.example.com\",\"port\":3306,\"username\":\"user\",\"password\":\"pass\",\"database\":\"sales\"},\"transformations\":[{\"type\":\"mapFields\",\"mapping\":{\"cust_id\":\"customerId\",\"cust_name\":\"name\"}},{\"type\":\"filter\",\"condition\":\"region == 'US'\"}],\"destinationType\":\"dataWarehouse\",\"destinationConfig\":{\"host\":\"dw.example.com\",\"port\":5432,\"username\":\"dwuser\",\"password\":\"dwpass\",\"database\":\"analytics\"},\"includeErrorHandling\":true,\"programmingLanguage\":\"Python\"}", + "description": "Generate a Python ETL module named 'CustomerDataETL' that connects to a MySQL database as source, transforms fields and filters for US region customers, and loads into a data warehouse using PostgreSQL." + }, + { + "inputJson": "{\"moduleName\":\"ApiToCsvETL\",\"sourceType\":\"api\",\"sourceConfig\":{\"endpoint\":\"https://api.example.com/data\",\"authToken\":\"abcdef123456\"},\"transformations\":[{\"type\":\"filter\",\"condition\":\"status == 'active'\"},{\"type\":\"renameFields\",\"mapping\":{\"firstName\":\"first_name\",\"lastName\":\"last_name\"}}],\"destinationType\":\"csv\",\"destinationConfig\":{\"filePath\":\"/tmp/output.csv\"},\"includeErrorHandling\":false,\"programmingLanguage\":\"JavaScript\"}", + "description": "Create a JavaScript ETL module named 'ApiToCsvETL' extracting data from a REST API with authentication, filtering active records, renaming fields, and saving to a CSV file, without error handling code." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Module", + "context": null + } + }, + { + "name": "etl-processes.createKPI", + "description": "Creates a Key Performance Indicator (KPI) definition based on provided raw data source, transformation rules, and calculation logic. Accepts details about data inputs, aggregation methods, filters, and target metrics, then outputs a structured KPI object ready for integration into reporting or analytics systems.", + "category": "etl-processes", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "Name of the KPI to be created, used as an identifier and display label.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSource", + "type": "object", + "description": "Definition of the raw data source including type (e.g., database, CSV), location, and schema details.", + "required": true, + "defaultValue": "" + }, + { + "name": "calculationLogic", + "type": "string", + "description": "Expression or formula defining how the KPI value should be calculated from the data source fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "Method for aggregating data points (e.g., sum, average, count) to compute the KPI.", + "required": true, + "defaultValue": "sum" + }, + { + "name": "filters", + "type": "array", + "description": "Optional list of filter conditions to apply on the data source to refine the KPI dataset before calculation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetFrequency", + "type": "string", + "description": "Reporting frequency for the KPI (e.g., daily, weekly, monthly).", + "required": false, + "defaultValue": "monthly" + }, + { + "name": "description", + "type": "string", + "description": "Optional textual description explaining the KPI's purpose and usage.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Structured KPI object including name, data source metadata, calculation details, filters, aggregation method, and frequency ready for use in analytics workflows." + }, + "aiAgent": { + "useCase": "Use this tool when you need to define a new KPI by specifying the underlying raw data, transformation logic, and aggregation rules. It helps automate the setup of KPIs for dashboards, reports, or monitoring systems by generating standardized KPI definitions.", + "limitations": "This tool does not connect to live data sources or perform the actual data extraction. It only defines KPI metadata and calculation logic. Data validation or result computation must be handled separately.", + "examples": [ + "Create a KPI to measure monthly total sales from a sales database with sum aggregation and filtering for active products.", + "Define a daily KPI measuring average customer satisfaction score from survey CSV files, applying weighted calculation logic." + ] + }, + "tags": [ + "etl", + "kpi", + "analytics", + "data-transformation", + "reporting", + "metric-definition" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"MonthlyTotalSales\",\"dataSource\":{\"type\":\"database\",\"connectionString\":\"Server=myServer;Database=salesDb;\",\"table\":\"transactions\"},\"calculationLogic\":\"SUM(amount)\",\"aggregationMethod\":\"sum\",\"filters\":[{\"field\":\"status\",\"operator\":\"=\",\"value\":\"completed\"}],\"targetFrequency\":\"monthly\",\"description\":\"Total sales amount for completed transactions each month.\"}", + "description": "Create a KPI that sums completed sales transactions monthly from a database." + }, + { + "inputJson": "{\"kpiName\":\"DailyAvgCustomerSatisfaction\",\"dataSource\":{\"type\":\"csv\",\"path\":\"/data/surveys/daily_scores.csv\",\"schema\":{\"fields\":[{\"name\":\"score\",\"type\":\"number\"},{\"name\":\"date\",\"type\":\"string\"}]}},\"calculationLogic\":\"AVG(score)\",\"aggregationMethod\":\"average\",\"filters\":[],\"targetFrequency\":\"daily\",\"description\":\"Average daily customer satisfaction score from survey data.\"}", + "description": "Define a KPI for the average customer satisfaction score per day using CSV survey data." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "etl-processes.createTable", + "description": "Creates a new data table within a specified database or data store based on provided schema definitions and optional initial data. Accepts inputs defining table name, columns with data types and constraints, and optionally initial rows to populate. Outputs a confirmation of table creation with metadata including schema and row count.", + "category": "etl-processes", + "parameters": [ + { + "name": "tableName", + "type": "string", + "description": "Name of the table to be created in the data store.", + "required": true, + "defaultValue": "" + }, + { + "name": "columns", + "type": "array", + "description": "Array of column definitions, each containing column name, data type, and optional constraints such as primary key or not null.", + "required": true, + "defaultValue": "" + }, + { + "name": "primaryKey", + "type": "array", + "description": "Optional array of column names to designate as primary key(s) for the table.", + "required": false, + "defaultValue": "" + }, + { + "name": "initialData", + "type": "array", + "description": "Optional array of objects representing rows to insert immediately after table creation; keys correspond to column names.", + "required": false, + "defaultValue": "" + }, + { + "name": "databaseType", + "type": "string", + "description": "Type of database system where the table will be created, e.g., 'sql', 'nosql', or specific like 'postgres', 'mongodb'.", + "required": false, + "defaultValue": "sql" + }, + { + "name": "ifNotExists", + "type": "boolean", + "description": "Whether to skip creation if table already exists (true), or throw an error (false).", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object confirming success status, table metadata including name, columns, primary key, and number of rows inserted." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically define and create new data tables in ETL workflows, enabling structured data storage prior to transform and load phases. Ideal for agents orchestrating database schema setup or data warehouse table management.", + "limitations": "Cannot perform complex database-specific configurations such as indexes beyond primary keys or set up triggers. Does not support schema evolution or altering existing tables.", + "examples": [ + "Create a user table with id as primary key and initial sample users.", + "Create a sales data table with columns for date, product, and amount without initial data.", + "Create a product catalog table with constraints if it does not exist" + ] + }, + "tags": [ + "etl", + "table", + "database", + "schema", + "create", + "data-structure", + "loading" + ], + "examples": [ + { + "inputJson": "{\"tableName\":\"users\",\"columns\":[{\"name\":\"id\",\"type\":\"integer\",\"constraints\":[\"primary key\"]},{\"name\":\"username\",\"type\":\"varchar(255)\",\"constraints\":[\"not null\"]},{\"name\":\"email\",\"type\":\"varchar(255)\"}],\"primaryKey\":[\"id\"],\"initialData\":[{\"id\":1,\"username\":\"alice\",\"email\":\"alice@example.com\"},{\"id\":2,\"username\":\"bob\",\"email\":\"bob@example.com\"}],\"databaseType\":\"sql\",\"ifNotExists\":true}", + "description": "Create a 'users' table with id as primary key and two initial user records." + }, + { + "inputJson": "{\"tableName\":\"sales\",\"columns\":[{\"name\":\"sale_date\",\"type\":\"date\"},{\"name\":\"product_id\",\"type\":\"integer\"},{\"name\":\"amount\",\"type\":\"decimal(10,2)\"}],\"databaseType\":\"sql\"}", + "description": "Create a 'sales' table for transactional sales data without initial data." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Table", + "context": null + } + }, + { + "name": "database-management.createSchema", + "description": "Creates a new database schema based on the provided schema definition. Accepts a JSON object describing tables, columns, data types, constraints, and relationships. Processes the input to generate and execute SQL commands that instantiate the schema, returning a success status and details of created tables.", + "category": "database-management", + "parameters": [ + { + "name": "schemaDefinition", + "type": "object", + "description": "A JSON object defining the database schema including tables, columns, data types, constraints, and relationships.", + "required": true, + "defaultValue": "" + }, + { + "name": "databaseType", + "type": "string", + "description": "Type of database for which the schema will be created, e.g., 'PostgreSQL', 'MySQL', or 'SQLite'.", + "required": true, + "defaultValue": "" + }, + { + "name": "executeOnDatabase", + "type": "boolean", + "description": "Whether to execute the schema creation directly on a connected database instance.", + "required": false, + "defaultValue": "false" + }, + { + "name": "connectionString", + "type": "string", + "description": "Database connection string to use if executeOnDatabase is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing success status, messages, and details of created schema elements" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create or initialize a database schema programmatically from a high-level schema definition. This includes generating appropriate SQL statements for various database systems and optionally executing them to instantiate the schema. Useful in automated deployment, migration, or database setup tasks.", + "limitations": "This tool does not validate semantic correctness of the schema beyond basic structure. Complex database-specific features like stored procedures, triggers, or advanced permissions are not handled. Also, it requires valid connection details when execution is requested.", + "examples": [ + "Create a PostgreSQL schema with tables for users and orders from a JSON schema.", + "Generate MySQL schema DDL commands without executing them.", + "Initialize a SQLite schema by executing schema creation commands directly on the database file." + ] + }, + "tags": [ + "database", + "schema", + "creation", + "SQL", + "automation", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"schemaDefinition\":{\"tables\":[{\"name\":\"users\",\"columns\":[{\"name\":\"id\",\"type\":\"SERIAL\",\"primaryKey\":true},{\"name\":\"email\",\"type\":\"VARCHAR(255)\",\"unique\":true},{\"name\":\"created_at\",\"type\":\"TIMESTAMP\"}]}]},\"databaseType\":\"PostgreSQL\",\"executeOnDatabase\":false,\"connectionString\":\"\"}", + "description": "Generate PostgreSQL schema DDL for a users table without executing on a database." + }, + { + "inputJson": "{\"schemaDefinition\":{\"tables\":[{\"name\":\"products\",\"columns\":[{\"name\":\"product_id\",\"type\":\"INT\",\"primaryKey\":true},{\"name\":\"name\",\"type\":\"VARCHAR(100)\"},{\"name\":\"price\",\"type\":\"DECIMAL(10,2)\"}]}]},\"databaseType\":\"MySQL\",\"executeOnDatabase\":true,\"connectionString\":\"mysql://user:pass@localhost:3306/shopdb\"}", + "description": "Create a products table schema and execute it on a local MySQL database." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Schema", + "context": null + } + }, + { + "name": "database-management.createSpec", + "description": "Creates a structured database specification document based on user-provided schema definitions and configuration options. Accepts input defining tables, fields, data types, constraints, and relationships, then produces a comprehensive JSON or YAML specification outlining the database schema for use in development or documentation.", + "category": "database-management", + "parameters": [ + { + "name": "schemaDefinitions", + "type": "array", + "description": "An array of table or collection definitions including fields, data types, and constraints; each element is an object defining a schema entity.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The format of the output specification document, e.g., 'json' or 'yaml'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "includeRelationships", + "type": "boolean", + "description": "Whether to include foreign keys and relationships in the specification output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeIndexes", + "type": "boolean", + "description": "Whether to include index definitions in the specification document.", + "required": false, + "defaultValue": "true" + }, + { + "name": "specTitle", + "type": "string", + "description": "Title or name for the specification document.", + "required": false, + "defaultValue": "Database Schema Specification" + }, + { + "name": "version", + "type": "string", + "description": "Version number or identifier for the specification document.", + "required": false, + "defaultValue": "1.0" + } + ], + "returns": { + "type": "object", + "description": "An object containing the specification document as a formatted string and metadata such as format and timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a clear and standardized database schema specification document from defined schema inputs. It helps when preparing documentation, sharing schema design, or automating database deployment scripts. Especially useful in projects requiring formal spec outputs in JSON or YAML for interoperability or validation.", + "limitations": "Does not generate actual database creation scripts or perform database migrations. It cannot validate the schema for runtime correctness, only produce the specification document.", + "examples": [ + "Generate a JSON spec document from table definitions including relationships.", + "Create a YAML schema spec without index information for documentation.", + "Produce a versioned spec document with a custom title for client review." + ] + }, + "tags": [ + "database", + "schema", + "specification", + "documentation", + "json", + "yaml", + "design" + ], + "examples": [ + { + "inputJson": "{\"schemaDefinitions\":[{\"tableName\":\"Users\",\"fields\":[{\"name\":\"id\",\"type\":\"int\",\"primaryKey\":true},{\"name\":\"username\",\"type\":\"string\",\"unique\":true},{\"name\":\"email\",\"type\":\"string\"}]},{\"tableName\":\"Orders\",\"fields\":[{\"name\":\"orderId\",\"type\":\"int\",\"primaryKey\":true},{\"name\":\"userId\",\"type\":\"int\",\"foreignKey\":{\"table\":\"Users\",\"field\":\"id\"}},{\"name\":\"amount\",\"type\":\"decimal\"}]}],\"outputFormat\":\"json\",\"includeRelationships\":true,\"includeIndexes\":true,\"specTitle\":\"Ecommerce DB Spec\",\"version\":\"2.0\"}", + "description": "Create a JSON schema spec for an ecommerce system with Users and Orders tables including their relationships." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Spec", + "context": null + } + }, + { + "name": "testing-automation.composeReport", + "description": "Generates a comprehensive test execution report by accepting raw test run data, coverage metrics, and error logs. It processes and formats the data into a structured, human-readable report summarizing test results, coverage statistics, and detailed error information in HTML or PDF format.", + "category": "testing-automation", + "parameters": [ + { + "name": "testResults", + "type": "array", + "description": "Array of individual test case results including status, name, and duration.", + "required": true, + "defaultValue": "" + }, + { + "name": "coverageData", + "type": "object", + "description": "Code coverage metrics data to be included in the report.", + "required": false, + "defaultValue": "" + }, + { + "name": "errorLogs", + "type": "array", + "description": "List of error or failure logs captured during the test run.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Desired output format of the report, e.g., 'html' or 'pdf'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeTimestamp", + "type": "boolean", + "description": "Whether to include timestamp of test execution in the report header.", + "required": false, + "defaultValue": "true" + }, + { + "name": "title", + "type": "string", + "description": "Title for the test report document.", + "required": false, + "defaultValue": "Test Execution Report" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report content as a string and the file format." + }, + "aiAgent": { + "useCase": "When an AI agent needs to produce a detailed, readable summary of test execution results for stakeholders, including test pass/fail status, coverage insights, and error details, this tool composes and formats these elements into a standard report document. It is appropriate after test automation suites complete to provide summarized insights.", + "limitations": "Cannot execute or run tests itself; only formats and composes reports from provided test data. It does not analyze source code or fix errors automatically.", + "examples": [ + "Generate a PDF report summarizing last night's automated test results including coverage data.", + "Create an HTML report that compiles test results and error logs with the title 'Sprint 12 QA Report'.", + "Produce a test report in HTML format without coverage details but with error logs included." + ] + }, + "tags": [ + "testing", + "automation", + "reporting", + "test-results", + "coverage", + "error-logging", + "document-generation" + ], + "examples": [ + { + "inputJson": "{\"testResults\":[{\"name\":\"LoginTest\",\"status\":\"passed\",\"duration\":12.5},{\"name\":\"SignupTest\",\"status\":\"failed\",\"duration\":10.2}],\"coverageData\":{\"statements\":85,\"branches\":80,\"functions\":90},\"errorLogs\":[\"SignupTest: AssertionError on email validation.\"],\"reportFormat\":\"pdf\",\"includeTimestamp\":true,\"title\":\"Nightly Test Report\"}", + "description": "Generate a PDF test report including test results, coverage metrics, and error logs with timestamp and custom title." + }, + { + "inputJson": "{\"testResults\":[{\"name\":\"APIHealthCheck\",\"status\":\"passed\",\"duration\":5.1}],\"reportFormat\":\"html\",\"includeTimestamp\":false,\"title\":\"API Tests Summary\"}", + "description": "Create a minimal HTML report for a single successful test case without coverage or error logs." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "testing-automation.buildTest", + "description": "Generates automated test code for software applications based on user-defined test scenarios and parameters. Accepts inputs such as test type, target language, framework, and test cases; processes them to build executable test scripts; outputs the generated test code as a string or file content.", + "category": "testing-automation", + "parameters": [ + { + "name": "testType", + "type": "string", + "description": "Type of test to generate (e.g., unit, integration, e2e).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "Programming language for the test code (e.g., JavaScript, Python, Java).", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "Testing framework to target (e.g., Jest, Mocha, PyTest, JUnit).", + "required": true, + "defaultValue": "" + }, + { + "name": "testCases", + "type": "array", + "description": "List of test cases details, each including inputs, expected outputs, and descriptions.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSetupTeardown", + "type": "boolean", + "description": "Whether to include setup and teardown hooks in the generated test code.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of output code (e.g., 'string' for code text, 'file' for file-ready content).", + "required": false, + "defaultValue": "string" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated test code as a string and metadata such as language and framework." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate boilerplate or customized automated test scripts for software projects, speeding up test creation and ensuring consistency across multiple languages and frameworks. It is helpful to quickly turn test case specifications into executable tests in popular programming environments.", + "limitations": "This tool does not execute the generated tests or validate runtime behavior. It does not generate tests with deep complex logic beyond provided scenarios. It relies on the quality and completeness of the input test case definitions.", + "examples": [ + "Generate JavaScript unit tests using Jest for provided function test cases.", + "Build Python integration test scripts using PyTest including setup and teardown.", + "Create end-to-end test scripts in Java using JUnit framework based on user scenarios." + ] + }, + "tags": [ + "testing", + "automation", + "code-generation", + "test-script", + "software-testing", + "unit-test", + "integration-test" + ], + "examples": [ + { + "inputJson": "{\"testType\":\"unit\",\"targetLanguage\":\"JavaScript\",\"testFramework\":\"Jest\",\"testCases\":[{\"description\":\"adds two numbers\",\"input\":{\"a\":1,\"b\":2},\"expectedOutput\":3}],\"includeSetupTeardown\":true,\"outputFormat\":\"string\"}", + "description": "Generate a JavaScript Jest unit test for addition function." + }, + { + "inputJson": "{\"testType\":\"integration\",\"targetLanguage\":\"Python\",\"testFramework\":\"PyTest\",\"testCases\":[{\"description\":\"checks user login flow\",\"input\":{\"username\":\"testuser\",\"password\":\"pass123\"},\"expectedOutput\":true}],\"includeSetupTeardown\":false,\"outputFormat\":\"string\"}", + "description": "Generate a Python PyTest integration test verifying user login without setup/teardown." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Test", + "context": null + } + }, + { + "name": "testing-automation.generateParagraph", + "description": "Generates a realistic, coherent paragraph of text for use as dummy content in automated testing scenarios. Accepts parameters to specify topic, length, complexity, and tone, then produces a text paragraph useful for populating UI elements or validating text handling in applications.", + "category": "testing-automation", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The subject or theme for the generated paragraph. Helps tailor content to a specific context.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of sentences to include in the paragraph. Controls paragraph size.", + "required": false, + "defaultValue": "5" + }, + { + "name": "complexity", + "type": "string", + "description": "Desired complexity or reading grade level of the paragraph; options: 'simple', 'medium', 'complex'.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "tone", + "type": "string", + "description": "Stylistic tone of the paragraph, such as 'formal', 'informal', 'neutral'.", + "required": false, + "defaultValue": "neutral" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph as a string property 'paragraph'." + }, + "aiAgent": { + "useCase": "This tool should be used when testing software that requires realistic placeholder text that adapts to different themes, lengths, and complexity levels, such as UI components displaying text, content editors, or formatting validation. It helps create varied and relevant dummy content for automated test scenarios.", + "limitations": "The generated paragraph is synthetic and may lack factual accuracy. It is not suitable for generating domain-specific expert content or highly accurate technical text.", + "examples": [ + "Generate a short, informal paragraph about gardening for a mobile app UI test.", + "Create a medium-length, formal paragraph on data privacy for validating a corporate dashboard.", + "Produce a simple paragraph with no specified topic for generic placeholder text in a web form." + ] + }, + "tags": [ + "testing", + "automation", + "content-generation", + "dummy-text", + "ui-testing", + "paragraph", + "placeholder" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"gardening\",\"length\":3,\"complexity\":\"simple\",\"tone\":\"informal\"}", + "description": "Generate a short, simple, informal paragraph about gardening." + }, + { + "inputJson": "{\"topic\":\"data privacy\",\"length\":6,\"complexity\":\"medium\",\"tone\":\"formal\"}", + "description": "Produce a medium-length, formal paragraph about data privacy." + }, + { + "inputJson": "{\"length\":4}", + "description": "Generate a neutral, medium complexity paragraph of 4 sentences with no specific topic." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "testing-automation.createLead", + "description": "This tool automates the creation of business leads within a test environment. It accepts lead details such as name, contact information, company, and optional metadata, performs validation and submits the lead to the system being tested, and returns the creation status along with a unique lead identifier for further testing workflows.", + "category": "testing-automation", + "parameters": [ + { + "name": "leadName", + "type": "string", + "description": "Full name of the lead to be created", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Email address of the lead for contact", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Contact phone number of the lead", + "required": false, + "defaultValue": "" + }, + { + "name": "companyName", + "type": "string", + "description": "Name of the company associated with the lead", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional custom key-value pairs related to the lead (e.g., lead source, campaign)", + "required": false, + "defaultValue": "{}" + }, + { + "name": "simulateValidationError", + "type": "boolean", + "description": "If true, simulates a validation error for testing validation handling", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the leadId (string), creationStatus (string: success or failure), and optional errorMessage if creation failed." + }, + "aiAgent": { + "useCase": "Use this tool when automating tests for CRM or lead management systems to programmatically generate leads with specified data, verify lead creation workflows, and validate error handling for bad inputs. Useful for load testing, functional testing, and chained test scenarios involving lead data.", + "limitations": "This tool does not perform real-world lead qualification or enrichment; it strictly automates lead creation in test environments. It may not integrate with all third-party CRM systems without additional adapters.", + "examples": [ + "Create a lead with full contact info for testing lead ingestion.", + "Create a lead with minimal data to check required fields validation.", + "Simulate a validation error by intentionally providing invalid email format." + ] + }, + "tags": [ + "testing", + "automation", + "lead-management", + "crm", + "test-data", + "business" + ], + "examples": [ + { + "inputJson": "{\"leadName\":\"Alice Johnson\",\"email\":\"alice.johnson@example.com\",\"phoneNumber\":\"+1234567890\",\"companyName\":\"Acme Corp\",\"metadata\":{\"source\":\"website\"}}", + "description": "Create a lead named Alice Johnson with contact info and metadata source." + }, + { + "inputJson": "{\"leadName\":\"Bob Smith\",\"email\":\"bob.smith@example.com\"}", + "description": "Create a lead with only required name and email fields to test minimal input." + }, + { + "inputJson": "{\"leadName\":\"Invalid Email\",\"email\":\"invalid-email\",\"simulateValidationError\":true}", + "description": "Simulate a validation error for invalid email format input." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Lead", + "context": null + } + }, + { + "name": "testing-automation.createModule", + "description": "Generates a structured automated testing module for a specified programming language and framework based on user inputs including test targets, test types, and configurations. It outputs ready-to-use source code files that implement test stubs or full test cases facilitating quick test automation setup.", + "category": "testing-automation", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "The name of the test module to be created, used as the source file and test suite identifier.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language for the test module, e.g., 'JavaScript', 'Python', or 'Java'.", + "required": true, + "defaultValue": "" + }, + { + "name": "framework", + "type": "string", + "description": "Testing framework to target, e.g., 'Jest', 'PyTest', 'JUnit'.", + "required": true, + "defaultValue": "" + }, + { + "name": "testTargets", + "type": "array", + "description": "List of function or component names that the tests should cover.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "testTypes", + "type": "array", + "description": "Types of tests to generate for each target, e.g., ['unit', 'integration', 'mock'].", + "required": false, + "defaultValue": "[\"unit\"]" + }, + { + "name": "includeSetupTeardown", + "type": "boolean", + "description": "Whether to include setup and teardown hooks in the generated module.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputPath", + "type": "string", + "description": "Filesystem path or project directory where the generated module files should be saved.", + "required": false, + "defaultValue": "./tests" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated source code as string(s), file names, and optionally file system paths where they are saved." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to quickly scaffold or generate automated test code modules for software projects, supporting multiple languages and frameworks. Ideal for accelerating test creation by producing ready test module code based on specified targets and test types, thus streamlining test automation workflows.", + "limitations": "This tool cannot execute tests, perform dynamic analysis, or validate the correctness of generated tests beyond code structure. It also does not handle complex test logic generation or integration with CI/CD pipelines directly.", + "examples": [ + "Create a Jest test module in JavaScript named 'userModuleTests' to unit test functions 'login' and 'logout' with setup/teardown included.", + "Generate a PyTest module in Python named 'apiTests' targeting 'fetchData' for integration tests without setup/teardown.", + "Create a JUnit Java module 'PaymentTests' that mocks database calls for payment processing functions." + ] + }, + "tags": [ + "testing", + "automation", + "module", + "code-generation", + "scaffolding", + "unit-testing", + "integration-testing" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"userModuleTests\",\"language\":\"JavaScript\",\"framework\":\"Jest\",\"testTargets\":[\"login\",\"logout\"],\"testTypes\":[\"unit\"],\"includeSetupTeardown\":true,\"outputPath\":\"./tests\"}", + "description": "Generate a Jest JavaScript test module named 'userModuleTests' for unit testing 'login' and 'logout' functions including setup and teardown hooks." + }, + { + "inputJson": "{\"moduleName\":\"apiTests\",\"language\":\"Python\",\"framework\":\"PyTest\",\"testTargets\":[\"fetchData\"],\"testTypes\":[\"integration\"],\"includeSetupTeardown\":false,\"outputPath\":\"./test/integration\"}", + "description": "Create a PyTest module called 'apiTests' for integration testing of the 'fetchData' function without setup/teardown code." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "devops.analyzeKPI", + "description": "This tool accepts operational metrics data for DevOps environments, including deployment frequency, lead time, change failure rate, and mean time to recovery. It processes this data to analyze key performance indicators (KPIs), identifying trends, bottlenecks, and areas for improvement. The output provides a detailed KPI report including summary statistics, historical comparisons, and recommendations for optimizing DevOps workflows.", + "category": "devops", + "parameters": [ + { + "name": "metricsData", + "type": "array", + "description": "An array of metric objects representing DevOps KPIs over time, each containing timestamp and value fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeRangeStart", + "type": "string", + "description": "Start timestamp (ISO 8601) for the analysis period.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeRangeEnd", + "type": "string", + "description": "End timestamp (ISO 8601) for the analysis period.", + "required": false, + "defaultValue": "" + }, + { + "name": "kpiTypes", + "type": "array", + "description": "Specific KPI types to analyze (e.g., 'deploymentFrequency', 'leadTime', 'changeFailureRate', 'MTTR').", + "required": false, + "defaultValue": "[\"deploymentFrequency\",\"leadTime\",\"changeFailureRate\",\"MTTR\"]" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include actionable recommendations based on KPI analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "Method to aggregate data points: 'daily', 'weekly', or 'monthly'. Defaults to 'weekly' for trend analysis.", + "required": false, + "defaultValue": "weekly" + } + ], + "returns": { + "type": "object", + "description": "An object containing analyzed KPI summaries, trend analytics, detected anomalies, and optionally improvement recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing DevOps KPIs to understand performance trends over a specified period, identify operational bottlenecks, and obtain insights into how deployment and recovery processes can be optimized. Especially useful for continuous integration metrics to guide DevOps process improvements.", + "limitations": "Does not provide root cause analysis for individual failures or unrelated system metrics. Accuracy depends on quality and completeness of input data. Not designed to replace specialized monitoring tools but to aggregate and interpret existing KPI data.", + "examples": [ + "Analyze the last quarter's deployment frequency and MTTR with recommendations.", + "Compare change failure rates and lead times between two time periods to identify trends.", + "Generate a KPI summary report focusing only on deployment frequency for the past month." + ] + }, + "tags": [ + "devops", + "kpi", + "analytics", + "performance", + "deployment", + "monitoring", + "continuousIntegration" + ], + "examples": [ + { + "inputJson": "{\"metricsData\":[{\"type\":\"deploymentFrequency\",\"timestamp\":\"2024-03-01T00:00:00Z\",\"value\":5},{\"type\":\"deploymentFrequency\",\"timestamp\":\"2024-03-08T00:00:00Z\",\"value\":7},{\"type\":\"MTTR\",\"timestamp\":\"2024-03-01T00:00:00Z\",\"value\":120}],\"timeRangeStart\":\"2024-03-01T00:00:00Z\",\"timeRangeEnd\":\"2024-03-31T23:59:59Z\",\"kpiTypes\":[\"deploymentFrequency\",\"MTTR\"],\"includeRecommendations\":true,\"aggregationMethod\":\"weekly\"}", + "description": "Analyze deployment frequency and MTTR for March 2024 weekly, including recommendations." + }, + { + "inputJson": "{\"metricsData\":[{\"type\":\"changeFailureRate\",\"timestamp\":\"2024-01-01T00:00:00Z\",\"value\":0.13},{\"type\":\"changeFailureRate\",\"timestamp\":\"2024-02-01T00:00:00Z\",\"value\":0.09}],\"timeRangeStart\":\"2024-01-01T00:00:00Z\",\"timeRangeEnd\":\"2024-02-28T23:59:59Z\",\"kpiTypes\":[\"changeFailureRate\"],\"includeRecommendations\":false,\"aggregationMethod\":\"monthly\"}", + "description": "Monthly change failure rate analysis for Jan and Feb 2024 without recommendations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "KPI", + "context": null + } + }, + { + "name": "devops.uploadDataset", + "description": "Uploads a dataset file to a specified cloud storage or data repository as part of a DevOps workflow. Accepts dataset files in common formats (CSV, JSON, Parquet), validates integrity, optionally compresses, and uploads to target storage with metadata tagging. Returns upload status and metadata info.", + "category": "devops", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path to the dataset file to upload (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetStorageUri", + "type": "string", + "description": "URI of the cloud storage or data repository where the dataset will be uploaded (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileFormat", + "type": "string", + "description": "Format of the dataset file, e.g., CSV, JSON, Parquet (optional, inferred if empty).", + "required": false, + "defaultValue": "" + }, + { + "name": "compress", + "type": "boolean", + "description": "Whether to compress the dataset file before uploading (optional, default false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadataTags", + "type": "object", + "description": "Key-value pairs of metadata tags to associate with the uploaded dataset (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the dataset if it already exists at the target location (optional, default false).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Result object containing upload status (success or failure), message, uploaded file URI, and applied metadata tags." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automate uploading dataset files as part of continuous integration or deployment pipelines. Ideal for pushing datasets into cloud storage systems in a standardized, repeatable way with optional metadata tagging and file compression.", + "limitations": "Cannot perform dataset content validation beyond file integrity; does not transform or analyze the dataset content. Requires existing access credentials to target storage outside this tool.", + "examples": [ + "Upload a CSV dataset to AWS S3 storage with compression enabled.", + "Upload a JSON dataset to a data repository and add metadata tags for versioning.", + "Upload and overwrite an existing Parquet dataset on Google Cloud Storage." + ] + }, + "tags": [ + "devops", + "upload", + "dataset", + "cloud storage", + "automation", + "data pipeline" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"./data/sales.csv\",\"targetStorageUri\":\"s3://my-bucket/datasets/sales.csv\",\"fileFormat\":\"CSV\",\"compress\":true,\"metadataTags\":{\"project\":\"sales-analytics\",\"version\":\"v1.2\"},\"overwrite\":false}", + "description": "Upload a CSV sales dataset to an AWS S3 bucket with compression and metadata tags, no overwrite." + }, + { + "inputJson": "{\"filePath\":\"/tmp/data.json\",\"targetStorageUri\":\"gs://my-datalake/raw/data.json\",\"fileFormat\":\"JSON\",\"compress\":false,\"metadataTags\":{},\"overwrite\":true}", + "description": "Upload a JSON dataset to Google Cloud Storage, overwriting existing file, without compression or metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Dataset", + "context": null + } + }, + { + "name": "devops.sendAlert", + "description": "Sends a security alert notification through specified channels based on input alert details and severity level. Accepts alert message, severity, target channels, and metadata. Processes alert content formatting and delivers the alert using integrated communication services. Returns confirmation status and delivery report.", + "category": "devops", + "parameters": [ + { + "name": "alertMessage", + "type": "string", + "description": "The detailed message content of the security alert to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "The severity level of the alert (e.g., low, medium, high, critical).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetChannels", + "type": "array", + "description": "List of channels to send the alert to, such as ['email', 'sms', 'slack'].", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata object providing additional context such as timestamps, affected systems, or reference IDs.", + "required": false, + "defaultValue": "" + }, + { + "name": "sendTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule the alert; send immediately if omitted.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing status of sending operation including success flag, message, and detailed delivery results per channel." + }, + "aiAgent": { + "useCase": "This tool should be used when an automated system or agent needs to notify relevant teams or personnel about security incidents or warnings in a timely manner. It is useful in continuous monitoring and incident response setups to escalate alerts with context and severity.", + "limitations": "Cannot generate alerts automatically; requires preformatted alert content. Does not decrypt or interpret encrypted or unstructured alert data. Delivery depends on external channel integrations and may fail if those are misconfigured.", + "examples": [ + "Send a critical security breach alert to email and Slack immediately.", + "Schedule a medium severity alert for system maintenance notification to email.", + "Send a low severity warning with metadata to SMS channel only." + ] + }, + "tags": [ + "notification", + "security", + "alert", + "devops", + "incident-response", + "automation" + ], + "examples": [ + { + "inputJson": "{\"alertMessage\":\"Unauthorized login attempt detected on server XYZ\",\"severityLevel\":\"high\",\"targetChannels\":[\"email\",\"slack\"],\"metadata\":{\"timestamp\":\"2024-06-10T14:23:00Z\",\"serverId\":\"XYZ\"}}", + "description": "Send a high severity alert about an unauthorized login on server XYZ through email and Slack." + }, + { + "inputJson": "{\"alertMessage\":\"Scheduled maintenance will start at midnight UTC\",\"severityLevel\":\"medium\",\"targetChannels\":[\"email\"],\"sendTime\":\"2024-06-11T00:00:00Z\"}", + "description": "Schedule a medium severity alert about maintenance start for delivery via email at midnight UTC." + }, + { + "inputJson": "{\"alertMessage\":\"Multiple failed password attempts detected\",\"severityLevel\":\"low\",\"targetChannels\":[\"sms\"],\"metadata\":{\"attemptCount\":5}}", + "description": "Send a low severity alert of multiple password failures to SMS recipients with attempt count included." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "devops.formatJSON", + "description": "Formats a raw JSON string to improve readability and consistency with configurable options. Accepts a JSON string input and outputs a well-indented, optionally compacted or prettified JSON string according to specified indentation levels, spacing characters, and sorting of object keys.", + "category": "devops", + "parameters": [ + { + "name": "jsonString", + "type": "string", + "description": "Raw JSON string to be formatted. Must be valid JSON.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for indentation per level in pretty-printed JSON.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "If true, object keys will be sorted alphabetically in output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "compact", + "type": "boolean", + "description": "If true, output JSON will be compacted with no whitespace, ignoring indentation and sorting.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted JSON string or an error message if input is invalid. The formattedJson field contains the processed JSON string on success." + }, + "aiAgent": { + "useCase": "Use this tool when you receive JSON data that is minified, poorly formatted, or inconsistently styled, and you need to present it in a readable and standardized format for debugging, logging, code review, or documentation purposes. It helps developers and deployment scripts by producing clean JSON output aligned with preferred formatting styles.", + "limitations": "The tool does not validate JSON schema or data correctness beyond basic parseability. It cannot fix semantic JSON errors and only formats structurally valid JSON. Very large JSON inputs might impact performance or memory usage.", + "examples": [ + "Format a minified JSON string with 4 spaces indentation.", + "Compact a JSON string to minimize size for transmission.", + "Format JSON with sorted keys and default 2 space indentation." + ] + }, + "tags": [ + "json", + "formatting", + "devops", + "data-cleanup", + "code-quality", + "debugging" + ], + "examples": [ + { + "inputJson": "{\"jsonString\":\"{\\\"name\\\":\\\"app\\\",\\\"version\\\":\\\"1.0\\\",\\\"components\\\":[\\\"web\\\", \\\"db\\\"]}\",\"indentation\":4,\"sortKeys\":false,\"compact\":false}", + "description": "Format a typical JSON string with 4 spaces indentation for readability." + }, + { + "inputJson": "{\"jsonString\":\"{\\\"z\\\":1,\\\"a\\\":2,\\\"m\\\":3}\",\"indentation\":2,\"sortKeys\":true,\"compact\":false}", + "description": "Format JSON with object keys sorted alphabetically." + }, + { + "inputJson": "{\"jsonString\":\"{\\\"debug\\\":true,\\\"timeout\\\":30}\",\"compact\":true}", + "description": "Compact JSON output with no spacing or indentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "JSON", + "context": null + } + }, + { + "name": "devops.buildService", + "description": "Builds and deploys a scalable cloud service based on the provided configuration. Accepts service definition including source code repository URL, infrastructure setup details, and deployment environment. Automates the build, containerization, and infrastructure provisioning steps, then deploys the service and returns deployment status and endpoints.", + "category": "devops", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "The unique name of the service to build and deploy.", + "required": true, + "defaultValue": "" + }, + { + "name": "repositoryUrl", + "type": "string", + "description": "Git repository URL containing the service source code.", + "required": true, + "defaultValue": "" + }, + { + "name": "branch", + "type": "string", + "description": "Git branch to build from. Defaults to 'main'.", + "required": false, + "defaultValue": "main" + }, + { + "name": "dockerfilePath", + "type": "string", + "description": "Relative path to the Dockerfile in the repository. Defaults to root Dockerfile.", + "required": false, + "defaultValue": "./Dockerfile" + }, + { + "name": "infrastructureConfig", + "type": "object", + "description": "Infrastructure configuration object specifying cloud provider, resource sizes, scaling policies, and network settings.", + "required": true, + "defaultValue": "" + }, + { + "name": "deploymentEnvironment", + "type": "string", + "description": "Target environment for deployment, e.g., 'staging', 'production'.", + "required": true, + "defaultValue": "" + }, + { + "name": "enableAutoScaling", + "type": "boolean", + "description": "Flag to enable auto-scaling for the deployed service. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set in the deployed service.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing deploymentId, status (e.g., 'success', 'failure'), serviceEndpoint URL if deployed successfully, and logs from build and deployment processes." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the process of building a cloud-based microservice from source code, provisioning necessary infrastructure, deploying it, and retrieving deployment results or errors for analysis or further orchestration.", + "limitations": "This tool does not support multi-region deployments, complex blue-green or canary deployment strategies directly, nor does it handle manual approval gates or integrations with third-party CI/CD pipelines out of the box.", + "examples": [ + "Build and deploy a new service from the main branch into the staging environment with default scaling.", + "Deploy a service with custom environment variables and specific Dockerfile for production.", + "Build a service using a non-default git branch and enable auto-scaling disabled." + ] + }, + "tags": [ + "devops", + "deployment", + "build", + "automation", + "cloud", + "infrastructure", + "service" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"user-auth-service\",\"repositoryUrl\":\"https://github.com/org/user-auth\",\"branch\":\"main\",\"dockerfilePath\":\"./Dockerfile\",\"infrastructureConfig\":{\"cloudProvider\":\"aws\",\"instanceType\":\"t3.medium\",\"replicaCount\":2,\"autoScalingPolicy\":{\"minReplicas\":2,\"maxReplicas\":5}},\"deploymentEnvironment\":\"staging\",\"enableAutoScaling\":true,\"environmentVariables\":{\"JWT_SECRET\":\"s3cr3t\"}}", + "description": "Build and deploy the user authentication service from AWS with auto-scaling enabled in the staging environment." + }, + { + "inputJson": "{\"serviceName\":\"payment-gateway\",\"repositoryUrl\":\"https://gitlab.com/org/payment\",\"branch\":\"release\",\"dockerfilePath\":\"/deploy/Dockerfile.prod\",\"infrastructureConfig\":{\"cloudProvider\":\"gcp\",\"machineType\":\"n1-standard-1\",\"replicaCount\":3},\"deploymentEnvironment\":\"production\",\"enableAutoScaling\":false,\"environmentVariables\":{\"PAYMENT_API_KEY\":\"apikey123\"}}", + "description": "Deploy payment gateway service from the release branch with a custom Dockerfile path, on Google Cloud without auto-scaling to production." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Service", + "context": null + } + }, + { + "name": "devops.buildConfig", + "description": "Generates a deployment or build configuration file (e.g., YAML or JSON) for CI/CD pipelines or infrastructure automation based on provided project parameters and environment settings. Accepts input describing project type, environment variables, dependencies, and build steps and outputs a ready-to-use configuration file string.", + "category": "devops", + "parameters": [ + { + "name": "projectType", + "type": "string", + "description": "Type of project for which to build the config, such as 'nodejs', 'python', or 'docker'. Influences template selection and build steps.", + "required": true, + "defaultValue": "" + }, + { + "name": "environment", + "type": "string", + "description": "Target deployment environment like 'development', 'staging', or 'production' which affects environment-specific settings in the config.", + "required": true, + "defaultValue": "" + }, + { + "name": "dependencies", + "type": "array", + "description": "List of external tools or packages (e.g., databases, services) the project depends on to include relevant setup in the config.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "buildSteps", + "type": "array", + "description": "An ordered list of commands or script actions to execute during the build phase, such as 'npm install', 'pytest', or 'docker build'.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to inject into the build or runtime environment.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated configuration, e.g., 'yaml' or 'json'. Defaults to 'yaml'.", + "required": false, + "defaultValue": "yaml" + }, + { + "name": "includeNotifications", + "type": "boolean", + "description": "Whether to add notification hooks (e.g., Slack messages) to the configuration upon build success or failure.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the configuration file content as a string and the format used." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate automated CI/CD or deployment config files tailored to specific project types and environments, reducing manual setup and ensuring consistent pipeline configurations.", + "limitations": "Cannot validate the correctness or syntax of user-provided build steps or dependency names; it builds configuration from given data but does not execute or test it.", + "examples": [ + "Create a build config for a Node.js app to deploy in production with Docker dependencies and notifications enabled.", + "Generate a CI config in JSON for Python project in staging with environment variables and custom build steps.", + "Build a simple deployment config for a development environment of a Go project with no dependencies and no notifications." + ] + }, + "tags": [ + "devops", + "build", + "configuration", + "ci-cd", + "automation", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"projectType\":\"nodejs\",\"environment\":\"production\",\"dependencies\":[\"docker\"],\"buildSteps\":[\"npm install\",\"npm test\",\"docker build -t myapp .\"],\"environmentVariables\":{\"NODE_ENV\":\"production\"},\"outputFormat\":\"yaml\",\"includeNotifications\":true}", + "description": "Build a YAML config for production Node.js project with Docker and notifications." + }, + { + "inputJson": "{\"projectType\":\"python\",\"environment\":\"staging\",\"dependencies\":[\"postgresql\"],\"buildSteps\":[\"pip install -r requirements.txt\",\"pytest\"],\"environmentVariables\":{\"DB_HOST\":\"localhost\"},\"outputFormat\":\"json\",\"includeNotifications\":false}", + "description": "Generate a JSON CI config for a Python staging project with PostgreSQL dependency." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Config", + "context": null + } + }, + { + "name": "devops.buildModule", + "description": "Builds a software module by compiling source code and packaging it according to specified build configuration. Accepts source code repository URL or local path, build configuration file path, and environment options. Produces a build artifact such as a compiled binary or package with build logs and status.", + "category": "devops", + "parameters": [ + { + "name": "sourcePath", + "type": "string", + "description": "Local filesystem path or Git repository URL pointing to the module's source code.", + "required": true, + "defaultValue": "" + }, + { + "name": "buildConfigPath", + "type": "string", + "description": "File path to the build configuration (e.g., a YAML or JSON file specifying build steps and environment).", + "required": false, + "defaultValue": "" + }, + { + "name": "targetEnvironment", + "type": "string", + "description": "Target environment or platform for the build, e.g., 'linux-x64', 'windows-x86'.", + "required": false, + "defaultValue": "" + }, + { + "name": "buildArgs", + "type": "object", + "description": "Optional key-value pairs to override or supplement build configuration parameters.", + "required": false, + "defaultValue": "" + }, + { + "name": "cleanBuild", + "type": "boolean", + "description": "Whether to perform a clean build by removing previous artifacts before building.", + "required": false, + "defaultValue": "false" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to allow the build process before aborting.", + "required": false, + "defaultValue": "600" + } + ], + "returns": { + "type": "object", + "description": "BuildResult object containing status ('success' or 'failure'), path or URL to the build artifact if successful, and build logs detailing compilation output and errors." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automate building a software module from source with customized build configurations in a DevOps pipeline or continuous integration environment. It helps automate compiling, packaging, and producing deployable artifacts from code repositories.", + "limitations": "Does not perform unit tests or integration testing of the built module; it also cannot deploy the artifact to runtime environments or package repositories by itself.", + "examples": [ + "Build the latest commit of a GitHub repo using default config", + "Build a module with a custom build config and clean environment", + "Build a software module targeting Windows x86 environment with build argument overrides" + ] + }, + "tags": [ + "build", + "devops", + "automation", + "ci", + "continuous integration", + "compilation", + "packaging", + "software module" + ], + "examples": [ + { + "inputJson": "{\"sourcePath\":\"https://github.com/example/project.git\",\"buildConfigPath\":\"build/build.yml\",\"targetEnvironment\":\"linux-x64\",\"buildArgs\":{\"optimize\":\"true\"},\"cleanBuild\":true}", + "description": "Build from Git repo with a specific build config on Linux x64 platform, cleaning previous output." + }, + { + "inputJson": "{\"sourcePath\":\"./local-modules/mymodule\",\"targetEnvironment\":\"windows-x86\",\"timeoutSeconds\":300}", + "description": "Build a local module source directory targeting Windows x86 platform with 5-minute timeout." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Module", + "context": null + } + }, + { + "name": "devops.generateKPI", + "description": "Generates key performance indicators (KPIs) for DevOps pipelines and infrastructure based on input data such as pipeline logs, deployment metrics, and monitoring statistics. Processes input metrics to compute standardized KPIs like deployment frequency, lead time, change failure rate, and mean time to recovery, outputting a structured KPI report suitable for dashboards and analytics.", + "category": "devops", + "parameters": [ + { + "name": "inputData", + "type": "object", + "description": "Structured input data containing logs, deployment records, and monitoring metrics to analyze for KPI generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "kpiList", + "type": "array", + "description": "Array of KPI names to generate; e.g., ['deploymentFrequency','leadTime','changeFailureRate','MTTR']. If empty or omitted, generates all standard KPIs.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeRange", + "type": "object", + "description": "Object defining the time range for the KPI calculation with 'start' and 'end' ISO 8601 datetime strings.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format: 'json' (default) or 'csv'.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "An object containing calculated KPI values keyed by KPI name, including timestamps and metadata suitable for integration into DevOps dashboards or analytics platforms." + }, + "aiAgent": { + "useCase": "Use this tool when you need to analyze DevOps performance metrics to evaluate pipeline efficiency, deployment stability, and recovery speed. It helps to automate KPI extraction from raw operational data to support continuous improvement and reporting.", + "limitations": "Does not ingest raw logs directly; expects parsed and structured input data. Cannot predict future KPIs or handle non-DevOps metrics. Limited to standard DevOps KPIs defined in kpiList.", + "examples": [ + "Generate KPIs for last month's deployment data including deployment frequency and mean time to recovery.", + "Produce a KPI report in CSV format for specified deployment metrics over the past week.", + "Calculate all standard DevOps KPIs for current quarter to feed into performance monitoring dashboard." + ] + }, + "tags": [ + "devops", + "kpi", + "analytics", + "monitoring", + "continuous-integration", + "deployment", + "performance", + "automation" + ], + "examples": [ + { + "inputJson": "{\"inputData\":{\"deployments\":[{\"id\":\"d1\",\"timestamp\":\"2024-04-01T10:00:00Z\",\"status\":\"success\"},{\"id\":\"d2\",\"timestamp\":\"2024-04-03T14:00:00Z\",\"status\":\"failure\"}],\"incidents\":[{\"id\":\"i1\",\"start\":\"2024-04-03T14:05:00Z\",\"end\":\"2024-04-03T15:00:00Z\"}],\"pipelineRuns\":[{\"id\":\"p1\",\"start\":\"2024-04-01T09:50:00Z\",\"end\":\"2024-04-01T10:05:00Z\"}]},\"kpiList\":[\"deploymentFrequency\",\"MTTR\"],\"timeRange\":{\"start\":\"2024-04-01T00:00:00Z\",\"end\":\"2024-04-07T23:59:59Z\"},\"outputFormat\":\"json\"}", + "description": "Generate deployment frequency and mean time to recovery KPIs from deployment and incident data for the first week of April 2024 in JSON format." + }, + { + "inputJson": "{\"inputData\":{\"deployments\":[{\"id\":\"d10\",\"timestamp\":\"2024-05-01T08:00:00Z\",\"status\":\"success\"}],\"pipelineRuns\":[{\"id\":\"p10\",\"start\":\"2024-05-01T07:50:00Z\",\"end\":\"2024-05-01T08:15:00Z\"}]},\"kpiList\":[],\"timeRange\":{\"start\":\"2024-05-01T00:00:00Z\",\"end\":\"2024-05-31T23:59:59Z\"},\"outputFormat\":\"csv\"}", + "description": "Generate all standard KPIs for May 2024 deployments and pipeline runs and output the result as CSV." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "KPI", + "context": null + } + }, + { + "name": "devops.createInstance", + "description": "Creates a new infrastructure instance in the specified cloud environment based on provided configuration parameters. Inputs include cloud provider, instance type, region, operating system, and optional startup scripts. The tool provisions the instance and returns details like instance ID, IP address, status, and URL.", + "category": "devops", + "parameters": [ + { + "name": "cloudProvider", + "type": "string", + "description": "The cloud service provider to create the instance on (e.g., AWS, Azure, GCP).", + "required": true, + "defaultValue": "" + }, + { + "name": "instanceType", + "type": "string", + "description": "The type or size of the instance to create (e.g., t2.micro, n1-standard-1).", + "required": true, + "defaultValue": "" + }, + { + "name": "region", + "type": "string", + "description": "The geographical region or availability zone where the instance should be deployed.", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "The operating system image to use for the instance (e.g., Ubuntu 20.04, Windows Server 2019).", + "required": true, + "defaultValue": "" + }, + { + "name": "startupScript", + "type": "string", + "description": "Optional shell script or commands to run on instance startup.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "object", + "description": "Optional key-value pairs to tag the instance with metadata.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "autoAssignPublicIp", + "type": "boolean", + "description": "Whether to automatically assign a public IP address to the instance.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns details of the provisioned instance including instance ID, IP addresses, status, and accessible URLs if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically provision and configure a new compute instance in a cloud environment as part of deployment, testing, or environment setup workflows. It supports configuration of instance parameters and automates instance creation, returning all relevant connection details.", + "limitations": "This tool does not manage instance lifecycle beyond initial creation (no stopping, starting, or termination). It depends on valid credentials configured in the environment and does not validate the availability of requested instance types or regions before creation.", + "examples": [ + "Create a new AWS EC2 t2.micro instance in us-east-1 region running Ubuntu 20.04 with a startup script to install nginx.", + "Provision a GCP instance type n1-standard-1 in europe-west1 with Windows Server and no public IP assigned.", + "Launch an Azure VM with tags for environment and owner, auto assigning a public IP." + ] + }, + "tags": [ + "cloud", + "infrastructure", + "deployment", + "automation", + "instance", + "provisioning", + "devops", + "compute" + ], + "examples": [ + { + "inputJson": "{\"cloudProvider\":\"AWS\",\"instanceType\":\"t2.micro\",\"region\":\"us-east-1\",\"operatingSystem\":\"Ubuntu 20.04\",\"startupScript\":\"#!/bin/bash\\napt-get update && apt-get install -y nginx\",\"tags\":{\"environment\":\"dev\",\"project\":\"website\"},\"autoAssignPublicIp\":true}", + "description": "Create an AWS micro instance in the US East region with Ubuntu, automatic nginx install, and tagged metadata." + }, + { + "inputJson": "{\"cloudProvider\":\"GCP\",\"instanceType\":\"n1-standard-1\",\"region\":\"europe-west1\",\"operatingSystem\":\"Windows Server 2019\",\"autoAssignPublicIp\":false}", + "description": "Provision a GCP Windows server instance in Europe without a public IP." + }, + { + "inputJson": "{\"cloudProvider\":\"Azure\",\"instanceType\":\"Standard_B1s\",\"region\":\"eastus\",\"operatingSystem\":\"Ubuntu 20.04\",\"tags\":{\"owner\":\"teamA\",\"purpose\":\"testing\"}}", + "description": "Launch an Azure Ubuntu instance in East US with tags but default public IP assignment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Instance", + "context": null + } + }, + { + "name": "devops.createKPI", + "description": "Generates a customized Key Performance Indicator (KPI) metric definition based on deployment and infrastructure data inputs. Accepts configuration parameters detailing data sources, aggregation methods, target environments, and alert thresholds. Produces a structured KPI object ready for integration into monitoring dashboards or CI/CD pipelines.", + "category": "devops", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The unique name for the KPI to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "Array of strings representing the data sources to aggregate (e.g., logs, deployment metrics).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "aggregationMethod", + "type": "string", + "description": "The method to aggregate data (e.g., average, percentile, sum).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetEnvironment", + "type": "string", + "description": "The environment (e.g., production, staging) where the KPI will be monitored.", + "required": true, + "defaultValue": "" + }, + { + "name": "alertThreshold", + "type": "number", + "description": "Numeric threshold at which alerts should be triggered.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeWindowMinutes", + "type": "number", + "description": "Time window in minutes over which the KPI is calculated.", + "required": false, + "defaultValue": "60" + }, + { + "name": "enabled", + "type": "boolean", + "description": "Flag to enable or disable the KPI monitoring.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created KPI, including its configuration, unique identifier, status, and metadata for use in monitoring or deployment tools." + }, + "aiAgent": { + "useCase": "Use this tool when needing to define and generate tailored KPIs based on deployment, infrastructure, or CI/CD metric inputs to facilitate real-time monitoring and alerting in devops workflows. It enables automated KPI setup for dashboards or alert systems.", + "limitations": "This tool does not retrieve or process raw metric data itself, nor does it evaluate historical KPI performance; it only creates KPI configurations based on provided parameters.", + "examples": [ + "Create a KPI to monitor average deployment duration in the production environment with alerts if exceeding 10 minutes.", + "Generate a KPI for error rate percentage across staging deployments using logs and metric aggregation.", + "Create a KPI for total number of failed deployment jobs over the last hour with threshold alerting enabled." + ] + }, + "tags": [ + "devops", + "KPI", + "monitoring", + "deployment", + "CI/CD", + "automation" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"DeploymentDurationAvg\",\"dataSources\":[\"deployment_metrics\"],\"aggregationMethod\":\"average\",\"targetEnvironment\":\"production\",\"alertThreshold\":10,\"timeWindowMinutes\":30,\"enabled\":true}", + "description": "Create a KPI to monitor the average duration of deployments in production, triggering alerts if average duration exceeds 10 minutes over a 30 minute window." + }, + { + "inputJson": "{\"kpiName\":\"ErrorRatePercentage\",\"dataSources\":[\"logs\",\"deployment_metrics\"],\"aggregationMethod\":\"percentile\",\"targetEnvironment\":\"staging\",\"alertThreshold\":5,\"timeWindowMinutes\":60,\"enabled\":true}", + "description": "Generate a KPI for error rate percentage in staging environment aggregating logs and deployment metrics, alerting if errors exceed 5% over an hour." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "frontend-development.analyzeDeal", + "description": "Analyzes a business deal object from the frontend perspective by evaluating its key attributes such as value, risk factors, deadlines, involved parties, and status. It processes input deal details to provide a structured report with risk assessment, priority recommendation, and progress summary to aid user decision making in UI workflows.", + "category": "frontend-development", + "parameters": [ + { + "name": "dealData", + "type": "object", + "description": "The deal object containing information like value, dates, parties, and current status to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "currentDate", + "type": "string", + "description": "Optional current date in ISO format to compare against deal deadlines; defaults to today if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeRiskAnalysis", + "type": "boolean", + "description": "Flag to indicate if risk factors should be evaluated and included in the analysis report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "priorityThreshold", + "type": "number", + "description": "A numeric value threshold to determine if the deal is high priority based on its value; default is 100000.", + "required": false, + "defaultValue": "100000" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object containing risk assessment, priority flag, days until deadline, and summary metrics for UI display and decision support." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to analyze frontend-received deal objects to produce actionable insights like risk levels, deadlines status, and priority evaluation, aiding in dynamic interface updates or user decision workflows.", + "limitations": "This tool does not perform backend validation or update deal status; it only analyzes provided deal data from the frontend perspective.", + "examples": [ + "Analyze a deal object to assess if it is high risk and approaching deadline.", + "Provide a priority recommendation based on deal value and days left until closing.", + "Generate a summary report for a deal with missing deadline to highlight incomplete data." + ] + }, + "tags": [ + "frontend-development", + "deal-analysis", + "risk-assessment", + "priority-evaluation", + "business", + "UI-insights" + ], + "examples": [ + { + "inputJson": "{\"dealData\":{\"value\":150000,\"startDate\":\"2024-05-01\",\"endDate\":\"2024-06-15\",\"parties\":[\"Client A\",\"Vendor B\"],\"status\":\"open\"},\"currentDate\":\"2024-06-01\",\"includeRiskAnalysis\":true,\"priorityThreshold\":100000}", + "description": "Analyze a high-value open deal nearing the deadline with risk analysis enabled." + }, + { + "inputJson": "{\"dealData\":{\"value\":50000,\"startDate\":\"2024-04-01\",\"endDate\":\"2024-12-31\",\"parties\":[\"Client X\"],\"status\":\"negotiation\"},\"includeRiskAnalysis\":false}", + "description": "Analyze a mid-value deal with late deadline, risk analysis disabled, using default current date and priority threshold." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Deal", + "context": null + } + }, + { + "name": "frontend-development.downloadCSV", + "description": "Enables frontend applications to generate and trigger the download of CSV files directly within the browser. Accepts an array of objects representing tabular data, converts them into CSV format with configurable delimiters and file name, and initiates a client-side download without server interaction.", + "category": "frontend-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects representing the rows to be converted into CSV format. Each object corresponds to one row.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "The desired name of the downloaded CSV file, including the .csv extension.", + "required": false, + "defaultValue": "\"data.csv\"" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate fields in the CSV file, defaulting to comma (,).", + "required": false, + "defaultValue": "\",\"" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Determines whether to include the header row with object keys as column names.", + "required": false, + "defaultValue": "true" + }, + { + "name": "quoteStrings", + "type": "boolean", + "description": "Whether to wrap string values in quotes to handle commas or newline characters within fields.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing a boolean 'success' indicating if download was triggered, and an optional 'error' message if failure occurred." + }, + "aiAgent": { + "useCase": "Use this tool when a frontend app needs to allow users to export displayed or processed data into CSV files for offline use, reporting, or sharing, without relying on backend services. It supports customization of file naming, delimiters, headers, and string quoting to accommodate different CSV standards.", + "limitations": "Cannot handle extremely large datasets that cause browser memory issues. Does not provide server-side storage or remote CSV generation.", + "examples": [ + "Download user list as CSV file named 'users.csv' including headers.", + "Export filtered product data with semicolon delimiters and no string quotes.", + "Generate a CSV file from an array of simple JSON objects with default settings." + ] + }, + "tags": [ + "frontend", + "csv", + "download", + "export", + "data", + "client-side", + "file" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"email\":\"alice@example.com\"},{\"name\":\"Bob\",\"age\":25,\"email\":\"bob@example.com\"}],\"fileName\":\"users.csv\",\"delimiter\":\",\",\"includeHeaders\":true,\"quoteStrings\":true}", + "description": "Download an array of user objects as a CSV file named \"users.csv\" with headers and quoted strings." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Screwdriver\",\"price\":12.50,\"inStock\":true},{\"product\":\"Hammer\",\"price\":15.00,\"inStock\":false}],\"fileName\":\"products.csv\",\"delimiter\":\";\",\"includeHeaders\":true,\"quoteStrings\":false}", + "description": "Export product data using semicolon delimiter and without quotation marks around strings." + }, + { + "inputJson": "{\"data\":[{\"city\":\"New York\",\"population\":8400000},{\"city\":\"Los Angeles\",\"population\":4000000}],\"fileName\":\"cities.csv\"}", + "description": "Generate a simple CSV download of city populations with default settings." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "CSV", + "context": null + } + }, + { + "name": "frontend-development.draftText", + "description": "Generates draft text content for frontend UI elements based on input prompts, style preferences, and context. Accepts seed text or keywords, desired tone and length, and outputs a text draft suitable for integration in user interfaces such as placeholders, tooltips, or content sections.", + "category": "frontend-development", + "parameters": [ + { + "name": "seedText", + "type": "string", + "description": "Initial text or keywords to guide the text generation.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the generated text (e.g., formal, casual, friendly).", + "required": false, + "defaultValue": "friendly" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated text in characters.", + "required": false, + "defaultValue": "150" + }, + { + "name": "contextType", + "type": "string", + "description": "The UI context where the text will be used (e.g., tooltip, buttonLabel, placeholder).", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the generated text (e.g., en, es, fr).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted text content, its tone, and length details." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate draft textual content for frontend interfaces to improve user experience by providing contextual, stylistically appropriate placeholders, labels, or help text based on minimal input. It helps streamline UI content creation during design or prototyping phases.", + "limitations": "Cannot generate highly technical or domain-specific text without adequate seed input; quality depends on input specificity; does not localize cultural nuances beyond language code.", + "examples": [ + "Generate a friendly tooltip text explaining a save button.", + "Draft placeholder text for a search input field with casual tone.", + "Create a formal error message for invalid user input in a form." + ] + }, + "tags": [ + "text generation", + "UI content", + "frontend", + "drafting", + "UX writing", + "placeholders", + "tooltips" + ], + "examples": [ + { + "inputJson": "{\"seedText\":\"save button\",\"tone\":\"friendly\",\"maxLength\":80,\"contextType\":\"tooltip\",\"language\":\"en\"}", + "description": "Draft a friendly tooltip text for a save button." + }, + { + "inputJson": "{\"seedText\":\"search input\",\"tone\":\"casual\",\"maxLength\":100,\"contextType\":\"placeholder\",\"language\":\"en\"}", + "description": "Create casual placeholder text for a search input field." + }, + { + "inputJson": "{\"seedText\":\"invalid form input\",\"tone\":\"formal\",\"maxLength\":120,\"contextType\":\"errorMessage\",\"language\":\"en\"}", + "description": "Generate a formal error message for invalid form input." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Text", + "context": null + } + }, + { + "name": "frontend-development.generateHeading", + "description": "Generates HTML code for a heading element based on the provided content, heading level, and optional styling. Accepts text content, desired heading level (h1 to h6), optional CSS classes and inline styles, and returns a string with the corresponding HTML heading tag ready to use in front-end interfaces.", + "category": "frontend-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text content to be placed inside the heading element.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "Heading level from 1 to 6 indicating h1 through h6 tags.", + "required": true, + "defaultValue": "1" + }, + { + "name": "cssClasses", + "type": "array", + "description": "Optional list of CSS class names to add to the heading element for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "inlineStyles", + "type": "string", + "description": "Optional inline CSS styles to apply directly to the heading element.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string containing the complete HTML markup for the heading element with specified text, level, classes, and styles." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to dynamically create semantic heading elements for web pages or applications, ensuring correct levels and optional styling for UI rendering. It simplifies generating consistent and accessible headings from user content or structured data.", + "limitations": "Does not validate CSS class names or styles; it does not sanitize text input so agents should ensure content safety to prevent XSS. Also, it only generates basic heading tags and does not handle complex nested markup or localization.", + "examples": [ + "Generate a main page title with 'Welcome to Our Site' as an h1 heading.", + "Create a subsection heading 'Features' as h2 with class 'section-title'.", + "Produce a heading with custom inline style color blue for 'Contact Us' at h3 level." + ] + }, + "tags": [ + "frontend", + "html", + "heading", + "ui", + "component-generation", + "web", + "markup" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Welcome to Our Site\",\"level\":1,\"cssClasses\":[],\"inlineStyles\":\"\"}", + "description": "Generate a simple main heading h1 with plain text." + }, + { + "inputJson": "{\"text\":\"Features\",\"level\":2,\"cssClasses\":[\"section-title\"],\"inlineStyles\":\"\"}", + "description": "Generate an h2 heading with a CSS class for styling subsections." + }, + { + "inputJson": "{\"text\":\"Contact Us\",\"level\":3,\"cssClasses\":[],\"inlineStyles\":\"color: blue; font-weight: bold;\"}", + "description": "Generate an h3 heading with inline style to color the text blue and make it bold." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "backend-development.analyzeQuote", + "description": "Analyzes a given textual quote by performing sentiment analysis, detecting key themes, and assessing language complexity. The tool accepts a quote string and optional parameters to customize analysis depth and language. It returns a structured analysis including sentiment score, key topics, and readability metrics.", + "category": "backend-development", + "parameters": [ + { + "name": "quoteText", + "type": "string", + "description": "The textual quote to analyze for sentiment, themes, and complexity.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "ISO code of the language of the quote for accurate linguistic analysis (default is 'en').", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "detailedAnalysis", + "type": "boolean", + "description": "Whether to perform an in-depth analysis including multiple theme extraction and complexity metrics.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing sentimentScore (number), detectedThemes (array of strings), readabilityScore (number), and languageDetected (string)." + }, + "aiAgent": { + "useCase": "Use this tool when needing to understand the emotional tone, main topics, and language complexity of a textual quote to support content moderation, sentiment-driven decisions, or content summarization. It helps when processing user-generated content or analyzing literature excerpts.", + "limitations": "This tool is optimized for short quotes and may not perform well on very long or conversational inputs. It only supports a limited set of languages and does not capture sarcasm or nuanced irony effectively.", + "examples": [ + "Analyze sentiment and themes of 'The only limit to our realization of tomorrow is our doubts of today.'", + "Assess readability and sentiment of quotes in Spanish by setting language parameter to 'es'.", + "Perform detailed analysis on motivational quotes to extract more themes and complexity scores." + ] + }, + "tags": [ + "analysis", + "text", + "sentiment", + "themes", + "readability", + "quotes", + "language" + ], + "examples": [ + { + "inputJson": "{\"quoteText\":\"The greatest glory in living lies not in never falling, but in rising every time we fall.\",\"language\":\"en\",\"detailedAnalysis\":true}", + "description": "Analyze a motivational quote in English with detailed analysis enabled." + }, + { + "inputJson": "{\"quoteText\":\"La vida es un sueño y los sueños, sueños son.\",\"language\":\"es\",\"detailedAnalysis\":false}", + "description": "Analyze a Spanish quote with basic analysis." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Quote", + "context": null + } + }, + { + "name": "backend-development.renderSentence", + "description": "This tool accepts an input sentence template with placeholder variables and an object mapping variables to values. It processes the template by replacing the placeholders with provided values, rendering a complete, coherent sentence. The output is the fully rendered sentence as a string.", + "category": "backend-development", + "parameters": [ + { + "name": "template", + "type": "string", + "description": "The sentence template containing placeholders wrapped in double curly braces (e.g., 'Hello, {{name}}!').", + "required": true, + "defaultValue": "" + }, + { + "name": "variables", + "type": "object", + "description": "Key-value pairs where keys correspond to placeholder names in the template and values are the replacements.", + "required": true, + "defaultValue": "" + }, + { + "name": "escapeHTML", + "type": "boolean", + "description": "If true, escape HTML characters in variable values to prevent injection when rendering for web.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered sentence as a single string field 'sentence'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate sentences or messages based on templates with variable data, such as personalized user messages or server response strings. It is ideal when the input sentence contains placeholders that must be replaced with real-time values supplied as variables.", + "limitations": "The tool does not evaluate expressions or perform complex logic inside placeholders, supporting only direct substitution. It cannot parse or validate templates for syntax errors beyond missing variables.", + "examples": [ + "Render a greeting sentence with a user name: template='Hello, {{name}}!', variables={name: 'Alice'}.", + "Generate status messages based on user input, replacing placeholders like '{{status}}' with actual status values.", + "Render sentences safely for web responses by enabling HTML escaping to avoid XSS vulnerabilities." + ] + }, + "tags": [ + "template", + "rendering", + "string-substitution", + "dynamic-content", + "backend", + "message-generation", + "personalization" + ], + "examples": [ + { + "inputJson": "{\"template\":\"Hello, {{name}}! Today is {{day}}.\",\"variables\":{\"name\":\"John\",\"day\":\"Monday\"},\"escapeHTML\":false}", + "description": "Render a greeting sentence with name and day placeholders replaced." + }, + { + "inputJson": "{\"template\":\"Warning: {{message}}\",\"variables\":{\"message\":\"\"},\"escapeHTML\":true}", + "description": "Render a sentence with HTML escaping enabled to prevent injection." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "render", + "object": "Sentence", + "context": null + } + }, + { + "name": "backend-development.renderParagraph", + "description": "Renders a formatted HTML paragraph string from input text content with optional styling such as CSS classes, inline styles, and text alignment. Accepts raw text and options, processes formatting, and outputs a valid HTML paragraph element as a string.", + "category": "backend-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw text content to be enclosed and rendered as a paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "cssClasses", + "type": "array", + "description": "Optional list of CSS class names to add to the paragraph element for styling.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "inlineStyles", + "type": "object", + "description": "Optional object specifying CSS style properties and their values to apply inline.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "textAlign", + "type": "string", + "description": "Optional text alignment value ('left', 'right', 'center', 'justify') to set the paragraph's style.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "The resulting HTML string representing the properly formatted paragraph element." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert plain text content into a styled HTML paragraph element on the backend, for example when dynamically generating server-side HTML pages or email templates that include paragraphs with custom formatting. This helps ensure consistent paragraph HTML output from raw text inputs.", + "limitations": "This tool does not sanitize input text for security (e.g., it does not prevent XSS). It handles only one paragraph at a time and does not parse markdown or complex rich text.", + "examples": [ + "Render a paragraph with center alignment and two CSS classes.", + "Render a paragraph with inline styles for font color and size.", + "Render a plain paragraph without any styling." + ] + }, + "tags": [ + "backend", + "HTML", + "rendering", + "paragraph", + "formatting", + "web", + "server-side" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Hello, world! This is a sample paragraph.\",\"cssClasses\":[\"intro\",\"highlight\"],\"inlineStyles\":{\"color\":\"blue\",\"fontWeight\":\"bold\"},\"textAlign\":\"center\"}", + "description": "Render a paragraph with center alignment, blue bold text, and two CSS classes." + }, + { + "inputJson": "{\"text\":\"Another paragraph here.\",\"cssClasses\":[],\"inlineStyles\":{},\"textAlign\":\"left\"}", + "description": "Render a plain left-aligned paragraph without additional styling." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "render", + "object": "Paragraph", + "context": null + } + }, + { + "name": "backend-development.formatComponent", + "description": "Formats a given backend component code snippet to adhere to a specified coding style, indentation, and optional code conventions. It accepts raw component source code as input and outputs the formatted, clean, and consistent code string ready for integration or deployment.", + "category": "backend-development", + "parameters": [ + { + "name": "sourceCode", + "type": "string", + "description": "The raw source code of the backend component to be formatted. Expected to be a complete or partial component code block.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the source code (e.g., 'javascript', 'typescript', 'python'). Determines syntax rules applied during formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces to use for indentation (commonly 2 or 4). Controls the visual indentation level in formatted code.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs instead of spaces for indentation. If true, overrides indentationSize.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed line length before code line wrapping occurs. Helps maintain code readability standards.", + "required": false, + "defaultValue": "80" + }, + { + "name": "enforceSemicolons", + "type": "boolean", + "description": "For languages like JavaScript/TypeScript, whether to enforce semicolons at statement ends.", + "required": false, + "defaultValue": "true" + }, + { + "name": "newlineStyle", + "type": "string", + "description": "Line break style to use in output ('LF' for Unix-style, 'CRLF' for Windows-style).", + "required": false, + "defaultValue": "LF" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted component code as a string and metadata about formatting." + }, + "aiAgent": { + "useCase": "Use this tool to ensure backend component code snippets conform to consistent styling and formatting standards before integration, review, or deployment. Ideal when handling raw code fragments from various sources or user input that require normalization to project coding guidelines.", + "limitations": "This tool formats code but does not perform syntax error correction, semantic analysis, or code refactoring. It assumes the provided code is syntactically valid for the specified language.", + "examples": [ + "Format a raw JavaScript backend component with 2-space indentation and semicolons enforced.", + "Format a Python backend module with 4 spaces indentation and LF newlines.", + "Format a TypeScript component using tabs for indentation and max line length of 100." + ] + }, + "tags": [ + "code-formatting", + "backend", + "component", + "javascript", + "typescript", + "python", + "style", + "linting" + ], + "examples": [ + { + "inputJson": "{\"sourceCode\":\"function add(a,b){return a+b}\",\"language\":\"javascript\",\"indentationSize\":2,\"useTabs\":false,\"maxLineLength\":80,\"enforceSemicolons\":true,\"newlineStyle\":\"LF\"}", + "description": "Formats a simple JavaScript function to use 2 spaces indentation and enforces semicolons." + }, + { + "inputJson": "{\"sourceCode\":\"def add(a,b):\\n return a+b\",\"language\":\"python\",\"indentationSize\":4,\"useTabs\":false,\"maxLineLength\":80,\"enforceSemicolons\":false,\"newlineStyle\":\"LF\"}", + "description": "Formats a Python function ensuring 4 space indentation and LF line endings." + }, + { + "inputJson": "{\"sourceCode\":\"export const add=(a,b)=>a+b\",\"language\":\"typescript\",\"indentationSize\":0,\"useTabs\":true,\"maxLineLength\":100,\"enforceSemicolons\":true,\"newlineStyle\":\"CRLF\"}", + "description": "Formats a TypeScript arrow function component using tabs for indentation, max line length 100, and CRLF newlines." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Component", + "context": null + } + }, + { + "name": "backend-development.formatTable", + "description": "Formats raw tabular data provided as an array of objects or arrays into a well-structured table string with customizable options such as column alignment, padding, and styles. Accepts input data and returns a formatted table string suitable for console display, logs, or text-based reports.", + "category": "backend-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "The raw table data to format, as an array of objects or arrays representing rows. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "columnHeaders", + "type": "array", + "description": "Optional array of strings specifying column headers. If omitted and data is array of objects, keys from the first object are used.", + "required": false, + "defaultValue": "" + }, + { + "name": "alignments", + "type": "array", + "description": "Array specifying alignment per column: 'left', 'right', or 'center'. Defaults to left alignment.", + "required": false, + "defaultValue": "left" + }, + { + "name": "padding", + "type": "number", + "description": "Number of spaces to pad on each side of a cell. Defaults to 1.", + "required": false, + "defaultValue": "1" + }, + { + "name": "borderStyle", + "type": "string", + "description": "Style of the table borders, e.g., 'ascii', 'unicode', or 'none'. Defaults to 'ascii'.", + "required": false, + "defaultValue": "ascii" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to include the column header row in the output. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "string", + "description": "A string representing the formatted table with borders, aligned columns, and optional header row, ready for display or output." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to convert raw table data structures into a nicely formatted, human-readable table string in backend applications, logs, reports, or console outputs. It is ideal when data comes as JSON-like arrays or objects and must be displayed cleanly with alignment and styling options.", + "limitations": "This tool does not generate tables in graphical or HTML formats; it is limited to plain-text table formatting. It does not support automatic data type formatting beyond string conversion.", + "examples": [ + "Format a JSON array of objects with default settings.", + "Format a table with custom column alignments and no borders.", + "Format data without headers and with increased padding." + ] + }, + "tags": [ + "backend", + "formatting", + "table", + "logging", + "console", + "text-output" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"Name\":\"Alice\",\"Age\":30,\"City\":\"New York\"},{\"Name\":\"Bob\",\"Age\":25,\"City\":\"Los Angeles\"}],\"includeHeader\":true}", + "description": "Format a simple array of objects with headers in default ascii table style." + }, + { + "inputJson": "{\"data\":[[\"Alice\",30,\"New York\"],[\"Bob\",25,\"Los Angeles\"]],\"columnHeaders\":[\"Name\",\"Age\",\"City\"],\"alignments\":[\"left\",\"right\",\"center\"],\"borderStyle\":\"unicode\"}", + "description": "Format array of arrays with custom column headers, alignment and unicode borders." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Table", + "context": null + } + }, + { + "name": "backend-development.draftSummary", + "description": "Generates a concise summary from provided raw textual documents such as logs, API specifications, or technical notes. It processes the input text to extract key points and outputs a structured summary useful for quick understanding or documentation purposes.", + "category": "backend-development", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "Raw text content of the document to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate desired length of the summary in sentences.", + "required": false, + "defaultValue": "5" + }, + { + "name": "language", + "type": "string", + "description": "Language of the input document text. Defaults to 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyTerms", + "type": "boolean", + "description": "Whether to extract and include key terms and phrases in the summary output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary string, optionally a list of key terms if requested, and metadata such as originalLength and summaryLength." + }, + "aiAgent": { + "useCase": "This tool is ideal for backend development contexts where lengthy technical documents, API specs, logs, or design notes need to be quickly summarized for review or documentation. It helps agents reduce large texts into manageable summaries to accelerate understanding and reporting.", + "limitations": "The tool summarizes text based on the input and may not always capture nuanced context or highly specialized content accurately. It does not replace expert technical review and is language-dependent with varying effectiveness by language.", + "examples": [ + "Please create a 3-sentence summary of this API documentation.", + "Summarize the error log report focusing on key issues.", + "Generate a brief technical summary highlighting endpoints described in this backend design note." + ] + }, + "tags": [ + "summary", + "backend", + "documentation", + "text-processing", + "API", + "logs" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"This backend API offers endpoints for user authentication, data retrieval, and logging. It enforces OAuth2 security, uses JSON for data interchange, and handles rate limiting with exponential backoff. The service is scalable, fault tolerant, and integrates with third-party analytics.\",\"summaryLength\":4,\"language\":\"en\",\"includeKeyTerms\":true}", + "description": "Summarize an API specification document emphasizing key features and terms." + }, + { + "inputJson": "{\"documentText\":\"Error report from service: timeout on database connection at 14:35 UTC. Several requests returned 500 errors between 15:00 and 15:10 due to resource exhaustion. Recovery procedures triggered automatically and system back to normal.\",\"summaryLength\":3}", + "description": "Summarize backend error logs to highlight incidents and resolutions." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Summary", + "context": null + } + }, + { + "name": "backend-development.formatArticle", + "description": "Formats a raw article text into a structured HTML or Markdown representation. Accepts article content with optional metadata like title, author, and date. Processes headings, paragraphs, lists, and basic formatting marks. Outputs formatted article content in the chosen output format for rendering or publishing.", + "category": "backend-development", + "parameters": [ + { + "name": "articleContent", + "type": "string", + "description": "The raw text content of the article to format, including paragraphs and inline formatting marks.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title of the article to include as a header.", + "required": false, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Optional author name to display with the article metadata.", + "required": false, + "defaultValue": "" + }, + { + "name": "publishDate", + "type": "string", + "description": "Optional publish date in ISO 8601 format to include in the article metadata.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the formatted article. Supported values: 'html', 'markdown'.", + "required": true, + "defaultValue": "html" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include metadata (title, author, date) in the output. Defaults to true if metadata fields are provided.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted article string under 'formattedContent'. Contains the fully formatted article in the specified format." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw article text with optional metadata and need it converted into a clean, well-structured HTML or Markdown format for web display, email, or publishing workflows. Ideal for content management systems or automated publishing pipelines.", + "limitations": "Does not perform advanced content analysis like SEO optimization, image insertion, or multimedia embedding. Only supports basic formatting: headers, paragraphs, bold, italics, lists, and metadata insertion. Complex layouts or interactive elements are not supported.", + "examples": [ + "Format a plain article text to HTML with title and author metadata included.", + "Convert an article with markdown-like inline markers to HTML for website display.", + "Generate markdown-formatted article from raw content without metadata for Git-based publishing." + ] + }, + "tags": [ + "backend-development", + "formatting", + "article", + "content-management", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"articleContent\":\"Introduction\\nThis is the first paragraph.\\n* Item 1\\n* Item 2\\nConclusion\\nThis is the end.\",\"title\":\"Sample Article\",\"author\":\"Jane Doe\",\"publishDate\":\"2024-04-20\",\"outputFormat\":\"html\",\"includeMetadata\":true}", + "description": "Format an article with title, author, and date metadata into HTML including headings and lists." + }, + { + "inputJson": "{\"articleContent\":\"# Main Heading\\nSome *emphasized* and **bold** text here.\",\"outputFormat\":\"markdown\",\"includeMetadata\":false}", + "description": "Convert raw content with inline markdown markers into markdown format without metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Article", + "context": null + } + }, + { + "name": "backend-development.draftSentence", + "description": "Generates a clear, concise English sentence based on a provided technical context and purpose suited for backend development documentation, comments, or communication. Accepts a context description and a goal or intent, returns a well-formed sentence that effectively conveys the specified information.", + "category": "backend-development", + "parameters": [ + { + "name": "context", + "type": "string", + "description": "A brief technical background or scenario related to backend development that the sentence should refer to.", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "The specific intent or objective of the sentence, such as explaining, warning, or summarizing technical details.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the sentence: e.g., formal, informal, instructional, or neutral.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeCodeReference", + "type": "boolean", + "description": "Whether to include a generic reference to code elements like functions or endpoints in the sentence.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted sentence as a string under the key 'sentence'. This sentence is syntactically correct, contextually relevant, and matches the requested purpose and tone." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate clear and context-aware sentences for backend development environments, such as generating documentation sentences, commit message explanations, inline comment drafts, or descriptive logs. It helps automate the creation of natural language explanations based on technical input.", + "limitations": "The tool cannot generate lengthy paragraphs or detailed multi-sentence explanations; its output is limited to a single, coherent sentence. It also does not generate code itself or replace in-depth technical documentation.", + "examples": [ + "Generate a warning sentence about potential null reference exceptions in a function.", + "Create an instructional sentence describing API endpoint behavior in a formal tone.", + "Draft a neutral summary sentence about a recent bug fix affecting database queries." + ] + }, + "tags": [ + "sentence-generation", + "backend-development", + "documentation", + "comment-generation", + "natural-language" + ], + "examples": [ + { + "inputJson": "{\"context\":\"handling user authentication in a REST API\",\"purpose\":\"instructional\",\"tone\":\"formal\",\"includeCodeReference\":true}", + "description": "Draft a formal instructional sentence about user authentication in a REST API including a code reference." + }, + { + "inputJson": "{\"context\":\"database connection timeout errors\",\"purpose\":\"warning\",\"tone\":\"neutral\",\"includeCodeReference\":false}", + "description": "Draft a neutral warning sentence about database connection timeouts without referencing code elements." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Sentence", + "context": null + } + }, + { + "name": "backend-development.draftParagraph", + "description": "This tool generates a coherent, content-specific paragraph for backend development documentation or code comments. It accepts parameters like the main topic, desired tone, length, and technical complexity, then outputs a well-structured paragraph suitable for inclusion in technical docs or API descriptions.", + "category": "backend-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the paragraph to draft, such as a specific backend concept or function.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the paragraph text (e.g., formal, casual, explanatory) to match the documentation style.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the paragraph in sentences.", + "required": false, + "defaultValue": "4" + }, + { + "name": "complexity", + "type": "string", + "description": "Technical complexity level for the language used: beginner, intermediate, advanced.", + "required": false, + "defaultValue": "intermediate" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "If true, the paragraph will include example snippets or analogies relevant to the topic.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted paragraph string under the 'paragraph' key, representing the generated content." + }, + "aiAgent": { + "useCase": "Use this tool to generate clear, concise explanatory text for backend development concepts when creating technical documentation, API references, or inline code comments, especially when needing consistent tone and appropriate technical detail.", + "limitations": "The tool does not generate complete documents or replace expert-written documentation. It may produce generic paragraphs lacking in-depth context or examples if parameters are not specified precisely.", + "examples": [ + "Draft a formal paragraph about RESTful API design for intermediate developers.", + "Create a casual explanation paragraph about database indexing including examples.", + "Generate a beginner-friendly paragraph explaining middleware functions with moderate length." + ] + }, + "tags": [ + "backend", + "documentation", + "paragraph-generation", + "technical-writing", + "content-creation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"REST API endpoint design\",\"tone\":\"formal\",\"length\":5,\"complexity\":\"intermediate\",\"includeExamples\":true}", + "description": "Generate a formal, moderately technical paragraph about REST API endpoint design including examples." + }, + { + "inputJson": "{\"topic\":\"database connection pooling\",\"tone\":\"explanatory\",\"length\":4,\"complexity\":\"beginner\",\"includeExamples\":false}", + "description": "Create a beginner-level explanatory paragraph about database connection pooling without examples." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Paragraph", + "context": null + } + }, + { + "name": "backend-development.composeArticle", + "description": "This tool accepts structured input including a title, author details, sections with headings and content, and optional metadata. It composes a well-formatted article as a serialized HTML string or Markdown document, applying basic formatting rules. The output can be used directly in web content or documentation systems.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the article to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "object", + "description": "An object containing author information such as name and optionally email and bio.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "sections", + "type": "array", + "description": "An array of article sections, each with a heading and content text. Sections are composed sequentially.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tags", + "type": "array", + "description": "Array of tags or keywords related to the article for metadata purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output article, e.g., 'html' or 'markdown'. Defaults to 'html'.", + "required": false, + "defaultValue": "html" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include author and tags metadata in the output. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed article as a string under 'articleContent', and its format under 'format'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a structured article from given components such as title, author info, and multiple sections. Ideal for backend systems that programmatically produce blog posts, technical documentation, or news articles in consistent formats.", + "limitations": "This tool composes basic HTML or Markdown output; it does not support advanced styling, multimedia embedding, or automated fact-checking. It requires well-structured input and does not perform natural language generation of content itself.", + "examples": [ + "Compose a technical documentation article with multiple sections and author metadata.", + "Generate a blog post in Markdown format with title and tags but no author information.", + "Create a simple HTML article with just a title and one section, excluding metadata." + ] + }, + "tags": [ + "backend-development", + "article", + "compose", + "content-generation", + "html", + "markdown", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Introduction to Serverless Architecture\",\"author\":{\"name\":\"Jane Smith\",\"email\":\"jane@example.com\"},\"sections\":[{\"heading\":\"What is Serverless?\",\"content\":\"Serverless architecture allows developers to build and run applications without managing servers.\"},{\"heading\":\"Benefits\",\"content\":\"It offers scalability, cost efficiency, and reduced operational complexity.\"}],\"tags\":[\"serverless\",\"cloud\",\"architecture\"],\"outputFormat\":\"html\",\"includeMetadata\":true}", + "description": "Compose a multi-section technical article in HTML with author and tags included." + }, + { + "inputJson": "{\"title\":\"Top 5 JavaScript Frameworks\",\"sections\":[{\"heading\":\"React\",\"content\":\"A popular library for building user interfaces.\"},{\"heading\":\"Vue.js\",\"content\":\"An approachable, versatile framework.\"}],\"outputFormat\":\"markdown\",\"includeMetadata\":false}", + "description": "Compose a brief article in Markdown format without author or tags metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Article", + "context": null + } + }, + { + "name": "backend-development.composeComment", + "description": "This tool generates a well-structured, context-appropriate comment string for server-side application code. It accepts inputs such as the programming language, the functionality description, the comment style (e.g., single-line, multi-line), and optional tags or author attribution. It processes these to produce a formatted comment block suitable for insertion in the codebase.", + "category": "backend-development", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language of the code to comment (e.g., 'JavaScript', 'Python'). This influences comment syntax.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionalityDescription", + "type": "string", + "description": "A clear text describing what the code or function does, to be used as the comment content.", + "required": true, + "defaultValue": "" + }, + { + "name": "commentStyle", + "type": "string", + "description": "The style of comment to generate, such as 'single-line', 'multi-line', or 'docstring' where applicable.", + "required": false, + "defaultValue": "single-line" + }, + { + "name": "includeAuthor", + "type": "boolean", + "description": "Whether to include an author attribution line in the comment block.", + "required": false, + "defaultValue": "false" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the author for attribution if includeAuthor is true.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeDate", + "type": "boolean", + "description": "Whether to include the current date in the comment block.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted comment text ready for code insertion, preserving correct syntax for the specified language and style." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate clear, idiomatic comments for backend code segments during code generation, documentation, or code review automation. It helps ensure comments follow language-specific conventions and project style. Avoids manual formatting or potential syntax errors in comments.", + "limitations": "This tool doesn't validate the underlying code logic or correctness of the functionality description. It also does not integrate with external documentation systems directly or handle internationalization of comments.", + "examples": [ + "Generate a multi-line JavaScript comment describing a function that processes user authentication, including author and date.", + "Create a Python docstring for a method that fetches data from a database.", + "Produce a single-line comment in Go summarizing error handling logic without author attribution." + ] + }, + "tags": [ + "backend", + "comment-generation", + "code-documentation", + "server-side", + "programming", + "automation" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"JavaScript\",\"functionalityDescription\":\"Handles user login by validating credentials against the database.\",\"commentStyle\":\"multi-line\",\"includeAuthor\":true,\"authorName\":\"Jane Doe\",\"includeDate\":true}", + "description": "Generate a multi-line JavaScript comment describing user login function with author and date." + }, + { + "inputJson": "{\"programmingLanguage\":\"Python\",\"functionalityDescription\":\"Retrieves all active users from the database.\",\"commentStyle\":\"docstring\",\"includeAuthor\":false,\"authorName\":\"\",\"includeDate\":false}", + "description": "Create a Python docstring for fetching active users without author and date." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Comment", + "context": null + } + }, + { + "name": "backend-development.generateReadme", + "description": "Generates a comprehensive README.md file for a backend development project based on provided project metadata, features, setup instructions, and usage examples. Accepts structured inputs describing the project and outputs a formatted Markdown string suitable as a README document.", + "category": "backend-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the backend project for the README title and references.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectDescription", + "type": "string", + "description": "A brief description of the project's purpose and functionality.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions to install and set up the project environment.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "array", + "description": "An array of string examples demonstrating how to run or interact with the project or its API.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "features", + "type": "array", + "description": "List of key features or capabilities provided by the backend project.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "apiEndpoints", + "type": "array", + "description": "An array of objects each describing an API endpoint with path, method, and brief description.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "contributingGuidelines", + "type": "string", + "description": "Guidelines for developers interested in contributing to the project.", + "required": false, + "defaultValue": "" + }, + { + "name": "license", + "type": "string", + "description": "The license type under which the project is released (e.g., MIT, Apache 2.0).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated README content as a Markdown-formatted string, keyed by \"readmeContent\"." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to quickly create or update a README file for a backend project based on structured project info. It helps automate documentation generation without manually formatting Markdown, ensuring consistent style and completeness.", + "limitations": "The tool generates README content based on input text and arrays but cannot validate project correctness or dynamically analyze project code or dependencies. Complex diagrams or screenshots are not included.", + "examples": [ + "Generate README for a new REST API with installation and usage.", + "Produce a README that lists API endpoints and contributing guidelines.", + "Create a simple README with project description and license info only." + ] + }, + "tags": [ + "documentation", + "backend", + "readme", + "markdown", + "automation", + "project-setup" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"UserAPI\",\"projectDescription\":\"A RESTful API for user management.\",\"installationInstructions\":\"Run npm install and then npm start.\",\"usageExamples\":[\"GET /users fetches all users\",\"POST /users creates a new user\"],\"features\":[\"User CRUD operations\",\"JWT authentication\",\"Role-based access control\"],\"apiEndpoints\":[{\"path\":\"/users\",\"method\":\"GET\",\"description\":\"Retrieve list of users\"},{\"path\":\"/users\",\"method\":\"POST\",\"description\":\"Create a new user\"}],\"contributingGuidelines\":\"Please fork the repo and submit a pull request.\",\"license\":\"MIT\"}", + "description": "Generate a full README for a user management API project with installation, features, API endpoints, usage examples, contributing, and license." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Readme", + "context": null + } + }, + { + "name": "backend-development.generateGraph", + "description": "Generates customizable data graphs (e.g., bar, line, pie charts) based on input datasets and configuration options, producing graph images or SVG markup ready for integration in backend-generated reports or APIs.", + "category": "backend-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "An array of data objects representing the dataset to visualize, each object typically containing relevant keys like labels and values.", + "required": true, + "defaultValue": "" + }, + { + "name": "graphType", + "type": "string", + "description": "The type of graph to generate, such as 'bar', 'line', 'pie', or 'scatter'.", + "required": true, + "defaultValue": "" + }, + { + "name": "width", + "type": "number", + "description": "The width of the resulting graph image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "The height of the resulting graph image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "title", + "type": "string", + "description": "An optional title to display on the graph.", + "required": false, + "defaultValue": "" + }, + { + "name": "labels", + "type": "array", + "description": "Optional array of label strings for the data points or categories.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format: 'png', 'jpeg', or 'svg'.", + "required": false, + "defaultValue": "png" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated graph as a base64-encoded string along with metadata like format and dimensions." + }, + "aiAgent": { + "useCase": "Use this tool when backend services need to dynamically create visual data representations such as charts or graphs for reports, dashboards, or API responses without relying on client-side rendering. It enables generating images or SVG markup for direct inclusion or further processing.", + "limitations": "Does not support highly complex or interactive graphs such as 3D charts or real-time animations. Limited to standard 2D chart types specified.", + "examples": [ + "Generate a bar chart from sales data for a monthly report.", + "Create an SVG pie chart showing user demographic percentages.", + "Produce a line graph image illustrating stock prices over time." + ] + }, + "tags": [ + "backend", + "graph-generation", + "data-visualization", + "chart", + "image-generation" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"label\":\"Jan\",\"value\":30},{\"label\":\"Feb\",\"value\":45},{\"label\":\"Mar\",\"value\":20}],\"graphType\":\"bar\",\"width\":600,\"height\":400,\"title\":\"Quarterly Sales\",\"labels\":[\"Jan\",\"Feb\",\"Mar\"],\"outputFormat\":\"png\"}", + "description": "Generate a bar chart PNG image depicting sales data for three months with specified dimensions and a title." + }, + { + "inputJson": "{\"data\":[{\"category\":\"A\",\"value\":40},{\"category\":\"B\",\"value\":60}],\"graphType\":\"pie\",\"width\":500,\"height\":500,\"title\":\"Category Distribution\",\"outputFormat\":\"svg\"}", + "description": "Create an SVG pie chart to visualize category distribution percentages with a title and square dimensions." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Graph", + "context": null + } + }, + { + "name": "backend-development.generateMarkdown", + "description": "Generates well-structured Markdown documents based on provided content sections and formatting options. Accepts inputs such as title, sections with headings and paragraphs, optional lists, and code snippets. Processes these inputs to produce comprehensive Markdown-formatted text suitable for documentation, READMEs, or reports.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the Markdown document, rendered as a top-level heading.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects, each containing a heading and content arrays of paragraphs, lists, or code blocks.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Flag indicating whether to automatically generate a table of contents based on section headings.", + "required": false, + "defaultValue": "false" + }, + { + "name": "codeLanguage", + "type": "string", + "description": "Programming language to specify in fenced code blocks for syntax highlighting, e.g., 'js', 'python'.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated Markdown document as a string property 'markdown'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate formatted Markdown documentation or reports from structured content, such as API docs, README files, or developer guides, preserving sections, lists, and code examples in a clean format.", + "limitations": "Cannot interpret or convert arbitrary unstructured text into Markdown intelligently; requires content in structured format with explicit headings and sections; does not support complex Markdown extensions like embedded HTML or interactive elements.", + "examples": [ + "Generate a README Markdown file with multiple sections including installation, usage, and contributing guidelines.", + "Create Markdown documentation with code samples in specific programming language highlighting.", + "Produce a report in Markdown format with table of contents and nested lists." + ] + }, + "tags": [ + "markdown", + "documentation", + "text-generation", + "backend-development", + "formatting", + "code-samples" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Awesome Project README\",\"sections\":[{\"heading\":\"Introduction\",\"content\":[{\"type\":\"paragraph\",\"text\":\"This project provides an awesome feature\"}]},{\"heading\":\"Installation\",\"content\":[{\"type\":\"paragraph\",\"text\":\"Follow these steps to install.\"},{\"type\":\"list\",\"items\":[\"Download the package\",\"Run the installer\",\"Configure settings\"]}]},{\"heading\":\"Usage\",\"content\":[{\"type\":\"paragraph\",\"text\":\"Here is how to use the project.\"},{\"type\":\"code\",\"code\":\"npm start\",\"language\":\"\"}]}],\"includeTableOfContents\":true,\"codeLanguage\":\"bash\"}", + "description": "Generate a README with introduction, installation steps as list, usage with a bash code snippet, and an auto-generated table of contents." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Markdown", + "context": null + } + }, + { + "name": "backend-development.createChannel", + "description": "Creates a new communication channel on the backend system with specified attributes such as name, type (e.g., public, private), description, and access permissions. Processes input parameters to configure the channel and returns the channel's metadata including unique identifier and creation timestamp.", + "category": "backend-development", + "parameters": [ + { + "name": "channelName", + "type": "string", + "description": "The unique name for the communication channel to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "channelType", + "type": "string", + "description": "Type of the channel indicating its accessibility, e.g., 'public' or 'private'.", + "required": true, + "defaultValue": "public" + }, + { + "name": "description", + "type": "string", + "description": "A brief description explaining the purpose or usage of the channel.", + "required": false, + "defaultValue": "" + }, + { + "name": "permissions", + "type": "object", + "description": "An object defining access permissions, specifying roles or user groups that can read, write or manage the channel.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional metadata as key-value pairs to tag or categorize the channel.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the channel ID, name, type, description, assigned permissions, metadata, and the ISO 8601 timestamp of creation." + }, + "aiAgent": { + "useCase": "Use this tool when backend services need to programmatically establish distinct communication pathways, such as chat rooms, notification feeds, or collaboration channels, configuring their access and properties.", + "limitations": "This tool does not handle client-side subscription logic or real-time message delivery; it only creates channel definitions on the backend.", + "examples": [ + "Create a private channel named 'engineering-discussions' with read access for the engineering team.", + "Create a public channel 'general-announcements' with no special permissions.", + "Create a channel with custom metadata tags for audit purposes." + ] + }, + "tags": [ + "backend", + "communication", + "channel", + "create", + "permissions", + "api" + ], + "examples": [ + { + "inputJson": "{\"channelName\":\"engineering-discussions\",\"channelType\":\"private\",\"description\":\"Channel for engineering team discussions\",\"permissions\":{\"read\":[\"engineering-team\"],\"write\":[\"engineering-team\"]}}", + "description": "Create a private channel 'engineering-discussions' with access restricted to the engineering team." + }, + { + "inputJson": "{\"channelName\":\"general-announcements\",\"channelType\":\"public\",\"description\":\"Company-wide announcement channel\"}", + "description": "Create a public channel for company-wide announcements with default permissions." + }, + { + "inputJson": "{\"channelName\":\"audit-log\",\"channelType\":\"private\",\"description\":\"Audit log channel\",\"permissions\":{\"read\":[\"audit-team\"]},\"metadata\":{\"compliance\":\"true\",\"region\":\"us-east\"}}", + "description": "Create a private audit log channel with metadata tags for compliance and region." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Channel", + "context": null + } + }, + { + "name": "backend-development.createDiagram", + "description": "Creates a backend architecture diagram from structured input describing services, databases, APIs, and connections. Processes JSON or object input defining components and relationships, then outputs a visual diagram representation in SVG or PNG format to help visualize server-side system structure.", + "category": "backend-development", + "parameters": [ + { + "name": "components", + "type": "array", + "description": "Array of component objects to include in the diagram; each defines a service, database, or API with a unique id, type, and label.", + "required": true, + "defaultValue": "" + }, + { + "name": "connections", + "type": "array", + "description": "Array of connection objects specifying relationships between components by referencing their ids and describing the connection type and direction.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output image format for the diagram, such as 'svg' or 'png'.", + "required": false, + "defaultValue": "svg" + }, + { + "name": "includeLabels", + "type": "boolean", + "description": "Whether to include labels on components and connections in the diagram.", + "required": false, + "defaultValue": "true" + }, + { + "name": "theme", + "type": "string", + "description": "Visual theme for the diagram, e.g., 'light' or 'dark'.", + "required": false, + "defaultValue": "light" + }, + { + "name": "layoutAlgorithm", + "type": "string", + "description": "Algorithm to use for layout of components, e.g., 'hierarchical' or 'force-directed'.", + "required": false, + "defaultValue": "hierarchical" + } + ], + "returns": { + "type": "object", + "description": "Object containing an imageData field with base64-encoded image string and a mimeType indicating the image format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate visual diagrams of backend system architectures automatically from structured descriptions of components and their connections, aiding developers and architects in understanding, documenting, and communicating server-side designs.", + "limitations": "This tool generates static diagrams only and does not support interactive editing or real-time collaboration. It requires well-structured input data with all necessary component and connection details specified.", + "examples": [ + "Create a diagram showing a microservices architecture with services and databases.", + "Generate a visual map of API endpoints connected to backend services and data stores.", + "Produce a hierarchical diagram of the backend components for documentation purposes." + ] + }, + "tags": [ + "backend", + "diagram", + "visualization", + "architecture", + "API", + "services", + "databases" + ], + "examples": [ + { + "inputJson": "{\"components\":[{\"id\":\"svc1\",\"type\":\"service\",\"label\":\"User Service\"},{\"id\":\"db1\",\"type\":\"database\",\"label\":\"User DB\"},{\"id\":\"api1\",\"type\":\"api\",\"label\":\"Auth API\"}],\"connections\":[{\"from\":\"api1\",\"to\":\"svc1\",\"type\":\"calls\",\"direction\":\"uni\"},{\"from\":\"svc1\",\"to\":\"db1\",\"type\":\"reads/writes\",\"direction\":\"uni\"}],\"outputFormat\":\"svg\",\"includeLabels\":true,\"theme\":\"light\",\"layoutAlgorithm\":\"hierarchical\"}", + "description": "Input describing a simple backend with an Auth API calling a User Service which reads/writes to a User Database, outputting an SVG diagram with labels." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Diagram", + "context": null + } + }, + { + "name": "backend-development.createReadme", + "description": "Generates a comprehensive README.md file content for a backend project by accepting project metadata, lists of features, setup instructions, usage examples, and other relevant details. Processes these inputs to produce a well-structured markdown document suitable for project documentation.", + "category": "backend-development", + "parameters": [ + { + "name": "projectName", + "type": "string", + "description": "The name of the backend project to document.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A brief description summarizing the purpose and functionality of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "installationInstructions", + "type": "string", + "description": "Step-by-step instructions for installing or setting up the project environment.", + "required": false, + "defaultValue": "" + }, + { + "name": "usageExamples", + "type": "string", + "description": "Code snippets or command examples demonstrating how to use the project or API.", + "required": false, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "A list of key features or functionalities included in the project.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "contributingGuidelines", + "type": "string", + "description": "Guidelines for contributing to the project such as coding standards or pull request process.", + "required": false, + "defaultValue": "" + }, + { + "name": "license", + "type": "string", + "description": "Type of license governing the project usage (e.g., MIT, Apache 2.0).", + "required": false, + "defaultValue": "" + }, + { + "name": "contactInfo", + "type": "string", + "description": "Contact information for maintainers or support, such as email or social links.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated README content as a markdown-formatted string under the 'readmeContent' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automatically generate or update a backend project's README documentation based on structured input data. It is ideal for creating standardized project documentation to improve clarity and onboarding for developers.", + "limitations": "This tool generates README content based on provided inputs but cannot fetch project-specific data automatically. It does not handle complex formatting beyond standard markdown and cannot validate the accuracy of technical instructions.", + "examples": [ + "Generate a README for a Node.js REST API including features and installation steps.", + "Create a comprehensive README providing usage examples and contribution guidelines for a backend microservice.", + "Produce a simple README with project description and contact info for support queries." + ] + }, + "tags": [ + "backend", + "documentation", + "readme", + "markdown", + "project-setup", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"projectName\":\"AwesomeBackendAPI\",\"description\":\"A RESTful API to manage user data and authentication.\",\"installationInstructions\":\"1. Clone the repo\\n2. Run npm install\\n3. Start with npm start\",\"usageExamples\":\"curl -X GET https://api.example.com/users\",\"features\":[\"User authentication\",\"Data CRUD operations\",\"JWT based security\"],\"contributingGuidelines\":\"Please fork the repo, create a feature branch, and submit pull requests.\",\"license\":\"MIT\",\"contactInfo\":\"devteam@example.com\"}", + "description": "Generates a full README file for a typical backend API project including setup, usage, and contact info." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Readme", + "context": null + } + }, + { + "name": "backend-development.createMarkdown", + "description": "Generates a Markdown-formatted document from structured input including title, headings, paragraphs, lists, and code blocks. Accepts an object defining content sections and converts it into a well-structured Markdown string ready for documentation, README files, or reports.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the Markdown document, rendered as an H1 header.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of section objects describing subsections, paragraphs, lists, and code blocks in order.", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object with a single Markdown string representing the entire formatted document." + }, + "aiAgent": { + "useCase": "Use this tool when you have structured content data such as titles, paragraphs, lists, and code snippets and want to produce a clean, standards-compliant Markdown document for documentation, README files, or notes. It simplifies content generation avoiding manual Markdown formatting.", + "limitations": "Does not support advanced Markdown extensions like tables, footnotes, or embedded HTML. Does not perform content validation or syntax highlighting beyond raw code fencing.", + "examples": [ + "Create a README file with project title, description paragraph, and usage code snippet.", + "Generate a Markdown report with multiple sections including bullet lists and code blocks.", + "Produce documentation from a content object with nested subsections and paragraphs." + ] + }, + "tags": [ + "backend-development", + "markdown", + "document-generation", + "documentation", + "code-blocks", + "lists", + "text-formatting" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Project README\",\"sections\":[{\"heading\":\"Introduction\",\"paragraphs\":[\"This project demonstrates backend API design.\"],\"lists\":[{\"type\":\"unordered\",\"items\":[\"Uses Node.js\",\"Implements REST API\"]}],\"codeBlocks\":[{\"language\":\"javascript\",\"code\":\"console.log('Hello World');\"}]}]}", + "description": "Generate a README file with a title, introduction section, bullet list, and JavaScript code block." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Markdown", + "context": null + } + }, + { + "name": "backend-development.createDependency", + "description": "This tool accepts specifications for a project dependency including package name, version, and type of dependency. It generates a structured dependency object suitable for inclusion in package manifest files like package.json or requirements.txt, facilitating automated management and inclusion of dependencies in backend projects.", + "category": "backend-development", + "parameters": [ + { + "name": "packageName", + "type": "string", + "description": "Name of the dependency package to be added, e.g., 'express'", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "Version or version range of the package, e.g., '^4.17.1'", + "required": true, + "defaultValue": "" + }, + { + "name": "dependencyType", + "type": "string", + "description": "Type of dependency such as 'dependencies', 'devDependencies', 'peerDependencies'", + "required": false, + "defaultValue": "dependencies" + }, + { + "name": "registry", + "type": "string", + "description": "Optional package registry URL or source to pull the dependency from", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured object representing the dependency entry, including package name, version, and dependency type, ready for integration into project manifest files." + }, + "aiAgent": { + "useCase": "Use this tool when automating backend project setup or dependency management, to generate precise dependency definitions that can be inserted into configuration files. It helps maintain consistent dependency versions and categorization (runtime vs dev).", + "limitations": "This tool does not resolve or install dependencies, nor validate that versions are valid or available in the registry. It only formats the dependency specification.", + "examples": [ + "Add express version ^4.17.1 as a runtime dependency", + "Add jest version ^29.0.0 as a devDependency", + "Create a dependency entry for a custom package from a private registry" + ] + }, + "tags": [ + "backend", + "dependency", + "package-management", + "automation" + ], + "examples": [ + { + "inputJson": "{\"packageName\":\"express\",\"version\":\"^4.17.1\",\"dependencyType\":\"dependencies\"}", + "description": "Add express as a runtime dependency with version ^4.17.1" + }, + { + "inputJson": "{\"packageName\":\"jest\",\"version\":\"^29.0.0\",\"dependencyType\":\"devDependencies\"}", + "description": "Add jest testing framework as a dev dependency" + }, + { + "inputJson": "{\"packageName\":\"my-private-lib\",\"version\":\"1.2.3\",\"dependencyType\":\"dependencies\",\"registry\":\"https://my-registry.example.com\"}", + "description": "Add a private package from custom registry as runtime dependency" + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Dependency", + "context": null + } + }, + { + "name": "backend-development.createTemplate", + "description": "Creates a server-side code template for various backend components such as API endpoints, database models, or middleware. Accepts template type, language, and optional configuration to generate reusable, boilerplate code files that accelerate backend development.", + "category": "backend-development", + "parameters": [ + { + "name": "templateType", + "type": "string", + "description": "Type of backend template to create (e.g., 'API Endpoint', 'Model', 'Middleware')", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language for the template code (e.g., 'NodeJS', 'Python', 'Java')", + "required": true, + "defaultValue": "" + }, + { + "name": "includeTests", + "type": "boolean", + "description": "Whether to generate accompanying test files for the template", + "required": false, + "defaultValue": "false" + }, + { + "name": "useDatabase", + "type": "boolean", + "description": "Include database integration code if applicable to the template type", + "required": false, + "defaultValue": "false" + }, + { + "name": "configOptions", + "type": "object", + "description": "Additional optional settings specific to the template type (e.g., HTTP methods for API)", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated template file content keyed by filename, enabling immediate use or customization." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to bootstrap backend components quickly by generating standardized, ready-to-use code templates for API endpoints, database models, or middleware in a specified programming language and configuration. It helps accelerate backend project setup and reduce manual boilerplate coding.", + "limitations": "This tool does not execute or test the generated code; it only provides static template files. It cannot customize templates beyond the provided configuration options or adapt to proprietary frameworks without user input.", + "examples": [ + "Create a NodeJS API endpoint template with tests included.", + "Generate a Python database model template without tests.", + "Produce middleware code in Java without database integration." + ] + }, + "tags": [ + "backend", + "template", + "code generation", + "API", + "model", + "middleware" + ], + "examples": [ + { + "inputJson": "{\"templateType\":\"API Endpoint\",\"language\":\"NodeJS\",\"includeTests\":true,\"useDatabase\":false,\"configOptions\":{\"httpMethods\":[\"GET\",\"POST\"]}}", + "description": "Generate a NodeJS API endpoint template supporting GET and POST methods with test files." + }, + { + "inputJson": "{\"templateType\":\"Model\",\"language\":\"Python\",\"includeTests\":false,\"useDatabase\":true,\"configOptions\":{\"orm\":\"SQLAlchemy\"}}", + "description": "Create a Python database model template using SQLAlchemy ORM without tests." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Template", + "context": null + } + }, + { + "name": "backend-development.createBlogPost", + "description": "Creates a new blog post entry by accepting input parameters such as title, content, author, tags, and publication status. It processes these inputs to structure and validate the blog post data, then outputs a blog post object including a unique ID, timestamps, and the provided details.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the blog post to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "The main body content of the blog post in markdown or HTML format.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "The name or identifier of the author creating the blog post.", + "required": true, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "An array of tag strings categorizing the blog post for indexing and search.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isPublished", + "type": "boolean", + "description": "Indicates if the blog post should be marked as published immediately upon creation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "summary", + "type": "string", + "description": "A brief summary or excerpt of the blog post, used for previews or listings.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object representing the created blog post, including generated fields like unique ID, created and updated timestamps, and the input data." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create new blog posts in a backend CMS or blog platform as part of content automation, managing dynamic posts, or publishing workflows.", + "limitations": "This tool does not handle image uploads, formatting beyond basic HTML/markdown checking, or advanced SEO optimizations. It assumes input content is already sanitized and valid.", + "examples": [ + "Create a new blog post titled 'Introduction to Node.js' with content, author 'Jane Doe', tags ['nodejs', 'backend'], immediately published.", + "Generate a draft blog post with title 'Upcoming Features', authored by 'John Smith', no tags, and not published yet.", + "Create a blog post including a summary and multiple tags for categorization." + ] + }, + "tags": [ + "backend-development", + "create", + "blog", + "content-management", + "API", + "post-creation", + "cms" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Getting Started with Express.js\",\"content\":\"Express.js is a minimal and flexible Node.js web application framework...\",\"author\":\"Alice Johnson\",\"tags\":[\"nodejs\",\"express\",\"webdev\"],\"isPublished\":true,\"summary\":\"An introduction to building web servers with Express.js.\"}", + "description": "Create a published blog post with a detailed summary and multiple tags." + }, + { + "inputJson": "{\"title\":\"Technical Roadmap 2024\",\"content\":\"Our platform updates planned for 2024 include scalability improvements...\",\"author\":\"Bob Lee\",\"tags\":[],\"isPublished\":false,\"summary\":\"\"}", + "description": "Save a draft blog post without tags or summary." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "BlogPost", + "context": null + } + }, + { + "name": "backend-development.createProposal", + "description": "Generates a structured project proposal document based on input parameters including project title, summary, objectives, deliverables, timeline, and budget. Processes the inputs to create a well-formatted JSON proposal output suitable for project planning and review.", + "category": "backend-development", + "parameters": [ + { + "name": "projectTitle", + "type": "string", + "description": "The title of the project proposal.", + "required": true, + "defaultValue": "" + }, + { + "name": "projectSummary", + "type": "string", + "description": "A brief summary describing the purpose and scope of the project.", + "required": true, + "defaultValue": "" + }, + { + "name": "objectives", + "type": "array", + "description": "An array of key objectives the project aims to achieve.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "deliverables", + "type": "array", + "description": "An array listing the expected deliverables or outputs of the project.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "timeline", + "type": "object", + "description": "An object specifying start and end dates of the project timeline in ISO date string format, e.g., {\"startDate\": \"YYYY-MM-DD\",\"endDate\": \"YYYY-MM-DD\"}.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "budget", + "type": "number", + "description": "Estimated budget in USD allocated for the project.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A JSON object containing the structured project proposal with all input fields organized, including automatically calculated duration in days if timeline is provided." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automatically generate a consistent, structured project proposal document from user-provided project details to facilitate planning, documentation, or submission processes. It helps standardize project proposals by assembling key information into a clear format.", + "limitations": "Does not generate detailed technical or financial analysis beyond provided inputs. Timeline dates must be valid ISO strings for duration calculation. Does not create formatted PDFs or textual documents, only structured JSON output.", + "examples": [ + "Create a project proposal for developing a mobile app with objectives and deliverables, timeline from 2024-07-01 to 2024-12-31, budget $150000.", + "Generate a summary project proposal with just title, summary, objectives, and deliverables, no timeline or budget.", + "Produce a project proposal focusing on software upgrade with clear objectives and an estimated budget but without timeline." + ] + }, + "tags": [ + "backend", + "proposal", + "project management", + "document generation", + "planning" + ], + "examples": [ + { + "inputJson": "{\"projectTitle\":\"Mobile Banking App Development\",\"projectSummary\":\"Develop a secure and user-friendly mobile banking application.\",\"objectives\":[\"Enhance user experience\",\"Implement multi-factor authentication\",\"Ensure 99.9% uptime\"],\"deliverables\":[\"Android and iOS apps\",\"Security audit report\",\"User manual\"],\"timeline\":{\"startDate\":\"2024-07-01\",\"endDate\":\"2024-12-31\"},\"budget\":150000}", + "description": "Full proposal with timeline and budget for a banking app project." + }, + { + "inputJson": "{\"projectTitle\":\"Website Redesign\",\"projectSummary\":\"Redesign corporate website for better accessibility and responsiveness.\",\"objectives\":[\"Improve UI/UX\",\"Increase mobile traffic\",\"Reduce bounce rate\"],\"deliverables\":[\"New homepage layout\",\"Mobile optimized pages\",\"Accessibility compliance report\"]}", + "description": "Basic proposal without timeline and budget." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Proposal", + "context": null + } + }, + { + "name": "web-development.analyzeSentence", + "description": "Analyzes a single sentence string to provide linguistic insights including grammatical structure, sentiment score, keyword extraction, and readability metrics. Accepts plain text input and returns detailed analysis information useful for SEO optimization, content quality assessment, and user engagement improvements.", + "category": "web-development", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The sentence text to analyze for linguistic and content features.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en' for English) to use for parsing and analysis.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Flag to include sentiment analysis results in output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeReadability", + "type": "boolean", + "description": "Flag to include readability metrics like Flesch–Kincaid score in output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "extractKeywords", + "type": "boolean", + "description": "Flag to perform keyword extraction from the sentence text.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the grammatical parse tree, sentiment score and label, extracted keywords, and readability scores for the input sentence." + }, + "aiAgent": { + "useCase": "Use this tool when you need to analyze the linguistic and semantic properties of a sentence in web content, such as for SEO tuning, quality assessment, or user experience improvement. It helps AI agents evaluate sentence structure, sentiment, keyword relevance, and readability to guide content adjustments.", + "limitations": "This tool analyzes one sentence at a time and may have reduced accuracy with idiomatic, highly informal, or domain-specific language. It does not provide full document analysis or context beyond the single sentence.", + "examples": [ + "Analyze the sentence 'Our new product launch was a huge success!' for sentiment and keywords.", + "Check readability and grammatical structure of the sentence 'Despite the rain, the event continued as planned.'", + "Extract keywords and sentiment from 'I am thrilled with the quick customer support provided.'" + ] + }, + "tags": [ + "analysis", + "linguistics", + "seo", + "content-quality", + "sentiment-analysis", + "readability" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\"The quick brown fox jumps over the lazy dog.\"}", + "description": "Basic English pangram sentence analysis with default options." + }, + { + "inputJson": "{\"sentence\":\"I had a terrible experience with the customer service.\", \"includeSentiment\":true, \"extractKeywords\":true}", + "description": "Analyzing a negative sentiment sentence including keyword extraction." + }, + { + "inputJson": "{\"sentence\":\"Understanding syntax and semantics is essential for natural language processing.\", \"includeReadability\":true}", + "description": "Assessing readability and grammatical features for an educational sentence." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Sentence", + "context": null + } + }, + { + "name": "web-development.analyzeMetric", + "description": "Analyzes a specified website performance or user behavior metric based on input data or live URLs. The tool accepts metric type, data source (either raw analytics data or a URL to fetch data from), and optional filters. It processes the data to compute statistics such as averages, trends, and anomalies, then outputs a detailed report summarizing the metric's status and insights.", + "category": "web-development", + "parameters": [ + { + "name": "metricType", + "type": "string", + "description": "The name of the metric to analyze (e.g., 'pageLoadTime', 'bounceRate', 'conversionRate').", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSource", + "type": "object", + "description": "Data input object. Either provide 'rawData' as an array of data points or 'url' string to fetch live data. At least one must be provided.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Optional filters to apply on the data, such as date range, user segments, or device types.", + "required": false, + "defaultValue": "" + }, + { + "name": "granularity", + "type": "string", + "description": "Time granularity for analysis output (e.g., 'daily', 'weekly', 'monthly'). If not specified, summarize overall metric.", + "required": false, + "defaultValue": "daily" + }, + { + "name": "includeAnomalies", + "type": "boolean", + "description": "Whether to detect and highlight anomalies in the metric data.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an analysis report object containing overall statistics, time series data per granularity interval, detected anomalies if any, and textual insights or recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when needing detailed analytics on specific website metrics from either raw data or live URL sources. It helps in understanding performance trends, spotting issues, and making data-driven decisions to improve website user experience and conversion.", + "limitations": "This tool relies on input data accuracy. It cannot fetch data from arbitrary URLs unless they provide accessible analytics data in compatible formats. It does not itself collect raw logs but analyzes provided data only.", + "examples": [ + "Analyze daily average page load time for the past month from raw log data.", + "Identify anomalies in bounce rate trends using live Google Analytics URL data.", + "Generate a weekly report on conversion rate filtered by mobile users." + ] + }, + "tags": [ + "analytics", + "web-development", + "metric-analysis", + "performance", + "user-behavior", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"metricType\":\"pageLoadTime\",\"dataSource\":{\"rawData\":[5.2,4.7,5.5,6.0,4.8]},\"filters\":{\"dateRange\":{\"start\":\"2024-01-01\",\"end\":\"2024-01-07\"}},\"granularity\":\"daily\",\"includeAnomalies\":true}", + "description": "Analyze daily page load times over one week from raw data, including anomaly detection." + }, + { + "inputJson": "{\"metricType\":\"bounceRate\",\"dataSource\":{\"url\":\"https://api.analytics.example.com/site123/bouncerate\"},\"filters\":{\"device\":\"mobile\"},\"granularity\":\"weekly\",\"includeAnomalies\":false}", + "description": "Generate weekly bounce rate report for mobile users from data fetched via URL, without anomaly detection." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Metric", + "context": null + } + }, + { + "name": "web-development.analyzeParagraph", + "description": "Analyzes a given paragraph of text from a web page to provide insights such as readability score, keyword density, sentiment, and grammatical issues. Accepts raw paragraph text as input and outputs a comprehensive analysis report highlighting content quality and SEO-related metrics.", + "category": "web-development", + "parameters": [ + { + "name": "paragraphText", + "type": "string", + "description": "The raw paragraph text to be analyzed for content quality and SEO metrics.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the paragraph text for accurate analysis, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to include sentiment analysis in the results.", + "required": false, + "defaultValue": "true" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of keywords to specifically check for their density in the paragraph.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An analysis report including readability score (Flesch-Kincaid), keyword density map, detected grammar issues, and optional sentiment rating." + }, + "aiAgent": { + "useCase": "Use this tool when needing to evaluate the quality, SEO effectiveness, and tone of textual content on web pages. It helps determine how readable the paragraph is, what keywords are emphasized, and whether the sentiment aligns with content goals.", + "limitations": "Does not perform full document or multi-paragraph context analysis. Limited by language support. Cannot verify factual accuracy of content or provide content rewriting suggestions.", + "examples": [ + "Analyze paragraph for readability and keyword presence in web page content.", + "Check sentiment and grammar issues in a promotional paragraph.", + "Evaluate SEO effectiveness of a paragraph referencing specific keywords." + ] + }, + "tags": [ + "web", + "content-analysis", + "SEO", + "readability", + "sentiment-analysis", + "grammar" + ], + "examples": [ + { + "inputJson": "{\"paragraphText\":\"Our innovative platform streamlines your workflow by integrating multiple tools into one seamless experience. Discover efficiency like never before.\",\"language\":\"en\",\"includeSentiment\":true,\"keywords\":[\"workflow\",\"efficiency\"]}", + "description": "Analyzing a marketing paragraph for readability, sentiment, and keyword density." + }, + { + "inputJson": "{\"paragraphText\":\"The quick brown fox jumps over the lazy dog.\",\"includeSentiment\":false}", + "description": "Basic readability and grammar check without sentiment analysis." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Paragraph", + "context": null + } + }, + { + "name": "web-development.analyzeCSV", + "description": "Analyzes CSV data provided as a string or file input to extract structural statistics including row and column counts, data type inference per column, missing value counts, and summary statistics for numeric data. Outputs a detailed report object summarizing these analyses, aiding web developers in validating and understanding CSV datasets for web applications.", + "category": "web-development", + "parameters": [ + { + "name": "csvData", + "type": "string", + "description": "CSV formatted string data to be analyzed.", + "required": true, + "defaultValue": "" + }, + { + "name": "hasHeader", + "type": "boolean", + "description": "Indicates if the CSV data includes a header row for column names.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used as the delimiter in the CSV data.", + "required": false, + "defaultValue": "," + }, + { + "name": "maxSampleSize", + "type": "number", + "description": "Maximum number of rows to sample for analysis to limit processing time.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "inferDataTypes", + "type": "boolean", + "description": "Whether to infer data types for each column based on sample data.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing analysis results including rowCount, columnCount, columnNames, dataTypes (inferred), missingValues per column, and summaryStatistics for numeric columns (min, max, mean, median, stdDev)." + }, + "aiAgent": { + "useCase": "Use this tool when needing to validate, preview, or understand the structure and data quality of CSV files in web development projects. It helps detect missing data, confirm expected columns, and obtain quick statistics for rendering data-driven interfaces or performing further processing.", + "limitations": "This tool analyzes CSV format only, it does not handle other file types or complex embedded CSV data. Data type inference is approximate and based on sample data, which may not reflect entire dataset nuances.", + "examples": [ + "Analyze a CSV string to get column names and data types before rendering a data table.", + "Check missing values and numeric distributions in CSV user-uploaded data for a web app.", + "Validate CSV structure by verifying row and column counts and summarizing key statistics." + ] + }, + "tags": [ + "csv", + "analysis", + "data-validation", + "web-development", + "data-quality", + "statistics" + ], + "examples": [ + { + "inputJson": "{\"csvData\":\"name,age,score\\nAlice,30,85\\nBob,25,90\\nCharlie,,78\",\"hasHeader\":true,\"delimiter\":\",\",\"maxSampleSize\":100,\"inferDataTypes\":true}", + "description": "Analyze a CSV string with three rows and three columns, one with a missing age value." + }, + { + "inputJson": "{\"csvData\":\"id|product|price\\n1|Notebook|10.5\\n2|Pen|1.25\\n3|Eraser|0.75\",\"hasHeader\":true,\"delimiter\":\"|\",\"inferDataTypes\":true}", + "description": "Analyze pipe-delimited CSV data with product price info to infer numeric and string columns." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "CSV", + "context": null + } + }, + { + "name": "web-development.draftEmail", + "description": "Generates a professional draft email based on input parameters including recipient details, subject, context, and tone. It processes the input to compose a structured email message body and returns a complete email draft ready for sending or further editing.", + "category": "web-development", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the email recipient to personalize the greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmail", + "type": "string", + "description": "Email address of the recipient, used for header formation and validation.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email to set the email topic or purpose.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyContext", + "type": "string", + "description": "Background information or key points that need to be conveyed in the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone style of the email, e.g., formal, informal, friendly, persuasive, to match the communication context.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the sender to include in the email closing or signature.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Flag whether to append a signature block with sender name at the end of the email.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed email components: subject, recipient, and full draft text." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate well-structured, context-aware email drafts for web applications or automated communication workflows, ensuring personalized and professional messaging based on specified inputs.", + "limitations": "The tool does not send emails or handle attachments, nor can it access external platform data to tailor content beyond provided input.", + "examples": [ + "Draft an email to a client named John Doe about the project update with a formal tone.", + "Generate a friendly invitation email to a colleague for a meeting.", + "Create a persuasive follow-up email to a customer with details of new offers." + ] + }, + "tags": [ + "email", + "draft", + "communication", + "web-development", + "automation", + "customer-support" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"John Doe\",\"recipientEmail\":\"john.doe@example.com\",\"subject\":\"Project Update\",\"bodyContext\":\"We have completed phase one of the project and are on track for delivery next month.\",\"tone\":\"formal\",\"senderName\":\"Alice Smith\",\"includeSignature\":true}", + "description": "Draft a formal project update email to a client including a signature." + }, + { + "inputJson": "{\"recipientName\":\"Julie\",\"recipientEmail\":\"julie@example.com\",\"subject\":\"Team Lunch Invitation\",\"bodyContext\":\"Join us for a team lunch this Friday at noon.\",\"tone\":\"friendly\",\"senderName\":\"Mark\",\"includeSignature\":false}", + "description": "Create an informal lunch invitation email without signature." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "web-development.generateParagraph", + "description": "Generates a coherent paragraph of text suitable for webpages based on a given topic keyword or phrase. It accepts parameters to control paragraph length, style, and tone, and outputs a well-structured paragraph string formatted for easy insertion into HTML or content management systems.", + "category": "web-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or keyword phrase to base the paragraph content on.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate number of sentences in the generated paragraph.", + "required": false, + "defaultValue": "5" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the paragraph, e.g., formal, casual, friendly, professional.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeHtml", + "type": "boolean", + "description": "Whether to format the paragraph output with HTML paragraph tags.", + "required": false, + "defaultValue": "false" + }, + { + "name": "audience", + "type": "string", + "description": "Intended audience for the paragraph, influencing word choice and complexity, e.g., general, technical, children.", + "required": false, + "defaultValue": "general" + } + ], + "returns": { + "type": "object", + "description": "An object containing a single string field 'paragraph' with the generated text, optionally HTML formatted." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate meaningful, readable paragraph content for website sections such as about pages, product descriptions, blog introductions, or informational blocks, based on a specific topic and style preferences. It helps automate content creation for web development and content management tasks.", + "limitations": "This tool cannot guarantee production of 100% original or perfectly accurate factual content. It also cannot replace human editing for SEO optimization or stylistic consistency beyond basic tone adjustments.", + "examples": [ + "Generate a friendly paragraph about sustainable gardening for a general audience, 4 sentences, with HTML tags.", + "Create a formal technical paragraph explaining cloud computing basics, 6 sentences, without HTML.", + "Produce a casual short paragraph on coffee culture for social media, 3 sentences, with HTML tags." + ] + }, + "tags": [ + "content generation", + "web development", + "paragraph", + "text generation", + "html formatting", + "tone control" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"sustainable gardening\",\"length\":4,\"tone\":\"friendly\",\"includeHtml\":true,\"audience\":\"general\"}", + "description": "Generating a friendly 4 sentence paragraph about sustainable gardening with HTML tags for a general audience." + }, + { + "inputJson": "{\"topic\":\"cloud computing basics\",\"length\":6,\"tone\":\"formal\",\"includeHtml\":false,\"audience\":\"technical\"}", + "description": "Generating a formal 6 sentence paragraph explaining cloud computing basics without HTML formatting for a technical audience." + }, + { + "inputJson": "{\"topic\":\"coffee culture\",\"length\":3,\"tone\":\"casual\",\"includeHtml\":true,\"audience\":\"general\"}", + "description": "Generating a casual 3 sentence paragraph about coffee culture with HTML tags for social media content." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "web-development.generateSummary", + "description": "Generates a concise summary of a website or webpage based on provided HTML content or URL. Processes raw HTML or fetches content from a URL, extracts key textual information, and returns a readable summary highlighting main points and topics.", + "category": "web-development", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL of the webpage to summarize. If provided, the tool fetches and processes the content from this URL.", + "required": false, + "defaultValue": "" + }, + { + "name": "htmlContent", + "type": "string", + "description": "Raw HTML content of a webpage to summarize. Used if URL is not provided or to summarize custom HTML fragments.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "Maximum length of the generated summary in characters. Limits summary size for concise output.", + "required": false, + "defaultValue": "300" + }, + { + "name": "includeHeadings", + "type": "boolean", + "description": "Whether to include webpage headings (like
,
) in the summary to preserve structure.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text, the source processed (URL or direct HTML), and metadata like summary length." + }, + "aiAgent": { + "useCase": "Use this tool when you need a quick, readable summary of webpage content to present to users, generate previews, or assist in content curation. It works for both URL inputs or raw HTML strings where content may come from dynamic or offline sources.", + "limitations": "This tool cannot fully understand multimedia content (images, videos) or deeply interpret JavaScript-rendered dynamic content without pre-rendered HTML. Summaries may lack nuance of detailed web pages and may miss some contextual info.", + "examples": [ + "Summarize the main points of https://example.com/article on climate change.", + "Generate a summary for given HTML content of a product webpage to produce meta descriptions.", + "Create a 150-character summary including headings for a blog post fetched by URL." + ] + }, + "tags": [ + "web", + "summary", + "html", + "content-analysis", + "website-preview", + "content-extraction" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/article\"}", + "description": "Generate a summary from the public article page provided by URL." + }, + { + "inputJson": "{\"htmlContent\":\"
Title
This is the content paragraph.
\",\"includeHeadings\":true}", + "description": "Summarize a given raw HTML snippet including headings." + }, + { + "inputJson": "{\"url\":\"https://example.com/blog/post\",\"maxSummaryLength\":150}", + "description": "Produce a concise 150-character summary for a blog post URL." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "automation-frameworks.downloadDataset", + "description": "Downloads datasets from specified public or private data repositories. Accepts repository URL, dataset identifier, optional authentication, and output format. Processes request by connecting to the repository, authenticating if needed, and downloading the dataset in the desired format, saving it locally or returning a path.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The URL of the data repository where the dataset is hosted, e.g., a public data portal or cloud storage endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "datasetId", + "type": "string", + "description": "Unique identifier or path of the dataset within the repository, used to locate the dataset to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format for the dataset file, e.g., CSV, JSON, Parquet. Converts dataset if supported.", + "required": false, + "defaultValue": "original" + }, + { + "name": "authenticationToken", + "type": "string", + "description": "Optional authentication token or API key if the repository requires secure access.", + "required": false, + "defaultValue": "" + }, + { + "name": "downloadPath", + "type": "string", + "description": "Local file system path where to save the downloaded dataset file. If empty, returns data as a buffer or stream.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing download status, local file path if saved, original dataset metadata, and error messages if any." + }, + "aiAgent": { + "useCase": "Use this tool when an automation workflow requires retrieving datasets from external repositories for processing or analysis, especially when needing to download and store data locally with optional format conversion and authentication.", + "limitations": "Cannot download datasets from repositories that do not support programmatic access or that require interactive sessions. Format conversion is limited to common dataset formats only.", + "examples": [ + "Download dataset 12345 from public repository at example.com and save as CSV locally.", + "Fetch private dataset with authentication token and get file path output.", + "Download dataset in original format but return data as a stream without saving." + ] + }, + "tags": [ + "automation", + "dataset", + "download", + "data-retrieval", + "workflow", + "data-format", + "authentication" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://data.example.com\",\"datasetId\":\"sales/2023/q1\",\"outputFormat\":\"CSV\",\"authenticationToken\":\"\",\"downloadPath\":\"/tmp/q1_sales.csv\"}", + "description": "Download Q1 sales dataset from public example.com repo, convert to CSV, and save locally." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://private.repo.com\",\"datasetId\":\"projectX/metrics\",\"outputFormat\":\"original\",\"authenticationToken\":\"abc123token\",\"downloadPath\":\"\"}", + "description": "Download private projectX metrics dataset using token, keep original format and return data stream." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "Dataset", + "context": null + } + }, + { + "name": "automation-frameworks.buildBranch", + "description": "This tool automates the creation of a new branch in a specified git repository. It accepts repository details, base branch, new branch name, and optional commit SHA as inputs, performs git operations to create and optionally check out the branch, and returns the branch creation status with relevant metadata.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "URL of the git repository where the branch will be created", + "required": true, + "defaultValue": "" + }, + { + "name": "baseBranch", + "type": "string", + "description": "The existing branch name to base the new branch on", + "required": true, + "defaultValue": "main" + }, + { + "name": "newBranchName", + "type": "string", + "description": "Name of the new branch to be created", + "required": true, + "defaultValue": "" + }, + { + "name": "commitSha", + "type": "string", + "description": "Specific commit SHA to base the new branch on; overrides baseBranch if provided", + "required": false, + "defaultValue": "" + }, + { + "name": "checkout", + "type": "boolean", + "description": "Whether to check out the new branch locally after creation", + "required": false, + "defaultValue": "false" + }, + { + "name": "authenticationToken", + "type": "string", + "description": "Authentication token for accessing private repositories if needed", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object describing the result of branch creation including status, branch info and any error messages" + }, + "aiAgent": { + "useCase": "Use this tool when automating software development workflows that require dynamic branch creation in git repositories. For example, an AI agent managing CI/CD pipelines or feature deployments can invoke this to create feature or bugfix branches programmatically without manual git commands.", + "limitations": "This tool does not perform merges, resolve conflicts, or push branches to remote if not configured. It requires correct repository access rights and valid parameters. It assumes git CLI or equivalent APIs are available for execution.", + "examples": [ + "Create a feature branch named 'feature/login-improvements' off 'develop' branch in given repo.", + "Create a hotfix branch from specific commit SHA for emergency patching.", + "Create and check out a new branch 'experiment-xyz' from main branch locally." + ] + }, + "tags": [ + "automation", + "git", + "branch-management", + "devops", + "ci-cd", + "workflow" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"baseBranch\":\"develop\",\"newBranchName\":\"feature/login-improvements\",\"checkout\":false}", + "description": "Create a new branch 'feature/login-improvements' based on 'develop' branch without checking out." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"commitSha\":\"a1b2c3d4e5f6g7h8i9j0\",\"newBranchName\":\"hotfix/urgent-fix\",\"checkout\":true}", + "description": "Create and check out a hotfix branch from a specific commit SHA." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"baseBranch\":\"main\",\"newBranchName\":\"experiment-xyz\",\"checkout\":true}", + "description": "Create and check out a new experimental branch from main branch." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Branch", + "context": null + } + }, + { + "name": "text-analysis.draftDocument", + "description": "This tool accepts user prompts and optional context to draft well-structured textual documents such as reports, summaries, emails, or proposals. It processes input by applying natural language generation techniques tailored to the specified document type, tone, and length constraints. The output is a coherent and formatted text document draft matching user requirements.", + "category": "text-analysis", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Specifies the type of document to draft (e.g., report, email, summary, proposal).", + "required": true, + "defaultValue": "" + }, + { + "name": "prompt", + "type": "string", + "description": "The main input or subject matter based on which the document will be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the drafted document (e.g., formal, informal, persuasive, neutral).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the document in number of words.", + "required": false, + "defaultValue": "500" + }, + { + "name": "context", + "type": "string", + "description": "Optional additional context or background information to be incorporated in the document.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated document text and metadata including word count and document type." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a structured textual document based on a user prompt and desired specifications, such as creating reports, emails, summaries, or proposals automatically. It helps produce coherent, contextually relevant drafts quickly for review and refinement.", + "limitations": "The tool cannot guarantee perfectly accurate or domain-specific expert content and may require human review and editing. It does not perform fact-checking or data extraction from external sources.", + "examples": [ + "Draft a formal email apologizing for a delayed project update.", + "Generate a concise summary report about the last quarter sales performance.", + "Create a persuasive proposal text for a new marketing campaign." + ] + }, + "tags": [ + "text-generation", + "document-creation", + "natural-language-processing", + "content-drafting", + "writing-assistant" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"email\",\"prompt\":\"Inform the client about the project delay due to unforeseen circumstances.\",\"tone\":\"formal\",\"length\":200}", + "description": "Draft a formal email notifying a client about a project delay." + }, + { + "inputJson": "{\"documentType\":\"summary\",\"prompt\":\"Summarize the main points discussed in the recent team meeting.\",\"tone\":\"neutral\",\"length\":150}", + "description": "Create a neutral toned summary of a team meeting." + }, + { + "inputJson": "{\"documentType\":\"proposal\",\"prompt\":\"Write a proposal for a new remote work policy to improve employee flexibility.\",\"tone\":\"persuasive\",\"length\":600}", + "description": "Generate a persuasive proposal document for implementing a remote work policy." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Document", + "context": null + } + }, + { + "name": "text-analysis.draftEmail", + "description": "Generates a professional email draft based on the provided subject, recipient details, and purpose. Accepts inputs such as recipient name, email subject, email purpose, tone, and optional key points to include. Outputs a well-structured email draft ready for review or sending.", + "category": "text-analysis", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the email recipient to personalize the greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmail", + "type": "string", + "description": "Email address of the recipient; used to confirm email relevance but not included in the draft text.", + "required": false, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email to set context for the content.", + "required": true, + "defaultValue": "" + }, + { + "name": "emailPurpose", + "type": "string", + "description": "Primary purpose of the email, e.g., request, follow-up, invitation, or information sharing.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email, such as formal, casual, friendly, or persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keyPoints", + "type": "array", + "description": "Array of concise key discussion points or items to include in the email body.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the complete email draft including salutation, body paragraphs, and closing remarks structured as a single string with markup for clarity." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate a professional and contextually appropriate email draft from minimal input about the recipient and the email's purpose. It assists in automating routine communication drafts, ensuring tone and content align with user goals.", + "limitations": "This tool does not send emails or manage email delivery. It cannot access external data about recipients beyond provided inputs, and may not perfectly capture very complex or highly specialized email content without detailed instructions.", + "examples": [ + "Draft a follow-up email to a client named Sarah Williams after a project meeting with a friendly tone.", + "Generate a formal invitation email for a company event addressed to multiple recipients, including key points about date, location, and RSVP instructions.", + "Create a persuasive email to request budget approval from the finance department head." + ] + }, + "tags": [ + "text-analysis", + "email", + "drafting", + "communication", + "natural-language-processing" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"John Doe\",\"recipientEmail\":\"john.doe@example.com\",\"subject\":\"Project Update Meeting\",\"emailPurpose\":\"to provide status updates and schedule next steps\",\"tone\":\"formal\",\"keyPoints\":[\"Current progress: 75% complete\",\"Issues faced: delayed deliveries\",\"Next steps: finalize design, start testing\"]}", + "description": "Draft a formal project update email to John Doe summarizing progress, issues, and next steps." + }, + { + "inputJson": "{\"recipientName\":\"Emily\",\"subject\":\"Invitation to Tech Conference 2024\",\"emailPurpose\":\"inviting to attend our annual tech conference\",\"tone\":\"friendly\",\"keyPoints\":[\"Date: March 15-17, 2024\",\"Location: Downtown Convention Center\",\"RSVP by Feb 28\"]}", + "description": "Create a friendly invitation email to Emily about an upcoming tech conference with key details." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "text-analysis.formatFunction", + "description": "This tool accepts raw source code of a single function in languages like JavaScript, Python, or Java. It parses and reformats the code to apply consistent indentation, spacing, and line breaks to improve readability and adherence to common style guidelines. It outputs the formatted function source code as a string.", + "category": "text-analysis", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The raw source code of the function to be formatted. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the input code (e.g., 'javascript', 'python', 'java'). Helps select appropriate formatting rules. Defaults to 'javascript'.", + "required": false, + "defaultValue": "\"javascript\"" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for indentation. Defaults to 4.", + "required": false, + "defaultValue": "4" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to indent with tabs instead of spaces. Defaults to false (use spaces).", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length before wrapping code lines. Defaults to 80.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function code as a string under 'formattedCode'." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw or poorly formatted source code of a function that needs to be cleaned up for readability, style consistency, or adherence to formatting conventions. Ideal for preparing code snippets for documentation, code reviews, or user display.", + "limitations": "It formats a single function's source code only, not entire files or multiple functions at once. Complex formatting or style customizations beyond indentation, spacing, and line breaks are not supported. It may not handle syntactically invalid code well.", + "examples": [ + "Format a messy JavaScript function to have consistent indentation and spacing.", + "Reformat a raw Python function snippet to improve readability before including in documentation.", + "Apply standard Java code indentation rules to a single method's source code." + ] + }, + "tags": [ + "formatting", + "code", + "function", + "source-code", + "style", + "text-analysis", + "programming" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function add(a,b){return a+b;}\",\"language\":\"javascript\",\"indentSize\":2,\"useTabs\":false,\"maxLineLength\":80}", + "description": "Format a simple JavaScript function with 2-space indentation." + }, + { + "inputJson": "{\"code\":\"def sum(a,b):\\n return a+b\",\"language\":\"python\",\"indentSize\":4,\"useTabs\":false,\"maxLineLength\":80}", + "description": "Format a Python function maintaining default 4-space indentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "text-analysis.generateSummary", + "description": "Generates a concise and coherent summary from input text documents. Accepts raw text or an array of text strings, processes the content to extract key points and themes using natural language understanding techniques, and produces a short textual summary highlighting the main ideas.", + "category": "text-analysis", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The primary text content to summarize, or a JSON stringified array of multiple text blocks.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum desired length of the summary in number of characters; if omitted, defaults to 300 characters.", + "required": false, + "defaultValue": "300" + }, + { + "name": "language", + "type": "string", + "description": "The language code of the input text (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeySentences", + "type": "boolean", + "description": "Whether the summary should include key representative sentences extracted verbatim from the input text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "summaryType", + "type": "string", + "description": "Type of summary to generate: 'extractive' (select sentences from text) or 'abstractive' (rephrase content).", + "required": false, + "defaultValue": "abstractive" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and metadata such as the original input length and summary length." + }, + "aiAgent": { + "useCase": "Use this tool when a concise overview of large documents or multiple texts is needed to quickly grasp essential information without reading full content. Useful for summarizing articles, reports, or emails to save time and improve understanding.", + "limitations": "Does not guarantee perfect accuracy or context preservation for highly technical or ambiguous texts. Quality depends on input clarity and length constraints.", + "examples": [ + "Summarize this 2000-word research article into a brief paragraph.", + "Generate a summary highlighting main points from these meeting notes.", + "Provide a short abstract of this report including key sentences." + ] + }, + "tags": [ + "text analysis", + "summarization", + "NLP", + "document processing", + "abstractive summary", + "extractive summary" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"Recent studies in climate science indicate a sharp rise in global temperatures over the past decade, with significant impacts on polar ice melt and weather patterns.\",\"maxLength\":150}", + "description": "Summarize a single short paragraph about climate science." + }, + { + "inputJson": "{\"inputText\":\"[\\\"The quarterly financial report shows an increase in revenue by 15% compared to last year.\", \"Expenses grew moderately but remain within budget limits.\"]\",\"summaryType\":\"extractive\",\"includeKeySentences\":true}", + "description": "Generate an extractive summary with key sentences from multiple financial report items." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "text-analysis.createParagraph", + "description": "Generates a coherent, contextually relevant paragraph based on a given topic or seed text, tone, and desired length. Accepts text prompts and style preferences, then produces a natural language paragraph suitable for articles, reports, or creative writing.", + "category": "text-analysis", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme the paragraph should cover.", + "required": true, + "defaultValue": "" + }, + { + "name": "seedText", + "type": "string", + "description": "Optional starter text to guide the paragraph content and style.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Defines the writing tone such as formal, casual, persuasive, or informative.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "length", + "type": "number", + "description": "Approximate target length of the paragraph in number of sentences or lines.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include illustrative examples or anecdotes in the paragraph.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text in a natural, coherent format suitable for direct use or further editing." + }, + "aiAgent": { + "useCase": "Use this tool when generating original, focused paragraphs for reports, essays, articles, or creative content based on a topic or initial prompt. It helps in expanding ideas into readable, fluent paragraphs matching desired tone and length.", + "limitations": "Cannot guarantee factual accuracy or up-to-date information; quality depends on input quality. Not for generating multi-paragraph documents or complex structured compositions.", + "examples": [ + "Write a persuasive paragraph about electric vehicles.", + "Create a formal paragraph discussing climate change impacts.", + "Generate an informative paragraph about the benefits of meditation with examples." + ] + }, + "tags": [ + "text generation", + "paragraph creation", + "natural language processing", + "content generation", + "writing assistant" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"renewable energy\",\"tone\":\"informative\",\"length\":4}", + "description": "Generate a concise informative paragraph about renewable energy." + }, + { + "inputJson": "{\"topic\":\"importance of cybersecurity\",\"seedText\":\"In today’s digital age,\",\"tone\":\"formal\",\"length\":5}", + "description": "Create a formal paragraph starting with given seed text about cybersecurity." + }, + { + "inputJson": "{\"topic\":\"healthy eating habits\",\"tone\":\"casual\",\"includeExamples\":true}", + "description": "Produce a casual tone paragraph about healthy eating including examples." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "text-analysis.createEvent", + "description": "Creates a structured event object from a block of text by analyzing and extracting relevant entities such as date, time, location, participants, and summary. Accepts raw event description as input, performs natural language processing and entity recognition, and outputs a JSON event object suitable for calendar or analytics integration.", + "category": "text-analysis", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "Raw text describing the event, including details like date, time, location, and participants.", + "required": true, + "defaultValue": "" + }, + { + "name": "timezone", + "type": "string", + "description": "The timezone to interpret dates and times in the text, e.g., 'America/New_York'.", + "required": false, + "defaultValue": "UTC" + }, + { + "name": "includeParticipants", + "type": "boolean", + "description": "Whether to attempt to extract participant names from the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text to improve entity extraction, e.g., 'en'.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the parsed event with fields like startDateTime, endDateTime, location, participants, and description summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to transform an unstructured textual event description into a standardized event data object for calendar creation, scheduling, or event analytics. It helps in extracting key details like time, place, and attendees automatically from natural language inputs.", + "limitations": "This tool may not perfectly parse highly ambiguous or incomplete event descriptions, and is less effective with informal or very short texts lacking clear event details. Timezone disambiguation relies on provided or default timezone and may need manual adjustment.", + "examples": [ + "Create an event object from the email text describing a meeting next Monday at 3 PM in New York with John and Lisa.", + "Extract event details from a chat message informing about a team lunch on Friday noon.", + "Parse a conference announcement text to create a calendar event with location and dates." + ] + }, + "tags": [ + "text-analysis", + "event-extraction", + "nlp", + "calendar-integration", + "entity-recognition" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Team meeting scheduled for March 15, 2024, at 2:00 PM in Conference Room A with Alice, Bob, and Charlie.\",\"timezone\":\"America/New_York\"}", + "description": "Extracts structured event from formal meeting description including date, time, location, and participants." + }, + { + "inputJson": "{\"text\":\"Lunch with Sarah next Friday at noon downtown.\",\"timezone\":\"America/Los_Angeles\"}", + "description": "Parses informal event description mentioning date, time, and location for event scheduling." + }, + { + "inputJson": "{\"text\":\"Annual conference will be held on July 10-12, 2024, at the Grand Hotel.\",\"language\":\"en\"}", + "description": "Creates event object from multi-day event announcement with location and dates." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "text-analysis.createInvoice", + "description": "Generates a detailed invoice document based on provided client information, list of purchased items or services, pricing, and payment terms. Accepts structured input including customer details and line items, processes them to calculate totals and taxes, and outputs a formatted invoice as JSON or plain text suitable for billing and record keeping.", + "category": "text-analysis", + "parameters": [ + { + "name": "clientInfo", + "type": "object", + "description": "An object with client details such as name, address, contact info, and tax ID.", + "required": true, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "An array of line items each including description, quantity, unit price, and optional tax rate.", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceNumber", + "type": "string", + "description": "Unique identifier for the invoice for reference and tracking.", + "required": false, + "defaultValue": "" + }, + { + "name": "issueDate", + "type": "string", + "description": "Date when the invoice is issued, in ISO 8601 format (e.g., 2023-01-30).", + "required": false, + "defaultValue": "" + }, + { + "name": "dueDate", + "type": "string", + "description": "Payment due date in ISO 8601 format, indicating when payment is expected.", + "required": false, + "defaultValue": "" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Terms and conditions related to payment (e.g., 'Net 30 days').", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for all monetary values (e.g., USD, EUR).", + "required": false, + "defaultValue": "USD" + }, + { + "name": "includeTaxes", + "type": "boolean", + "description": "Flag whether to calculate and include taxes based on item tax rates.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the output invoice document: 'json' for structured data or 'text' for human readable string.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "Returns the generated invoice either as a JSON object with full details and calculations or as a formatted plain text string depending on requested output format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a complete invoice document from structured order or service data, including client details and pricing. It is ideal for automating billing processes, generating records, or preparing invoices for emailing or printing.", + "limitations": "This tool does not perform payment processing or validation of client financial information. It also does not generate PDF or graphical invoice templates; output is limited to JSON data or plain text formats.", + "examples": [ + "Create an invoice for a client who purchased three items with different tax rates.", + "Generate an invoice in plain text for a service provider including payment terms and due date.", + "Produce a JSON invoice including itemized taxes and a unique invoice number." + ] + }, + "tags": [ + "text-analysis", + "document-generation", + "invoice", + "billing", + "finance", + "automation" + ], + "examples": [ + { + "inputJson": "{\"clientInfo\":{\"name\":\"Acme Corp\",\"address\":\"123 Elm St, Springfield, IL\",\"contact\":\"billing@acme.com\",\"taxId\":\"98-7654321\"},\"items\":[{\"description\":\"Widget A\",\"quantity\":10,\"unitPrice\":9.99,\"taxRate\":0.07},{\"description\":\"Widget B\",\"quantity\":5,\"unitPrice\":19.99,\"taxRate\":0.07}],\"invoiceNumber\":\"INV-1001\",\"issueDate\":\"2024-04-15\",\"dueDate\":\"2024-05-15\",\"paymentTerms\":\"Net 30\",\"currency\":\"USD\",\"includeTaxes\":true,\"outputFormat\":\"json\"}", + "description": "Generate a JSON formatted invoice for a client with two products, including tax calculation." + }, + { + "inputJson": "{\"clientInfo\":{\"name\":\"Jane Doe Consulting\",\"address\":\"456 Oak Ave, Metropolis, NY\",\"contact\":\"jane@consulting.com\"},\"items\":[{\"description\":\"Consulting Service\",\"quantity\":15,\"unitPrice\":75}],\"invoiceNumber\":\"CONS-2024-07\",\"issueDate\":\"2024-06-01\",\"dueDate\":\"2024-06-30\",\"paymentTerms\":\"Due on receipt\",\"currency\":\"USD\",\"includeTaxes\":false,\"outputFormat\":\"text\"}", + "description": "Create a plain text invoice for consulting services, excluding taxes, with payment due on receipt." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "text-analysis.createSummary", + "description": "This tool accepts a text document or multiple paragraphs as input and generates a concise summary capturing the main ideas and key points. It processes natural language text using advanced NLP techniques to produce a shorter, coherent summary that retains essential information, suitable for quick understanding or review.", + "category": "text-analysis", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The full text content to summarize, can be a paragraph or multiple paragraphs.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words for the summary output. If not specified, defaults to 100 words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "minLength", + "type": "number", + "description": "Minimum number of words for the summary output. Controls summary length floor.", + "required": false, + "defaultValue": "30" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text to handle language-specific processing. Defaults to English ('en').", + "required": false, + "defaultValue": "en" + }, + { + "name": "focusKeywords", + "type": "array", + "description": "Optional list of keywords to emphasize in the summary, guiding the tool to highlight related content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeHighlights", + "type": "boolean", + "description": "If true, include brief highlights or bullet points summarizing key facts along with the main summary text.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and optional highlights." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to distill large bodies of text or documents into concise summaries that preserve core meaning and key details. Ideal for speeding comprehension of articles, reports, emails, or long messages. It helps users quickly grasp content without reading the full text.", + "limitations": "The summary may omit nuanced details and context. It is not suitable for creating exhaustive abstracts or technical summaries requiring domain expertise. Quality depends on input text clarity and language support.", + "examples": [ + "Summarize a research paper abstract to a 50-word brief.", + "Generate a summary of a user-submitted news article highlighting main events.", + "Create bullet point highlights focusing on specific keywords in a business report." + ] + }, + "tags": [ + "summary", + "text-processing", + "natural-language", + "document", + "nlp", + "concise", + "review" + ], + "examples": [ + { + "inputJson": "{\"text\":\"The city council met to discuss new policies on transportation infrastructure improvements aimed at reducing traffic congestion and promoting sustainable transit options. The meeting highlighted several key projects, including bike lane expansions and electric bus deployments.\",\"maxLength\":50,\"includeHighlights\":true}", + "description": "Summarize a city council report discussing transportation projects, including bullet highlights." + }, + { + "inputJson": "{\"text\":\"Artificial intelligence is transforming many industries by automating routine tasks and enabling new forms of data analysis. Businesses leveraging AI can improve efficiency and innovate rapidly.\",\"maxLength\":40}", + "description": "Generate a brief summary of AI impact in business contexts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "api-integration.analyzeSentence", + "description": "Analyzes a sentence by detecting its language, sentiment (positive, neutral, negative), and extracting key entities such as people, places, and organizations. Accepts a text sentence as input and returns a structured summary with language code, sentiment score, and a list of recognized entities with types and positions.", + "category": "api-integration", + "parameters": [ + { + "name": "sentence", + "type": "string", + "description": "The input sentence text to analyze for language, sentiment, and entities.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeEntities", + "type": "boolean", + "description": "Whether to extract named entities from the sentence. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to analyze the sentence sentiment. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "languageHint", + "type": "string", + "description": "Optional ISO language code hint to assist language detection (e.g., 'en', 'fr').", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing detected language (ISO code), sentiment (label and score), and an array of extracted entities (type, text, start and end indices)." + }, + "aiAgent": { + "useCase": "Use this tool when you need comprehensive analysis of individual sentences for content understanding, such as social media monitoring, customer feedback analysis, or conversational AI applications. It helps extract key meaning components, detect sentiment polarity, and identify important named entities to inform downstream decision-making or summarization.", + "limitations": "Cannot perform deep semantic parsing or context-aware disambiguation beyond the single sentence. Accuracy depends on the quality of underlying language and NLP models; ambiguous sentences may yield imperfect sentiment or entity detection.", + "examples": [ + "Analyze this customer review sentence for sentiment and entities: 'John from Seattle loved the new product!'.", + "Detect language and sentiment of a French sentence.", + "Extract entities only from the sentence: 'Amazon is expanding its headquarters in New York.'" + ] + }, + "tags": [ + "api-integration", + "text-analysis", + "nlp", + "sentiment-analysis", + "entity-recognition", + "language-detection" + ], + "examples": [ + { + "inputJson": "{\"sentence\":\"Barack Obama was born in Hawaii.\"}", + "description": "Analyze a sentence mentioning a famous person and place to extract entities and detect language and sentiment." + }, + { + "inputJson": "{\"sentence\":\"C'est une belle journée.\", \"languageHint\":\"fr\"}", + "description": "Analyze a French sentence with a language hint to detect language and sentiment." + }, + { + "inputJson": "{\"sentence\":\"The meeting was unproductive.\", \"includeEntities\":false}", + "description": "Analyze sentiment only without extracting entities from a negative sentiment sentence." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Sentence", + "context": null + } + }, + { + "name": "api-integration.buildCommit", + "description": "Builds a commit object for a version control system API by accepting commit metadata such as author details, commit message, parent commit SHA, and tree SHA. Processes these inputs to construct a structured commit payload ready for submission to code hosting APIs like GitHub or GitLab, outputting a commit object with a generated SHA identifier.", + "category": "api-integration", + "parameters": [ + { + "name": "repository", + "type": "string", + "description": "The repository identifier, typically in 'owner/repo' format, where the commit will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "treeSha", + "type": "string", + "description": "The SHA hash of the tree object this commit points to, representing the state of the file hierarchy.", + "required": true, + "defaultValue": "" + }, + { + "name": "parentShas", + "type": "array", + "description": "An array of parent commit SHA strings for this commit, supporting merges when multiple parents are provided.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "authorName", + "type": "string", + "description": "The name of the commit author.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "The email address of the commit author.", + "required": true, + "defaultValue": "" + }, + { + "name": "committerName", + "type": "string", + "description": "The name of the committer, if different from the author. If not provided, defaults to authorName.", + "required": false, + "defaultValue": "" + }, + { + "name": "committerEmail", + "type": "string", + "description": "The email of the committer, if different from the author. Defaults to authorEmail if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "commitMessage", + "type": "string", + "description": "The commit message describing the changes introduced by this commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "commitTimestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp of the commit. Defaults to current time if omitted.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created commit, including its SHA, commit message, author and committer info, parent SHAs, tree SHA, and commit timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create or prepare a commit object for a git repository via API integration, including setting metadata such as author, committer, message, and tree reference before pushing. Ideal for automating commit workflows or building custom version control operations.", + "limitations": "This tool only builds the commit object and does not push or apply the commit to the repository. It depends on correct input SHAs and repository IDs; authentication and actual commit creation via remote API calls must be handled separately.", + "examples": [ + "Create a commit object for a repo with a new commit message and author info.", + "Build a commit with multiple parent commits to represent a merge commit.", + "Generate a commit structure with specific committer details differing from the author." + ] + }, + "tags": [ + "api-integration", + "git", + "commit", + "version-control", + "code-management", + "automation", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"repository\":\"octocat/Hello-World\",\"treeSha\":\"f49cfc1e6b7c2e6defa9f3cbb2222d15a4d1e5b5\",\"parentShas\":[\"7d1b31e74ee336d15cbd21741bc88a537ed063a0\"],\"authorName\":\"Alice Johnson\",\"authorEmail\":\"alice@example.com\",\"commitMessage\":\"Fix typo in README.md\"}", + "description": "Create a basic commit object pointing to a tree SHA with one parent commit and author info." + }, + { + "inputJson": "{\"repository\":\"octocat/Hello-World\",\"treeSha\":\"a12bc34de56f7890a12b3c4d5e6f7890abcdef12\",\"parentShas\":[\"c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f67890abcd\",\"1234567890abcdef1234567890abcdef12345678\"],\"authorName\":\"Bob Smith\",\"authorEmail\":\"bob.smith@example.com\",\"committerName\":\"CI Bot\",\"committerEmail\":\"ci@example.com\",\"commitMessage\":\"Merge branch 'feature-xyz' into 'main'\",\"commitTimestamp\":\"2024-06-01T12:00:00Z\"}", + "description": "Build a merge commit with two parents, with different committer info and explicit commit timestamp." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Commit", + "context": null + } + }, + { + "name": "api-integration.formatFunction", + "description": "Formats a given raw JavaScript or TypeScript function code string into a standardized, readable style according to specified formatting options. Accepts a code string and optional style rules, processes indentation, spacing, and line breaks, and returns the formatted function code as a string.", + "category": "api-integration", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The raw function code to format as a string, including function signature and body.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the input code; supports 'js' for JavaScript or 'ts' for TypeScript for proper parsing.", + "required": false, + "defaultValue": "js" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use per indentation level in the formatted output.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "braceStyle", + "type": "string", + "description": "Style of braces placement; options are '1tbs' (one true brace style), 'allman', or 'stroustrup'.", + "required": false, + "defaultValue": "1tbs" + }, + { + "name": "semiColons", + "type": "boolean", + "description": "Whether to add semicolons at the end of statements.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum line length before attempting to wrap lines for readability.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function code string under the 'formattedCode' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate, clean up, or standardize JavaScript or TypeScript function code snippets before further processing, review, or integration. It ensures consistent coding style for better readability and reduces syntax formatting errors.", + "limitations": "This tool formats only strings containing single function definitions. It does not validate logic correctness, handle multiple functions in one string, or format entire files or unrelated code snippets.", + "examples": [ + "Format raw JS function code with default options.", + "Format a TypeScript function using tabs and Allman braces style.", + "Format JavaScript code with a max line length of 100 and no semicolons." + ] + }, + "tags": [ + "api-integration", + "formatting", + "code", + "javascript", + "typescript", + "function", + "style" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function greet(name){console.log('Hello, '+name);} \\n\",\"language\":\"js\"}", + "description": "Format a basic JavaScript function with default options." + }, + { + "inputJson": "{\"code\":\"function add(a: number, b: number): number{return a+b;}\",\"language\":\"ts\",\"indentSize\":4,\"useTabs\":true,\"braceStyle\":\"allman\"}", + "description": "Format a TypeScript function using tabs for indentation and Allman brace style." + }, + { + "inputJson": "{\"code\":\"const multiply=(x,y)=>{return x*y}\",\"semiColons\":false,\"maxLineLength\":100}", + "description": "Format a JavaScript arrow function without semicolons and with a longer allowed line length." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "api-integration.createEvent", + "description": "Creates a new analytics event by sending structured event data to a specified API endpoint. Accepts event name, properties, user identifiers, and timestamps, processes these to build a valid API request, and returns the API response confirming event creation or providing error details.", + "category": "api-integration", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the event to create, e.g., 'page_view' or 'purchase'.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventProperties", + "type": "object", + "description": "A key-value map of properties describing the event context, such as product ID or page URL.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier of the user associated with the event.", + "required": false, + "defaultValue": "" + }, + { + "name": "anonymousId", + "type": "string", + "description": "Anonymous identifier when userId is not available.", + "required": false, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 timestamp of when the event occurred. Defaults to current time if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "apiEndpoint", + "type": "string", + "description": "URL of the analytics API endpoint to receive the event.", + "required": true, + "defaultValue": "" + }, + { + "name": "apiKey", + "type": "string", + "description": "Secret or public API key/token used for authenticating to the API.", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "API response object indicating success status, event ID if created, or error details if failed." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically record user interaction events into analytics platforms by integrating with their HTTP APIs. Enables real-time event tracking, user behavior analysis, and funnel monitoring within automated workflows.", + "limitations": "This tool assumes the target API accepts JSON formatted event data and uses a key/token for authentication. It does not handle batch event uploads or retries on network failure. It cannot validate event schema beyond basic types.", + "examples": [ + "Create a 'signup' event with userId and user traits.", + "Send a 'purchase' event including product details, timestamp, and anonymousId.", + "Submit 'page_view' event with URL and referrer properties to a custom analytics API." + ] + }, + "tags": [ + "api", + "analytics", + "event", + "tracking", + "integration", + "automation" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"signup\",\"eventProperties\":{\"plan\":\"premium\",\"referrer\":\"ad_campaign\"},\"userId\":\"user_1234\",\"apiEndpoint\":\"https://analytics.example.com/events\",\"apiKey\":\"abcd1234\"}", + "description": "Create a signup event for user user_1234 with plan and referrer details." + }, + { + "inputJson": "{\"eventName\":\"purchase\",\"eventProperties\":{\"productId\":\"sku_456\",\"price\":19.99},\"anonymousId\":\"anon_xyz\",\"timestamp\":\"2024-05-01T14:30:00Z\",\"apiEndpoint\":\"https://analytics.example.com/events\",\"apiKey\":\"abcd1234\"}", + "description": "Send purchase event with product details and anonymous user ID at a specific time." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "api-integration.createNotification", + "description": "Creates and sends a customizable notification through specified communication channels (e.g., email, SMS, push). Accepts inputs like recipient details, message content, notification type, and delivery options. Processes content formatting and routing, then outputs a confirmation with status and message ID.", + "category": "api-integration", + "parameters": [ + { + "name": "recipient", + "type": "object", + "description": "Recipient details including contact info such as email address or phone number.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The notification message content to be sent to the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "notificationType", + "type": "string", + "description": "Type of notification to send (e.g., email, sms, push).", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line for notifications that support it (e.g., email).", + "required": false, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification (e.g., normal, high).", + "required": false, + "defaultValue": "normal" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 datetime to schedule notification delivery in future.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional metadata or custom tags to associate with the notification.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing notificationId, status (e.g., sent, scheduled, failed), and optional error message if sending failed." + }, + "aiAgent": { + "useCase": "Use when needing to send automated or user-triggered notifications through various channels, such as alerts, reminders, or confirmations. Helps automate communication workflows by specifying message details and delivery preferences.", + "limitations": "Cannot guarantee message delivery due to external channel constraints; does not handle complex multi-channel orchestration beyond single notification requests.", + "examples": [ + "Send a reminder email to a user about an upcoming appointment.", + "Notify a customer via SMS about a shipment delivery status.", + "Create a scheduled push notification for a mobile app update alert." + ] + }, + "tags": [ + "notification", + "messaging", + "api-integration", + "communication", + "alert", + "reminder", + "scheduler" + ], + "examples": [ + { + "inputJson": "{\"recipient\":{\"email\":\"user@example.com\"},\"message\":\"Your appointment is tomorrow at 10 AM.\",\"notificationType\":\"email\",\"subject\":\"Appointment Reminder\",\"priority\":\"high\"}", + "description": "Send a high priority email reminder about appointment." + }, + { + "inputJson": "{\"recipient\":{\"phoneNumber\":\"+1234567890\"},\"message\":\"Your package has been shipped.\",\"notificationType\":\"sms\"}", + "description": "Send an SMS notification about package shipment." + }, + { + "inputJson": "{\"recipient\":{\"deviceToken\":\"abc123token\"},\"message\":\"Update available! Please restart the app.\",\"notificationType\":\"push\",\"scheduleTime\":\"2024-07-01T09:00:00Z\"}", + "description": "Schedule a push notification for a mobile app update alert." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Notification", + "context": null + } + }, + { + "name": "api-integration.createCSV", + "description": "Generates a CSV string from structured data input. Accepts an array of objects representing rows with key-value pairs as columns. Converts the data into properly escaped CSV format, optionally including headers. Returns the CSV content as a string for saving or transmitting.", + "category": "api-integration", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects where each object represents a row with key-value pairs for columns.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include a header row with column names derived from the keys of the first data object.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate columns in the CSV output, typically a comma or semicolon.", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteChar", + "type": "string", + "description": "Character used to quote fields containing special characters, usually a double quote.", + "required": false, + "defaultValue": "\"" + }, + { + "name": "lineEnding", + "type": "string", + "description": "String used to separate lines, usually '\\n' or '\\r\\n'.", + "required": false, + "defaultValue": "\\n" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated CSV string as the 'csv' property." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert JSON or array of object data into CSV format for easy export, data exchange, or integration with systems that consume CSV. Useful in API orchestration where structured data is transformed into CSV format before transmission or storage.", + "limitations": "Does not support nested objects or arrays within fields; all values should be primitives or convertible to strings. Does not handle streaming large datasets efficiently; best for moderate-sized arrays.", + "examples": [ + "Convert an array of user data objects to CSV for download.", + "Generate CSV report data with custom delimiter and without headers." + ] + }, + "tags": [ + "api-integration", + "csv", + "data-conversion", + "export", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"includeHeaders\":true}", + "description": "Convert user info array to CSV with headers." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Book\",\"price\":12.5},{\"product\":\"Pen\",\"price\":1.2}],\"includeHeaders\":false,\"delimiter\":\";\"}", + "description": "Create CSV from product data without headers and with semicolon delimiter." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "CSV", + "context": null + } + }, + { + "name": "api-integration.createEndpoint", + "description": "Creates a new API endpoint configuration by accepting parameters such as HTTP method, URL path, authentication settings, request and response schemas. The tool processes these inputs and generates a structured endpoint definition object suitable for integration or deployment in API gateways or backend services.", + "category": "api-integration", + "parameters": [ + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method for the endpoint, e.g., GET, POST, PUT, DELETE.", + "required": true, + "defaultValue": "" + }, + { + "name": "path", + "type": "string", + "description": "URL path for the endpoint, starting with '/'.", + "required": true, + "defaultValue": "" + }, + { + "name": "authenticationType", + "type": "string", + "description": "Type of authentication required, e.g., 'none', 'apiKey', 'oauth2'.", + "required": false, + "defaultValue": "none" + }, + { + "name": "requestSchema", + "type": "object", + "description": "JSON schema defining the expected request body structure. Required only if the method supports a body (POST, PUT, PATCH).", + "required": false, + "defaultValue": "" + }, + { + "name": "responseSchema", + "type": "object", + "description": "JSON schema describing the structure of the response returned by the endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Timeout in seconds for endpoint requests before responding with an error.", + "required": false, + "defaultValue": "30" + }, + { + "name": "enableCORS", + "type": "boolean", + "description": "Flag indicating whether Cross-Origin Resource Sharing is enabled for the endpoint.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A structured object representing the configured API endpoint, including method, path, auth settings, and schemas, ready for use in API gateway or backend integration." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically define or register new API endpoints in a standardized format. It helps in scenarios where an AI agent orchestrates or automates API creation by generating endpoint definitions with appropriate methods, paths, authentication, and data schemas.", + "limitations": "This tool does not deploy the endpoint or implement backend logic. It only creates the configuration object defining the endpoint properties.", + "examples": [ + "Create a POST endpoint for user registration with OAuth2 authentication and JSON request/response schemas.", + "Define a simple public GET endpoint at '/status' without authentication that returns a health check JSON.", + "Create a PUT endpoint with API key required and a request schema for updating user profiles." + ] + }, + "tags": [ + "api", + "endpoint", + "automation", + "integration", + "configuration", + "http", + "schema" + ], + "examples": [ + { + "inputJson": "{\"httpMethod\":\"POST\",\"path\":\"/users/register\",\"authenticationType\":\"oauth2\",\"requestSchema\":{\"type\":\"object\",\"properties\":{\"email\":{\"type\":\"string\"},\"password\":{\"type\":\"string\"}},\"required\":[\"email\",\"password\"]},\"responseSchema\":{\"type\":\"object\",\"properties\":{\"userId\":{\"type\":\"string\"},\"createdAt\":{\"type\":\"string\"}}},\"timeoutSeconds\":60,\"enableCORS\":true}", + "description": "Creating a POST user registration endpoint with OAuth2 auth, request and response JSON schemas, 60s timeout, and CORS enabled." + }, + { + "inputJson": "{\"httpMethod\":\"GET\",\"path\":\"/status\",\"authenticationType\":\"none\",\"responseSchema\":{\"type\":\"object\",\"properties\":{\"status\":{\"type\":\"string\"}}},\"enableCORS\":false}", + "description": "Defining a public GET status endpoint with no authentication and a simple response schema." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Endpoint", + "context": null + } + }, + { + "name": "api-integration.createSummary", + "description": "This tool accepts raw textual content from various document sources via API integration, processes it using natural language processing techniques to extract key points, and generates a coherent and concise summary. It outputs a summary text that captures the main ideas, enabling easier information consumption and review.", + "category": "api-integration", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "The full text content of the document to summarize.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "Maximum length of the summary in number of characters or words (depending on implementation).", + "required": false, + "defaultValue": "300" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input document to optimize processing and ensure summary relevance.", + "required": false, + "defaultValue": "en" + }, + { + "name": "summaryType", + "type": "string", + "description": "Type of summary desired, such as 'extractive' or 'abstractive'.", + "required": false, + "defaultValue": "abstractive" + }, + { + "name": "includeHighlights", + "type": "boolean", + "description": "Whether to include highlighted key sentences from the original document in the output summary.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text and optional highlights." + }, + "aiAgent": { + "useCase": "Use this tool when an application or user needs a concise summary of lengthy text data from integrated API sources such as articles, reports, or documents. It helps reduce information overload by extracting essential points and presenting a brief, readable synopsis. Ideal for knowledge management, reporting, or content previews.", + "limitations": "Cannot guarantee perfect accuracy or completeness of summaries, especially on highly technical or ambiguous texts. It may miss subtle nuances or omit significant details not well represented in the text. Not suitable for legal or medical documents requiring expert validation.", + "examples": [ + "Summarize a long news article fetched via an API for quick reading.", + "Generate a brief summary of customer feedback responses collected from multiple platforms.", + "Create an executive summary of a lengthy project report retrieved from cloud storage." + ] + }, + "tags": [ + "api", + "summary", + "text-processing", + "nlp", + "document", + "integration", + "abstractive", + "extractive" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"Artificial intelligence (AI) is a branch of computer science focused on building smart machines capable of performing tasks that typically require human intelligence. AI applications include expert systems, natural language processing, speech recognition, computer vision, and robotics.\",\"maxSummaryLength\":150,\"language\":\"en\",\"summaryType\":\"abstractive\",\"includeHighlights\":false}", + "description": "Summarize a short informational text about artificial intelligence to generate a concise overview." + }, + { + "inputJson": "{\"documentText\":\"[Long customer feedback data text from multiple API sources concatenated]\",\"maxSummaryLength\":200,\"language\":\"en\",\"summaryType\":\"extractive\",\"includeHighlights\":true}", + "description": "Generate an extractive summary with highlights of key sentences for a large set of customer feedback." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "api-integration.createInvoice", + "description": "Creates a new invoice by accepting invoice details such as customer information, line items, billing terms, and tax details. Processes the input to generate a structured invoice record and returns the invoice ID along with a summary of the created invoice.", + "category": "api-integration", + "parameters": [ + { + "name": "customerId", + "type": "string", + "description": "Unique identifier of the customer to bill.", + "required": true, + "defaultValue": "" + }, + { + "name": "lineItems", + "type": "array", + "description": "List of items or services to invoice, each with description, quantity, and unit price.", + "required": true, + "defaultValue": "" + }, + { + "name": "invoiceDate", + "type": "string", + "description": "Date when the invoice is issued, in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "dueDate", + "type": "string", + "description": "Payment due date in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code for invoice amounts, e.g., USD or EUR.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "taxPercent", + "type": "number", + "description": "Applicable tax percentage to apply on the subtotal.", + "required": false, + "defaultValue": "0" + }, + { + "name": "notes", + "type": "string", + "description": "Optional additional notes to include on the invoice.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the invoiceId, a summary including total amount, and confirmation status of creation." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to generate a new invoice record in an integrated accounting or invoicing system by providing necessary billing details and line items. It helps automate invoice creation workflows and integrates billing data.", + "limitations": "This tool does not handle payment processing, customer creation, or invoice modification after creation. It assumes valid and complete input data is provided.", + "examples": [ + "Create an invoice for customer 12345 with 3 line items and 10% tax.", + "Generate an invoice dated today with payment due in 30 days for services rendered.", + "Create a USD invoice with specific notes included for the client." + ] + }, + "tags": [ + "api", + "invoice", + "billing", + "finance", + "integration", + "automation" + ], + "examples": [ + { + "inputJson": "{\"customerId\":\"cust-001\",\"lineItems\":[{\"description\":\"Consulting services\",\"quantity\":10,\"unitPrice\":150},{\"description\":\"Software license\",\"quantity\":1,\"unitPrice\":1200}],\"invoiceDate\":\"2024-06-15\",\"dueDate\":\"2024-07-15\",\"currency\":\"USD\",\"taxPercent\":10,\"notes\":\"Thank you for your business.\"}", + "description": "Create a detailed invoice for a consulting engagement with applicable tax and notes." + }, + { + "inputJson": "{\"customerId\":\"cust-999\",\"lineItems\":[{\"description\":\"Annual maintenance plan\",\"quantity\":1,\"unitPrice\":500}],\"currency\":\"EUR\",\"taxPercent\":20}", + "description": "Create a single-item EUR invoice applying 20% VAT tax without specific dates." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "agent-management.formatContract", + "description": "Formats legal contract documents by applying specified style guidelines such as font, spacing, and section numbering to an input contract text, producing a clean, standardized formatted contract document in either plain text or PDF format.", + "category": "agent-management", + "parameters": [ + { + "name": "contractText", + "type": "string", + "description": "The raw contract text content to be formatted, including clauses and sections.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "object", + "description": "Object specifying style settings such as fontFamily, fontSize, lineSpacing, and sectionNumbering style.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the formatted contract, e.g., 'text' or 'pdf'.", + "required": false, + "defaultValue": "text" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents based on contract sections.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the contract for locale-specific formatting (e.g., 'en', 'fr').", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted contract content as a string, along with metadata such as format and page count." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce standardized, professionally formatted legal contract documents from raw text inputs, ensuring consistent styling and structure for review or presentation.", + "limitations": "Cannot interpret or validate legal content meaning; focuses solely on formatting. Complex formatting beyond basic style guides may not be supported.", + "examples": [ + "Format this contract text into a PDF with Arial font, 12pt, and numbered sections.", + "Generate a clean formatted version of the given contract text with a table of contents included.", + "Convert this raw contract text to a plain text file applying double line spacing and Times New Roman font." + ] + }, + "tags": [ + "legal", + "document", + "formatting", + "contract", + "style", + "pdf", + "text" + ], + "examples": [ + { + "inputJson": "{\"contractText\":\"Section 1: Agreement\\nThis Agreement is made between...\",\"styleGuide\":{\"fontFamily\":\"Arial\",\"fontSize\":12,\"lineSpacing\":1.5,\"sectionNumbering\":\"numeric\"},\"outputFormat\":\"pdf\",\"includeTableOfContents\":true,\"language\":\"en\"}", + "description": "Format a contract text with Arial font, 12pt size, 1.5 line spacing, numeric section numbering, include TOC, output as PDF." + }, + { + "inputJson": "{\"contractText\":\"Clause A: Confidentiality\\nThe parties agree...\",\"styleGuide\":{\"fontFamily\":\"Times New Roman\",\"fontSize\":11,\"lineSpacing\":2.0},\"outputFormat\":\"text\",\"includeTableOfContents\":false,\"language\":\"en\"}", + "description": "Format contract clauses to plain text with Times New Roman font, 11pt, double spaced, no TOC." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Contract", + "context": null + } + }, + { + "name": "agent-management.generateArticle", + "description": "Generates a detailed article based on a given topic or summary by leveraging AI-powered natural language processing. Accepts parameters for topic, desired length, style, and target audience to produce coherent, structured, and informative articles as output.", + "category": "agent-management", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or theme of the article to be generated. Required to focus the content.", + "required": true, + "defaultValue": "" + }, + { + "name": "summary", + "type": "string", + "description": "Optional brief summary or bullet points to guide the article content and structure.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the article in number of words. Helps adjust detail level and depth.", + "required": false, + "defaultValue": "500" + }, + { + "name": "style", + "type": "string", + "description": "Writing style or tone of the article (e.g., formal, casual, technical, persuasive).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Defines the intended reader group to tailor the language and complexity (e.g., general public, experts, students).", + "required": false, + "defaultValue": "general public" + }, + { + "name": "includeReferences", + "type": "boolean", + "description": "Whether the article should include references or citations where applicable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article text and metadata such as length and style." + }, + "aiAgent": { + "useCase": "Use this tool when there is a need to automatically generate full-length articles or comprehensive documents on a specific topic based on minimal input, ideal for content creation, briefing reports, or knowledge bases.", + "limitations": "Cannot guarantee factual accuracy or cite real-time data unless references are specifically included. May produce generic or repetitive content for very narrow topics.", + "examples": [ + "Generate an article about renewable energy advantages.", + "Create a 1000-word technical article on machine learning applications for students.", + "Write a casual style article on the benefits of meditation for general readers." + ] + }, + "tags": [ + "article generation", + "content creation", + "AI writing", + "document generation", + "natural language processing", + "agent-management" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Benefits of electric vehicles\",\"length\":700,\"style\":\"formal\",\"targetAudience\":\"general public\",\"includeReferences\":true}", + "description": "Generate a 700-word formal article aimed at the general public about the benefits of electric vehicles, including references." + }, + { + "inputJson": "{\"topic\":\"Deep learning in medical imaging\",\"summary\":\"Explain how deep learning improves diagnosis accuracy\",\"length\":1000,\"style\":\"technical\",\"targetAudience\":\"experts\",\"includeReferences\":true}", + "description": "Create a 1000-word technical article for experts on deep learning applications in medical imaging with citations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Article", + "context": null + } + }, + { + "name": "prompt-engineering.sendMessage", + "description": "This tool sends a crafted prompt message to a specified AI model or chat API endpoint. It accepts the message text, target model identifier, and optional context or conversation history, then transmits this information, returning the AI's response message and metadata about the interaction.", + "category": "prompt-engineering", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The prompt or message text to send to the AI model.", + "required": true, + "defaultValue": "" + }, + { + "name": "modelId", + "type": "string", + "description": "Identifier of the target AI model or chat endpoint to receive the message (e.g., 'gpt-4', 'chat-bot-v1').", + "required": true, + "defaultValue": "" + }, + { + "name": "conversationContext", + "type": "array", + "description": "Optional array of previous message objects to provide conversation history context. Each object should have 'role' and 'content' fields.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxTokens", + "type": "number", + "description": "Maximum number of tokens to generate in the response. Helps control response length.", + "required": false, + "defaultValue": "512" + }, + { + "name": "temperature", + "type": "number", + "description": "Sampling temperature for response generation, controlling randomness (0.0-1.0).", + "required": false, + "defaultValue": "0.7" + } + ], + "returns": { + "type": "object", + "description": "An object containing the AI's response message, including text content, token usage, and response metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically send a prompt message to an AI language model or chat-based API to obtain a text response, including scenarios of multi-turn conversations or dynamic prompt testing.", + "limitations": "This tool does not perform prompt crafting or optimization by itself; it only sends messages to given AI endpoints and returns responses. It cannot validate message content or handle non-text modalities.", + "examples": [ + "Send a customer support prompt to GPT-4 to get an answer.", + "Continue a multi-turn chat conversation by sending the updated conversation context.", + "Test different prompts on various AI models to compare responses." + ] + }, + "tags": [ + "prompt", + "message", + "AI", + "chat", + "language-model", + "conversational", + "API" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"Hello, how can I improve my writing skills?\",\"modelId\":\"gpt-4\",\"conversationContext\":[],\"maxTokens\":200,\"temperature\":0.5}", + "description": "Sending a single prompt message to GPT-4 asking for writing skill improvement advice." + }, + { + "inputJson": "{\"messageText\":\"Thanks! Can you give me an example exercise?\",\"modelId\":\"chat-bot-v1\",\"conversationContext\":[{\"role\":\"user\",\"content\":\"Hello, how can I improve my writing skills?\"},{\"role\":\"assistant\",\"content\":\"Practice daily and read more books.\"}],\"maxTokens\":150,\"temperature\":0.7}", + "description": "Continuing a chat conversation by providing previous messages as context for a coherent reply." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Message", + "context": null + } + }, + { + "name": "prompt-engineering.formatFunction", + "description": "Formats a given code function string according to specified style conventions such as indentation, brace style, and line width. Accepts raw function code as input and produces a cleaned, consistently formatted function code string as output, improving readability and maintainability.", + "category": "prompt-engineering", + "parameters": [ + { + "name": "functionCode", + "type": "string", + "description": "Raw source code of the function to format, as a single string.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the function code (e.g., 'javascript', 'python'), used to apply language-specific formatting rules.", + "required": false, + "defaultValue": "javascript" + }, + { + "name": "indentStyle", + "type": "string", + "description": "Indentation style to use, such as 'spaces' or 'tabs'.", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces or tabs per indentation level.", + "required": false, + "defaultValue": "2" + }, + { + "name": "braceStyle", + "type": "string", + "description": "Brace style to apply for block openings, e.g., '1tbs', 'allman', or 'stroustrup'.", + "required": false, + "defaultValue": "1tbs" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed line length to wrap lines appropriately for readability.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function code string under the 'formattedCode' key." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to standardize or beautify function code, making it easier to read, review, or further process as part of prompt engineering or code generation tasks. It helps enforce consistent style conventions automatically, especially when working across multiple languages or formatting preferences.", + "limitations": "Does not perform syntax validation or fixes beyond formatting. It assumes the input is valid code in the specified language. It may not support all programming languages or complex language-specific formatting nuances.", + "examples": [ + "Format a JavaScript function with spaces and 2-space indentation.", + "Format a Python function using tabs and Allman brace style (for languages that support braces).", + "Format a function to wrap lines longer than 100 characters." + ] + }, + "tags": [ + "formatting", + "code", + "function", + "style", + "prompt-engineering", + "beautify" + ], + "examples": [ + { + "inputJson": "{\"functionCode\":\"function add(a,b){return a+b;}\",\"language\":\"javascript\",\"indentStyle\":\"spaces\",\"indentSize\":2,\"braceStyle\":\"1tbs\",\"maxLineLength\":80}", + "description": "Format a simple JavaScript function using 2 spaces indentation and 1TBS brace style." + }, + { + "inputJson": "{\"functionCode\":\"def add(a,b):\\n return a+b\",\"language\":\"python\",\"indentStyle\":\"spaces\",\"indentSize\":4,\"maxLineLength\":80}", + "description": "Format a Python function with 4 spaces indentation and default brace style." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "model-management.analyzeOpportunity", + "description": "Analyzes a potential business opportunity for AI model development and deployment by evaluating market data, resource requirements, and expected ROI. It accepts inputs such as opportunity description, market size, competition metrics, and resource constraints, then outputs a detailed analysis report including risk assessment, feasibility score, and recommendations.", + "category": "model-management", + "parameters": [ + { + "name": "opportunityDescription", + "type": "string", + "description": "Detailed description of the business opportunity to analyze", + "required": true, + "defaultValue": "" + }, + { + "name": "marketSizeEstimate", + "type": "number", + "description": "Estimated size of the target market in monetary terms (e.g., USD)", + "required": true, + "defaultValue": "" + }, + { + "name": "competitionLevel", + "type": "string", + "description": "Level of competition in the market segment (e.g., 'low', 'medium', 'high')", + "required": true, + "defaultValue": "" + }, + { + "name": "resourceAvailability", + "type": "object", + "description": "Available internal resources for the project, including team size, budget, and infrastructure", + "required": true, + "defaultValue": "" + }, + { + "name": "expectedROI", + "type": "number", + "description": "Expected return on investment percentage", + "required": false, + "defaultValue": "0" + }, + { + "name": "timeFrameMonths", + "type": "number", + "description": "Time frame in months to achieve ROI and market entry", + "required": false, + "defaultValue": "12" + } + ], + "returns": { + "type": "object", + "description": "A structured report containing feasibility score, risk factors, recommended actions, and summary insights" + }, + "aiAgent": { + "useCase": "Use this tool when evaluating new AI product or project ideas to assess their market viability, resource fit, and risks before committing to development. It helps prioritize opportunities based on quantitative and qualitative analysis.", + "limitations": "Does not provide precise financial forecasts or replace detailed market studies. Relies on input accuracy and may not capture external market disruptions.", + "examples": [ + "Analyze a new AI-powered customer support chatbot opportunity with medium competition and limited resources", + "Evaluate if developing an AI-based medical imaging tool with high competition but large market size is viable within a 18-month timeframe" + ] + }, + "tags": [ + "analysis", + "business", + "opportunity", + "model-management", + "feasibility", + "risk-assessment" + ], + "examples": [ + { + "inputJson": "{\"opportunityDescription\":\"Develop AI-driven chatbot for e-commerce customer support\",\"marketSizeEstimate\":50000000,\"competitionLevel\":\"medium\",\"resourceAvailability\":{\"teamSize\":5,\"budget\":200000,\"infrastructure\":\"cloud\"},\"expectedROI\":15,\"timeFrameMonths\":12}", + "description": "Evaluating a chatbot AI opportunity with moderate competition and limited resources" + }, + { + "inputJson": "{\"opportunityDescription\":\"AI diagnostic tool for radiology scans\",\"marketSizeEstimate\":200000000,\"competitionLevel\":\"high\",\"resourceAvailability\":{\"teamSize\":10,\"budget\":1000000,\"infrastructure\":\"on-premise\"},\"expectedROI\":25,\"timeFrameMonths\":24}", + "description": "Analyzing a competitive but high-value AI healthcare product opportunity" + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Opportunity", + "context": null + } + }, + { + "name": "model-management.analyzeTable", + "description": "Analyzes tabular datasets to extract key statistical summaries, identify data distributions, detect missing values, and highlight potential outliers. Accepts structured table data (e.g., CSV or JSON array of records) and returns a detailed report including column-wise statistics and data quality metrics, aiding data understanding for model training and evaluation.", + "category": "model-management", + "parameters": [ + { + "name": "tableData", + "type": "array", + "description": "An array of objects representing the tabular dataset rows, with keys as column names. Required for analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "columnsToAnalyze", + "type": "array", + "description": "Optional list of column names to limit the analysis; if not provided, all columns are analyzed.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCorrelations", + "type": "boolean", + "description": "Whether to calculate pairwise correlation coefficients between numeric columns. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "missingValueStrategy", + "type": "string", + "description": "Strategy to handle missing values during analysis: 'ignore' (default), 'count', or 'impute'.", + "required": false, + "defaultValue": "ignore" + }, + { + "name": "outlierDetectionMethod", + "type": "string", + "description": "Method used to detect outliers: 'iqr' (Interquartile Range, default) or 'zscore'.", + "required": false, + "defaultValue": "iqr" + }, + { + "name": "maxUniqueValuesForCategorical", + "type": "number", + "description": "Maximum number of unique values to treat a column as categorical for summary. Defaults to 50.", + "required": false, + "defaultValue": "50" + } + ], + "returns": { + "type": "object", + "description": "Comprehensive report object containing summaries per column such as count, mean, median, mode, std deviation, missing value counts, outliers list; plus pairwise correlations if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing an in-depth statistical and data quality analysis of tabular datasets before training or deploying AI models. It helps reveal data distributions, identify issues like missing or anomalous data, and provides summary statistics to guide feature engineering and model building.", + "limitations": "Does not perform data cleaning, model training, or visualization. Large datasets may require substantial memory and processing time. Correlation analysis is limited to numeric columns only.", + "examples": [ + "Analyze a tabular dataset to understand its statistical properties and check for missing values.", + "Determine outlier rows in sensor readings stored in JSON array format before model training.", + "Get correlation metrics between numeric features to assist in feature selection." + ] + }, + "tags": [ + "analysis", + "model-data", + "statistics", + "data-quality", + "tabular-data", + "machine-learning" + ], + "examples": [ + { + "inputJson": "{\"tableData\":[{\"age\":30,\"income\":50000,\"gender\":\"M\"},{\"age\":25,\"income\":48000,\"gender\":\"F\"},{\"age\":40,\"income\":62000,\"gender\":\"F\"},{\"age\":null,\"income\":52000,\"gender\":\"M\"}],\"includeCorrelations\":true}", + "description": "Analyze demographic data with incomes and genders, including correlation between numeric columns." + }, + { + "inputJson": "{\"tableData\":[{\"temperature\":22.5,\"humidity\":30},{\"temperature\":null,\"humidity\":35},{\"temperature\":20.1,\"humidity\":28}],\"missingValueStrategy\":\"count\",\"outlierDetectionMethod\":\"zscore\"}", + "description": "Analyze environmental sensor data counting missing values and detecting outliers using z-score method." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Table", + "context": null + } + }, + { + "name": "model-management.formatJSON", + "description": "Formats JSON strings related to AI models and configurations for improved readability or compactness. Accepts raw JSON string input and outputs a formatted JSON string with customizable indentation and sorting options.", + "category": "model-management", + "parameters": [ + { + "name": "jsonString", + "type": "string", + "description": "The raw JSON string representing model configurations or metadata that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted JSON output.", + "required": false, + "defaultValue": "2" + }, + { + "name": "sortKeys", + "type": "boolean", + "description": "Flag to enable sorting of JSON object keys alphabetically in the output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "compact", + "type": "boolean", + "description": "If true, outputs compact JSON without spaces or newlines, ignoring indentation and sorting.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted JSON string under 'formattedJson' key, preserving valid JSON structure." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to ensure JSON configurations, model parameters, or metadata are human-readable or standardized before deployment, storage, or logging. It is helpful for validating format consistency or transforming compact JSON into pretty-printed form and vice versa.", + "limitations": "This tool only formats JSON strings; it does not validate schema correctness or semantic integrity of JSON content, nor does it parse JSON into objects beyond formatting purposes.", + "examples": [ + "Format a raw JSON string of model metadata with 4 spaces indentation for better readability.", + "Convert a pretty-printed JSON to compact form for efficient storage or transmission.", + "Sort JSON keys alphabetically to maintain consistent formatting in configuration files." + ] + }, + "tags": [ + "formatting", + "json", + "model-management", + "configuration", + "readability", + "serialization" + ], + "examples": [ + { + "inputJson": "{\"jsonString\":\"{\\\"modelName\\\":\\\"GPT-4\\\",\\\"version\\\":1,\\\"parameters\\\":{\\\"layers\\\":96,\\\"units\\\":12288}}\",\"indentation\":4,\"sortKeys\":true,\"compact\":false", + "description": "Pretty-print model configuration JSON with 4 spaces indentation and keys sorted alphabetically." + }, + { + "inputJson": "{\"jsonString\":\"{\\\"version\\\":1,\\\"parameters\\\":{\\\"units\\\":12288,\\\"layers\\\":96},\\\"modelName\\\":\\\"GPT-4\\\"}\",\"compact\":true}", + "description": "Compact the same JSON string by removing all unnecessary whitespace." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "JSON", + "context": null + } + }, + { + "name": "model-management.composeText", + "description": "This tool generates coherent and contextually relevant text by composing multiple input prompts and optional context metadata. It accepts an array of prompt strings, optional style and length parameters, and produces composed text output that can be used for content generation, summarization, or creative writing tasks.", + "category": "model-management", + "parameters": [ + { + "name": "prompts", + "type": "array", + "description": "An array of text prompts or partial inputs to be composed into a single output text.", + "required": true, + "defaultValue": "" + }, + { + "name": "contextMetadata", + "type": "object", + "description": "Optional metadata to guide text composition, such as topic, tone, or target audience.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the composed text output in tokens or words. Controls output size.", + "required": false, + "defaultValue": "500" + }, + { + "name": "style", + "type": "string", + "description": "Optional writing style to apply to the composed text, e.g., formal, casual, technical.", + "required": false, + "defaultValue": "" + }, + { + "name": "temperature", + "type": "number", + "description": "Controls randomness in text generation; higher values produce more creative outputs.", + "required": false, + "defaultValue": "0.7" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed text output as a single string and metadata about the generation process." + }, + "aiAgent": { + "useCase": "Use this tool when multiple text prompts must be combined into a cohesive passage, such as generating reports, articles, or creative writing where several inputs contribute to the final output. It supports refinements via style, length, and contextual metadata to customize output tone and detail.", + "limitations": "This tool cannot verify factual accuracy or generate guaranteed error-free text. It may produce plausible-sounding but incorrect or biased content. Complex domain-specific synthesis may require specialized models outside this generic composer.", + "examples": [ + "Compose a summary from these bullet points.", + "Generate a formal email combining these content snippets.", + "Create a short story combining these thematic prompts." + ] + }, + "tags": [ + "text-generation", + "composition", + "content-creation", + "model-management", + "writing", + "nlp" + ], + "examples": [ + { + "inputJson": "{\"prompts\":[\"Market trends indicate a rise in AI adoption.\",\"Customer feedback highlights usability concerns.\"],\"contextMetadata\":{\"topic\":\"AI technology adoption\",\"tone\":\"professional\"},\"maxLength\":150,\"style\":\"formal\",\"temperature\":0.5}", + "description": "Compose a formal professional summary combining market trends and customer feedback about AI adoption." + }, + { + "inputJson": "{\"prompts\":[\"Once upon a time in a distant galaxy\", \"a brave explorer set out on a quest.\"],\"style\":\"creative\",\"temperature\":0.9}", + "description": "Generate a creative story text by composing two narrative prompts with a high creativity setting." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Text", + "context": null + } + }, + { + "name": "model-management.draftReport", + "description": "Generates a detailed model evaluation report by analyzing input model metadata, performance metrics, and training logs. Produces a structured document summarizing model architecture, training parameters, evaluation results, and recommendations for deployment or improvement.", + "category": "model-management", + "parameters": [ + { + "name": "modelMetadata", + "type": "object", + "description": "Metadata of the AI model including architecture details and version info.", + "required": true, + "defaultValue": "" + }, + { + "name": "performanceMetrics", + "type": "object", + "description": "Quantitative evaluation results such as accuracy, loss, precision, recall, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "trainingLogs", + "type": "string", + "description": "Optional logs or textual summaries from the model training process.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Desired output format of the report document (e.g., pdf, markdown, html).", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include deployment and improvement recommendations in the report.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A structured report document containing summarized model details, evaluation analysis, and optionally recommendations, formatted as specified." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a comprehensive evaluation report about a trained model's performance and training process, helping stakeholders understand model quality and deployment readiness. This is useful during model validation, audit, or documentation phases.", + "limitations": "This tool does not perform model training or evaluation itself; it requires supplied metadata and metrics. It cannot interpret raw model weights or logs without structured input.", + "examples": [ + "Draft a PDF report summarizing the latest model's architecture, evaluation metrics, and training logs including recommendations.", + "Generate a markdown report for version 2.0 of the model excluding recommendations.", + "Produce an HTML model report including training log details." + ] + }, + "tags": [ + "model", + "report", + "evaluation", + "documentation", + "performance", + "mlops", + "training" + ], + "examples": [ + { + "inputJson": "{\"modelMetadata\":{\"name\":\"ResNet50\",\"version\":\"1.0\",\"layers\":50,\"parameters\":25557032},\"performanceMetrics\":{\"accuracy\":0.932,\"loss\":0.23,\"precision\":0.91,\"recall\":0.89},\"trainingLogs\":\"Training completed in 12 hours with early stopping.\",\"reportFormat\":\"pdf\",\"includeRecommendations\":true}", + "description": "Generate a detailed PDF report including metrics and training log for ResNet50 model version 1.0." + }, + { + "inputJson": "{\"modelMetadata\":{\"name\":\"TransformerXL\",\"version\":\"2.1\",\"parameters\":151000000},\"performanceMetrics\":{\"accuracy\":0.87,\"loss\":0.45},\"reportFormat\":\"markdown\",\"includeRecommendations\":false}", + "description": "Create a markdown report without recommendations summarizing TransformerXL model version 2.1 key metrics." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Report", + "context": null + } + }, + { + "name": "model-management.createDashboard", + "description": "Creates a customizable AI model monitoring dashboard by accepting configuration inputs such as model IDs, metric types, refresh interval, and display format. Processes these inputs to aggregate and visualize model performance metrics over time, enabling stakeholders to review model health and analytics in a consolidated dashboard view. Outputs a dashboard configuration object and URL for access.", + "category": "model-management", + "parameters": [ + { + "name": "modelIds", + "type": "array", + "description": "List of AI model identifiers to include in the dashboard for monitoring", + "required": true, + "defaultValue": "[]" + }, + { + "name": "metrics", + "type": "array", + "description": "Array of metric names (e.g., accuracy, latency) to display for each model", + "required": true, + "defaultValue": "[]" + }, + { + "name": "refreshInterval", + "type": "number", + "description": "Time in seconds between automatic dashboard data refreshes", + "required": false, + "defaultValue": "300" + }, + { + "name": "dashboardName", + "type": "string", + "description": "User-defined name for the dashboard", + "required": false, + "defaultValue": "\"Model Performance Dashboard\"" + }, + { + "name": "displayStyle", + "type": "string", + "description": "Visual presentation style for the dashboard, e.g., 'summary', 'detailed', or 'graphical'", + "required": false, + "defaultValue": "\"graphical\"" + }, + { + "name": "includeAlerts", + "type": "boolean", + "description": "Whether to include alert panels for threshold breaches in metrics", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing dashboardId (string), dashboardUrl (string), and a summary of configured monitoring settings." + }, + "aiAgent": { + "useCase": "Use this tool to rapidly create a centralized dashboard for monitoring various AI models' performance metrics and status in real time or historical context. Ideal when configuring monitoring setups for one or more deployed models to assess quality, detect anomalies, or report metrics to stakeholders.", + "limitations": "The tool does not support creating dashboards for models without accessible metric data or integrating with external BI platforms beyond its native interface.", + "examples": [ + "Create a dashboard monitoring model A and model B's accuracy and latency every 5 minutes in graphical style.", + "Build a summary-style dashboard for multiple models focusing on error rates with alerts enabled.", + "Generate a detailed dashboard named 'Project X Model Insights' refreshing every 10 minutes for deployment review." + ] + }, + "tags": [ + "model-monitoring", + "dashboard", + "analytics", + "AI-models", + "performance", + "visualization" + ], + "examples": [ + { + "inputJson": "{\"modelIds\":[\"modelA\",\"modelB\"],\"metrics\":[\"accuracy\",\"latency\"],\"refreshInterval\":300,\"dashboardName\":\"Baseline Models\",\"displayStyle\":\"graphical\",\"includeAlerts\":true}", + "description": "Dashboard setup monitoring accuracy and latency for modelA and modelB, refreshing every 5 minutes with alerts." + }, + { + "inputJson": "{\"modelIds\":[\"modelX\"],\"metrics\":[\"errorRate\"],\"refreshInterval\":600,\"dashboardName\":\"Project X Model Insights\",\"displayStyle\":\"detailed\",\"includeAlerts\":false}", + "description": "Detailed single-model dashboard without alerts, refreshing every 10 minutes." + }, + { + "inputJson": "{\"modelIds\":[\"model1\",\"model2\",\"model3\"],\"metrics\":[\"precision\",\"recall\"],\"refreshInterval\":120,\"dashboardName\":\"Multi-Model Summary\",\"displayStyle\":\"summary\",\"includeAlerts\":true}", + "description": "Summary dashboard showing precision and recall for three models with alert panels enabled and 2-minute refresh." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Dashboard", + "context": null + } + }, + { + "name": "embedding-generation.composeEmail", + "description": "Generates an embedding vector representation for the content of an email composed from given structured inputs. Accepts subject, body text, recipients, and optional tags, then processes and returns a numerical vector embedding capturing semantic features of the composed email.", + "category": "embedding-generation", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be embedded.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main textual content of the email to embed.", + "required": true, + "defaultValue": "" + }, + { + "name": "toRecipients", + "type": "array", + "description": "List of main recipient email addresses (strings). Used optionally to enhance context.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "ccRecipients", + "type": "array", + "description": "List of CC recipient email addresses (strings). Optional context for embedding.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccRecipients", + "type": "array", + "description": "List of BCC recipient email addresses (strings). Included as optional context.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tags", + "type": "array", + "description": "Optional tags or keywords related to the email content to refine the embedding context.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing a single field 'embedding' which is an array of numbers representing the vector embedding of the email content." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a vector embedding summarizing the semantic content of an email composed from its components, to enable similarity search, clustering, or automated classification of emails in an embedding space.", + "limitations": "This tool does not generate natural language email text; it only produces vector embeddings from provided text. It cannot infer missing email parts or write email content.", + "examples": [ + "Generate a semantic vector embedding for a composed email given its subject, body, and recipients to find similar past emails.", + "Create embeddings from new composed emails to cluster and organize them based on content similarity.", + "Embed draft emails to recommend relevant actions or categorize by topic using pretrained vector embeddings." + ] + }, + "tags": [ + "embedding", + "email", + "text-representation", + "communication", + "semantic-vector", + "vectorization", + "email-processing" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Meeting agenda update\",\"body\":\"Please find the updated agenda for tomorrow's meeting attached.\",\"toRecipients\":[\"alice@example.com\"],\"ccRecipients\":[\"bob@example.com\"],\"bccRecipients\":[],\"tags\":[\"meeting\",\"agenda\"]}", + "description": "Embed a composed email about a meeting agenda update including recipients and tags." + }, + { + "inputJson": "{\"subject\":\"Invoice reminder\",\"body\":\"Dear customer, this is a reminder that your invoice #1234 is due next week.\",\"toRecipients\":[\"client@example.com\"],\"ccRecipients\":[],\"bccRecipients\":[],\"tags\":[\"invoice\",\"payment\"]}", + "description": "Create embedding for a payment reminder email to a client with relevant tags." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "file-operations.createReport", + "description": "Creates a structured report document from provided data inputs. Accepts data as JSON or CSV strings, applies optional formatting options, and outputs a report in PDF, DOCX, or HTML format. Supports adding titles, headers, footers, and basic styling for professional reporting needs.", + "category": "file-operations", + "parameters": [ + { + "name": "inputData", + "type": "string", + "description": "The raw data to include in the report, formatted as JSON or CSV string.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the inputData: 'json' or 'csv'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "reportTitle", + "type": "string", + "description": "Title text to display at the top of the report.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired report output format, e.g. 'pdf', 'docx', or 'html'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "includeHeader", + "type": "boolean", + "description": "Whether to include a header section in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeFooter", + "type": "boolean", + "description": "Whether to include a footer section in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "pageSize", + "type": "string", + "description": "Page size for the report output, e.g. 'A4', 'Letter'.", + "required": false, + "defaultValue": "A4" + }, + { + "name": "customStyles", + "type": "object", + "description": "Optional styling settings such as fonts, colors, and spacing as key-value pairs.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a base64-encoded string of the generated report file, the file name with extension, and MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate formatted reports from structured data inputs for sharing, presentation, or archival purposes. Ideal for summarizing tabular or JSON data into professional documents in common formats like PDF and DOCX.", + "limitations": "Does not perform complex data analysis or dynamic chart generation. Styling and formatting are basic and designed for clarity, not high design customization.", + "examples": [ + "Create a PDF sales report from JSON data with a title and default styling.", + "Generate an HTML report from CSV input, including header and footer.", + "Produce a DOCX report with custom font styles and letter-size pages." + ] + }, + "tags": [ + "file", + "report", + "document", + "generate", + "pdf", + "docx", + "html", + "data" + ], + "examples": [ + { + "inputJson": "{\"inputData\":\"[{\\\"name\\\":\\\"Alice\\\",\\\"score\\\":93},{\\\"name\\\":\\\"Bob\\\",\\\"score\\\":87}]\",\"inputFormat\":\"json\",\"reportTitle\":\"Exam Results\",\"outputFormat\":\"pdf\",\"includeHeader\":true,\"includeFooter\":true,\"pageSize\":\"A4\",\"customStyles\":{}}", + "description": "Generate a PDF report titled 'Exam Results' from JSON array data." + }, + { + "inputJson": "{\"inputData\":\"name,score\\nAlice,93\\nBob,87\",\"inputFormat\":\"csv\",\"reportTitle\":\"CSV Report\",\"outputFormat\":\"html\",\"includeHeader\":true,\"includeFooter\":false,\"pageSize\":\"Letter\",\"customStyles\":{\"fontFamily\":\"Arial\"}}", + "description": "Create an HTML report from CSV data with custom font and header only." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "file-operations.createFunction", + "description": "Creates a new programming function file based on specified parameters such as function name, language, parameters, and function body content. Outputs a text file with valid function code ready for use or further editing.", + "category": "file-operations", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The name of the function to create, used as the function identifier and file base name.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming language of the function to generate (e.g., 'javascript', 'python', 'typescript').", + "required": true, + "defaultValue": "" + }, + { + "name": "parameters", + "type": "array", + "description": "An array of parameter names (strings) that the function accepts.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "functionBody", + "type": "string", + "description": "The code to include inside the function body, defining its behavior.", + "required": true, + "defaultValue": "" + }, + { + "name": "exportFunction", + "type": "boolean", + "description": "Whether to export the function (if language supports export syntax) from the module/file.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the filename and the full content of the function code as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a new standalone function in a specific programming language, allowing dynamic creation of reusable code from specifications or prompts. It is ideal for scaffolding functions based on input signature and logic.", + "limitations": "This tool generates the function text but does not compile, execute, or validate the function code. It cannot infer complex logic from vague descriptions and requires explicit function body code.", + "examples": [ + "Create a Python function named 'add' that takes parameters 'a' and 'b' and returns their sum.", + "Generate a JavaScript function called 'greet' accepting 'name' that returns a greeting string.", + "Produce a TypeScript exported function 'multiply' with parameters 'x', 'y' returning the product." + ] + }, + "tags": [ + "code-generation", + "file-creation", + "function", + "programming", + "automation", + "source-code" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"add\",\"language\":\"python\",\"parameters\":[\"a\",\"b\"],\"functionBody\":\"return a + b\",\"exportFunction\":false}", + "description": "Generate a simple Python add function with two parameters that returns their sum." + }, + { + "inputJson": "{\"functionName\":\"greet\",\"language\":\"javascript\",\"parameters\":[\"name\"],\"functionBody\":\"return `Hello, ${name}!`;\",\"exportFunction\":true}", + "description": "Create an exported JavaScript greet function that returns a personalized string." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "audio-processing.generateCode", + "description": "Generates source code snippets to perform audio processing tasks based on natural language descriptions. Accepts parameters specifying the target programming language, desired audio effect or analysis, and code complexity level. Produces ready-to-use code samples that implement audio processing functionality such as filtering, synthesis, or feature extraction.", + "category": "audio-processing", + "parameters": [ + { + "name": "description", + "type": "string", + "description": "A natural language description of the desired audio processing functionality to implement (e.g., 'apply a low-pass filter to audio input').", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Target programming language for the generated code (e.g., 'Python', 'JavaScript').", + "required": true, + "defaultValue": "Python" + }, + { + "name": "complexityLevel", + "type": "string", + "description": "Desired complexity level of the generated code: 'basic' for simple examples, 'advanced' for production-ready or optimized implementations.", + "required": false, + "defaultValue": "basic" + }, + { + "name": "libraryPreference", + "type": "string", + "description": "Preferred audio processing library or framework to use if applicable (e.g., 'librosa', 'pydub', or empty for no preference).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated source code as a string, the language used, and optional notes about dependencies or usage instructions." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate practical example code snippets for audio processing tasks in a specific programming language based on a description of the audio effect or analysis required. Ideal for developers or learners seeking programmatic implementations of audio operations.", + "limitations": "The tool cannot execute or test the generated code, nor guarantee compatibility with all versions of the requested libraries. Complex custom audio algorithms beyond common patterns might not produce accurate code.", + "examples": [ + "Generate Python code that performs speech detection using the librosa library.", + "Create a JavaScript snippet applying a reverb effect on an audio buffer.", + "Produce a basic Python example to extract MFCC features from an audio file." + ] + }, + "tags": [ + "audio-processing", + "code-generation", + "programming", + "audio-effects", + "machine-learning", + "audio-analysis" + ], + "examples": [ + { + "inputJson": "{\"description\":\"apply a low-pass filter to an audio signal\",\"language\":\"Python\",\"complexityLevel\":\"basic\",\"libraryPreference\":\"librosa\"}", + "description": "Generate simple Python code using librosa to apply a low-pass filter to audio input." + }, + { + "inputJson": "{\"description\":\"extract MFCC features from an audio clip\",\"language\":\"Python\",\"complexityLevel\":\"advanced\",\"libraryPreference\":\"\"}", + "description": "Generate advanced Python code for extracting MFCC features from audio without specifying a library preference." + }, + { + "inputJson": "{\"description\":\"add a reverb effect to an audio buffer\",\"language\":\"JavaScript\",\"complexityLevel\":\"basic\",\"libraryPreference\":\"\"}", + "description": "Generate a JavaScript snippet applying reverb effect to an audio buffer." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Code", + "context": null + } + }, + { + "name": "image-processing.createFunction", + "description": "Creates a custom image processing function based on user-defined operations and parameters. The tool accepts a specification of image manipulations such as filters, color adjustments, and transformations, then generates executable code implementing the function. Outputs the function code as a string for integration or further use.", + "category": "image-processing", + "parameters": [ + { + "name": "operations", + "type": "array", + "description": "A list of image processing operations to apply, each specifying type, parameters, and order. Supported operations include filters, transforms, color adjustments, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionName", + "type": "string", + "description": "The desired name of the generated function. If empty, a default name is assigned.", + "required": false, + "defaultValue": "\"processImage\"" + }, + { + "name": "language", + "type": "string", + "description": "The programming language for the function code output, e.g., 'JavaScript', 'Python'.", + "required": false, + "defaultValue": "\"JavaScript\"" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments in the generated code for better readability.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated function code string and metadata such as language and applied operations." + }, + "aiAgent": { + "useCase": "Use this tool when needing to dynamically create custom image processing functions programmatically based on specific operation sequences and parameters, allowing AI agents to automate image manipulation code generation without manual coding.", + "limitations": "Cannot execute or test the generated function code; assumes input operations are valid and supported; does not handle image input/output directly, only code generation.", + "examples": [ + "Create a JS function to apply grayscale and blur filters to an image.", + "Generate a Python function named 'enhanceContrast' to increase image contrast.", + "Produce a JavaScript function with comments applying rotate and resize transformations." + ] + }, + "tags": [ + "image-processing", + "code-generation", + "function-creation", + "filters", + "transformations", + "color-adjustment" + ], + "examples": [ + { + "inputJson": "{\"operations\":[{\"type\":\"grayscale\"},{\"type\":\"blur\",\"radius\":5}],\"functionName\":\"applyEffects\",\"language\":\"JavaScript\",\"includeComments\":true}", + "description": "Generate a JS function 'applyEffects' applying grayscale and blur with radius 5." + }, + { + "inputJson": "{\"operations\":[{\"type\":\"rotate\",\"angle\":90},{\"type\":\"resize\",\"width\":200,\"height\":100}],\"functionName\":\"transformImage\",\"language\":\"Python\",\"includeComments\":false}", + "description": "Create a Python function 'transformImage' to rotate 90 degrees and resize to 200x100 without comments." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "notifications.analyzeAccount", + "description": "Analyzes notification account data to identify patterns, delivery performance, usage statistics, and potential issues. It accepts account identifier and optional filters, processes historical and real-time notification metadata, and outputs a detailed report summarizing activity trends, success/failure rates, anomaly detection, and recommendations for optimization.", + "category": "notifications", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "Unique identifier of the notification account to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 date to specify analysis start time; defaults to 30 days before endDate if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 date for analysis end time; defaults to current date/time if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "notificationTypes", + "type": "array", + "description": "Filter to include only specified notification types (e.g., email, SMS, push).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeFailedOnly", + "type": "boolean", + "description": "If true, limit analysis to only failed notifications to identify problems.", + "required": false, + "defaultValue": "false" + }, + { + "name": "aggregationInterval", + "type": "string", + "description": "Time interval to aggregate results, e.g., 'daily', 'weekly', or 'monthly'. Defaults to 'daily'.", + "required": false, + "defaultValue": "daily" + } + ], + "returns": { + "type": "object", + "description": "Detailed analytics report including summary statistics, trend graphs data, failure analysis, peak usage periods, and improvement suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to provide insights on the performance and usage patterns of a notifications account, such as reviewing delivery success rates, finding spikes in notification volume, or diagnosing recurring failures. It is especially useful for support, account management, or operational optimization tasks.", + "limitations": "This tool does not modify account settings, send notifications directly, or provide real-time alerting. It only analyzes historical and current notification data within given filters and intervals.", + "examples": [ + "Analyze notification delivery performance for account 'acc123' over the last month.", + "Generate a report of failed email notifications for account 'acc123' between 2024-01-01 and 2024-01-31.", + "Summarize weekly push notification volumes for account 'acc123', showing trends and peak days." + ] + }, + "tags": [ + "notifications", + "analysis", + "account", + "reporting", + "performance", + "failure-detection" + ], + "examples": [ + { + "inputJson": "{\"accountId\":\"acc123\"}", + "description": "Basic analysis for account 'acc123' using default parameters (last 30 days, all notification types)." + }, + { + "inputJson": "{\"accountId\":\"acc123\",\"startDate\":\"2024-05-01T00:00:00Z\",\"endDate\":\"2024-05-31T23:59:59Z\",\"notificationTypes\":[\"email\"],\"includeFailedOnly\":true}", + "description": "Analyze failed email notifications for 'acc123' during May 2024." + }, + { + "inputJson": "{\"accountId\":\"acc123\",\"aggregationInterval\":\"weekly\"}", + "description": "Weekly aggregated trend report for 'acc123' across all notification types for the last 30 days." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "notifications.composeEmail", + "description": "Composes an email message based on specified recipient addresses, subject, body content, and optional metadata like CC, BCC, and attachments. Returns a structured email object ready for sending or further processing.", + "category": "notifications", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of primary recipient email addresses to send the email to.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content of the email, supports plain text or HTML format.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of email addresses to be carbon copied on the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of email addresses to be blind carbon copied on the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Flag indicating if the body content is HTML (true) or plain text (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachments, each with filename and base64 encoded content.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A structured email object including all headers, body, and attachments ready to be sent or stored." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create a well-formed email message with all relevant fields (to, cc, bcc, subject, content, attachments) ready for sending via an email client or service. It helps in composing emails from dynamic content and multiple recipients.", + "limitations": "This tool only composes the email message structure and does not send the email or manage email delivery. It cannot validate email address correctness beyond format checks or handle scheduling or mailbox management.", + "examples": [ + "Compose an email to a team updating them on project status with HTML content and an attachment.", + "Create a plain text email to notify a user about password reset instructions.", + "Generate an email with CC and BCC recipients for event invitations." + ] + }, + "tags": [ + "notifications", + "email", + "compose", + "communication", + "automated messages", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Meeting Reminder\",\"body\":\"Just a reminder about our meeting tomorrow at 10 AM.\",\"isHtml\":false}", + "description": "Simple plain text email to one recipient reminding about a meeting." + }, + { + "inputJson": "{\"to\":[\"team@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Project Update\",\"body\":\"Project Status
The project is on track for delivery.
\",\"isHtml\":true}", + "description": "HTML email to team with CC to manager including project status update." + }, + { + "inputJson": "{\"to\":[\"invitee@example.com\"],\"bcc\":[\"organizer@example.com\"],\"subject\":\"You’re Invited!\",\"body\":\"Please find the invitation attached.\",\"isHtml\":false,\"attachments\":[{\"filename\":\"invitation.pdf\",\"content\":\"JVBERi0xLjQKJcfs...\"}]}", + "description": "Plain text invitation email with a PDF attachment and a BCC to the organizer." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "notifications.generateText", + "description": "Generates text content for notifications based on specified parameters including audience type, event type, urgency level, and preferred language. Accepts structured input and produces a customized notification message text suitable for alert or update purposes.", + "category": "notifications", + "parameters": [ + { + "name": "audienceType", + "type": "string", + "description": "Type of the notification audience, e.g., 'customer', 'employee', 'admin'. Affects tone and content of generated text.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventType", + "type": "string", + "description": "Type of event triggering the notification, e.g., 'passwordReset', 'systemAlert', 'promotion'. Influences the message focus.", + "required": true, + "defaultValue": "" + }, + { + "name": "urgencyLevel", + "type": "string", + "description": "Urgency of the notification: 'low', 'medium', or 'high'. Modifies the language to reflect urgency accordingly.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "language", + "type": "string", + "description": "Preferred language code for the notification text, e.g., 'en', 'es', 'fr'. Controls output language.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeActionCall", + "type": "boolean", + "description": "Whether to include a call-to-action phrase in the notification text, e.g., 'Click here to reset'.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated notification text under the key 'notificationText', ready for display or sending." + }, + "aiAgent": { + "useCase": "This tool should be used by AI agents tasked with creating clear, context-sensitive notification messages for various audiences and events. It is ideal when a dynamically generated, natural language notification is required for alerting users, customers, or staff in multiple languages and urgency levels.", + "limitations": "The tool does not send notifications; it only generates the text content. It cannot forecast user reactions or guarantee legal compliance.", + "examples": [ + "Generate a high urgency system alert notification for employees in English with an action call.", + "Create a promotional notification text for customers in Spanish, medium urgency, without a call to action.", + "Generate a password reset notification for admins in French, low urgency, including an action call." + ] + }, + "tags": [ + "notification", + "text generation", + "alert", + "multilingual", + "custom messaging", + "urgency" + ], + "examples": [ + { + "inputJson": "{\"audienceType\":\"customer\",\"eventType\":\"promotion\",\"urgencyLevel\":\"low\",\"language\":\"en\",\"includeActionCall\":true}", + "description": "Generate a low urgency promotional notification for customers in English with a call to action." + }, + { + "inputJson": "{\"audienceType\":\"employee\",\"eventType\":\"systemAlert\",\"urgencyLevel\":\"high\",\"language\":\"en\",\"includeActionCall\":true}", + "description": "Generate a high urgency system alert notification for employees in English including a call to action." + }, + { + "inputJson": "{\"audienceType\":\"admin\",\"eventType\":\"passwordReset\",\"urgencyLevel\":\"medium\",\"language\":\"fr\",\"includeActionCall\":true}", + "description": "Generate a medium urgency password reset notification for admins in French including a call to action." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "messaging.analyzeMessage", + "description": "Analyzes a chat or message text to extract insights such as sentiment, toxicity, key topics, intent, and language. Accepts a string message and options for analysis types, then processes the text using NLP techniques and returns a detailed analysis report summarizing detected attributes and scores.", + "category": "messaging", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The message content to analyze for sentiment, intent, and other attributes.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSentiment", + "type": "boolean", + "description": "Whether to analyze and include sentiment score and label.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeToxicity", + "type": "boolean", + "description": "Whether to evaluate and include toxicity levels in the analysis.", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeTopics", + "type": "boolean", + "description": "Whether to extract and include key topics and keywords from the message.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeIntent", + "type": "boolean", + "description": "Whether to detect and report the intent of the message.", + "required": false, + "defaultValue": "false" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en' for English) of the message to assist accurate analysis.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object including fields such as sentiment (score and label), toxicity score (if requested), extracted topics, detected intent, and a summary string describing the message analysis." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing individual chat messages or user communications to understand emotional tone, detect harmful content, summarize key topics, or infer user intent. It supports moderation, user sentiment tracking, conversation summarization, and intent classification in messaging platforms.", + "limitations": "This tool does not provide full conversation context analysis, cannot replace comprehensive moderation systems alone, and may have reduced accuracy on very short, slang-heavy, or ambiguous messages.", + "examples": [ + "Analyze the sentiment and toxicity of a user message to detect potential abuse.", + "Extract key topics and intent from a customer support chat message to help route the request appropriately.", + "Determine if a message is positive, neutral, or negative to inform user mood tracking." + ] + }, + "tags": [ + "messaging", + "analysis", + "sentiment", + "toxicity", + "intent", + "topics", + "NLP", + "chat" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"I'm really unhappy with the delay in service. Can someone help?\",\"includeSentiment\":true,\"includeToxicity\":false,\"includeTopics\":true,\"includeIntent\":true,\"language\":\"en\"}", + "description": "Analyze a customer complaint message for sentiment, key topics, and intent detection." + }, + { + "inputJson": "{\"messageText\":\"Congrats on the new project! Looking forward to working together.\",\"includeSentiment\":true,\"includeToxicity\":false,\"includeTopics\":true,\"includeIntent\":false,\"language\":\"en\"}", + "description": "Analyze a positive, congratulatory message to identify sentiment and key topics." + }, + { + "inputJson": "{\"messageText\":\"You all are awful and incompetent!\",\"includeSentiment\":true,\"includeToxicity\":true,\"includeTopics\":false,\"includeIntent\":false,\"language\":\"en\"}", + "description": "Analyze a hostile message including toxicity detection to flag abusive language." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "messaging.formatEmail", + "description": "This tool formats email content according to specified parameters including subject, sender, recipients, body text, and optional attachments. It accepts inputs like subject line, from and to addresses, plain or HTML body content, and a list of attachments, then produces a structured email object ready for sending or further processing.", + "category": "messaging", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "fromAddress", + "type": "string", + "description": "The sender's email address.", + "required": true, + "defaultValue": "" + }, + { + "name": "toAddresses", + "type": "array", + "description": "List of recipient email addresses.", + "required": true, + "defaultValue": "" + }, + { + "name": "ccAddresses", + "type": "array", + "description": "List of CC recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccAddresses", + "type": "array", + "description": "List of BCC recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bodyText", + "type": "string", + "description": "The plain text version of the email body.", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "The HTML version of the email body, if any.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects, each with filename and content (base64 or URL).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "charset", + "type": "string", + "description": "Character set encoding of the email content, e.g., UTF-8.", + "required": false, + "defaultValue": "UTF-8" + } + ], + "returns": { + "type": "object", + "description": "A structured email object containing all input fields validated and organized for delivery or integration with email sending services." + }, + "aiAgent": { + "useCase": "Use this tool whenever an AI agent needs to programmatically construct a complete email structure, ensuring proper formatting of headers, recipients, body types (text and/or HTML), and attachments before sending or saving drafts. Especially useful when assembling emails from dynamic content or user inputs.", + "limitations": "This tool does not send or transmit emails; it only formats the email content. It cannot validate email address syntax beyond basic string checks nor handle delivery status or server responses.", + "examples": [ + "Format an email with subject, sender and multiple recipients with both plain text and HTML body.", + "Add attachments like PDFs or images encoded in base64 to the formatted email.", + "Format a copied email draft into a structured object for integration in an email client." + ] + }, + "tags": [ + "messaging", + "email", + "formatting", + "communication", + "attachments", + "html", + "automation" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Project Update\",\"fromAddress\":\"manager@example.com\",\"toAddresses\":[\"team@example.com\",\"lead@example.com\"],\"ccAddresses\":[\"hr@example.com\"],\"bodyText\":\"Please find the update on the project timeline.\",\"bodyHtml\":\"Please find the update on the project timeline.
\",\"attachments\":[{\"filename\":\"timeline.pdf\",\"content\":\"base64encodedstringhere\"}]}", + "description": "Format an email with subject, multiple recipients, CC, plain text and HTML body, and one PDF attachment." + }, + { + "inputJson": "{\"subject\":\"Meeting Reminder\",\"fromAddress\":\"noreply@company.com\",\"toAddresses\":[\"employee@example.com\"],\"bodyText\":\"This is a reminder for your meeting scheduled tomorrow at 10 AM.\"}", + "description": "Format a simple email reminder with plain text body and single recipient." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Email", + "context": null + } + }, + { + "name": "messaging.createText", + "description": "Creates a formatted text message for real-time messaging applications. Accepts plain text input and optional formatting parameters such as markdown support, emoji inclusion, and verbosity level. Outputs a structured message object ready for sending or further processing in chat integrations.", + "category": "messaging", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The main textual content of the message to create, in plain text.", + "required": true, + "defaultValue": "" + }, + { + "name": "enableMarkdown", + "type": "boolean", + "description": "Whether to parse and apply basic markdown formatting to the text content (e.g., bold, italics).", + "required": false, + "defaultValue": "false" + }, + { + "name": "includeEmojis", + "type": "boolean", + "description": "Whether to parse emoji codes in the text and convert them to Unicode emojis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the message; text will be truncated if exceeded.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "verbosityLevel", + "type": "string", + "description": "Level of detail for the message, such as 'short', 'normal', or 'detailed'. Affects message length and style.", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created message, including formatted text and metadata such as length and formatting flags." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate a chat-ready text message from raw or lightly formatted input, especially when preparing messages for messaging platforms supporting markdown and emoji. It helps standardize and format messages before sending.", + "limitations": "Does not support rich media content such as images or videos. Limited to text formatting and emoji parsing only.", + "examples": [ + "Create a text message with markdown enabled and emojis included.", + "Generate a brief chat message truncated to 200 characters.", + "Produce a detailed text message without markdown formatting." + ] + }, + "tags": [ + "messaging", + "text", + "chat", + "formatting", + "markdown", + "emoji", + "messageCreation" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"Hello, team! Please review the *project update* attached.\",\"enableMarkdown\":true,\"includeEmojis\":true,\"maxLength\":500,\"verbosityLevel\":\"normal\"}", + "description": "Create a normal verbosity message with markdown formatting and emojis included." + }, + { + "inputJson": "{\"textContent\":\"Reminder: submit your timesheets.\",\"enableMarkdown\":false,\"includeEmojis\":false,\"maxLength\":100,\"verbosityLevel\":\"short\"}", + "description": "Create a short, plain text reminder message without markdown or emojis." + }, + { + "inputJson": "{\"textContent\":\"Detailed meeting summary: topics discussed, decisions made, and next steps.\",\"enableMarkdown\":true,\"includeEmojis\":false,\"maxLength\":1000,\"verbosityLevel\":\"detailed\"}", + "description": "Generate a longer, detailed message with markdown formatting but no emojis." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "email-communication.draftDocument", + "description": "Generates a professional email draft document based on provided subject, recipient info, and message details. Accepts inputs like recipient name, email subject, purpose, tone, and key points to include. Outputs a formatted email draft text suitable for review or sending.", + "category": "email-communication", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "The recipient's full name to personalize the email", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmail", + "type": "string", + "description": "The recipient's email address for contextual relevance", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The main subject line of the email", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Brief description of the email's purpose or reason", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of key points or topics to cover in the email body", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "The tone of the email (e.g., formal, casual, persuasive)", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to append a signature block at the end", + "required": false, + "defaultValue": "true" + }, + { + "name": "signatureName", + "type": "string", + "description": "Name to use in the signature if included", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed email draft text and metadata" + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to create an initial email draft tailored to a particular recipient, purpose, and style. It helps automate personalized email drafting for outreach, follow-up, or information sharing scenarios, ensuring professionalism while saving user time.", + "limitations": "The tool does not send emails or manage inboxes; it only generates draft content. It cannot verify recipient email validity or adhere to specific compliance beyond tone guidance.", + "examples": [ + "Draft an email to a client introducing a new product in a professional tone.", + "Generate a follow-up email draft to a partner including key meeting points.", + "Create a casual inquiry email draft to a colleague asking for status update." + ] + }, + "tags": [ + "email", + "drafting", + "automation", + "communication", + "document", + "personalization", + "professional" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Jane Smith\",\"recipientEmail\":\"jane.smith@example.com\",\"subject\":\"Introductory Meeting Follow-up\",\"purpose\":\"Thank Jane for meeting and summarize key takeaways\",\"keyPoints\":[\"Thank you for your time\",\"Discussed potential collaboration\",\"Next steps scheduling\"],\"tone\":\"formal\",\"includeSignature\":true,\"signatureName\":\"John Doe\"}", + "description": "Draft a formal follow-up email to a business contact after a meeting." + }, + { + "inputJson": "{\"recipientName\":\"Tom\",\"recipientEmail\":\"tom@example.com\",\"subject\":\"Weekly Update\",\"purpose\":\"Provide weekly project status update\",\"keyPoints\":[\"Completed tasks\",\"Pending issues\",\"Request for feedback\"],\"tone\":\"casual\",\"includeSignature\":false,\"signatureName\":\"\"}", + "description": "Generate a casual weekly update email draft without signature." + }, + { + "inputJson": "{\"recipientName\":\"Dr. Lee\",\"recipientEmail\":\"dr.lee@university.edu\",\"subject\":\"Research Collaboration Opportunity\",\"purpose\":\"Propose joint research project and request meeting\",\"keyPoints\":[\"Project overview\",\"Mutual benefits\",\"Proposed timeline\"],\"tone\":\"formal\",\"includeSignature\":true,\"signatureName\":\"Alex Morgan\"}", + "description": "Create a professional email proposing a research collaboration with a formal tone and signature." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Document", + "context": null + } + }, + { + "name": "email-communication.createOrder", + "description": "Creates a detailed email order message to be sent to customers or suppliers by processing order data inputs. Accepts order details including recipient email, product list, quantities, prices, and optional message template and shipping info; constructs a formatted email content string summarizing the order for communication purposes.", + "category": "email-communication", + "parameters": [ + { + "name": "recipientEmail", + "type": "string", + "description": "The email address of the primary recipient who will receive the order email.", + "required": true, + "defaultValue": "" + }, + { + "name": "orderId", + "type": "string", + "description": "Unique identifier for the order being communicated.", + "required": true, + "defaultValue": "" + }, + { + "name": "products", + "type": "array", + "description": "An array of products, each as an object with name (string), quantity (number), and unitPrice (number), representing the items in the order.", + "required": true, + "defaultValue": "" + }, + { + "name": "shippingAddress", + "type": "object", + "description": "The shipping address details including fields: recipientName, street, city, state, postalCode, and country, used to inform delivery info in the email.", + "required": false, + "defaultValue": "" + }, + { + "name": "orderDate", + "type": "string", + "description": "Date string indicating when the order was placed (e.g., ISO 8601 format).", + "required": false, + "defaultValue": "" + }, + { + "name": "customMessage", + "type": "string", + "description": "Optional personalized message to include in the email body for the recipient.", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "The currency code (e.g., USD, EUR) used for price display in the email, defaulting to USD.", + "required": false, + "defaultValue": "USD" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated subject line and body text for the order email message, ready for sending through an email client or service." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a well-formatted email content representing an order summary for customers or suppliers based on structured order data. It simplifies composing the order message including product details, pricing, and shipping info to streamline email communications in e-commerce or procurement workflows.", + "limitations": "This tool only creates the email content and subject. It does not send emails, manage email delivery status, or handle replies/confirmations.", + "examples": [ + "Create an order confirmation email to send to a customer including product and shipping details.", + "Generate an order request email to a supplier with a list of requested goods and quantities.", + "Produce a summary email for internal stakeholders detailing a recent purchase order." + ] + }, + "tags": [ + "email", + "order", + "ecommerce", + "communication", + "automation", + "business", + "message-generation" + ], + "examples": [ + { + "inputJson": "{\"recipientEmail\":\"customer@example.com\",\"orderId\":\"ORD123456\",\"products\":[{\"name\":\"Widget A\",\"quantity\":3,\"unitPrice\":19.99},{\"name\":\"Gadget B\",\"quantity\":2,\"unitPrice\":29.5}],\"shippingAddress\":{\"recipientName\":\"John Doe\",\"street\":\"123 Elm St\",\"city\":\"Springfield\",\"state\":\"IL\",\"postalCode\":\"62704\",\"country\":\"USA\"},\"orderDate\":\"2024-06-01T10:00:00Z\",\"customMessage\":\"Thank you for your purchase!\",\"currency\":\"USD\"}", + "description": "Generate a customer order confirmation email with product list, quantities, prices, shipping address, and a thank you note." + }, + { + "inputJson": "{\"recipientEmail\":\"supplier@vendor.com\",\"orderId\":\"PO78910\",\"products\":[{\"name\":\"Component X\",\"quantity\":100,\"unitPrice\":5.0}],\"currency\":\"EUR\"}", + "description": "Create an order request email to a supplier for 100 units of Component X, prices in EUR." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Order", + "context": null + } + }, + { + "name": "email-communication.createAlert", + "description": "Creates and sends a security alert email based on specified triggers, recipients, and alert content. Accepts parameters defining the alert subject, message body, recipient list, severity level, and optional attachments. Processes the input to format the alert email and initiates sending via configured email infrastructure. Returns a status confirmation including alert ID and sending result.", + "category": "email-communication", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "Subject line for the alert email", + "required": true, + "defaultValue": "" + }, + { + "name": "messageBody", + "type": "string", + "description": "Main content of the alert email, supporting plain text or HTML", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of email addresses (strings) to receive the alert", + "required": true, + "defaultValue": "" + }, + { + "name": "severity", + "type": "string", + "description": "Severity level of the alert, e.g., 'low', 'medium', 'high', or 'critical'", + "required": false, + "defaultValue": "medium" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of file objects (with name and content) to attach to the email", + "required": false, + "defaultValue": "" + }, + { + "name": "sendImmediately", + "type": "boolean", + "description": "Flag indicating whether to send the alert immediately or schedule for later", + "required": false, + "defaultValue": "true" + }, + { + "name": "scheduledTime", + "type": "string", + "description": "ISO 8601 datetime string for scheduled sending; used if sendImmediately is false", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the alertId (unique identifier), status (e.g., 'sent', 'scheduled'), and message describing the sending outcome" + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically create and dispatch security alert emails triggered by monitoring systems or manual requests. It helps communicate timely security incidents or warning notices to designated personnel with appropriate severity and attachments. Ideal for alert automation and rapid notification workflows.", + "limitations": "Does not handle email server configuration or authentication; requires underlying email infrastructure to be set up. Cannot analyze alerts or detect security issues, only formats and sends alert emails.", + "examples": [ + "Create and send a critical security breach alert to the security team immediately.", + "Schedule a medium severity alert email for the admin team with a log file attachment.", + "Send a low severity alert with customizable HTML content to multiple recipients." + ] + }, + "tags": [ + "email", + "security", + "alert", + "automation", + "notification", + "email-sending" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Critical Security Breach Detected\",\"messageBody\":\"A critical breach was detected in the network. Immediate action required.\",\"recipients\":[\"security@company.com\",\"admin@company.com\"],\"severity\":\"critical\",\"sendImmediately\":true}", + "description": "Send an immediate critical alert email to security and admin teams." + }, + { + "inputJson": "{\"subject\":\"Scheduled Security Alert\",\"messageBody\":\"This is a scheduled reminder of the weekly security audit.\",\"recipients\":[\"audit@company.com\"],\"severity\":\"medium\",\"sendImmediately\":false,\"scheduledTime\":\"2024-07-01T09:00:00Z\"}", + "description": "Schedule an alert email for future delivery to the audit team." + }, + { + "inputJson": "{\"subject\":\"Low Severity Alert\",\"messageBody\":\"Routine check completed with no issues.\",\"recipients\":[\"support@company.com\"],\"severity\":\"low\",\"attachments\":[{\"name\":\"report.pdf\",\"content\":\"\"}],\"sendImmediately\":true}", + "description": "Send a low severity alert immediately with an attached report." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Alert", + "context": null + } + }, + { + "name": "infrastructure-management.draftEmail", + "description": "This tool drafts professional emails related to infrastructure management tasks. It accepts input parameters including the subject, recipient details, context about the infrastructure issue or update, and tone preference. It processes these inputs to generate a clear, concise, and contextually appropriate email draft ready for review and sending.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "The name of the email recipient, used for personalization.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmail", + "type": "string", + "description": "The email address of the recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "context", + "type": "string", + "description": "Detailed information about the infrastructure update, issue, or request to include in the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone of the email (e.g., formal, informal, urgent).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeActionItems", + "type": "boolean", + "description": "Flag indicating whether to include action items or next steps in the email.", + "required": false, + "defaultValue": "true" + }, + { + "name": "ccRecipients", + "type": "array", + "description": "Optional list of additional recipient email addresses to CC.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the drafted email subject, body text, and optionally formatted recipients lists for 'to' and 'cc'." + }, + "aiAgent": { + "useCase": "Use this tool when automating communication tasks about infrastructure changes, status updates, or incidents. Ideal for situations requiring clear and professional correspondence with teams, stakeholders, or clients regarding technical infrastructure management.", + "limitations": "This tool does not send emails or handle sensitive data directly; it only drafts textual emails. It cannot access external systems or email directories to verify addresses or fetch real-time infrastructure data.", + "examples": [ + "Draft a formal email to the cloud operations team updating them on a scheduled maintenance window.", + "Create an urgent email notifying the network team of detected outages and inviting immediate attention.", + "Generate a soft reminder email to stakeholders about upcoming infrastructure upgrades with requested approvals." + ] + }, + "tags": [ + "infrastructure", + "email", + "communication", + "automation", + "drafting" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Alice Johnson\",\"recipientEmail\":\"alice.johnson@example.com\",\"subject\":\"Scheduled Maintenance Notification\",\"context\":\"We will perform scheduled maintenance on the primary database server on June 15th between 2 AM and 4 AM UTC. During this period, the database services will be temporarily unavailable. Please plan your operations accordingly.\",\"tone\":\"formal\",\"includeActionItems\":true,\"ccRecipients\":[\"bob.smith@example.com\"]}", + "description": "Formal maintenance notification email to the database operations team with CC to the support manager." + }, + { + "inputJson": "{\"recipientName\":\"DevOps Team\",\"recipientEmail\":\"devops@example.com\",\"subject\":\"Immediate Action Required: Network Outage Detected\",\"context\":\"A critical network outage has been detected affecting multiple data centers. Immediate troubleshooting is required to identify and resolve the root cause.\",\"tone\":\"urgent\",\"includeActionItems\":true,\"ccRecipients\":[]}", + "description": "Urgent notification email to DevOps about a network outage requiring immediate response." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "infrastructure-management.buildServer", + "description": "This tool provisions and configures a new server instance based on specified parameters such as server type, CPU, memory, storage, operating system, and networking options. It accepts an infrastructure profile and setup preferences to automate server creation and returns details of the deployed server including its ID, IP address, and status.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "Type or flavor of the server (e.g. 't2.medium', 'm5.large') to specify CPU and memory configurations.", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system to install on the server (e.g. 'ubuntu-20.04', 'windows-server-2019').", + "required": true, + "defaultValue": "" + }, + { + "name": "storageGB", + "type": "number", + "description": "Amount of storage in gigabytes to allocate to the server's primary disk.", + "required": false, + "defaultValue": "50" + }, + { + "name": "networkId", + "type": "string", + "description": "Identifier of the network or VPC where the server will be deployed.", + "required": true, + "defaultValue": "" + }, + { + "name": "sshKeyName", + "type": "string", + "description": "Name of the SSH key to set up for secure access to the server.", + "required": false, + "defaultValue": "" + }, + { + "name": "autoStart", + "type": "boolean", + "description": "Whether to start the server automatically after build completion.", + "required": false, + "defaultValue": "true" + }, + { + "name": "tags", + "type": "object", + "description": "Key-value pairs of tags to assign to the server resource for management and billing.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the server's unique identifier, public and private IP addresses, current status (e.g. 'running', 'stopped'), and any error messages if applicable." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically spin up a new server in a cloud or virtualized environment with custom configurations as part of infrastructure automation, scaling, or deployment workflows. Ideal for DevOps automation, cloud provisioning, or dynamic infrastructure management.", + "limitations": "This tool does not handle complex multi-server orchestration or configuration management beyond initial setup. It assumes provided network IDs and SSH keys are valid and available. Server image and flavor options depend on target infrastructure provider capabilities.", + "examples": [ + "Create a new Ubuntu server with 4 CPUs, 16GB memory, and 100GB storage in a specific VPC.", + "Provision a Windows server instance with a given SSH key and tags for environment identification.", + "Build a server configured to auto-start on deployment with specified network and key settings." + ] + }, + "tags": [ + "infrastructure", + "server", + "provisioning", + "cloud", + "automation", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"m5.large\",\"operatingSystem\":\"ubuntu-20.04\",\"storageGB\":100,\"networkId\":\"vpc-12345\",\"sshKeyName\":\"prod-key\",\"autoStart\":true,\"tags\":{\"environment\":\"production\",\"project\":\"webapp\"}}", + "description": "Provision a production Ubuntu server with specified sizing, network, SSH key, and tags." + }, + { + "inputJson": "{\"serverType\":\"t3.medium\",\"operatingSystem\":\"windows-server-2019\",\"networkId\":\"vpc-67890\",\"autoStart\":false}", + "description": "Deploy a Windows server without auto-start in a given VPC, default storage size, no SSH key." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Server", + "context": null + } + }, + { + "name": "infrastructure-management.buildCommit", + "description": "Builds a commit object representing changes to infrastructure-as-code files, taking inputs like commit message, author info, branch, and file changes. Processes these inputs to compose a structured commit with diffs and metadata, outputting the commit id, status, and summary for integration with infrastructure management workflows.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "commitMessage", + "type": "string", + "description": "The message describing the commit purpose and changes.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the author making the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email of the author making the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "branch", + "type": "string", + "description": "Target branch for the commit.", + "required": true, + "defaultValue": "main" + }, + { + "name": "fileChanges", + "type": "array", + "description": "Array of objects describing file changes; each must include file path, change type (added, modified, deleted), and content when applicable.", + "required": true, + "defaultValue": "" + }, + { + "name": "parentCommitId", + "type": "string", + "description": "The ID of the parent commit, if applicable, to maintain history linkage.", + "required": false, + "defaultValue": "" + }, + { + "name": "signCommit", + "type": "boolean", + "description": "Flag indicating whether to cryptographically sign the commit for authenticity.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing commitId (string), status (success/failure), summary (text description), and optional error details if failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create a commit in an infrastructure-as-code repository, such as automating deployment changes or updating configuration files. It bundles file diffs and metadata into a structured commit for version control integration.", + "limitations": "This tool does not push commits to remote repositories nor handle merge conflicts. It only constructs commit objects locally; actual repository operations must be performed by separate tools.", + "examples": [ + "Create a commit on branch 'feature-xyz' adding a new Terraform file to deploy a database cluster", + "Build a signed commit updating Kubernetes manifests on branch 'prod' with precise author info", + "Generate a commit deleting deprecated config files on branch 'staging' without signing" + ] + }, + "tags": [ + "infrastructure", + "commit", + "version-control", + "automation", + "code-management" + ], + "examples": [ + { + "inputJson": "{\"commitMessage\":\"Add Terraform module for VPC setup\",\"authorName\":\"Alice Dev\",\"authorEmail\":\"alice@example.com\",\"branch\":\"main\",\"fileChanges\":[{\"filePath\":\"modules/vpc/main.tf\",\"changeType\":\"added\",\"content\":\"resource \\\"aws_vpc\\\" \\\"main\\\" { cidr_block = \\\"10.0.0.0/16\\\" }\"}],\"signCommit\":true}", + "description": "Adding a new Terraform module file for VPC setup on main branch with commit signing enabled." + }, + { + "inputJson": "{\"commitMessage\":\"Update Kubernetes deployment replicas\",\"authorName\":\"Bob Ops\",\"authorEmail\":\"bob@example.com\",\"branch\":\"prod\",\"fileChanges\":[{\"filePath\":\"deployments/backend.yaml\",\"changeType\":\"modified\",\"content\":\"replicas: 5\"}]}", + "description": "Modifying an existing Kubernetes deployment to scale replicas in the production branch." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Commit", + "context": null + } + }, + { + "name": "infrastructure-management.buildTest", + "description": "This tool accepts configuration and code parameters to programmatically generate and build automated test scripts for infrastructure components such as cloud deployments, configurations, and physical servers. It processes input definitions of infrastructure elements and outputs a ready-to-execute test suite validating desired properties like connectivity, performance, and compliance.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "testName", + "type": "string", + "description": "Name of the test suite to build", + "required": true, + "defaultValue": "" + }, + { + "name": "infrastructureType", + "type": "string", + "description": "Type of infrastructure (e.g., 'cloud', 'physical', 'hybrid') to target in the test", + "required": true, + "defaultValue": "" + }, + { + "name": "components", + "type": "array", + "description": "List of infrastructure components (e.g., servers, services) with their configurations to include in the test", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "Testing framework to use for generated tests (e.g., 'pytest', 'robotframework')", + "required": false, + "defaultValue": "pytest" + }, + { + "name": "testCases", + "type": "array", + "description": "Array specifying desired test cases and validations, such as connectivity checks, load tests, and compliance verifications", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output test files format or language (e.g., 'python', 'bash')", + "required": false, + "defaultValue": "python" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated test suite code as strings keyed by filename, and a summary of the test coverage and validations included" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create automated test suites based on infrastructure configurations or deployment definitions to validate infrastructure integrity and performance automatically. Ideal for continuous integration pipelines and automated validation workflows in infrastructure management.", + "limitations": "This tool does not execute the tests nor interact with live infrastructure. It generates test code but requires separate test execution environments and runtime context. It cannot infer unknown infrastructure components without defined input.", + "examples": [ + "Generate connectivity and performance tests for a cloud deployment with multiple services", + "Create compliance validation tests for physical servers’ configurations", + "Build load testing scripts targeting hybrid cloud infrastructure components" + ] + }, + "tags": [ + "infrastructure", + "testing", + "automation", + "cloud", + "physical", + "validation" + ], + "examples": [ + { + "inputJson": "{\"testName\":\"CloudDeploymentTest\",\"infrastructureType\":\"cloud\",\"components\":[{\"name\":\"web-server\",\"ip\":\"10.0.0.10\"},{\"name\":\"db-server\",\"ip\":\"10.0.0.11\"}],\"testFramework\":\"pytest\",\"testCases\":[{\"type\":\"connectivity\",\"target\":\"web-server\"},{\"type\":\"performance\",\"target\":\"db-server\"}],\"outputFormat\":\"python\"}", + "description": "Build a Python pytest suite to test connectivity and performance on cloud web and DB servers." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Test", + "context": null + } + }, + { + "name": "infrastructure-management.generateParagraph", + "description": "Generates a concise, informative paragraph describing a specific infrastructure component or concept based on provided keywords and context. Accepts keywords, optional detail level, and infrastructure type to produce tailored explanatory text useful for documentation, reports, or operational manuals.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "keywords", + "type": "array", + "description": "List of keywords or phrases related to the infrastructure component or concept to include in the paragraph.", + "required": true, + "defaultValue": "" + }, + { + "name": "infrastructureType", + "type": "string", + "description": "Type of infrastructure relevant to the content, e.g., cloud, network, physical, or general. Helps contextualize the generated paragraph.", + "required": false, + "defaultValue": "general" + }, + { + "name": "detailLevel", + "type": "string", + "description": "Desired granularity of the paragraph content. Options include 'summary', 'detailed', or 'technical'.", + "required": false, + "defaultValue": "summary" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended audience for the paragraph, such as 'engineers', 'managers', or 'general users' to adjust complexity and terminology.", + "required": false, + "defaultValue": "engineers" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph as a string under the key 'paragraph'." + }, + "aiAgent": { + "useCase": "Use when needing to programmatically generate human-readable descriptive paragraphs for infrastructure components or concepts to support documentation, onboarding, or reporting within infrastructure management contexts. It helps automate content creation based on specified keywords and context parameters.", + "limitations": "Cannot verify technical accuracy or replace expert review. May produce generic or incomplete paragraphs if keywords or context are insufficient.", + "examples": [ + "Generate a summary paragraph explaining cloud load balancers for engineers.", + "Create a detailed paragraph describing physical server rack cooling methods for managers.", + "Produce a technical description of network segmentation based on given keywords." + ] + }, + "tags": [ + "infrastructure", + "documentation", + "content-generation", + "cloud", + "network", + "physical", + "automation" + ], + "examples": [ + { + "inputJson": "{\"keywords\":[\"load balancer\",\"cloud\",\"high availability\"],\"infrastructureType\":\"cloud\",\"detailLevel\":\"summary\",\"targetAudience\":\"engineers\"}", + "description": "Generate a summary paragraph describing cloud load balancers focusing on high availability for engineers." + }, + { + "inputJson": "{\"keywords\":[\"server rack\",\"cooling\",\"air flow\"],\"infrastructureType\":\"physical\",\"detailLevel\":\"detailed\",\"targetAudience\":\"managers\"}", + "description": "Produce a detailed paragraph about server rack cooling and air flow directed at management." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "infrastructure-management.createService", + "description": "Creates a new infrastructure service within a cloud or on-premises environment. Accepts parameters specifying service type, configuration details, resource allocations, and optional tags. Provisions the service accordingly, returning deployment status and service identifiers.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "Name identifier for the new service to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "serviceType", + "type": "string", + "description": "Type of service to create (e.g., web-server, database, cache).", + "required": true, + "defaultValue": "" + }, + { + "name": "configuration", + "type": "object", + "description": "JSON object specifying service-specific configuration parameters such as version, environment variables, and custom settings.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "resourceAllocation", + "type": "object", + "description": "Object defining resource limits and requests, such as CPU cores, memory in MB, and storage size in GB.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "region", + "type": "string", + "description": "Geographical region or datacenter location where to deploy the service.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Array of string tags to assign to the service for categorization and management purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "autoScale", + "type": "boolean", + "description": "Flag indicating whether to enable autoscaling based on load.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing details of the created service, including unique service ID, deployment status, and any error messages if creation failed." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to provision a new infrastructure service, specifying type, configuration, and resource needs for automated environment setup and deployment orchestration.", + "limitations": "This tool does not handle the decommissioning or update of existing services. It also cannot configure services beyond initial provisioning parameters.", + "examples": [ + "Create a web-server service with 2 CPU cores and 4GB RAM in us-east region.", + "Deploy a database instance configured with version 12.5 and tags ['production','db'], enabling auto scaling.", + "Provision a caching layer service named 'app-cache' with specific environment variables and resource limits." + ] + }, + "tags": [ + "infrastructure", + "service", + "create", + "provisioning", + "cloud", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"web-app-01\",\"serviceType\":\"web-server\",\"configuration\":{\"version\":\"1.18\",\"env\":{\"NODE_ENV\":\"production\"}},\"resourceAllocation\":{\"cpuCores\":2,\"memoryMb\":4096},\"region\":\"us-east-1\",\"tags\":[\"frontend\",\"production\"],\"autoScale\":true}", + "description": "Create a web server service named 'web-app-01' in the US East region with 2 CPU cores, 4GB RAM, environment variable set, and autoscaling enabled." + }, + { + "inputJson": "{\"serviceName\":\"db-primary\",\"serviceType\":\"database\",\"configuration\":{\"dbVersion\":\"12.5\"},\"resourceAllocation\":{\"cpuCores\":4,\"memoryMb\":8192,\"storageGb\":100},\"region\":\"eu-west-2\",\"tags\":[\"production\",\"primary-db\"],\"autoScale\":false}", + "description": "Provision a primary database instance with specific version, 4 CPU cores, 8GB RAM, 100GB storage in EU West region without autoscaling." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Service", + "context": null + } + }, + { + "name": "infrastructure-management.createContainer", + "description": "Creates and deploys a new container instance in a specified cloud or on-premises infrastructure. Accepts container image details, resource constraints, networking settings, and environment variables as input, then provisions the container accordingly. Returns deployment metadata including container ID, status, and endpoint information.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "containerImage", + "type": "string", + "description": "The container image name and tag to deploy (e.g., nginx:latest).", + "required": true, + "defaultValue": "" + }, + { + "name": "cpuLimit", + "type": "number", + "description": "Maximum CPU units allocated to the container (e.g., 0.5 for half CPU).", + "required": false, + "defaultValue": "1" + }, + { + "name": "memoryLimitMb", + "type": "number", + "description": "Maximum memory in megabytes allocated to the container.", + "required": false, + "defaultValue": "512" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set inside the container.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "portMappings", + "type": "array", + "description": "List of port mappings to expose, each element an object with containerPort and hostPort.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "networkMode", + "type": "string", + "description": "Network mode for the container (e.g., bridge, host, none).", + "required": false, + "defaultValue": "bridge" + }, + { + "name": "restartPolicy", + "type": "string", + "description": "Container restart policy (no, on-failure, always, unless-stopped).", + "required": false, + "defaultValue": "always" + }, + { + "name": "labels", + "type": "object", + "description": "Optional metadata labels to apply to the container for identification or management.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "Deployment result including container ID, current status, assigned ports, and potential errors." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically launch containerized applications within infrastructure environments. Suitable for automating deployments, scaling services, or initializing test environments with specific configurations.", + "limitations": "This tool does not handle the orchestration of multi-container applications or management of container lifecycles beyond creation. It assumes the infrastructure environment is pre-configured and accessible.", + "examples": [ + "Deploy a web server container running nginx with 0.5 CPU and 256MB RAM, exposing port 80.", + "Create a container using a custom app image with specific environment variables and restart policy set to 'on-failure'.", + "Launch a container with host networking mode and custom port mappings." + ] + }, + "tags": [ + "infrastructure", + "container", + "deployment", + "cloud", + "automation" + ], + "examples": [ + { + "inputJson": "{\"containerImage\":\"nginx:latest\",\"cpuLimit\":0.5,\"memoryLimitMb\":256,\"portMappings\":[{\"containerPort\":80,\"hostPort\":8080}],\"environmentVariables\":{},\"networkMode\":\"bridge\",\"restartPolicy\":\"always\",\"labels\":{\"app\":\"webserver\"}}", + "description": "Deploy an nginx web server container with limited CPU and memory, exposing container port 80 to host port 8080." + }, + { + "inputJson": "{\"containerImage\":\"myorg/customapp:v2\",\"cpuLimit\":1,\"memoryLimitMb\":1024,\"environmentVariables\":{\"ENV\":\"production\",\"DEBUG\":\"false\"},\"restartPolicy\":\"on-failure\"}", + "description": "Create a custom application container with environment variables and a restart policy to retry on failure." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "infrastructure-management.createInvoice", + "description": "Creates a detailed invoice document for cloud or physical infrastructure services. Accepts client and service details including usage metrics, pricing, taxes, and payment terms; processes them to generate a structured invoice with line items, totals, and formatted output ready for billing.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "clientId", + "type": "string", + "description": "Unique identifier for the client to whom the invoice is issued", + "required": true, + "defaultValue": "" + }, + { + "name": "billingPeriodStart", + "type": "string", + "description": "Start date of the billing period in ISO 8601 format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "billingPeriodEnd", + "type": "string", + "description": "End date of the billing period in ISO 8601 format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "serviceItems", + "type": "array", + "description": "List of service items including description, quantity, unitPrice, and optionally usage metrics", + "required": true, + "defaultValue": "" + }, + { + "name": "taxRate", + "type": "number", + "description": "Applicable tax rate as a decimal (e.g., 0.07 for 7%)", + "required": false, + "defaultValue": "0" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code ISO 4217 format for the invoice amounts (e.g., USD, EUR)", + "required": false, + "defaultValue": "USD" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Payment terms description (e.g., Net 30, Due on receipt)", + "required": false, + "defaultValue": "Net 30" + }, + { + "name": "invoiceDate", + "type": "string", + "description": "Date the invoice is issued in ISO 8601 format (YYYY-MM-DD)", + "required": false, + "defaultValue": "" + }, + { + "name": "notes", + "type": "string", + "description": "Additional notes or comments to include on the invoice", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An invoice object with generated invoiceId, clientId, invoiceDate, billing period, line items with calculated totals, tax amounts, total due, currency, payment terms, and any notes" + }, + "aiAgent": { + "useCase": "Use this tool when generating invoices for infrastructure-related services or resource usage for clients, such as cloud compute, storage, networking, or physical hardware rentals. It helps automate billing document creation from service data and pricing details.", + "limitations": "This tool does not handle payment processing or client account management. It cannot fetch client data or service usage autonomously; all necessary input must be provided. It does not produce formatted PDFs but returns structured invoice data.", + "examples": [ + "Create an invoice for client ID 'C1234' for the usage period March 1-31, 2024 including compute and storage charges with a 10% tax rate in USD.", + "Generate an invoice with payment terms 'Due on receipt' and include notes about a service discount.", + "Produce an invoice with multiple service line items including quantity and unit price for billing." + ] + }, + "tags": [ + "infrastructure", + "billing", + "invoice", + "cloud", + "physical", + "document", + "automation", + "finance" + ], + "examples": [ + { + "inputJson": "{\"clientId\": \"C1234\", \"billingPeriodStart\": \"2024-03-01\", \"billingPeriodEnd\": \"2024-03-31\", \"serviceItems\": [{\"description\": \"Cloud Compute Hours\", \"quantity\": 120, \"unitPrice\": 0.15}, {\"description\": \"Storage GB-Month\", \"quantity\": 500, \"unitPrice\": 0.05}], \"taxRate\": 0.1, \"currency\": \"USD\", \"paymentTerms\": \"Net 30\", \"invoiceDate\": \"2024-04-01\", \"notes\": \"Thank you for your business.\"}", + "description": "Invoice for client C1234 for March 2024 cloud compute and storage usage with 10% tax." + }, + { + "inputJson": "{\"clientId\": \"C5678\", \"billingPeriodStart\": \"2024-05-01\", \"billingPeriodEnd\": \"2024-05-15\", \"serviceItems\": [{\"description\": \"Physical Server Rental\", \"quantity\": 15, \"unitPrice\": 25}], \"taxRate\": 0, \"currency\": \"EUR\", \"paymentTerms\": \"Due on receipt\", \"invoiceDate\": \"2024-05-16\", \"notes\": \"Please pay promptly.\"}", + "description": "Invoice for physical server rental for first half of May 2024 with no tax in EUR currency." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "infrastructure-management.createModule", + "description": "Creates a reusable infrastructure module by accepting configuration inputs such as resource definitions, variables, and outputs. The tool processes these inputs to generate a standardized module template file suitable for managing cloud or physical infrastructure as code, enabling infrastructure reuse and versioning.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "The name identifier for the infrastructure module to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "resourceDefinitions", + "type": "array", + "description": "An array of objects defining the resources, including type and configuration parameters, to be included in the module.", + "required": true, + "defaultValue": "" + }, + { + "name": "variables", + "type": "object", + "description": "Key-value pairs of variable names and their default values or types used within the module for parameterization.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "outputs", + "type": "object", + "description": "Key-value pairs defining outputs of the module, specifying output names and the expressions or attributes to expose.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "moduleDescription", + "type": "string", + "description": "A brief textual description of the purpose or functionality of the module.", + "required": false, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "The version tag or number for the module to enable versioning and tracking.", + "required": false, + "defaultValue": "1.0.0" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated module template file content as a string and metadata including the module name and version." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automate the creation of modular, reusable infrastructure-as-code components to accelerate deployment pipelines and enforce organization-wide standards. It helps AI agents generate standardized modules from resource specifications without manual coding.", + "limitations": "This tool does not validate the correctness of resource configurations against specific cloud provider schemas or guarantee syntactic correctness beyond template generation.", + "examples": [ + "Create a module named 'webServer' with resources for EC2 instances and security groups.", + "Generate a Terraform module for a database cluster including variables for node count and outputs for connection strings.", + "Produce a reusable infrastructure module from given resource definitions with version tagging." + ] + }, + "tags": [ + "infrastructure", + "module", + "automation", + "infrastructure-as-code", + "cloud", + "template-generation", + "devops" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"webServer\",\"resourceDefinitions\":[{\"type\":\"aws_instance\",\"name\":\"web\",\"properties\":{\"ami\":\"ami-123456\",\"instance_type\":\"t2.micro\"}},{\"type\":\"aws_security_group\",\"name\":\"web_sg\",\"properties\":{\"ingress\":[{\"protocol\":\"tcp\",\"from_port\":80,\"to_port\":80,\"cidr_blocks\":[\"0.0.0.0/0\"]}]}}],\"variables\":{\"instance_count\":\"number\"},\"outputs\":{\"instance_ids\":\"aws_instance.web.*.id\"},\"moduleDescription\":\"A module for deploying web servers with security group.\",\"version\":\"1.2.0\"}", + "description": "Create a module named 'webServer' with EC2 instance and security group resources, with variables and outputs, version 1.2.0." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "monitoring.composeReport", + "description": "Generates a comprehensive monitoring report by aggregating and analyzing system and application performance data from given sources over a specified time range. Accepts input data sources and parameters, processes metrics and logs, then outputs a structured report summarizing key performance indicators, trends, anomalies, and recommendations.", + "category": "monitoring", + "parameters": [ + { + "name": "dataSources", + "type": "array", + "description": "List of monitoring data source identifiers (e.g., metric servers, log aggregators) to include in the report", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "Start timestamp (ISO 8601) for the data range in the report", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "End timestamp (ISO 8601) for the data range in the report", + "required": true, + "defaultValue": "" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Format of the generated report, e.g., pdf, html, json", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Flag to include performance improvement recommendations in the report", + "required": false, + "defaultValue": "true" + }, + { + "name": "aggregateBy", + "type": "string", + "description": "Granularity level for data aggregation: e.g., hourly, daily, weekly", + "required": false, + "defaultValue": "daily" + } + ], + "returns": { + "type": "object", + "description": "Structured report containing summary metrics, detailed analysis per data source, detected anomalies, performance trends, and optional recommendations, serialized in the chosen report format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a periodic or on-demand monitoring report combining multiple sources of system and application performance data for assessment, decision-making, or auditing. It supports flexible time ranges, data aggregation, and output format options to tailor reports for different stakeholders.", + "limitations": "This tool does not collect raw monitoring data itself; it requires pre-existing accessible data sources. It also does not perform real-time alerting or live monitoring, focusing instead on retrospective report composition.", + "examples": [ + "Generate a daily performance report for the last week from CPU, memory, and application logs in PDF format.", + "Create an HTML report including anomaly detection and recommendations for the past 24 hours from specified monitoring servers.", + "Produce a JSON formatted weekly summary report aggregated by day for network and database performance metrics." + ] + }, + "tags": [ + "monitoring", + "reporting", + "performance", + "aggregation", + "analysis", + "system", + "application", + "metrics" + ], + "examples": [ + { + "inputJson": "{\"dataSources\":[\"cpuMetrics\",\"appLogs\"],\"startTime\":\"2024-05-01T00:00:00Z\",\"endTime\":\"2024-05-07T23:59:59Z\",\"reportFormat\":\"pdf\",\"includeRecommendations\":true,\"aggregateBy\":\"daily\"}", + "description": "Compose a detailed PDF report covering CPU and application log data over one week, aggregated daily, with recommendations." + }, + { + "inputJson": "{\"dataSources\":[\"networkStats\",\"dbMetrics\"],\"startTime\":\"2024-06-10T00:00:00Z\",\"endTime\":\"2024-06-10T23:59:59Z\",\"reportFormat\":\"html\",\"includeRecommendations\":false,\"aggregateBy\":\"hourly\"}", + "description": "Generate an HTML report for network and database metrics on a specific day, aggregated hourly, excluding recommendations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "monitoring.renderDocument", + "description": "This tool accepts structured performance monitoring data along with a template specification and renders a formatted document report. It processes input such as JSON performance metrics and custom templates to produce documents in formats like PDF or HTML, summarizing system and application monitoring results.", + "category": "monitoring", + "parameters": [ + { + "name": "performanceData", + "type": "object", + "description": "Structured JSON object containing system or application performance metrics to be included in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "template", + "type": "string", + "description": "Template identifier or string that defines the layout and style of the document report.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output document format, e.g., 'pdf', 'html', or 'docx'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Flag indicating whether to include graphical charts representing performance data.", + "required": false, + "defaultValue": "true" + }, + { + "name": "title", + "type": "string", + "description": "Optional title for the rendered document report.", + "required": false, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Optional author name to include in the document metadata.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the rendered document as a base64 encoded string and its MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a professional, formatted performance monitoring report document from raw monitoring data and user-defined templates. Helpful for sharing or archiving performance summaries in portable formats like PDF or HTML.", + "limitations": "This tool does not perform data collection or analysis, only renders provided data into documents. It cannot dynamically fetch monitoring data or generate templates internally.", + "examples": [ + "Render a PDF report summarizing CPU and memory usage for last week using a corporate template.", + "Generate an HTML performance summary including charts for application response times.", + "Create a DOCX document report titled 'Monthly Server Metrics' authored by 'Operations Team'." + ] + }, + "tags": [ + "monitoring", + "rendering", + "reporting", + "performance", + "document", + "pdf", + "html", + "charts" + ], + "examples": [ + { + "inputJson": "{\"performanceData\":{\"cpuUsage\":75.4,\"memoryUsage\":62.1,\"uptime\":123456},\"template\":\"corporateTemplate\",\"outputFormat\":\"pdf\",\"includeCharts\":true,\"title\":\"Weekly Performance Report\",\"author\":\"SysOps Team\"}", + "description": "Render a PDF report from monitoring data with charts using a corporate template and custom title/author." + }, + { + "inputJson": "{\"performanceData\":{\"responseTimes\":{\"avg\":180,\"p95\":300}},\"template\":\"simpleSummary\",\"outputFormat\":\"html\",\"includeCharts\":false}", + "description": "Generate a simple HTML document summarizing application response times without charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "render", + "object": "Document", + "context": null + } + }, + { + "name": "monitoring.createAlert", + "description": "Creates a monitoring alert for system or application performance metrics based on specified conditions. Accepts inputs defining the alert name, monitored metric, threshold values, comparison operators, evaluation period, notification channels, and severity level. Processes these inputs to configure and register an alert that triggers notifications when conditions are met, returning alert configuration details including a unique alert ID.", + "category": "monitoring", + "parameters": [ + { + "name": "alertName", + "type": "string", + "description": "The user-friendly name for the alert to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "metric", + "type": "string", + "description": "The name or identifier of the system or application metric to monitor (e.g., CPU usage, memory consumption).", + "required": true, + "defaultValue": "" + }, + { + "name": "threshold", + "type": "number", + "description": "The numeric threshold value which, when crossed, triggers the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "comparisonOperator", + "type": "string", + "description": "The operator to compare the metric against the threshold (e.g., '>', '<', '>=', '<=').", + "required": true, + "defaultValue": ">" + }, + { + "name": "evaluationPeriod", + "type": "number", + "description": "The duration in seconds during which the metric must satisfy the condition to trigger alert, preventing short spikes from triggering alerts.", + "required": true, + "defaultValue": "300" + }, + { + "name": "notificationChannels", + "type": "array", + "description": "List of notification channel identifiers (e.g., emails, SMS, webhook URLs) to send alerts to upon trigger.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "severity", + "type": "string", + "description": "The severity level of the alert such as 'info', 'warning', 'critical'.", + "required": false, + "defaultValue": "warning" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing details of the created alert including alertId, alertName, metric, threshold, condition, evaluationPeriod, notificationChannels, severity and creationTimestamp." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create monitoring alerts in environments where performance metrics need to be tracked and notifications dispatched upon threshold breaches. Ideal for automated monitoring configuration, dynamic alert adjustments, or provisioning alerts in new deployments.", + "limitations": "This tool does not perform actual metric collection or alert evaluation; it solely configures alert definitions. It also does not guarantee notification delivery as that depends on external channels.", + "examples": [ + "Create an alert when CPU usage exceeds 80% for more than 5 minutes, notify the operations team.", + "Set up a critical alert for memory usage above 90% with SMS and email notifications.", + "Add a warning alert for disk space below 10% with email notification only." + ] + }, + "tags": [ + "monitoring", + "alerting", + "performance", + "automation", + "notification", + "system", + "application" + ], + "examples": [ + { + "inputJson": "{\"alertName\":\"High CPU Usage\",\"metric\":\"cpuUsage\",\"threshold\":80,\"comparisonOperator\":\">\",\"evaluationPeriod\":300,\"notificationChannels\":[\"ops-team@example.com\",\"sms:+1234567890\"],\"severity\":\"critical\"}", + "description": "Create an alert for CPU usage exceeding 80% sustained for 5 minutes with critical severity and notify by email and SMS." + }, + { + "inputJson": "{\"alertName\":\"Low Disk Space\",\"metric\":\"diskFreePercent\",\"threshold\":10,\"comparisonOperator\":\"<\",\"evaluationPeriod\":600,\"notificationChannels\":[\"admin@example.com\"],\"severity\":\"warning\"}", + "description": "Create a warning alert for disk free space below 10% for 10 minutes, notifying admins by email only." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Alert", + "context": null + } + }, + { + "name": "monitoring.createConfig", + "description": "This tool generates a monitoring configuration file based on provided parameters such as monitored services, metrics, alert rules, and notification settings. It accepts input detailing these aspects, processes them to build a valid structured configuration (e.g., YAML or JSON), and outputs the ready-to-use config content as a string.", + "category": "monitoring", + "parameters": [ + { + "name": "monitoredServices", + "type": "array", + "description": "List of service names or identifiers to be monitored, e.g., ['web-server', 'database'].", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "Array of metric names to track for each service, e.g., ['cpu_usage', 'memory_usage'].", + "required": true, + "defaultValue": "" + }, + { + "name": "alertRules", + "type": "array", + "description": "List of alert rule objects defining conditions, thresholds, and severities for triggering alerts.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "notificationChannels", + "type": "array", + "description": "List of notification channel configurations (e.g., email addresses, webhook URLs) to send alerts to.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "configFormat", + "type": "string", + "description": "Desired output format of the configuration file, such as 'yaml' or 'json'.", + "required": false, + "defaultValue": "yaml" + }, + { + "name": "includeDefaults", + "type": "boolean", + "description": "Whether to include default monitoring settings and thresholds in the configuration.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing two fields: 'configContent' with the generated configuration file content as a string, and 'format' indicating the configuration file format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or update monitoring configuration files programmatically based on dynamic service and metric specifications, including alerting settings. It aids in automating deployment and updates of monitoring setups across environments.", + "limitations": "This tool generates configuration content but does not validate against all monitoring system schemas or deploy the configuration to monitoring infrastructure.", + "examples": [ + "Generate a monitoring config for webserver and database tracking CPU and memory with alert rules for high usage.", + "Create a JSON format config with custom notification channels for a microservices environment.", + "Produce a config with default settings included for common metrics monitoring." + ] + }, + "tags": [ + "monitoring", + "configuration", + "automation", + "alerting", + "metrics", + "infrastructure" + ], + "examples": [ + { + "inputJson": "{\"monitoredServices\":[\"web-server\",\"database\"],\"metrics\":[\"cpu_usage\",\"memory_usage\"],\"alertRules\":[{\"metric\":\"cpu_usage\",\"threshold\":80,\"duration\":\"5m\",\"severity\":\"critical\"}],\"notificationChannels\":[{\"type\":\"email\",\"address\":\"ops@example.com\"}],\"configFormat\":\"yaml\",\"includeDefaults\":true}", + "description": "Generate YAML config to monitor CPU and memory for web-server and database, with a critical alert for CPU usage over 80%, sending alerts by email." + }, + { + "inputJson": "{\"monitoredServices\":[\"auth-service\"],\"metrics\":[\"request_latency\"],\"alertRules\":[],\"notificationChannels\":[],\"configFormat\":\"json\",\"includeDefaults\":false}", + "description": "Generate JSON config monitoring request latency of auth-service without alert rules or notifications, excluding default settings." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Config", + "context": null + } + }, + { + "name": "compliance-management.uploadDocument", + "description": "Uploads a compliance-related document to the management system. Accepts document file data and metadata, validates required input, processes storage, and returns confirmation and document ID for tracking within compliance workflows.", + "category": "compliance-management", + "parameters": [ + { + "name": "documentName", + "type": "string", + "description": "The name/title of the compliance document being uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "Type/category of the compliance document (e.g., Policy, Audit Report)", + "required": true, + "defaultValue": "" + }, + { + "name": "fileContentBase64", + "type": "string", + "description": "Base64-encoded content of the document file to be uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "uploadedBy", + "type": "string", + "description": "Username or identifier of the user uploading the document", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Array of tags or keywords associated with the document for easier searching", + "required": false, + "defaultValue": "[]" + }, + { + "name": "confidential", + "type": "boolean", + "description": "Indicates if the document contains confidential information requiring restricted access", + "required": false, + "defaultValue": "false" + }, + { + "name": "uploadTimestamp", + "type": "string", + "description": "ISO8601 formatted timestamp of when the document is uploaded; if empty, server sets current time", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Confirmation data including unique document ID, status message, and metadata about the upload" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to help a user upload documents related to regulatory compliance, including policies, audit reports, or certifications, ensuring proper metadata is attached for easy retrieval and auditing. It supports file content encoding and metadata tagging for comprehensive document management workflows.", + "limitations": "This tool does not perform content validation against specific compliance regulations, nor does it parse or analyze the document’s internal content for policy adherence.", + "examples": [ + "Upload a company's updated privacy policy document with confidential tag included.", + "Submit an audit report file with relevant document type and uploader information.", + "Add ISO certification documents tagged under multiple compliance categories for system archival." + ] + }, + "tags": [ + "compliance", + "document", + "upload", + "file-management", + "regulatory", + "policy" + ], + "examples": [ + { + "inputJson": "{\"documentName\":\"Data Privacy Policy\",\"documentType\":\"Policy\",\"fileContentBase64\":\"VGhpcyBpcyBhIHRlc3QgZmlsZSBjb250ZW50Lg==\",\"uploadedBy\":\"jdoe\",\"tags\":[\"privacy\",\"data\",\"policy\"],\"confidential\":true}", + "description": "Uploading a confidential data privacy policy document with specific tags and uploader ID." + }, + { + "inputJson": "{\"documentName\":\"2023 Q1 Audit Report\",\"documentType\":\"Audit Report\",\"fileContentBase64\":\"QXVkaXQgcmVwb3J0IGNvbnRlbnQgdGVzdCBmaWxlLg==\",\"uploadedBy\":\"audit_team\"}", + "description": "Uploading a quarterly audit report document with uploader information but no tags or confidentiality." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "compliance-management.createText", + "description": "Creates compliance-related text documents based on provided regulatory topics, jurisdiction, and document type. Accepts inputs such as compliance area, jurisdiction, purpose, and tone, and generates clear, formatted text that addresses specified compliance requirements, aiding regulatory adherence and documentation preparation.", + "category": "compliance-management", + "parameters": [ + { + "name": "complianceArea", + "type": "string", + "description": "The specific area of compliance to address (e.g., GDPR, HIPAA).", + "required": true, + "defaultValue": "" + }, + { + "name": "jurisdiction", + "type": "string", + "description": "The legal jurisdiction or region (e.g., EU, US, California) for regulation applicability.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "Type of compliance document to generate (e.g., policy, guideline, summary).", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "The intended purpose or context of the document (e.g., internal training, external audit).", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the generated text (e.g., formal, concise, explanatory).", + "required": false, + "defaultValue": "formal" + }, + { + "name": "additionalContext", + "type": "string", + "description": "Any additional context or specifications to tailor the compliance text output.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated compliance text document, including title, body text, and metadata such as compliance area, jurisdiction, and document type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate compliance-related textual content customized for specific regulatory areas and jurisdictions. It helps automate the creation of policies, guidelines, or summaries for compliance management, ensuring documents align with requested compliance requirements and tones.", + "limitations": "The tool cannot provide legally binding advice or certify regulatory compliance; it generates informative text based on input parameters and does not replace professional legal consultation.", + "examples": [ + "Create a GDPR compliance policy document for the EU jurisdiction with a formal tone.", + "Generate a HIPAA guideline summary for internal training use in the US healthcare sector.", + "Produce a California privacy regulation compliance overview with an explanatory tone for external audit purposes." + ] + }, + "tags": [ + "compliance", + "text-generation", + "policy", + "regulatory", + "documentation", + "legal", + "automation" + ], + "examples": [ + { + "inputJson": "{\"complianceArea\":\"GDPR\",\"jurisdiction\":\"EU\",\"documentType\":\"policy\",\"purpose\":\"internal training\",\"tone\":\"formal\",\"additionalContext\":\"focus on data protection measures\"}", + "description": "Generating a formal GDPR compliance policy document for internal training with emphasis on data protection." + }, + { + "inputJson": "{\"complianceArea\":\"HIPAA\",\"jurisdiction\":\"US\",\"documentType\":\"guideline\",\"purpose\":\"external audit\",\"tone\":\"concise\",\"additionalContext\":\"highlight patient data security protocols\"}", + "description": "Creating a concise HIPAA guideline document aimed at external audits focused on patient data security protocols." + }, + { + "inputJson": "{\"complianceArea\":\"CCPA\",\"jurisdiction\":\"California\",\"documentType\":\"summary\",\"purpose\":\"compliance overview\",\"tone\":\"explanatory\",\"additionalContext\":\"include recent amendments\"}", + "description": "Producing an explanatory summary of California Consumer Privacy Act compliance including recent amendments for overview purposes." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "security-tools.analyzeLink", + "description": "This tool accepts a URL as input and performs an in-depth security analysis of the link. It checks for URL safety, phishing characteristics, malware hosting, SSL certificate validity, and other common web threats. The output is a detailed report indicating potential risks, suspicious patterns, and security status to help users decide if the link is safe to access.", + "category": "security-tools", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The URL string of the link to analyze for security risks.", + "required": true, + "defaultValue": "" + }, + { + "name": "checkMalware", + "type": "boolean", + "description": "Whether to check the link against known malware databases (can increase analysis time).", + "required": false, + "defaultValue": "true" + }, + { + "name": "checkPhishing", + "type": "boolean", + "description": "Whether to scan for phishing indicators in the URL and webpage content (if accessible).", + "required": false, + "defaultValue": "true" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum amount of time in seconds to wait for network responses during analysis.", + "required": false, + "defaultValue": "10" + }, + { + "name": "checkSslCertificate", + "type": "boolean", + "description": "Verify SSL/TLS certificate validity and expiry if the link uses HTTPS.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the security analysis results including risk scores, detected issues, and recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent encounters a URL and needs to assess its security before user interaction, to prevent phishing, malware, or other web-based threats. It is useful in email scanning, chat moderation, or automated alert systems.", + "limitations": "This tool cannot guarantee absolute safety as new or unknown threats might not be detected; it may also produce false positives or negatives depending on heuristic analyses and external databases.", + "examples": [ + "Analyze if a given URL is a phishing site.", + "Check if a shared link in a message hosts malware.", + "Verify the SSL certificate and safety of a URL before clicking." + ] + }, + "tags": [ + "security", + "link analysis", + "phishing detection", + "malware scan", + "url safety", + "ssl verification" + ], + "examples": [ + { + "inputJson": "{\"url\":\"http://example.com/login\"}", + "description": "Basic analysis of a simple HTTP URL to check for common security issues." + }, + { + "inputJson": "{\"url\":\"https://securebank.com\",\"checkMalware\":true,\"checkPhishing\":true,\"timeoutSeconds\":15}", + "description": "Comprehensive scan of a banking site URL including malware and phishing checks with extended timeout." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Link", + "context": null + } + }, + { + "name": "security-tools.analyzePayment", + "description": "Analyzes payment transaction data to detect potential security risks such as fraud indicators, anomalies, and compliance violations. Accepts structured payment details, performs pattern and anomaly detection using heuristics and ML models, and outputs a detailed risk assessment report with risk scores and flagged issues.", + "category": "security-tools", + "parameters": [ + { + "name": "paymentData", + "type": "object", + "description": "Structured JSON object representing the payment transaction details, including payer, payee, amounts, timestamps, and metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "fraudDetectionEnabled", + "type": "boolean", + "description": "Flag to enable or disable fraud pattern detection analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "anomalyDetectionEnabled", + "type": "boolean", + "description": "Flag to enable or disable anomaly detection in payment behavior and metadata.", + "required": false, + "defaultValue": "true" + }, + { + "name": "complianceCheckEnabled", + "type": "boolean", + "description": "Flag to enable or disable compliance rule checks on payment data.", + "required": false, + "defaultValue": "true" + }, + { + "name": "riskThreshold", + "type": "number", + "description": "Numeric threshold (0-100) above which payments will be flagged as high risk.", + "required": false, + "defaultValue": "75" + }, + { + "name": "customRules", + "type": "array", + "description": "Optional array of custom compliance or risk evaluation rules to apply during analysis.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A risk assessment report containing an overall risk score, detailed findings per category (fraud, anomaly, compliance), and flagged suspicious attributes with explanations." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate payment transactions for security concerns, such as detecting fraud, unusual activity, or regulatory compliance issues before processing or for audit purposes.", + "limitations": "This tool does not process raw unstructured data such as images or unformatted text invoices. It cannot guarantee fraud detection, only risk scoring based on known patterns and rules.", + "examples": [ + "Analyze payment transaction for fraud risk and compliance before approval.", + "Check a batch of payment records for anomalies and generate a risk report.", + "Verify if a payment meets regulatory compliance and identify suspicious fields." + ] + }, + "tags": [ + "security", + "payment", + "fraudDetection", + "anomalyDetection", + "compliance", + "riskAssessment", + "transactionAnalysis" + ], + "examples": [ + { + "inputJson": "{\"paymentData\":{\"transactionId\":\"TX123456789\",\"payer\":{\"name\":\"Alice Smith\",\"account\":\"AC987654321\"},\"payee\":{\"name\":\"Bob's Electronics\",\"account\":\"AC123456789\"},\"amount\":2500.0,\"currency\":\"USD\",\"timestamp\":\"2024-05-20T13:45:00Z\",\"method\":\"credit_card\",\"metadata\":{\"ipAddress\":\"192.168.0.15\",\"deviceId\":\"device123\"}},\"fraudDetectionEnabled\":true,\"anomalyDetectionEnabled\":true,\"complianceCheckEnabled\":true,\"riskThreshold\":70}", + "description": "Analyze a single credit card payment transaction for fraud, anomalies, and compliance risks with default detection flags enabled and a risk threshold of 70." + }, + { + "inputJson": "{\"paymentData\":{\"transactionId\":\"TX987654321\",\"payer\":{\"name\":\"Charlie Brown\",\"account\":\"AC222333444\"},\"payee\":{\"name\":\"Global Importers\",\"account\":\"AC555666777\"},\"amount\":150000.0,\"currency\":\"EUR\",\"timestamp\":\"2024-05-18T08:30:00Z\",\"method\":\"wire_transfer\",\"metadata\":{\"ipAddress\":\"10.0.0.8\",\"deviceId\":\"device789\"}},\"fraudDetectionEnabled\":true,\"anomalyDetectionEnabled\":false,\"complianceCheckEnabled\":true,\"riskThreshold\":80,\"customRules\":[{\"ruleId\":\"AML1\",\"description\":\"Flag transactions >100000 EUR\",\"condition\":\"amount > 100000 && currency == 'EUR'\"}]}", + "description": "Analyze a high-value wire transfer payment with custom compliance rules, disabling anomaly detection but keeping fraud and compliance checks." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Payment", + "context": null + } + }, + { + "name": "security-tools.analyzeRisk", + "description": "Analyzes security risks based on provided system components, threat vectors, and existing controls. Accepts details about assets, vulnerabilities, and potential threats as input, processes them to evaluate risk levels (low, medium, high), and outputs a structured risk assessment report including recommendations for mitigation.", + "category": "security-tools", + "parameters": [ + { + "name": "assets", + "type": "array", + "description": "List of critical assets or components of the system to analyze risk for, each with identifier and type.", + "required": true, + "defaultValue": "" + }, + { + "name": "vulnerabilities", + "type": "array", + "description": "Known vulnerabilities with severity scores relevant to the assets, including CVE references if available.", + "required": true, + "defaultValue": "" + }, + { + "name": "threatVectors", + "type": "array", + "description": "Descriptions of potential threat vectors or attack methods that could target the assets.", + "required": true, + "defaultValue": "" + }, + { + "name": "existingControls", + "type": "array", + "description": "List of existing security controls and mitigations currently implemented in the environment.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "assessmentDate", + "type": "string", + "description": "Date of the assessment in ISO 8601 format, defaults to current date if not provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Structured risk assessment report including risk levels per asset, risk factors, likelihood, impact ratings, and suggested mitigations." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to assist in evaluating the security risks of specific system components by integrating details about assets, vulnerabilities, and threat vectors. It helps to quantify risk levels and recommend prioritized mitigation steps to enhance security posture.", + "limitations": "Does not perform real-time vulnerability scanning or penetration testing; it relies on user-provided data. It cannot guarantee absolute risk elimination and should be complemented with manual expert review.", + "examples": [ + "Analyze the risk of our web application including known CVEs and current firewall protections.", + "Evaluate risks related to the new cloud infrastructure assets incorporating potential insider threats.", + "Provide a risk assessment report for IoT devices in our network given their reported vulnerabilities." + ] + }, + "tags": [ + "security", + "risk-analysis", + "vulnerability", + "threat-modeling", + "risk-assessment" + ], + "examples": [ + { + "inputJson": "{\"assets\":[{\"id\":\"web-server-1\",\"type\":\"web-server\"},{\"id\":\"db-01\",\"type\":\"database\"}],\"vulnerabilities\":[{\"cve\":\"CVE-2021-44228\",\"severity\":9.8,\"assetId\":\"web-server-1\"}],\"threatVectors\":[\"remote code execution via crafted log messages\"],\"existingControls\":[\"WAF\",\"network segmentation\"]}", + "description": "Risk analysis for a web server and database with a known critical vuln and existing protections" + }, + { + "inputJson": "{\"assets\":[{\"id\":\"iot-thermostat-23\",\"type\":\"IoT-device\"}],\"vulnerabilities\":[{\"id\":\"vuln-001\",\"severity\":7.5,\"description\":\"default credentials\"}],\"threatVectors\":[\"unauthorized remote access\"],\"existingControls\":[]}", + "description": "Assess risk of an IoT device with default credentials as vulnerability and no existing controls" + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Risk", + "context": null + } + }, + { + "name": "security-tools.sendAlert", + "description": "Sends a security alert notification to specified recipients. Accepts alert details including severity, message, and affected systems, and delivers the alert through configured channels such as email, SMS, or webhook, providing delivery status as output.", + "category": "security-tools", + "parameters": [ + { + "name": "alertTitle", + "type": "string", + "description": "The concise title or summary of the alert message.", + "required": true, + "defaultValue": "" + }, + { + "name": "alertMessage", + "type": "string", + "description": "Detailed description of the security issue or incident triggering the alert.", + "required": true, + "defaultValue": "" + }, + { + "name": "severityLevel", + "type": "string", + "description": "Alert severity classification (e.g., low, medium, high, critical) indicating urgency.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient contact points such as email addresses or phone numbers.", + "required": true, + "defaultValue": "" + }, + { + "name": "channels", + "type": "array", + "description": "List of communication channels to use for sending the alert (e.g., email, sms, webhook).", + "required": false, + "defaultValue": "[\"email\"]" + }, + { + "name": "affectedSystems", + "type": "array", + "description": "Optional list of affected system names or identifiers relevant to the alert context.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional key-value information to attach with the alert for context.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "Returns the status of alert delivery including each channel's success or failure and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when a security event or anomaly requires notifying relevant personnel or systems promptly. It helps automate alert dissemination with context and severity over multiple channels for timely incident response.", + "limitations": "This tool does not assess or detect security events; it only sends alerts when provided with complete alert information. It cannot guarantee delivery due to external system failures or incorrect recipient data.", + "examples": [ + "Send a critical alert about a detected intrusion to the security team via email and SMS.", + "Notify system admins of a medium severity vulnerability found in the web server with affected systems listed.", + "Dispatch a high severity alert including metadata to a webhook for automated processing." + ] + }, + "tags": [ + "security", + "alerting", + "notification", + "incident-response", + "email", + "sms", + "webhook" + ], + "examples": [ + { + "inputJson": "{\"alertTitle\":\"Unauthorized Access Detected\",\"alertMessage\":\"Multiple failed login attempts detected on the admin panel.\",\"severityLevel\":\"high\",\"recipients\":[\"security-team@example.com\",\"+15551234567\"],\"channels\":[\"email\",\"sms\"],\"affectedSystems\":[\"AdminPanel\"],\"metadata\":{\"ipAddress\":\"203.0.113.42\"}}", + "description": "Send a high severity alert about unauthorized access attempts to email and SMS recipients." + }, + { + "inputJson": "{\"alertTitle\":\"Web Server Vulnerability\",\"alertMessage\":\"A medium severity vulnerability was found in Apache server version 2.4.46.\",\"severityLevel\":\"medium\",\"recipients\":[\"sysadmin@example.com\"],\"channels\":[\"email\"],\"affectedSystems\":[\"WebServer1\"],\"metadata\":{}}", + "description": "Email a medium severity vulnerability alert to system administrators with details on affected server." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Alert", + "context": null + } + }, + { + "name": "security-tools.formatContract", + "description": "Formats legal or technical contract text to standardized structures by applying consistent indentation, section numbering, clause formatting, and style rules. Accepts raw contract text and configuration options, and outputs a clean, well-structured formatted contract document as a string.", + "category": "security-tools", + "parameters": [ + { + "name": "contractText", + "type": "string", + "description": "Raw text of the contract to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Name of the style guide to apply for formatting (e.g., 'APA', 'CustomCompanyGuide').", + "required": false, + "defaultValue": "StandardLegal" + }, + { + "name": "indentationSpaces", + "type": "number", + "description": "Number of spaces to use for indentation in the formatted contract.", + "required": false, + "defaultValue": "4" + }, + { + "name": "numberSections", + "type": "boolean", + "description": "Whether to apply automatic numbering to contract sections and clauses.", + "required": false, + "defaultValue": "true" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line width before wrapping text in the contract formatting.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully formatted contract as a string under 'formattedContract' key." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to assist in preparing, reviewing, or standardizing contract documents by generating consistently formatted outputs from raw or variably styled input texts. It ensures readability and compliance with a desired formatting style, facilitating contract analysis, presentation, or further processing.", + "limitations": "This tool does not interpret legal meaning, validate contract terms, or replace human review by legal professionals. It focuses solely on text formatting, not on content correctness or legal enforceability.", + "examples": [ + "Format this raw contract text according to the company's standard legal formatting style.", + "Indent the provided contract text using 2 spaces and do not number sections.", + "Reformat the contract text to a maximum line width of 100 characters and apply APA style guide formatting." + ] + }, + "tags": [ + "security-tools", + "formatting", + "contract", + "document-standardization", + "legal-documents" + ], + "examples": [ + { + "inputJson": "{\"contractText\":\"This Agreement is made on the date of execution. The Parties agree as follows: First, the Seller will deliver goods. Second, the Buyer will remit payment.\",\"styleGuide\":\"StandardLegal\",\"indentationSpaces\":4,\"numberSections\":true,\"lineWidth\":80}", + "description": "Format a simple contract with default style guide, 4 spaces indentation, with section numbering, and 80 characters line width." + }, + { + "inputJson": "{\"contractText\":\"Confidentiality Clause: The Recipient shall hold all information...\",\"indentationSpaces\":2,\"numberSections\":false}", + "description": "Format a confidentiality clause snippet with 2-space indentation and no automatic numbering." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Contract", + "context": null + } + }, + { + "name": "security-tools.composeMessage", + "description": "This tool accepts message parameters including recipient info, message content, and security preferences to create a securely composed communication message. It processes inputs to format the message, optionally encrypt, digitally sign, and append metadata for integrity and confidentiality. The output is a fully formatted secure message ready for transmission.", + "category": "security-tools", + "parameters": [ + { + "name": "recipient", + "type": "object", + "description": "Recipient details including email or user ID and optional public key for encryption", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject or title of the message", + "required": false, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content of the message", + "required": true, + "defaultValue": "" + }, + { + "name": "encrypt", + "type": "boolean", + "description": "Flag indicating whether to encrypt the message", + "required": false, + "defaultValue": "false" + }, + { + "name": "sign", + "type": "boolean", + "description": "Flag indicating whether to digitally sign the message", + "required": false, + "defaultValue": "false" + }, + { + "name": "senderPrivateKey", + "type": "string", + "description": "Sender's private key used for signing; required if sign=true", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional metadata or headers to attach to the message", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Securely composed message object including formatted content, encryption/signature status, and metadata" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to assemble a secure communication message that may require encryption and/or digital signing before sending to a recipient, ensuring confidentiality and authenticity of the content.", + "limitations": "This tool does not transmit messages; it only composes secure message objects. It requires valid cryptographic keys externally provided. It cannot generate keys or manage key distribution.", + "examples": [ + "Compose a signed and encrypted message to user Alice with a specific body text.", + "Create a plain message to an internal user without encryption or signature.", + "Add custom metadata and encrypt the message before composing it." + ] + }, + "tags": [ + "security", + "messaging", + "encryption", + "digital-signature", + "communication", + "secure-message" + ], + "examples": [ + { + "inputJson": "{\"recipient\":{\"email\":\"alice@example.com\",\"publicKey\":\"BASE64ENCODEDPUBLICKEY==\"},\"subject\":\"Meeting Update\",\"body\":\"Please find the updated meeting agenda attached.\",\"encrypt\":true,\"sign\":true,\"senderPrivateKey\":\"BASE64ENCODEDPRIVATEKEY==\",\"metadata\":{\"priority\":\"high\"}}", + "description": "Compose a signed and encrypted message to recipient Alice with high priority metadata." + }, + { + "inputJson": "{\"recipient\":{\"userId\":\"bob123\"},\"body\":\"Hello Bob, your report is due tomorrow.\",\"encrypt\":false,\"sign\":false}", + "description": "Compose a simple unencrypted, unsigned message to internal user Bob." + }, + { + "inputJson": "{\"recipient\":{\"email\":\"carol@example.com\",\"publicKey\":\"BASE64ENCODEDPUBLICKEY==\"},\"body\":\"Confidential: Please review the attached document.\",\"encrypt\":true,\"sign\":false,\"metadata\":{\"confidential\":\"true\"}}", + "description": "Compose an encrypted message to Carol with confidentiality metadata but without a signature." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Message", + "context": null + } + }, + { + "name": "security-tools.buildConfig", + "description": "This tool generates a security configuration file for an application or infrastructure component. It accepts inputs specifying security requirements such as allowed IP ranges, required authentication methods, encryption standards, and audit logging preferences. It processes these inputs to build a structured configuration object or file snippet ready to be integrated into deployment pipelines or security management systems.", + "category": "security-tools", + "parameters": [ + { + "name": "allowedIpRanges", + "type": "array", + "description": "List of IP address ranges (CIDR notation) allowed to access the system.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "authenticationMethod", + "type": "string", + "description": "The authentication method to configure (e.g., 'OAuth2', 'SAML', 'APIKey','None').", + "required": true, + "defaultValue": "" + }, + { + "name": "encryptionLevel", + "type": "string", + "description": "The encryption standard to use (e.g., 'AES256', 'RSA2048', 'None').", + "required": true, + "defaultValue": "AES256" + }, + { + "name": "enableAuditLogging", + "type": "boolean", + "description": "Flag to enable or disable audit logging of security events.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLoginAttempts", + "type": "number", + "description": "Maximum number of allowed failed login attempts before lockout.", + "required": false, + "defaultValue": "5" + }, + { + "name": "passwordPolicy", + "type": "object", + "description": "Object specifying password policy parameters such as minimum length, complexity requirements, and expiry days.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "allowedProtocols", + "type": "array", + "description": "List of allowed network protocols (e.g., ['TLS1.2','TLS1.3']).", + "required": false, + "defaultValue": "[\"TLS1.2\",\"TLS1.3\"]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full security configuration as JSON, including all specified parameters structured according to security best practices, ready for deployment." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create or update security configuration files for applications or infrastructure components, ensuring consistent, automated application of security policies across environments.", + "limitations": "This tool generates configuration based on inputs but does not validate them against actual environment constraints or perform deployment; integration and deployment are separate processes.", + "examples": [ + "Generate a security config with OAuth2 authentication, AES256 encryption, and audit logging enabled.", + "Create a config allowing only specific IP ranges with API key authentication and a strict password policy.", + "Build a security config disabling audit logging but requiring TLS 1.3 protocol and setting maximum login attempts to 3." + ] + }, + "tags": [ + "security", + "configuration", + "automation", + "infrastructure", + "policy" + ], + "examples": [ + { + "inputJson": "{\"allowedIpRanges\":[\"192.168.1.0/24\",\"10.0.0.0/16\"],\"authenticationMethod\":\"OAuth2\",\"encryptionLevel\":\"AES256\",\"enableAuditLogging\":true,\"maxLoginAttempts\":5,\"passwordPolicy\":{\"minLength\":12,\"requireSpecialChars\":true,\"expiryDays\":90},\"allowedProtocols\":[\"TLS1.2\",\"TLS1.3\"]}", + "description": "Generate a comprehensive security config with OAuth2, AES256, audit logging, IP restrictions, and strict password policy." + }, + { + "inputJson": "{\"authenticationMethod\":\"APIKey\",\"encryptionLevel\":\"RSA2048\",\"enableAuditLogging\":false,\"maxLoginAttempts\":3,\"allowedProtocols\":[\"TLS1.3\"]}", + "description": "Create a config for API key authentication with RSA encryption, audit logging disabled, strict login attempts and TLS 1.3 only." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Config", + "context": null + } + }, + { + "name": "security-tools.createKPI", + "description": "This tool creates security-focused Key Performance Indicators (KPIs) by accepting configuration parameters such as name, description, calculation formula, data sources, and target thresholds. It processes these inputs to generate a structured KPI object that can be used for monitoring and reporting security metrics effectively.", + "category": "security-tools", + "parameters": [ + { + "name": "kpiName", + "type": "string", + "description": "The name of the KPI to create, which identifies it clearly within reports and dashboards.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed explanation of what the KPI measures and its significance.", + "required": false, + "defaultValue": "" + }, + { + "name": "calculationFormula", + "type": "string", + "description": "The formula or method used to compute the KPI value from raw security data.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataSources", + "type": "array", + "description": "An array of identifiers representing data sources or metrics used as inputs to the KPI calculation.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetThreshold", + "type": "number", + "description": "The desired or acceptable value threshold for the KPI to indicate healthy security posture.", + "required": false, + "defaultValue": "" + }, + { + "name": "aggregationFrequency", + "type": "string", + "description": "The frequency at which KPI is calculated and aggregated, e.g., hourly, daily, weekly.", + "required": false, + "defaultValue": "daily" + }, + { + "name": "alertOnThresholdBreach", + "type": "boolean", + "description": "Flag to indicate whether to trigger alerts if KPI value crosses the target threshold.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Structured KPI object including id, name, description, formula, data sources, threshold details, and metadata for monitoring use." + }, + "aiAgent": { + "useCase": "Use this tool when needing to define and formalize security KPIs for monitoring application and infrastructure security posture. It helps automate and standardize metric definitions critical for security reporting and alerting systems.", + "limitations": "Does not perform the actual data collection, validation, or real-time calculation of KPIs. It only defines and creates configuration objects representing KPIs.", + "examples": [ + "Create a KPI named 'Failed Login Attempts Rate' with formula counting failed logins per day from authentication logs, setting alert if exceeding 100 attempts.", + "Define a KPI measuring 'Patch Compliance Percentage' calculated weekly from asset management data with a target threshold of 95%." + ] + }, + "tags": [ + "security", + "KPI", + "metrics", + "monitoring", + "analytics", + "reporting", + "thresholds", + "alerts" + ], + "examples": [ + { + "inputJson": "{\"kpiName\":\"Failed Login Attempts Rate\",\"description\":\"Counts number of failed login attempts per day to detect potential brute force attacks.\",\"calculationFormula\":\"count(failed_login_events)\",\"dataSources\":[\"auth_logs\"],\"targetThreshold\":100,\"aggregationFrequency\":\"daily\",\"alertOnThresholdBreach\":true}", + "description": "Create KPI measuring daily failed login attempts with alert threshold at 100." + }, + { + "inputJson": "{\"kpiName\":\"Patch Compliance Percentage\",\"description\":\"Percentage of devices with latest security patches applied.\",\"calculationFormula\":\"(patched_devices / total_devices) * 100\",\"dataSources\":[\"asset_management\"],\"targetThreshold\":95,\"aggregationFrequency\":\"weekly\",\"alertOnThresholdBreach\":true}", + "description": "Create KPI for weekly patch compliance to ensure minimum 95% coverage." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "KPI", + "context": null + } + }, + { + "name": "security-tools.createRisk", + "description": "Creates a structured security risk profile based on input parameters describing system assets, threat scenarios, vulnerabilities, and potential impacts. Processes inputs to compute likelihood, impact, and risk level, returning a comprehensive risk object for use in risk management and mitigation planning.", + "category": "security-tools", + "parameters": [ + { + "name": "assetName", + "type": "string", + "description": "Name of the asset under assessment", + "required": true, + "defaultValue": "" + }, + { + "name": "assetType", + "type": "string", + "description": "Type/category of the asset (e.g., application, database, infrastructure)", + "required": true, + "defaultValue": "" + }, + { + "name": "threatScenario", + "type": "string", + "description": "Description of the threat or attacker scenario considered", + "required": true, + "defaultValue": "" + }, + { + "name": "vulnerabilities", + "type": "array", + "description": "List of known vulnerabilities affecting the asset", + "required": false, + "defaultValue": "[]" + }, + { + "name": "impactDescription", + "type": "string", + "description": "Description of potential impacts if the risk is realized", + "required": true, + "defaultValue": "" + }, + { + "name": "likelihoodScore", + "type": "number", + "description": "Numerical score (0-10) representing the likelihood of risk occurrence", + "required": true, + "defaultValue": "" + }, + { + "name": "impactScore", + "type": "number", + "description": "Numerical score (0-10) representing the severity of the impact", + "required": true, + "defaultValue": "" + }, + { + "name": "riskOwner", + "type": "string", + "description": "Person or team responsible for managing the risk", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Risk profile object containing asset info, threat scenario, vulnerabilities, scores for likelihood, impact, computed risk level, and recommended mitigation status" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to assess or document a security risk by combining qualitative and quantitative input about an asset and its threats to produce a formal risk entity useful for security management workflows.", + "limitations": "This tool does not automatically discover vulnerabilities or assess threats; it requires user-provided inputs. It also does not recommend specific mitigations beyond indicating risk level.", + "examples": [ + "Create a risk profile for a web application with SQL injection vulnerability, describing potential data breach impact.", + "Assess risk for cloud infrastructure exposed to DDoS attack with estimated likelihood and impact scores.", + "Document security risk for IoT device susceptible to firmware tampering with corresponding threat and impact descriptions." + ] + }, + "tags": [ + "security", + "risk management", + "risk assessment", + "threat modeling", + "vulnerability" + ], + "examples": [ + { + "inputJson": "{\"assetName\":\"Customer Web Portal\",\"assetType\":\"application\",\"threatScenario\":\"SQL Injection attack via user input fields\",\"vulnerabilities\":[\"CWE-89\"],\"impactDescription\":\"Unauthorized data exfiltration and data integrity loss.\",\"likelihoodScore\":7,\"impactScore\":8,\"riskOwner\":\"Web Security Team\"}", + "description": "Creating a risk profile for a customer web portal vulnerable to SQL injection, analyzing impact and likelihood." + }, + { + "inputJson": "{\"assetName\":\"Corporate Database Server\",\"assetType\":\"database\",\"threatScenario\":\"Ransomware attack encrypting production data\",\"vulnerabilities\":[\"Unpatched OS\",\"Weak access control\"],\"impactDescription\":\"Loss of data availability causing operational disruption.\",\"likelihoodScore\":6,\"impactScore\":9,\"riskOwner\":\"IT Security\"}", + "description": "Assessing ransomware risk on corporate database with known system weaknesses." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Risk", + "context": null + } + }, + { + "name": "security-tools.createTable", + "description": "Creates a security-focused data table to organize and track security-related items such as vulnerabilities, audit logs, or incident reports. Accepts column definitions and row data, validates input types, and outputs a structured table object suitable for security analysis and reporting.", + "category": "security-tools", + "parameters": [ + { + "name": "tableName", + "type": "string", + "description": "The name identifier for the security table to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "columns", + "type": "array", + "description": "An array of objects defining column names and data types (e.g., {name: 'vulnerabilityId', type: 'string'}).", + "required": true, + "defaultValue": "" + }, + { + "name": "rows", + "type": "array", + "description": "An array of objects representing the rows of data, where each object keys correspond to column names.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "primaryKey", + "type": "string", + "description": "The column name that acts as the primary key for unique row identification.", + "required": false, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Optional description of the table's purpose or contents.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created security table, including metadata and structured data for further processing or querying." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create and initialize a structured table for organizing security-related data such as vulnerability tracking, audit trails, or compliance reports. It serves to standardize security data capture for analytics or dashboarding.", + "limitations": "This tool creates the table structure and initial data but does not enforce complex relational constraints or perform real-time security analytics. It is not a database engine and does not persist data beyond the returned object.", + "examples": [ + "Create a table named 'VulnerabilityTracker' with columns for 'vulnerabilityId' (string), 'severity' (string), and 'discoveredDate' (string), inserting initial vulnerability data.", + "Generate a table to log incident reports with columns for 'incidentId', 'description', 'resolved' (boolean), and 'resolutionDate'.", + "Create an empty audit log table with columns 'logId', 'timestamp', 'action', and 'userId' for subsequent data insertion." + ] + }, + "tags": [ + "security", + "table", + "data-organization", + "vulnerability-tracking", + "incident-logging", + "audit" + ], + "examples": [ + { + "inputJson": "{\"tableName\":\"VulnerabilityTracker\",\"columns\":[{\"name\":\"vulnerabilityId\",\"type\":\"string\"},{\"name\":\"severity\",\"type\":\"string\"},{\"name\":\"discoveredDate\",\"type\":\"string\"}],\"rows\":[{\"vulnerabilityId\":\"VULN-2024-001\",\"severity\":\"high\",\"discoveredDate\":\"2024-05-15\"},{\"vulnerabilityId\":\"VULN-2024-002\",\"severity\":\"medium\",\"discoveredDate\":\"2024-05-16\"}],\"primaryKey\":\"vulnerabilityId\",\"description\":\"Tracks discovered vulnerabilities with severity and identification.\"}", + "description": "Create a vulnerability tracking table with three columns and two initial rows of data." + }, + { + "inputJson": "{\"tableName\":\"IncidentLog\",\"columns\":[{\"name\":\"incidentId\",\"type\":\"string\"},{\"name\":\"description\",\"type\":\"string\"},{\"name\":\"resolved\",\"type\":\"boolean\"},{\"name\":\"resolutionDate\",\"type\":\"string\"}],\"rows\":[{\"incidentId\":\"INC-1001\",\"description\":\"Unauthorized access detected\",\"resolved\":false,\"resolutionDate\":\"\"}],\"primaryKey\":\"incidentId\",\"description\":\"Log of security incidents for resolution tracking.\"}", + "description": "Create an incident log table that tracks incident resolution status and details." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Table", + "context": null + } + }, + { + "name": "security-tools.createArticle", + "description": "Generates a structured security article based on provided topics, target audience, and formatting preferences. It processes input keywords and context to create detailed, readable content suitable for documentation or educational purposes. The output is a formatted article text with sections, headings, and security best practices.", + "category": "security-tools", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the security article to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "topics", + "type": "array", + "description": "List of key security topics or keywords to cover in the article.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended readers, such as developers, security professionals, or general users.", + "required": false, + "defaultValue": "General audience" + }, + { + "name": "format", + "type": "string", + "description": "Preferred output format for the article, e.g., Markdown, HTML, or plain text.", + "required": false, + "defaultValue": "Markdown" + }, + { + "name": "includeBestPractices", + "type": "boolean", + "description": "Whether to include recommended security best practices in the article.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum word count limit for the generated article to control length.", + "required": false, + "defaultValue": "1500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article in the requested format and a summary of topics covered." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly generate comprehensive security-focused articles or documentation on specific topics, targeted to an audience with variable security knowledge, to support education, compliance, or internal communication.", + "limitations": "This tool does not perform live security audits or provide real-time vulnerability detection; it focuses solely on content creation based on provided input topics and parameters.", + "examples": [ + "Create a security article about 'SQL Injection and Preventive Measures' for software developers in Markdown format.", + "Generate documentation on 'Cloud Security Best Practices' targeting IT administrators in plain text.", + "Write a brief overview on 'Phishing Attacks' for general users including recommended action steps." + ] + }, + "tags": [ + "security", + "documentation", + "article", + "content-generation", + "education", + "best-practices" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Understanding SQL Injection\",\"topics\":[\"SQL Injection\",\"input validation\",\"database security\"],\"targetAudience\":\"software developers\",\"format\":\"Markdown\",\"includeBestPractices\":true,\"maxLength\":1200}", + "description": "Generate a Markdown formatted article about SQL Injection for software developers including best practices." + }, + { + "inputJson": "{\"title\":\"Cloud Security Essentials\",\"topics\":[\"cloud security\",\"data encryption\",\"access control\"],\"targetAudience\":\"IT administrators\",\"format\":\"plain text\",\"includeBestPractices\":true,\"maxLength\":1000}", + "description": "Create a plain text article on cloud security essentials for IT administrators." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Article", + "context": null + } + }, + { + "name": "customer-support.analyzeParagraph", + "description": "Analyzes a customer support text paragraph to identify sentiment, key issues, and suggested response topics. Accepts raw paragraph text and optional language setting, then processes linguistic and sentiment cues to output a structured summary with sentiment classification, detected issues or intents, and recommended response focuses.", + "category": "customer-support", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The customer support paragraph text to analyze for sentiment and issues.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Optional language code of the input text (e.g., 'en' for English). Defaults to 'en'.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeywords", + "type": "boolean", + "description": "Flag indicating whether to include extracted keywords in the output summary.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis result object containing sentiment (positive, negative, neutral), key detected issues or intents as an array of strings, optional keywords if requested, and a summary suggestion for customer support response focus." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents needing to extract actionable insights from customer messages, such as determining sentiment to prioritize responses, identifying common complaint or inquiry themes, and generating topics to tailor human or automated replies effectively. It supports multi-language inputs and enhances workflows in customer support ticket triaging and analytics.", + "limitations": "The tool cannot replace full-scale natural language understanding or context-aware dialogue management. It does not handle multi-turn conversations or verify factual accuracy of the detected issues. It performs best on single-paragraph inputs and may have reduced accuracy with heavily informal or corrupted text.", + "examples": [ + "Analyze the sentiment and main concerns in this customer email paragraph.", + "Extract key issues and suggest response focus for a support message in Spanish.", + "Provide sentiment classification and keywords from this user complaint text." + ] + }, + "tags": [ + "customer-support", + "text-analysis", + "sentiment-analysis", + "issue-detection", + "response-suggestion" + ], + "examples": [ + { + "inputJson": "{\"text\":\"I have been waiting for a refund for over two weeks now and have received no updates. This is very frustrating!\",\"language\":\"en\",\"includeKeywords\":true}", + "description": "Analyze an English customer complaint paragraph with keywords included." + }, + { + "inputJson": "{\"text\":\"Mi pedido llegó roto y no sé qué hacer, necesito ayuda urgente.\",\"language\":\"es\",\"includeKeywords\":false}", + "description": "Analyze a Spanish customer complaint paragraph without keywords." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Paragraph", + "context": null + } + }, + { + "name": "customer-support.createSentence", + "description": "Generates a clear, polite customer support sentence based on given context, intent, and tone. Accepts input parameters describing the situation, desired action, and preferred communication style, and outputs a fully composed sentence suitable for customer service interactions.", + "category": "customer-support", + "parameters": [ + { + "name": "context", + "type": "string", + "description": "Description of the customer support scenario or issue context to address.", + "required": true, + "defaultValue": "" + }, + { + "name": "intent", + "type": "string", + "description": "The primary purpose of the sentence, such as apologizing, providing information, requesting action, or confirming resolution.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the sentence, e.g., formal, friendly, empathetic, or neutral.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "customerType", + "type": "string", + "description": "Type of customer (e.g., new, returning, VIP) to tailor formality or personalization level.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCallToAction", + "type": "boolean", + "description": "Whether to include a call to action or next step in the sentence.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated customer support sentence as a string under the key 'sentence'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to compose a coherent and contextually appropriate sentence for customer support communications, tailored by scenario and desired tone. This helps automate or assist in crafting responses that are consistent with company voice and customer expectations.", + "limitations": "This tool generates single sentences only; it cannot create multi-sentence replies or full conversations. It also does not validate factual correctness or replace human judgment for complex or sensitive issues.", + "examples": [ + "Generate an apologetic sentence for a delayed shipment issue with empathetic tone.", + "Create a sentence providing troubleshooting instructions in a friendly tone.", + "Compose a formal confirmation sentence for issue resolution for a VIP customer." + ] + }, + "tags": [ + "customer-support", + "text-generation", + "communication", + "customer-service", + "sentence-composition" + ], + "examples": [ + { + "inputJson": "{\"context\":\"customer reports delayed shipment\",\"intent\":\"apologize\",\"tone\":\"empathetic\",\"includeCallToAction\":true}", + "description": "Generate a polite apology for a customer whose shipment is delayed, including a next step." + }, + { + "inputJson": "{\"context\":\"customer needs password reset instructions\",\"intent\":\"provide information\",\"tone\":\"friendly\"}", + "description": "Create a friendly sentence giving instructions to reset password." + }, + { + "inputJson": "{\"context\":\"issue resolved successfully\",\"intent\":\"confirm resolution\",\"tone\":\"formal\",\"customerType\":\"VIP\"}", + "description": "Generate a formal sentence confirming resolution for a VIP customer." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Sentence", + "context": null + } + }, + { + "name": "customer-support.createParagraph", + "description": "Creates a well-structured paragraph for customer support communications based on the provided topic, tone, and important points. Accepts inputs to tailor the message style and content focus, and outputs a coherent, context-appropriate paragraph ready for use in support replies or documentation.", + "category": "customer-support", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "The main subject or issue to address in the paragraph (e.g., 'refund policy', 'account verification').", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The desired tone of the paragraph, such as 'formal', 'friendly', 'empathetic', or 'professional'.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of important points or information to include in the paragraph for clarity and completeness.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en', 'es') to write the paragraph in, supporting multilingual needs.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph string ready to use in customer support interactions." + }, + "aiAgent": { + "useCase": "Use this tool when generating concise, customer-facing paragraph responses or explanations within support tickets, FAQs, or chat interactions to ensure consistent tone and coverage of essential information. It helps avoid repetitive manual writing and ensures clarity with dynamic input points.", + "limitations": "The tool cannot handle complex multi-paragraph documents or interactive dialogues, and may lack deep personalized context without sufficient detailed inputs.", + "examples": [ + "Generate a friendly paragraph explaining the refund policy highlighting key deadlines and conditions.", + "Create a formal paragraph to inform customers about security verification steps in account recovery.", + "Write an empathetic message addressing a delayed shipment issue with apology and next steps." + ] + }, + "tags": [ + "customer-support", + "content-generation", + "text-creation", + "customer-communication", + "paragraph-writing" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"refund policy\",\"tone\":\"friendly\",\"keyPoints\":[\"refund requests must be made within 30 days\",\"items must be in original condition\",\"refund processed within 5 business days\"]}", + "description": "Generate a friendly paragraph explaining the refund policy including deadlines and conditions." + }, + { + "inputJson": "{\"topic\":\"account verification\",\"tone\":\"formal\",\"keyPoints\":[\"two-step verification required\",\"provide valid ID proof\",\"contact support if issues\"]}", + "description": "Create a formal paragraph about the security verification steps customers must follow for account recovery." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "customer-support.createNotification", + "description": "Creates a customer support notification message to be sent to users or support agents. Accepts inputs such as notification type, message content, recipient info, and delivery method. Processes these inputs to format and queue the notification for delivery. Returns the notification ID and status confirmation.", + "category": "customer-support", + "parameters": [ + { + "name": "notificationType", + "type": "string", + "description": "Type of notification to create (e.g. 'ticketUpdate', 'systemAlert', 'newMessage').", + "required": true, + "defaultValue": "" + }, + { + "name": "messageContent", + "type": "string", + "description": "The text content of the notification message to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientIds", + "type": "array", + "description": "List of recipient user IDs to whom the notification will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "deliveryMethod", + "type": "string", + "description": "Method of delivery for the notification (e.g. 'email', 'sms', 'inApp').", + "required": false, + "defaultValue": "inApp" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification (e.g. 'low', 'normal', 'high').", + "required": false, + "defaultValue": "normal" + }, + { + "name": "scheduledTime", + "type": "string", + "description": "Optional ISO 8601 datetime string to schedule the notification for future delivery.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique notification ID and current status of the notification processing." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create and dispatch notifications related to customer support activities such as ticket updates, alerts, or reminders. It helps keep customers and agents informed via preferred communication channels.", + "limitations": "Does not handle actual delivery mechanics or retries beyond initial queueing. It also does not verify recipient contact details or perform content moderation.", + "examples": [ + "Create a high priority alert notification for multiple recipients via email about a system outage.", + "Send an in-app message to a single user about their ticket status update.", + "Schedule a low priority SMS reminder for customers about upcoming support appointments." + ] + }, + "tags": [ + "customer support", + "notifications", + "messaging", + "alerts", + "in-app", + "email", + "sms" + ], + "examples": [ + { + "inputJson": "{\"notificationType\":\"ticketUpdate\",\"messageContent\":\"Your support ticket #12345 has been updated.\",\"recipientIds\":[\"user_001\"],\"deliveryMethod\":\"email\",\"priority\":\"normal\"}", + "description": "Send an email notification to a user about a ticket update." + }, + { + "inputJson": "{\"notificationType\":\"systemAlert\",\"messageContent\":\"Scheduled maintenance will occur at midnight.\",\"recipientIds\":[\"agent_101\",\"agent_102\"],\"deliveryMethod\":\"inApp\",\"priority\":\"high\"}", + "description": "Create a high priority in-app alert for support agents about system maintenance." + }, + { + "inputJson": "{\"notificationType\":\"reminder\",\"messageContent\":\"Don't forget your support session tomorrow.\",\"recipientIds\":[\"user_007\"],\"deliveryMethod\":\"sms\",\"priority\":\"low\",\"scheduledTime\":\"2024-07-01T10:00:00Z\"}", + "description": "Schedule an SMS reminder notification for a customer support appointment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Notification", + "context": null + } + }, + { + "name": "customer-support.createLead", + "description": "This tool accepts lead information including contact details, source, and qualification data to create a new customer lead record in the CRM system. It processes the input to validate essential fields, assigns lead scoring if specified, and outputs the unique lead ID along with confirmation and summary of stored data.", + "category": "customer-support", + "parameters": [ + { + "name": "firstName", + "type": "string", + "description": "The first name of the lead contact", + "required": true, + "defaultValue": "" + }, + { + "name": "lastName", + "type": "string", + "description": "The last name of the lead contact", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Primary email address of the lead", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Contact phone number for the lead", + "required": false, + "defaultValue": "" + }, + { + "name": "companyName", + "type": "string", + "description": "Name of the company the lead represents", + "required": false, + "defaultValue": "" + }, + { + "name": "leadSource", + "type": "string", + "description": "Source from where the lead was acquired (e.g., website, event, referral)", + "required": false, + "defaultValue": "" + }, + { + "name": "leadScore", + "type": "number", + "description": "Numerical score representing lead quality or potential", + "required": false, + "defaultValue": "0" + }, + { + "name": "interestedProducts", + "type": "array", + "description": "List of product or service names the lead is interested in", + "required": false, + "defaultValue": "[]" + }, + { + "name": "notes", + "type": "string", + "description": "Additional notes or comments about the lead", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique lead identifier, a success confirmation, and a summary of the saved lead data" + }, + "aiAgent": { + "useCase": "Use this tool when new potential customers need to be added to the CRM to enable tracking and follow-up by the sales or customer support teams. It ensures structured creation of lead records including essential contact and qualification details.", + "limitations": "This tool does not validate the authenticity of contact information beyond basic format checks, nor does it handle updating existing leads or duplicate detection.", + "examples": [ + "Create a new lead with full contact details and interest information.", + "Add a lead using minimal required fields such as name and email only.", + "Create a lead sourced from a marketing event with lead score and product interests." + ] + }, + "tags": [ + "customer-support", + "lead-management", + "crm", + "sales", + "customer-data", + "creation" + ], + "examples": [ + { + "inputJson": "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"email\":\"jane.doe@example.com\",\"phoneNumber\":\"+1234567890\",\"companyName\":\"ExampleCorp\",\"leadSource\":\"Website\",\"leadScore\":75,\"interestedProducts\":[\"ProductA\",\"ProductB\"],\"notes\":\"Interested in pricing details.\"}", + "description": "Create a lead with full contact info, source, score, and product interest." + }, + { + "inputJson": "{\"firstName\":\"John\",\"lastName\":\"Smith\",\"email\":\"john.smith@example.com\"}", + "description": "Create a lead using only required fields: first name, last name, and email." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Lead", + "context": null + } + }, + { + "name": "marketing-automation.generateEvent", + "description": "Generates a marketing event object representing a user interaction or campaign trigger. Accepts inputs like event type, timestamp, user identifiers, campaign details, and metadata. Outputs a structured event record for analytics or automation ingestion.", + "category": "marketing-automation", + "parameters": [ + { + "name": "eventType", + "type": "string", + "description": "Type of marketing event (e.g., click, impression, conversion)", + "required": true, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 timestamp of when the event occurred", + "required": true, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier of the user associated with the event", + "required": false, + "defaultValue": "" + }, + { + "name": "campaignId", + "type": "string", + "description": "Identifier of marketing campaign related to the event", + "required": false, + "defaultValue": "" + }, + { + "name": "channel", + "type": "string", + "description": "Marketing channel through which event was triggered (e.g., email, social, web)", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional event-specific attributes as key-value pairs", + "required": false, + "defaultValue": "{}" + }, + { + "name": "value", + "type": "number", + "description": "Monetary value attributed to the event (e.g., purchase amount), optional", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Structured event object containing all input fields plus a generated unique eventId" + }, + "aiAgent": { + "useCase": "Use this tool to programmatically create standardized marketing event records capturing key details such as event type, time, user and campaign info, and optional metadata. This facilitates consistent event tracking and analytics pipelines across campaigns and channels.", + "limitations": "This tool only generates event data objects; it does not send, store, or analyze events. Integration with event streaming or storage systems must be done separately.", + "examples": [ + "Generate a 'click' event from a user on an email campaign.", + "Create a conversion event with purchase value and user ID for web channel.", + "Record an impression event with timestamp and campaign details" + ] + }, + "tags": [ + "marketing", + "automation", + "event", + "analytics", + "campaign", + "tracking", + "user-interaction" + ], + "examples": [ + { + "inputJson": "{\"eventType\":\"click\",\"timestamp\":\"2024-05-01T12:34:56Z\",\"userId\":\"user123\",\"campaignId\":\"camp789\",\"channel\":\"email\",\"metadata\":{\"buttonId\":\"signup\"}}", + "description": "Generate a click event from a user on an email campaign with additional metadata for button clicked." + }, + { + "inputJson": "{\"eventType\":\"conversion\",\"timestamp\":\"2024-05-02T15:00:00Z\",\"userId\":\"user456\",\"campaignId\":\"camp101\",\"channel\":\"web\",\"value\":99.99}", + "description": "Create a conversion event representing a purchase with monetary value on web channel." + }, + { + "inputJson": "{\"eventType\":\"impression\",\"timestamp\":\"2024-05-03T10:00:00Z\",\"campaignId\":\"camp300\",\"channel\":\"social\"}", + "description": "Record an impression event for a social media campaign without user identification." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Event", + "context": null + } + }, + { + "name": "marketing-automation.createEvent", + "description": "Creates a marketing analytics event based on input parameters such as event name, type, timestamp, user identifiers, and additional properties. Processes and validates input to produce a structured event object ready for tracking or integration with analytics platforms.", + "category": "marketing-automation", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "Name of the marketing event to create, e.g., 'signup' or 'adClick'.", + "required": true, + "defaultValue": "" + }, + { + "name": "eventType", + "type": "string", + "description": "Category or type of the event, such as 'click', 'impression', 'conversion'.", + "required": true, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp of when the event occurred. Defaults to current time if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier for the user who triggered the event. Optional but recommended for user-level analytics.", + "required": false, + "defaultValue": "" + }, + { + "name": "sessionId", + "type": "string", + "description": "Unique session identifier to link events within a user session.", + "required": false, + "defaultValue": "" + }, + { + "name": "properties", + "type": "object", + "description": "Additional key-value pairs with custom metadata related to the event, e.g., { adCampaign: 'summer_sale', device: 'mobile' }.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A structured event object including all inputs normalized, with added server timestamp if not provided, ready for ingestion by analytics systems." + }, + "aiAgent": { + "useCase": "Use this tool when generating trackable marketing events for analytics platforms, including custom campaigns, user interactions, or conversion tracking. Ideal for converting loosely structured event data into structured format required by marketing automation tools.", + "limitations": "This tool does not send or store events; it only creates structured event objects. It does not validate user identity beyond format nor integrates directly with external analytics APIs.", + "examples": [ + "Create an event for a user signing up on a website.", + "Generate a click event for an ad banner with custom campaign properties.", + "Create a conversion event capturing a purchase with order details." + ] + }, + "tags": [ + "marketing", + "automation", + "analytics", + "eventTracking", + "campaign", + "userBehavior" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"signup\",\"eventType\":\"conversion\",\"timestamp\":\"2024-06-01T10:00:00Z\",\"userId\":\"user_12345\",\"properties\":{\"plan\":\"premium\"}}", + "description": "Create a signup conversion event with a specified timestamp and user plan property." + }, + { + "inputJson": "{\"eventName\":\"adClick\",\"eventType\":\"click\",\"userId\":\"user_67890\",\"sessionId\":\"sess_abc123\",\"properties\":{\"adCampaign\":\"spring_sale\",\"device\":\"mobile\"}}", + "description": "Generate an ad click event linked to a user session with campaign and device info." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "finance-tools.createReport", + "description": "Generates a comprehensive financial report based on provided transaction data and parameters. Accepts input data such as transactions, report type, date range, and formatting options. Processes and aggregates financial data, calculates key metrics, and outputs a structured report document (JSON or PDF metadata) summarizing financial status and performance.", + "category": "finance-tools", + "parameters": [ + { + "name": "transactions", + "type": "array", + "description": "Array of transaction objects including date, amount, category, and description to be analyzed in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportType", + "type": "string", + "description": "Type of financial report to generate (e.g., 'incomeStatement', 'balanceSheet', 'cashFlow').", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Start date (ISO 8601 format) to filter transactions for the report period.", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date (ISO 8601 format) to filter transactions for the report period.", + "required": false, + "defaultValue": "" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code (e.g., USD, EUR) in which to display monetary values.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Whether to include charts and graphical summaries in the report output.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the report: 'json' for structured data or 'pdf' for a document format.", + "required": false, + "defaultValue": "json" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the detailed financial report including summary metrics, categorized transaction aggregates, and optional chart data or PDF document metadata depending on parameters." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to produce a structured financial report summarizing transactions over a specified period for accounting, review, or presentation purposes. Ideal for generating income statements, balance sheets, or cash flow reports automatically from raw financial data.", + "limitations": "This tool does not perform auditing or verify transaction authenticity. It assumes input data correctness and does not offer tax-specific calculations or advanced financial forecasting.", + "examples": [ + "Generate an income statement report from last quarter's transactions in USD, output as PDF including charts.", + "Create a cash flow report between two dates and receive it as JSON for further processing.", + "Produce a balance sheet summarizing assets and liabilities from a year's transaction data." + ] + }, + "tags": [ + "finance", + "reporting", + "financial-report", + "accounting", + "document-generation", + "data-aggregation" + ], + "examples": [ + { + "inputJson": "{\"transactions\":[{\"date\":\"2024-01-15\",\"amount\":-500,\"category\":\"Office Supplies\",\"description\":\"Printer ink\"},{\"date\":\"2024-01-20\",\"amount\":2000,\"category\":\"Sales\",\"description\":\"Client payment\"}],\"reportType\":\"incomeStatement\",\"startDate\":\"2024-01-01\",\"endDate\":\"2024-03-31\",\"currency\":\"USD\",\"includeCharts\":true,\"outputFormat\":\"pdf\"}", + "description": "Generate a PDF income statement for Q1 2024 with charts included." + }, + { + "inputJson": "{\"transactions\":[{\"date\":\"2024-02-10\",\"amount\":10000,\"category\":\"Investment\",\"description\":\"Capital injection\"},{\"date\":\"2024-02-15\",\"amount\":-1500,\"category\":\"Equipment\",\"description\":\"New laptop\"}],\"reportType\":\"balanceSheet\",\"currency\":\"USD\",\"outputFormat\":\"json\"}", + "description": "Create a JSON balance sheet report from investments and expenses in February 2024 without charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "finance-tools.createFunction", + "description": "Creates a customizable financial calculation function based on user-defined parameters such as inputs, operations, and output formatting. Accepts details about financial metrics and returns executable JavaScript code that performs the specified financial calculation, enabling dynamic computation in financial management contexts.", + "category": "finance-tools", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The name to assign to the created function for identification and reuse.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputParameters", + "type": "array", + "description": "An array of parameter names (strings) that the function will accept as inputs for the calculation.", + "required": true, + "defaultValue": "" + }, + { + "name": "calculationExpression", + "type": "string", + "description": "A valid JavaScript expression as a string that defines how to compute the output using the input parameters.", + "required": true, + "defaultValue": "" + }, + { + "name": "returnType", + "type": "string", + "description": "Specifies the data type of the function's return value, such as 'number' or 'string'.", + "required": false, + "defaultValue": "number" + }, + { + "name": "documentation", + "type": "string", + "description": "Optional documentation string describing the purpose and usage of the generated function.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated function as a string of JavaScript code and optionally the documentation string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate tailored financial calculation functions dynamically based on user input or evolving financial formulas, enabling customized computation logic for budgeting, investment analysis, or accounting tasks. It helps automate creation of reusable and parameterized financial functions without manual coding.", + "limitations": "This tool does not validate semantic correctness of the calculation expression beyond syntax. It does not execute the function or handle runtime errors; generated code must be tested and integrated appropriately.", + "examples": [ + "Create a function named 'calculateROI' that takes 'gain' and 'cost' as inputs and returns (gain - cost)/cost.", + "Define a function 'monthlyPayment' with inputs 'principal', 'rate', and 'months' that calculates loan payment based on the formula.", + "Generate a simple summation function 'totalAssets' accepting 'cash', 'inventory', and 'receivables'." + ] + }, + "tags": [ + "finance", + "function-generation", + "dynamic-calculation", + "financial-modeling", + "javascript", + "automation" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"calculateROI\",\"inputParameters\":[\"gain\",\"cost\"],\"calculationExpression\":\"(gain - cost) / cost\",\"returnType\":\"number\",\"documentation\":\"Calculates Return on Investment.\"}", + "description": "Generate a ROI calculation function that computes investment return based on gain and cost." + }, + { + "inputJson": "{\"functionName\":\"monthlyPayment\",\"inputParameters\":[\"principal\",\"rate\",\"months\"],\"calculationExpression\":\"(principal * rate) / (1 - Math.pow(1 + rate, -months))\",\"returnType\":\"number\",\"documentation\":\"Computes monthly loan payment using amortization formula.\"}", + "description": "Create a loan payment function that calculates monthly payments given principal, interest rate, and duration." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "human-resources.createEmail", + "description": "Generates a professional email template for human resources communications such as recruitment, onboarding, or employee notifications. Accepts input parameters like recipient role, purpose, tone, and key message points, then outputs a formatted email subject and body text suitable for HR purposes.", + "category": "human-resources", + "parameters": [ + { + "name": "recipientRole", + "type": "string", + "description": "Role or position of the email recipient (e.g., 'Job Applicant', 'New Hire', 'Employee')", + "required": true, + "defaultValue": "" + }, + { + "name": "emailPurpose", + "type": "string", + "description": "The main purpose of the email (e.g., 'Interview Invitation', 'Onboarding Instructions', 'Policy Update')", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email (e.g., 'Formal', 'Friendly', 'Neutral')", + "required": false, + "defaultValue": "Formal" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of key message points or information to include in the email body", + "required": false, + "defaultValue": "[]" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the sender or HR representative", + "required": false, + "defaultValue": "" + }, + { + "name": "senderTitle", + "type": "string", + "description": "Job title of the sender", + "required": false, + "defaultValue": "" + }, + { + "name": "companyName", + "type": "string", + "description": "Name of the company or organization sending the email", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted email subject and body text string ready for sending or further customization." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate professional and contextually appropriate HR emails aimed at various recipients to streamline communication processes such as recruitment invitations, onboarding instructions, or employee updates. It helps maintain consistency in tone and content relevance for HR communications.", + "limitations": "This tool generates email templates based on input parameters but does not send emails or handle personalization beyond the given parameters. It may not capture very specific organizational jargon or legal disclaimers unless provided in keyPoints.", + "examples": [ + "Generate an interview invitation email for a job applicant with a formal tone and details on interview date and location.", + "Create an onboarding welcome email for a new hire, friendly in tone, including information about their start date and required documents.", + "Prepare a policy update notification email to employees with neutral tone and key points summarizing changes." + ] + }, + "tags": [ + "email", + "human-resources", + "recruitment", + "onboarding", + "communication", + "template", + "automation" + ], + "examples": [ + { + "inputJson": "{\"recipientRole\":\"Job Applicant\",\"emailPurpose\":\"Interview Invitation\",\"tone\":\"Formal\",\"keyPoints\":[\"Interview scheduled for March 15th at 10 AM\",\"Location: Company HQ, Room 305\",\"Please bring a valid ID and resume\"],\"senderName\":\"Jane Smith\",\"senderTitle\":\"HR Manager\",\"companyName\":\"Tech Solutions Inc.\"}", + "description": "Formal interview invitation email to a job applicant with specified interview details." + }, + { + "inputJson": "{\"recipientRole\":\"New Hire\",\"emailPurpose\":\"Onboarding Instructions\",\"tone\":\"Friendly\",\"keyPoints\":[\"Welcome to the team!\",\"Your start date is April 1st\",\"Please complete the attached forms before your first day.\"],\"senderName\":\"Tom Lee\",\"senderTitle\":\"HR Coordinator\",\"companyName\":\"Innovatech\"}", + "description": "Friendly onboarding welcome email with instructions for a new employee." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "human-resources.createDocument", + "description": "Creates an HR-related document such as offer letters, employment contracts, or termination notices by accepting template type, employee details, and custom content. Generates a formatted document output suitable for review, download, or further processing.", + "category": "human-resources", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of HR document to create, e.g., 'offerLetter', 'employmentContract', or 'terminationNotice'.", + "required": true, + "defaultValue": "" + }, + { + "name": "employeeData", + "type": "object", + "description": "Employee details to populate in the document such as name, job title, start date, salary, and other personalized fields.", + "required": true, + "defaultValue": "" + }, + { + "name": "customContent", + "type": "string", + "description": "Optional custom text or clauses to add to the document for special terms or notes.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated document, e.g. 'pdf', 'docx', or 'txt'.", + "required": false, + "defaultValue": "pdf" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated document encoded as a base64 string along with metadata such as filename, document type, and format." + }, + "aiAgent": { + "useCase": "Use this tool when an automated system or assistant needs to create standardized HR documents personalized for specific employees, facilitating faster onboarding, contracts, or separation agreements without manual drafting.", + "limitations": "Cannot perform legal validation or approval workflows; it only generates the document text and formatting based on inputs.", + "examples": [ + "Create an offer letter document for a new hire John Doe starting as Software Engineer.", + "Generate an employment contract for employee Jane Smith including a custom confidentiality clause.", + "Produce a termination notice for an employee with relevant termination details." + ] + }, + "tags": [ + "human-resources", + "document-creation", + "hr-documents", + "employee-management", + "automation", + "contract-generation" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"offerLetter\",\"employeeData\":{\"name\":\"John Doe\",\"jobTitle\":\"Software Engineer\",\"startDate\":\"2024-07-01\",\"salary\":\"90000\"},\"customContent\":\"This offer is contingent upon background check.\",\"outputFormat\":\"pdf\"}", + "description": "Generate a PDF offer letter for John Doe with basic employment details and a custom background check clause." + }, + { + "inputJson": "{\"documentType\":\"employmentContract\",\"employeeData\":{\"name\":\"Jane Smith\",\"jobTitle\":\"Product Manager\",\"startDate\":\"2024-08-15\",\"salary\":\"110000\"},\"customContent\":\"Includes additional NDA terms.\",\"outputFormat\":\"docx\"}", + "description": "Create a DOCX employment contract for Jane Smith including additional NDA clauses." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Document", + "context": null + } + }, + { + "name": "copywriting.sendEmail", + "description": "Sends a marketing or promotional email to a specified recipient list. Accepts recipient addresses, subject, body content (HTML or text), and optional attachments, then dispatches the email using configured SMTP or email API services. Returns delivery status and message IDs for tracking.", + "category": "copywriting", + "parameters": [ + { + "name": "recipients", + "type": "array", + "description": "An array of recipient email addresses to send the email to.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "The HTML content of the email body, used to format visual email content.", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "Plain text version of the email body, used if HTML is not supported or preferred.", + "required": false, + "defaultValue": "" + }, + { + "name": "senderEmail", + "type": "string", + "description": "The sender's email address shown in the 'From' field.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects with file name and data or URLs.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "cc", + "type": "array", + "description": "Optional array of email addresses to be CC'd on the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional array of email addresses to be BCC'd on the email.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "replyTo", + "type": "string", + "description": "Optional Reply-To email address for recipient responses.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object indicating if the email was sent successfully, including status, message IDs, and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to send marketing, promotional, or transactional emails to targeted recipients, utilizing formatted HTML content or plain text, optionally with attachments or CC/BCC fields. Useful for automated campaign dispatch, customer follow-ups, or subscription notifications.", + "limitations": "This tool does not design or generate email content and relies on preformatted input. It cannot guarantee inbox delivery or handle very large recipient lists that require specialized bulk email services.", + "examples": [ + "Send a promotional newsletter to a list of customers.", + "Dispatch a follow-up email with attachment after a webinar.", + "Send a transactional confirmation email with custom reply-to address." + ] + }, + "tags": [ + "email", + "marketing", + "promotional", + "communication", + "send", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"recipients\":[\"user@example.com\"],\"subject\":\"Summer Sale Just For You!\",\"bodyHtml\":\" Don't miss 50% off!
Exclusive deals inside.
\",\"senderEmail\":\"newsletter@shop.com\"}", + "description": "Send a simple HTML promotional email to one customer." + }, + { + "inputJson": "{\"recipients\":[\"client1@example.com\",\"client2@example.com\"],\"subject\":\"Webinar Follow-up\",\"bodyText\":\"Thank you for attending our webinar. Attached is the slide deck.\",\"senderEmail\":\"events@company.com\",\"attachments\":[{\"fileName\":\"slides.pdf\",\"data\":\"base64encodedpdf\"}]}", + "description": "Send a plain text follow-up email with PDF attachment to multiple recipients." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "copywriting.buildCode", + "description": "This tool generates well-structured, commented programming code snippets based on user-provided functional specifications. It accepts a target programming language, a description of the desired functionality, and optional style preferences. The output is clean, executable code tailored to the provided instructions, ready for integration or review.", + "category": "copywriting", + "parameters": [ + { + "name": "programmingLanguage", + "type": "string", + "description": "The target programming language for the code output, e.g., Python, JavaScript, Java, etc.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionalityDescription", + "type": "string", + "description": "A detailed description of what functionality the code should implement or demonstrate.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeStyle", + "type": "string", + "description": "Optional coding style or conventions to follow, such as indentation style or naming conventions.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments within the generated code for clarity.", + "required": false, + "defaultValue": "true" + }, + { + "name": "codeComplexityLevel", + "type": "string", + "description": "Desired complexity level for the code such as 'basic', 'intermediate', or 'advanced'.", + "required": false, + "defaultValue": "basic" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated code string and metadata such as language and any stylistic notes." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to generate executable programming code from natural language descriptions, enabling fast prototyping, demonstrations, or educational explanations. It's useful when code must be tailored to particular languages or styles and for automating initial code draft creation.", + "limitations": "This tool does not validate code correctness beyond synthesis, nor does it guarantee optimal performance or security compliance. It cannot replace full programming or debugging processes and may produce syntactically correct but logically incomplete code in complex scenarios.", + "examples": [ + "Generate a Python function to sort a list of integers.", + "Create a JavaScript snippet for validating email input on a form.", + "Build a Java method that calculates factorial recursively with comments." + ] + }, + "tags": [ + "code generation", + "programming", + "copywriting", + "automation", + "developer tools", + "code snippets" + ], + "examples": [ + { + "inputJson": "{\"programmingLanguage\":\"Python\",\"functionalityDescription\":\"Sort a list of integers in ascending order.\",\"codeStyle\":\"PEP8\",\"includeComments\":true,\"codeComplexityLevel\":\"basic\"}", + "description": "Generate a basic Python sorted function with comments following PEP8 style." + }, + { + "inputJson": "{\"programmingLanguage\":\"JavaScript\",\"functionalityDescription\":\"Validate if a string is a properly formatted email address.\",\"codeStyle\":\"camelCase variables\",\"includeComments\":false,\"codeComplexityLevel\":\"intermediate\"}", + "description": "Create a JavaScript function without comments that validates email format using regex." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Code", + "context": null + } + }, + { + "name": "content-creation.buildCommit", + "description": "Constructs a detailed commit object for version control systems by accepting commit message, author info, changed files list, and optional metadata. Processes inputs to build a structured commit representation including timestamp and unique ID. Returns a commit object ready for submission to a repository.", + "category": "content-creation", + "parameters": [ + { + "name": "commitMessage", + "type": "string", + "description": "The message describing the changes included in the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the commit author.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email address of the commit author.", + "required": true, + "defaultValue": "" + }, + { + "name": "changedFiles", + "type": "array", + "description": "An array of objects describing changed files; each object includes file path and change type (added, modified, deleted).", + "required": true, + "defaultValue": "" + }, + { + "name": "parentCommitHash", + "type": "string", + "description": "The hash of the parent commit for linking in history. Optional if this is the first commit.", + "required": false, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 timestamp for the commit time. Defaults to current time if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs to include additional commit metadata (e.g., ticket IDs, review status).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured commit object containing id, message, author info, changed files, timestamp, parent hash, and metadata." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically build a commit object incorporating descriptive commit messages, author information, and a list of changed files before submitting to a version control system. It is useful for automation scripts, bots generating commits, or interfacing with git-like repositories without a native client.", + "limitations": "This tool does not perform the actual commit operation to a repository. It does not validate file contents or enforce commit policies. It does not generate diffs or patch data.", + "examples": [ + "Create a commit with message 'Fix login bug', author 'Alice', modified two files, with current timestamp.", + "Build a commit referencing a parent commit hash and including metadata for tracking a Jira ticket.", + "Generate an initial commit with author details and no parent hash." + ] + }, + "tags": [ + "content-creation", + "version-control", + "commit", + "automation", + "code-management" + ], + "examples": [ + { + "inputJson": "{\"commitMessage\":\"Fix issue #123 by updating authentication logic\",\"authorName\":\"Alice Johnson\",\"authorEmail\":\"alice.johnson@example.com\",\"changedFiles\":[{\"filePath\":\"auth/login.js\",\"changeType\":\"modified\"},{\"filePath\":\"auth/utils.js\",\"changeType\":\"added\"}],\"timestamp\":\"2024-05-01T14:30:00Z\"}", + "description": "Build a commit for bug fix with two changed files and specified timestamp." + }, + { + "inputJson": "{\"commitMessage\":\"Initial commit\",\"authorName\":\"Bob Smith\",\"authorEmail\":\"bob.smith@example.com\",\"changedFiles\":[{\"filePath\":\"README.md\",\"changeType\":\"added\"}],\"parentCommitHash\":\"\",\"metadata\":{\"ticket\":\"PROJ-1\"}}", + "description": "Create an initial commit with metadata for referencing a project ticket." + }, + { + "inputJson": "{\"commitMessage\":\"Refactor backend code\",\"authorName\":\"Carol Lee\",\"authorEmail\":\"carol.lee@example.com\",\"changedFiles\":[{\"filePath\":\"server/index.js\",\"changeType\":\"modified\"},{\"filePath\":\"server/db.js\",\"changeType\":\"modified\"}],\"parentCommitHash\":\"abc123def4567890\"}", + "description": "Create a commit referencing a parent commit with multiple modified files." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Commit", + "context": null + } + }, + { + "name": "documentation-tools.analyzeComment", + "description": "Analyzes a given comment text to detect tone, sentiment, key topics, and potential action items within technical or project documentation discussions. Accepts raw comment strings, performs NLP analysis, and outputs structured insights to help maintain clarity and relevance in documentation communication.", + "category": "documentation-tools", + "parameters": [ + { + "name": "commentText", + "type": "string", + "description": "The raw text content of the comment to be analyzed.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code for the comment text (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "detectSentiment", + "type": "boolean", + "description": "Flag to enable sentiment analysis of the comment text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "detectTopics", + "type": "boolean", + "description": "Flag to enable detection of key topics within the comment.", + "required": false, + "defaultValue": "true" + }, + { + "name": "extractActionItems", + "type": "boolean", + "description": "Flag to enable extraction of potential action items mentioned in the comment.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the analyzed results including overall sentiment, detected topics as keywords, categorized tone, and extracted action items if any." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to understand and extract meaningful insights from comments in code reviews, project documentation discussions, or collaborative notes to improve clarity, identify issues, or summarize stakeholder intentions.", + "limitations": "The tool cannot fully understand highly context-dependent or ambiguous comments without additional domain information. It is not designed for non-text comment formats such as audio or video.", + "examples": [ + "Analyze the tone and key topics of a code review comment to check for concerns or suggestions.", + "Extract action items from project discussion comments for task tracking.", + "Determine the sentiment of user feedback comments on documentation pages." + ] + }, + "tags": [ + "documentation", + "comment-analysis", + "sentiment-analysis", + "topic-detection", + "action-items", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"commentText\":\"I think this function needs better error handling and clear comments. We should add tests for edge cases.\",\"language\":\"en\",\"detectSentiment\":true,\"detectTopics\":true,\"extractActionItems\":true}", + "description": "Analyze a comment suggesting improvements and test additions with sentiment and action item extraction." + }, + { + "inputJson": "{\"commentText\":\"Looks good to me! No issues found.\",\"language\":\"en\",\"detectSentiment\":true,\"detectTopics\":true,\"extractActionItems\":false}", + "description": "Analyze positive feedback comment focusing on sentiment and topic detection only." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Comment", + "context": null + } + }, + { + "name": "documentation-tools.sendNotification", + "description": "Sends a notification message related to documentation updates to specified recipients via email or webhook. It accepts parameters including message content, subject, recipient list, delivery method, and optional metadata. Processes inputs by formatting the notification and dispatching it, returning a status report for each recipient indicating success or failure.", + "category": "documentation-tools", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject or title of the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "message", + "type": "string", + "description": "The main content body of the notification message.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient addresses (emails or webhook URLs) to send the notification.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "deliveryMethod", + "type": "string", + "description": "Method of notification delivery: 'email' or 'webhook'.", + "required": true, + "defaultValue": "email" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional information to include with the notification, such as document version or change summary.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the notification (e.g., 'normal', 'high').", + "required": false, + "defaultValue": "normal" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of results for each recipient, indicating whether the notification was sent successfully, with optional error messages." + }, + "aiAgent": { + "useCase": "Use this tool when you need to inform team members or stakeholders about updates, changes, or alerts related to documentation. It enables automated dispatch of notifications through common channels such as email or webhooks, ensuring timely communication about document state or action items.", + "limitations": "Does not support SMS or push notification channels directly; requires valid and reachable recipient addresses; delivery reliability depends on external service availability and network conditions.", + "examples": [ + "Send an email notification to the documentation team about a new API specification update.", + "Dispatch a webhook notification to a continuous integration system when a changelog document is updated.", + "Notify a list of stakeholders via email regarding a documentation review schedule." + ] + }, + "tags": [ + "notification", + "documentation", + "communication", + "email", + "webhook", + "update", + "alert" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"API Doc Updated\",\"message\":\"The API specification document v2.1 has been published.\",\"recipients\":[\"dev-team@example.com\"],\"deliveryMethod\":\"email\"}", + "description": "Send an email notification about an API documentation update to the development team." + }, + { + "inputJson": "{\"subject\":\"Changelog Update\",\"message\":\"A new changelog entry for release 5.4 is available.\",\"recipients\":[\"https://ci.example.com/webhook\"],\"deliveryMethod\":\"webhook\",\"metadata\":{\"document\":\"changelog.md\",\"version\":\"5.4\"}}", + "description": "Send a webhook notification to a CI system after changelog document update." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Notification", + "context": null + } + }, + { + "name": "documentation-tools.buildEndpoint", + "description": "This tool generates detailed API endpoint documentation from structured input describing the endpoint's HTTP method, URL, parameters, request and response schemas, and descriptions. It processes the input to produce clean, formatted endpoint documentation suitable for API docs.", + "category": "documentation-tools", + "parameters": [ + { + "name": "endpointName", + "type": "string", + "description": "The unique name or identifier for the API endpoint, used as a title in the documentation.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "The HTTP method (GET, POST, PUT, DELETE, etc.) used by the endpoint.", + "required": true, + "defaultValue": "" + }, + { + "name": "path", + "type": "string", + "description": "The URL path of the endpoint, including any path parameters, e.g., /users/{id}.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A brief explanation of what the endpoint does or its purpose.", + "required": false, + "defaultValue": "" + }, + { + "name": "queryParameters", + "type": "array", + "description": "Array of objects describing query parameters, each with name, type, and description.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "requestBody", + "type": "object", + "description": "JSON schema or example describing the structure of the request body if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "responseBody", + "type": "object", + "description": "JSON schema or example describing the structure of the expected response body.", + "required": false, + "defaultValue": "" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Indicates if authentication is required to access this endpoint.", + "required": false, + "defaultValue": "false" + }, + { + "name": "tags", + "type": "array", + "description": "Array of string tags to categorize the endpoint, e.g., ['User','Admin'].", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted documentation text for the API endpoint, structured for easy rendering in docs." + }, + "aiAgent": { + "useCase": "Use this tool when you have structured data about an API endpoint's method, path, parameters, and schemas and want to generate consistent, human-readable documentation for integration into API reference documents or developer portals. It helps automate accurate and detailed endpoint docs.", + "limitations": "This tool cannot validate the correctness of the endpoint data or generate code implementations; it only formats and generates documentation text from the provided input.", + "examples": [ + "Generate documentation for a POST /login endpoint with username and password in the request body.", + "Create docs for a GET /users/{id} endpoint returning user profile details.", + "Document a DELETE /items/{itemId} endpoint requiring authentication." + ] + }, + "tags": [ + "documentation", + "API", + "endpoint", + "build", + "automation", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"endpointName\":\"Create User\",\"httpMethod\":\"POST\",\"path\":\"/users\",\"description\":\"Creates a new user in the system.\",\"queryParameters\":[],\"requestBody\":{\"username\":\"string\",\"email\":\"string\",\"password\":\"string\"},\"responseBody\":{\"id\":\"number\",\"username\":\"string\",\"email\":\"string\"},\"authenticationRequired\":true,\"tags\":[\"User\",\"Admin\"]}", + "description": "Generate documentation for a POST /users endpoint requiring authentication that creates a new user." + }, + { + "inputJson": "{\"endpointName\":\"Get User Details\",\"httpMethod\":\"GET\",\"path\":\"/users/{id}\",\"description\":\"Retrieves details for a user by ID.\",\"queryParameters\":[{\"name\":\"verbose\",\"type\":\"boolean\",\"description\":\"Return extended user info.\"}],\"requestBody\":null,\"responseBody\":{\"id\":\"number\",\"username\":\"string\",\"email\":\"string\",\"createdAt\":\"string\"},\"authenticationRequired\":true,\"tags\":[\"User\"]}", + "description": "Generate documentation for a GET /users/{id} endpoint with optional query parameter 'verbose'." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Endpoint", + "context": null + } + }, + { + "name": "data-analytics.formatFunction", + "description": "Formats a JavaScript or TypeScript function code snippet according to specified style rules. Accepts raw function code as a string and formatting options (like indentation, max line length). Outputs the function code string reformatted for improved readability and consistency.", + "category": "data-analytics", + "parameters": [ + { + "name": "functionCode", + "type": "string", + "description": "Raw string of the JavaScript/TypeScript function code to format.", + "required": true, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for indentation.", + "required": false, + "defaultValue": "2" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs instead of spaces for indentation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed length of each line before wrapping.", + "required": false, + "defaultValue": "80" + }, + { + "name": "semi", + "type": "boolean", + "description": "Whether to add semicolons at the end of statements.", + "required": false, + "defaultValue": "true" + }, + { + "name": "singleQuote", + "type": "boolean", + "description": "Use single quotes for strings instead of double quotes.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted function code string under 'formattedCode'." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw or inconsistently formatted JavaScript/TypeScript function code and need it reformatted to conform with style conventions for readability and maintainability. Useful in code synthesis, refactoring, or preparing snippets for documentation or display.", + "limitations": "Does not parse or validate function semantics or correctness; strictly formats code style. Complex or incomplete syntax may cause formatting errors. Does not perform linting or comprehensive code analysis.", + "examples": [ + "Format a raw JS function with 4-space indentation and semicolons.", + "Convert a TypeScript function to use tabs and single quotes.", + "Wrap long lines in a function code snippet to max 100 characters." + ] + }, + "tags": [ + "formatting", + "function", + "javascript", + "typescript", + "code-style", + "data-analytics" + ], + "examples": [ + { + "inputJson": "{\"functionCode\":\"function add(a,b){return a+b}\",\"indentSize\":4,\"useTabs\":false,\"maxLineLength\":80,\"semi\":true,\"singleQuote\":true}", + "description": "Format a simple add function with 4 spaces indentation and semicolons." + }, + { + "inputJson": "{\"functionCode\":\"const greet=(name)=>{console.log(\\\"Hello, \\\"+name)};\",\"indentSize\":2,\"useTabs\":true,\"maxLineLength\":80,\"semi\":false,\"singleQuote\":true}", + "description": "Format an arrow function with tabs indentation and no semicolons." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Function", + "context": null + } + }, + { + "name": "data-analytics.composeReport", + "description": "Generates a comprehensive analytical report by processing input datasets, applying specified data transformations and visualizations, and compiling the results into a structured document output such as PDF or HTML. Accepts raw or preprocessed data and optional configuration for report sections and styling.", + "category": "data-analytics", + "parameters": [ + { + "name": "inputData", + "type": "array", + "description": "Array of data objects or records to be analyzed and included in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportTitle", + "type": "string", + "description": "Title of the report to be displayed on the cover page or header.", + "required": false, + "defaultValue": "\"Data Analytics Report\"" + }, + { + "name": "sections", + "type": "array", + "description": "List of sections to include in the report, each defining data subset, metrics, visualizations, and textual insights.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated report output. Supported formats include PDF and HTML.", + "required": false, + "defaultValue": "\"PDF\"" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to generate and include an executive summary with key insights.", + "required": false, + "defaultValue": "true" + }, + { + "name": "theme", + "type": "string", + "description": "Visual style theme for report styling, e.g., 'light', 'dark', or custom themes.", + "required": false, + "defaultValue": "\"light\"" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the report author or organization to include in the footer or metadata.", + "required": false, + "defaultValue": "\"\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report content as a base64 encoded string, the MIME type indicating format, and a summary of sections included." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically generate detailed, customized data analytics reports that combine raw data, statistical summaries, visualizations, and narrative insights into a single coherent document for stakeholders or clients. Ideal for automating repetitive report generation from standard datasets with flexible section composition.", + "limitations": "This tool does not perform raw data cleansing or complex statistical modeling beyond basic transformations specified in sections. It cannot interpret ambiguous data or perform advanced natural language summaries without user input.", + "examples": [ + "Create a quarterly sales analytics report with charts and key KPIs in PDF format.", + "Generate an HTML report summarizing customer feedback data including sentiment analysis section.", + "Produce a sales forecast report with executive summary and customized styling theme." + ] + }, + "tags": [ + "data-analytics", + "report-generation", + "visualization", + "summary", + "pdf", + "html" + ], + "examples": [ + { + "inputJson": "{\"inputData\":[{\"region\":\"North\",\"sales\":120000,\"date\":\"2024-01-31\"},{\"region\":\"South\",\"sales\":95000,\"date\":\"2024-01-31\"}],\"reportTitle\":\"Q1 Regional Sales Report\",\"sections\":[{\"title\":\"Sales Overview\",\"metrics\":[\"totalSales\"],\"charts\":[{\"type\":\"bar\",\"x\":\"region\",\"y\":\"sales\"}],\"textSummary\":\"Overview of regional sales performance.\"}],\"outputFormat\":\"PDF\",\"includeSummary\":true,\"theme\":\"light\",\"authorName\":\"Data Team\"}", + "description": "Generate a PDF sales report for Q1 with bar charts by region and an executive summary." + }, + { + "inputJson": "{\"inputData\":[{\"category\":\"Electronics\",\"rating\":4.5,\"comments\":45},{\"category\":\"Books\",\"rating\":4.8,\"comments\":120}],\"sections\":[{\"title\":\"Customer Ratings\",\"metrics\":[\"averageRating\"],\"charts\":[{\"type\":\"pie\",\"field\":\"category\"}],\"textSummary\":\"Customer ratings breakdown by product category.\"}],\"outputFormat\":\"HTML\",\"includeSummary\":false,\"theme\":\"dark\",\"authorName\":\"Market Research\"}", + "description": "Create an HTML report on customer ratings by category with pie charts but no summary, styled dark." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "data-analytics.formatReport", + "description": "Formats raw analytical data and statistical insights into a well-structured, visually enhanced report document. Accepts input data objects or JSON arrays representing metrics and analyses, applies templated layouts with charts and tables, and outputs a formatted report in PDF, HTML, or Markdown formats for easy sharing and presentation.", + "category": "data-analytics", + "parameters": [ + { + "name": "rawData", + "type": "object", + "description": "Input structured data or JSON object containing the analytics results and metrics to be included in the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "reportTemplate", + "type": "string", + "description": "The identifier or path of the template to use that defines the report layout, styling, and sections.", + "required": false, + "defaultValue": "standard" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired format of the final report document such as 'pdf', 'html', or 'md' (Markdown).", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Flag to include visual charts generated from the data within the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "title", + "type": "string", + "description": "Custom title text to use at the top of the report.", + "required": false, + "defaultValue": "Analytics Report" + }, + { + "name": "author", + "type": "string", + "description": "Name of the report author to display in the report metadata or header.", + "required": false, + "defaultValue": "" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Date format string to display dates consistently within the report, e.g. 'YYYY-MM-DD'.", + "required": false, + "defaultValue": "YYYY-MM-DD" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted report file content as a base64 string, its file name, and the MIME type." + }, + "aiAgent": { + "useCase": "Use this tool when raw analytical data from sources such as datasets or API responses need to be converted into human-readable and professional reports for presentation or sharing with stakeholders. Ideal for creating consistent reports including tables, summary statistics, and charts in multiple output formats.", + "limitations": "Cannot interpret or generate analytical insights; expects preprocessed analytical data as input. Does not perform data analysis or cleaning itself, only formatting into reports.", + "examples": [ + "Generate a PDF report with charts from monthly sales data.", + "Produce an HTML report summarizing user engagement metrics using a custom template.", + "Create a Markdown report of key performance indicators with a specified date format." + ] + }, + "tags": [ + "data-analytics", + "reporting", + "formatting", + "visualization", + "pdf", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"rawData\":{\"metrics\":[{\"name\":\"Total Sales\",\"value\":120000},{\"name\":\"Average Session Duration\",\"value\":300}]},\"reportTemplate\":\"modern\",\"outputFormat\":\"pdf\",\"includeCharts\":true,\"title\":\"Monthly Sales Report\",\"author\":\"Alice\",\"dateFormat\":\"YYYY-MM-DD\"}", + "description": "Format sales metrics into a modern PDF report with charts and custom title/author." + }, + { + "inputJson": "{\"rawData\":{\"userStats\":[{\"metric\":\"Active Users\",\"count\":1500},{\"metric\":\"New Signups\",\"count\":300}]},\"outputFormat\":\"html\",\"includeCharts\":false,\"title\":\"User Engagement Report\"}", + "description": "Generate a simple HTML report from user engagement stats without charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Report", + "context": null + } + }, + { + "name": "data-analytics.createEvent", + "description": "Creates a structured analytics event record from user-provided event details, including event name, timestamp, user identifiers, and additional metadata. The tool validates and formats these inputs into a standardized event object suitable for downstream analytics processing or storage.", + "category": "data-analytics", + "parameters": [ + { + "name": "eventName", + "type": "string", + "description": "The name of the event to be recorded, e.g., 'page_view' or 'purchase'.", + "required": true, + "defaultValue": "" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted date-time string representing the event occurrence time. Defaults to current time if omitted.", + "required": false, + "defaultValue": "current_timestamp" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier of the user associated with the event.", + "required": true, + "defaultValue": "" + }, + { + "name": "sessionId", + "type": "string", + "description": "Identifier representing the user’s session in which the event happened.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional optional key-value pairs with contextual event data, e.g., page URL, product details.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "eventProperties", + "type": "object", + "description": "Optional structured properties specific to the event, e.g., {'productId': '1234', 'price':100}.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the fully constructed and validated event, including all provided details and a standardized schema for analytics ingestion." + }, + "aiAgent": { + "useCase": "Use this tool when needing to formulate a clear, standardized event record from raw inputs, ensuring consistent formatting for data analytics workflows, tracking user behavior, or feeding event pipelines.", + "limitations": "Does not send or store events; only constructs the event object. Does not infer missing data beyond timestamp defaulting or validate specific event business logic beyond structural correctness.", + "examples": [ + "Create a purchase event with user, session, timestamp, and detailed product info.", + "Generate a page_view event with minimal metadata including userId and current timestamp.", + "Form a custom event with dynamic metadata and arbitrary event properties." + ] + }, + "tags": [ + "data", + "analytics", + "event", + "tracking", + "user-behavior", + "event-creation" + ], + "examples": [ + { + "inputJson": "{\"eventName\":\"purchase\",\"timestamp\":\"2024-05-01T10:15:30Z\",\"userId\":\"user_123\",\"sessionId\":\"sess_456\",\"metadata\":{\"pageUrl\":\"https://shop.example.com/product/1234\"},\"eventProperties\":{\"productId\":\"1234\",\"price\":49.99}}", + "description": "Create a purchase event with product details and user session info." + }, + { + "inputJson": "{\"eventName\":\"page_view\",\"userId\":\"user_789\"}", + "description": "Create a page view event with current timestamp and minimal details." + }, + { + "inputJson": "{\"eventName\":\"custom_action\",\"userId\":\"user_999\",\"metadata\":{\"buttonColor\":\"red\"},\"eventProperties\":{\"actionType\":\"click\",\"label\":\"signup_button\"}}", + "description": "Create a custom event with metadata and properties describing a button click." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Event", + "context": null + } + }, + { + "name": "data-analytics.createEndpoint", + "description": "This tool creates a REST API endpoint for data analytics applications. It accepts configuration inputs such as endpoint path, HTTP method, data processing logic in code form, and optional authentication settings. It outputs a deployable endpoint configuration object ready for integration in a backend service.", + "category": "data-analytics", + "parameters": [ + { + "name": "endpointPath", + "type": "string", + "description": "The URL path at which the endpoint will be accessible, e.g., '/analytics/data'.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "The HTTP method for the endpoint, e.g., GET, POST, PUT, DELETE.", + "required": true, + "defaultValue": "GET" + }, + { + "name": "processingCode", + "type": "string", + "description": "JavaScript code snippet that defines how to process the incoming request data and produce a response. Should be safe and self-contained.", + "required": true, + "defaultValue": "" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Whether the endpoint requires authentication to access.", + "required": false, + "defaultValue": "false" + }, + { + "name": "responseType", + "type": "string", + "description": "The content type of the response, such as 'application/json' or 'text/csv'.", + "required": false, + "defaultValue": "application/json" + } + ], + "returns": { + "type": "object", + "description": "An object with the full endpoint configuration, including the path, method, processing logic, authentication flag, and response metadata, ready for deployment." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate and configure backend API endpoints that handle data analytics tasks, such as aggregating data, filtering analytics results, or computing metrics dynamically. It is ideal for automating endpoint creation in systems requiring quick data insights delivery over HTTP.", + "limitations": "This tool does not deploy the endpoint to a live server; it only generates configuration code and metadata. It also does not validate the processing code for security risks or runtime errors.", + "examples": [ + "Create an analytics endpoint at '/reports/daily' using POST that computes sales totals, requiring authentication.", + "Generate a GET endpoint '/stats/user' that returns user activity summary as JSON without authentication." + ] + }, + "tags": [ + "data-analytics", + "endpoint", + "API", + "REST", + "code-generation", + "backend", + "automation" + ], + "examples": [ + { + "inputJson": "{\"endpointPath\":\"/analytics/summarize\",\"httpMethod\":\"POST\",\"processingCode\":\"const body = JSON.parse(request.body); return { summary: body.data.reduce((a,b) => a + b, 0) };\",\"authenticationRequired\":true,\"responseType\":\"application/json\"}", + "description": "Creates a POST endpoint '/analytics/summarize' that sums an array of numbers sent in the request body, requires authentication, and returns JSON." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Endpoint", + "context": null + } + }, + { + "name": "data-transformation.composeDocument", + "description": "This tool accepts an array of content blocks, each with text, formatting, and optional metadata, then composes them into a structured document output in specified format (e.g., JSON, HTML, Markdown). It processes ordering, applies styles, and merges elements to create a cohesive document representation.", + "category": "data-transformation", + "parameters": [ + { + "name": "contentBlocks", + "type": "array", + "description": "An array of content block objects defining the document parts such as paragraphs, headings, images, or lists, each with relevant attributes.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output document format, e.g., 'json', 'html', or 'markdown'.", + "required": true, + "defaultValue": "json" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to embed metadata like authorship or timestamps in the output document.", + "required": false, + "defaultValue": "false" + }, + { + "name": "documentTitle", + "type": "string", + "description": "Optional title to include at the start of the document.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document in the specified format as a string and relevant metadata, such as length and format type." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically assemble structured documents from multiple discrete content elements, applying formatting and producing a final document in various common formats for display or storage.", + "limitations": "Does not perform deep natural language understanding or generate content; it expects input content blocks to be pre-defined and focuses solely on composition and formatting.", + "examples": [ + "Compose a markdown document from multiple text and heading blocks.", + "Generate a JSON representation of an article composed of paragraphs, images, and lists.", + "Create an HTML document from input content blocks with embedded metadata." + ] + }, + "tags": [ + "document", + "composition", + "formatting", + "data-transformation", + "markdown", + "html", + "json" + ], + "examples": [ + { + "inputJson": "{\"contentBlocks\":[{\"type\":\"heading\",\"level\":1,\"text\":\"Monthly Report\"},{\"type\":\"paragraph\",\"text\":\"This is the summary of the report.\"},{\"type\":\"list\",\"style\":\"bullet\",\"items\":[\"Revenue increased\",\"Customer base expanded\"]}],\"outputFormat\":\"markdown\",\"includeMetadata\":true,\"documentTitle\":\"Monthly Report\"}", + "description": "Compose a markdown document containing a heading, paragraph, and bullet list with metadata included." + }, + { + "inputJson": "{\"contentBlocks\":[{\"type\":\"paragraph\",\"text\":\"Introduction to the project.\"},{\"type\":\"image\",\"url\":\"https://example.com/image.png\",\"altText\":\"Project image\"}],\"outputFormat\":\"html\",\"includeMetadata\":false,\"documentTitle\":\"Project Overview\"}", + "description": "Create an HTML document with text and an image without metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "data-validation.analyzeText", + "description": "Analyzes input text to assess quality aspects such as spelling accuracy, grammar correctness, readability score, sentiment polarity, and keyword density. Accepts raw text and optional parameters to focus analysis. Produces a detailed report with metrics and identified issues.", + "category": "data-validation", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw text content to be analyzed for quality and characteristics.", + "required": true, + "defaultValue": "" + }, + { + "name": "checkSpelling", + "type": "boolean", + "description": "Enable spelling error detection within the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "checkGrammar", + "type": "boolean", + "description": "Enable grammar error detection within the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "analyzeSentiment", + "type": "boolean", + "description": "Perform sentiment analysis to indicate positive, negative, or neutral tone.", + "required": false, + "defaultValue": "false" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of keywords to evaluate their frequency and density in the text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') to tailor analysis to the text's language.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing analysis results including spelling errors count, grammar issues list, readability score, sentiment label and score, and keyword density report." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate the quality, clarity, and tone of a text input, such as reviewing user submissions, assessing document quality, or extracting writing metrics for editorial purposes.", + "limitations": "This tool does not correct errors or rewrite text; it only identifies issues and provides analysis. It may not fully understand highly domain-specific or poetic language nuances.", + "examples": [ + "Analyze this blog post's text for grammar and readability.", + "Check the sentiment and keyword density in a customer review.", + "Evaluate a document for spelling mistakes and language correctness." + ] + }, + "tags": [ + "text analysis", + "data validation", + "quality check", + "sentiment analysis", + "readability", + "spelling", + "grammar" + ], + "examples": [ + { + "inputJson": "{\"text\":\"This sentence has a speling error.\",\"checkSpelling\":true,\"checkGrammar\":true}", + "description": "Analyze text with an intentional spelling error to identify it." + }, + { + "inputJson": "{\"text\":\"I love this product! It's fantastic and well-made.\",\"analyzeSentiment\":true}", + "description": "Perform sentiment analysis on a positive product review." + }, + { + "inputJson": "{\"text\":\"The quick brown fox jumps over the lazy dog.\",\"keywords\":[\"fox\",\"dog\"]}", + "description": "Evaluate keyword density for specific words in a well-known sentence." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Text", + "context": null + } + }, + { + "name": "data-validation.formatCode", + "description": "This tool accepts source code as input in various programming languages, formats the code according to specified style guidelines or predefined configurations, and outputs the well-formatted, standardized code string. It helps maintain code consistency and readability by applying indentation, spacing, and line-break rules.", + "category": "data-validation", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The source code text that needs to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming language of the source code (e.g., 'javascript', 'python', 'java').", + "required": true, + "defaultValue": "" + }, + { + "name": "styleConfig", + "type": "object", + "description": "Optional formatting style configuration specifying indentation size, max line length, and other formatting rules.", + "required": false, + "defaultValue": "" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum allowed line length before wrapping occurs; if zero or not set, default style is used.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted code string and any warnings if formatting could not be fully applied." + }, + "aiAgent": { + "useCase": "Use this tool when validating and cleaning source code input before further processing, to ensure that code conforms to style guidelines and is easier to analyze or display. It is particularly helpful for automated pipelines requiring consistent code style or for presenting code snippets in standardized formats.", + "limitations": "This tool does not perform code linting or correctness checking. It cannot fix semantic errors, only syntactic style formatting. Complex or unsupported languages may have limited formatting capabilities.", + "examples": [ + "Format a JavaScript function to use 2-space indentation and wrap lines at 80 characters.", + "Format a Python script with standard PEP8 indentation and spacing rules.", + "Format a Java file with tabs for indentation and a maximum line length of 100 characters." + ] + }, + "tags": [ + "formatting", + "code-style", + "source-code", + "validation", + "cleaning", + "programming-language" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function test() {console.log('hello world');}\",\"language\":\"javascript\",\"styleConfig\":{\"indentSize\":2},\"useTabs\":false,\"maxLineLength\":80}", + "description": "Format a simple JavaScript function with 2-space indentation and max line length 80." + }, + { + "inputJson": "{\"code\":\"def hello():\\n print('Hello world')\\n\",\"language\":\"python\",\"styleConfig\":{},\"useTabs\":false}", + "description": "Format a Python function with default style config (PEP8 style expected)." + }, + { + "inputJson": "{\"code\":\"public class Test{public static void main(String[] args){System.out.println(\\\"Hello\\\");}}\",\"language\":\"java\",\"useTabs\":true,\"maxLineLength\":100}", + "description": "Format Java code using tabs for indentation and a max line length of 100 characters." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "data-validation.generateWord", + "description": "Generates a single word string based on specified language, part of speech, and optional length constraints. Accepts parameters defining language code, desired part of speech (noun, verb, adjective, etc.), and minimum and maximum length for the word. Outputs a valid word string matching the criteria or an empty string if no suitable word is found.", + "category": "data-validation", + "parameters": [ + { + "name": "language", + "type": "string", + "description": "The language code (ISO 639-1) for the generated word (e.g., 'en' for English).", + "required": true, + "defaultValue": "\"en\"" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "The grammatical part of speech for the word to generate (e.g., noun, verb, adjective).", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "minLength", + "type": "number", + "description": "Minimum length of the generated word, inclusive.", + "required": false, + "defaultValue": "1" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word, inclusive.", + "required": false, + "defaultValue": "20" + }, + { + "name": "capitalize", + "type": "boolean", + "description": "Whether to capitalize the first letter of the generated word.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word as a string. Returns an empty string if no word matches criteria, with the field 'word'." + }, + "aiAgent": { + "useCase": "Use this tool when you need a valid word generated dynamically for data validation tests, such as testing input fields, language processing pipelines, or generating sample text data that must conform to specific linguistic properties. Ideal for quickly producing example words that meet language and part of speech constraints.", + "limitations": "This tool generates single words only, not phrases or sentences. It depends on internal lexical data which may not cover rare or highly specialized vocabulary. It does not guarantee semantic appropriateness beyond part of speech filtering.", + "examples": [ + "Generate a noun in English between 3 and 8 letters.", + "Generate a capitalized adjective in Spanish.", + "Generate any verb in English with no length constraints." + ] + }, + "tags": [ + "data-validation", + "word-generation", + "linguistics", + "language", + "part-of-speech", + "text-data" + ], + "examples": [ + { + "inputJson": "{\"language\":\"en\",\"partOfSpeech\":\"noun\",\"minLength\":3,\"maxLength\":8,\"capitalize\":false}", + "description": "Generate an English noun between 3 and 8 letters, lowercase." + }, + { + "inputJson": "{\"language\":\"es\",\"partOfSpeech\":\"adjective\",\"capitalize\":true}", + "description": "Generate a capitalized Spanish adjective with default length constraints." + }, + { + "inputJson": "{\"language\":\"en\",\"partOfSpeech\":\"verb\"}", + "description": "Generate any English verb with default length constraints, lowercase." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Word", + "context": null + } + }, + { + "name": "data-validation.generateJSON", + "description": "Generates synthetic JSON data objects based on a user-defined schema to facilitate data validation and testing. Accepts a schema defining fields, types, and value constraints, then produces an array of JSON objects conforming to these specifications, supporting realistic test data generation.", + "category": "data-validation", + "parameters": [ + { + "name": "schema", + "type": "object", + "description": "An object defining the structure of JSON objects to generate, including field names, data types (string, number, boolean, array, object), and optional constraints (e.g., min, max, regex).", + "required": true, + "defaultValue": "" + }, + { + "name": "count", + "type": "number", + "description": "Number of JSON objects to generate according to the schema.", + "required": true, + "defaultValue": "1" + }, + { + "name": "includeNulls", + "type": "boolean", + "description": "Whether to randomly include null values for fields when allowed by the schema.", + "required": false, + "defaultValue": "false" + }, + { + "name": "seed", + "type": "number", + "description": "Optional seed for random data generation to ensure reproducibility of generated data.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "array", + "description": "An array of generated JSON objects matching the specified schema and constraints, suitable for validation and testing purposes." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create realistic yet synthetic JSON data samples for validating data ingestion pipelines, testing APIs, or verifying data processing workflows. It helps generate predictable, structured test data based on dynamic schema input, supporting robust QA and integration testing.", + "limitations": "This tool does not generate meaningful semantic content beyond schema constraints; it cannot infer domain-specific logic or complex data interdependencies beyond basic constraint rules.", + "examples": [ + "Generate 100 JSON user profiles with name, age, and email fields defined in the schema.", + "Create 10 sample order objects including nested address and product arrays to test an ecommerce API.", + "Produce 50 JSON objects with boolean flags and optional nullable fields for feature flag testing." + ] + }, + "tags": [ + "data-validation", + "json", + "test-data-generation", + "synthetic-data", + "schema-driven", + "data-quality", + "testing" + ], + "examples": [ + { + "inputJson": "{\"schema\":{\"name\":{\"type\":\"string\",\"regex\":\"^[A-Za-z]{3,10}$\"},\"age\":{\"type\":\"number\",\"min\":18,\"max\":99},\"email\":{\"type\":\"string\",\"regex\":\"^[\\w.-]+@[\\w.-]+\\\\.com$\"}},\"count\":5}", + "description": "Generate 5 JSON objects with name (3-10 letters), age between 18 and 99, and email matching a simple pattern." + }, + { + "inputJson": "{\"schema\":{\"id\":{\"type\":\"string\",\"regex\":\"^ID\\\\d{4}$\"},\"active\":{\"type\":\"boolean\"}},\"count\":3,\"includeNulls\":true}", + "description": "Generate 3 JSON objects with an ID string formatted 'ID' plus 4 digits, and an active boolean with possible null values." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "JSON", + "context": null + } + }, + { + "name": "data-validation.createAPI", + "description": "Creates a RESTful API endpoint that validates incoming JSON data against a defined JSON schema. Accepts a JSON schema and configuration options, then generates API code that processes requests, validates payloads, and returns validation results or error messages. Output includes the API source code as a string.", + "category": "data-validation", + "parameters": [ + { + "name": "jsonSchema", + "type": "object", + "description": "The JSON schema object defining the validation rules for incoming data.", + "required": true, + "defaultValue": "" + }, + { + "name": "apiEndpoint", + "type": "string", + "description": "The URL path for the API endpoint (e.g., '/validate').", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method to listen for, e.g., 'POST', 'PUT'.", + "required": false, + "defaultValue": "\"POST\"" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Programming language for the generated API code (e.g., 'NodeJS', 'Python').", + "required": false, + "defaultValue": "\"NodeJS\"" + }, + { + "name": "framework", + "type": "string", + "description": "Web framework to use for generating the API (e.g., 'Express' for NodeJS, 'Flask' for Python).", + "required": false, + "defaultValue": "\"Express\"" + }, + { + "name": "requireAuthentication", + "type": "boolean", + "description": "Flag indicating whether the generated API requires an authentication token header.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated API source code as a string and metadata such as language and framework used." + }, + "aiAgent": { + "useCase": "Use this tool when needing to quickly scaffold a validation API endpoint from a JSON schema to enforce data integrity in applications or services. Ideal for backend services requiring standardized input validation without manual coding. It automates API code generation for easy integration and testing.", + "limitations": "Does not deploy or host the generated API; does not support advanced schema features like conditional schemas or custom validation functions; limited to basic authentication inclusion; supports only a few languages and frameworks.", + "examples": [ + "Create an API in NodeJS with Express that validates user registration payloads against a user schema.", + "Generate a POST endpoint in Python Flask that validates order submission JSON data.", + "Create a secured validation API endpoint requiring authentication token for financial transaction inputs." + ] + }, + "tags": [ + "data-validation", + "API", + "code-generation", + "JSON-schema", + "backend", + "automation" + ], + "examples": [ + { + "inputJson": "{\"jsonSchema\":{\"type\":\"object\",\"properties\":{\"username\":{\"type\":\"string\"},\"password\":{\"type\":\"string\"}},\"required\":[\"username\",\"password\"]},\"apiEndpoint\":\"/validateUser\",\"httpMethod\":\"POST\",\"programmingLanguage\":\"NodeJS\",\"framework\":\"Express\",\"requireAuthentication\":false}", + "description": "Generate a NodeJS Express POST API '/validateUser' that validates username and password fields." + }, + { + "inputJson": "{\"jsonSchema\":{\"type\":\"object\",\"properties\":{\"orderId\":{\"type\":\"string\"},\"amount\":{\"type\":\"number\"}},\"required\":[\"orderId\",\"amount\"]},\"apiEndpoint\":\"/validateOrder\",\"httpMethod\":\"POST\",\"programmingLanguage\":\"Python\",\"framework\":\"Flask\",\"requireAuthentication\":true}", + "description": "Generate a secured Python Flask API POST endpoint '/validateOrder' validating orderId and amount." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "etl-processes.uploadReport", + "description": "Uploads a structured report file (e.g., PDF, DOCX, or JSON) to a specified data repository or server for storage and further ETL processing. Accepts file data and metadata, validates formats and authentication, then stores the report and returns upload status and storage location.", + "category": "etl-processes", + "parameters": [ + { + "name": "fileContent", + "type": "string", + "description": "Base64-encoded content of the report file to be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "The name of the report file including extension (e.g., report.pdf).", + "required": true, + "defaultValue": "" + }, + { + "name": "fileType", + "type": "string", + "description": "MIME type of the report file (e.g., application/pdf).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Target path or folder in the repository where the report will be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional metadata about the report, such as author, date, or tags.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Whether to overwrite a report if one with the same name exists at the destination.", + "required": false, + "defaultValue": "false" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or API key required to authorize the upload operation.", + "required": true, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "The result object indicating success or failure of the upload, including a message and the URL/location of the stored report if successful." + }, + "aiAgent": { + "useCase": "Use this tool when needing to upload structured or semi-structured reports as part of an ETL pipeline to a data storage or management system. It facilitates incorporation of document data into the ETL process by managing transfer, validation, and storage of report files with metadata and access control.", + "limitations": "Does not parse or analyze the report content; only uploads and stores files. Not designed for streaming large files or direct editing of report contents.", + "examples": [ + "Upload a monthly sales report PDF to the reports repository, providing authentication and metadata.", + "Overwrite an existing JSON report file in a subfolder with updated data.", + "Upload a DOCX project summary report with author metadata and save it under a secure folder path." + ] + }, + "tags": [ + "upload", + "report", + "etl", + "file-storage", + "document-management", + "data-pipeline" + ], + "examples": [ + { + "inputJson": "{\"fileContent\":\"JVBERi0xLjQKJcfs...\",\"fileName\":\"monthly-sales.pdf\",\"fileType\":\"application/pdf\",\"destinationPath\":\"/reports/2024/monthly/\",\"metadata\":{\"author\":\"Jane Doe\",\"department\":\"Sales\"},\"overwriteExisting\":false,\"authToken\":\"eyJhbGciOiJI...\"}", + "description": "Uploading a PDF monthly sales report with metadata to the designated monthly reports folder." + }, + { + "inputJson": "{\"fileContent\":\"UEsDBBQABgAIAAAAIQC...\",\"fileName\":\"project-summary.docx\",\"fileType\":\"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\"destinationPath\":\"/projects/summary/\",\"metadata\":{\"author\":\"John Smith\",\"tags\":[\"summary\",\"project\"]},\"overwriteExisting\":true,\"authToken\":\"eyJhbGciOiJI...\"}", + "description": "Overwriting an existing DOCX project summary report with new content and metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Report", + "context": null + } + }, + { + "name": "etl-processes.formatReport", + "description": "Formats a structured report data object into a well-organized, human-readable document in various formats such as PDF, HTML, or plain text. It accepts raw report content and layout options, applies formatting rules like headers, footers, tables, and styling, then outputs the formatted report as a string or binary data for further use or distribution.", + "category": "etl-processes", + "parameters": [ + { + "name": "reportData", + "type": "object", + "description": "The raw report content including sections, tables, texts, and metadata to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "formatType", + "type": "string", + "description": "The output format of the report, e.g., 'pdf', 'html', or 'text'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents in the formatted report.", + "required": false, + "defaultValue": "false" + }, + { + "name": "pageSize", + "type": "string", + "description": "The page size for the output document, e.g., 'A4', 'Letter'. Applicable mainly for PDF format.", + "required": false, + "defaultValue": "A4" + }, + { + "name": "includePageNumbers", + "type": "boolean", + "description": "Whether to add page numbers to each page in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "styleOptions", + "type": "object", + "description": "An object describing styling preferences like fonts, colors, and margins for report formatting.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted report output, including a base64 encoded string for binary formats or raw string for plaintext." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to convert raw structured report data into polished, presentation-ready documents in various formats for distribution, printing, or archiving. It is particularly useful for automating report generation after data extraction and analysis stages.", + "limitations": "This tool does not generate report content or perform data analysis. It formats existing report data but cannot correct content errors or create data visualizations beyond basic table rendering.", + "examples": [ + "Format quarterly sales report data into a styled PDF with page numbers.", + "Generate an HTML report including a table of contents from structured input data.", + "Produce a plain text summary report without page numbers." + ] + }, + "tags": [ + "etl", + "report", + "formatting", + "pdf", + "html", + "document", + "automation" + ], + "examples": [ + { + "inputJson": "{\"reportData\":{\"title\":\"Quarterly Sales\",\"sections\":[{\"header\":\"Q1 Summary\",\"content\":\"Sales increased by 10% compared to last quarter.\"}]},\"formatType\":\"pdf\",\"includeTableOfContents\":true,\"pageSize\":\"Letter\",\"includePageNumbers\":true,\"styleOptions\":{\"font\":\"Arial\",\"fontSize\":12}}", + "description": "Format a quarterly sales report into a Letter-sized PDF with table of contents and page numbers using Arial font." + }, + { + "inputJson": "{\"reportData\":{\"title\":\"System Logs\",\"sections\":[{\"header\":\"Errors\",\"content\":\"No errors found during the scan.\"}]},\"formatType\":\"html\",\"includeTableOfContents\":false,\"includePageNumbers\":false}", + "description": "Generate an HTML report for system logs without table of contents and page numbers." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Report", + "context": null + } + }, + { + "name": "etl-processes.generateEvent", + "description": "Generates a structured analytics event record from raw input data. Accepts event metadata such as event type, user identifiers, properties, and timestamps, processes them to create a consistent event object, and outputs the event in a format ready for downstream analytics ingestion or storage.", + "category": "etl-processes", + "parameters": [ + { + "name": "eventType", + "type": "string", + "description": "The type or name of the event to generate (e.g., 'page_view', 'purchase').", + "required": true, + "defaultValue": "" + }, + { + "name": "userId", + "type": "string", + "description": "Unique identifier for the user performing the event.", + "required": false, + "defaultValue": "" + }, + { + "name": "sessionId", + "type": "string", + "description": "Identifier for the user's session to group events.", + "required": false, + "defaultValue": "" + }, + { + "name": "eventProperties", + "type": "object", + "description": "A key-value map of additional properties related to the event (e.g., productId, pageUrl).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timestamp", + "type": "string", + "description": "ISO 8601 formatted timestamp representing when the event occurred. Defaults to current time if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "anonymizeUser", + "type": "boolean", + "description": "If true, the userId will be removed/anonymized in the output event.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "A structured event object including sanitized eventType, timestamp, user/session identifiers as applicable, and event properties, ready for ingestion." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate consistent, structured analytics event data from various input sources. Especially useful in ETL pipelines to standardize event formats before loading into data warehouses or analytics systems.", + "limitations": "Does not validate event property schemas beyond basic JSON structure; does not enrich events with external data or complex transformations; timestamps default to current time if none provided but depend on correct formatting if supplied.", + "examples": [ + "Generate an event record for a user purchase with product details and user identifiers.", + "Create a page view event anonymizing user info for privacy compliance.", + "Standardize raw click event data into a uniform event structure for analytics ingestion." + ] + }, + "tags": [ + "etl", + "event", + "analytics", + "data-transformation", + "tracking", + "ingestion" + ], + "examples": [ + { + "inputJson": "{\"eventType\":\"purchase\",\"userId\":\"user123\",\"sessionId\":\"sess456\",\"eventProperties\":{\"productId\":\"prod789\",\"price\":29.99},\"timestamp\":\"2024-06-01T12:34:56Z\",\"anonymizeUser\":false}", + "description": "Generate a purchase event recording product ID, price, user and session IDs with a specified timestamp." + }, + { + "inputJson": "{\"eventType\":\"page_view\",\"userId\":\"user123\",\"eventProperties\":{\"pageUrl\":\"https://example.com/home\"},\"anonymizeUser\":true}", + "description": "Generate a page view event with anonymized user ID and current timestamp." + }, + { + "inputJson": "{\"eventType\":\"click\",\"eventProperties\":{\"buttonId\":\"signup-btn\"}}", + "description": "Generate a click event with minimal data, defaulting timestamp to current time and no user/session info." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Event", + "context": null + } + }, + { + "name": "etl-processes.generateCSV", + "description": "Generates a CSV-formatted string from a given array of objects or array of arrays. Accepts input data as JSON objects or arrays, applies optional custom headers and delimiter, and outputs a valid CSV string ready for saving or transmission.", + "category": "etl-processes", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Input data to convert into CSV format. Can be an array of objects (keys become headers) or array of arrays (rows).", + "required": true, + "defaultValue": "" + }, + { + "name": "headers", + "type": "array", + "description": "Optional array of strings specifying CSV column headers. If omitted and data is array of objects, keys from first object are used.", + "required": false, + "defaultValue": "" + }, + { + "name": "delimiter", + "type": "string", + "description": "Delimiter character to separate CSV columns. Defaults to comma (,).", + "required": false, + "defaultValue": "," + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include headers as the first row in CSV output. Defaults to true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "quoteChar", + "type": "string", + "description": "Character used to quote values that contain delimiters or special characters. Defaults to double quote (\").", + "required": false, + "defaultValue": "\"" + }, + { + "name": "lineEnding", + "type": "string", + "description": "String used to terminate each CSV line. Defaults to standard CRLF (\\r\\n).", + "required": false, + "defaultValue": "\\r\\n" + } + ], + "returns": { + "type": "object", + "description": "An object containing the CSV string under 'csvContent' key." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to convert structured JSON data (arrays of objects or arrays) into a CSV formatted string for data export, reporting, or integration. It enables agents to serialize structured data efficiently with control over CSV format details like delimiters and headers.", + "limitations": "This tool does not perform any data validation or normalization beyond CSV formatting. It cannot convert nested or complex data types automatically. It does not write to files, only returns CSV as string.", + "examples": [ + "Generate CSV from an array of user objects with default settings.", + "Generate CSV from array of arrays with a semicolon delimiter.", + "Export data with custom headers and disable headers row in output." + ] + }, + "tags": [ + "etl", + "csv", + "data-export", + "data-transformation", + "serialization" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}]}", + "description": "Generate CSV from an array of objects using keys as headers." + }, + { + "inputJson": "{\"data\":[[\"name\",\"age\",\"city\"],[\"Charlie\",22,\"Chicago\"],[\"Diana\",28,\"Boston\"]],\"delimiter\":\";\"}", + "description": "Generate CSV from array of arrays with semicolon delimiter." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Book\",\"price\":12.99},{\"product\":\"Pen\",\"price\":1.5}],\"headers\":[\"productName\",\"productPrice\"],\"includeHeaders\":false}", + "description": "Generate CSV from objects with custom headers and omit headers row." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "CSV", + "context": null + } + }, + { + "name": "etl-processes.createService", + "description": "Creates a new ETL (Extract, Transform, Load) service configuration to automate data workflows. Accepts input parameters defining source and destination data systems, transformation rules, schedule settings, and service metadata. Processes these inputs to generate a deployable ETL service definition that orchestrates data extraction, transformation, and loading tasks.", + "category": "etl-processes", + "parameters": [ + { + "name": "serviceName", + "type": "string", + "description": "Unique name for the ETL service to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceConfig", + "type": "object", + "description": "Configuration object defining the data source connection and extraction parameters.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationConfig", + "type": "object", + "description": "Configuration object specifying the target data system and loading options.", + "required": true, + "defaultValue": "" + }, + { + "name": "transformationRules", + "type": "array", + "description": "Array of transformation rule objects defining how to modify or map the extracted data before loading.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "scheduleCron", + "type": "string", + "description": "Cron expression defining the execution schedule for the ETL service.", + "required": false, + "defaultValue": "" + }, + { + "name": "enableLogging", + "type": "boolean", + "description": "Flag to enable detailed logging for the ETL service runs.", + "required": false, + "defaultValue": "false" + }, + { + "name": "retryPolicy", + "type": "object", + "description": "Configuration for retry attempts and intervals on ETL task failures.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the created ETL service ID, configuration summary, and deployment status." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the creation of data integration services that move and transform data between systems on a scheduled or triggered basis. This applies to automating data pipeline setup for analytics, reporting, or migration tasks where reusable ETL definitions are required.", + "limitations": "This tool does not perform the actual data extraction or loading; it only generates the service configuration. Actual runtime execution depends on the ETL infrastructure outside the scope of this tool. Complex transformations requiring custom scripting may need additional tooling.", + "examples": [ + "Create an ETL service to extract sales data from an SQL database, transform currency fields, and load into a data warehouse every night at 2 AM.", + "Create a service to move JSON logs from cloud storage, flatten nested fields, and load into a NoSQL database with retry on failure.", + "Set up a monthly ETL job importing user data from REST API endpoints into a reporting database with detailed success/failure logging enabled." + ] + }, + "tags": [ + "etl", + "service", + "automation", + "data-integration", + "workflow", + "scheduling", + "transformation" + ], + "examples": [ + { + "inputJson": "{\"serviceName\":\"dailySalesImport\",\"sourceConfig\":{\"type\":\"sql\",\"connectionString\":\"Server=myServer;Database=sales;User Id=admin;Password=password;\",\"query\":\"SELECT * FROM daily_sales\"},\"destinationConfig\":{\"type\":\"dataWarehouse\",\"connectionString\":\"Server=dwServer;Database=analytics;User Id=dwadmin;Password=dwpass;\"},\"transformationRules\":[{\"field\":\"sales_amount\",\"operation\":\"currencyConversion\",\"params\":{\"from\":\"USD\",\"to\":\"EUR\"}}],\"scheduleCron\":\"0 2 * * *\",\"enableLogging\":true}", + "description": "Create a daily ETL service to import and convert sales data from SQL DB to data warehouse with logging enabled." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Service", + "context": null + } + }, + { + "name": "etl-processes.createLead", + "description": "Creates a new sales lead record by extracting provided lead information, validating and transforming necessary fields, and loading the transformed data into the CRM system. Accepts input details such as name, contact info, company, and lead source, then outputs a confirmation with lead ID and status.", + "category": "etl-processes", + "parameters": [ + { + "name": "firstName", + "type": "string", + "description": "First name of the lead contact person", + "required": true, + "defaultValue": "" + }, + { + "name": "lastName", + "type": "string", + "description": "Last name of the lead contact person", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Email address of the lead; must be valid format", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Phone number of the lead, optional but recommended", + "required": false, + "defaultValue": "" + }, + { + "name": "companyName", + "type": "string", + "description": "Name of the lead's company or organization", + "required": false, + "defaultValue": "" + }, + { + "name": "leadSource", + "type": "string", + "description": "Origin of the lead such as referral, web, event, etc.", + "required": false, + "defaultValue": "web" + }, + { + "name": "tags", + "type": "array", + "description": "Array of tags or categories to classify the lead", + "required": false, + "defaultValue": "[]" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the lead, e.g. High, Medium, Low", + "required": false, + "defaultValue": "Medium" + } + ], + "returns": { + "type": "object", + "description": "Object containing the newly created lead ID, status, and a message confirming lead creation" + }, + "aiAgent": { + "useCase": "Use this tool when user requests to create or register a new sales lead by supplying personal and business details. It automates the ETL process for new leads to be entered into CRM systems ensuring data validation, transformation, and successful persistence.", + "limitations": "This tool does not handle updating or deleting existing leads. It requires valid and non-empty essential fields like firstName, lastName, and email; it does not validate phone numbers beyond format check.", + "examples": [ + "Create a new lead with full contact info from a trade show", + "Add a lead coming from an email campaign with company details", + "Register a lead quickly using only the minimal required fields" + ] + }, + "tags": [ + "etl", + "lead management", + "crm", + "data ingestion", + "sales automation" + ], + "examples": [ + { + "inputJson": "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"email\":\"jane.doe@example.com\",\"phoneNumber\":\"+1234567890\",\"companyName\":\"Acme Corp\",\"leadSource\":\"trade show\",\"tags\":[\"VIP\",\"north region\"],\"priority\":\"High\"}", + "description": "Create a high priority lead from a trade show event with full contact information." + }, + { + "inputJson": "{\"firstName\":\"John\",\"lastName\":\"Smith\",\"email\":\"john.smith@example.com\"}", + "description": "Create a basic lead with only the required fields for quick registration." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Lead", + "context": null + } + }, + { + "name": "etl-processes.createCSV", + "description": "Creates a CSV file from structured data provided as an array of objects or arrays. Accepts data input along with optional parameters for delimiter, header inclusion, and quotation style. Processes the input to generate a CSV-formatted string, optionally writing it to a specified file path, and returns the CSV content as a string.", + "category": "etl-processes", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects or arrays representing the rows of the CSV data. Each object key or array index corresponds to a column.", + "required": true, + "defaultValue": "" + }, + { + "name": "hasHeader", + "type": "boolean", + "description": "Indicates if the CSV should include a header row derived from object keys or array indexes.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "The character used to separate values in the CSV (e.g., ',', ';', '\\t').", + "required": false, + "defaultValue": "," + }, + { + "name": "quoteChar", + "type": "string", + "description": "Character used to quote fields, typically double quotes (\") or single quotes (').", + "required": false, + "defaultValue": "\"" + }, + { + "name": "filePath", + "type": "string", + "description": "Optional file system path to save the generated CSV file. If empty, CSV is not saved to disk.", + "required": false, + "defaultValue": "" + }, + { + "name": "encoding", + "type": "string", + "description": "Character encoding to use when saving the CSV file (e.g., 'utf-8').", + "required": false, + "defaultValue": "utf-8" + }, + { + "name": "includeBOM", + "type": "boolean", + "description": "Whether to include a BOM (byte order mark) at the start of the file to aid compatibility.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the full CSV string as 'csvContent' and, if filePath is provided, a confirmation of file write success as 'fileWritten' boolean." + }, + "aiAgent": { + "useCase": "Use this tool when needing to convert structured JSON-like data into CSV format for data export, reporting, or feeding into systems expecting CSV input. It is suitable when controlling CSV format details such as delimiter or quote characters is necessary, and optional automatic file writing is desired.", + "limitations": "This tool does not handle extremely large datasets that require streaming due to memory constraints. It also does not infer complex nested data structures beyond flat objects or arrays.", + "examples": [ + "Create a CSV from an array of objects with default comma delimiter and header row.", + "Create a tab-separated CSV file saved to disk without headers.", + "Generate a CSV string with semicolon delimiters and quoted fields, without saving a file." + ] + }, + "tags": [ + "etl", + "csv", + "data-format", + "export", + "file-generation" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"NYC\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"LA\"}],\"hasHeader\":true,\"delimiter\":\",\",\"quoteChar\":\"\\\"\",\"filePath\":\"\",\"encoding\":\"utf-8\",\"includeBOM\":false}", + "description": "Convert array of objects to CSV string with header and default comma delimiter, no file output." + }, + { + "inputJson": "{\"data\":[[\"name\",\"age\",\"score\"],[\"Tom\",22,88],[\"Sue\",28,92]],\"hasHeader\":false,\"delimiter\":\"\\t\",\"quoteChar\":\"\\\"\",\"filePath\":\"./output.tsv\",\"encoding\":\"utf-8\",\"includeBOM\":true}", + "description": "Create a TSV file from array of arrays data without header auto-generation, file saved with UTF-8 and BOM." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Pen\",\"price\":1.25},{\"product\":\"Notebook\",\"price\":2.5}],\"hasHeader\":true,\"delimiter\":\";\",\"quoteChar\":\"'\",\"filePath\":\"\",\"encoding\":\"utf-8\",\"includeBOM\":false}", + "description": "Generate a semicolon-delimited CSV string with single quotes around fields, no file saved." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "CSV", + "context": null + } + }, + { + "name": "testing-automation.formatDocument", + "description": "This tool accepts source code or text documents and formats them according to specified style guidelines or formatting rules. It processes the input document, applies formatting such as indentation, line breaks, spacing, and ordering, then outputs the reformatted document text. It supports multiple programming languages and document types based on provided language and style parameters.", + "category": "testing-automation", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "The raw text content of the document or source code to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming or document language identifier (e.g., 'javascript', 'python', 'markdown') to determine the formatting rules.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Identifies which style guide or formatting preset to apply (e.g., 'google', 'pep8', 'default').", + "required": false, + "defaultValue": "default" + }, + { + "name": "tabSize", + "type": "number", + "description": "Number of spaces per indentation level. Used when formatting indentation.", + "required": false, + "defaultValue": "4" + }, + { + "name": "insertFinalNewline", + "type": "boolean", + "description": "Whether to ensure the formatted document ends with a newline character.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Preferred maximum line length before wrapping or breaking lines, if applicable.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted document as a string and metadata such as formatting success status and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to normalize or beautify source code or text documents automatically during testing pipelines, code reviews, or pre-commit hooks to ensure consistent formatting across a project. Suitable for preparing documents for automated quality checks or version control commits.", + "limitations": "Cannot fix semantic errors or rewrite code logic. It only reformats the structure and appearance of the document text. Language support depends on implemented formatting rules. May not support very obscure or custom languages or styles fully.", + "examples": [ + "Format this JavaScript file content following the Google JavaScript style guide with 2 spaces per tab.", + "Reformat the Python script to comply with PEP8 style and ensure lines are wrapped at 79 characters.", + "Format the provided Markdown document text with default indentation and add a trailing newline." + ] + }, + "tags": [ + "formatting", + "automation", + "testing", + "code-quality", + "style", + "source-code" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"function test( ){console.log( 'Hello world' );}\",\"language\":\"javascript\",\"styleGuide\":\"google\",\"tabSize\":2,\"insertFinalNewline\":true,\"maxLineLength\":80}", + "description": "Format a Javascript function using Google style guide with 2-space indent." + }, + { + "inputJson": "{\"documentContent\":\"def foo():\\n print('bar')\",\"language\":\"python\",\"styleGuide\":\"pep8\",\"tabSize\":4,\"insertFinalNewline\":true,\"maxLineLength\":79}", + "description": "Format a Python snippet according to PEP8 style with 4 spaces indentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Document", + "context": null + } + }, + { + "name": "testing-automation.formatCode", + "description": "Formats source code according to specified style guidelines to improve readability and maintain consistency. Accepts raw code as input along with language and style preferences. Returns the code formatted according to the given rules or standard conventions if none specified.", + "category": "testing-automation", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "Source code text to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the input code (e.g., 'javascript', 'python') to apply appropriate formatting rules", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Optional style guide to apply (e.g., 'Google', 'PEP8', 'Airbnb'). If empty, default style for the language is used", + "required": false, + "defaultValue": "" + }, + { + "name": "indentSize", + "type": "number", + "description": "Number of spaces to use for indentation", + "required": false, + "defaultValue": "4" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tab characters for indentation instead of spaces", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLineLength", + "type": "number", + "description": "Maximum number of characters per line; lines will be wrapped accordingly", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the formatted code string and metadata about the formatting process, including whether any errors occurred." + }, + "aiAgent": { + "useCase": "Use this tool whenever source code needs to be automatically formatted to improve readability, adhere to coding standards, or normalize style before automated testing or code reviews. It helps maintain uniform code style across different languages and projects by applying language-specific formatting rules and customizable style guides.", + "limitations": "This tool does not perform syntax checking or code linting beyond formatting. It cannot fix semantic errors or enforce complex custom linting rules beyond standard style guide formatting.", + "examples": [ + "Format a messy JavaScript snippet according to the Airbnb style guide.", + "Reformat Python code using PEP8 conventions with 2 space indents.", + "Wrap lines in Java source code to 100 characters using tabs for indentation." + ] + }, + "tags": [ + "formatting", + "code-style", + "testing-automation", + "code-quality", + "automation", + "linting" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function test(){console.log('hello');}\",\"language\":\"javascript\",\"styleGuide\":\"Airbnb\",\"indentSize\":2,\"useTabs\":false,\"maxLineLength\":80}", + "description": "Format JavaScript code using Airbnb style with 2 spaces indentation and 80 character line length limit." + }, + { + "inputJson": "{\"code\":\"def example():\\n print(\\\"hello world\\\")\",\"language\":\"python\",\"styleGuide\":\"PEP8\",\"indentSize\":4,\"useTabs\":false,\"maxLineLength\":79}", + "description": "Format Python code according to PEP8 with 4 space indentation and standard line length." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "testing-automation.composeDocument", + "description": "Composes a structured test document by integrating provided test case specifications, setup instructions, and expected outcomes. Accepts arrays of test cases and configuration details, then generates a formatted document in Markdown or HTML summarizing all elements for automated testing documentation purposes.", + "category": "testing-automation", + "parameters": [ + { + "name": "testCases", + "type": "array", + "description": "Array of test case objects, each with title, description, steps, and expected results", + "required": true, + "defaultValue": "" + }, + { + "name": "setupInstructions", + "type": "string", + "description": "Instructions or prerequisite steps required before executing the test cases", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output document format, either 'markdown' or 'html'", + "required": true, + "defaultValue": "markdown" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include an overall summary section in the generated document", + "required": false, + "defaultValue": "true" + }, + { + "name": "documentTitle", + "type": "string", + "description": "Title of the test document; appears as heading", + "required": false, + "defaultValue": "Test Document" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document content as a string and its format type" + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to generate human-readable testing documentation automatically from raw test case data during software development or QA automation. It streamlines composing consistent test specification documents compatible with CI/CD pipelines or manual review.", + "limitations": "Cannot execute or validate test cases; focuses solely on formatting and composing textual test documentation based on provided inputs.", + "examples": [ + "Generate a Markdown test document from a list of functional test cases for a web application.", + "Create an HTML formatted test spec document including setup instructions for the QA team.", + "Compose a test document summary for integration tests with clear expected results sections." + ] + }, + "tags": [ + "testing", + "automation", + "document-generation", + "test-specification", + "QA" + ], + "examples": [ + { + "inputJson": "{\"testCases\":[{\"title\":\"Login Functionality\",\"description\":\"Verify login with valid credentials.\",\"steps\":[\"Navigate to login page\",\"Enter valid username and password\",\"Click login button\"],\"expectedResults\":\"User is redirected to dashboard.\"}],\"setupInstructions\":\"Ensure test environment is running and database has valid user records.\",\"outputFormat\":\"markdown\",\"includeSummary\":true,\"documentTitle\":\"User Login Tests\"}", + "description": "Compose a Markdown document for user login test cases including setup instructions and summary." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "testing-automation.createText", + "description": "Generates test input text based on specified criteria for automated software testing. Accepts parameters defining length, character sets, patterns, or randomness, then produces text strings suitable to simulate user input or test data within testing frameworks.", + "category": "testing-automation", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Desired length of the generated text string.", + "required": true, + "defaultValue": "100" + }, + { + "name": "includeUppercase", + "type": "boolean", + "description": "Whether to include uppercase letters in the generated text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeLowercase", + "type": "boolean", + "description": "Whether to include lowercase letters in the generated text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeDigits", + "type": "boolean", + "description": "Whether to include numeric digits in the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSpecialChars", + "type": "boolean", + "description": "Whether to include special characters in the text (e.g., !@#$%).", + "required": false, + "defaultValue": "false" + }, + { + "name": "pattern", + "type": "string", + "description": "Optional regex pattern that generated text should match. Overrides character set options if provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text string under the 'text' property." + }, + "aiAgent": { + "useCase": "Use this tool when automated tests require generated string inputs matching specific patterns or character compositions, such as simulating user inputs, testing form validations, or stress-testing text handling functions.", + "limitations": "Cannot guarantee matching highly complex regex patterns perfectly; pattern support is simplified. Not suitable for generating semantically meaningful or linguistically correct text.", + "examples": [ + "Generate a 50-character alphanumeric string with special characters.", + "Produce a 10-character string containing only digits.", + "Create a text string matching the regex pattern '^AB\\d{3}XYZ$'." + ] + }, + "tags": [ + "testing", + "automation", + "text-generation", + "input-simulation", + "test-data" + ], + "examples": [ + { + "inputJson": "{\"length\":50,\"includeUppercase\":true,\"includeLowercase\":true,\"includeDigits\":true,\"includeSpecialChars\":true}", + "description": "Generate a 50-character string including uppercase, lowercase, digits, and special characters." + }, + { + "inputJson": "{\"length\":10,\"includeUppercase\":false,\"includeLowercase\":false,\"includeDigits\":true,\"includeSpecialChars\":false}", + "description": "Generate a 10-digit numeric string only." + }, + { + "inputJson": "{\"length\":8,\"pattern\":\"^AB\\\\d{3}XY$\"}", + "description": "Generate a string that starts with 'AB', followed by exactly 3 digits, then 'XY'." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "testing-automation.createTest", + "description": "Creates an automated test script for software applications based on user-defined parameters such as test type, target platform, and test steps. Accepts details about the test scenario and outputs structured test code or script ready for integration with test frameworks.", + "category": "testing-automation", + "parameters": [ + { + "name": "testType", + "type": "string", + "description": "Type of the test to create, e.g., unit, integration, end-to-end, performance, accessibility.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetPlatform", + "type": "string", + "description": "The platform or environment to test on, e.g., web, android, ios, backend API.", + "required": true, + "defaultValue": "" + }, + { + "name": "testSteps", + "type": "array", + "description": "An ordered list of test steps detailing actions, inputs, and expected outcomes.", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Desired programming or scripting language for the generated test code, e.g., JavaScript, Python, Java.", + "required": false, + "defaultValue": "JavaScript" + }, + { + "name": "framework", + "type": "string", + "description": "Testing framework to generate test code compatible with, e.g., Jest, Cypress, Selenium.", + "required": false, + "defaultValue": "Jest" + }, + { + "name": "includeSetupTeardown", + "type": "boolean", + "description": "Whether to include setup and teardown methods in the test code for initializing and cleaning test states.", + "required": false, + "defaultValue": "true" + }, + { + "name": "testName", + "type": "string", + "description": "A descriptive name for the test case to include in the generated code.", + "required": false, + "defaultValue": "\"Generated Test\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated test code as a string and metadata about the generated test such as language and framework." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate automated test scripts from structured test scenario descriptions, allowing quick creation of tests for continuous integration, development workflows, or quality assurance processes without manually writing code.", + "limitations": "This tool cannot run or execute the generated test code, validate its correctness against actual applications, or handle complex adaptive test logic beyond the inputs provided. It generates code templates but does not interact with live environments.", + "examples": [ + "Create a unit test for a login function on a web platform using Jest in JavaScript.", + "Generate an end-to-end test for an ecommerce checkout flow targeting a web platform with Cypress.", + "Produce an integration test for a backend API endpoint in Python using pytest." + ] + }, + "tags": [ + "testing", + "automation", + "test-generation", + "code-generation", + "software-testing", + "automated-tests", + "QA" + ], + "examples": [ + { + "inputJson": "{\"testType\":\"unit\",\"targetPlatform\":\"web\",\"testSteps\":[{\"action\":\"call function\",\"functionName\":\"login\",\"inputs\":{\"username\":\"testuser\",\"password\":\"pass123\"},\"expectedOutcome\":\"returns true\"}],\"programmingLanguage\":\"JavaScript\",\"framework\":\"Jest\",\"includeSetupTeardown\":true,\"testName\":\"Login Function Unit Test\"}", + "description": "Generate a unit test in JavaScript using Jest for a login function on a web platform." + }, + { + "inputJson": "{\"testType\":\"end-to-end\",\"targetPlatform\":\"web\",\"testSteps\":[{\"action\":\"navigate\",\"url\":\"https://example.com/login\"},{\"action\":\"input\",\"selector\":\"#username\",\"value\":\"user1\"},{\"action\":\"input\",\"selector\":\"#password\",\"value\":\"pass1\"},{\"action\":\"click\",\"selector\":\"#submit\"},{\"action\":\"expect\",\"selector\":\".welcome-message\",\"valueContains\":\"Welcome user1\"}],\"programmingLanguage\":\"JavaScript\",\"framework\":\"Cypress\",\"includeSetupTeardown\":true,\"testName\":\"User Login E2E Test\"}", + "description": "Create an end-to-end test scenario in Cypress for user login flow on a web platform." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Test", + "context": null + } + }, + { + "name": "devops.uploadReport", + "description": "Uploads a report file to a specified remote storage or reporting server. Accepts a report file path or raw content, validates file type (e.g., PDF, HTML), and uploads it to the target destination (S3 bucket, FTP server, or API endpoint). Returns upload status and file URL on success.", + "category": "devops", + "parameters": [ + { + "name": "reportPath", + "type": "string", + "description": "Local file system path to the report file to upload (e.g., /tmp/report.pdf). Either reportPath or reportContent is required.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportContent", + "type": "string", + "description": "Raw content of the report as a string (e.g., base64-encoded or plain text). Used if reportPath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileType", + "type": "string", + "description": "File type/extension of the report (e.g., pdf, html, txt). Used for validation and setting correct metadata.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "destinationType", + "type": "string", + "description": "The type of the upload destination: 's3', 'ftp', or 'api'.", + "required": true, + "defaultValue": "s3" + }, + { + "name": "destinationConfig", + "type": "object", + "description": "Configuration object with connection credentials and parameters depending on destinationType, e.g. bucket name for S3, URL and credentials for API or FTP.", + "required": true, + "defaultValue": "" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite an existing report with the same name at the destination.", + "required": false, + "defaultValue": "false" + }, + { + "name": "archiveOlder", + "type": "boolean", + "description": "If true, archives or moves older reports before uploading the new one (behavior depends on destination).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "UploadResult containing success status, uploaded file URL if successful, and error message if any error occurred." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically upload build or test reports, or any generated documents, to a remote storage location such as cloud storage, FTP servers, or REST API endpoints for centralized access or further processing.", + "limitations": "This tool does not generate reports or modify their content; it only uploads reports in supported file formats. It cannot validate report content semantic correctness or parse report data.", + "examples": [ + "Upload a test coverage PDF report to an AWS S3 bucket after CI build.", + "Upload HTML build report content directly via API endpoint without a local file.", + "Upload a log report to FTP server and archive previous reports before uploading." + ] + }, + "tags": [ + "upload", + "report", + "devops", + "deployment", + "ci", + "infrastructure", + "automation" + ], + "examples": [ + { + "inputJson": "{\"reportPath\":\"/tmp/coverage-report.pdf\",\"fileType\":\"pdf\",\"destinationType\":\"s3\",\"destinationConfig\":{\"bucketName\":\"ci-reports\",\"region\":\"us-east-1\",\"accessKeyId\":\"AKIA...\",\"secretAccessKey\":\"...\"},\"overwrite\":true}", + "description": "Upload a local PDF coverage report file to an AWS S3 bucket, allowing overwrite." + }, + { + "inputJson": "{\"reportContent\":\"Build Report\",\"fileType\":\"html\",\"destinationType\":\"api\",\"destinationConfig\":{\"endpointUrl\":\"https://reports.example.com/upload\",\"apiKey\":\"abcd1234\"},\"overwrite\":false}", + "description": "Upload build report HTML content directly to a reporting server via REST API." + }, + { + "inputJson": "{\"reportPath\":\"/var/logs/test-report.txt\",\"fileType\":\"txt\",\"destinationType\":\"ftp\",\"destinationConfig\":{\"host\":\"ftp.example.com\",\"username\":\"user\",\"password\":\"pass\",\"remotePath\":\"/reports/\"},\"archiveOlder\":true}", + "description": "Upload a text test report to FTP server, archiving older reports first." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Report", + "context": null + } + }, + { + "name": "devops.buildCommit", + "description": "Builds and creates a code commit in a specified Git repository by applying staged changes with a commit message, author details, and optional branch selection. Accepts repository path or URL, commit message, author info, and branch name to produce a commit hash confirming successful commit creation.", + "category": "devops", + "parameters": [ + { + "name": "repositoryPath", + "type": "string", + "description": "Local file path or clone URL of the Git repository where the commit will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "commitMessage", + "type": "string", + "description": "Message describing the commit content and purpose.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the commit author to record in the commit metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email address of the commit author for the commit metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "branchName", + "type": "string", + "description": "Target branch name where the commit should be applied. Defaults to current branch if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "signCommit", + "type": "boolean", + "description": "Flag indicating whether the commit should be GPG signed if signing is configured.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Object containing the commitHash string representing the unique SHA identifier of the created commit, and a success boolean indicating operation result." + }, + "aiAgent": { + "useCase": "Use this tool when automating code deployment pipelines, continuous integration workflows, or scripts that require programmatic creation of commits with controlled metadata and branch targeting. Ideal for bots or agents orchestrating code updates to repositories.", + "limitations": "Does not stage new changes; expects that the repository has staged changes ready to commit. Cannot handle merge conflicts or perform pushes to remote repositories. Requires access to the local repository or a cloned repository workspace.", + "examples": [ + "Create a commit in a local repository with author info and message on the develop branch.", + "Commit staged changes in a CI pipeline and retrieve the new commit hash without branch specification.", + "Create a signed commit for verification using provided author details and commit message." + ] + }, + "tags": [ + "devops", + "build", + "commit", + "git", + "automation", + "ci", + "continuous integration" + ], + "examples": [ + { + "inputJson": "{\"repositoryPath\":\"/home/user/projects/myrepo\",\"commitMessage\":\"Fix bug in authentication flow\",\"authorName\":\"Jane Doe\",\"authorEmail\":\"jane.doe@example.com\",\"branchName\":\"feature/auth-fix\",\"signCommit\":false}", + "description": "Create a commit with a specific message and author on the 'feature/auth-fix' branch in a local repository." + }, + { + "inputJson": "{\"repositoryPath\":\"/repo\",\"commitMessage\":\"Update README with contribution guidelines\",\"authorName\":\"CI Bot\",\"authorEmail\":\"ci-bot@example.com\",\"branchName\":\"\",\"signCommit\":false}", + "description": "Create a commit on the current branch in a local repository without signing." + }, + { + "inputJson": "{\"repositoryPath\":\"/repo\",\"commitMessage\":\"Secure API keys storage\",\"authorName\":\"DevOps Engineer\",\"authorEmail\":\"devops@example.com\",\"branchName\":\"security-updates\",\"signCommit\":true}", + "description": "Create a signed commit on the 'security-updates' branch with author details." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Commit", + "context": null + } + }, + { + "name": "devops.createContainer", + "description": "Creates and deploys a new container instance based on provided configuration parameters such as image name, resource limits, environment variables, and network settings. Accepts container specification inputs, provisions the container on the target infrastructure, and returns deployment details including container ID, status, and access endpoints.", + "category": "devops", + "parameters": [ + { + "name": "imageName", + "type": "string", + "description": "The name of the container image to deploy, including tag if applicable (e.g., 'nginx:latest').", + "required": true, + "defaultValue": "" + }, + { + "name": "containerName", + "type": "string", + "description": "An optional unique name to assign to the container instance.", + "required": false, + "defaultValue": "" + }, + { + "name": "cpuLimit", + "type": "number", + "description": "The maximum number of CPU units allocated to the container (e.g., 2 for 2 cores).", + "required": false, + "defaultValue": "1" + }, + { + "name": "memoryLimitMB", + "type": "number", + "description": "The maximum amount of memory in megabytes allocated to the container.", + "required": false, + "defaultValue": "512" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set inside the container.", + "required": false, + "defaultValue": "" + }, + { + "name": "portMappings", + "type": "array", + "description": "List of port mappings, each mapping host port to container port (e.g., [{\"hostPort\":80,\"containerPort\":8080}]).", + "required": false, + "defaultValue": "" + }, + { + "name": "networkMode", + "type": "string", + "description": "Network mode for the container such as 'bridge', 'host', or a user-defined network.", + "required": false, + "defaultValue": "bridge" + }, + { + "name": "restartPolicy", + "type": "string", + "description": "Container restart policy (e.g., 'no', 'on-failure', 'always').", + "required": false, + "defaultValue": "no" + }, + { + "name": "command", + "type": "array", + "description": "Override the default command to run in the container as a list of strings.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing containerId, status ('created', 'running', or 'failed'), start time, and network access info (e.g., IP address and mapped ports)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the deployment of containerized applications by specifying custom runtime configurations. Suitable for continuous integration pipelines, dynamic infrastructure scaling, or on-demand container provisioning.", + "limitations": "This tool cannot manage clusters, orchestrate multiple containers, or configure complex multi-service networks; it focuses exclusively on creating single container instances per invocation.", + "examples": [ + "Deploy a web server container with custom environment variables and port mapping.", + "Create a resource-limited container from a specific image with a restart policy.", + "Launch a container overriding the default command with specified network settings." + ] + }, + "tags": [ + "devops", + "container", + "deployment", + "automation", + "infrastructure", + "runtime-management" + ], + "examples": [ + { + "inputJson": "{\"imageName\":\"nginx:latest\",\"containerName\":\"webserver01\",\"cpuLimit\":2,\"memoryLimitMB\":1024,\"environmentVariables\":{\"ENV\":\"production\"},\"portMappings\":[{\"hostPort\":8080,\"containerPort\":80}],\"networkMode\":\"bridge\",\"restartPolicy\":\"always\"}", + "description": "Deploy an nginx web server container named 'webserver01' with 2 CPUs, 1GB RAM, exposing container port 80 on host port 8080 and automatic restart." + }, + { + "inputJson": "{\"imageName\":\"python:3.9-slim\",\"command\":[\"python\",\"app.py\"],\"memoryLimitMB\":256}", + "description": "Create a lightweight Python container running 'app.py' with 256MB memory limit and default network settings." + }, + { + "inputJson": "{\"imageName\":\"redis:6-alpine\",\"restartPolicy\":\"on-failure\"}", + "description": "Deploy a Redis container from the alpine image which restarts only on failure using default resources and network." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "devops.createKey", + "description": "Generates a cryptographic key pair for deployment or infrastructure automation purposes. Accepts key type and size preferences, optional passphrase, and returns the public and private keys in PEM format suitable for secure authentication or encryption tasks.", + "category": "devops", + "parameters": [ + { + "name": "keyType", + "type": "string", + "description": "Type of key to generate (e.g., RSA, ECDSA, Ed25519).", + "required": true, + "defaultValue": "" + }, + { + "name": "keySize", + "type": "number", + "description": "Key size in bits for applicable key types (e.g., 2048 for RSA). Ignored for types with fixed size like Ed25519.", + "required": false, + "defaultValue": "2048" + }, + { + "name": "passphrase", + "type": "string", + "description": "Optional passphrase to encrypt the private key for additional security.", + "required": false, + "defaultValue": "" + }, + { + "name": "comment", + "type": "string", + "description": "Optional comment or label to associate with the key pair.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the generated public and private keys in PEM format, with indication if the private key is encrypted." + }, + "aiAgent": { + "useCase": "Use when you need to programmatically generate secure cryptographic keys for infrastructure automation, continuous deployment, or authentication, allowing agents to provision keys without manual intervention.", + "limitations": "Does not handle key storage or deployment; keys are returned as strings and must be securely stored by the user or subsequent tools. Does not generate keys for deprecated or unsupported algorithms.", + "examples": [ + "Create an RSA 4096-bit key pair without passphrase.", + "Generate an Ed25519 key pair for SSH authentication with a passphrase.", + "Produce an ECDSA key pair with a custom comment label." + ] + }, + "tags": [ + "key generation", + "cryptography", + "deployment", + "security", + "infrastructure", + "automation", + "devops" + ], + "examples": [ + { + "inputJson": "{\"keyType\":\"RSA\",\"keySize\":4096,\"passphrase\":\"\",\"comment\":\"Deployment key for app server\"}", + "description": "Generate a strong RSA 4096-bit key pair without passphrase for deployment use." + }, + { + "inputJson": "{\"keyType\":\"Ed25519\",\"passphrase\":\"s3cretPass\",\"comment\":\"SSH key for CI/CD pipeline\"}", + "description": "Generate Ed25519 key pair with passphrase for secure SSH authentication in CI/CD." + }, + { + "inputJson": "{\"keyType\":\"ECDSA\",\"keySize\":256,\"comment\":\"Monitor key\"}", + "description": "Produce an ECDSA 256-bit key pair with a descriptive comment, no passphrase." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Key", + "context": null + } + }, + { + "name": "devops.createPullRequest", + "description": "Creates a pull request on a specified repository platform (e.g., GitHub, GitLab) from a source branch to a target branch. Accepts repository details, branches, title, body, and optional reviewers or assignees. Returns details of the created pull request including URL and ID.", + "category": "devops", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "URL of the repository where the pull request will be created, including protocol (e.g., https://github.com/user/repo)", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceBranch", + "type": "string", + "description": "Name of the branch containing the changes to be merged", + "required": true, + "defaultValue": "" + }, + { + "name": "targetBranch", + "type": "string", + "description": "Name of the branch into which the changes will be merged", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Title of the pull request", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Detailed description of the pull request, explaining the changes and purpose", + "required": false, + "defaultValue": "" + }, + { + "name": "reviewers", + "type": "array", + "description": "List of usernames or IDs of users requested to review the pull request", + "required": false, + "defaultValue": "[]" + }, + { + "name": "assignees", + "type": "array", + "description": "List of usernames or IDs of users assigned to the pull request", + "required": false, + "defaultValue": "[]" + }, + { + "name": "accessToken", + "type": "string", + "description": "Authentication token with permissions to create pull requests on the target repository", + "required": true, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "Repository hosting platform identifier (e.g., 'github', 'gitlab') to select appropriate API", + "required": false, + "defaultValue": "github" + } + ], + "returns": { + "type": "object", + "description": "An object containing the pull request's unique ID, title, URL link, current status (e.g., open, merged), and creation timestamp." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to automate or assist in software development workflows involving code review and merging. For example, after generating or modifying code, the agent can create a pull request programmatically to initiate review and integration processes, streamlining continuous integration and delivery pipelines.", + "limitations": "This tool does not handle merge conflicts or branch creation; it requires that the source branch exists and is pushed to the remote repository. It also depends on valid access tokens and platform API availability. The tool does not perform code analysis or verify branch status prior to PR creation.", + "examples": [ + "Create a pull request from 'feature/login' to 'develop' on GitHub with title 'Add login feature' and assign reviewers.", + "Open a merge request from branch 'bugfix/ui-fix' to 'master' on GitLab with detailed description and request specific assignees.", + "Generate a pull request without specifying reviewers on a private repo with authentication token." + ] + }, + "tags": [ + "devops", + "pull-request", + "code-review", + "automation", + "continuous-integration", + "repository" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/repo\",\"sourceBranch\":\"feature/api-endpoint\",\"targetBranch\":\"main\",\"title\":\"Add new API endpoint\",\"body\":\"Implements the new data retrieval API endpoint for the reports module.\",\"reviewers\":[\"alice\",\"bob\"],\"assignees\":[\"carol\"],\"accessToken\":\"ghp_exampletoken123\",\"platform\":\"github\"}", + "description": "Create a GitHub pull request from 'feature/api-endpoint' to 'main' with reviewers and assignees specified." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://gitlab.com/company/project\",\"sourceBranch\":\"fix/login-error\",\"targetBranch\":\"master\",\"title\":\"Fix login error handling\",\"body\":\"Fixes the null pointer exception in login logic and improves error responses.\",\"reviewers\":[],\"assignees\":[],\"accessToken\":\"glpat_exampletoken456\",\"platform\":\"gitlab\"}", + "description": "Create a GitLab merge request from 'fix/login-error' to 'master' without requesting reviewers or assignees." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "PullRequest", + "context": null + } + }, + { + "name": "devops.createModule", + "description": "Creates a deployable infrastructure automation module by generating code templates and configuration files for specified environments. Accepts parameters defining the module name, target cloud provider, infrastructure components, and optional CI/CD integration settings. Outputs structured module directory content ready for versioning and deployment pipelines.", + "category": "devops", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "Name of the infrastructure automation module to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "cloudProvider", + "type": "string", + "description": "Target cloud provider for which the module is intended (e.g., AWS, Azure, GCP).", + "required": true, + "defaultValue": "" + }, + { + "name": "infrastructureComponents", + "type": "array", + "description": "List of infrastructure components to include in the module (e.g., ['VPC','EC2','RDS']).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "ciCdIntegration", + "type": "boolean", + "description": "Whether to include continuous integration/continuous deployment pipeline configurations.", + "required": false, + "defaultValue": "false" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "Preferred programming or configuration language for the module code (e.g., Terraform, CloudFormation, Pulumi).", + "required": false, + "defaultValue": "Terraform" + } + ], + "returns": { + "type": "object", + "description": "An object containing the directory structure and file contents of the generated infrastructure module, including code templates and configuration files." + }, + "aiAgent": { + "useCase": "Use this tool when needing to bootstrap a new infrastructure automation module targeting specific cloud providers with predefined components and optional CI/CD pipelines, enabling accelerated and consistent DevOps deployments.", + "limitations": "This tool does not deploy the module or validate cloud-specific syntax beyond template generation. It requires user review and integration into existing pipelines.", + "examples": [ + "Create a Terraform module named 'webAppModule' for AWS with networking and compute components.", + "Generate a CloudFormation module for Azure including database and storage services with CI/CD integration enabled." + ] + }, + "tags": [ + "devops", + "infrastructure", + "automation", + "cloud", + "module", + "ci/cd", + "terraform", + "cloudformation" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"coreInfraModule\",\"cloudProvider\":\"AWS\",\"infrastructureComponents\":[\"VPC\",\"EC2\",\"RDS\"],\"ciCdIntegration\":true,\"programmingLanguage\":\"Terraform\"}", + "description": "Create a Terraform AWS module including VPC, EC2, and RDS with CI/CD integration." + }, + { + "inputJson": "{\"moduleName\":\"dataPipeline\",\"cloudProvider\":\"GCP\",\"infrastructureComponents\":[\"ComputeEngine\",\"CloudSQL\"],\"ciCdIntegration\":false,\"programmingLanguage\":\"Pulumi\"}", + "description": "Generate a Pulumi GCP module for Compute Engine and Cloud SQL without CI/CD." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "frontend-development.uploadImage", + "description": "Uploads an image file from the client side to a specified server endpoint, optionally resizing or compressing the image before sending. Accepts image files in common formats, processes transformations if requested, and returns upload status along with URL of the stored image if successful.", + "category": "frontend-development", + "parameters": [ + { + "name": "file", + "type": "object", + "description": "The image file object to upload, typically obtained from a file input or drag-and-drop event.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpointUrl", + "type": "string", + "description": "The server URL where the image should be uploaded via POST request.", + "required": true, + "defaultValue": "" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Optional width to resize the image to before upload; maintains aspect ratio if set.", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Optional height to resize the image to before upload; maintains aspect ratio if set.", + "required": false, + "defaultValue": "" + }, + { + "name": "compressQuality", + "type": "number", + "description": "Compression quality factor between 0 and 1 to reduce image file size before upload (only for JPEG/WEBP).", + "required": false, + "defaultValue": "0.8" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include original image metadata (EXIF) in the uploaded file.", + "required": false, + "defaultValue": "false" + }, + { + "name": "headers", + "type": "object", + "description": "Additional HTTP headers as key-value pairs to include in the upload request (e.g., authorization tokens).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the upload status (success or failure), a message, and on success the URL location of the uploaded image." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to upload user-selected or generated image files from a web client to a backend service, optionally performing client-side image processing such as resizing and compression to optimize upload speed and resource usage. Typical scenarios include profile picture uploads, gallery additions, or image-based form submissions.", + "limitations": "This tool cannot securely authenticate the user by itself; authentication must be handled and tokens provided via headers. It does not support multipart uploads for very large files or resume failed uploads automatically.", + "examples": [ + "Upload a user-selected profile photo to the server with a maximum width of 800px, compressing it moderately to reduce data usage.", + "Send a full quality image with metadata preserved to a cloud image hosting endpoint, including an authorization header.", + "Quickly upload a small image without resizing or compression to a test HTTP endpoint for validation." + ] + }, + "tags": [ + "image", + "upload", + "frontend", + "client-side", + "resize", + "compression" + ], + "examples": [ + { + "inputJson": "{\"file\": {\"name\": \"avatar.png\", \"type\": \"image/png\", \"size\": 204800}, \"endpointUrl\": \"https://api.example.com/upload\", \"resizeWidth\": 800, \"compressQuality\": 0.7}", + "description": "Upload a PNG avatar image resized to 800px width and compressed to 70% quality." + }, + { + "inputJson": "{\"file\": {\"name\": \"photo.jpg\", \"type\": \"image/jpeg\", \"size\": 1024000}, \"endpointUrl\": \"https://images.example.com/upload\", \"includeMetadata\": true, \"headers\": {\"Authorization\": \"Bearer abc123\"}}", + "description": "Upload a JPEG photo including metadata with authentication header for authorization." + }, + { + "inputJson": "{\"file\": {\"name\": \"icon.svg\", \"type\": \"image/svg+xml\", \"size\": 10240}, \"endpointUrl\": \"https://upload.example.net/images\"}", + "description": "Upload an SVG file without resizing or compression to a test endpoint." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Image", + "context": null + } + }, + { + "name": "frontend-development.generateLink", + "description": "Generates an HTML anchor (<a>) tag string based on specified input parameters including URL, link text, target behavior, CSS classes, and additional attributes. It processes inputs to produce a fully-formed link element string ready for integration into frontend code.", + "category": "frontend-development", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The destination URL for the hyperlink.", + "required": true, + "defaultValue": "" + }, + { + "name": "linkText", + "type": "string", + "description": "The display text or inner HTML content of the link.", + "required": true, + "defaultValue": "" + }, + { + "name": "openInNewTab", + "type": "boolean", + "description": "Determines whether the link opens in a new browser tab (true adds target=\"_blank\" and rel=\"noopener noreferrer\").", + "required": false, + "defaultValue": "false" + }, + { + "name": "cssClasses", + "type": "string", + "description": "A space-separated list of CSS class names to apply to the anchor tag.", + "required": false, + "defaultValue": "" + }, + { + "name": "attributes", + "type": "object", + "description": "Additional arbitrary HTML attributes to add to the anchor tag as key-value pairs.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "string", + "description": "A string of the fully constructed HTML anchor (<a>) tag with all provided options applied." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate or sanitize hyperlink HTML elements in frontend development scenarios, ensuring proper attribute handling like opening links in new tabs or adding custom CSS classes and attributes programmatically.", + "limitations": "This tool generates simple anchor tags and does not perform URL validation or advanced security checks beyond adding standard 'rel' attributes for new tab links. It does not create complex nested HTML or handle event listeners.", + "examples": [ + "Generate a link to https://example.com with text 'Visit Example' that opens in a new tab with a specific CSS class.", + "Produce a simple link with no extra attributes to 'https://openai.com' with text 'OpenAI Homepage'.", + "Create a link with custom data attributes and aria-labels for accessibility." + ] + }, + "tags": [ + "frontend", + "html", + "link", + "ui", + "component", + "generate" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com\",\"linkText\":\"Visit Example\",\"openInNewTab\":true,\"cssClasses\":\"btn btn-primary\",\"attributes\":{\"aria-label\":\"Example Link\"}}", + "description": "Generate a link that opens in a new tab with button styling and an aria-label attribute." + }, + { + "inputJson": "{\"url\":\"/home\",\"linkText\":\"Home\",\"openInNewTab\":false,\"cssClasses\":\"nav-link\",\"attributes\":{}}", + "description": "Generate a simple internal navigation link with a CSS class." + }, + { + "inputJson": "{\"url\":\"mailto:support@example.com\",\"linkText\":\"Contact Support\",\"openInNewTab\":false,\"cssClasses\":\"\",\"attributes\":{\"target\":\"_self\"}}", + "description": "Generate a mailto link with explicit target attribute." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Link", + "context": null + } + }, + { + "name": "backend-development.analyzeHeading", + "description": "Analyzes heading elements from provided HTML or markdown content to extract semantic information, heading hierarchy, and potential accessibility issues. Accepts raw content string and heading level filters, outputs structured data about headings including their text, level, position, and recommendations.", + "category": "backend-development", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "HTML or markdown content string containing heading elements to analyze", + "required": true, + "defaultValue": "" + }, + { + "name": "contentType", + "type": "string", + "description": "Type of the input content: 'html' or 'markdown'", + "required": true, + "defaultValue": "html" + }, + { + "name": "minHeadingLevel", + "type": "number", + "description": "Minimum heading level (1-6) to include in analysis", + "required": false, + "defaultValue": "1" + }, + { + "name": "maxHeadingLevel", + "type": "number", + "description": "Maximum heading level (1-6) to include in analysis", + "required": false, + "defaultValue": "6" + }, + { + "name": "checkAccessibility", + "type": "boolean", + "description": "Whether to perform accessibility-related checks such as skipped heading levels or missing top-level heading", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing an array of headings with their text, level, and position, plus an accessibility report with warnings if any." + }, + "aiAgent": { + "useCase": "Use this tool when you need to extract and analyze heading structure from server-side HTML or markdown content for SEO, accessibility validation, or content structuring purposes. Useful for generating reports on document semantic structure or detecting heading hierarchy issues programmatically.", + "limitations": "Does not modify content or fix issues automatically. Only analyzes headings present in the input content string; dynamic content or scripts-generated headings are not considered.", + "examples": [ + "Analyze all headings in an HTML page to get their levels and text for building a table of contents.", + "Check a markdown document for any skipped heading levels or missing top-level headings for accessibility reviews.", + "Extract only h2 to h4 headings from HTML content to summarize sections." + ] + }, + "tags": [ + "analysis", + "backend", + "seo", + "accessibility", + "content-structure", + "html", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"content\":\"Main Title
Intro paragraph.
Subsection
Sub-subsection
\",\"contentType\":\"html\",\"minHeadingLevel\":1,\"maxHeadingLevel\":3,\"checkAccessibility\":true}", + "description": "Analyzing HTML with h1, h2, h3 headings to extract their structure and check accessibility." + }, + { + "inputJson": "{\"content\":\"# Title\\nSome text\\n### Skipped heading\\n## Back up heading\",\"contentType\":\"markdown\",\"minHeadingLevel\":1,\"maxHeadingLevel\":3,\"checkAccessibility\":true}", + "description": "Analyze markdown content with out-of-order headings to detect skipped levels." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Heading", + "context": null + } + }, + { + "name": "backend-development.analyzeThreat", + "description": "Analyzes potential security threats based on server logs, threat intelligence data, and system configurations. Accepts log files or structured event data, evaluates patterns against known threat signatures and heuristics, and produces a detailed report categorizing the threat level, possible attacker methods, and recommendations for mitigation.", + "category": "backend-development", + "parameters": [ + { + "name": "logData", + "type": "string", + "description": "Raw server log data or JSON-formatted event logs to be analyzed for threats.", + "required": true, + "defaultValue": "" + }, + { + "name": "threatIntelligenceFeeds", + "type": "array", + "description": "Array of URLs or identifiers for threat intelligence feeds used to cross-reference indicators of compromise.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "systemConfig", + "type": "object", + "description": "Current system and network configuration details that help contextualize the analysis, such as firewall rules and open ports.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "analysisDepth", + "type": "string", + "description": "Level of analysis detail: 'basic', 'intermediate', or 'advanced' determining thoroughness and runtime.", + "required": false, + "defaultValue": "basic" + }, + { + "name": "timeRange", + "type": "object", + "description": "Object with start and end ISO 8601 timestamps to limit which log entries are analyzed.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "includeMitigationRecommendations", + "type": "boolean", + "description": "Whether to include actionable recommendations for threat mitigation in the output report.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Structured threat analysis report including threat level classification, identified threat types, matched indicators, timestamps, and mitigation recommendations if requested." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to assess the security posture of a backend system by analyzing available logs and configurations for signs of compromise or ongoing attacks. Particularly useful for incident response, continuous security monitoring, and evaluating suspicious activities against known threats.", + "limitations": "Cannot guarantee detection of zero-day or highly obfuscated attacks. Accuracy depends on quality and completeness of input data and threat intelligence feeds. Not a replacement for manual security audits or penetration testing.", + "examples": [ + "Analyze server logs from the past 24 hours to identify any suspicious SSH login attempts.", + "Evaluate the web application firewall logs and system config to detect web-based threat patterns.", + "Generate a threat analysis report including recommendations based on recent access logs and multiple threat intelligence sources." + ] + }, + "tags": [ + "security", + "threat-analysis", + "backend", + "log-analysis", + "incident-response", + "cybersecurity" + ], + "examples": [ + { + "inputJson": "{\"logData\":\"\",\"timeRange\":{\"start\":\"2024-06-01T00:00:00Z\",\"end\":\"2024-06-01T23:59:59Z\"},\"includeMitigationRecommendations\":true}", + "description": "Analyze all server logs from June 1, 2024, producing a report with mitigation advice." + }, + { + "inputJson": "{\"logData\":\" \",\"threatIntelligenceFeeds\":[\"https://example.com/cti-feed.json\"],\"analysisDepth\":\"advanced\"}", + "description": "Perform a deep analysis on application logs using a threat intelligence feed to identify advanced threats." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Threat", + "context": null + } + }, + { + "name": "backend-development.analyzeIncident", + "description": "Analyzes a security or operational incident by processing provided incident details, logs, and metadata to identify root causes, impacted systems, and recommend remediation steps. Outputs a structured incident analysis report summarizing findings and suggested actions.", + "category": "backend-development", + "parameters": [ + { + "name": "incidentId", + "type": "string", + "description": "Unique identifier of the incident to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "incidentDetails", + "type": "object", + "description": "Detailed description and context of the incident, including timestamps, involved entities, and reported symptoms.", + "required": true, + "defaultValue": "" + }, + { + "name": "logFiles", + "type": "array", + "description": "Array of log file contents or paths related to the incident for deeper analysis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeRemediation", + "type": "boolean", + "description": "Flag indicating whether to include recommended remediation steps in the analysis output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "sensitivityLevel", + "type": "string", + "description": "Sensitivity level of the incident data (e.g., low, medium, high) to tailor analysis depth and confidentiality.", + "required": false, + "defaultValue": "medium" + } + ], + "returns": { + "type": "object", + "description": "Structured report including root cause summary, impacted components, timeline of events, severity assessment, and recommended remediation actions if enabled." + }, + "aiAgent": { + "useCase": "Use this tool when detailed analysis of a backend or security incident is required to quickly understand root causes, affected systems, and remediation guidance based on logs and incident data. Helps automate incident response by formalizing analysis.", + "limitations": "The tool relies on provided incident data quality and may not identify unknown attack vectors or zero-day exploits without sufficient input logs or context. It does not replace expert human analysis for complex incidents.", + "examples": [ + "Analyze an incident with ID 'INC12345', including logs and request remediation steps.", + "Analyze incident details for system outage to determine root cause and summarize timeline.", + "Review security breach incident details and logs to generate actionable remediation recommendations." + ] + }, + "tags": [ + "backend", + "security", + "incident-analysis", + "root-cause", + "remediation", + "logs", + "automation" + ], + "examples": [ + { + "inputJson": "{\"incidentId\":\"INC001\",\"incidentDetails\":{\"description\":\"Unauthorized data access detected\",\"timestamp\":\"2024-05-01T14:22:00Z\",\"reportedBy\":\"monitoring-system\",\"affectedSystems\":[\"db-server-1\",\"auth-service\"]},\"logFiles\":[\"...logs snippet...\",\"...another logs snippet...\"],\"includeRemediation\":true,\"sensitivityLevel\":\"high\"}", + "description": "Analyzing a high-sensitivity security incident of unauthorized data access with supporting logs, requesting remediation guidance." + }, + { + "inputJson": "{\"incidentId\":\"INC002\",\"incidentDetails\":{\"description\":\"API timeout errors impacting users\",\"timestamp\":\"2024-04-28T11:10:00Z\",\"reportedBy\":\"user-reports\",\"affectedSystems\":[\"api-gateway\"]},\"includeRemediation\":false}", + "description": "Analyzing an incident of API timeout errors without remediation steps requested." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Incident", + "context": null + } + }, + { + "name": "backend-development.formatParagraph", + "description": "Formats a given text paragraph according to specified style options such as line width, indentation, and text alignment. Accepts a raw text string and formatting parameters, then outputs the formatted paragraph as a string suitable for server-side text processing and display.", + "category": "backend-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw paragraph text input that needs formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLineWidth", + "type": "number", + "description": "Maximum number of characters per line after formatting; lines will wrap accordingly.", + "required": false, + "defaultValue": "80" + }, + { + "name": "indentation", + "type": "number", + "description": "Number of spaces to indent each line of the paragraph.", + "required": false, + "defaultValue": "0" + }, + { + "name": "alignment", + "type": "string", + "description": "Text alignment style: 'left', 'right', 'center', or 'justify'.", + "required": false, + "defaultValue": "left" + }, + { + "name": "preserveLineBreaks", + "type": "boolean", + "description": "Whether to preserve existing line breaks within the paragraph.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "string", + "description": "The formatted paragraph as a single string respecting the given style parameters." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically format paragraph text for server-side content processing, such as generating consistent readable text output for APIs, logs, or documentation with controlled line widths and alignment.", + "limitations": "Does not perform natural language processing or grammar correction; only formats text layout. Cannot handle markup or HTML formatting.", + "examples": [ + "Format a paragraph with max line width of 60 characters and center alignment.", + "Indent a paragraph by 4 spaces and justify the text.", + "Preserve existing line breaks while formatting with a max width of 50 characters." + ] + }, + "tags": [ + "backend", + "text-formatting", + "paragraph", + "string-processing", + "API", + "server-side" + ], + "examples": [ + { + "inputJson": "{\"text\":\"This is a sample paragraph that needs to be formatted neatly by wrapping lines and aligning text appropriately according to the specified options.\",\"maxLineWidth\":60,\"indentation\":2,\"alignment\":\"justify\",\"preserveLineBreaks\":false}", + "description": "Format text with 60 char max width, 2-space indent, and justify alignment." + }, + { + "inputJson": "{\"text\":\"Another example paragraph to demonstrate left alignment with no indentation and default line width.\",\"alignment\":\"left\"}", + "description": "Format paragraph with default 80 char width, left aligned, no indentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Paragraph", + "context": null + } + }, + { + "name": "backend-development.draftText", + "description": "Generates draft text content based on provided topic, key points, and desired tone. Accepts inputs such as main subject, bullet points to include, tone style, and target audience, then produces coherent, contextually relevant draft text suitable for backend service documentation, API descriptions, or user notifications.", + "category": "backend-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Main subject or title to generate the draft text about.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of important points or subtopics to include in the draft text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the draft text, e.g., formal, casual, technical.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Intended readers of the draft text such as developers, end users, or stakeholders.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated draft text in words.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "Result object containing the generated draft text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically create initial textual content for backend system components such as API documentation, user messages, or notification templates from a given topic and essential points. It helps speed up content creation and ensures consistency in tone and style.", + "limitations": "The tool generates draft text but does not guarantee technical accuracy or complete correctness. It may not replace expert-written detailed documents and can lack specific domain knowledge.", + "examples": [ + "Draft a notification message to alert users about scheduled maintenance.", + "Generate API endpoint documentation text for a new feature including given parameters.", + "Create an introduction paragraph for backend service overview aimed at technical stakeholders." + ] + }, + "tags": [ + "text generation", + "content drafting", + "backend documentation", + "API description", + "notification templates" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Scheduled Maintenance Notification\",\"keyPoints\":[\"Date and time of maintenance\",\"Expected downtime duration\",\"Services affected\",\"User actions required\"],\"tone\":\"formal\",\"targetAudience\":\"end users\",\"maxLength\":200}", + "description": "Draft a formal notification for end users about scheduled backend maintenance including key details." + }, + { + "inputJson": "{\"topic\":\"User Authentication API\",\"keyPoints\":[\"Endpoint URL\",\"HTTP methods\",\"Required headers\",\"Response formats\"],\"tone\":\"technical\",\"targetAudience\":\"developers\",\"maxLength\":300}", + "description": "Generate technical API documentation draft describing user authentication endpoints for backend developers." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Text", + "context": null + } + }, + { + "name": "backend-development.generateReference", + "description": "Generates a structured reference documentation snippet for backend API endpoints or server-side modules. Accepts input describing the endpoint or module details including parameters, request and response formats, and authentication. Produces a formatted, human-readable reference section that can be integrated into developer docs.", + "category": "backend-development", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "Name of the backend module or API endpoint to document.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Brief description of the module or endpoint functionality.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method if the reference is for an API endpoint (GET, POST, etc.).", + "required": false, + "defaultValue": "GET" + }, + { + "name": "path", + "type": "string", + "description": "The URL path for the API endpoint (e.g., /users/{id}). Required if httpMethod is provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "parameters", + "type": "array", + "description": "List of input parameters with name, type, and description for the endpoint or module inputs.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "requestBody", + "type": "object", + "description": "Schema defining the shape of the request body if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "responseBody", + "type": "object", + "description": "Schema describing the structure of the expected response body.", + "required": true, + "defaultValue": "" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Indicates whether the endpoint requires authentication.", + "required": false, + "defaultValue": "false" + }, + { + "name": "examples", + "type": "array", + "description": "An array of example usages with request and response samples.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted reference documentation as a string, including all relevant details in a standardized structure." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automatically generate clear, consistent reference documentation snippets for backend API endpoints or server-side modules based on structured input definitions. Ideal for automating developer documentation and ensuring standardized references.", + "limitations": "Does not validate endpoint logic or correctness, only formats documentation based on input data. Not intended to generate full API specifications or replace dedicated API documentation tools.", + "examples": [ + "Generate reference doc for GET /users/{id} endpoint with parameters and response schema.", + "Create module reference for authenticationManager module describing its methods and usage.", + "Produce example-rich reference documentation snippet including request and response samples." + ] + }, + "tags": [ + "documentation", + "backend", + "API", + "reference", + "developer-docs", + "server", + "automation" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"UserController\",\"description\":\"Handles user retrieval and updates.\",\"httpMethod\":\"GET\",\"path\":\"/users/{id}\",\"parameters\":[{\"name\":\"id\",\"type\":\"string\",\"description\":\"Unique identifier of the user.\"}],\"responseBody\":{\"id\":\"string\",\"name\":\"string\",\"email\":\"string\"},\"authenticationRequired\":true,\"examples\":[{\"request\":{\"pathParam\":\"123\"},\"response\":{\"id\":\"123\",\"name\":\"Jane Doe\",\"email\":\"jane@example.com\"}}]}", + "description": "Generate a reference doc snippet for a GET endpoint to fetch user details by ID, including input path parameter and JSON response." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Reference", + "context": null + } + }, + { + "name": "backend-development.composeSummary", + "description": "Takes a detailed technical document or API specification as input, analyzes its key points and structures, and produces a concise, clear summary highlighting important features, endpoints, or components. Useful for generating readable overviews of backend systems or APIs.", + "category": "backend-development", + "parameters": [ + { + "name": "inputText", + "type": "string", + "description": "The full technical document or API specification text to summarize.", + "required": true, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Desired length of the summary in number of sentences or paragraphs.", + "required": false, + "defaultValue": "5" + }, + { + "name": "focusAreas", + "type": "array", + "description": "Specific topics or sections to prioritize in the summary, e.g., 'authentication', 'endpoints', 'data models'.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeExamples", + "type": "boolean", + "description": "Whether to include example usages or code snippets in the summary if available.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary string and optionally included example snippets." + }, + "aiAgent": { + "useCase": "Use this tool when you need to quickly generate an understandable summary from complex backend documentation or API specs. It helps provide concise insights into the backend structure, important components, or endpoints, aiding developers, managers, or API users who require a brief yet informative overview.", + "limitations": "This tool cannot replace detailed technical reading and may omit nuanced implementation details. It does not verify accuracy or provide deep technical analysis beyond summarization.", + "examples": [ + "Summarize a lengthy API specification document to extract key endpoints and authentication methods.", + "Generate a summary highlighting the data models and validation rules of a backend service.", + "Create a brief overview of a complex backend module focusing on error handling and logging mechanisms." + ] + }, + "tags": [ + "backend", + "summary", + "documentation", + "API", + "technical writing", + "developer-tools" + ], + "examples": [ + { + "inputJson": "{\"inputText\":\"The backend system exposes RESTful endpoints for user management including registration, login, and profile updates. Authentication is handled via JWT tokens with refresh capabilities. Data models include User, Role, and Permission with enforced validation rules. Error handling uses consistent HTTP codes with detailed messages.\",\"summaryLength\":3,\"focusAreas\":[\"authentication\",\"endpoints\"],\"includeExamples\":false}", + "description": "Summarize a backend API doc focusing on authentication and endpoint overview, returning a concise summary." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Summary", + "context": null + } + }, + { + "name": "backend-development.generateHTML", + "description": "Generates an HTML document string based on provided structure and content parameters. Accepts inputs defining the page title, metadata, stylesheet URLs, scripts, and body content in HTML or text form. Outputs a complete, well-formed HTML5 string suitable for serving in web responses or saving as a file.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the HTML document used in the tag.", + "required": true, + "defaultValue": "\"Untitled Page\"" + }, + { + "name": "metaTags", + "type": "array", + "description": "Array of meta tag objects to include in the section, each with 'name' and 'content' fields.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "stylesheetUrls", + "type": "array", + "description": "List of URLs to CSS stylesheets to link in the section.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "scriptUrls", + "type": "array", + "description": "List of URLs to JavaScript files to include before the closing tag.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bodyContent", + "type": "string", + "description": "The raw HTML or text content to insert inside the tag.", + "required": true, + "defaultValue": "\"\"" + }, + { + "name": "language", + "type": "string", + "description": "Language attribute for the tag (e.g., 'en').", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "includeDoctype", + "type": "boolean", + "description": "Whether to include the HTML5 doctype declaration at the top.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the complete HTML document string under the 'html' property." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically assemble a complete HTML document combining configurable titles, metadata, stylesheets, scripts, and raw body content, such as when generating dynamic webpages or templates.", + "limitations": "This tool generates basic HTML structure but does not validate complex scripts or CSS content. It does not perform JavaScript or CSS generation or advanced templating logic beyond string composition.", + "examples": [ + "Generate a basic webpage with a title, a stylesheet link, and simple body content.", + "Create a multi-language page with specific meta tags and external scripts included.", + "Produce a minimal HTML snippet with no doctype for embedding in other documents." + ] + }, + "tags": [ + "backend", + "html", + "webpage", + "template", + "generate", + "server-side" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Welcome Page\",\"metaTags\":[{\"name\":\"description\",\"content\":\"Welcome to our site\"}],\"stylesheetUrls\":[\"https://cdn.example.com/styles.css\"],\"scriptUrls\":[\"https://cdn.example.com/app.js\"],\"bodyContent\":\"Hello, World!
This is a sample page.
\",\"language\":\"en\",\"includeDoctype\":true}", + "description": "Generate a full HTML page with descriptive meta tags, linked stylesheet, script, and simple body content." + }, + { + "inputJson": "{\"title\":\"Minimal Page\",\"bodyContent\":\"Content only
\",\"includeDoctype\":false}", + "description": "Generate a minimal HTML snippet without doctype and default language 'en'." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "HTML", + "context": null + } + }, + { + "name": "backend-development.generateHeading", + "description": "Generates an HTML heading element string based on input text and specified heading level. Accepts the heading text and an optional level (1-6), then returns a string with the appropriately formatted HTML heading tag.", + "category": "backend-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text content to include inside the heading element.", + "required": true, + "defaultValue": "" + }, + { + "name": "level", + "type": "number", + "description": "The heading level from 1 to 6, corresponding to HTML tags h1 through h6.", + "required": false, + "defaultValue": "1" + }, + { + "name": "className", + "type": "string", + "description": "Optional CSS class name to add to the heading tag for styling purposes.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "string", + "description": "A string of HTML representing the heading element with the specified level, text content, and optional CSS class." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate HTML heading tags in backend-generated content or API responses, ensuring valid semantic HTML with flexible heading levels and styling classes. It's ideal for serverside rendering scenarios or automated content generation workflows.", + "limitations": "This tool only generates static HTML strings for headings; it does not sanitize input text for HTML injection or support advanced heading attributes like IDs, ARIA roles, or inline styles.", + "examples": [ + "Generate a level 2 heading with text 'Welcome to My Site'.", + "Create a level 4 heading with text 'Section Overview' and a CSS class 'section-title'.", + "Produce a default level 1 heading for 'Main Title' without additional classes." + ] + }, + "tags": [ + "backend-development", + "html", + "heading", + "generate", + "templating", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Welcome to My Site\",\"level\":2}", + "description": "Generate a level 2 HTML heading with the given text." + }, + { + "inputJson": "{\"text\":\"Section Overview\",\"level\":4,\"className\":\"section-title\"}", + "description": "Generate a level 4 heading with a CSS class for styling." + }, + { + "inputJson": "{\"text\":\"Main Title\"}", + "description": "Generate a default level 1 heading with given text and no class." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Heading", + "context": null + } + }, + { + "name": "backend-development.createHeading", + "description": "Generates an HTML heading element string based on the provided level, text content, and optional styling classes. Accepts heading level (1-6), text for the heading, and optional list of CSS class names to apply. Returns a string containing the complete HTML heading tag that can be embedded in server-generated HTML templates or API responses.", + "category": "backend-development", + "parameters": [ + { + "name": "level", + "type": "number", + "description": "The heading level to create, between 1 and 6 inclusive.", + "required": true, + "defaultValue": "" + }, + { + "name": "text", + "type": "string", + "description": "The text content to be displayed inside the heading tag.", + "required": true, + "defaultValue": "" + }, + { + "name": "classNames", + "type": "array", + "description": "An optional array of CSS class names to add to the heading element for styling purposes.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated HTML heading string as 'htmlString'." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically create correctly formatted HTML heading elements on the backend. It is useful for server-side rendering of web pages, APIs that generate HTML snippets, or for transforming text data into structured heading tags programmatically. It ensures that the heading level is valid and optionally allows adding CSS classes for styling.", + "limitations": "This tool only creates simple heading tags and does not sanitize text content to prevent injection. It does not support nested elements or other attributes beyond class names.", + "examples": [ + "Create a level 2 heading with text 'Welcome to My Site' and CSS classes ['main-title','highlight'].", + "Generate a level 4 heading with text 'Section 1' without any CSS classes.", + "Produce a level 1 heading titled 'Home Page' with class 'header'." + ] + }, + "tags": [ + "backend", + "html", + "heading", + "web", + "server-side", + "templating" + ], + "examples": [ + { + "inputJson": "{\"level\":2,\"text\":\"Welcome to My Site\",\"classNames\":[\"main-title\",\"highlight\"]}", + "description": "Create an H2 heading with text and multiple classes." + }, + { + "inputJson": "{\"level\":4,\"text\":\"Section 1\",\"classNames\":[]}", + "description": "Create an H4 heading with text but no classes." + }, + { + "inputJson": "{\"level\":1,\"text\":\"Home Page\",\"classNames\":[\"header\"]}", + "description": "Create an H1 heading with one class." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Heading", + "context": null + } + }, + { + "name": "backend-development.createQueue", + "description": "Creates a message queue with specified configuration parameters for use in backend server applications. Accepts inputs such as queue name, durability settings, maximum message size, and optional dead-letter queue parameters. Outputs confirmation of queue creation along with configuration details including the unique queue identifier and status.", + "category": "backend-development", + "parameters": [ + { + "name": "queueName", + "type": "string", + "description": "The desired name for the queue to be created. Must be unique within the messaging system.", + "required": true, + "defaultValue": "" + }, + { + "name": "durable", + "type": "boolean", + "description": "Indicates whether the queue should survive broker restarts (persisted).", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxSizeMB", + "type": "number", + "description": "Maximum size of the queue in megabytes before rejecting new messages.", + "required": false, + "defaultValue": "100" + }, + { + "name": "maxLengthMessages", + "type": "number", + "description": "Maximum number of messages the queue can hold. Additional messages will be rejected or overflowed.", + "required": false, + "defaultValue": "10000" + }, + { + "name": "deadLetterQueueName", + "type": "string", + "description": "Optional name of a dead-letter queue to route messages that cannot be delivered or processed.", + "required": false, + "defaultValue": "" + }, + { + "name": "autoDelete", + "type": "boolean", + "description": "If true, the queue will be deleted automatically when no longer used.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the queue ID, name, configuration details, and creation status confirmation." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and configure a message queue in backend infrastructure, ensuring it meets specific durability, sizing, and message routing requirements essential for scalable, reliable asynchronous processing.", + "limitations": "This tool does not handle the actual message publishing or consumption, nor does it manage the lifecycle beyond initial creation (such as updates or deletions). It assumes the underlying message broker supports the specified features.", + "examples": [ + "Create a durable queue named 'orderProcessing' with max size 500MB and dead-letter queue 'orderDLQ'.", + "Create a temporary auto-delete queue named 'tempNotifications'.", + "Create a queue 'userSignup' with default settings and no dead-letter queue." + ] + }, + "tags": [ + "backend", + "queue", + "infrastructure", + "message-queue", + "create", + "server", + "asynchronous", + "messaging" + ], + "examples": [ + { + "inputJson": "{\"queueName\":\"orderProcessing\",\"durable\":true,\"maxSizeMB\":500,\"maxLengthMessages\":50000,\"deadLetterQueueName\":\"orderDLQ\",\"autoDelete\":false}", + "description": "Create a durable order processing queue with a large max size and a dead-letter queue." + }, + { + "inputJson": "{\"queueName\":\"tempNotifications\",\"durable\":false,\"autoDelete\":true}", + "description": "Create a non-durable, auto-delete queue for temporary notifications." + }, + { + "inputJson": "{\"queueName\":\"userSignup\"}", + "description": "Create a queue named userSignup with default durability, size, and no dead-letter queue." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Queue", + "context": null + } + }, + { + "name": "backend-development.createIncident", + "description": "Creates a new security incident record for backend systems by accepting details such as incident type, description, severity, and affected components. Processes the input to validate and store the incident in a centralized incident management system, returning a confirmation with a unique incident ID and status.", + "category": "backend-development", + "parameters": [ + { + "name": "incidentType", + "type": "string", + "description": "Category or type of the security incident (e.g., 'Unauthorized Access', 'Data Breach').", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed description of the incident including what happened and potential impact.", + "required": true, + "defaultValue": "" + }, + { + "name": "severity", + "type": "string", + "description": "Severity level of the incident, such as 'Low', 'Medium', 'High', or 'Critical'.", + "required": true, + "defaultValue": "" + }, + { + "name": "affectedComponents", + "type": "array", + "description": "List of backend components or services affected by the incident.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "detectedAt", + "type": "string", + "description": "Timestamp indicating when the incident was detected, in ISO 8601 format.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportedBy", + "type": "string", + "description": "Identifier or name of the individual or system reporting the incident.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional tags or keywords to categorize or label the incident for searchability.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Object containing confirmation of the incident creation with a unique incident ID, creation timestamp, and current status." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent detects or is informed of a security issue affecting backend infrastructure and needs to formally log it into the incident management system with relevant metadata for further tracking and resolution.", + "limitations": "This tool does not perform incident response actions or mitigation measures; it only logs incidents. It also does not automatically update or close incidents once created.", + "examples": [ + "Create a new incident for a detected data breach affecting the database cluster.", + "Log an unauthorized access incident detected by the monitoring system.", + "Report a denial-of-service attack impacting web backend services." + ] + }, + "tags": [ + "incident management", + "security", + "backend", + "logging", + "automation", + "security incident" + ], + "examples": [ + { + "inputJson": "{\"incidentType\":\"Unauthorized Access\",\"description\":\"An attacker gained access to the admin panel using stolen credentials.\",\"severity\":\"High\",\"affectedComponents\":[\"Admin Panel\",\"User Auth Service\"],\"detectedAt\":\"2024-06-01T15:30:00Z\",\"reportedBy\":\"IDS System\",\"tags\":[\"critical\",\"breach\"]}", + "description": "Create a high severity incident of unauthorized access detected by the IDS system affecting admin panel and auth service." + }, + { + "inputJson": "{\"incidentType\":\"Data Breach\",\"description\":\"Sensitive user data was extracted by malware.\",\"severity\":\"Critical\",\"affectedComponents\":[\"User Database\"],\"detectedAt\":\"2024-06-02T11:00:00Z\",\"reportedBy\":\"Security Team\",\"tags\":[\"data breach\"]}", + "description": "Log a critical data breach incident reported by the security team involving user database." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Incident", + "context": null + } + }, + { + "name": "backend-development.createDeal", + "description": "Creates a new business deal record in a backend system. Accepts deal details such as title, description, value, currency, involved parties, status, and optional custom metadata. Processes input by validating and storing the deal, returning a unique deal ID along with confirmation and summary of the saved deal.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title or name of the deal to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "A detailed description of the deal.", + "required": false, + "defaultValue": "" + }, + { + "name": "value", + "type": "number", + "description": "The monetary value of the deal (positive number).", + "required": false, + "defaultValue": "0" + }, + { + "name": "currency", + "type": "string", + "description": "The currency code (e.g., USD, EUR) for the deal value.", + "required": false, + "defaultValue": "USD" + }, + { + "name": "partyA", + "type": "string", + "description": "Identifier or name for the first party involved in the deal.", + "required": true, + "defaultValue": "" + }, + { + "name": "partyB", + "type": "string", + "description": "Identifier or name for the second party involved in the deal.", + "required": true, + "defaultValue": "" + }, + { + "name": "status", + "type": "string", + "description": "Current status of the deal such as 'pending', 'active', 'closed'.", + "required": false, + "defaultValue": "pending" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional key-value metadata related to the deal.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique dealId generated, confirmation status, and a summary of the saved deal details." + }, + "aiAgent": { + "useCase": "Use this tool when an AI needs to create or register new business deals in a backend system, ensuring all required information is captured and stored properly. Ideal for CRM automation, contract management, or sales pipelines where structured deal records are necessary.", + "limitations": "This tool does not perform complex deal validations like regulatory compliance or automated negotiation; it only records deal data as provided.", + "examples": [ + "Create a new sales deal between company A and company B with a value of $10,000 USD.", + "Register a partnership agreement deal with detailed metadata indicating contract terms.", + "Start a pending deal record between two clients without specifying description or metadata." + ] + }, + "tags": [ + "backend", + "business", + "deal", + "create", + "crm", + "sales" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Q2 Enterprise Software License\",\"description\":\"License deal for enterprise software covering 500 users.\",\"value\":150000,\"currency\":\"USD\",\"partyA\":\"Enterprise Corp\",\"partyB\":\"Software Maker Inc.\",\"status\":\"pending\",\"metadata\":{\"contractLength\":\"12 months\",\"renewalOption\":true}}", + "description": "Creating a high-value software license deal with metadata including contract length and renewal option." + }, + { + "inputJson": "{\"title\":\"Marketing Collaboration Agreement\",\"partyA\":\"Marketing Co.\",\"partyB\":\"Retail Partner LLC\",\"status\":\"active\"}", + "description": "Creating an active collaboration agreement with minimal details for a marketing campaign." + }, + { + "inputJson": "{\"title\":\"Consulting Services Deal\",\"description\":\"Annual consulting services contract.\",\"value\":50000,\"currency\":\"EUR\",\"partyA\":\"Tech Consulting GmbH\",\"partyB\":\"Client XYZ\",\"metadata\":{\"serviceLevel\":\"premium\"}}", + "description": "Registering a consulting deal with value in EUR and extra metadata about the service level." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Deal", + "context": null + } + }, + { + "name": "backend-development.createResume", + "description": "Generates a professional resume document in various formats based on structured input data. Accepts personal information, work experience, education, skills, and optional sections to create a formatted resume ready for download or further editing.", + "category": "backend-development", + "parameters": [ + { + "name": "personalInfo", + "type": "object", + "description": "An object containing personal details such as name, email, phone, and address.", + "required": true, + "defaultValue": "" + }, + { + "name": "workExperience", + "type": "array", + "description": "An array of work experience entries, each with company, role, start date, end date, and description.", + "required": true, + "defaultValue": "" + }, + { + "name": "education", + "type": "array", + "description": "An array of education entries including institution, degree, field of study, start date, and end date.", + "required": true, + "defaultValue": "" + }, + { + "name": "skills", + "type": "array", + "description": "A list of skills or competencies to highlight on the resume.", + "required": true, + "defaultValue": "" + }, + { + "name": "certifications", + "type": "array", + "description": "Optional list of certifications or licenses with names and issuance dates.", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Output file format of the resume document, e.g., pdf, docx, or txt.", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Flag to include a professional summary section if provided.", + "required": false, + "defaultValue": "false" + }, + { + "name": "summary", + "type": "string", + "description": "A brief professional summary or objective to include at the start of the resume.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated resume document as a base64-encoded string along with the specified file format and suggested filename." + }, + "aiAgent": { + "useCase": "Use this tool when a detailed, formatted resume document is needed programmatically from structured user career data, such as in job application platforms or career management services. It automates the creation of professional resumes in multiple formats to reduce manual formatting effort.", + "limitations": "This tool does not evaluate or optimize the quality of content; it only formats provided data into a resume layout. It cannot generate content or suggest improvements.", + "examples": [ + "Create a PDF resume from user profile data including work and education history.", + "Generate a DOCX resume file including certifications and a professional summary.", + "Produce a plain text version of a resume for simple email applications." + ] + }, + "tags": [ + "resume", + "document-generation", + "backend", + "career", + "pdf", + "docx", + "automation" + ], + "examples": [ + { + "inputJson": "{\"personalInfo\":{\"name\":\"Jane Doe\",\"email\":\"jane.doe@example.com\",\"phone\":\"555-123-4567\",\"address\":\"123 Main St, Springfield, USA\"},\"workExperience\":[{\"company\":\"TechCorp\",\"role\":\"Software Engineer\",\"startDate\":\"2018-06\",\"endDate\":\"2022-08\",\"description\":\"Developed scalable web applications and APIs.\"},{\"company\":\"Web Solutions\",\"role\":\"Junior Developer\",\"startDate\":\"2016-01\",\"endDate\":\"2018-05\",\"description\":\"Assisted with frontend development and testing.\"}],\"education\":[{\"institution\":\"State University\",\"degree\":\"BSc Computer Science\",\"fieldOfStudy\":\"Computer Science\",\"startDate\":\"2012-09\",\"endDate\":\"2016-06\"}],\"skills\":[\"JavaScript\",\"Node.js\",\"React\",\"Docker\"],\"certifications\":[{\"name\":\"AWS Certified Developer\",\"date\":\"2021-10\"}],\"format\":\"pdf\",\"includeSummary\":true,\"summary\":\"Experienced software engineer with a passion for scalable backend systems.\"}", + "description": "Create a PDF resume with full profile data including summary and certifications." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Resume", + "context": null + } + }, + { + "name": "backend-development.createSpec", + "description": "Generates a detailed API specification document based on provided endpoint definitions, request and response schemas, authentication methods, and metadata. Accepts structured inputs describing REST or GraphQL endpoints and outputs a comprehensive spec in JSON or YAML format compatible with OpenAPI 3.0 or GraphQL SDL standards.", + "category": "backend-development", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "The name of the API for which the specification document is created.", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "Version identifier for the API spec document (e.g., '1.0.0').", + "required": false, + "defaultValue": "\"1.0.0\"" + }, + { + "name": "description", + "type": "string", + "description": "A short description or summary of the API.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "endpoints", + "type": "array", + "description": "An array of endpoint objects each describing a single API operation, including HTTP method, path, parameters, and response schemas.", + "required": true, + "defaultValue": "" + }, + { + "name": "authentication", + "type": "object", + "description": "Details about the supported authentication schemes, e.g., API keys, OAuth2 flows.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired specification format output, e.g., 'openapijson', 'openapiyaml', 'graphqlsdl'.", + "required": false, + "defaultValue": "\"openapijson\"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the complete API specification document as a string and its format type." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create or update a machine-readable API specification document from structured input describing API endpoints and metadata. This enables automated validation, documentation generation, or SDK generation workflows for backend APIs.", + "limitations": "This tool does not implement semantic validation of Swagger or GraphQL beyond structural assembly. It does not interact with live APIs to fetch or infer schemas; it requires accurate manual input. Does not generate human-friendly prose documentation beyond the provided descriptions.", + "examples": [ + "Create an OpenAPI 3.0 JSON spec for a RESTful user management API with POST /users and GET /users/{id} endpoints.", + "Generate a GraphQL SDL specification document from given type and query definitions.", + "Update an existing API spec to version 2.0 with added OAuth2 authentication details." + ] + }, + "tags": [ + "backend", + "API", + "specification", + "OpenAPI", + "GraphQL", + "documentation", + "automation" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"User Management API\",\"version\":\"1.0.0\",\"description\":\"API for managing user accounts.\",\"endpoints\":[{\"path\":\"/users\",\"method\":\"POST\",\"summary\":\"Create a new user\",\"parameters\":[{\"name\":\"body\",\"in\":\"body\",\"required\":true,\"schema\":{\"type\":\"object\",\"properties\":{\"username\":{\"type\":\"string\"},\"email\":{\"type\":\"string\"}}}}],\"responses\":{\"201\":{\"description\":\"User created successfully\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"username\":{\"type\":\"string\"},\"email\":{\"type\":\"string\"}}}}}}}}],\"authentication\":{\"type\":\"apiKey\",\"in\":\"header\",\"name\":\"X-API-KEY\"},\"outputFormat\":\"openapijson\"}", + "description": "Generate an OpenAPI 3.0 JSON document for a simple user creation API with API key authentication." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Spec", + "context": null + } + }, + { + "name": "web-development.analyzeAccount", + "description": "Analyzes a web application user account by evaluating input metrics such as login activity, account settings, and usage patterns to generate a comprehensive report highlighting account health, potential security vulnerabilities, and optimization recommendations.", + "category": "web-development", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "The unique identifier of the user account to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSecurityAnalysis", + "type": "boolean", + "description": "Whether to include security vulnerability assessment in the analysis report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "timeRangeDays", + "type": "number", + "description": "Number of past days to consider for usage and activity data analysis.", + "required": false, + "defaultValue": "30" + }, + { + "name": "detailedReport", + "type": "boolean", + "description": "Whether to generate a detailed report including granular metrics and recommendations.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the account analysis report including summary metrics, security findings, usage patterns, and optimization suggestions." + }, + "aiAgent": { + "useCase": "Use this tool when you want to analyze user accounts of a web application to understand their activity, security posture, and overall health to improve user management or detect issues. It's applicable in scenarios such as account audits, security reviews, and optimizing account configurations.", + "limitations": "This tool requires valid and accessible account data inputs and does not perform any real-time monitoring or direct remediation actions. It cannot analyze accounts outside of the supported web application context.", + "examples": [ + "Analyze a specific user account for potential security risks and usage anomalies over the past month.", + "Generate a detailed report on a user account's activity and settings to identify optimization opportunities.", + "Quickly assess an account's general health without deep security analysis for summary dashboards." + ] + }, + "tags": [ + "analysis", + "account", + "web-development", + "security", + "usage", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"accountId\":\"user12345\",\"includeSecurityAnalysis\":true,\"timeRangeDays\":30,\"detailedReport\":true}", + "description": "Analyze user12345 account over the last 30 days with full security and detailed metrics." + }, + { + "inputJson": "{\"accountId\":\"guest6789\",\"includeSecurityAnalysis\":false,\"timeRangeDays\":7}", + "description": "Quick 7-day usage analysis for guest6789 account without security checks." + }, + { + "inputJson": "{\"accountId\":\"admin001\",\"detailedReport\":true}", + "description": "Detailed report for admin001 account using default time range and including security analysis." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "automation-frameworks.analyzeAlert", + "description": "Analyzes security alert data provided as input, processes alert attributes such as severity, source, and type, correlates with known threat intelligence and past incident patterns, and outputs an analysis report including threat level, probable impact, and recommended actions.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "alertData", + "type": "object", + "description": "A structured object containing alert details such as timestamp, severity, source IP, destination IP, alert type, and description.", + "required": true, + "defaultValue": "" + }, + { + "name": "threatIntelligenceSources", + "type": "array", + "description": "An optional list of external threat intelligence sources (URLs or API endpoints) to enrich analysis.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "correlationWindow", + "type": "number", + "description": "Time window in minutes to correlate the alert with previous alerts for pattern detection.", + "required": false, + "defaultValue": "60" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "When true, include security recommendations based on the analysis results.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object including evaluated threatLevel (low, medium, high), impactSummary, correlatedAlerts (list), and recommendedActions (list of strings)." + }, + "aiAgent": { + "useCase": "Use this tool when receiving raw or structured security alerts that need automated evaluation to determine threat significance, identify correlations with past incidents, and suggest mitigation steps. Ideal for security automation workflows to prioritize alerts and reduce manual triage workload.", + "limitations": "Cannot replace a human security analyst's comprehensive investigation; dependent on data quality and available threat intelligence; does not perform real-time alert collection, only analysis of supplied alert data.", + "examples": [ + "Analyze this suspicious alert to determine its severity and recommended actions.", + "Correlate this network intrusion alert with past alerts in the last hour and evaluate the risk.", + "Provide an analysis report on this phishing alert with suggested next steps." + ] + }, + "tags": [ + "security", + "automation", + "alert-analysis", + "threat-intelligence", + "incident-response", + "correlation", + "recommendation" + ], + "examples": [ + { + "inputJson": "{\"alertData\":{\"timestamp\":\"2024-06-15T14:30:00Z\",\"severity\":\"high\",\"sourceIP\":\"192.168.1.100\",\"destinationIP\":\"10.0.0.5\",\"alertType\":\"network intrusion\",\"description\":\"Detected unusual traffic pattern from internal host.\"},\"threatIntelligenceSources\":[\"https://threatintel.example.com/api\"],\"correlationWindow\":120,\"includeRecommendations\":true}", + "description": "Analyze a high-severity network intrusion alert with threat intel enrichment and 2-hour correlation window." + }, + { + "inputJson": "{\"alertData\":{\"timestamp\":\"2024-06-15T09:15:00Z\",\"severity\":\"medium\",\"sourceIP\":\"203.0.113.10\",\"destinationIP\":\"10.0.0.8\",\"alertType\":\"phishing email\",\"description\":\"Suspicious email detected containing a malicious attachment.\"},\"includeRecommendations\":false}", + "description": "Analyze a medium-severity phishing alert without recommendations, using default correlation window and no threat intel sources." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Alert", + "context": null + } + }, + { + "name": "automation-frameworks.generateSentence", + "description": "Generates a coherent sentence based on specified parameters, including desired length, tone, and keywords. This tool accepts parameters that guide sentence construction, processes them using a natural language generation model, and outputs a generated sentence string that fits the input criteria.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Desired length of the sentence in words, from 3 to 50.", + "required": false, + "defaultValue": "15" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the sentence, e.g., formal, casual, optimistic, neutral.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords that should be included in the sentence if possible.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Language code for the sentence generation, e.g., 'en' for English.", + "required": false, + "defaultValue": "en" + }, + { + "name": "avoidNegative", + "type": "boolean", + "description": "Indicates whether to avoid negative or pessimistic expressions in the sentence.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence string under the key 'sentence'." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to generate natural language sentences for automation workflows, such as creating sample messages, notifications, or example text content where parameters like tone and keyword inclusion matter. It's ideal for automating content generation within scripts or for testing purposes where adjustable sentence features are required.", + "limitations": "The tool cannot produce highly specialized or technical sentences requiring domain knowledge beyond general language generation, nor can it ensure perfectly fluent or factually accurate sentences in all contexts.", + "examples": [ + "Generate a formal sentence of about 10 words including the keyword 'performance'.", + "Create a casual, optimistic sentence of length 20 with the keywords ['team', 'success'].", + "Produce a neutral tone sentence avoiding negative words, about 15 words long." + ] + }, + "tags": [ + "automation", + "text-generation", + "sentence", + "NLG", + "content-creation", + "workflow" + ], + "examples": [ + { + "inputJson": "{\"length\":12,\"tone\":\"formal\",\"keywords\":[\"performance\"]}", + "description": "Generate a formal sentence approximately 12 words long including the keyword 'performance'." + }, + { + "inputJson": "{\"length\":20,\"tone\":\"casual\",\"keywords\":[\"team\",\"success\"],\"avoidNegative\":true}", + "description": "Create a casual, optimistic sentence of length 20 including keywords 'team' and 'success', avoiding negative phrasing." + }, + { + "inputJson": "{\"length\":15,\"tone\":\"neutral\"}", + "description": "Produce a neutral tone sentence about 15 words long without mandatory keywords." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Sentence", + "context": null + } + }, + { + "name": "automation-frameworks.createContainer", + "description": "Creates a new container instance within a specified container orchestration platform (e.g., Docker, Kubernetes). Accepts platform type, container image, resource limits, environment variables, and networking settings, then provisions the container and returns its status and connection details.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "platform", + "type": "string", + "description": "The container orchestration platform to use (e.g., 'docker', 'kubernetes').", + "required": true, + "defaultValue": "" + }, + { + "name": "image", + "type": "string", + "description": "The container image name or ID to deploy (e.g., 'nginx:latest').", + "required": true, + "defaultValue": "" + }, + { + "name": "containerName", + "type": "string", + "description": "The desired name for the new container instance.", + "required": false, + "defaultValue": "" + }, + { + "name": "cpuLimit", + "type": "number", + "description": "Maximum CPU resources allocated to the container in cores (e.g., 0.5 for half core).", + "required": false, + "defaultValue": "0.5" + }, + { + "name": "memoryLimit", + "type": "string", + "description": "Maximum memory allocated to the container (e.g., '512Mi', '2Gi').", + "required": false, + "defaultValue": "512Mi" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs for environment variables set inside the container.", + "required": false, + "defaultValue": "" + }, + { + "name": "ports", + "type": "array", + "description": "List of port mappings from host to container in the format [{'hostPort':80,'containerPort':80}].", + "required": false, + "defaultValue": "" + }, + { + "name": "networkMode", + "type": "string", + "description": "Networking mode or namespace to use (e.g., 'bridge', 'host' in Docker).", + "required": false, + "defaultValue": "bridge" + }, + { + "name": "restartPolicy", + "type": "string", + "description": "Container restart policy (e.g., 'no', 'on-failure', 'always').", + "required": false, + "defaultValue": "no" + } + ], + "returns": { + "type": "object", + "description": "An object containing the container ID, status (running, created, error), and connection info such as IP and mapped ports." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate deployment of containerized applications for testing, development, or dynamic scaling by creating containers with specified configurations on docker or Kubernetes platforms. It helps launch, configure, and track container instances programmatically.", + "limitations": "Does not handle complex multi-container orchestration (use the full orchestration framework for that), nor manage container lifecycle beyond initial creation. Platform-specific features beyond common parameters are not supported.", + "examples": [ + "Create a single docker container running nginx with 0.5 CPU core and 512Mi memory", + "Provision a Kubernetes pod with an environment variable and port mapping", + "Deploy a container named 'app-test' with restart policy 'always' and host network mode" + ] + }, + "tags": [ + "automation", + "container", + "deploy", + "docker", + "kubernetes", + "orchestration", + "infrastructure" + ], + "examples": [ + { + "inputJson": "{\"platform\":\"docker\",\"image\":\"nginx:latest\",\"containerName\":\"web-server\",\"cpuLimit\":0.5,\"memoryLimit\":\"512Mi\",\"environmentVariables\":{\"ENV\":\"production\"},\"ports\":[{\"hostPort\":8080,\"containerPort\":80}],\"networkMode\":\"bridge\",\"restartPolicy\":\"no\"}", + "description": "Deploy a Docker nginx container named 'web-server' with 0.5 CPU and 512Mi memory, exposing container port 80 on host port 8080." + }, + { + "inputJson": "{\"platform\":\"kubernetes\",\"image\":\"redis:6-alpine\",\"containerName\":\"cache\",\"cpuLimit\":0.2,\"memoryLimit\":\"256Mi\",\"environmentVariables\":{\"LOG_LEVEL\":\"debug\"},\"ports\":[{\"hostPort\":6379,\"containerPort\":6379}],\"networkMode\":\"\",\"restartPolicy\":\"Always\"}", + "description": "Create a Kubernetes container instance running Redis with debug log level, low resource limits, opening default Redis port." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Container", + "context": null + } + }, + { + "name": "automation-frameworks.createBranch", + "description": "This tool automates the creation of a new branch in a version control repository. It accepts inputs such as the repository URL, target commit hash or branch, new branch name, and optional authentication credentials. It performs validation, creates the branch in the remote repository, and returns details about the created branch including its reference and confirmation of success.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The URL of the git repository where the branch will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "newBranchName", + "type": "string", + "description": "The name of the new branch to create.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceRef", + "type": "string", + "description": "The source commit hash or existing branch name the new branch will be based on. Defaults to the repository's default branch if empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Optional authentication token (e.g., OAuth, personal access token) to access private repositories.", + "required": false, + "defaultValue": "" + }, + { + "name": "force", + "type": "boolean", + "description": "Whether to force branch creation if the branch already exists, overwriting it.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the new branch reference details and operation status, including branchName, commitHash, repositoryUrl, and success flag." + }, + "aiAgent": { + "useCase": "Use this tool when automating version control workflows requiring programmatic branch creation, such as feature branching, hotfixes, or automated integration pipelines. It facilitates continuous integration/deployment by enabling agents to create branches dynamically.", + "limitations": "Does not support non-git version control systems. Does not manage pull requests or branch protection rules. Requires proper authentication tokens for private repositories; cannot generate or renew these tokens automatically.", + "examples": [ + "Create a new branch 'feature-xyz' from the latest main branch in a public repo.", + "Create a hotfix branch from a specific commit hash in a private repo using an auth token.", + "Force overwrite an existing branch with updated changes for CI purposes." + ] + }, + "tags": [ + "automation", + "git", + "version-control", + "branching", + "devops", + "ci-cd", + "repository-management" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"newBranchName\":\"feature-login\",\"sourceRef\":\"main\",\"authToken\":\"\",\"force\":false}", + "description": "Create a feature branch 'feature-login' from main branch in a public repository." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/private-repo.git\",\"newBranchName\":\"hotfix-urgent\",\"sourceRef\":\"a1b2c3d4e5f6g7h8i9j0\",\"authToken\":\"ghp_XXXXXXXXXXXXXXXXXXXX\",\"force\":false}", + "description": "Create a hotfix branch from a specific commit in a private repository with authentication." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"newBranchName\":\"release-candidate\",\"sourceRef\":\"develop\",\"authToken\":\"\",\"force\":true}", + "description": "Force create or overwrite the 'release-candidate' branch from develop branch." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Branch", + "context": null + } + }, + { + "name": "statistics-tools.generateDocument", + "description": "Generates a comprehensive statistical analysis report document based on input dataset and analysis parameters. Accepts raw data and specified statistical methods, performs computations such as descriptive statistics, hypothesis testing, and regression modeling, then produces a structured document (PDF or DOCX) summarizing results with charts and interpretation.", + "category": "statistics-tools", + "parameters": [ + { + "name": "dataset", + "type": "array", + "description": "Input dataset as an array of objects or arrays representing rows of data for analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "analysisMethods", + "type": "array", + "description": "List of statistical methods to apply, e.g., ['descriptive', 'anova', 'regression'].", + "required": true, + "defaultValue": "" + }, + { + "name": "documentFormat", + "type": "string", + "description": "Output document format. Supported values: 'pdf' or 'docx'.", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "title", + "type": "string", + "description": "Title of the generated report document.", + "required": false, + "defaultValue": "Statistical Analysis Report" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Whether to include visual charts (histograms, scatter plots) in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "significanceLevel", + "type": "number", + "description": "Alpha level to use for hypothesis testing (e.g., 0.05).", + "required": false, + "defaultValue": "0.05" + }, + { + "name": "notes", + "type": "string", + "description": "Optional user notes or comments to add to the end of the report.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the binary document file as base64 and metadata such as filename and content type. Example: { filename: 'report.pdf', contentType: 'application/pdf', contentBase64: '...' }" + }, + "aiAgent": { + "useCase": "Use this tool to automatically generate detailed statistical analysis reports from raw data inputs. Ideal when users need quick, documented insights with supporting statistics and visualizations for presentations, publications, or review.", + "limitations": "This tool does not perform raw data cleaning or transformation; input data should be preprocessed. It supports common statistical methods but not specialized or highly customized analyses. Large datasets may increase processing time.", + "examples": [ + "Generate a PDF report with descriptive statistics and regression analysis for experimental data.", + "Create a DOCX report including ANOVA and hypothesis test results with charts.", + "Produce a summary report without charts and with user notes appended." + ] + }, + "tags": [ + "statistics", + "reporting", + "document", + "analysis", + "pdf", + "docx", + "data-science" + ], + "examples": [ + { + "inputJson": "{\"dataset\":[{\"age\":30,\"score\":88},{\"age\":25,\"score\":95},{\"age\":40,\"score\":78}],\"analysisMethods\":[\"descriptive\",\"regression\"],\"documentFormat\":\"pdf\",\"title\":\"Test Score Analysis\",\"includeCharts\":true,\"significanceLevel\":0.05,\"notes\":\"Data collected from Q1 survey.\"}", + "description": "Generate a PDF report analyzing test scores using descriptive and regression methods with charts and additional notes." + }, + { + "inputJson": "{\"dataset\":[{\"group\":\"A\",\"value\":5},{\"group\":\"B\",\"value\":7},{\"group\":\"A\",\"value\":6},{\"group\":\"B\",\"value\":8}],\"analysisMethods\":[\"anova\"],\"documentFormat\":\"docx\",\"title\":\"Group Value Comparison\",\"includeCharts\":false,\"significanceLevel\":0.01}", + "description": "Create a DOCX report performing ANOVA to compare two groups without charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "automation-frameworks.createSummary", + "description": "Takes a body of text or document content as input and generates a concise summary highlighting the main points and key information. This tool supports plain text or markdown inputs and outputs a shortened text summary to facilitate quick understanding and review.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "The full text or document content that needs to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "Maximum length of the generated summary in characters. Defaults to 500.", + "required": false, + "defaultValue": "500" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the content (e.g., 'en' for English) to optimize summarization accuracy.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeBulletPoints", + "type": "boolean", + "description": "Whether to format the summary with bullet points for clarity. Defaults to false.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated summary text." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a brief, readable summary from lengthy text documents, reports, or articles to help users quickly grasp critical information without reading the full content. It is useful in automating content review workflows, generating executive summaries, or extracting key points for reporting.", + "limitations": "The summary may lose nuanced or detailed information; it is designed for high-level overviews and not for detailed analysis. It requires reasonably well-formed input text; very short or highly technical text may produce less useful results.", + "examples": [ + "Create a summary from a 5-page project status report to provide a quick update to stakeholders.", + "Summarize meeting notes to highlight action items and decisions.", + "Generate a brief abstract for a long-form article for newsletter inclusion." + ] + }, + "tags": [ + "automation", + "summary", + "text-processing", + "document", + "workflow", + "content" + ], + "examples": [ + { + "inputJson": "{\"content\":\"This quarterly sales report shows a steady increase in revenue driven by the new product line, significant growth in online sales channels, and expansion into new markets. Challenges include supply chain delays and increased operational costs, which are being addressed through strategic partnerships and process improvements.\",\"maxSummaryLength\":300,\"includeBulletPoints\":true}", + "description": "Summarize a quarterly sales report highlighting key achievements and challenges with bullet points." + }, + { + "inputJson": "{\"content\":\"During the meeting, the team decided to prioritize feature development for the upcoming release cycle. Key action items include finalizing the UI mockups by next week, initiating backend integration, and scheduling user testing sessions.\",\"maxSummaryLength\":200}", + "description": "Create a brief summary of meeting notes focusing on decisions and action items." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "text-analysis.composeEmail", + "description": "This tool composes a professional email based on the provided recipient details, subject, key points, tone, and style preferences. It processes these inputs using natural language generation to produce a coherent, contextually appropriate email body, returning a complete email text ready for sending or further editing.", + "category": "text-analysis", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the email recipient, used for personalization at greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to define the email topic.", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of main points or messages to include in the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the email such as formal, informal, friendly, or professional.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "style", + "type": "string", + "description": "Writing style preference, e.g., concise, detailed, persuasive.", + "required": false, + "defaultValue": "concise" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to append a signature block with sender's information at the end.", + "required": false, + "defaultValue": "true" + }, + { + "name": "senderName", + "type": "string", + "description": "Name of the sender to use in greeting and signature if included.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed email with subject and body text ready for use." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate complete, coherent, and purpose-driven emails quickly from structured input parameters such as recipient, subject, key message points, and style preferences. It helps automate email drafting for business, customer communication, or personal correspondence while ensuring appropriate tone and style.", + "limitations": "This tool cannot verify recipient contact authenticity, handle attachments, or respond to email replies. It generates text based solely on input parameters and does not interact with email clients.", + "examples": [ + "Compose a formal email to a client summarizing the project status and next steps.", + "Generate a friendly invitation email with key event details for team members.", + "Create a concise professional apology email for a delayed response." + ] + }, + "tags": [ + "email", + "composition", + "text-analysis", + "natural-language-generation", + "communication" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Jane Smith\",\"subject\":\"Project Update\",\"keyPoints\":[\"The project is 75% complete\",\"Expected delivery by June 30\",\"Next review meeting on June 15\"],\"tone\":\"formal\",\"style\":\"concise\",\"includeSignature\":true,\"senderName\":\"John Doe\"}", + "description": "Formal project update email to a client named Jane Smith with key status points and a signature." + }, + { + "inputJson": "{\"recipientName\":\"Mike\",\"subject\":\"Team Lunch Invitation\",\"keyPoints\":[\"Join us for lunch on Friday at 12pm\",\"Location is the new Italian restaurant downtown\"],\"tone\":\"friendly\",\"style\":\"detailed\",\"includeSignature\":false,\"senderName\":\"\"}", + "description": "Friendly invitation email for team lunch with event details and no signature." + }, + { + "inputJson": "{\"recipientName\":\"Customer Support\",\"subject\":\"Apology for Delayed Response\",\"keyPoints\":[\"Apologize for delayed reply\",\"Issue has been escalated to technical team\",\"Will update within 24 hours\"],\"tone\":\"professional\",\"style\":\"concise\",\"includeSignature\":true,\"senderName\":\"Support Team\"}", + "description": "Professional apology email with brief explanation and signature from support team." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "text-analysis.buildFunction", + "description": "This tool generates a code function based on a textual description of desired functionality. It accepts natural language input describing what the function should do, optional parameters such as programming language and function name, and outputs the source code implementing the specification in the chosen language.", + "category": "text-analysis", + "parameters": [ + { + "name": "functionDescription", + "type": "string", + "description": "A natural language description detailing the functionality the desired function should perform.", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language for the generated function code, e.g., 'Python', 'JavaScript'.", + "required": false, + "defaultValue": "Python" + }, + { + "name": "functionName", + "type": "string", + "description": "Optional name for the generated function. If not provided, a suitable name will be inferred.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments inside the generated function code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated function's source code as a string, including the function signature, body, and optional comments." + }, + "aiAgent": { + "useCase": "AI agents can use this tool when they need to dynamically create code functions from natural language specifications, for example, to assist developers by automating function scaffolding, prototyping, or generating utility functions based on user requests or documentation.", + "limitations": "This tool cannot guarantee optimized or production-ready code; it may not handle complex or ambiguous descriptions well and has limited support to error-check or test the generated code.", + "examples": [ + "Generate a Python function named 'calculateSum' that takes a list of numbers and returns their sum.", + "Create a JavaScript function that checks if a string is a palindrome, including comments explaining each step.", + "Build a function that converts Celsius to Fahrenheit, no specific name provided, default language Python." + ] + }, + "tags": [ + "code-generation", + "function-creation", + "natural-language-processing", + "programming", + "automation" + ], + "examples": [ + { + "inputJson": "{\"functionDescription\":\"Create a function that takes a list of numbers and returns their sum.\",\"programmingLanguage\":\"Python\",\"functionName\":\"calculateSum\",\"includeComments\":true}", + "description": "Generate a Python summation function named calculateSum with comments." + }, + { + "inputJson": "{\"functionDescription\":\"Determine if a given string is a palindrome.\",\"programmingLanguage\":\"JavaScript\",\"functionName\":\"isPalindrome\",\"includeComments\":true}", + "description": "Produce a JavaScript function named isPalindrome that checks palindromes with explanatory comments." + }, + { + "inputJson": "{\"functionDescription\":\"Convert temperature in Celsius to Fahrenheit.\",\"programmingLanguage\":\"Python\",\"functionName\":\"\",\"includeComments\":false}", + "description": "Generate a Python function to convert Celsius to Fahrenheit, unnamed with no comments." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "text-analysis.composeDocument", + "description": "This tool accepts structured input including a document title, sections with headings and content, and optional style guidelines. It composes a coherent, well-formatted text document by organizing the sections, ensuring logical flow and readability. The output is a complete text document string ready for use or further processing.", + "category": "text-analysis", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The main title of the document to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "sections", + "type": "array", + "description": "An array of objects each containing a 'heading' (string) and 'content' (string), representing the document sections and their respective texts.", + "required": true, + "defaultValue": "" + }, + { + "name": "styleGuidelines", + "type": "object", + "description": "Optional style guidelines including tone (e.g., formal, informal), formatting preferences (bullets, numbering), and length constraints.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document as a single formatted string under the 'documentText' key." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a multi-section document from structured input, such as reports, articles, or summaries, ensuring good organization, clarity, and adherence to style instructions.", + "limitations": "The tool does not generate original section content; it only organizes and formats provided input. It cannot perform content fact-checking or creative writing beyond the input provided.", + "examples": [ + "Compose a project update document with a title and three sections: summary, progress, next steps.", + "Generate a formal report with specified headings and content following strict style guidelines.", + "Assemble a multi-part article with given headings and detailed content for each section." + ] + }, + "tags": [ + "text-analysis", + "document-composition", + "natural-language-processing", + "report-generation", + "formatting", + "document-assembly" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Quarterly Business Review\",\"sections\":[{\"heading\":\"Executive Summary\",\"content\":\"This quarter showed significant growth in sales.\"},{\"heading\":\"Financial Analysis\",\"content\":\"Revenue increased by 15% compared to the previous quarter.\"},{\"heading\":\"Action Items\",\"content\":\"Focus on expanding marketing efforts in new regions.\"}],\"styleGuidelines\":{\"tone\":\"formal\",\"formatting\":\"numbered sections\"}}", + "description": "Input to create a formal business review document with numbered sections." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "text-analysis.createWord", + "description": "Generates a new word based on specified linguistic roots, prefixes, suffixes, or phonetic patterns. Accepts inputs such as base word fragments, desired word length, language constraints, and parts of speech, then constructs a plausible word combining these elements. Outputs the generated word string along with metadata about its components.", + "category": "text-analysis", + "parameters": [ + { + "name": "baseFragments", + "type": "array", + "description": "Array of string fragments or root words to combine when creating the new word.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "prefixes", + "type": "array", + "description": "Array of string prefixes to optionally prepend to the generated word.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "suffixes", + "type": "array", + "description": "Array of string suffixes to optionally append to the generated word.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetLength", + "type": "number", + "description": "Desired approximate length of the generated word; the tool will try to meet this length if possible.", + "required": false, + "defaultValue": "" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "Intended part of speech for the generated word, e.g., noun, verb, adjective to guide formation.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language or linguistic family to influence phonetic and morphological rules, e.g., 'English', 'Latin'.", + "required": false, + "defaultValue": "English" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word string and details of how it was formed including used fragments and affixes." + }, + "aiAgent": { + "useCase": "This tool is valuable when creating new, plausible words for creative writing, branding, fictional languages, or linguistic research. AI agents can use it to generate novel terms fitting specified linguistic patterns or semantic constraints.", + "limitations": "It cannot guarantee meaningfulness or dictionary-valid words; the output may not be recognized by users as standard vocabulary. It also does not perform semantic validation or ensure usability in real languages.", + "examples": [ + "Generate a new English noun word combining 'tech' and 'logic' with suffix 'al'.", + "Create a short adjective word using latin roots 'lux' (light) with prefix 'in-' meaning not.", + "Form a new verb approximately 7 letters long using fragments 'run' and 'nov'." + ] + }, + "tags": [ + "word-generation", + "creative-writing", + "linguistics", + "natural-language", + "naming", + "morphology" + ], + "examples": [ + { + "inputJson": "{\"baseFragments\":[\"tech\",\"logic\"],\"suffixes\":[\"al\"],\"partOfSpeech\":\"noun\",\"language\":\"English\"}", + "description": "Generate a noun combining 'tech' and 'logic' with suffix 'al' to create a technical-sounding word." + }, + { + "inputJson": "{\"baseFragments\":[\"lux\"],\"prefixes\":[\"in-\"],\"partOfSpeech\":\"adjective\",\"language\":\"Latin\"}", + "description": "Create an adjective with Latin root 'lux' (light) prefixed by 'in-' to mean 'not light' or dark." + }, + { + "inputJson": "{\"baseFragments\":[\"run\",\"nov\"],\"targetLength\":7,\"partOfSpeech\":\"verb\",\"language\":\"English\"}", + "description": "Form a new English verb about 7 letters long combining 'run' and 'nov' fragments." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "text-analysis.createText", + "description": "Generates coherent and contextually relevant natural language text based on a given prompt or set of parameters. It accepts input prompts, tone, style, length, and topic constraints, then produces original text output suitable for content creation, summaries, or creative writing tasks.", + "category": "text-analysis", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "Initial input text or idea to base the generated content on.", + "required": true, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the generated text in number of words.", + "required": false, + "defaultValue": "100" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or mood of the generated text, e.g., formal, casual, professional, humorous.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "style", + "type": "string", + "description": "Writing style to emulate, such as narrative, descriptive, persuasive, or informative.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "topic", + "type": "string", + "description": "Specific topic or subject that the generated text should focus on.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Target language for the generated text (e.g., en, es, fr).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text string with metadata" + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate original, relevant, and stylistically tailored natural language content from a prompt or topic for applications like content creation, automated summaries, personalized messages, or creative writing. It helps bypass writer's block or produce bulk text efficiently.", + "limitations": "Cannot guarantee factual accuracy or creativity beyond the model's knowledge cutoff and training data. May generate generic or repetitive content if parameters are vague or too broad.", + "examples": [ + "Create a professional email draft to respond to a customer complaint.", + "Generate a casual blog post introduction about sustainable living.", + "Write a persuasive product description for a new smartphone." + ] + }, + "tags": [ + "text generation", + "natural language", + "content creation", + "writing assistant", + "NLP", + "creative writing" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"Write a summary of the book '1984' by George Orwell.\",\"length\":150,\"tone\":\"informative\",\"style\":\"summary\",\"topic\":\"1984 book summary\",\"language\":\"en\"}", + "description": "Generate a concise, informative summary of the book '1984'." + }, + { + "inputJson": "{\"prompt\":\"A friendly greeting message for new users of a fitness app.\",\"length\":50,\"tone\":\"casual\",\"style\":\"informative\",\"language\":\"en\"}", + "description": "Create a welcoming and friendly greeting message tailored for new fitness app users." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "text-analysis.createIssue", + "description": "Generates a structured software issue report from natural language input describing the problem, including optional context such as code snippets, error messages, and severity. Processes free text to extract key information and outputs a standardized issue object suitable for tracking and triage.", + "category": "text-analysis", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "A concise, clear title summarizing the issue (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed natural language description of the issue (required)", + "required": true, + "defaultValue": "" + }, + { + "name": "severity", + "type": "string", + "description": "Severity level of the issue (e.g., 'low', 'medium', 'high', 'critical') (optional)", + "required": false, + "defaultValue": "medium" + }, + { + "name": "codeSnippet", + "type": "string", + "description": "Optional snippet of code related to the issue (optional)", + "required": false, + "defaultValue": "" + }, + { + "name": "errorMessage", + "type": "string", + "description": "Optional error message text if available (optional)", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of tags or keywords to categorize the issue (optional)", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created issue with fields: id (string unique identifier), title, description, severity, codeSnippet, errorMessage, tags, createdAt (timestamp)" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to convert free-form textual problem descriptions from users or logs into a structured issue format for bug tracking systems or project management tools. It is especially useful for interpreting natural language inputs and augmenting them with contextual data like code snippets or error messages to create actionable issue reports.", + "limitations": "This tool does not automatically fix issues or perform code analysis. It relies on the quality of input text for accurate extraction and does not assign issue ownership or link to version control.", + "examples": [ + "Create an issue from a user description with error message and severity.", + "Generate a bug report from a developer's explanation and code snippet.", + "Summarize a customer's problem report into a structured issue with tags." + ] + }, + "tags": [ + "issue", + "bug-report", + "text-analysis", + "nlp", + "code", + "software-development" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Null pointer exception in payment processing\",\"description\":\"When attempting to process payment, the application crashes with a null pointer exception. Steps to reproduce: enter card details and submit. The error message displayed is 'NullReferenceException at PaymentProcessor.cs line 45'.\",\"severity\":\"high\",\"codeSnippet\":\"public void ProcessPayment(Card card) { var amount = card.Amount; // line 45 if(card == null) throw new NullReferenceException(); }\",\"errorMessage\":\"NullReferenceException at PaymentProcessor.cs line 45\",\"tags\":[\"bug\",\"payment\",\"crash\"]}", + "description": "Create a detailed issue report from a developer's bug description including code and error." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Issue", + "context": null + } + }, + { + "name": "api-integration.downloadDocument", + "description": "Downloads a document from a specified API endpoint using provided authentication and query parameters. Accepts the document URL, authentication credentials, optional query parameters, and headers. Processes the API request and returns the document content along with metadata such as filename and content type.", + "category": "api-integration", + "parameters": [ + { + "name": "documentUrl", + "type": "string", + "description": "The full URL of the API endpoint to download the document from.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or API key required to authorize the request.", + "required": true, + "defaultValue": "" + }, + { + "name": "queryParams", + "type": "object", + "description": "Optional key-value pairs for URL query parameters to customize the request.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "headers", + "type": "object", + "description": "Optional additional HTTP headers to include in the request.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Timeout in seconds for the download request before failure.", + "required": false, + "defaultValue": "30" + }, + { + "name": "saveToFile", + "type": "boolean", + "description": "Whether to save the downloaded document as a file to local storage.", + "required": false, + "defaultValue": "false" + }, + { + "name": "filePath", + "type": "string", + "description": "If saveToFile is true, the full file path to save the document to.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the document's binary content (base64 encoded), filename, MIME content type, HTTP status code, and a success flag." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to retrieve documents from external APIs that require authentication and optional query customization. It helps automate data extraction from secured or parameterized API endpoints, returning structured content and metadata for further processing or storage.", + "limitations": "This tool does not handle document format conversions, offline file system operations beyond saving, or parsing document contents. It requires a valid API endpoint and valid authentication credentials.", + "examples": [ + "Download a PDF invoice from a billing API using a bearer token.", + "Retrieve a JSON report document from a REST endpoint with query filters.", + "Fetch an image file from an authenticated API and save it locally." + ] + }, + "tags": [ + "api", + "download", + "document", + "authentication", + "http", + "integration" + ], + "examples": [ + { + "inputJson": "{\n \"documentUrl\": \"https://api.example.com/v1/docs/12345/download\",\n \"authToken\": \"Bearer abcdef1234567890\",\n \"queryParams\": {},\n \"headers\": {\"Accept\": \"application/pdf\"},\n \"timeoutSeconds\": 60,\n \"saveToFile\": true,\n \"filePath\": \"/tmp/invoice_12345.pdf\"\n}", + "description": "Download a PDF invoice document with a bearer token, saving it to local path." + }, + { + "inputJson": "{\n \"documentUrl\": \"https://reports.example.com/api/report\",\n \"authToken\": \"ApiKey xyz987654\",\n \"queryParams\": {\"date\": \"2024-06-01\", \"format\": \"json\"},\n \"headers\": {},\n \"timeoutSeconds\": 30,\n \"saveToFile\": false,\n \"filePath\": \"\"\n}", + "description": "Retrieve a JSON formatted report for a specific date without saving to disk." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "Document", + "context": null + } + }, + { + "name": "api-integration.createAPI", + "description": "Creates a new RESTful API configuration by accepting endpoint definitions, HTTP methods, request/response schemas, authentication, and other settings; it then generates an API specification and optionally deploys it to a target environment, returning a summary and access details.", + "category": "api-integration", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "The name of the API to create, used for identification and documentation.", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "The version number or identifier of the API, e.g., 'v1'.", + "required": false, + "defaultValue": "\"v1\"" + }, + { + "name": "basePath", + "type": "string", + "description": "The base URL path prefix for the API endpoints, e.g., '/api'.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "An array of endpoint definitions, each including path, HTTP method, request/response schema, and descriptions.", + "required": true, + "defaultValue": "" + }, + { + "name": "authentication", + "type": "object", + "description": "Authentication configuration object specifying the auth type and credentials or tokens.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "deploy", + "type": "boolean", + "description": "Flag indicating whether to deploy the API automatically after creation.", + "required": false, + "defaultValue": "false" + }, + { + "name": "targetEnvironment", + "type": "string", + "description": "The target environment for deployment like 'staging' or 'production'.", + "required": false, + "defaultValue": "\"staging\"" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the created API's unique identifier, summarized configuration, deployment status, and access URLs if deployed." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and optionally deploy new RESTful APIs by specifying endpoints, request methods, data schemas, and authentication, enabling integration platforms or dev automation pipelines to generate APIs without manual coding. It is ideal for dynamic API generation based on user requirements or metadata.", + "limitations": "This tool does not handle API runtime execution, scaling, or monitoring. It cannot create non-RESTful APIs or automatically generate backend logic for endpoints beyond the specification.", + "examples": [ + "Create a versioned API named 'InventoryService' with CRUD endpoints for inventory items.", + "Create a simple API with authentication for accessing user profile data.", + "Automatically deploy a new payment processing API to the production environment with specified endpoints." + ] + }, + "tags": [ + "api", + "integration", + "automation", + "deployment", + "rest", + "configuration", + "authentication" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"InventoryService\",\"version\":\"v1\",\"basePath\":\"/inventory\",\"endpoints\":[{\"path\":\"/items\",\"method\":\"GET\",\"requestSchema\":{},\"responseSchema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"quantity\":{\"type\":\"number\"}}}},\"description\":\"List all inventory items\"},{\"path\":\"/items\",\"method\":\"POST\",\"requestSchema\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"quantity\":{\"type\":\"number\"}},\"required\":[\"name\",\"quantity\"]},\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"}}},\"description\":\"Create a new inventory item\"}],\"authentication\":{\"type\":\"apiKey\",\"in\":\"header\",\"name\":\"X-API-Key\"},\"deploy\":true,\"targetEnvironment\":\"staging\"}", + "description": "Defines a versioned InventoryService API with GET and POST endpoints for items, includes API key authentication, and deploys to staging." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "agent-management.analyzeLead", + "description": "Analyzes a business lead profile by assessing attributes such as contact information, company data, engagement level, and potential deal size. Processes structured lead data to produce a detailed analysis report indicating lead quality, sales readiness, and recommended next steps for engagement.", + "category": "agent-management", + "parameters": [ + { + "name": "leadData", + "type": "object", + "description": "Structured object containing lead details including contact info, company profile, interaction history, and any sales notes.", + "required": true, + "defaultValue": "" + }, + { + "name": "engagementThreshold", + "type": "number", + "description": "Minimum engagement score to consider a lead sales-ready (range 0-100).", + "required": false, + "defaultValue": "70" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include personalized next step recommendations based on lead analysis.", + "required": false, + "defaultValue": "true" + }, + { + "name": "priorityRegions", + "type": "array", + "description": "List of geographic regions to prioritize in assessing market potential for the lead's company.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An analysis report containing the lead score, readiness status, potential deal size estimate, and optionally recommendations for sales follow-up." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to evaluate potential sales leads to prioritize outreach efforts by assessing lead quality and readiness based on multiple business and engagement factors. Suitable for CRM optimizations and automated sales workflows.", + "limitations": "This tool cannot access or update live CRM databases; accuracy depends on completeness of input lead data. It does not perform direct contact or outreach actions.", + "examples": [ + "Analyze this lead's potential based on their company size and recent engagement.", + "Evaluate if this lead is ready for a sales call and suggest next steps.", + "Score multiple leads to prioritize high-value opportunities." + ] + }, + "tags": [ + "lead analysis", + "sales", + "crm", + "business intelligence", + "agent management" + ], + "examples": [ + { + "inputJson": "{\"leadData\":{\"contactName\":\"Jane Doe\",\"email\":\"jane.doe@example.com\",\"companyName\":\"Tech Innovators Inc.\",\"industry\":\"Software\",\"companySize\":250,\"lastEngagementScore\":85,\"notes\":\"Interested in enterprise solution\"},\"engagementThreshold\":75,\"includeRecommendations\":true,\"priorityRegions\":[\"North America\"]}", + "description": "Analyzing a technology sector lead with high engagement score and relevant company size, requesting recommendations for next sales steps." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Lead", + "context": null + } + }, + { + "name": "agent-management.generateSummary", + "description": "Generates a concise summary from a provided document or text input. Accepts raw text or document content in string format, processes it to extract key points and themes, and outputs a well-structured summary that highlights main ideas while preserving context.", + "category": "agent-management", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "The full text content of the document to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "Maximum length of the summary in characters; if omitted, a default length is used.", + "required": false, + "defaultValue": "500" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text (e.g., 'en' for English); influences summary quality.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeHighlights", + "type": "boolean", + "description": "Whether to include key bullet points as highlights in addition to summary paragraphs.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the summary text and optionally an array of highlight points if requested." + }, + "aiAgent": { + "useCase": "Use this tool when needing a quick concise overview of lengthy documents, reports, or articles to aid rapid understanding or decision-making. Ideal for agents that handle information synthesis or briefings.", + "limitations": "Cannot generate summaries for non-text content such as raw images or audio. Output quality may vary with very short or highly technical texts.", + "examples": [ + "Summarize a 10-page project report to highlight key outcomes.", + "Generate a brief synopsis of a long article to share with stakeholders.", + "Produce main bullet points from meeting notes for quick review." + ] + }, + "tags": [ + "summary", + "document", + "text-processing", + "agent-management", + "information-synthesis" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"This document outlines the project objectives, timelines, and resource allocations. The primary goal is to enhance system performance by 20%. Key milestones include feature development, testing phases, and deployment within six months.\",\"maxSummaryLength\":300,\"includeHighlights\":true}", + "description": "Summarize a project overview document highlighting goals and milestones." + }, + { + "inputJson": "{\"documentText\":\"Recent quarterly financial results show a 5% increase in revenue while operating expenses decreased by 3%. Strategic investments in marketing contributed to better customer acquisition.\",\"maxSummaryLength\":200}", + "description": "Generate a brief financial summary focusing on recent quarterly performance." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "prompt-engineering.uploadDocument", + "description": "Uploads a document to a prompt engineering system to be used as context or reference for AI prompt crafting. Accepts document content or file URL, assigns metadata such as document name and type, and returns a confirmation with document ID and status.", + "category": "prompt-engineering", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "The full text content of the document to upload. Required if fileUrl is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileUrl", + "type": "string", + "description": "URL to the document file to be fetched and uploaded. Required if documentContent is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "documentName", + "type": "string", + "description": "A user-defined name or title for the document for identification.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentType", + "type": "string", + "description": "The type or format of the document (e.g., 'text', 'pdf', 'markdown').", + "required": false, + "defaultValue": "text" + }, + { + "name": "tags", + "type": "array", + "description": "An array of strings serving as tags or categories for grouping or searching the document.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Whether to overwrite an existing document with the same name if found.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the unique document ID, upload status, and message describing the result of the upload." + }, + "aiAgent": { + "useCase": "Use this tool when needing to add external textual documents to the AI prompt environment for informed prompt crafting, context incorporation, or reference during generation tasks. Ideal for feeding manuals, knowledge bases, or reference texts to enhance AI understanding.", + "limitations": "This tool does not analyze document content or perform any transformation beyond uploading. It requires either direct text or accessible file URLs. Does not support binary file uploads directly. Overwrite is limited to documents with matching names.", + "examples": [ + "Upload a product manual document text to be used as context in prompt construction.", + "Add a PDF knowledge base via URL for AI to reference when generating answers.", + "Update an existing specification document by overwriting its previous version." + ] + }, + "tags": [ + "upload", + "document", + "prompt-engineering", + "context", + "reference", + "AI", + "text" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"This is a troubleshooting guide for the X100 printer.\",\"documentName\":\"X100 Printer Manual\",\"documentType\":\"text\",\"tags\":[\"printer\",\"manual\",\"troubleshooting\"],\"overwriteExisting\":false}", + "description": "Upload a plain text troubleshooting guide document with tags." + }, + { + "inputJson": "{\"fileUrl\":\"https://example.com/docs/api-reference.pdf\",\"documentName\":\"API Reference\",\"documentType\":\"pdf\",\"tags\":[\"api\",\"reference\"],\"overwriteExisting\":false}", + "description": "Upload a PDF document from a file URL for API reference." + }, + { + "inputJson": "{\"documentContent\":\"Updated spec for project timeline.\",\"documentName\":\"Project Timeline Spec\",\"documentType\":\"text\",\"tags\":[\"specification\",\"project\"],\"overwriteExisting\":true}", + "description": "Overwrite an existing document named 'Project Timeline Spec' with new content." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "prompt-engineering.buildFunction", + "description": "This tool accepts a natural language description of a desired AI prompt function, analyzes the intent and parameters, and generates a reusable JavaScript function that encapsulates the prompt construction logic. It processes input parameters and outputs well-structured, customizable prompt functions to integrate into prompt engineering workflows.", + "category": "prompt-engineering", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "Name of the JavaScript function to generate, following camelCase conventions.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Natural language description detailing what the prompt function should do.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputParameters", + "type": "array", + "description": "An array of objects describing each input parameter's name and type for the generated function.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "returnType", + "type": "string", + "description": "Expected return type of the function, typically 'string' for prompt output.", + "required": false, + "defaultValue": "string" + }, + { + "name": "includeComments", + "type": "boolean", + "description": "Whether to include explanatory comments in the generated function code.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated JavaScript function code as a string under 'code' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to formalize prompt crafting into reusable code functions for dynamic prompt generation in applications or AI workflows, enabling parameterized prompt templates. It helps automate prompt engineering by generating clean, maintainable functions from natural language intent descriptions.", + "limitations": "It cannot generate executable code for prompt APIs beyond string-based prompt construction or understand very ambiguous or incomplete descriptions. It assumes JavaScript output and does not test the generated code in runtime environments.", + "examples": [ + "Generate a function named 'createSummaryPrompt' that accepts 'text' and 'length' and returns a summary prompt string.", + "Build a prompt function named 'generateQueryPrompt' taking a 'query' and 'filters' to create a refined search prompt.", + "Create a prompt function 'composeEmail' with parameters 'recipientName' and 'topic' that returns a personalized email prompt." + ] + }, + "tags": [ + "prompt-engineering", + "code-generation", + "javascript", + "function-builder", + "ai-prompt", + "automation" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"createSummaryPrompt\",\"description\":\"Generates a prompt to summarize given text to a specified length.\",\"inputParameters\":[{\"name\":\"text\",\"type\":\"string\"},{\"name\":\"length\",\"type\":\"number\"}],\"returnType\":\"string\",\"includeComments\":true}", + "description": "Build function to summarize text with specified length" + }, + { + "inputJson": "{\"functionName\":\"generateQueryPrompt\",\"description\":\"Constructs a search query prompt incorporating user query and optional filters.\",\"inputParameters\":[{\"name\":\"query\",\"type\":\"string\"},{\"name\":\"filters\",\"type\":\"object\"}],\"returnType\":\"string\",\"includeComments\":false}", + "description": "Generate search query prompt function" + }, + { + "inputJson": "{\"functionName\":\"composeEmail\",\"description\":\"Creates an email prompt personalized with recipient name and topic.\",\"inputParameters\":[{\"name\":\"recipientName\",\"type\":\"string\"},{\"name\":\"topic\",\"type\":\"string\"}],\"returnType\":\"string\",\"includeComments\":true}", + "description": "Generate personalized email prompt function" + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "model-management.analyzeMetric", + "description": "Analyzes a specified performance metric of a trained AI model on a given dataset by computing statistical summaries, trends, and comparisons over time or between different model versions. Accepts model identifier, metric type, dataset, and optional filters, outputting detailed analytic results to support performance evaluation and monitoring.", + "category": "model-management", + "parameters": [ + { + "name": "modelId", + "type": "string", + "description": "Unique identifier of the AI model to analyze metrics for.", + "required": true, + "defaultValue": "" + }, + { + "name": "metricName", + "type": "string", + "description": "Name of the performance metric to analyze (e.g., accuracy, precision, loss).", + "required": true, + "defaultValue": "" + }, + { + "name": "datasetId", + "type": "string", + "description": "Identifier of the dataset on which the metric was evaluated.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeRange", + "type": "object", + "description": "Optional start and end timestamps to filter metric data for time-based analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "compareModelIds", + "type": "array", + "description": "Optional array of other model IDs to compare the metric against.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "granularity", + "type": "string", + "description": "Aggregation level for metric analysis such as 'daily', 'weekly', or 'monthly'.", + "required": false, + "defaultValue": "daily" + } + ], + "returns": { + "type": "object", + "description": "An object containing summary statistics (mean, median, variance), trend analysis, and comparison charts or tables of the selected metric over the specified parameters." + }, + "aiAgent": { + "useCase": "Use this tool when evaluating a specific model's performance using a particular metric on a dataset, especially for monitoring changes over time or comparing multiple model versions. Ideal for assessing model quality, detecting performance degradation, or reporting analytics in deployment pipelines.", + "limitations": "Does not retrain models or interpret causal reasons behind metric changes. Requires prior availability of metric data from evaluations; it cannot generate raw predictions or metrics from scratch.", + "examples": [ + "Analyze the accuracy trend of model ID 'model123' on the 'validationSet' dataset over the last month.", + "Compare the precision metric of model 'model123' vs 'model456' on the 'testSet' dataset.", + "Get a weekly summary of the loss metric for model 'model789' on dataset 'productionRollout'." + ] + }, + "tags": [ + "model-management", + "performance-analysis", + "metric-analysis", + "evaluation", + "AI-model", + "analytics", + "monitoring" + ], + "examples": [ + { + "inputJson": "{\"modelId\":\"model123\",\"metricName\":\"accuracy\",\"datasetId\":\"validationSet\",\"timeRange\":{\"start\":\"2024-01-01T00:00:00Z\",\"end\":\"2024-01-31T23:59:59Z\"},\"granularity\":\"daily\"}", + "description": "Analyze daily accuracy metric of model123 on the validationSet dataset during January 2024." + }, + { + "inputJson": "{\"modelId\":\"model123\",\"metricName\":\"precision\",\"datasetId\":\"testSet\",\"compareModelIds\":[\"model456\",\"model789\"],\"granularity\":\"weekly\"}", + "description": "Compare weekly precision metric of three models on the testSet dataset." + }, + { + "inputJson": "{\"modelId\":\"model789\",\"metricName\":\"loss\",\"datasetId\":\"productionRollout\",\"timeRange\":{\"start\":\"2024-05-01T00:00:00Z\",\"end\":\"2024-05-15T23:59:59Z\"}}", + "description": "Get half-month loss metric summary for model789 on the production rollout dataset." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Metric", + "context": null + } + }, + { + "name": "model-management.draftEmail", + "description": "This tool accepts inputs describing the email purpose, recipient details, key points to include, tone, and optional signature. It processes these inputs to generate a coherent, professional draft email text suitable for business or technical communication. The output is a formatted email string ready for review or sending.", + "category": "model-management", + "parameters": [ + { + "name": "recipientName", + "type": "string", + "description": "Name of the email recipient to personalize the greeting.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipientEmail", + "type": "string", + "description": "Email address of the recipient; used for addressing or context.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "purpose", + "type": "string", + "description": "Brief description of the email purpose or intent (e.g., meeting request, update, follow-up).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of main points or information that must be included in the email body.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the email such as formal, casual, persuasive, or neutral.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "signature", + "type": "string", + "description": "Optional sender's signature line or closing remarks.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the complete drafted email text with subject, greeting, body, and signature formatted as a string under the 'emailText' key." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a professional and contextually appropriate draft email based on structured input about recipients, purpose, and message details. It helps automate routine communication drafting to enhance productivity and maintain tone consistency.", + "limitations": "This tool cannot send emails or handle attachments. It generates text only and cannot verify the correctness of contact information or ensure compliance with specific organizational policies.", + "examples": [ + "Draft an email to a client summarizing the project status and next steps with a formal tone.", + "Create a casual follow-up email to a colleague to remind about an upcoming deadline.", + "Generate a persuasive email inviting stakeholders to an important meeting with key agenda points." + ] + }, + "tags": [ + "email", + "drafting", + "communication", + "business", + "automation", + "model-management" + ], + "examples": [ + { + "inputJson": "{\"recipientName\":\"Alice Johnson\",\"recipientEmail\":\"alice.johnson@example.com\",\"subject\":\"Project Update and Next Steps\",\"purpose\":\"Provide status update and outline next steps for the project\",\"keyPoints\":[\"Project is 75% complete\",\"Testing phase starts next week\",\"Need client feedback on deliverables\"],\"tone\":\"formal\",\"signature\":\"Best regards, John Smith\"}", + "description": "Draft a formal project update email to a client with key project milestones and requests for feedback." + }, + { + "inputJson": "{\"recipientName\":\"Bob\",\"recipientEmail\":\"bob@example.com\",\"subject\":\"Reminder: Report Submission\",\"purpose\":\"Gently remind about upcoming report submission deadline\",\"keyPoints\":[\"Deadline is Friday\",\"Please send the draft by Wednesday for review\"],\"tone\":\"casual\",\"signature\":\"Thanks, Sarah\"}", + "description": "Create a casual reminder email to a coworker about an approaching deadline and draft submission." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Email", + "context": null + } + }, + { + "name": "model-management.draftDocument", + "description": "This tool generates a structured draft document for AI model management purposes based on user inputs such as model type, purpose, specifications, and deployment considerations. It produces a detailed text document draft that outlines the model's overview, architecture, training procedure, evaluation metrics, and deployment plan.", + "category": "model-management", + "parameters": [ + { + "name": "modelName", + "type": "string", + "description": "The name or identifier of the AI model to document.", + "required": true, + "defaultValue": "" + }, + { + "name": "modelType", + "type": "string", + "description": "Type or category of the AI model (e.g., classification, regression, NLP, vision).", + "required": true, + "defaultValue": "" + }, + { + "name": "modelPurpose", + "type": "string", + "description": "The primary purpose or application domain of the model (e.g., fraud detection, image recognition).", + "required": true, + "defaultValue": "" + }, + { + "name": "architectureDetails", + "type": "string", + "description": "A description of the model architecture including key components and layers.", + "required": false, + "defaultValue": "" + }, + { + "name": "trainingDataDescription", + "type": "string", + "description": "Details about the training dataset including source, size, and preprocessing steps.", + "required": false, + "defaultValue": "" + }, + { + "name": "evaluationMetrics", + "type": "array", + "description": "List of evaluation metrics used to assess model performance (e.g., accuracy, F1 score).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "deploymentStrategy", + "type": "string", + "description": "Description of how the model will be deployed in production environments.", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalNotes", + "type": "string", + "description": "Any additional information or considerations to include in the document.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing a complete draft of the model management document as a string under the key 'documentDraft'." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a comprehensive draft document outlining an AI model's specifications, training, evaluation, and deployment plan to aid in documentation, compliance, or knowledge transfer processes.", + "limitations": "This tool generates a draft text document and does not perform validation of the model specifications or guarantee compliance with industry regulations. It relies on the input quality and completeness.", + "examples": [ + "Generate a draft document for a convolutional neural network model used for medical image classification.", + "Create a draft document describing a fraud detection model including training data and deployment strategy.", + "Draft a document for an NLP sentiment analysis model focusing on architecture and evaluation metrics." + ] + }, + "tags": [ + "model management", + "documentation", + "drafting", + "AI model", + "deployment", + "training", + "evaluation" + ], + "examples": [ + { + "inputJson": "{\"modelName\":\"MedImgCNN\",\"modelType\":\"CNN\",\"modelPurpose\":\"Medical image classification\",\"architectureDetails\":\"3 convolutional layers followed by 2 dense layers\",\"trainingDataDescription\":\"Dataset of 50,000 labeled X-ray images with preprocessing including normalization and augmentation\",\"evaluationMetrics\":[\"accuracy\",\"recall\"],\"deploymentStrategy\":\"Deployed as a REST API on AWS Lambda\",\"additionalNotes\":\"Model retraining every 6 months.\"}", + "description": "Draft document for a CNN model used in medical imaging including all key sections." + }, + { + "inputJson": "{\"modelName\":\"FraudDetectV2\",\"modelType\":\"Random Forest\",\"modelPurpose\":\"Credit card fraud detection\",\"architectureDetails\":\"Ensemble of 100 decision trees\",\"trainingDataDescription\":\"Transaction dataset with 1 million records, balanced classes\",\"evaluationMetrics\":[\"precision\",\"recall\",\"F1 score\"],\"deploymentStrategy\":\"Real-time processing integrated with payment gateway\",\"additionalNotes\":\"Includes feature importance analysis.\"}", + "description": "Generate document draft for a fraud detection model with emphasis on deployment and evaluation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "draft", + "object": "Document", + "context": null + } + }, + { + "name": "model-management.generateParagraph", + "description": "Generates a coherent paragraph of text based on a given prompt, desired length, and optional tone. Accepts a text prompt and parameters to control style and length, then uses a text generation model to produce a relevant paragraph as output.", + "category": "model-management", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "Initial text prompt to base the paragraph generation on.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words in the generated paragraph.", + "required": false, + "defaultValue": "100" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone or style of the paragraph, e.g., formal, casual, technical.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "includeKeywords", + "type": "array", + "description": "Optional list of keywords to try to include in the paragraph to emphasize relevance.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "temperature", + "type": "number", + "description": "Controls randomness of generation; 0 is most deterministic, 1 is more creative.", + "required": false, + "defaultValue": "0.7" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated paragraph text as a string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a paragraph of text related to a specific topic or prompt for applications such as report summaries, content generation, or example text. This can assist in automating content creation workflows that require coherent and contextually relevant paragraphs.", + "limitations": "The tool cannot guarantee factual accuracy or original thought. It may generate irrelevant or off-topic content if the prompt is vague or if contradictory parameters are provided.", + "examples": [ + "Generate a formal paragraph about the importance of cybersecurity.", + "Create a casual paragraph describing benefits of electric vehicles including keywords 'environment' and 'efficiency'.", + "Produce a technical paragraph on AI model deployment with maximum 80 words." + ] + }, + "tags": [ + "text-generation", + "content-creation", + "paragraph", + "AI-model", + "writing" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"The impact of climate change on agriculture\",\"maxLength\":80,\"tone\":\"formal\",\"includeKeywords\":[\"sustainability\",\"crop yield\"],\"temperature\":0.6}", + "description": "Generate a formal paragraph about climate change impacts on agriculture including sustainability and crop yield keywords." + }, + { + "inputJson": "{\"prompt\":\"How to prepare for a job interview\",\"maxLength\":100,\"tone\":\"casual\",\"includeKeywords\":[],\"temperature\":0.8}", + "description": "Generate a casual paragraph giving tips on job interview preparation." + }, + { + "inputJson": "{\"prompt\":\"Explain the concept of neural networks\",\"maxLength\":90,\"tone\":\"technical\",\"includeKeywords\":[\"layers\",\"weights\"],\"temperature\":0.5}", + "description": "Generate a technical paragraph explaining neural networks with emphasis on layers and weights." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "model-management.generateSentence", + "description": "Generates a coherent and contextually relevant sentence based on specified input parameters, such as desired length, tone, and topic keywords. Accepts optional parameters to tailor sentence style and complexity, then outputs a single generated sentence string ready for use in AI model testing or content creation.", + "category": "model-management", + "parameters": [ + { + "name": "topicKeywords", + "type": "array", + "description": "List of keywords or phrases to be incorporated into the generated sentence to guide content focus.", + "required": false, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Specifies the tone of the sentence, e.g., formal, informal, humorous, or neutral, affecting style and word choice.", + "required": false, + "defaultValue": "\"neutral\"" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the sentence in words. The tool will aim to generate a sentence close to this length.", + "required": false, + "defaultValue": "20" + }, + { + "name": "complexity", + "type": "string", + "description": "Controls the sentence complexity, e.g., simple, moderate, or complex sentence structures.", + "required": false, + "defaultValue": "\"moderate\"" + }, + { + "name": "language", + "type": "string", + "description": "The language in which to generate the sentence, specified by ISO language codes (e.g., 'en' for English).", + "required": false, + "defaultValue": "\"en\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence as a string." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to create realistic sentences with customizable attributes for testing, training, or content generation. It helps produce sentences tailored by tone, length, topic keywords, or complexity to fit specific scenarios or datasets.", + "limitations": "It cannot generate multiple sentences or paragraphs in a single call, nor does it provide highly nuanced emotional subtleties beyond preset tone categories. It is limited to single sentences and may not accurately reflect complex semantic nuances for very specialized domains.", + "examples": [ + "Generate a humorous sentence about technology around 15 words.", + "Create a formal sentence using the keywords 'finance' and 'investment' approximately 25 words long.", + "Produce a simple, neutral sentence in Spanish about travel with length near 10 words." + ] + }, + "tags": [ + "generation", + "sentence", + "language-model", + "content-creation", + "text-generation", + "customization" + ], + "examples": [ + { + "inputJson": "{\"topicKeywords\":[\"technology\",\"innovation\"],\"tone\":\"humorous\",\"length\":15,\"complexity\":\"moderate\",\"language\":\"en\"}", + "description": "Generate a humorous sentence about technology with approximately 15 words." + }, + { + "inputJson": "{\"topicKeywords\":[\"finance\",\"investment\"],\"tone\":\"formal\",\"length\":25,\"complexity\":\"complex\",\"language\":\"en\"}", + "description": "Generate a formal and complex sentence involving finance and investment with about 25 words." + }, + { + "inputJson": "{\"topicKeywords\":[\"viaje\"],\"tone\":\"neutral\",\"length\":10,\"complexity\":\"simple\",\"language\":\"es\"}", + "description": "Generate a simple neutral sentence in Spanish about travel with around 10 words." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Sentence", + "context": null + } + }, + { + "name": "model-management.generateSummary", + "description": "Generates a concise, coherent summary of a document based on provided text input. Accepts raw document text or extracted content, processes it using natural language understanding techniques to produce a shorter version that retains key information, suitable for quick review or metadata generation.", + "category": "model-management", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "The raw text content of the document to summarize.", + "required": true, + "defaultValue": "" + }, + { + "name": "maxSummaryLength", + "type": "number", + "description": "The maximum length of the summary in number of words or characters, depending on the summarization mode.", + "required": false, + "defaultValue": "200" + }, + { + "name": "summaryType", + "type": "string", + "description": "Type of summarization to perform: 'extractive' (select sentences from original) or 'abstractive' (generate new text).", + "required": false, + "defaultValue": "abstractive" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input document text (e.g., 'en' for English) to optimize processing.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyPhrases", + "type": "boolean", + "description": "Whether to extract and return key phrases or keywords alongside the summary.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summary text and optionally key phrases or other metadata." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to create a readable and concise summary from large document texts to facilitate understanding or generate abstracts for reports, databases, or user interfaces. It is useful for streamlining information consumption or metadata creation.", + "limitations": "The tool cannot interpret images, tables, or non-text content within documents. Very short texts might produce trivial summaries. Summary quality depends on input clarity and summarization type selected.", + "examples": [ + "Generate a brief summary of a legal contract to highlight main obligations.", + "Create an executive summary for a technical report in English, limited to 150 words.", + "Extract key phrases and a summary from a research article for indexing." + ] + }, + "tags": [ + "summarization", + "document", + "NLP", + "text-processing", + "metadata", + "model-management" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"The Q3 financial report shows significant growth in revenue with a 15% increase over the previous quarter, driven primarily by the new product launch...\",\"maxSummaryLength\":100,\"summaryType\":\"abstractive\",\"language\":\"en\",\"includeKeyPhrases\":true}", + "description": "Summarize a quarterly financial report to produce a concise overview with key phrases." + }, + { + "inputJson": "{\"documentText\":\"In this study, we explore the effects of climate change on ocean temperatures and marine biodiversity. Our results indicate a steady increase in surface temperatures...\",\"maxSummaryLength\":150,\"summaryType\":\"extractive\",\"language\":\"en\",\"includeKeyPhrases\":false}", + "description": "Create an extractive summary of a scientific article in English." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "model-management.createParagraph", + "description": "Generates a coherent paragraph of text based on a given prompt, tone, and desired length. The tool accepts text input parameters defining the topic or seed content, the intended style or tone, and a target word count. It processes these inputs using a language model to produce a natural language paragraph suitable for content generation, documentation, or creative writing tasks.", + "category": "model-management", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "Initial text or topic seed to base the paragraph content on.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Style or tone of the paragraph, e.g., formal, casual, informative, persuasive.", + "required": false, + "defaultValue": "informative" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of words in the generated paragraph.", + "required": false, + "defaultValue": "100" + }, + { + "name": "temperature", + "type": "number", + "description": "Sampling temperature for text generation; controls creativity (0.0-1.0).", + "required": false, + "defaultValue": "0.7" + } + ], + "returns": { + "type": "object", + "description": "Object containing the generated paragraph as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to automatically generate a paragraph of coherent, contextually relevant text from a brief prompt, maintaining a specified tone and length. Useful in scenarios such as drafting content for documentation, marketing materials, or writing assistance.", + "limitations": "Cannot guarantee factual accuracy or originality; may produce generic or repetitive content. Paragraph length is approximate. Does not perform detailed topic research or fact verification.", + "examples": [ + "Generate a formal paragraph about the importance of data privacy.", + "Create a casual paragraph summarizing the features of a new product.", + "Write an informative paragraph explaining the basics of machine learning." + ] + }, + "tags": [ + "generation", + "text", + "paragraph", + "content creation", + "NLP", + "writing assistance" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"The impact of climate change on agriculture\",\"tone\":\"informative\",\"maxLength\":80,\"temperature\":0.6}", + "description": "Generate an informative paragraph about climate change effects on farming." + }, + { + "inputJson": "{\"prompt\":\"Launching our new smartphone model\",\"tone\":\"persuasive\",\"maxLength\":100,\"temperature\":0.8}", + "description": "Create a persuasive paragraph promoting a new phone." + }, + { + "inputJson": "{\"prompt\":\"Benefits of mindfulness meditation\",\"tone\":\"casual\",\"maxLength\":70,\"temperature\":0.7}", + "description": "Generate a casual paragraph about mindfulness meditation benefits." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Paragraph", + "context": null + } + }, + { + "name": "model-management.createSummary", + "description": "This tool accepts raw document text or a document object as input and generates a concise, coherent summary capturing the key points. It uses NLP techniques optimized for document content to produce a readable summary string, suitable for quick content review or integration into downstream AI model pipelines.", + "category": "model-management", + "parameters": [ + { + "name": "documentText", + "type": "string", + "description": "Raw text content of the document to summarize.", + "required": false, + "defaultValue": "" + }, + { + "name": "documentObject", + "type": "object", + "description": "Structured document input with metadata and text fields (e.g., {title, content}). If provided, text is extracted internally for summarization.", + "required": false, + "defaultValue": "" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate maximum number of sentences desired in the summary.", + "required": false, + "defaultValue": "3" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en' for English) of the input document to guide summarization.", + "required": false, + "defaultValue": "en" + }, + { + "name": "includeKeyPhrases", + "type": "boolean", + "description": "If true, include extracted key phrases alongside the summary in the output.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the summary text and optionally key phrases extracted from the document. Structure: {summary: string, keyPhrases?: array of strings}" + }, + "aiAgent": { + "useCase": "Use this tool when you have extensive document content that needs condensing for faster human reading or subsequent AI processing, e.g., generating executive summaries from reports, legal documents, research papers, or long articles. It allows quick content understanding without reading full text.", + "limitations": "The tool may not capture all nuanced details; it assumes input is reasonably coherent text. It does not perform in-depth semantic analysis or fact-checking. Extremely short or highly technical texts may not summarize effectively.", + "examples": [ + "Generate a 3-sentence summary from a lengthy annual report document.", + "Create a summary and extract key phrases from research paper content for indexing.", + "Summarize a user manual text in Spanish with 5 sentences." + ] + }, + "tags": [ + "summarization", + "document", + "nlp", + "text-processing", + "model-management", + "content", + "ai" + ], + "examples": [ + { + "inputJson": "{\"documentText\":\"In this annual report, we detail the company performance in 2023, highlighting revenue growth of 15%, expansion into three new markets, and the successful launch of two new product lines. Challenges included supply chain disruptions and increased competition in Europe. Our sustainability initiatives reduced carbon footprint by 20%.\"}", + "description": "Summarize a business annual report text to key points." + }, + { + "inputJson": "{\"documentObject\":{\"title\":\"Advances in Renewable Energy\",\"author\":\"Dr. Smith\",\"content\":\"Renewable energy technologies have seen significant improvements in efficiency and cost-effectiveness over the last decade...\"},\"summaryLength\":4,\"includeKeyPhrases\":true}", + "description": "Summarize an academic paper excerpt and include key phrases." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Summary", + "context": null + } + }, + { + "name": "file-operations.generateDocument", + "description": "Generates a text-based document file (such as .txt, .md, or .html) from provided content and formatting options. Accepts input content as a string or array of strings, applies optional title, footer, and basic formatting, and outputs the completed document as a base64-encoded string along with metadata like file name and mime type.", + "category": "file-operations", + "parameters": [ + { + "name": "content", + "type": "string", + "description": "Main textual content of the document to be included; supports plain text or simple markdown.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Name of the output document file including extension (e.g., 'report.md', 'notes.txt').", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Optional title to appear at the top of the document.", + "required": false, + "defaultValue": "" + }, + { + "name": "footer", + "type": "string", + "description": "Optional footer text to append at the end of the document.", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Output document format specifying flavor or markup (allowed: 'txt', 'md', 'html'). Defaults to 'txt'.", + "required": false, + "defaultValue": "txt" + }, + { + "name": "includeDate", + "type": "boolean", + "description": "If true, inserts the current date below the title or at the top if no title is provided.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing the base64-encoded document content, the file name, and the MIME type corresponding to the document format." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create a new textual document file from raw content inputs, optionally formatted with title, footer, and simple markup format, suitable for saving or transmission as a standalone file.", + "limitations": "This tool does not support complex formatting, images, or advanced document types like PDFs or Word documents. It only outputs basic text-based formats and does not edit existing documents.", + "examples": [ + "Generate a markdown README file from provided project description and section headings.", + "Create a plain text log file with a header title and appended timestamp footer.", + "Produce a small HTML snippet document with a title and content for email or webpage embedding." + ] + }, + "tags": [ + "file", + "document", + "generate", + "text", + "markdown", + "html", + "plain-text" + ], + "examples": [ + { + "inputJson": "{\"content\":\"# Project Documentation\\nThis project is designed to demonstrate document generation.\",\"fileName\":\"README.md\",\"title\":\"Project Documentation\",\"format\":\"md\",\"includeDate\":true}", + "description": "Generate a markdown README file with a title and current date included." + }, + { + "inputJson": "{\"content\":\"Error Log Entry 2024/06/01:\\nSystem rebooted unexpectedly.\",\"fileName\":\"error_log.txt\",\"format\":\"txt\",\"footer\":\"End of Log\"}", + "description": "Create a plain text error log file with footer appended." + }, + { + "inputJson": "{\"content\":\"Welcome to our site!
\",\"fileName\":\"welcome.html\",\"format\":\"html\",\"title\":\"Welcome Email\"}", + "description": "Produce a simple HTML document with a title and paragraph content." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "file-operations.createFile", + "description": "Creates a new file at a specified path with given content and optional encoding. Accepts file path, content as a string, encoding type (e.g., utf-8, ascii), and an overwrite flag. Outputs confirmation of creation and full file metadata including size and timestamps.", + "category": "file-operations", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "The complete path where the new file will be created, including filename and extension.", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "The text content to write into the new file.", + "required": true, + "defaultValue": "" + }, + { + "name": "encoding", + "type": "string", + "description": "The text encoding to use for the file content; defaults to utf-8.", + "required": false, + "defaultValue": "utf-8" + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite the file if it already exists at the path.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing confirmation of creation, the absolute file path, file size in bytes, creation and modification timestamps." + }, + "aiAgent": { + "useCase": "Use this tool when the agent needs to create new text files programmatically, such as saving logs, generating reports, or exporting data. It ensures controlled creation with options to set encoding and avoid overwriting existing files unless explicitly allowed.", + "limitations": "Cannot create files with non-text binary content without encoding translation. Does not support directory creation; the target directory must exist beforehand.", + "examples": [ + "Create a log file at /var/logs/app.log with UTF-8 encoding and allow overwriting.", + "Generate a new text report at C:/reports/daily.txt without overwriting if it exists.", + "Create a configuration file at ./config/settings.json with UTF-8 encoding." + ] + }, + "tags": [ + "file", + "create", + "text", + "encoding", + "filesystem", + "write", + "file management" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/tmp/example.txt\",\"content\":\"Hello, world!\",\"encoding\":\"utf-8\",\"overwrite\":true}", + "description": "Create a UTF-8 encoded text file at /tmp/example.txt with content 'Hello, world!' and overwrite if the file exists." + }, + { + "inputJson": "{\"filePath\":\"C:/Users/Public/report.txt\",\"content\":\"Report generated on 2024-06-15\",\"overwrite\":false}", + "description": "Create a report.txt file at given Windows path without overwriting if it already exists, using default UTF-8 encoding." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "File", + "context": null + } + }, + { + "name": "file-operations.createCode", + "description": "Generates a source code file with specified programming language, code content, and optional file name and directory. Accepts code text and language, then writes a properly formatted code file at the given or default location.", + "category": "file-operations", + "parameters": [ + { + "name": "language", + "type": "string", + "description": "Programming language of the code to create, e.g., 'python','javascript'. Determines file extension and formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "codeContent", + "type": "string", + "description": "The full source code text content to be saved in the file.", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Optional file name without extension. If omitted, a default name 'newCodeFile' will be used.", + "required": false, + "defaultValue": "newCodeFile" + }, + { + "name": "directoryPath", + "type": "string", + "description": "Optional path to directory where the file will be created. Defaults to current working directory.", + "required": false, + "defaultValue": "." + }, + { + "name": "overwrite", + "type": "boolean", + "description": "Whether to overwrite an existing file with the same name. Defaults to false to prevent accidental overwrites.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Information about the created file including full file path and success status" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate or save source code programmatically in a specified language and location, such as scaffolding code snippets, generating example files, or storing dynamically created code for further use.", + "limitations": "This tool cannot execute or validate code correctness; it only creates the file with given content. It does not support complex project structures or multiple files in one call.", + "examples": [ + "Create a Python script file named 'helloWorld.py' with a hello world function.", + "Generate a JavaScript file in a subdirectory without overwriting if it exists.", + "Save a snippet of Java code into default directory using default file name." + ] + }, + "tags": [ + "file", + "create", + "code", + "source", + "programming", + "save", + "generate" + ], + "examples": [ + { + "inputJson": "{\"language\":\"python\",\"codeContent\":\"def greet():\\n print('Hello, world!')\",\"fileName\":\"helloWorld\",\"directoryPath\":\"./scripts\",\"overwrite\":false}", + "description": "Create a Python code file 'helloWorld.py' in './scripts' directory with a simple greet function." + }, + { + "inputJson": "{\"language\":\"javascript\",\"codeContent\":\"console.log('Testing file creation');\",\"fileName\":\"test\",\"directoryPath\":\"\",\"overwrite\":true}", + "description": "Create or overwrite 'test.js' in current directory with a console log statement." + }, + { + "inputJson": "{\"language\":\"java\",\"codeContent\":\"public class Example { public static void main(String[] args) { System.out.println(\\\"Example\\\"); } }\",\"fileName\":\"\",\"directoryPath\":\"./src\",\"overwrite\":false}", + "description": "Create a Java file with default name in './src' directory containing a simple Example class." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Code", + "context": null + } + }, + { + "name": "email-communication.analyzeMessage", + "description": "Analyzes an email message provided as input to extract key information such as sentiment, intent, language, spam likelihood, and important entities. The tool accepts raw email text and provides a structured analysis summary including tone and probable categories to enable informed responses or automated workflows.", + "category": "email-communication", + "parameters": [ + { + "name": "emailText", + "type": "string", + "description": "The full raw content of the email message to analyze, including subject and body.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSpamScore", + "type": "boolean", + "description": "Whether to calculate and include a spam likelihood score in the analysis output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "languageHint", + "type": "string", + "description": "Optional hint for the language of the email text to improve analysis accuracy (e.g., 'en' for English).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the analyzed email attributes: detected language, overall sentiment score and label, identified intent categories, spam likelihood score, and any extracted key entities or topics." + }, + "aiAgent": { + "useCase": "This tool is ideal when an AI agent needs to understand the content and characteristics of an incoming email message to determine appropriate handling, such as routing, automated replies, prioritization, or spam filtering. It enables nuanced comprehension of the message beyond keyword matching.", + "limitations": "The tool cannot perfectly interpret highly ambiguous, sarcastic, or very context-dependent messages. It also does not provide full email parsing (e.g., headers) or advanced attachments analysis.", + "examples": [ + "Analyze the sentiment and intent of this email before deciding on a reply.", + "Detect if an email is likely spam and extract main topics for workflow automation.", + "Identify the language and main emotion conveyed in the customer support request email." + ] + }, + "tags": [ + "email", + "analysis", + "sentiment", + "spam-detection", + "intent-recognition", + "language-detection", + "automation" + ], + "examples": [ + { + "inputJson": "{\"emailText\":\"Subject: Meeting rescheduled to Monday\\nHi team,\\nThe meeting originally planned for Friday has been moved to Monday at 10 AM. Please update your calendars accordingly. Thanks!\",\"includeSpamScore\":true}", + "description": "A typical internal meeting rescheduling email to analyze tone and urgency." + }, + { + "inputJson": "{\"emailText\":\"Hello, I received a defective product and want a refund. Please advise how to proceed.\",\"includeSpamScore\":false}", + "description": "Customer complaint email to assess sentiment and extract key intent for support routing." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "email-communication.formatEmail", + "description": "Formats an email message by combining subject, body content, sender and recipient details, and optional attachments into a structured email object suitable for sending or preview. Accepts plain text or HTML body input and outputs a well-structured email format with headers and content.", + "category": "email-communication", + "parameters": [ + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content of the email; can include plain text or HTML markup.", + "required": true, + "defaultValue": "" + }, + { + "name": "sender", + "type": "string", + "description": "The email address or display name and address of the sender.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "List of recipient email addresses to send the email to.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of CC (carbon copy) email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of BCC (blind carbon copy) email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Whether the body content is HTML formatted (true) or plain text (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment objects; each containing filename and content or a URL.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A structured email object including headers (subject, sender, recipients, cc, bcc), body content formatted properly according to isHtml flag, and an attachments array." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to prepare an email message for sending or preview by formatting raw input components like subject, body, sender, recipients, and attachments into a standardized structured email object suitable for downstream processing or transmission.", + "limitations": "This tool does not send emails, validate email address syntax extensively, or encrypt content. It only formats and structures the email data.", + "examples": [ + "Format an email with plain text body for a project update.", + "Create an HTML formatted marketing email with multiple recipients and attachments.", + "Prepare a copy of an email with CC and BCC recipients included." + ] + }, + "tags": [ + "email", + "formatting", + "communication", + "automation", + "message", + "html", + "attachments" + ], + "examples": [ + { + "inputJson": "{\"subject\":\"Meeting Reminder\",\"body\":\"Please be reminded that the project kickoff meeting is tomorrow at 10 AM.\",\"sender\":\"project.manager@example.com\",\"recipients\":[\"team.member1@example.com\",\"team.member2@example.com\"],\"cc\":[\"pm.assistant@example.com\"],\"bcc\":[],\"isHtml\":false,\"attachments\":[]}", + "description": "Formatting a plain text email reminder with one CC recipient and no attachments." + }, + { + "inputJson": "{\"subject\":\"Monthly Newsletter\",\"body\":\"Latest Updates
Check out our new product features!
\",\"sender\":\"newsletter@example.com\",\"recipients\":[\"subscriber1@example.com\",\"subscriber2@example.com\"],\"cc\":[],\"bcc\":[\"audit@example.com\"],\"isHtml\":true,\"attachments\":[{\"filename\":\"brochure.pdf\",\"content\":\"base64encodedstringhere\"}]}", + "description": "Formatting an HTML newsletter email with BCC and one PDF attachment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Email", + "context": null + } + }, + { + "name": "email-communication.formatCode", + "description": "This tool accepts a string containing code snippets intended for inclusion in email templates. It formats and highlights the code according to the specified programming language and style preferences to ensure the code displays clearly and attractively within email content. The output is a properly formatted HTML string ready for email embedding.", + "category": "email-communication", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The raw code snippet as a string that needs to be formatted for email display.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming language of the code snippet to apply appropriate syntax highlighting (e.g., 'javascript', 'python').", + "required": true, + "defaultValue": "" + }, + { + "name": "theme", + "type": "string", + "description": "Color theme for syntax highlighting, such as 'light' or 'dark'.", + "required": false, + "defaultValue": "light" + }, + { + "name": "lineNumbers", + "type": "boolean", + "description": "Whether to include line numbers alongside the formatted code.", + "required": false, + "defaultValue": "false" + }, + { + "name": "inlineStyles", + "type": "boolean", + "description": "Use inline CSS styles for email client compatibility (true) or external classes (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "wrapLines", + "type": "boolean", + "description": "Whether to wrap long lines to avoid horizontal scrolling in email clients.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the HTML string of the formatted and syntax-highlighted code suitable for embedding in email templates." + }, + "aiAgent": { + "useCase": "Use this tool when you need to embed programming code snippets in email templates or communications, ensuring the code is properly formatted, readable, and visually distinct with syntax highlighting, compatible with common email clients.", + "limitations": "This tool formats and highlights code for HTML email contexts but does not execute or validate the code itself. Some complex styles or very large code blocks may not render perfectly on all email clients.", + "examples": [ + "Format a JavaScript snippet with dark theme and line numbers for an email newsletter.", + "Format a Python code block with light theme and no line numbers for an instructional email.", + "Format HTML code snippet with inline styles to ensure compatibility in diverse email clients." + ] + }, + "tags": [ + "email", + "code", + "formatting", + "syntax-highlighting", + "template", + "automation" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function greet() {\\n console.log('Hello, world!');\\n}\",\"language\":\"javascript\",\"theme\":\"dark\",\"lineNumbers\":true,\"inlineStyles\":true,\"wrapLines\":true}", + "description": "Format a JavaScript function snippet for an email with dark theme, line numbers, inline styles, and line wrapping enabled." + }, + { + "inputJson": "{\"code\":\"def add(a, b):\\n return a + b\",\"language\":\"python\",\"theme\":\"light\",\"lineNumbers\":false,\"inlineStyles\":true,\"wrapLines\":true}", + "description": "Format a simple Python function snippet for embedding in an email with a light theme and no line numbers." + }, + { + "inputJson": "{\"code\":\"Example\",\"language\":\"html\",\"theme\":\"light\",\"lineNumbers\":false,\"inlineStyles\":true,\"wrapLines\":false}", + "description": "Format a simple HTML snippet for email with inline styles and no line wrapping." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "email-communication.composeEmail", + "description": "This tool composes a complete email message based on specified inputs such as recipients, subject, body content, and optional attachments or formatting. It accepts sender and recipient info, email subject, plain or HTML body text, optional CC and BCC addresses, and attachments. It outputs a structured email object ready for sending through an SMTP service or email API.", + "category": "email-communication", + "parameters": [ + { + "name": "sender", + "type": "string", + "description": "The sender's email address (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "toRecipients", + "type": "array", + "description": "List of primary recipient email addresses.", + "required": true, + "defaultValue": "" + }, + { + "name": "ccRecipients", + "type": "array", + "description": "List of CC recipient email addresses (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bccRecipients", + "type": "array", + "description": "List of BCC recipient email addresses (optional).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content of the email, can include plain text or HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Indicates if the body is HTML formatted (true) or plain text (false).", + "required": false, + "defaultValue": "false" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional list of attachments to include, each specified as an object with filename and base64 content.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An email object containing all input fields structured properly and ready for sending through an email service." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate a fully structured email message from given sender, recipients, subject, body, and optional attachments. It helps automate email creation in workflows requiring dynamic message composition before sending.", + "limitations": "This tool does not send emails; it only composes and returns the structured email data. It does not validate email addresses or handle encoding of attachments beyond basic structuring.", + "examples": [ + "Compose an email with a subject, plain text body, sender, single recipient, and no attachments.", + "Create an HTML formatted email including CC and BCC recipients plus multiple attachments.", + "Generate an email with multiple 'To' recipients and verify the structure is correct for sending." + ] + }, + "tags": [ + "email", + "compose", + "automation", + "communication", + "message", + "sender", + "recipient" + ], + "examples": [ + { + "inputJson": "{\"sender\":\"alice@example.com\",\"toRecipients\":[\"bob@example.com\"],\"subject\":\"Meeting Update\",\"body\":\"Hello Bob, the meeting is rescheduled to 3 PM.\",\"isHtml\":false}", + "description": "Compose a simple plain text email from Alice to Bob with a meeting update." + }, + { + "inputJson": "{\"sender\":\"marketing@company.com\",\"toRecipients\":[\"client1@example.com\",\"client2@example.com\"],\"ccRecipients\":[\"manager@example.com\"],\"bccRecipients\":[\"audit@example.com\"],\"subject\":\"Newsletter April\",\"body\":\"April Newsletter
Check our updates!
\",\"isHtml\":true,\"attachments\":[{\"filename\":\"newsletter.pdf\",\"content\":\"JVBERi0xLjQKJcfs...\"}]}", + "description": "Compose an HTML email newsletter to multiple clients with CC, BCC, and a PDF attachment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Email", + "context": null + } + }, + { + "name": "email-communication.buildFunction", + "description": "Constructs a customizable JavaScript function for sending automated emails based on provided parameters including SMTP settings, recipient details, email content, and optional scheduling. The tool outputs source code for seamless integration into email automation workflows.", + "category": "email-communication", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The desired name for the generated JavaScript function.", + "required": true, + "defaultValue": "" + }, + { + "name": "smtpSettings", + "type": "object", + "description": "SMTP configuration object containing host, port, user, and password for email sending.", + "required": true, + "defaultValue": "" + }, + { + "name": "recipients", + "type": "array", + "description": "Array of recipient email addresses to whom the email will be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the email to be sent.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The HTML or plain text content of the email body.", + "required": true, + "defaultValue": "" + }, + { + "name": "useHtml", + "type": "boolean", + "description": "Flag indicating whether the body content is HTML (true) or plain text (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "scheduleTime", + "type": "string", + "description": "Optional ISO 8601 timestamp to schedule the email sending time. If empty, sends immediately.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated JavaScript function source code as a string under 'code' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to dynamically generate JavaScript functions for sending automated emails with customizable SMTP credentials, recipients, and email content. Particularly useful for integrating programmatic email sending capabilities in larger automation scripts or applications without manually writing boilerplate code.", + "limitations": "The tool does not validate SMTP credentials or send emails itself; testing and verification must be performed in the target environment. It does not support rich templating engines or attachments.", + "examples": [ + "Create a function named 'sendWelcomeEmail' that sends a welcome email with HTML content to a list of users immediately.", + "Generate a function 'scheduleReportEmail' that sends a plain text report email to multiple recipients at a specified future time using given SMTP settings." + ] + }, + "tags": [ + "email", + "automation", + "JavaScript", + "function generation", + "SMTP", + "email sending" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"sendWelcomeEmail\",\"smtpSettings\":{\"host\":\"smtp.example.com\",\"port\":587,\"user\":\"user@example.com\",\"password\":\"password123\"},\"recipients\":[\"alice@example.com\",\"bob@example.com\"],\"subject\":\"Welcome!\",\"body\":\"Hello, welcome to our service.
\",\"useHtml\":true,\"scheduleTime\":\"\"}", + "description": "Generate a function named 'sendWelcomeEmail' that sends an HTML welcome email immediately to two recipients using specified SMTP credentials." + }, + { + "inputJson": "{\"functionName\":\"scheduleReportEmail\",\"smtpSettings\":{\"host\":\"smtp.mailserver.com\",\"port\":465,\"user\":\"reports@company.com\",\"password\":\"securepwd\"},\"recipients\":[\"team@company.com\"],\"subject\":\"Monthly Report\",\"body\":\"Please find the monthly report attached.\",\"useHtml\":false,\"scheduleTime\":\"2024-07-01T09:00:00Z\"}", + "description": "Build a function 'scheduleReportEmail' that sends a plain text email with monthly report notice to team members at a scheduled future time using secure SMTP settings." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "email-communication.createJSON", + "description": "Generates a JSON representation of an email message based on provided components such as sender, recipients, subject, body, attachments, and metadata. Accepts structured inputs and outputs a standardized JSON object suitable for email automation and storage.", + "category": "email-communication", + "parameters": [ + { + "name": "from", + "type": "string", + "description": "Sender email address, used as the 'From' field in the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses for the 'To' field.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of email addresses for the carbon copy 'CC' field, optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of email addresses for the blind carbon copy 'BCC' field, optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "Main content/body of the email, can be plain text or HTML.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyType", + "type": "string", + "description": "Format of the email body content: 'plain' or 'html'.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects, each containing filename and file data as base64 string, optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Additional metadata as key-value pairs to include with the email JSON, optional.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A JSON object representing the full email message, including specified headers, body, attachments, and metadata, formatted for downstream processing or dispatch." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate a standardized JSON representation of an email message for automation, templating, storing drafts, or preparing messages for sending via an email API. It consolidates all essential email components into a structured format.", + "limitations": "This tool only formats email data into JSON and does not send emails, validate email addresses, or handle email delivery status.", + "examples": [ + "Create a JSON email draft with basic fields: from, to, subject, and plain text body.", + "Generate an email JSON including CC, BCC, HTML body, and attachments encoded as base64.", + "Add custom metadata to the email JSON to store campaign or tracking info." + ] + }, + "tags": [ + "email", + "communication", + "json", + "automation", + "message-formatting", + "attachments", + "templating" + ], + "examples": [ + { + "inputJson": "{\"from\":\"sender@example.com\",\"to\":[\"recipient@example.com\"],\"subject\":\"Meeting Reminder\",\"body\":\"Don't forget our meeting at 10am.\",\"bodyType\":\"plain\"}", + "description": "Basic email JSON with sender, one recipient, subject, and plain text body." + }, + { + "inputJson": "{\"from\":\"noreply@company.com\",\"to\":[\"user1@example.com\",\"user2@example.com\"],\"cc\":[\"manager@example.com\"],\"bcc\":[],\"subject\":\"Monthly Report\",\"body\":\"Report attached
\",\"bodyType\":\"html\",\"attachments\":[{\"filename\":\"report.pdf\",\"content\":\"JVBERi0xLjUKJcfs...\"}]}", + "description": "HTML email with multiple recipients, CC, and a PDF attachment encoded in base64." + }, + { + "inputJson": "{\"from\":\"marketing@brand.com\",\"to\":[\"client@example.com\"],\"subject\":\"Exclusive Offer\",\"body\":\"Check out our special discount!\",\"metadata\":{\"campaignId\":\"12345\",\"trackingEnabled\":true}}", + "description": "Email JSON including metadata fields for tracking and campaign identification." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "JSON", + "context": null + } + }, + { + "name": "email-communication.createMessage", + "description": "Creates a structured email message object based on input parameters such as recipients, subject line, body content (plain text and/or HTML), attachments, and optional metadata like CC, BCC, and reply-to addresses. It outputs a message object ready for sending or further processing by email sending services.", + "category": "email-communication", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "A list of primary recipient email addresses. Must be valid email strings.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of carbon copy recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of blind carbon copy recipient email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email message.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "Plain text version of the email body content.", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "HTML version of the email body content; if provided, email clients will prefer this format.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachments where each item contains filename, content (base64 or raw string), and optional content type.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "replyTo", + "type": "string", + "description": "Optional reply-to email address if different from the sender's address.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An email message object containing structured headers, body content in text and/or HTML format, recipient lists, attachments, and metadata ready for sending or further processing." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically construct a complete email message with recipients, subject, multiple body formats, and optional attachments or metadata before sending via an email service. It supports building messages for transactional emails, marketing campaigns, or automated notifications.", + "limitations": "Does not actually send the email; it only constructs the message object. Does not validate email addresses beyond basic format checks or handle sending failures.", + "examples": [ + "Create an email to multiple recipients with HTML content and an attachment.", + "Generate a plain text notification email with CC and BCC addresses specified.", + "Build a reply email setting a custom reply-to address." + ] + }, + "tags": [ + "email", + "message", + "create", + "compose", + "communication", + "automation", + "smtp", + "notifications" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"alice@example.com\",\"bob@example.com\"],\"subject\":\"Meeting Reminder\",\"bodyText\":\"Dear all, please be reminded of the meeting tomorrow at 10am.\",\"bodyHtml\":\"Dear all,
Please be reminded of the meeting tomorrow at 10am.
\",\"attachments\":[{\"filename\":\"agenda.pdf\",\"content\":\"JVBERi0xLjQKJdP0zOEKMSAwIG9iago8PAovVGl0bGUgKP7/\"}]}", + "description": "Create an email message with multiple recipients, a subject, both text and HTML body content, and a PDF attachment." + }, + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Password Reset\",\"bodyText\":\"Click the link to reset your password.\",\"replyTo\":\"support@example.com\"}", + "description": "Generate a password reset email including a reply-to address for support." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Message", + "context": null + } + }, + { + "name": "infrastructure-management.analyzeAccount", + "description": "Analyzes a cloud infrastructure account by collecting and examining resource usage, security configurations, cost metrics, and compliance status. It accepts an account identifier and optional filters, performs data aggregation and rule-based analysis, and returns a comprehensive report highlighting optimization opportunities, security risks, and compliance gaps.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "Unique identifier of the cloud infrastructure account to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeCostAnalysis", + "type": "boolean", + "description": "Flag to include cost and billing data in the analysis report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSecurityAssessment", + "type": "boolean", + "description": "Flag to include security configurations and vulnerability assessment in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeComplianceCheck", + "type": "boolean", + "description": "Flag indicating whether to perform compliance checks against specified standards.", + "required": false, + "defaultValue": "true" + }, + { + "name": "complianceStandards", + "type": "array", + "description": "List of compliance standards to check against, e.g., ['PCI-DSS','SOC2']. Required if includeComplianceCheck is true.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "timeRangeDays", + "type": "number", + "description": "Number of past days to consider data for usage, cost, and security trends analysis.", + "required": false, + "defaultValue": "30" + } + ], + "returns": { + "type": "object", + "description": "An object containing summarized analytics including resource utilization metrics, cost breakdowns, identified security issues, compliance status per standard, and recommendations for optimization or remediation." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs to audit or analyze a cloud infrastructure account to produce an integrated report on resource efficiency, cost management, security posture, and compliance adherence. It aids in proactive infrastructure management and risk mitigation by combining multiple analysis domains into one comprehensive result.", + "limitations": "The tool depends on access permissions and data availability from cloud providers. It cannot make changes to the account or fix detected issues, only report them. Real-time data analysis is limited by the underlying APIs and may not reflect instant state changes.", + "examples": [ + "Generate a security and cost analysis report for account 'acc-1234' over the last 60 days.", + "Check compliance of account 'prod-account' against PCI-DSS and SOC2 standards.", + "Provide an overview of resource utilization and potential security risks for 'dev-account' including cost metrics." + ] + }, + "tags": [ + "analysis", + "infrastructure", + "cloud", + "account", + "cost", + "security", + "compliance", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"accountId\":\"acc-1234\",\"includeCostAnalysis\":true,\"includeSecurityAssessment\":true,\"includeComplianceCheck\":true,\"complianceStandards\":[\"PCI-DSS\"],\"timeRangeDays\":60}", + "description": "Analyze cloud account 'acc-1234' for cost, security, and PCI-DSS compliance over the past 60 days." + }, + { + "inputJson": "{\"accountId\":\"prod-account\",\"includeCostAnalysis\":false,\"includeSecurityAssessment\":true,\"includeComplianceCheck\":true,\"complianceStandards\":[\"SOC2\",\"ISO27001\"],\"timeRangeDays\":30}", + "description": "Perform security and compliance checks against SOC2 and ISO27001 for production account over last 30 days without cost data." + }, + { + "inputJson": "{\"accountId\":\"dev-account\",\"includeCostAnalysis\":true,\"includeSecurityAssessment\":false,\"includeComplianceCheck\":false,\"timeRangeDays\":15}", + "description": "Get cost and usage overview for development account over the past 15 days without security or compliance analysis." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "infrastructure-management.downloadCode", + "description": "Downloads code repositories or files from specified cloud or version control infrastructure. Accepts repository URL or file path, optional authentication credentials, branch or tag specifications, and downloads code content to a local or specified destination path. Outputs download status, file paths, and error messages if any.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The URL of the code repository or file location to download. Supports Git URLs and HTTP(S) file links.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Local path where the downloaded code or files will be saved.", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or personal access token for private repositories if required.", + "required": false, + "defaultValue": "" + }, + { + "name": "branch", + "type": "string", + "description": "Specific branch, tag, or commit hash to download from the repository. Defaults to the repository default branch if omitted.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSubmodules", + "type": "boolean", + "description": "Whether to include git submodules when downloading repositories. Defaults to false.", + "required": false, + "defaultValue": "false" + }, + { + "name": "shallowClone", + "type": "boolean", + "description": "Whether to perform a shallow clone (limited history) to speed up download and reduce data. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the status of the download process, absolute paths of downloaded files or directories, and any error messages encountered." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically download code repositories or specific files from cloud version control systems or infrastructure for deployment automation, testing, or analysis. It supports private repositories with authentication and selective branch retrieval. It is valuable when integrating code fetching in infrastructure pipelines or management scripts.", + "limitations": "This tool cannot perform repository modifications like commits or pushes. It does not handle repository creation or detailed version control operations beyond downloading. Large repositories may require sufficient local storage and bandwidth.", + "examples": [ + "Download the main branch of a GitHub repository to a local build environment.", + "Fetch a private repository's specific feature branch using a provided access token.", + "Download code files from a public HTTP file server to a temporary directory for analysis." + ] + }, + "tags": [ + "infrastructure", + "download", + "code", + "version-control", + "repository", + "automation", + "cloud" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/repo.git\",\"destinationPath\":\"/tmp/repo\",\"branch\":\"main\",\"includeSubmodules\":false,\"shallowClone\":true}", + "description": "Download the main branch of a public GitHub repository to /tmp/repo with shallow clone and no submodules." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/private-repo.git\",\"destinationPath\":\"/var/repos/private-repo\",\"authToken\":\"ghp_exampletoken123\",\"branch\":\"develop\",\"includeSubmodules\":true,\"shallowClone\":false}", + "description": "Download the 'develop' branch of a private repository with an authentication token, including submodules, with full history." + }, + { + "inputJson": "{\"repositoryUrl\":\"https://files.example.com/project.zip\",\"destinationPath\":\"/data/projects/project.zip\"}", + "description": "Download a code archive file from an HTTP URL to a local directory." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "Code", + "context": null + } + }, + { + "name": "infrastructure-management.downloadDocument", + "description": "Downloads specified infrastructure management documents such as architecture diagrams, compliance reports, or configuration files from a cloud service or internal document storage. Inputs include document ID or name, authentication credentials, and optional format. Outputs the document content or a download link.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "documentId", + "type": "string", + "description": "Unique identifier of the document to download.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentName", + "type": "string", + "description": "Name of the document to download if ID is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Desired format for the downloaded document (e.g., pdf, docx, json).", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "authenticationToken", + "type": "string", + "description": "Authentication token or API key to authorize document download.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeMetadata", + "type": "boolean", + "description": "Whether to include document metadata with the download.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the document content as a base64 string along with metadata if requested. If download fails, returns error details." + }, + "aiAgent": { + "useCase": "Use this tool when an agent needs to retrieve specific infrastructure-related documents securely from managed cloud or internal repositories to view or process configuration details, compliance reports, or architecture documents.", + "limitations": "Cannot download documents from unsupported external systems or without proper authentication. Does not convert document content beyond specified formats.", + "examples": [ + "Download the architecture diagram with ID 'arch-12345' as a PDF.", + "Fetch compliance report named 'PCI_DSS_Audit_2024' including metadata.", + "Get configuration file in JSON format with necessary access token." + ] + }, + "tags": [ + "infrastructure", + "document", + "download", + "cloud", + "compliance", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"documentId\":\"arch-12345\",\"format\":\"pdf\",\"authenticationToken\":\"token_abc123\"}", + "description": "Download a specific architecture diagram in PDF format with authentication." + }, + { + "inputJson": "{\"documentName\":\"PCI_DSS_Audit_2024\",\"includeMetadata\":true,\"authenticationToken\":\"token_xyz789\"}", + "description": "Fetch compliance audit report by name including metadata with a valid token." + }, + { + "inputJson": "{\"documentId\":\"config-9876\",\"format\":\"json\",\"authenticationToken\":\"token_def456\"}", + "description": "Retrieve configuration file in JSON format using its ID and access token." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "Document", + "context": null + } + }, + { + "name": "infrastructure-management.buildFunction", + "description": "This tool automates the creation and deployment of serverless functions in cloud environments. It accepts configuration details including runtime, trigger events, environment variables, and source code repository. It builds, packages, and deploys the function, returning deployment status and endpoint information.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "Name identifier for the function to be built and deployed.", + "required": true, + "defaultValue": "" + }, + { + "name": "runtime", + "type": "string", + "description": "The runtime environment for the function (e.g., nodejs14.x, python3.9).", + "required": true, + "defaultValue": "" + }, + { + "name": "triggerType", + "type": "string", + "description": "Event source or trigger for the function such as HTTP, S3, or scheduled cron.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceRepository", + "type": "string", + "description": "URL or path to the source code repository for the function's codebase.", + "required": true, + "defaultValue": "" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs of environment variables to set in the function runtime.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "memorySize", + "type": "number", + "description": "Amount of memory (in MB) allocated to the function.", + "required": false, + "defaultValue": "128" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum execution time (seconds) before the function times out.", + "required": false, + "defaultValue": "30" + }, + { + "name": "deploymentRegion", + "type": "string", + "description": "Cloud region to deploy the function in (e.g., us-east-1).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Deployment response including status, function ARN or URL, and any error messages." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate building and deploying serverless cloud functions to support scalable event-driven applications. It streamlines setup by configuring runtime, triggers, environment, and deployment without manual cloud console interaction.", + "limitations": "Does not manage infrastructure beyond serverless function deployment (e.g., no VPC setup). Cannot create source code, only deploys given repository code. Limited to supported cloud provider runtimes and regions.", + "examples": [ + "Build a Node.js serverless function triggered by HTTP events with custom environment variables.", + "Deploy a Python function with a S3 bucket trigger in the us-west-2 region.", + "Create a scheduled function running every 5 minutes with 256MB memory allocation." + ] + }, + "tags": [ + "infrastructure-management", + "serverless", + "cloud", + "deployment", + "function", + "automation" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"imageProcessor\",\"runtime\":\"nodejs14.x\",\"triggerType\":\"http\",\"sourceRepository\":\"https://github.com/example/image-processor.git\",\"environmentVariables\":{\"LOG_LEVEL\":\"debug\"},\"memorySize\":256,\"timeoutSeconds\":60,\"deploymentRegion\":\"us-east-1\"}", + "description": "Deploy a Node.js HTTP-triggered image processing function with custom environment variables and increased memory." + }, + { + "inputJson": "{\"functionName\":\"dataIngestor\",\"runtime\":\"python3.9\",\"triggerType\":\"s3\",\"sourceRepository\":\"https://gitlab.com/org/data-ingestor.git\",\"environmentVariables\":{},\"memorySize\":128,\"timeoutSeconds\":30,\"deploymentRegion\":\"eu-central-1\"}", + "description": "Deploy a Python function triggered by S3 events in the EU Central region with default memory and timeout." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "infrastructure-management.generateText", + "description": "Generates customized infrastructure-related textual content based on provided input parameters. Accepts infrastructure type, purpose, and key points, then composes detailed documentation, deployment notes, or overview summaries useful for cloud or physical infrastructure management. Outputs coherent, professional text tailored to specified infrastructure scenarios.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "infrastructureType", + "type": "string", + "description": "Type of infrastructure (e.g., cloud, physical, hybrid) for which the text will be generated.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentPurpose", + "type": "string", + "description": "Intended use or purpose of the generated text (e.g., deployment guide, architecture overview, maintenance notes).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "List of key points or topics to include in the generated text, highlighting important details or considerations.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the target audience (e.g., system administrators, developers, management) to adjust tone and complexity.", + "required": false, + "defaultValue": "" + }, + { + "name": "length", + "type": "number", + "description": "Approximate desired length of the generated text in words.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text content under 'text' field as a string." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate clear, concise, and tailored textual content related to cloud, physical, or hybrid infrastructure scenarios. Ideal for creating documentation, deployment notes, or overviews automatically based on structured inputs. Helps automate communication and documentation tasks in infrastructure management.", + "limitations": "This tool cannot verify technical accuracy or replace expert-generated infrastructure documentation. It does not generate executable scripts or code, only descriptive text content.", + "examples": [ + "Generate a deployment overview for a hybrid infrastructure targeting system administrators.", + "Create maintenance notes summarizing key points for a physical data center for management.", + "Produce an architecture overview document for cloud infrastructure components." + ] + }, + "tags": [ + "infrastructure", + "documentation", + "text-generation", + "cloud", + "physical", + "automation" + ], + "examples": [ + { + "inputJson": "{\"infrastructureType\":\"cloud\",\"documentPurpose\":\"architecture overview\",\"keyPoints\":[\"scalability\",\"security considerations\",\"cost optimization\"],\"targetAudience\":\"system architects\",\"length\":300}", + "description": "Generate a 300-word architecture overview text for cloud infrastructure focusing on scalability, security, and cost optimization aimed at system architects." + }, + { + "inputJson": "{\"infrastructureType\":\"physical\",\"documentPurpose\":\"maintenance notes\",\"keyPoints\":[\"hardware checks\",\"cooling system\",\"backup power\"],\"targetAudience\":\"operations team\",\"length\":200}", + "description": "Create 200-word maintenance notes for physical infrastructure covering hardware checks, cooling system, and backup power for operations team." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "infrastructure-management.createServer", + "description": "Creates a new virtual or physical server instance based on specified parameters such as server type, CPU cores, memory, storage, operating system, and network settings. Accepts configuration details and provisioning options as input, performs server allocation and setup, and returns the server's metadata including ID, status, IP address, and access credentials.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "The type of server to create, e.g., virtual machine, bare metal, container host.", + "required": true, + "defaultValue": "" + }, + { + "name": "cpuCores", + "type": "number", + "description": "Number of CPU cores to allocate to the server.", + "required": true, + "defaultValue": "2" + }, + { + "name": "memoryGB", + "type": "number", + "description": "Amount of RAM in gigabytes for the server.", + "required": true, + "defaultValue": "4" + }, + { + "name": "storageGB", + "type": "number", + "description": "Storage size in gigabytes for the server's primary disk.", + "required": true, + "defaultValue": "50" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system image to install, e.g., Ubuntu 22.04, Windows Server 2019.", + "required": true, + "defaultValue": "" + }, + { + "name": "networkSettings", + "type": "object", + "description": "Configuration object for network settings such as VPC ID, subnet, and public IP allocation.", + "required": false, + "defaultValue": "" + }, + { + "name": "serverName", + "type": "string", + "description": "Optional friendly name for the server instance.", + "required": false, + "defaultValue": "" + }, + { + "name": "autoStart", + "type": "boolean", + "description": "Whether to start the server automatically after creation.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the newly created server's unique identifier, current status, assigned IP addresses, and access credentials or keys." + }, + "aiAgent": { + "useCase": "Use this tool when provisioning new server instances in cloud or hybrid environments is needed, including specification of hardware resources, OS, and network configurations. Ideal for automating infrastructure deployment and scaling operations.", + "limitations": "This tool does not perform post-deployment software installation or configuration management. It cannot guarantee immediate availability under resource constraints.", + "examples": [ + "Create a Linux VM with 4 CPUs, 8GB RAM, and 100GB storage in subnet xyz.", + "Provision a bare metal server with Windows Server, 16 CPUs, and 256GB memory for a database workload.", + "Set up a container host with 2 CPUs and 4GB RAM and assign a public IP." + ] + }, + "tags": [ + "infrastructure", + "server provisioning", + "cloud", + "virtual machine", + "bare metal", + "automation", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"virtual machine\",\"cpuCores\":4,\"memoryGB\":8,\"storageGB\":100,\"operatingSystem\":\"Ubuntu 22.04\",\"networkSettings\":{\"vpcId\":\"vpc-123456\",\"subnetId\":\"subnet-abc123\",\"assignPublicIp\":true},\"serverName\":\"web-server-01\",\"autoStart\":true}", + "description": "Provision a Linux VM with moderate resources and public IP in a specific subnet." + }, + { + "inputJson": "{\"serverType\":\"bare metal\",\"cpuCores\":16,\"memoryGB\":256,\"storageGB\":2000,\"operatingSystem\":\"Windows Server 2019\",\"autoStart\":false}", + "description": "Create a high-performance bare metal server with Windows for a database application." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Server", + "context": null + } + }, + { + "name": "infrastructure-management.createDataset", + "description": "Creates a structured dataset by aggregating and normalizing infrastructure metrics and logs from specified cloud and physical environments. Accepts input parameters defining data sources, timeframe, and filtering options, then processes the collected data into a consistent dataset format for analysis or reporting.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "dataSources", + "type": "array", + "description": "List of infrastructure data sources (e.g., servers, cloud accounts, monitoring tools) to collect metrics and logs from.", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 formatted start timestamp to specify beginning of data collection period.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 formatted end timestamp to specify end of data collection period.", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "Specific performance metrics or log types to include (e.g., CPU usage, memory, error logs). If empty, all available data is collected.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "normalize", + "type": "boolean", + "description": "If true, normalize data values and timestamps for consistency across sources.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the dataset (e.g., 'JSON', 'CSV').", + "required": false, + "defaultValue": "JSON" + } + ], + "returns": { + "type": "object", + "description": "An object containing the compiled dataset with metadata including source info, timeframe, and data schema, formatted per the requested outputFormat." + }, + "aiAgent": { + "useCase": "Use this tool when you need to consolidate and standardize diverse infrastructure monitoring data from multiple sources for analysis, reporting, or machine learning workflows. It is ideal for preparing unified datasets reflecting system state across clouds and physical servers over defined timeframes.", + "limitations": "This tool does not perform in-depth data analysis or visualization; it only aggregates and normalizes raw infrastructure data. It also depends on available data access permissions and may not support all custom metrics without prior integration.", + "examples": [ + "Create a dataset of CPU and memory usage from AWS and on-prem servers for last week.", + "Aggregate error logs from specific physical servers and cloud services between two dates, output as CSV.", + "Generate a normalized JSON dataset including network and storage metrics from multiple infrastructure data sources for an ML model input." + ] + }, + "tags": [ + "infrastructure", + "dataset", + "data-aggregation", + "monitoring", + "cloud", + "physical-servers", + "normalization" + ], + "examples": [ + { + "inputJson": "{\"dataSources\":[\"aws-account-123\",\"onprem-server-01\"],\"startTime\":\"2024-05-01T00:00:00Z\",\"endTime\":\"2024-05-07T23:59:59Z\",\"metrics\":[\"cpuUsage\",\"memoryUsage\"],\"normalize\":true,\"outputFormat\":\"JSON\"}", + "description": "Collect CPU and memory metrics from AWS and on-prem servers for the first week of May, normalized and output as JSON." + }, + { + "inputJson": "{\"dataSources\":[\"datacenter-rack15\"],\"startTime\":\"2024-06-10T00:00:00Z\",\"endTime\":\"2024-06-10T23:59:59Z\",\"metrics\":[\"errorLogs\"],\"normalize\":false,\"outputFormat\":\"CSV\"}", + "description": "Aggregate error logs from one datacenter rack for a single day, without normalization, output as CSV." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Dataset", + "context": null + } + }, + { + "name": "infrastructure-management.createAPI", + "description": "Creates a RESTful API endpoint configuration for managing cloud or physical infrastructure components. Accepts input parameters defining endpoint paths, HTTP methods, expected request/response schemas, and authentication methods. Processes to generate API specifications and deployment-ready configurations. Outputs structured API definition JSON suitable for deployment or documentation.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "The unique name identifying the API to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "List of endpoint objects defining path, HTTP method, request and response schemas, and authentication requirements.", + "required": true, + "defaultValue": "" + }, + { + "name": "version", + "type": "string", + "description": "Version string of the API specification, e.g., 'v1'.", + "required": false, + "defaultValue": "\"v1\"" + }, + { + "name": "authentication", + "type": "object", + "description": "Object specifying the authentication type and configuration for the API, e.g., API keys, OAuth2.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "description", + "type": "string", + "description": "Brief textual description of the API's purpose and capabilities.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "A structured object containing the full API specification including name, version, endpoints with paths, methods and schemas, and authentication details, ready for deployment or export." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the creation of standardized, versioned API endpoints for managing infrastructure components via a RESTful interface. Ideal for orchestrating infrastructure management tasks, integrating with cloud services, or generating API specs from parameterized input.", + "limitations": "This tool does not deploy the API or implement backend logic. It only generates configuration/specification objects. Deployment and runtime environment setup must be handled separately.", + "examples": [ + "Create a REST API named 'infraManager' with endpoints to create and list virtual machines that require API key authentication.", + "Generate an API version 'v2' with endpoints for monitoring server status using GET methods without authentication.", + "Set up an API for physical device inventory management with POST and GET endpoints, including JSON schemas for requests and responses." + ] + }, + "tags": [ + "infrastructure", + "API", + "create", + "REST", + "cloud", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"infraManager\",\"version\":\"v1\",\"description\":\"API to manage cloud VMs\",\"authentication\":{\"type\":\"apiKey\"},\"endpoints\":[{\"path\":\"/vms\",\"method\":\"POST\",\"requestSchema\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"size\":{\"type\":\"string\"}},\"required\":[\"name\"]},\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"status\":{\"type\":\"string\"}}},\"authenticationRequired\":true},{\"path\":\"/vms\",\"method\":\"GET\",\"responseSchema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"status\":{\"type\":\"string\"}}}},\"authenticationRequired\":true}]}", + "description": "Create a VM management API with POST and GET endpoints secured by API key." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "infrastructure-management.createContract", + "description": "Creates a standardized contract document for cloud or physical infrastructure services. Accepts details like parties involved, contract terms, service descriptions, duration, and pricing, and produces a structured contract document in JSON format suitable for review or further processing.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "partyAName", + "type": "string", + "description": "Full legal name of the first party in the contract", + "required": true, + "defaultValue": "" + }, + { + "name": "partyBName", + "type": "string", + "description": "Full legal name of the second party in the contract", + "required": true, + "defaultValue": "" + }, + { + "name": "serviceDescription", + "type": "string", + "description": "Detailed description of the infrastructure services covered by the contract", + "required": true, + "defaultValue": "" + }, + { + "name": "contractStartDate", + "type": "string", + "description": "Start date of the contract in ISO 8601 format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "contractEndDate", + "type": "string", + "description": "End date of the contract in ISO 8601 format (YYYY-MM-DD)", + "required": true, + "defaultValue": "" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Description of payment terms, such as billing frequency and amounts", + "required": true, + "defaultValue": "" + }, + { + "name": "terminationClauses", + "type": "string", + "description": "Terms and conditions under which the contract may be terminated", + "required": false, + "defaultValue": "" + }, + { + "name": "additionalClauses", + "type": "array", + "description": "Additional special conditions or clauses to include in the contract", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A contract document object containing all provided information formatted for legal and operational use" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate a legally structured contract document for cloud or physical infrastructure management engagements, including service provisioning, support, or maintenance agreements. Ideal for automating contract drafts based on user inputs to expedite legal and operational workflows.", + "limitations": "This tool generates contract documents based on provided inputs but does not perform legal validation, negotiation, or enforceability checks. Final legal review is required by qualified professionals.", + "examples": [ + "Create a contract between 'Cloud Provider Inc.' and 'Acme Corp.' for managed cloud services starting 2024-07-01 with monthly billing.", + "Draft a service contract between 'Data Center Ops' and 'Retail Corp' covering server maintenance from 2024-08-01 to 2025-07-31 including payment terms and termination clauses.", + "Generate a contract for physical infrastructure installation between 'BuildTech Ltd.' and 'Enterprise Solutions' with additional clauses for SLA and penalties." + ] + }, + "tags": [ + "infrastructure", + "contract", + "document", + "legal", + "automation", + "service agreement" + ], + "examples": [ + { + "inputJson": "{\"partyAName\":\"Cloud Provider Inc.\",\"partyBName\":\"Acme Corp.\",\"serviceDescription\":\"Managed cloud infrastructure services including monitoring and backups.\",\"contractStartDate\":\"2024-07-01\",\"contractEndDate\":\"2025-06-30\",\"paymentTerms\":\"Monthly payments of $5000 due on the first of each month.\",\"terminationClauses\":\"Either party may terminate with 30 days written notice.\",\"additionalClauses\":[\"Service level agreement with 99.9% uptime guarantee\"]}", + "description": "Creating a service contract for managed cloud infrastructure between two companies with standard terms and SLA clause." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "monitoring.analyzeMessage", + "description": "This tool accepts a batch of communication messages as input in JSON format, analyzing them to detect patterns such as sentiment, frequency, peak times, and potential anomalies in message traffic. It outputs a structured report summarizing these insights including sentiment distribution, message count trends, and flagged irregularities.", + "category": "monitoring", + "parameters": [ + { + "name": "messages", + "type": "array", + "description": "An array of message objects to analyze, each containing at least a timestamp and text content.", + "required": true, + "defaultValue": "" + }, + { + "name": "timeRange", + "type": "object", + "description": "Optional time range filter with 'start' and 'end' ISO8601 timestamp strings to limit analysis within a specific period.", + "required": false, + "defaultValue": "" + }, + { + "name": "sentimentAnalysis", + "type": "boolean", + "description": "Flag to enable or disable sentiment analysis of message contents.", + "required": false, + "defaultValue": "true" + }, + { + "name": "anomalyThreshold", + "type": "number", + "description": "Threshold value (0-1) to define sensitivity for detecting anomalies in message volume or patterns.", + "required": false, + "defaultValue": "0.8" + }, + { + "name": "groupBy", + "type": "string", + "description": "Criteria to group messages for summarized analysis, e.g., 'senderId', 'channelId', or 'none'.", + "required": false, + "defaultValue": "none" + } + ], + "returns": { + "type": "object", + "description": "An analysis report containing sentiment overview, message frequency trends over time, grouping summaries if applied, and any detected anomalies flagged with relevant detail." + }, + "aiAgent": { + "useCase": "Use this tool when monitoring communication systems to understand message flow characteristics, detect unusual activity, and gain insights into sentiment trends over time. It assists in preventive monitoring and sentiment-driven analysis in messaging platforms or internal communications.", + "limitations": "The tool analyzes text-based messages and time metadata only and cannot interpret multimedia content or context beyond textual data. Its anomaly detection is based on statistical thresholds and may require tuning for specific environments.", + "examples": [ + "Analyze message sentiment and frequency trends over the past week from a chat application.", + "Identify anomalies in message traffic grouped by sender within a one-day timeframe.", + "Generate a report summarizing message volume without sentiment analysis for a specific channel." + ] + }, + "tags": [ + "monitoring", + "analysis", + "message", + "sentiment", + "anomaly-detection", + "communication", + "metrics" + ], + "examples": [ + { + "inputJson": "{\"messages\":[{\"timestamp\":\"2024-05-01T10:00:00Z\",\"text\":\"Hello, how are you?\",\"senderId\":\"user1\"},{\"timestamp\":\"2024-05-01T10:05:00Z\",\"text\":\"Everything is fine, thanks!\",\"senderId\":\"user2\"}],\"timeRange\":{\"start\":\"2024-05-01T00:00:00Z\",\"end\":\"2024-05-07T23:59:59Z\"},\"sentimentAnalysis\":true,\"anomalyThreshold\":0.75,\"groupBy\":\"none\"}", + "description": "Analyze a small set of messages with sentiment enabled, limited to a one-week time range." + }, + { + "inputJson": "{\"messages\":[{\"timestamp\":\"2024-06-10T12:00:00Z\",\"text\":\"Server is down!\",\"senderId\":\"user1\"},{\"timestamp\":\"2024-06-10T12:01:00Z\",\"text\":\"Fixing it now.\",\"senderId\":\"user2\"}],\"sentimentAnalysis\":true,\"groupBy\":\"senderId\"}", + "description": "Detect message patterns and sentiment grouped by sender from a brief conversation indicating a system issue." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "monitoring.composeDocument", + "description": "This tool accepts structured monitoring data inputs including metrics, logs, and events, then composes a comprehensive monitoring report document. It processes input parameters such as time range, included data types, and format preferences to generate an organized document summarizing system/application performance and issues. The output is a formatted report document (e.g., PDF, Markdown, HTML) ready for review or sharing.", + "category": "monitoring", + "parameters": [ + { + "name": "startTime", + "type": "string", + "description": "Start timestamp for the monitoring data to include in ISO 8601 format, e.g., '2024-01-01T00:00:00Z'.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "End timestamp for the monitoring data to include in ISO 8601 format, e.g., '2024-01-02T00:00:00Z'.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataTypes", + "type": "array", + "description": "List of monitoring data types to include in the document e.g., ['metrics', 'logs', 'events'].", + "required": true, + "defaultValue": "[\"metrics\",\"logs\"]" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include an executive summary section in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output document format, such as 'pdf', 'markdown', or 'html'.", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "title", + "type": "string", + "description": "Title to use for the monitoring report document.", + "required": false, + "defaultValue": "Monitoring Report" + }, + { + "name": "includeCharts", + "type": "boolean", + "description": "Flag to include generated charts/graphs for key metrics in the document.", + "required": false, + "defaultValue": "true" + }, + { + "name": "detailsLevel", + "type": "string", + "description": "Level of detail for included data sections: 'summary', 'detailed', or 'full logs'.", + "required": false, + "defaultValue": "summary" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed document content encoded (e.g., base64 string), metadata such as format, page count, and generation timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when a comprehensive monitoring report needs to be generated from collected system or application monitoring data within a specific timeframe. Ideal for generating automated performance and issue summary documents for stakeholders or for archival purposes.", + "limitations": "Does not perform real-time data collection; relies on provided input data. Cannot generate deeply customized narrative analysis beyond templated summaries. No direct integration with alerting or remediation actions.", + "examples": [ + "Generate a PDF report of metrics and logs from last 24 hours including charts and summary.", + "Create an HTML monitoring report document focusing on events only with full log details.", + "Produce a Markdown report summarizing key performance metrics in the last week without charts." + ] + }, + "tags": [ + "monitoring", + "reporting", + "document", + "performance", + "metrics", + "logs", + "automation" + ], + "examples": [ + { + "inputJson": "{\"startTime\":\"2024-04-01T00:00:00Z\",\"endTime\":\"2024-04-01T23:59:59Z\",\"dataTypes\":[\"metrics\",\"logs\"],\"includeSummary\":true,\"outputFormat\":\"pdf\",\"title\":\"April 1 System Monitoring Report\",\"includeCharts\":true,\"detailsLevel\":\"summary\"}", + "description": "Generate a PDF monitoring report for April 1st including metrics and logs with summary and charts." + }, + { + "inputJson": "{\"startTime\":\"2024-03-25T00:00:00Z\",\"endTime\":\"2024-03-31T23:59:59Z\",\"dataTypes\":[\"events\"],\"includeSummary\":false,\"outputFormat\":\"html\",\"title\":\"Weekly Events Report\",\"includeCharts\":false,\"detailsLevel\":\"full logs\"}", + "description": "Create an HTML events-only report for the last week with full log details but no summary or charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "monitoring.generateJSON", + "description": "Generates a JSON-formatted system or application performance report based on input metrics and parameters. Accepts performance data (e.g., CPU, memory usage), time range, and optional filters, then processes and organizes this information into a structured JSON output suitable for monitoring dashboards or further analysis.", + "category": "monitoring", + "parameters": [ + { + "name": "metrics", + "type": "array", + "description": "List of performance metrics to include such as ['cpuUsage', 'memoryUsage', 'latency'].", + "required": true, + "defaultValue": "[]" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 formatted start timestamp to define the beginning of the reporting period.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 formatted end timestamp to define the ending of the reporting period.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Optional key-value pairs to filter data (e.g., { 'host': 'server01', 'region': 'us-east' }).", + "required": false, + "defaultValue": "{}" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Flag to include a summary section with aggregate statistics for the performance metrics.", + "required": false, + "defaultValue": "true" + }, + { + "name": "granularity", + "type": "string", + "description": "The resolution of the data points, e.g., 'minute', 'hour', or 'day'.", + "required": false, + "defaultValue": "minute" + } + ], + "returns": { + "type": "object", + "description": "JSON object containing time-series performance data matching the requested metrics and filters, optionally including summaries and metadata about the report." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate structured JSON reports from raw or aggregated monitoring data within specified time frames and metric selections. Ideal for preparing data for visualization or further automated analysis in monitoring and alerting pipelines.", + "limitations": "Does not collect raw data itself; requires input data for processing. Does not perform predictive analysis or alerting logic. The tool outputs structured JSON but does not visualize or send data to endpoint systems.", + "examples": [ + "Generate CPU and memory usage report for the last 24 hours for host 'server01'.", + "Create a JSON report of latency metrics for a specific region between two dates.", + "Produce a summary-inclusive performance JSON report with hourly granularity." + ] + }, + "tags": [ + "monitoring", + "performance", + "reporting", + "json", + "metrics", + "time-series" + ], + "examples": [ + { + "inputJson": "{\"metrics\":[\"cpuUsage\",\"memoryUsage\"],\"startTime\":\"2024-06-01T00:00:00Z\",\"endTime\":\"2024-06-02T00:00:00Z\",\"filters\":{\"host\":\"server01\"},\"includeSummary\":true,\"granularity\":\"hour\"}", + "description": "Generate an hourly CPU and memory usage report for server01 from June 1 to June 2, including summary statistics." + }, + { + "inputJson": "{\"metrics\":[\"latency\"],\"startTime\":\"2024-05-25T10:00:00Z\",\"endTime\":\"2024-05-25T16:00:00Z\",\"filters\":{\"region\":\"us-west\"},\"includeSummary\":false,\"granularity\":\"minute\"}", + "description": "Create a minute-resolution JSON report of latency metric in the US-West region for a 6-hour time window." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "JSON", + "context": null + } + }, + { + "name": "monitoring.createJSON", + "description": "Generates a structured JSON report from raw performance metrics input. Accepts metrics data, timestamps, and optional metadata, then formats and summarizes them into a standardized JSON output suitable for monitoring dashboards or storage.", + "category": "monitoring", + "parameters": [ + { + "name": "metricsData", + "type": "object", + "description": "An object containing key-value pairs of performance metrics (e.g., CPU usage, memory usage).", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 formatted timestamp marking the start of the metrics collection period.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 formatted timestamp marking the end of the metrics collection period.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "If true, includes a summary section with min, max, and average values for each metric.", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional object containing additional metadata such as host info or application ID to include in the report.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "A JSON object structured report containing the input metrics, timestamps, optional metadata, and, if requested, statistical summaries." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw performance metrics data and need to produce a well-structured JSON report for monitoring, alerting, or dashboard visualization. It helps format and enrich metrics data with timing and optional metadata consistently.", + "limitations": "This tool does not collect metrics by itself; it requires pre-collected data input. It does not perform deep analytics beyond basic summary statistics.", + "examples": [ + "Create a JSON report from CPU and memory usage metrics collected between two timestamps including summary statistics.", + "Generate a JSON monitoring report with server metadata for later import into a monitoring dashboard.", + "Produce a metrics JSON payload without summary statistics for real-time streaming." + ] + }, + "tags": [ + "monitoring", + "json", + "metrics", + "reporting", + "performance", + "dashboard" + ], + "examples": [ + { + "inputJson": "{\"metricsData\":{\"cpuUsage\":75,\"memoryUsage\":6320},\"startTime\":\"2024-06-01T08:00:00Z\",\"endTime\":\"2024-06-01T08:05:00Z\",\"includeSummary\":true,\"metadata\":{\"host\":\"server01\",\"app\":\"backend\"}}", + "description": "Generate a JSON report for CPU and memory usage including summary and metadata." + }, + { + "inputJson": "{\"metricsData\":{\"responseTime\":120,\"errorRate\":0.02},\"startTime\":\"2024-06-01T12:00:00Z\",\"endTime\":\"2024-06-01T12:10:00Z\",\"includeSummary\":false}", + "description": "Create a JSON metrics report without summary for response time and error rate." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "JSON", + "context": null + } + }, + { + "name": "security-tools.analyzeNotification", + "description": "Analyzes notification messages to detect potential security risks such as phishing attempts, malicious links, or suspicious sender information. Accepts notification content and metadata, performs threat assessment using pattern recognition and heuristics, and outputs a detailed risk analysis report including risk level and identified issues.", + "category": "security-tools", + "parameters": [ + { + "name": "notificationContent", + "type": "string", + "description": "The full text content of the notification message to analyze for security threats.", + "required": true, + "defaultValue": "" + }, + { + "name": "senderId", + "type": "string", + "description": "Identifier or address of the notification sender, used to assess sender reputation and legitimacy.", + "required": false, + "defaultValue": "" + }, + { + "name": "platform", + "type": "string", + "description": "The platform or channel from which the notification originated (e.g., email, SMS, app), influencing analysis context.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeLinkAnalysis", + "type": "boolean", + "description": "Whether to perform analysis on links contained within the notification content to identify malicious URLs.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxLinksToAnalyze", + "type": "number", + "description": "Maximum number of links to analyze within the notification to optimize performance.", + "required": false, + "defaultValue": "5" + } + ], + "returns": { + "type": "object", + "description": "A structured report containing overall risk assessment, detected threat categories, suspicious elements info, and recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when assessing the security and authenticity of notifications (e.g., emails, SMS, app alerts) to identify phishing or malicious content before user exposure. It's ideal for automated monitoring systems, security bots, or AI agents working in threat detection and response workflows.", + "limitations": "This tool cannot guarantee detection of all threats as some malicious content may use unknown or highly sophisticated evasion techniques. It does not perform real-time blocking or user notification. Accuracy depends on input quality and available threat intelligence.", + "examples": [ + "Analyze the security risk of an SMS notification about a package delivery with embedded links.", + "Check if a transactional email notification contains phishing indicators.", + "Evaluate app push notification content for potential security threats before displaying to users." + ] + }, + "tags": [ + "security", + "notification", + "phishing", + "risk analysis", + "threat detection", + "malicious link", + "communication" + ], + "examples": [ + { + "inputJson": "{\"notificationContent\":\"Your account has been suspended. Click http://fake-bank-login.com to verify immediately!\",\"senderId\":\"support@bank.com\",\"platform\":\"email\",\"includeLinkAnalysis\":true,\"maxLinksToAnalyze\":3}", + "description": "Analyze a suspicious email notification with a link potentially leading to a phishing site." + }, + { + "inputJson": "{\"notificationContent\":\"Package delivered to your door. Track at http://tracking-service.com/12345\",\"platform\":\"sms\",\"includeLinkAnalysis\":true}", + "description": "Evaluate SMS notification with delivery tracking link for security risks." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Notification", + "context": null + } + }, + { + "name": "security-tools.uploadReport", + "description": "Uploads a security report document to a centralized secure repository. Accepts report content, metadata like report type and author, and optional tags. Validates inputs and stores the report securely, returning a unique report ID, upload timestamp, and status confirmation.", + "category": "security-tools", + "parameters": [ + { + "name": "reportContent", + "type": "string", + "description": "The full content of the security report to upload, as a string (e.g., text, JSON, or XML format).", + "required": true, + "defaultValue": "" + }, + { + "name": "reportType", + "type": "string", + "description": "Type of the security report (e.g., vulnerability scan, audit report, compliance check).", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name or identifier of the report author or originating system.", + "required": true, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of string tags to categorize the report for searching or filtering.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "confidential", + "type": "boolean", + "description": "Flag indicating if the report is confidential and requires restricted access.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique report ID, upload timestamp in ISO 8601 format, and upload status message." + }, + "aiAgent": { + "useCase": "Use this tool when you have a security-related report document that needs to be securely stored and cataloged for compliance, audit, or tracking purposes. It is ideal for automated workflows that generate vulnerability scans or audit summaries requiring centralized archival with metadata.", + "limitations": "This tool does not analyze or interpret report content, nor does it perform report generation. It only uploads and stores the given report content securely.", + "examples": [ + "Upload a vulnerability scan report from automated security tool", + "Store an audit compliance report authored by security team", + "Save a penetration test summary report with tags and confidentiality flag" + ] + }, + "tags": [ + "security", + "upload", + "report", + "compliance", + "audit", + "document", + "storage" + ], + "examples": [ + { + "inputJson": "{\"reportContent\":\"{\\\"scanSummary\\\":\\\"No critical vulnerabilities found\\\"}\",\"reportType\":\"vulnerability scan\",\"author\":\"AutomatedScanner01\",\"tags\":[\"monthly\",\"scan\"],\"confidential\":true}", + "description": "Uploading a JSON formatted vulnerability scan report marked confidential with tags." + }, + { + "inputJson": "{\"reportContent\":\"Audit completed on 2024-05-15, all compliance checks passed.\",\"reportType\":\"audit report\",\"author\":\"SecurityTeamLead\",\"tags\":[],\"confidential\":false}", + "description": "Uploading a plain text audit report authored by team lead without tags and not confidential." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Report", + "context": null + } + }, + { + "name": "security-tools.composeReport", + "description": "Generates a comprehensive security report by aggregating and analyzing input vulnerability scan data, system logs, and compliance checklist results. The tool processes the input data and outputs a formatted report in PDF or Markdown summarizing identified issues, severity levels, and recommended mitigation steps.", + "category": "security-tools", + "parameters": [ + { + "name": "vulnerabilityData", + "type": "array", + "description": "An array of vulnerability scan results, each including vulnerability id, description, severity, and affected components.", + "required": true, + "defaultValue": "" + }, + { + "name": "systemLogs", + "type": "array", + "description": "An optional array of system log entries relevant to security events for further analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "complianceResults", + "type": "object", + "description": "An optional object containing compliance checklist results, mapping requirement IDs to pass/fail and comments.", + "required": false, + "defaultValue": "" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Output format of the generated report. Supported values are 'pdf' and 'markdown'.", + "required": true, + "defaultValue": "pdf" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include remediation recommendations in the report summary.", + "required": false, + "defaultValue": "true" + }, + { + "name": "reportTitle", + "type": "string", + "description": "Custom title for the security report.", + "required": false, + "defaultValue": "Security Assessment Report" + } + ], + "returns": { + "type": "object", + "description": "An object containing the report content as a base64-encoded string and metadata including format and summary statistics." + }, + "aiAgent": { + "useCase": "This tool is used when an AI agent needs to compile diverse security-related inputs (e.g., vulnerability scans, logs, compliance data) into a cohesive report for stakeholders or security teams, facilitating decision-making and remediation prioritization.", + "limitations": "It does not perform vulnerability scanning or log collection itself; all input data must be pre-processed and validated. It also does not replace detailed forensic or manual security analysis.", + "examples": [ + "Create a markdown security report from the latest vulnerability scans and compliance results.", + "Generate a PDF report including system logs and recommendations for the last assessment.", + "Compose a security report titled 'Q2 Security Review' without recommendations." + ] + }, + "tags": [ + "security", + "reporting", + "vulnerabilities", + "compliance", + "log analysis", + "pdf", + "markdown" + ], + "examples": [ + { + "inputJson": "{\"vulnerabilityData\":[{\"id\":\"VULN-1234\",\"description\":\"SQL Injection in login form.\",\"severity\":\"High\",\"affectedComponent\":\"WebApp\"}],\"systemLogs\":[{\"timestamp\":\"2024-04-01T12:00:00Z\",\"event\":\"Unauthorized login attempt\"}],\"complianceResults\":{\"PCI-DSS-1\":{\"status\":\"fail\",\"comment\":\"Missing encryption on data storage\"}},\"reportFormat\":\"markdown\",\"includeRecommendations\":true,\"reportTitle\":\"April Security Report\"}", + "description": "Generate a markdown report from vulnerabilities, logs, and compliance results with recommendations and custom title." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "security-tools.buildServer", + "description": "Builds a secured virtual server environment based on provided configurations. Accepts specifications for server type, operating system, security hardening options, network setup, and access controls. Processes these inputs to provision and configure the server with firewalls, user roles, and encryption policies. Outputs a summary of the built server's configuration and access details.", + "category": "security-tools", + "parameters": [ + { + "name": "serverType", + "type": "string", + "description": "Type of the server to build, e.g., 'web', 'database', 'application'.", + "required": true, + "defaultValue": "" + }, + { + "name": "operatingSystem", + "type": "string", + "description": "Operating system to install on the server, e.g., 'Ubuntu 22.04', 'CentOS 8'.", + "required": true, + "defaultValue": "" + }, + { + "name": "enableFirewall", + "type": "boolean", + "description": "Whether to enable and configure the firewall for the server.", + "required": false, + "defaultValue": "true" + }, + { + "name": "sshAccessUsers", + "type": "array", + "description": "List of user names allowed SSH access to the server.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "installSecurityUpdates", + "type": "boolean", + "description": "Whether to automatically apply latest security updates after build.", + "required": false, + "defaultValue": "true" + }, + { + "name": "networkConfiguration", + "type": "object", + "description": "Network parameters including VPC, subnet, and public IP assignment.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "enableDiskEncryption", + "type": "boolean", + "description": "Flag to enable full disk encryption on the server.", + "required": false, + "defaultValue": "false" + }, + { + "name": "additionalHardening", + "type": "array", + "description": "List of additional security hardening steps to apply like 'fail2ban', 'selinux'.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object containing serverId, IP address, configuration summary, security settings applied, and credential/access info." + }, + "aiAgent": { + "useCase": "This tool is used to programmatically create secure server instances with predefined configurations for environments that demand stringent security controls. Ideal for automating infrastructure deployment where security policies like firewalls, user access restrictions, and encryption need to be enforced from the start.", + "limitations": "Does not handle physical hardware provisioning or bare-metal servers; limited to virtualized/cloud environments. Does not install business applications or custom software beyond security tools.", + "examples": [ + "Build a secure Ubuntu web server with firewall enabled and SSH only for admin users.", + "Create a database server running CentOS with disk encryption and automatic security updates.", + "Provision an application server with additional fail2ban hardening and defined network settings." + ] + }, + "tags": [ + "security", + "server", + "infrastructure", + "provisioning", + "automation", + "hardening" + ], + "examples": [ + { + "inputJson": "{\"serverType\":\"web\",\"operatingSystem\":\"Ubuntu 22.04\",\"enableFirewall\":true,\"sshAccessUsers\":[\"admin\",\"devops\"],\"installSecurityUpdates\":true,\"networkConfiguration\":{\"vpc\":\"vpc-1234\",\"subnet\":\"subnet-5678\",\"assignPublicIp\":true},\"enableDiskEncryption\":false,\"additionalHardening\":[\"fail2ban\"]}", + "description": "Build a secure Ubuntu web server with firewall, SSH access for admin and devops users, public IP, fail2ban enabled." + }, + { + "inputJson": "{\"serverType\":\"database\",\"operatingSystem\":\"CentOS 8\",\"enableFirewall\":true,\"sshAccessUsers\":[\"dbadmin\"],\"installSecurityUpdates\":true,\"enableDiskEncryption\":true,\"additionalHardening\":[]}", + "description": "Create a CentOS database server with firewall, full disk encryption, and SSH access restricted to dbadmin." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Server", + "context": null + } + }, + { + "name": "security-tools.generateSummary", + "description": "Generates a concise, clear summary of security-related documents such as vulnerability reports, audit logs, or compliance documents. Accepts raw text or structured JSON input and extracts key insights, risks, and recommendations into an easy-to-understand summary report.", + "category": "security-tools", + "parameters": [ + { + "name": "inputDocument", + "type": "string", + "description": "The raw text content or JSON string of the security document to be summarized.", + "required": true, + "defaultValue": "" + }, + { + "name": "inputFormat", + "type": "string", + "description": "Format of the input document: 'text' for raw text, 'json' for structured JSON input.", + "required": true, + "defaultValue": "text" + }, + { + "name": "summaryLength", + "type": "number", + "description": "Approximate length of the summary in number of sentences or key points.", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeRecommendations", + "type": "boolean", + "description": "Whether to include actionable recommendations in the summary output.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "The language of the input document and the summary output, default is 'en' (English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the summarized key points, risks identified, and optional recommendations based on the input document." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents needing to quickly digest lengthy or complex security documents such as vulnerability assessments, audit findings, or incident reports. It helps extract and present critical security insights efficiently for decision-making or reporting.", + "limitations": "The tool may not accurately interpret documents with highly specialized jargon without sufficient context. It does not perform original security analysis but summarizes provided content. Summaries depend on input quality and may omit less prominent details.", + "examples": [ + "Summarize a vulnerability report to extract main risks and suggested mitigations.", + "Generate an executive summary from an audit log detailing security events for review.", + "Create a compliance document summary highlighting non-conformities and recommendations." + ] + }, + "tags": [ + "security", + "summary", + "documentation", + "vulnerability", + "audit", + "compliance", + "reporting" + ], + "examples": [ + { + "inputJson": "{\"inputDocument\":\"The recent security audit revealed several critical vulnerabilities including outdated software components and improper access controls. Immediate patching is recommended along with a review of user permissions.\",\"inputFormat\":\"text\",\"summaryLength\":3,\"includeRecommendations\":true,\"language\":\"en\"}", + "description": "Summarize a text-based security audit report highlighting vulnerabilities and recommendations." + }, + { + "inputJson": "{\"inputDocument\":\"{\\\"findings\\\":[{\\\"id\\\":1,\\\"description\\\":\\\"Outdated SSL protocols detected\\\",\\\"severity\\\":\\\"high\\\"},{\\\"id\\\":2,\\\"description\\\":\\\"Weak password policies\\\",\\\"severity\\\":\\\"medium\\\"}]}\",\"inputFormat\":\"json\",\"summaryLength\":4,\"includeRecommendations\":true,\"language\":\"en\"}", + "description": "Generate a summary from a structured JSON vulnerability report including key findings and recommendations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Summary", + "context": null + } + }, + { + "name": "security-tools.createKey", + "description": "Generates a cryptographic key based on specified parameters such as key type, length, and usage. Accepts inputs defining the algorithm (e.g., RSA, AES), key size, and whether the key is symmetric or asymmetric. Outputs the generated key material securely encoded, along with metadata including key ID and algorithm details.", + "category": "security-tools", + "parameters": [ + { + "name": "algorithm", + "type": "string", + "description": "The cryptographic algorithm for the key (e.g., RSA, AES, EC).", + "required": true, + "defaultValue": "" + }, + { + "name": "keySize", + "type": "number", + "description": "Key length in bits (e.g., 2048 for RSA, 256 for AES).", + "required": true, + "defaultValue": "" + }, + { + "name": "keyUsage", + "type": "array", + "description": "Intended uses of the key such as ['encrypt','decrypt','sign','verify'].", + "required": false, + "defaultValue": "[\"encrypt\",\"decrypt\"]" + }, + { + "name": "isSymmetric", + "type": "boolean", + "description": "Whether to generate a symmetric key (true) or an asymmetric key pair (false).", + "required": true, + "defaultValue": "true" + }, + { + "name": "keyId", + "type": "string", + "description": "Optional user-defined identifier for the key.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated key material (for symmetric keys) or key pair components (for asymmetric keys), encoded in base64 or PEM format, along with algorithm info and key ID." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate cryptographic keys for use in encryption, signing, or other security operations within your application or infrastructure. It supports both symmetric and asymmetric keys with customizable properties to fit diverse security requirements.", + "limitations": "This tool does not store keys securely; it only generates keys. Proper secure storage and lifecycle management must be handled separately. It also does not perform key rotation or revocation.", + "examples": [ + "Generate an AES 256-bit symmetric encryption key.", + "Create an RSA 2048-bit key pair for digital signatures.", + "Produce an EC key pair using ECDSA with 256-bit curve for signing." + ] + }, + "tags": [ + "cryptography", + "key generation", + "security", + "encryption", + "asymmetric", + "symmetric" + ], + "examples": [ + { + "inputJson": "{\"algorithm\":\"AES\",\"keySize\":256,\"keyUsage\":[\"encrypt\",\"decrypt\"],\"isSymmetric\":true}", + "description": "Generate a 256-bit AES symmetric key for encryption and decryption." + }, + { + "inputJson": "{\"algorithm\":\"RSA\",\"keySize\":2048,\"keyUsage\":[\"sign\",\"verify\"],\"isSymmetric\":false,\"keyId\":\"user-signing-key-01\"}", + "description": "Create an RSA 2048-bit asymmetric key pair for signing and verification with a specific key ID." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Key", + "context": null + } + }, + { + "name": "security-tools.createModule", + "description": "Generates a customizable security module for web applications based on specified features such as authentication, authorization, input validation, and logging. Accepts configuration parameters defining the module's security features and returns code files and documentation to integrate into existing projects.", + "category": "security-tools", + "parameters": [ + { + "name": "moduleName", + "type": "string", + "description": "Name of the security module to be created, used for code namespaces and filenames.", + "required": true, + "defaultValue": "" + }, + { + "name": "features", + "type": "array", + "description": "List of security features to include such as 'authentication', 'authorization', 'inputValidation', 'logging', 'encryption'.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "Programming language for the generated module (e.g., 'JavaScript', 'Python', 'Java').", + "required": true, + "defaultValue": "JavaScript" + }, + { + "name": "frameworkCompatibility", + "type": "string", + "description": "Target framework for integration compatibility (e.g., 'Express', 'Django', 'Spring') or empty for none.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTests", + "type": "boolean", + "description": "Whether to include unit and integration test code for the module features.", + "required": false, + "defaultValue": "true" + }, + { + "name": "documentationFormat", + "type": "string", + "description": "Format of generated documentation, e.g., 'Markdown', 'HTML'.", + "required": false, + "defaultValue": "Markdown" + } + ], + "returns": { + "type": "object", + "description": "An object containing generated source code files as key-value pairs, documentation content, and optionally test code files to integrate a security module based on the provided specifications." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create a modular security component tailored to specific security aspects for web applications, including authentication and authorization features, input validation, logging, and encryption. Ideal for automating boilerplate security code generation for faster development and consistent security practices.", + "limitations": "This tool does not perform security vulnerability scanning, auditing, or real-time threat detection. It generates code templates and modules but does not deploy or integrate them automatically. Requires manual review and integration into projects.", + "examples": [ + "Create a security module named 'UserAuth' in JavaScript with authentication, authorization, and logging features compatible with Express.", + "Generate a Python security module for input validation and encryption, including test cases, without framework integration.", + "Build a Java security module named 'SecureAccess' with authorization and logging features for Spring framework, documenting in HTML." + ] + }, + "tags": [ + "security", + "module", + "code generation", + "authentication", + "authorization", + "input validation", + "logging", + "encryption" + ], + "examples": [ + { + "inputJson": "{\"moduleName\":\"UserAuth\",\"features\":[\"authentication\",\"authorization\",\"logging\"],\"language\":\"JavaScript\",\"frameworkCompatibility\":\"Express\",\"includeTests\":true,\"documentationFormat\":\"Markdown\"}", + "description": "Create a JavaScript security module named UserAuth with authentication and authorization compatible with Express, including tests and Markdown docs." + }, + { + "inputJson": "{\"moduleName\":\"DataProtection\",\"features\":[\"inputValidation\",\"encryption\"],\"language\":\"Python\",\"frameworkCompatibility\":\"\",\"includeTests\":false,\"documentationFormat\":\"Markdown\"}", + "description": "Generate a Python security module named DataProtection focusing on input validation and encryption without framework coupling or tests." + }, + { + "inputJson": "{\"moduleName\":\"SecureAccess\",\"features\":[\"authorization\",\"logging\"],\"language\":\"Java\",\"frameworkCompatibility\":\"Spring\",\"includeTests\":true,\"documentationFormat\":\"HTML\"}", + "description": "Build a Java security module SecureAccess including authorization and logging for Spring, with tests and HTML format documentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Module", + "context": null + } + }, + { + "name": "security-tools.createInvoice", + "description": "This tool generates a secure, tamper-evident invoice document based on provided invoice details and client information. It accepts detailed input including items, prices, taxes, and client data; then produces a signed invoice PDF or JSON that includes a digital signature ensuring document integrity and authenticity.", + "category": "security-tools", + "parameters": [ + { + "name": "invoiceNumber", + "type": "string", + "description": "Unique identifier for the invoice to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "clientName", + "type": "string", + "description": "Name of the client to whom the invoice is issued.", + "required": true, + "defaultValue": "" + }, + { + "name": "clientEmail", + "type": "string", + "description": "Email address of the client for sending or record purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "items", + "type": "array", + "description": "List of items or services billed; each entry includes description, quantity, and unit price.", + "required": true, + "defaultValue": "" + }, + { + "name": "taxRate", + "type": "number", + "description": "Applicable tax rate as a decimal (e.g., 0.07 for 7% tax).", + "required": false, + "defaultValue": "0" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code (ISO 4217) for the invoice amounts, e.g., USD, EUR.", + "required": true, + "defaultValue": "USD" + }, + { + "name": "dueDate", + "type": "string", + "description": "Due date for the invoice payment in ISO 8601 format (YYYY-MM-DD).", + "required": false, + "defaultValue": "" + }, + { + "name": "signInvoice", + "type": "boolean", + "description": "Flag indicating whether to digitally sign the invoice to ensure security and authenticity.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A structured response with invoice data including a secure digital signature and invoice document in PDF or JSON format." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate verified, tamper-evident invoices that ensure document integrity and authenticity, particularly for billing in secure environments or regulated industries. Suitable for workflows requiring digital signing of financial documents to prevent fraud.", + "limitations": "This tool does not process payments, validate financial regulations by jurisdiction, or handle complex tax scenarios like multiple tax jurisdictions or exemptions.", + "examples": [ + "Create a signed invoice for client Acme Corp including 3 items and 7% tax.", + "Generate an invoice in EUR currency without digital signature for a consulting service.", + "Produce an invoice with due date 30 days from issue date and include client email for delivery." + ] + }, + "tags": [ + "invoice", + "security", + "document-generation", + "digital-signature", + "billing", + "finance" + ], + "examples": [ + { + "inputJson": "{\"invoiceNumber\":\"INV-2024-0001\",\"clientName\":\"Acme Corporation\",\"clientEmail\":\"billing@acme.com\",\"items\":[{\"description\":\"Consulting Services\",\"quantity\":10,\"unitPrice\":150},{\"description\":\"Software License\",\"quantity\":1,\"unitPrice\":1200}],\"taxRate\":0.07,\"currency\":\"USD\",\"dueDate\":\"2024-07-31\",\"signInvoice\":true}", + "description": "Generate a secure, signed invoice for Acme Corporation including consulting and software license items with 7% tax." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Invoice", + "context": null + } + }, + { + "name": "customer-support.analyzeText", + "description": "Analyzes customer support text input such as chat transcripts, emails, or feedback messages to extract key insights including sentiment analysis, intent classification, and topic detection. Returns structured analytics data to help improve service quality and understand customer needs.", + "category": "customer-support", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw customer support text content to analyze, such as a chat log, email, or feedback message.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the input text to tailor analysis models for accurate results (e.g., 'en' for English).", + "required": false, + "defaultValue": "en" + }, + { + "name": "analyzeSentiment", + "type": "boolean", + "description": "Whether to perform sentiment analysis to determine the emotional tone of the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "detectIntent", + "type": "boolean", + "description": "Whether to classify the customer's intent or request from the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "extractTopics", + "type": "boolean", + "description": "Whether to identify and extract key topics or themes discussed in the text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeEntities", + "type": "boolean", + "description": "Whether to extract named entities like product names, locations, or dates mentioned in the text.", + "required": false, + "defaultValue": "false" + }, + { + "name": "verbose", + "type": "boolean", + "description": "Return detailed analysis metadata and confidence scores for each detected element.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object including sentiment score, intent label, list of detected topics, extracted entities if requested, and confidence scores or metadata depending on verbosity settings." + }, + "aiAgent": { + "useCase": "Use this tool when analyzing raw customer communication text to automatically summarize sentiment, detect what the customer is asking for, and identify relevant topics or entities. Useful for improving customer service response, routing tickets, and extracting actionable insights from unstructured customer feedback.", + "limitations": "Does not perform real-time interactive conversation analysis or multi-turn dialogue understanding; analysis is limited to the single text input provided. May require additional customization for niche domain-specific terms or multilingual contexts.", + "examples": [ + "Analyze a customer support email to identify their sentiment and intent.", + "Process chat transcript text to extract key topics and customer frustration level.", + "Summarize feedback messages to categorize topics and detect overall satisfaction." + ] + }, + "tags": [ + "customer-support", + "text-analysis", + "sentiment-analysis", + "intent-detection", + "topic-extraction" + ], + "examples": [ + { + "inputJson": "{\"text\":\"I'm very disappointed with my recent order. The product arrived late and damaged.\",\"language\":\"en\",\"analyzeSentiment\":true,\"detectIntent\":true,\"extractTopics\":true}", + "description": "Analyze a customer email complaining about product issues to extract sentiment, intent, and topics." + }, + { + "inputJson": "{\"text\":\"Can you help me reset my password? I can't access my account.\",\"analyzeSentiment\":true,\"detectIntent\":true}", + "description": "Analyze a support chat message to detect customer intent and sentiment for proper ticket handling." + }, + { + "inputJson": "{\"text\":\"Loved the quick support on my last issue! Great job.\",\"analyzeSentiment\":true,\"extractTopics\":true}", + "description": "Analyze positive customer feedback to identify sentiment and main topics mentioned." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Text", + "context": null + } + }, + { + "name": "customer-support.analyzeMessage", + "description": "Analyzes a customer support message text to identify its sentiment, intent, and key topics. Accepts raw message text and language code as input; performs natural language processing to provide structured insights including emotional tone, primary customer intent categories, and important keywords or phrases for further handling or routing.", + "category": "customer-support", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The raw text content of the customer message to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "languageCode", + "type": "string", + "description": "ISO language code of the message text, for accurate language processing (e.g., 'en' for English).", + "required": false, + "defaultValue": "\"en\"" + } + ], + "returns": { + "type": "object", + "description": "An analysis report object including sentiment (positive, neutral, negative), detected intent categories, and extracted key topics or keywords that summarize the customer message content." + }, + "aiAgent": { + "useCase": "Use this tool when handling incoming customer service messages to automatically assess emotional tone, understand customer intent, and extract key topics. This enables prioritizing urgent or negative messages, routing requests to appropriate departments, and generating summary insights for faster response.", + "limitations": "The tool cannot replace full comprehension of nuance or sarcasm; it may misclassify ambiguous intents or complex multi-topic messages; it requires reasonably well-formed text and may not perform well on highly ungrammatical inputs.", + "examples": [ + "Analyze the customer's message to see if they are frustrated and what they are requesting.", + "Identify the main issue and emotional tone in this support chat log text.", + "Extract keywords and intent from the customer's email to automate routing." + ] + }, + "tags": [ + "customer-support", + "analysis", + "sentiment-analysis", + "intent-detection", + "text-processing", + "NLP" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"I am really unhappy with the delay in shipping my order. When will it arrive?\",\"languageCode\":\"en\"}", + "description": "Analyzing an unhappy customer message about delivery delay to detect negative sentiment, shipping delay intent, and key topics like 'delay' and 'order'." + }, + { + "inputJson": "{\"messageText\":\"Could you please help me reset my account password? I forgot it.\",\"languageCode\":\"en\"}", + "description": "Analyzing a password reset request to detect intent for account assistance and extract keywords like 'reset', 'account password'." + }, + { + "inputJson": "{\"messageText\":\"Merci pour votre aide, tout est parfait!\",\"languageCode\":\"fr\"}", + "description": "Analyzing a French message expressing satisfaction to detect positive sentiment and gratitude intent." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "customer-support.createWord", + "description": "Creates a new glossary word or term entry for customer support documentation, accepting the word text, definition, category, and optional tags. It processes the input by validating and formatting the word details, then outputs a standardized word object reflecting the glossary entry suitable for internal docs or knowledge bases.", + "category": "customer-support", + "parameters": [ + { + "name": "wordText", + "type": "string", + "description": "The word or term to be created in the glossary", + "required": true, + "defaultValue": "" + }, + { + "name": "definition", + "type": "string", + "description": "A clear, concise definition for the word or term", + "required": true, + "defaultValue": "" + }, + { + "name": "category", + "type": "string", + "description": "Category or domain the word belongs to, e.g., 'billing', 'technical'", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Array of string tags related to the word for easier search and classification", + "required": false, + "defaultValue": "[]" + }, + { + "name": "createdBy", + "type": "string", + "description": "Identifier or name of the user or system creating the word entry", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object representing the created glossary word entry including id, word text, definition, category, tags, and metadata such as creation timestamp and creator" + }, + "aiAgent": { + "useCase": "Use this tool to add new customer support terminology or jargon into the internal glossary or knowledge base to ensure consistent usage and understanding among support agents and documentation. Useful when evolving product terms or capturing newly coined phrases.", + "limitations": "This tool does not validate the accuracy of definitions or enforce style guidelines; it only creates a structured glossary entry.", + "examples": [ + "Create a glossary word for 'Chargeback' with definition related to billing disputes.", + "Add a new term 'Multi-factor Authentication' with a technical definition to the security category.", + "Insert the term 'ETA' as an abbreviation for 'Estimated Time of Arrival' with appropriate tags." + ] + }, + "tags": [ + "customer-support", + "glossary", + "content-creation", + "knowledge-base", + "terminology" + ], + "examples": [ + { + "inputJson": "{\"wordText\":\"Chargeback\",\"definition\":\"A demand by a credit-card provider for a retailer to make good the loss on a fraudulent or disputed transaction.\",\"category\":\"billing\",\"tags\":[\"finance\",\"payment\"],\"createdBy\":\"system\"}", + "description": "Creates a glossary entry for the term Chargeback in the billing category." + }, + { + "inputJson": "{\"wordText\":\"Multi-factor Authentication\",\"definition\":\"A security system that requires more than one method of authentication from independent categories of credentials to verify the user's identity.\",\"category\":\"security\",\"tags\":[\"authentication\",\"security\"],\"createdBy\":\"admin_user\"}", + "description": "Adds a security-related technical glossary term for MFA." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "customer-support.createText", + "description": "Generates customized customer support text messages based on input parameters such as issue type, customer sentiment, and desired tone. The tool processes these inputs to create clear, empathetic, and context-appropriate replies useful for email, chat, or SMS support channels.", + "category": "customer-support", + "parameters": [ + { + "name": "issueType", + "type": "string", + "description": "The category or type of the customer's issue (e.g., billing, technical, account).", + "required": true, + "defaultValue": "" + }, + { + "name": "customerSentiment", + "type": "string", + "description": "The perceived sentiment or emotion of the customer, such as 'frustrated', 'neutral', or 'happy'.", + "required": false, + "defaultValue": "neutral" + }, + { + "name": "desiredTone", + "type": "string", + "description": "The tone in which the reply should be written, e.g., 'formal', 'friendly', 'empathetic'.", + "required": false, + "defaultValue": "empathetic" + }, + { + "name": "language", + "type": "string", + "description": "The language for the generated text (e.g., 'en' for English, 'es' for Spanish).", + "required": false, + "defaultValue": "en" + }, + { + "name": "additionalContext", + "type": "string", + "description": "Any extra context or details relevant to the customer's situation to personalize the response.", + "required": false, + "defaultValue": "" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated response in characters.", + "required": false, + "defaultValue": "500" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated support text message as a string." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate empathetic and context-aware customer support messages tailored to specific issue types and customer sentiments. Ideal for creating draft replies for support agents or automating responses in multi-channel help desks.", + "limitations": "This tool cannot replace complex case-specific troubleshooting or provide legally binding information. It depends on accurate input parameters and may not capture all nuances of unique customer scenarios.", + "examples": [ + "Generate a friendly response to a billing issue where the customer is frustrated.", + "Create a formal text to respond to a technical inquiry in Spanish.", + "Produce an empathetic message addressing account access issues with extra context about recent service outages." + ] + }, + "tags": [ + "customer-support", + "text-generation", + "customer-service", + "response-automation", + "multilingual", + "tone-adaptive", + "support-messages" + ], + "examples": [ + { + "inputJson": "{\"issueType\":\"billing\",\"customerSentiment\":\"frustrated\",\"desiredTone\":\"friendly\",\"language\":\"en\",\"additionalContext\":\"Customer reports being overcharged for last month.\",\"maxLength\":300}", + "description": "Generate a friendly English response to a billing issue where the customer is frustrated and mentioned overcharge." + }, + { + "inputJson": "{\"issueType\":\"technical\",\"customerSentiment\":\"neutral\",\"desiredTone\":\"formal\",\"language\":\"es\",\"additionalContext\":\"No internet connection since yesterday.\",\"maxLength\":400}", + "description": "Create a formal Spanish reply for a technical issue about internet outage." + }, + { + "inputJson": "{\"issueType\":\"account\",\"customerSentiment\":\"happy\",\"desiredTone\":\"empathetic\",\"language\":\"en\",\"additionalContext\":\"Customer recently changed phone number.\",\"maxLength\":250}", + "description": "Produce an empathetic English message regarding account access issues involving a recent phone number change." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "customer-support.createImage", + "description": "Generates customized support images such as tutorials, step-by-step guides, or error explanation graphics based on input text descriptions, preferred style, and dimensions. It processes textual prompts and outputs image files suitable for embedding in customer service portals or help documentation.", + "category": "customer-support", + "parameters": [ + { + "name": "descriptionText", + "type": "string", + "description": "Detailed textual description of the image content or scenario to be illustrated, guiding the image generation process.", + "required": true, + "defaultValue": "" + }, + { + "name": "imageStyle", + "type": "string", + "description": "Preferred visual style of the generated image, e.g., 'cartoon', 'realistic', 'minimalist'.", + "required": false, + "defaultValue": "minimalist" + }, + { + "name": "width", + "type": "number", + "description": "Width of the generated image in pixels.", + "required": false, + "defaultValue": "800" + }, + { + "name": "height", + "type": "number", + "description": "Height of the generated image in pixels.", + "required": false, + "defaultValue": "600" + }, + { + "name": "includeTextOverlay", + "type": "boolean", + "description": "Whether to include text annotations or labels directly on the image to clarify steps or errors.", + "required": false, + "defaultValue": "true" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., en, es) to use for any textual elements in the image overlays.", + "required": false, + "defaultValue": "en" + }, + { + "name": "fileFormat", + "type": "string", + "description": "Output image file format, such as 'png', 'jpg', or 'svg'.", + "required": false, + "defaultValue": "png" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated image as a Base64 encoded string, its width, height, and file format for embedding or download." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to create visual aids tailored to customer support scenarios, such as instructional images, error resolution diagrams, or product usage visuals, derived from textual guidance. It is particularly useful for generating dynamic images on-demand that complement textual explanations.", + "limitations": "The tool cannot generate highly complex photographic images or intricate designs requiring professional graphic design software. It is limited to generating images based on descriptive prompts and cannot replace specialized graphic design services.", + "examples": [ + "Create an image showing how to reset a password with step numbers and icons.", + "Generate a minimalist diagram explaining common error messages in the app with callouts.", + "Make an instructional cartoon-style image that illustrates how to install a printer driver." + ] + }, + "tags": [ + "customer-support", + "image-generation", + "visual-aid", + "tutorial", + "helpdesk", + "graphics" + ], + "examples": [ + { + "inputJson": "{\"descriptionText\":\"Step-by-step guide to reset a forgotten password, showing keyboard and reset button.\",\"imageStyle\":\"minimalist\",\"width\":800,\"height\":600,\"includeTextOverlay\":true,\"language\":\"en\",\"fileFormat\":\"png\"}", + "description": "Generate a minimalist step-by-step password reset guide image with text annotations." + }, + { + "inputJson": "{\"descriptionText\":\"Diagram showing common network error messages with explanations.\",\"imageStyle\":\"realistic\",\"width\":1024,\"height\":768,\"includeTextOverlay\":true,\"language\":\"en\",\"fileFormat\":\"jpg\"}", + "description": "Create a realistic diagram explaining network error messages for support documentation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Image", + "context": null + } + }, + { + "name": "customer-support.createIssue", + "description": "Creates a new customer support issue ticket based on provided details such as customer ID, issue title, description, priority, and optional metadata. Processes inputs to generate a structured issue record, assigning default status and optionally linking to related product or order IDs. Returns the new issue ID and confirmation details.", + "category": "customer-support", + "parameters": [ + { + "name": "customerId", + "type": "string", + "description": "Unique identifier for the customer reporting the issue.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "Brief summary or title of the issue.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed explanation of the customer's issue or request.", + "required": true, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Urgency level of the issue; e.g., low, medium, high, critical.", + "required": false, + "defaultValue": "medium" + }, + { + "name": "relatedProductId", + "type": "string", + "description": "Optional product identifier related to the issue if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "relatedOrderId", + "type": "string", + "description": "Optional order identifier related to the issue if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "Optional array of tags to categorize or label the issue (e.g., \"billing\", \"technical\").", + "required": false, + "defaultValue": "[]" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachment URLs or file references supporting the issue.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with the new issue's unique ID, status confirming creation, and a timestamp of creation." + }, + "aiAgent": { + "useCase": "Use this tool when you need to create a new support ticket to formally track and manage a customer's problem or request, capturing relevant customer info, issue details, and contextual metadata to facilitate resolution and follow-up within a helpdesk environment.", + "limitations": "This tool does not update existing issues or provide solutions; it only creates new issue records. It does not perform validation beyond required fields or prioritize issues automatically beyond setting an initial priority level.", + "examples": [ + "Create a new issue for a customer reporting a login failure with high priority.", + "Log a billing question related to a specific order with supplemental attachments.", + "Register a general support inquiry without linking to a product or order." + ] + }, + "tags": [ + "customer-support", + "issue-tracking", + "ticket-creation", + "helpdesk", + "service", + "support", + "customer-service" + ], + "examples": [ + { + "inputJson": "{\"customerId\":\"cust12345\",\"title\":\"Cannot log in to account\",\"description\":\"Customer reports receiving an 'Invalid credentials' error despite correct password.\",\"priority\":\"high\",\"relatedProductId\":\"prod6789\",\"tags\":[\"login\",\"authentication\"]}", + "description": "Creating a high priority login issue for a specific product with tags." + }, + { + "inputJson": "{\"customerId\":\"cust54321\",\"title\":\"Billing discrepancy on last invoice\",\"description\":\"Customer notes an unexpected charge on invoice #INV-9999.\",\"priority\":\"medium\",\"relatedOrderId\":\"order1122\",\"attachments\":[\"https://example.com/invoice_INV-9999.pdf\"],\"tags\":[\"billing\",\"invoice\"]}", + "description": "Logging a billing issue related to a particular order with attachment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Issue", + "context": null + } + }, + { + "name": "customer-support.createContract", + "description": "Creates a customer service contract document based on specified client details, service terms, pricing, and duration. Accepts input parameters to customize contract clauses and outputs a finalized contract text suitable for review or digital signing.", + "category": "customer-support", + "parameters": [ + { + "name": "clientName", + "type": "string", + "description": "Full legal name of the client or customer for whom the contract is being created.", + "required": true, + "defaultValue": "" + }, + { + "name": "serviceDescription", + "type": "string", + "description": "A detailed description of the services to be provided under the contract.", + "required": true, + "defaultValue": "" + }, + { + "name": "contractStartDate", + "type": "string", + "description": "Start date of the contract in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "contractEndDate", + "type": "string", + "description": "End date of the contract in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Description of payment terms, including pricing, billing frequency, and payment methods.", + "required": true, + "defaultValue": "" + }, + { + "name": "terminationClause", + "type": "string", + "description": "Text of termination clause specifying conditions for contract termination.", + "required": false, + "defaultValue": "Either party may terminate with 30 days written notice." + }, + { + "name": "includeConfidentialityClause", + "type": "boolean", + "description": "Whether to include a standard confidentiality clause in the contract.", + "required": false, + "defaultValue": "true" + }, + { + "name": "specialConditions", + "type": "array", + "description": "An array of strings specifying any special conditions or clauses to include in the contract.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "An object containing the finalized contract text and a summary metadata including client name and contract duration." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate a tailored customer service contract based on client-specific parameters, service scope, and payment details to automate and standardize contract creation, especially in a help desk or customer support context.", + "limitations": "This tool does not perform legal validation or ensure compliance with jurisdiction-specific laws. The generated contract should be reviewed by legal professionals before signing.", + "examples": [ + "Create a new service contract for a client starting next month with monthly payments and a confidentiality clause.", + "Generate a customer support agreement for a three-month trial period without special conditions.", + "Produce a contract including custom termination terms and special service level agreements." + ] + }, + "tags": [ + "contract", + "customer-support", + "document-generation", + "service-agreement" + ], + "examples": [ + { + "inputJson": "{\"clientName\":\"Acme Corp\",\"serviceDescription\":\"Premium IT support services covering 24/7 help desk and onsite troubleshooting.\",\"contractStartDate\":\"2024-07-01\",\"contractEndDate\":\"2025-06-30\",\"paymentTerms\":\"Monthly payments of $5000 due on the 1st of each month.\",\"terminationClause\":\"Either party may terminate with 60 days written notice.\",\"includeConfidentialityClause\":true,\"specialConditions\":[\"Service Level Agreement with 99.9% uptime guarantee\"]}", + "description": "Create a one-year premium IT support contract with a custom termination notice and SLA clause." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "marketing-automation.composeDocument", + "description": "Generates a tailored marketing document such as proposals, campaign briefs, or newsletters by accepting input parameters detailing the target audience, campaign goals, tone, and content sections. It processes these inputs to compose a professional, coherent document in the requested format (e.g. plain text, HTML).", + "category": "marketing-automation", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of marketing document to compose, e.g., 'proposal', 'newsletter', or 'campaignBrief'.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended recipients or customer segment for the marketing document.", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignGoals", + "type": "string", + "description": "Key objectives or messages that the marketing campaign aims to communicate.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Desired tone of the document, such as 'formal', 'casual', 'persuasive', or 'informative'.", + "required": false, + "defaultValue": "professional" + }, + { + "name": "contentSections", + "type": "array", + "description": "Array of objects defining section titles and main points to include in those sections. Each object contains 'title' (string) and 'points' (array of strings).", + "required": false, + "defaultValue": "[]" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format for the generated document, e.g. 'plainText', 'HTML', or 'markdown'.", + "required": false, + "defaultValue": "plainText" + } + ], + "returns": { + "type": "object", + "description": "An object containing the composed marketing document text in the requested format under the 'documentContent' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate structured marketing documents customized to specific campaigns, audiences, and objectives, saving time and ensuring consistency in tone and content. It's ideal for creating proposals, briefs, or newsletters with clear sections and messaging.", + "limitations": "Cannot access or analyze external data sources; relies solely on user-provided inputs. It does not perform detailed graphic layout or include images, focusing on textual content composition only.", + "examples": [ + "Compose a campaign proposal for a new eco-friendly product targeting millennials with a persuasive tone.", + "Generate a monthly newsletter outline for loyal customers highlighting upcoming sales and promotions, using a casual tone.", + "Create a formal campaign brief describing goals and key messages for an email marketing campaign targeting small business owners." + ] + }, + "tags": [ + "marketing", + "automation", + "document", + "composition", + "campaign", + "proposal", + "newsletter" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"proposal\",\"targetAudience\":\"millennial consumers interested in sustainability\",\"campaignGoals\":\"introduce new eco-friendly product line highlighting environmental benefits and affordability\",\"tone\":\"persuasive\",\"contentSections\":[{\"title\":\"Introduction\",\"points\":[\"Product overview\",\"Sustainability mission\"]},{\"title\":\"Benefits\",\"points\":[\"Eco-friendly materials\",\"Competitive pricing\"]},{\"title\":\"Call to Action\",\"points\":[\"Visit website\",\"Sign up for updates\"]}],\"outputFormat\":\"plainText\"}", + "description": "Compose a persuasive marketing proposal document targeting millennials for an eco-friendly product launch." + }, + { + "inputJson": "{\"documentType\":\"newsletter\",\"targetAudience\":\"existing loyal customers\",\"campaignGoals\":\"inform about upcoming seasonal sales and exclusive promotions\",\"tone\":\"casual\",\"contentSections\":[{\"title\":\"Upcoming Sales\",\"points\":[\"Black Friday savings\",\"Holiday discounts\"]},{\"title\":\"Exclusive Offers\",\"points\":[\"Early access for members\",\"Bonus gifts\"]}],\"outputFormat\":\"HTML\"}", + "description": "Generate a casual-style newsletter for loyal customers with information about sales and exclusive offers." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "marketing-automation.createText", + "description": "Generates marketing text content based on the campaign objective, target audience, tone, and additional style preferences. Accepts inputs like campaign goal, audience description, desired tone, and optional keywords. Produces tailored text suitable for ads, emails, social media posts, or landing pages to automate marketing content creation.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignObjective", + "type": "string", + "description": "The main goal of the marketing content (e.g., brand awareness, lead generation, product promotion).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description of the intended audience including demographics, interests, or behaviors.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "The tone or style of the generated text (e.g., formal, casual, enthusiastic, professional).", + "required": false, + "defaultValue": "casual" + }, + { + "name": "contentType", + "type": "string", + "description": "Type of marketing content to generate such as ad copy, email, social post, or landing page text.", + "required": false, + "defaultValue": "ad copy" + }, + { + "name": "keywords", + "type": "array", + "description": "Optional list of keywords or phrases to incorporate in the generated text.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated text in characters.", + "required": false, + "defaultValue": "300" + }, + { + "name": "callToAction", + "type": "string", + "description": "Optional call-to-action phrase to include at the end of the text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated marketing text content as a string and metadata about the generation (e.g., content length)." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create customized marketing text content automatically from structured campaign inputs. It helps rapidly produce relevant and engaging copy that aligns with campaign goals and audience profiles, facilitating scalable marketing efforts without manual writing.", + "limitations": "The tool generates text based on input prompts but may not capture deep brand nuances or complex strategies. It cannot replace human review and editing for brand voice consistency or legal compliance.", + "examples": [ + "Create email content for a professional product launch aimed at IT managers with a formal tone.", + "Generate social media ad copy targeting millennials interested in fitness using an enthusiastic tone and including specified keywords.", + "Produce landing page header text for a lead generation campaign focused on small business owners with a casual tone and a clear call to action." + ] + }, + "tags": [ + "marketing", + "content-generation", + "automation", + "text-generation", + "advertising", + "copywriting" + ], + "examples": [ + { + "inputJson": "{\"campaignObjective\":\"lead generation\",\"targetAudience\":\"small business owners aged 30-50 interested in tech solutions\",\"tone\":\"professional\",\"contentType\":\"email\",\"keywords\":[\"free trial\",\"easy setup\"],\"maxLength\":250,\"callToAction\":\"Sign up now\"}", + "description": "Generate a professional email for lead generation targeting small business owners promoting a free trial with a clear call to action." + }, + { + "inputJson": "{\"campaignObjective\":\"brand awareness\",\"targetAudience\":\"millennials interested in eco-friendly products\",\"tone\":\"enthusiastic\",\"contentType\":\"social post\",\"keywords\":[\"sustainable\",\"green\"],\"maxLength\":150,\"callToAction\":\"Join us today!\"}", + "description": "Create an enthusiastic social media post for brand awareness aiming at millennials promoting sustainable product benefits." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Text", + "context": null + } + }, + { + "name": "marketing-automation.createMessage", + "description": "Creates a marketing message draft based on provided campaign details, target audience, and communication goals. Accepts input parameters defining message type, tone, key points, and call-to-action, then outputs a formatted message ready for review or deployment within marketing campaigns.", + "category": "marketing-automation", + "parameters": [ + { + "name": "campaignName", + "type": "string", + "description": "Name of the marketing campaign this message belongs to.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetAudience", + "type": "string", + "description": "Description or segment identifier of the intended message recipients.", + "required": true, + "defaultValue": "" + }, + { + "name": "messageType", + "type": "string", + "description": "Type of message to create, e.g., email, SMS, social media post.", + "required": true, + "defaultValue": "email" + }, + { + "name": "tone", + "type": "string", + "description": "Tone/style of the message, e.g., formal, casual, enthusiastic.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "keyPoints", + "type": "array", + "description": "Array of key points or benefits to highlight in the message (each a string).", + "required": true, + "defaultValue": "[]" + }, + { + "name": "callToAction", + "type": "string", + "description": "The main call-to-action to include in the message, e.g., 'Buy now', 'Sign up today'.", + "required": true, + "defaultValue": "" + }, + { + "name": "includePersonalization", + "type": "boolean", + "description": "Whether to include personalization placeholders (e.g., recipient's name).", + "required": false, + "defaultValue": "false" + }, + { + "name": "maxLength", + "type": "number", + "description": "Optional maximum length of the message content in characters; 0 means no limit.", + "required": false, + "defaultValue": "0" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated message text, metadata including message type, and a summary of included elements." + }, + "aiAgent": { + "useCase": "This tool is ideal for automating the creation of marketing messages tailored to specific campaigns and audiences, helping to speed up content production in email marketing, SMS campaigns, or social media. It assists AI agents in generating draft messages that follow campaign themes, desired tone, and calls to action.", + "limitations": "It cannot send messages or perform A/B testing. The generated content requires human review for compliance and final edits. It does not generate images or multimedia content.", + "examples": [ + "Create an email message for a holiday sale campaign targeting previous customers with a casual tone and 'Shop now' call-to-action.", + "Generate a short SMS message for a new product launch aimed at tech enthusiasts highlighting features and a signup CTA.", + "Draft a social media post with an enthusiastic tone promoting a webinar registration with personalization enabled." + ] + }, + "tags": [ + "marketing", + "automation", + "message", + "campaign", + "email", + "sms", + "social media", + "content creation" + ], + "examples": [ + { + "inputJson": "{\"campaignName\":\"Holiday Sale 2024\",\"targetAudience\":\"loyal_customers\",\"messageType\":\"email\",\"tone\":\"casual\",\"keyPoints\":[\"Up to 50% off\",\"Free shipping on orders over $50\"],\"callToAction\":\"Shop now\",\"includePersonalization\":true,\"maxLength\":500}", + "description": "Create a casual email message for loyal customers promoting a holiday sale with personalization and a shop now CTA." + }, + { + "inputJson": "{\"campaignName\":\"Product Launch\",\"targetAudience\":\"tech_enthusiasts\",\"messageType\":\"sms\",\"tone\":\"formal\",\"keyPoints\":[\"New AI-powered features\",\"Limited-time offer\"],\"callToAction\":\"Sign up today\",\"includePersonalization\":false,\"maxLength\":160}", + "description": "Generate a formal SMS message announcing new product features and a signup call-to-action for tech enthusiasts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Message", + "context": null + } + }, + { + "name": "finance-tools.generateDocument", + "description": "Generates a financial document such as invoice, expense report, or financial statement based on provided data. Accepts document type, configurable fields (e.g., client info, line items, dates, amounts), and outputs a structured PDF or text document ready for use or distribution.", + "category": "finance-tools", + "parameters": [ + { + "name": "documentType", + "type": "string", + "description": "Type of financial document to generate (e.g., invoice, expenseReport, financialStatement).", + "required": true, + "defaultValue": "\"\"" + }, + { + "name": "data", + "type": "object", + "description": "Structured data specific to the document type (e.g., items, amounts, dates, client details).", + "required": true, + "defaultValue": "{}" + }, + { + "name": "currency", + "type": "string", + "description": "Currency code (ISO 4217) to display amounts in the document.", + "required": false, + "defaultValue": "\"USD\"" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a summary section in the generated document.", + "required": false, + "defaultValue": "true" + }, + { + "name": "dateFormat", + "type": "string", + "description": "Date format string to use for dates in the document (e.g., MM/DD/YYYY).", + "required": false, + "defaultValue": "\"MM/DD/YYYY\"" + } + ], + "returns": { + "type": "object", + "description": "Contains the document content as a base64-encoded PDF string and a human-readable summary of the generated document." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate formal financial documents based on structured data inputs. Ideal for automating invoicing, expense reporting, and financial statement generation within financial management workflows. It ensures consistent format and reduces manual document preparation.", + "limitations": "Cannot process unstructured data or generate complex multi-section reports without explicit structured input. Does not perform financial calculations beyond those provided in inputs.", + "examples": [ + "Generate an invoice PDF for client ABC including purchased items and their prices.", + "Create an expense report document from a list of expenses with dates and amounts.", + "Produce a financial statement summarizing quarterly revenues and expenses in a formatted report." + ] + }, + "tags": [ + "finance", + "document generation", + "invoice", + "expense report", + "financial statement", + "automation" + ], + "examples": [ + { + "inputJson": "{\"documentType\":\"invoice\",\"data\":{\"clientName\":\"Acme Corp\",\"invoiceNumber\":\"INV-1001\",\"items\":[{\"description\":\"Widget A\",\"quantity\":10,\"unitPrice\":9.99},{\"description\":\"Widget B\",\"quantity\":5,\"unitPrice\":19.99}],\"issueDate\":\"2024-05-01\",\"dueDate\":\"2024-05-15\"},\"currency\":\"USD\",\"includeSummary\":true,\"dateFormat\":\"MM/DD/YYYY\"}", + "description": "Generate an invoice for client Acme Corp with two line items and specified dates." + }, + { + "inputJson": "{\"documentType\":\"expenseReport\",\"data\":{\"employeeName\":\"John Doe\",\"expenses\":[{\"date\":\"2024-04-20\",\"category\":\"Travel\",\"amount\":350.75},{\"date\":\"2024-04-22\",\"category\":\"Meals\",\"amount\":45.60}],\"reportPeriod\":\"April 2024\"},\"currency\":\"USD\",\"includeSummary\":true,\"dateFormat\":\"MM/DD/YYYY\"}", + "description": "Generate an expense report for John Doe with travel and meal expenses for April 2024." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Document", + "context": null + } + }, + { + "name": "translation.createEmail", + "description": "This tool generates a professionally structured email in a target language based on user-provided key points, tone preferences, and recipient context. It accepts input text or bullet points in the source language, translates and composes them into a coherent email, and outputs the complete email content in the desired language.", + "category": "translation", + "parameters": [ + { + "name": "sourceLanguage", + "type": "string", + "description": "Language code of the input text (e.g., 'en' for English).", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "Language code for the email output translation (e.g., 'fr' for French).", + "required": true, + "defaultValue": "" + }, + { + "name": "emailPurpose", + "type": "string", + "description": "Brief description of the email's purpose or subject to guide tone and style (e.g., 'request meeting','customer inquiry').", + "required": true, + "defaultValue": "" + }, + { + "name": "keyPoints", + "type": "array", + "description": "An array of key sentences or bullet points in source language to be included in the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "tone", + "type": "string", + "description": "Tone of the email such as formal, informal, persuasive, or friendly.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "recipientContext", + "type": "string", + "description": "Additional context about the recipient or relationship to help personalize the email (e.g., 'new client', 'longtime partner').", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSignature", + "type": "boolean", + "description": "Whether to append a formal signature placeholder at the end of the email.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the fully generated email text in the target language as a string under 'emailBody'." + }, + "aiAgent": { + "useCase": "Use when the agent needs to draft a clear, contextually appropriate email in a different language, transforming raw notes or points into polished communication. Ideal for cross-language professional or personal email creation with controlled tone and recipient consideration.", + "limitations": "Does not verify factual accuracy or recipient-specific sensitive contexts. Quality depends on clarity of input key points. Signature content is a placeholder and must be customized manually.", + "examples": [ + "Create a formal email in German requesting a reschedule for a meeting based on listed points.", + "Generate a friendly thank-you email in Spanish for a customer following a purchase.", + "Compose an informal reminder email in Japanese highlighting key deadlines for a colleague." + ] + }, + "tags": [ + "translation", + "email", + "communication", + "multilingual", + "business", + "automation", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"sourceLanguage\":\"en\",\"targetLanguage\":\"fr\",\"emailPurpose\":\"request meeting\",\"keyPoints\":[\"I hope you are well.\",\"I would like to schedule a meeting next week.\",\"Please let me know your availability.\"],\"tone\":\"formal\",\"recipientContext\":\"new client\",\"includeSignature\":true}", + "description": "Generate a formal French email to a new client requesting a meeting based on three key points." + }, + { + "inputJson": "{\"sourceLanguage\":\"en\",\"targetLanguage\":\"es\",\"emailPurpose\":\"thank you note\",\"keyPoints\":[\"Thank you for your recent purchase.\",\"We appreciate your business.\",\"Please contact us if you have any questions.\"],\"tone\":\"friendly\",\"recipientContext\":\"customer\",\"includeSignature\":false}", + "description": "Create a friendly Spanish thank-you email for a customer without a signature." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "translation.createCode", + "description": "This tool accepts source code snippets in one programming language along with a target programming language, and produces an equivalent code snippet translated into the target language. It supports multiple programming languages and preserves logic and structure as much as possible during translation.", + "category": "translation", + "parameters": [ + { + "name": "sourceCode", + "type": "string", + "description": "The code snippet in the original programming language to be translated.", + "required": true, + "defaultValue": "" + }, + { + "name": "sourceLanguage", + "type": "string", + "description": "The language of the input source code (e.g., 'Python', 'JavaScript').", + "required": true, + "defaultValue": "" + }, + { + "name": "targetLanguage", + "type": "string", + "description": "The programming language to translate the source code into (e.g., 'Java', 'C++').", + "required": true, + "defaultValue": "" + }, + { + "name": "preserveComments", + "type": "boolean", + "description": "Whether to try to preserve comments from the source code in the translated code.", + "required": false, + "defaultValue": "true" + }, + { + "name": "optimizeForReadability", + "type": "boolean", + "description": "If true, format the translated code with emphasis on readability and idiomatic style of the target language.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the translated code snippet and metadata such as success status and any warnings or notes from the translation process." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate equivalent source code in a different programming language, for tasks such as code migration, interoperability, or learning purposes. It is helpful to quickly produce functional code in the target language given a source example.", + "limitations": "The tool cannot guarantee 100% semantic equivalence or handle very complex or library-dependent code perfectly. It may not translate proprietary or domain-specific languages accurately. Comments and formatting preservation may be imperfect.", + "examples": [ + "Translate a Python function to JavaScript.", + "Convert a JavaScript sorting algorithm snippet into Python.", + "Generate C# code from a given Java method." + ] + }, + "tags": [ + "translation", + "code", + "programming", + "sourceCode", + "languageConversion", + "codeGeneration" + ], + "examples": [ + { + "inputJson": "{\"sourceCode\":\"def greet(name):\\n return 'Hello, ' + name\",\"sourceLanguage\":\"Python\",\"targetLanguage\":\"JavaScript\",\"preserveComments\":true,\"optimizeForReadability\":true}", + "description": "Translate a simple Python greeting function to JavaScript." + }, + { + "inputJson": "{\"sourceCode\":\"function sum(arr) { let total = 0; for(let i=0; igetUsers() { return List.of(\\\"Alice\\\", \\\"Bob\\\"); }\\n}\",\"inputType\":\"java\",\"outputFormat\":\"html\",\"includeExamples\":true,\"theme\":\"dark\",\"documentTitle\":\"User API\"}", + "description": "Building HTML API documentation from Java Spring controller source code with example enablement and dark theme." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "API", + "context": null + } + }, + { + "name": "data-analytics.composeDocument", + "description": "Composes a structured analytical document by integrating data insights, visualizations, and narrative summaries. It accepts raw data inputs and user-defined focus areas, processes key metrics and trends, generates charts or tables as needed, and outputs a formatted report suitable for presentations or decision-making.", + "category": "data-analytics", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of data objects or records to analyze and include in the document.", + "required": true, + "defaultValue": "" + }, + { + "name": "documentTitle", + "type": "string", + "description": "The title of the analytical document to be composed.", + "required": true, + "defaultValue": "" + }, + { + "name": "sectionHeadings", + "type": "array", + "description": "An ordered list of section headings to organize the document content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "highlightMetrics", + "type": "array", + "description": "Specific metrics or KPIs to emphasize in the document narrative and visualizations.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includeVisualizations", + "type": "boolean", + "description": "Whether to generate and embed visual charts/tables in the document (true) or plain text only (false).", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Desired output format of the document, e.g., 'pdf', 'docx', or 'html'.", + "required": false, + "defaultValue": "pdf" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') for the narrative text in the document.", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "Object containing the composed document content, format metadata, and a URL or base64 string for download or display." + }, + "aiAgent": { + "useCase": "Use this tool when a comprehensive, narrative-driven document integrating analytical data, key metrics, and visualizations is needed for reports, presentations, or executive summaries. It is ideal for transforming raw data into a structured, easy-to-consume format that highlights actionable insights.", + "limitations": "This tool does not perform deep statistical analysis or complex model training; it assumes input data is pre-processed and clean. It also does not support interactive dashboards but static document outputs only.", + "examples": [ + "Compose a quarterly sales performance report highlighting sales volume and customer acquisition metrics.", + "Generate a marketing analysis document using the last 12 months of campaign data with charts included.", + "Create an executive summary report in Spanish focusing on website traffic and conversion rate KPIs." + ] + }, + "tags": [ + "data-analytics", + "document-composition", + "report-generation", + "data-insights", + "visualization", + "narrative-summary" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"month\":\"January\",\"sales\":12000,\"customers\":150},{\"month\":\"February\",\"sales\":15000,\"customers\":180}],\"documentTitle\":\"Q1 Sales Report\",\"sectionHeadings\":[\"Overview\",\"Sales Trends\",\"Customer Growth\"],\"highlightMetrics\":[\"sales\",\"customers\"],\"includeVisualizations\":true,\"outputFormat\":\"pdf\",\"language\":\"en\"}", + "description": "Composes a quarterly sales report highlighting monthly sales and customer growth with visual charts included." + }, + { + "inputJson": "{\"data\":[{\"campaign\":\"Email Blast\",\"clicks\":3000,\"conversions\":150},{\"campaign\":\"Social Ads\",\"clicks\":4500,\"conversions\":200}],\"documentTitle\":\"Marketing Campaign Analysis\",\"sectionHeadings\":[\"Campaign Performance\",\"Conversion Analysis\"],\"highlightMetrics\":[\"clicks\",\"conversions\"],\"includeVisualizations\":true,\"outputFormat\":\"docx\",\"language\":\"en\"}", + "description": "Creates a marketing campaign analysis document with emphasis on clicks and conversions including tables and charts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Document", + "context": null + } + }, + { + "name": "data-analytics.formatDocument", + "description": "Formats a structured document containing textual data and analytics results into a visually organized and styled output format such as HTML or Markdown. It accepts input data including sections, text blocks, tables, and charts, applies formatting rules, and returns a fully formatted document string suited for reporting or presentation.", + "category": "data-analytics", + "parameters": [ + { + "name": "inputData", + "type": "object", + "description": "The structured document data to format, including sections, paragraphs, tables, and charts.", + "required": true, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The desired output format of the formatted document (e.g., 'html', 'markdown').", + "required": true, + "defaultValue": "html" + }, + { + "name": "styleTemplate", + "type": "string", + "description": "Optional style or template name to apply predefined styling and layout rules.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeTableOfContents", + "type": "boolean", + "description": "Whether to generate and include a table of contents based on document sections.", + "required": false, + "defaultValue": "false" + }, + { + "name": "compressOutput", + "type": "boolean", + "description": "Whether to minify or compress the output document string for smaller size.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted document as a string and metadata about formatting success." + }, + "aiAgent": { + "useCase": "Use this tool when you have structured data representing a document with text, tables, and charts that needs converting into a polished, styled report format such as HTML or Markdown for presentation, sharing, or exporting. It supports customizable styling and optional table of contents generation to enhance readability and professionalism.", + "limitations": "Cannot convert unstructured raw text into structured documents; does not generate charts or analytics results from raw data, only formats already prepared document content. Styling options are limited to predefined templates.", + "examples": [ + "Format a JSON document object into styled HTML with a table of contents for a presentation report.", + "Convert analytics output structured as a document object into Markdown format for inclusion in a GitHub README.", + "Generate a compressed HTML report document from structured input data applying a corporate style template." + ] + }, + "tags": [ + "formatting", + "document", + "data-analytics", + "reporting", + "presentation", + "HTML", + "Markdown" + ], + "examples": [ + { + "inputJson": "{\"inputData\":{\"title\":\"Sales Report\",\"sections\":[{\"heading\":\"Q1 Results\",\"content\":[{\"type\":\"paragraph\",\"text\":\"Sales increased by 15% compared to last year.\"},{\"type\":\"table\",\"headers\":[\"Product\",\"Sales\"],\"rows\":[[\"Product A\",\"1000\"],[\"Product B\",\"1500\"]]}]}]},\"outputFormat\":\"html\",\"includeTableOfContents\":true}", + "description": "Format a sales report document with sections and a table into HTML including a table of contents." + }, + { + "inputJson": "{\"inputData\":{\"title\":\"Analysis Summary\",\"sections\":[{\"heading\":\"Findings\",\"content\":[{\"type\":\"paragraph\",\"text\":\"Data shows a positive trend in engagement.\"}]}]},\"outputFormat\":\"markdown\",\"styleTemplate\":\"simple\"}", + "description": "Convert an analysis summary document into simple styled Markdown format for sharing." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Document", + "context": null + } + }, + { + "name": "data-analytics.createWord", + "description": "Generates a single meaningful word based on specified criteria such as desired word length, part of speech, and thematic category. Accepts parameters defining these constraints and returns a word matching the criteria, useful for naming, brainstorming, or content generation tasks.", + "category": "data-analytics", + "parameters": [ + { + "name": "minLength", + "type": "number", + "description": "Minimum number of characters the generated word should have.", + "required": false, + "defaultValue": "3" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum number of characters the generated word should have.", + "required": false, + "defaultValue": "10" + }, + { + "name": "partOfSpeech", + "type": "string", + "description": "Desired part of speech for the generated word (e.g., noun, adjective, verb).", + "required": false, + "defaultValue": "" + }, + { + "name": "theme", + "type": "string", + "description": "The thematic category or subject area to influence word selection (e.g., technology, nature).", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code to generate the word in (e.g., en for English).", + "required": false, + "defaultValue": "en" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word string and its metadata such as length, part of speech, and theme." + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate a single word constrained by length, part of speech, or theme for applications like naming, creative writing prompts, or metadata tagging. It helps produce contextually relevant words quickly when specific word characteristics are required.", + "limitations": "This tool generates single words and does not create phrases or sentences. It may not provide uncommon or highly specialized vocabulary outside general thematic categories.", + "examples": [ + "Generate a technology-related noun with 5 to 8 letters.", + "Create a short adjective (3-5 letters) with a nature theme.", + "Generate a verb in English with maximum length of 7 characters." + ] + }, + "tags": [ + "generate", + "word", + "text", + "creative", + "naming", + "partOfSpeech", + "theme" + ], + "examples": [ + { + "inputJson": "{\"minLength\":5,\"maxLength\":8,\"partOfSpeech\":\"noun\",\"theme\":\"technology\",\"language\":\"en\"}", + "description": "Generate a technology-related noun with length between 5 and 8 letters." + }, + { + "inputJson": "{\"minLength\":3,\"maxLength\":5,\"partOfSpeech\":\"adjective\",\"theme\":\"nature\",\"language\":\"en\"}", + "description": "Create a short adjective related to nature between 3 and 5 letters long." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Word", + "context": null + } + }, + { + "name": "data-validation.createCustomer", + "description": "Validates and creates a new customer record using provided customer details such as name, email, phone, and address. It checks for completeness, format correctness (e.g., valid email), and business rules compliance, then returns a success status with a customer ID or detailed error messages for correction.", + "category": "data-validation", + "parameters": [ + { + "name": "customerName", + "type": "string", + "description": "Full name of the customer. Required for identification.", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Customer's email address. Must be a valid email format.", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Contact phone number for the customer. Optional but if provided must follow standard phone formatting.", + "required": false, + "defaultValue": "" + }, + { + "name": "address", + "type": "object", + "description": "Physical address of the customer with fields: street, city, state, zipCode, and country.", + "required": true, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional information related to the customer such as preferred contact method or customer category.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object indicating success or failure. Includes a unique customerId when successful or detailed validation errors otherwise." + }, + "aiAgent": { + "useCase": "Use this tool when needing to verify and create valid customer records in a system, ensuring data completeness and adherence to standard formats before insertion into databases or CRMs. It helps prevent corrupt or incomplete customer data creation.", + "limitations": "Does not perform duplicate detection beyond basic email format checks. Does not connect to external contact validation services. Business rule validations should be predefined in the system using this tool.", + "examples": [ + "Create a new customer with full address and contact details to add to CRM.", + "Validate customer info from a web form prior to database insertion.", + "Check and create a customer record ensuring mandatory fields and correct email format." + ] + }, + "tags": [ + "validation", + "customer", + "data-quality", + "create", + "business", + "contact-management" + ], + "examples": [ + { + "inputJson": "{\"customerName\":\"Jane Doe\",\"email\":\"jane.doe@example.com\",\"phoneNumber\":\"+15555550123\",\"address\":{\"street\":\"123 Maple Ave\",\"city\":\"Anytown\",\"state\":\"CA\",\"zipCode\":\"90210\",\"country\":\"USA\"},\"metadata\":{\"preferredContactMethod\":\"email\"}}", + "description": "Create a validated customer record with full contact and address info." + }, + { + "inputJson": "{\"customerName\":\"\",\"email\":\"invalid-email\",\"address\":{\"street\":\"\",\"city\":\"\",\"state\":\"\",\"zipCode\":\"\",\"country\":\"\"}}", + "description": "Fails validation due to missing name, invalid email, and empty address fields." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Customer", + "context": null + } + }, + { + "name": "etl-processes.generateDataset", + "description": "Generates a synthetic dataset based on specified schema definitions, data distributions, and record counts. Accepts a data schema and generation options, and produces a structured dataset in formats like JSON or CSV for use in testing, simulations, or development.", + "category": "etl-processes", + "parameters": [ + { + "name": "schema", + "type": "object", + "description": "Defines the dataset's structure including field names, data types, and constraints (e.g., min/max, categories). Required to guide data generation.", + "required": true, + "defaultValue": "" + }, + { + "name": "recordCount", + "type": "number", + "description": "Number of data records to generate. Must be a positive integer.", + "required": true, + "defaultValue": "1000" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated dataset output. Supported values include 'json' and 'csv'.", + "required": false, + "defaultValue": "json" + }, + { + "name": "randomSeed", + "type": "number", + "description": "Optional seed for random number generation to produce reproducible datasets.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "If true and output format is CSV, includes header row with field names.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated dataset as a string in requested format and metadata including schema and record count." + }, + "aiAgent": { + "useCase": "Use this tool when synthetic datasets are needed for testing, development, or data processing simulations where real data is unavailable or unsuitable. It allows generation of customizable datasets matching user-defined schemas and distributions to validate data pipelines or analytics.", + "limitations": "Cannot generate datasets with complex relational integrity between multiple tables; limited to single flat datasets. Does not synthesize truly complex natural language or image data beyond simple text or numeric values.", + "examples": [ + "Generate a dataset with 500 records including fields for name (string), age (integer), and signup date (date) in CSV format.", + "Create a JSON dataset of 1000 sensor readings with timestamp and temperature fields using a fixed random seed.", + "Produce a test dataset for a customer database schema using category distributions for gender and state fields." + ] + }, + "tags": [ + "data-generation", + "synthetic-data", + "dataset", + "testing", + "etl", + "simulation" + ], + "examples": [ + { + "inputJson": "{\"schema\":{\"fields\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"age\",\"type\":\"number\",\"min\":18,\"max\":80},{\"name\":\"signupDate\",\"type\":\"string\",\"format\":\"date\"}]},\"recordCount\":3,\"outputFormat\":\"json\",\"randomSeed\":42,\"includeHeaders\":true}", + "description": "Generate 3 records of user data with fields for name, age, and signup date in JSON format." + }, + { + "inputJson": "{\"schema\":{\"fields\":[{\"name\":\"sensorId\",\"type\":\"string\"},{\"name\":\"temperature\",\"type\":\"number\",\"min\":-20,\"max\":50}]},\"recordCount\":5,\"outputFormat\":\"csv\",\"includeHeaders\":true}", + "description": "Generate 5 records of sensor temperature data in CSV format with header included." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Dataset", + "context": null + } + }, + { + "name": "database-management.composeReport", + "description": "Generates a comprehensive database report by querying specified tables with filters and aggregations. Accepts database connection info, tables, fields, filters, and output format. Produces a structured report summarizing data insights, including statistics and formatted export (JSON, CSV, PDF).", + "category": "database-management", + "parameters": [ + { + "name": "connectionString", + "type": "string", + "description": "Database connection string to establish access (e.g., JDBC or URI)", + "required": true, + "defaultValue": "" + }, + { + "name": "tables", + "type": "array", + "description": "List of table names to include in the report", + "required": true, + "defaultValue": "" + }, + { + "name": "fields", + "type": "array", + "description": "List of fields/columns to select from each table", + "required": false, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Filter conditions as key-value pairs to apply (e.g., {status: 'active'})", + "required": false, + "defaultValue": "" + }, + { + "name": "aggregations", + "type": "object", + "description": "Aggregation functions to apply (e.g., count, sum) mapped to fields", + "required": false, + "defaultValue": "" + }, + { + "name": "groupBy", + "type": "array", + "description": "List of fields to group the aggregation by", + "required": false, + "defaultValue": "" + }, + { + "name": "limit", + "type": "number", + "description": "Maximum number of records to retrieve", + "required": false, + "defaultValue": "100" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the report output (e.g., 'JSON', 'CSV', 'PDF')", + "required": false, + "defaultValue": "JSON" + } + ], + "returns": { + "type": "object", + "description": "Report object containing queried data, aggregations, and metadata formatted as requested" + }, + "aiAgent": { + "useCase": "Use this tool when needing to generate detailed reports from one or more database tables by applying filters, selecting specific fields, performing aggregations, and outputting in common formats. Enables summarization of data insights for decision-making, audits, or data analysis tasks.", + "limitations": "Cannot execute complex multi-join queries beyond basic table selection and groupings. Performance depends on the datasource and connection stability. Does not provide real-time streaming reports.", + "examples": [ + "Create a sales summary report summarizing total sales per region filtered by date range.", + "Generate a user activity report including counts of logins by user roles.", + "Produce a CSV export of recent orders with customer details filtered to active customers only." + ] + }, + "tags": [ + "database", + "reporting", + "aggregation", + "query", + "data-analysis", + "export" + ], + "examples": [ + { + "inputJson": "{\"connectionString\":\"postgresql://user:pass@host:5432/dbname\",\"tables\":[\"orders\"],\"fields\":[\"order_id\",\"customer_id\",\"order_total\"],\"filters\":{\"order_status\":\"completed\"},\"aggregations\":{\"sum_order_total\":\"order_total\"},\"groupBy\":[\"customer_id\"],\"limit\":50,\"outputFormat\":\"JSON\"}", + "description": "Generate JSON report of total completed order amounts grouped by customer from orders table." + }, + { + "inputJson": "{\"connectionString\":\"mysql://user:pass@host:3306/salesdb\",\"tables\":[\"sales\"],\"fields\":[\"region\",\"sales_amount\"],\"aggregations\":{\"count_sales\":\"sales_amount\"},\"groupBy\":[\"region\"],\"outputFormat\":\"CSV\"}", + "description": "Create a CSV report counting sales entries grouped by region." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Report", + "context": null + } + }, + { + "name": "devops.analyzeDataset", + "description": "This tool accepts dataset files (CSV or JSON) related to deployment logs, build times, or infrastructure metrics, analyzes them using statistical methods and anomaly detection to uncover patterns, trends, or performance issues, and outputs a structured report summarizing key insights, anomalies, and recommendations for DevOps optimization.", + "category": "devops", + "parameters": [ + { + "name": "datasetFilePath", + "type": "string", + "description": "File path or URL to the dataset file (CSV or JSON) for analysis", + "required": true, + "defaultValue": "" + }, + { + "name": "fileType", + "type": "string", + "description": "Type of the dataset file: 'csv' or 'json'", + "required": true, + "defaultValue": "" + }, + { + "name": "analysisType", + "type": "string", + "description": "Type of analysis to perform: 'performanceTrend', 'anomalyDetection', or 'summaryStats'", + "required": false, + "defaultValue": "summaryStats" + }, + { + "name": "dateRange", + "type": "object", + "description": "Optional date range filter with keys 'startDate' and 'endDate' in ISO format to analyze data within a timeframe", + "required": false, + "defaultValue": "" + }, + { + "name": "sensitivityLevel", + "type": "number", + "description": "Anomaly detection sensitivity level (1-10), where 10 is most sensitive", + "required": false, + "defaultValue": "5" + }, + { + "name": "includeVisualizations", + "type": "boolean", + "description": "Whether to include visualization URLs or image references in the output report", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "A structured analysis report containing summary statistics, identified anomalies, trend insights, and optionally visualization references relevant to DevOps dataset analysis" + }, + "aiAgent": { + "useCase": "Use this tool when needing to analyze operational datasets from deployment pipelines, infrastructure monitoring, or build logs to derive actionable insights, detect unexpected behaviors, or understand performance trends for continuous improvement in DevOps workflows.", + "limitations": "This tool cannot modify datasets or fix issues. It focuses on analysis and does not process unstructured text logs or non-tabular data formats.", + "examples": [ + "Analyze a JSON dataset of deployment times to detect any delay anomalies", + "Provide summary statistics for a CSV log of infrastructure metrics over the last month", + "Generate a performance trend report from build logs filtered by date" + ] + }, + "tags": [ + "devops", + "dataset", + "analysis", + "performance", + "anomaly detection", + "infrastructure", + "automation" + ], + "examples": [ + { + "inputJson": "{\"datasetFilePath\":\"/data/build_logs.csv\",\"fileType\":\"csv\",\"analysisType\":\"performanceTrend\",\"dateRange\":{\"startDate\":\"2024-03-01\",\"endDate\":\"2024-03-31\"},\"sensitivityLevel\":7,\"includeVisualizations\":true}", + "description": "Analyze build logs CSV file from March 2024 to find performance trends with moderate anomaly sensitivity and include visualizations." + }, + { + "inputJson": "{\"datasetFilePath\":\"https://example.com/deployment_metrics.json\",\"fileType\":\"json\",\"analysisType\":\"anomalyDetection\",\"includeVisualizations\":false}", + "description": "Perform anomaly detection on deployment metrics dataset provided as JSON from a URL without visualizations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Dataset", + "context": null + } + }, + { + "name": "devops.downloadFile", + "description": "Downloads a file from a specified URL or remote server to a local destination path. Accepts input parameters such as the file URL, local destination path, optional HTTP headers for authentication, and a timeout duration. It performs an HTTP(S) GET request (or SFTP as specified) and writes the file content locally, returning the success status and file size if downloaded successfully.", + "category": "devops", + "parameters": [ + { + "name": "sourceUrl", + "type": "string", + "description": "The URL or remote path of the file to download. Supports HTTP, HTTPS, or SFTP URLs.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Local filesystem path where the downloaded file will be saved, including filename.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpHeaders", + "type": "object", + "description": "Optional HTTP headers (e.g., Authorization) sent with the download request. Ignored for SFTP.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for the download to complete before aborting. Defaults to 60 seconds.", + "required": false, + "defaultValue": "60" + }, + { + "name": "useSftp", + "type": "boolean", + "description": "If true, uses SFTP protocol for downloading instead of HTTP(S). If true, sourceUrl must be a valid SFTP URL.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object indicating whether the download was successful, the local file path, and size in bytes if successful, or an error message." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically retrieve files from remote HTTP(S) or SFTP sources during build, deployment, or infrastructure automation tasks. It helps download configuration files, artifacts, or scripts reliably to specified local paths with optional authentication.", + "limitations": "Cannot perform partial downloads or resume interrupted transfers. Limited to HTTP(S) GET method or basic SFTP downloads. Does not verify file integrity or handle complex authentication beyond HTTP headers or SFTP URL credentials.", + "examples": [ + "Download a public file from a HTTP URL to a local path.", + "Download a protected file from HTTPS with Authorization header.", + "Download a file from a SFTP server using SFTP URL format." + ] + }, + "tags": [ + "download", + "file", + "http", + "sftp", + "devops", + "automation", + "infrastructure" + ], + "examples": [ + { + "inputJson": "{\"sourceUrl\":\"https://example.com/releases/latest.zip\",\"destinationPath\":\"/tmp/latest.zip\"}", + "description": "Download the latest release archive from a public HTTPS URL to a temporary directory." + }, + { + "inputJson": "{\"sourceUrl\":\"https://private.example.com/config.yaml\",\"destinationPath\":\"/etc/config.yaml\",\"httpHeaders\":{\"Authorization\":\"Bearer abc123\"}}", + "description": "Download a protected configuration file over HTTPS with an authorization bearer token." + }, + { + "inputJson": "{\"sourceUrl\":\"sftp://user:password@example-sftp.com/home/user/script.sh\",\"destinationPath\":\"/usr/local/bin/script.sh\",\"useSftp\":true}", + "description": "Download a script file from an SFTP server using embedded credentials in the SFTP URL." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "File", + "context": null + } + }, + { + "name": "devops.uploadDocument", + "description": "Uploads a document file to a specified remote server or cloud storage as part of deployment or configuration management workflows. Accepts document files in common formats (e.g., PDF, DOCX, TXT), authenticates with the destination using provided credentials, optionally sets access permissions, and returns a confirmation including the storage URL and upload status.", + "category": "devops", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local filesystem path to the document to upload (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationUrl", + "type": "string", + "description": "URL or endpoint of the remote server or cloud storage to upload the document to (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "authToken", + "type": "string", + "description": "Authentication token or API key used to authorize the upload request (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "accessPermissions", + "type": "string", + "description": "Optional access level or permission setting for the uploaded document, e.g., 'private', 'public', or specific roles (optional).", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs containing metadata to associate with the document (optional).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the upload status ('success' or 'failure'), a message with details, and the URL to access the uploaded document if successful." + }, + "aiAgent": { + "useCase": "This tool should be used when there is a need to programmatically upload documents as part of automated deployment pipelines, configuration documentation, or infrastructure setup processes. It is suitable for scenarios where documents must be versioned, stored remotely, or shared securely within devops environments.", + "limitations": "This tool cannot modify the document contents prior to upload. It does not handle document conversion or complex permission management beyond basic access permission strings.", + "examples": [ + "Upload the latest architecture design PDF to the secure cloud storage endpoint with read-only access.", + "Upload a configuration changelog TXT file to the internal documentation server using the provided API key.", + "Store a project specification DOCX file to a remote endpoint with custom metadata for version and author." + ] + }, + "tags": [ + "devops", + "upload", + "document", + "deployment", + "automation", + "cloud-storage", + "configuration" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/home/user/docs/design.pdf\",\"destinationUrl\":\"https://storage.example.com/uploads\",\"authToken\":\"abcd1234token\",\"accessPermissions\":\"private\",\"metadata\":{\"version\":\"1.2\",\"author\":\"devops-team\"}}", + "description": "Upload a PDF design document to private cloud storage with metadata." + }, + { + "inputJson": "{\"filePath\":\"./changelog.txt\",\"destinationUrl\":\"https://docs.internal.company/api/upload\",\"authToken\":\"token123\",\"accessPermissions\":\"public\"}", + "description": "Upload a changelog text file to internal documentation server with public access." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "devops.formatCode", + "description": "This tool accepts source code in various programming languages and formats it according to specified style guidelines or configurations. It processes the raw code input to produce a consistently styled, clean, and readable code snippet, optionally supporting specific language and style presets.", + "category": "devops", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "The source code text that needs to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The programming language of the source code (e.g., 'javascript', 'python', 'java').", + "required": false, + "defaultValue": "" + }, + { + "name": "styleConfig", + "type": "object", + "description": "An optional object defining style rules or configuration (like indent size, max line length).", + "required": false, + "defaultValue": "" + }, + { + "name": "useDefaultConfig", + "type": "boolean", + "description": "If true, uses default formatting settings when styleConfig is not provided.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted code string, and optionally any errors or warnings produced during formatting." + }, + "aiAgent": { + "useCase": "Use this tool when you need to standardize source code format for better readability, maintainability, or to comply with team or industry style standards. It is useful for code review preparation, automated formatting in CI/CD pipelines, and improving code quality before deployment.", + "limitations": "This tool only formats code stylistically; it does not perform syntax checking beyond what is necessary for formatting. It may not fully support all language-specific nuances or extremely rare coding styles. Semantic errors or logical bugs are not detected or fixed.", + "examples": [ + "Format unformatted JavaScript code for consistent indentation and style.", + "Apply project-specific style rules to Python source code before committing.", + "Auto-format Java code using default settings for clean source presentation." + ] + }, + "tags": [ + "formatting", + "code", + "devops", + "style", + "automation", + "continuous-integration" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function foo(){console.log( 'hello' );}\",\"language\":\"javascript\",\"styleConfig\":{\"indentSize\":2}}", + "description": "Format compact JavaScript code with 2-space indentation." + }, + { + "inputJson": "{\"code\":\"def foo():\\n print( 'hello' )\\n\",\"language\":\"python\",\"useDefaultConfig\":true}", + "description": "Format Python code using default style guidelines." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "devops.generateText", + "description": "Generates customizable text content based on specified templates and variables, designed to create automated messages, deployment notes, or configuration descriptions for DevOps workflows. Accepts template strings with placeholders and variable mappings, producing fully rendered text outputs.", + "category": "devops", + "parameters": [ + { + "name": "template", + "type": "string", + "description": "The template string containing placeholders for variables to be replaced in the output text.", + "required": true, + "defaultValue": "" + }, + { + "name": "variables", + "type": "object", + "description": "A key-value map of variable names and their values to substitute into the template placeholders.", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "The language code for the generated text, enabling localization support (e.g., 'en', 'fr').", + "required": false, + "defaultValue": "en" + }, + { + "name": "maxLength", + "type": "number", + "description": "Optional maximum length of the generated text output to truncate if necessary.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated text string after template rendering and variable substitution, plus metadata such as length." + }, + "aiAgent": { + "useCase": "Use this tool when you need automated generation of descriptive or templated text in DevOps pipelines or documentation, such as release notes, deployment summaries, or alert messages that require dynamic insertion of environment variables or parameters.", + "limitations": "This tool cannot generate natural language text beyond templated substitutions; it does not perform AI-based content creation or contextual text understanding.", + "examples": [ + "Generate deployment notification with environment and version variables.", + "Create standardized error message text for alerts using given variables.", + "Produce changelog entries by substituting release info into a changelog template." + ] + }, + "tags": [ + "devops", + "text generation", + "templating", + "automation", + "documentation" + ], + "examples": [ + { + "inputJson": "{\"template\":\"Deployment completed in environment: {{environment}} with version: {{version}}.\",\"variables\":{\"environment\":\"production\",\"version\":\"1.4.2\"},\"language\":\"en\"}", + "description": "Generate a deployment completion message for production with version." + }, + { + "inputJson": "{\"template\":\"Alert: Service {{serviceName}} is down on host {{host}}.\",\"variables\":{\"serviceName\":\"api-server\",\"host\":\"host123\"}}", + "description": "Generate alert message when a specified service is detected down." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "devops.createAccount", + "description": "Creates a new user account in the DevOps system by accepting essential details such as username, email, role, and optional metadata. It validates inputs, assigns permissions based on the role, and returns confirmation with account ID and status.", + "category": "devops", + "parameters": [ + { + "name": "username", + "type": "string", + "description": "Unique username identifier for the account to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Email address associated with the user account.", + "required": true, + "defaultValue": "" + }, + { + "name": "role", + "type": "string", + "description": "Role assigned to the account which defines permissions (e.g., admin, developer, viewer).", + "required": true, + "defaultValue": "" + }, + { + "name": "fullName", + "type": "string", + "description": "Optional full name of the user.", + "required": false, + "defaultValue": "" + }, + { + "name": "enabled", + "type": "boolean", + "description": "Flag indicating if the account should be enabled immediately after creation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional free-form key-value pairs for additional account information such as department or location.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Object containing the new account's unique ID, creation status, and a message indicating success or the details of any failure." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create user accounts within a DevOps infrastructure or CI/CD environment, ensuring proper role-based access and metadata assignment with automated account provisioning.", + "limitations": "This tool does not handle password setting, password policies, or multi-factor authentication configuration. It also does not perform email verification or notification dispatch.", + "examples": [ + "Create a developer account with email and metadata", + "Create and enable an admin account immediately", + "Create a user account without enabling it initially" + ] + }, + "tags": [ + "devops", + "account management", + "user provisioning", + "automation", + "access control", + "role management" + ], + "examples": [ + { + "inputJson": "{\"username\":\"jdoe\",\"email\":\"jdoe@example.com\",\"role\":\"developer\",\"fullName\":\"John Doe\",\"enabled\":true,\"metadata\":{\"department\":\"engineering\",\"location\":\"NYC\"}}", + "description": "Creating an enabled developer account for John Doe with department and location metadata." + }, + { + "inputJson": "{\"username\":\"asmith\",\"email\":\"asmith@example.com\",\"role\":\"admin\",\"enabled\":true}", + "description": "Creating and enabling a new admin account without additional metadata." + }, + { + "inputJson": "{\"username\":\"mjones\",\"email\":\"mjones@example.com\",\"role\":\"viewer\",\"enabled\":false}", + "description": "Creating a viewer account that is disabled initially for later activation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Account", + "context": null + } + }, + { + "name": "devops.createImage", + "description": "Creates a container image based on user-provided Dockerfile content or configuration. Accepts raw Dockerfile text or a build context path, processes the build instructions, and outputs an image identifier with build logs and status information for use in deployment pipelines.", + "category": "devops", + "parameters": [ + { + "name": "dockerfileContent", + "type": "string", + "description": "The raw text content of the Dockerfile to build the container image from.", + "required": false, + "defaultValue": "" + }, + { + "name": "buildContextPath", + "type": "string", + "description": "The filesystem path or URL to the build context directory containing the Dockerfile and related files.", + "required": false, + "defaultValue": "" + }, + { + "name": "imageName", + "type": "string", + "description": "The desired name (including tag) for the resulting container image, e.g., 'myapp:latest'.", + "required": true, + "defaultValue": "" + }, + { + "name": "noCache", + "type": "boolean", + "description": "Whether to build the image without using cache to ensure a fresh build.", + "required": false, + "defaultValue": "false" + }, + { + "name": "pullBaseImage", + "type": "boolean", + "description": "Whether to always attempt to pull the latest base image before building.", + "required": false, + "defaultValue": "true" + }, + { + "name": "buildArgs", + "type": "object", + "description": "Key-value pairs of build-time variables to pass to the Docker build process.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum number of seconds to allow the build process before aborting.", + "required": false, + "defaultValue": "300" + } + ], + "returns": { + "type": "object", + "description": "An object containing the final image identifier (name and digest), build logs, and success status." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate building container images from given Dockerfile content or build contexts to integrate with CI/CD workflows or container deployment processes. It is suited for scenarios where infrastructure automation requires programmatic image creation and feedback on build status.", + "limitations": "This tool cannot build images without sufficient build context or Dockerfile instructions. It does not push images to remote registries; pushing must be handled separately. It also assumes Docker-compatible build environments are available.", + "examples": [ + "Build an image named 'webapp:latest' from provided Dockerfile content with no-cache.", + "Create an image 'dbservice:v1.0' using a local build context directory and passing build arguments for environment variables.", + "Build an image 'analytics:dev' with a 10-minute timeout and always pull the latest base image." + ] + }, + "tags": [ + "devops", + "container", + "build", + "docker", + "CI/CD", + "automation", + "image" + ], + "examples": [ + { + "inputJson": "{\"dockerfileContent\":\"FROM node:16-alpine\\nWORKDIR /app\\nCOPY package.json .\\nRUN npm install\\nCOPY . .\\nCMD [\\\"node\\\", \\\"index.js\\\"]\",\"imageName\":\"nodeapp:1.0\",\"noCache\":true}", + "description": "Build a Node.js application image from inline Dockerfile content using no cache." + }, + { + "inputJson": "{\"buildContextPath\":\"./microservice\",\"imageName\":\"microservice:stable\",\"pullBaseImage\":true,\"buildArgs\":{\"API_URL\":\"https://api.example.com\"}}", + "description": "Build image from a local directory with build arguments and always pull base image." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Image", + "context": null + } + }, + { + "name": "devops.createCommit", + "description": "Creates a new commit in a git repository by adding specified changes, author information, and commit message. It accepts the repository path, files to update or add, the commit message, and author details, performs the commit operation, and returns the commit hash and status.", + "category": "devops", + "parameters": [ + { + "name": "repositoryPath", + "type": "string", + "description": "File system path to the local git repository where the commit will be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "files", + "type": "object", + "description": "A dictionary/object with file paths as keys and their new content as values to be staged for commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "commitMessage", + "type": "string", + "description": "The message describing the changes included in the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Name of the commit author that will appear in git history.", + "required": false, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "Email of the commit author that will appear in git history.", + "required": false, + "defaultValue": "" + }, + { + "name": "branch", + "type": "string", + "description": "The git branch where the commit should be created; defaults to the current branch if not provided.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the commitHash (SHA string) and status ('success' or error message) indicating the result of the commit operation." + }, + "aiAgent": { + "useCase": "Use this tool when an automated system or AI agent needs to programmatically create a git commit in a local repository, for example during CI/CD pipeline automation, code generation tasks, or automated patching of a codebase. It is helpful when changes must be recorded with proper commit metadata.", + "limitations": "This tool does not handle pushing commits to remote repositories or resolving merge conflicts. It assumes the repository is valid and accessible locally, and user has write permission.", + "examples": [ + "Create a commit adding two new files with appropriate author info and message.", + "Amend a local git repository with a single file update and a descriptive commit message.", + "Commit changes on a specified branch rather than the default current branch." + ] + }, + "tags": [ + "devops", + "git", + "commit", + "automation", + "versionControl", + "ci/cd" + ], + "examples": [ + { + "inputJson": "{\"repositoryPath\":\"/home/user/myrepo\",\"files\":{\"src/app.js\":\"console.log(\\\"Hello World\\\");\"},\"commitMessage\":\"Add hello world logging\",\"authorName\":\"Alice\",\"authorEmail\":\"alice@example.com\"}", + "description": "Create a commit adding one file with a simple message and author info." + }, + { + "inputJson": "{\"repositoryPath\":\"/repo/project\",\"files\":{\"README.md\":\"# Project Updated\"},\"commitMessage\":\"Update README\",\"branch\":\"develop\"}", + "description": "Create a commit updating the README on a specific branch without author info." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Commit", + "context": null + } + }, + { + "name": "devops.createAPI", + "description": "Creates a RESTful API service scaffold based on specified configuration. Accepts API endpoint definitions, HTTP methods, data models, and authentication schemes as input. Generates boilerplate code in the chosen programming language with routing, validation, and basic security setup. Outputs the complete API project structure ready for deployment or further development.", + "category": "devops", + "parameters": [ + { + "name": "apiName", + "type": "string", + "description": "Name identifier for the API service (e.g., \"UserManagementAPI\").", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language/framework to generate the API in (e.g., \"NodeJS\", \"Python-Flask\").", + "required": true, + "defaultValue": "" + }, + { + "name": "endpoints", + "type": "array", + "description": "Array of endpoint definitions including path, HTTP method, expected parameters, and response schema.", + "required": true, + "defaultValue": "" + }, + { + "name": "authentication", + "type": "object", + "description": "Authentication scheme configuration such as type (e.g., \"JWT\", \"OAuth2\") and options.", + "required": false, + "defaultValue": "" + }, + { + "name": "databaseIntegration", + "type": "object", + "description": "Database connection and model mapping details (optional). Includes DB type, credentials, and schema mapping.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeValidation", + "type": "boolean", + "description": "Flag to include input validation middleware for endpoints.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated project output: \"zip\" archive or \"folder\" structure representation.", + "required": false, + "defaultValue": "zip" + } + ], + "returns": { + "type": "object", + "description": "Generated API project structure including source files, configuration, and documentation in specified output format." + }, + "aiAgent": { + "useCase": "Use this tool when an automated generation of a baseline API service is needed from high-level specifications. It helps in jumpstarting backend development with consistent structure, routing, validation, and security boilerplate, saving manual coding effort.", + "limitations": "Cannot fully implement business logic customization or complex multi-service architectures. Generated code is a scaffold requiring developer refinement. Database integration setup is basic and may need extensions for complex schemas.", + "examples": [ + "Create a NodeJS REST API named 'InventoryAPI' with CRUD endpoints for products, JWT authentication, and MongoDB integration.", + "Generate a Python Flask API scaffold with public GET endpoints and no authentication.", + "Produce a ZIP archive of a simple API service with input validation enabled for REST endpoints managing user data." + ] + }, + "tags": [ + "devops", + "api", + "automation", + "code-generation", + "rest", + "backend", + "scaffolding" + ], + "examples": [ + { + "inputJson": "{\"apiName\":\"InventoryAPI\",\"language\":\"NodeJS\",\"endpoints\":[{\"path\":\"/products\",\"method\":\"GET\",\"parameters\":[],\"responseSchema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"}}}}},{\"path\":\"/products\",\"method\":\"POST\",\"parameters\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"price\",\"type\":\"number\"}],\"responseSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"}}}}],\"authentication\":{\"type\":\"JWT\",\"secretKey\":\"supersecret\"},\"databaseIntegration\":{\"type\":\"MongoDB\",\"connectionString\":\"mongodb://localhost:27017/inventory\"},\"includeValidation\":true,\"outputFormat\":\"zip\"}", + "description": "Generate a NodeJS API called 'InventoryAPI' with GET and POST /products endpoints, JWT auth, MongoDB integration, and input validation, outputting a ZIP archive." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "devops.createContract", + "description": "Creates a standardized contract document for DevOps projects based on input parameters such as parties involved, scope, deliverables, timelines, payment terms, and compliance requirements. Processes inputs to generate a formatted contract text or PDF output ready for review and signature.", + "category": "devops", + "parameters": [ + { + "name": "partyA", + "type": "string", + "description": "Name of the first party in the contract (e.g., client or service provider).", + "required": true, + "defaultValue": "" + }, + { + "name": "partyB", + "type": "string", + "description": "Name of the second party in the contract (e.g., client or service provider).", + "required": true, + "defaultValue": "" + }, + { + "name": "projectScope", + "type": "string", + "description": "Detailed description of the project scope covered by the contract.", + "required": true, + "defaultValue": "" + }, + { + "name": "deliverables", + "type": "array", + "description": "List of key deliverables expected from the agreement.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "Project start date (ISO 8601 format, e.g., 2024-07-01).", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "Project end date or contract expiration date (ISO 8601 format).", + "required": true, + "defaultValue": "" + }, + { + "name": "paymentTerms", + "type": "string", + "description": "Description of payment terms, milestones, and conditions.", + "required": true, + "defaultValue": "" + }, + { + "name": "confidentiality", + "type": "boolean", + "description": "Whether to include a confidentiality clause in the contract.", + "required": false, + "defaultValue": "true" + }, + { + "name": "jurisdiction", + "type": "string", + "description": "Legal jurisdiction governing the contract (e.g., state or country).", + "required": false, + "defaultValue": "United States" + }, + { + "name": "format", + "type": "string", + "description": "Output document format, either 'text' or 'pdf'.", + "required": false, + "defaultValue": "text" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated contract document content as a string and metadata such as format and contract summary." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to draft a legally structured contract for DevOps-related services or projects, ensuring all key elements like parties, scope, deliverables, timelines, and payment terms are included consistently. It helps automate contract creation for infrastructure, deployment, or service agreements, reducing manual work and errors.", + "limitations": "This tool does not provide legal advice, cannot customize clauses beyond predefined templates, and should not replace review by a qualified legal professional.", + "examples": [ + "Create a contract between a cloud service provider and client specifying project milestones and confidentiality.", + "Generate a PDF contract for a DevOps consultancy engagement including payment milestones.", + "Draft a simple text contract covering deployment services with specified start and end dates." + ] + }, + "tags": [ + "devops", + "contract", + "automation", + "document-generation", + "legal", + "service-agreement", + "infrastructure", + "deployment" + ], + "examples": [ + { + "inputJson": "{\"partyA\":\"Acme Cloud Services\",\"partyB\":\"Tech Innovations LLC\",\"projectScope\":\"Setup and maintain CI/CD pipelines for microservices deployment.\",\"deliverables\":[\"CI/CD pipeline setup\",\"Documentation\",\"Quarterly maintenance reports\"],\"startDate\":\"2024-07-01\",\"endDate\":\"2025-06-30\",\"paymentTerms\":\"$10,000 upfront, $2,500 monthly\",\"confidentiality\":true,\"jurisdiction\":\"California, USA\",\"format\":\"pdf\"}", + "description": "Generate a PDF contract for cloud services with specified scope, deliverables, payment, and confidentiality." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Contract", + "context": null + } + }, + { + "name": "frontend-development.generateParagraph", + "description": "Generates a realistic, contextually appropriate HTML paragraph element based on input text content and formatting preferences. Accepts raw text or markdown, processes optional styling and formatting instructions, and outputs a semantic paragraph string suitable for immediate use in front-end development.", + "category": "frontend-development", + "parameters": [ + { + "name": "textContent", + "type": "string", + "description": "The main textual content to be included within the paragraph element.", + "required": true, + "defaultValue": "" + }, + { + "name": "format", + "type": "string", + "description": "Content format of the input text; supports 'plain' for raw text or 'markdown' for markdown syntax to be converted to HTML inside the paragraph.", + "required": false, + "defaultValue": "plain" + }, + { + "name": "classNames", + "type": "array", + "description": "Array of CSS class names to apply to the paragraph element for styling purposes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "id", + "type": "string", + "description": "Optional id attribute for the paragraph element to uniquely identify it in the DOM.", + "required": false, + "defaultValue": "" + }, + { + "name": "inlineStyles", + "type": "object", + "description": "Object representing CSS property-value pairs to be applied as inline styles on the paragraph element.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "escapeHtml", + "type": "boolean", + "description": "Flag indicating whether HTML special characters in the textContent should be escaped to prevent HTML injection (applicable when format is 'plain').", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "string", + "description": "A valid HTML paragraph string with applied content, classes, ids, and inline styles ready for insertion into frontend UI code." + }, + "aiAgent": { + "useCase": "Use this tool when needing to create HTML paragraph blocks dynamically based on varied text input and styling needs in web front-end development tasks. It helps convert raw or simple markdown text into safe, styled paragraph elements for seamless UI integration.", + "limitations": "Does not support nested complex HTML structures beyond paragraph level or advanced markdown beyond simple inline formatting. It is not a full HTML or markdown editor, and does not validate CSS styles, which must be valid CSS strings.", + "examples": [ + "Create a styled paragraph with markdown content describing a product feature.", + "Generate a simple paragraph with plain text and a unique id attribute.", + "Produce a paragraph with multiple CSS classes and inline styles from raw text input." + ] + }, + "tags": [ + "frontend", + "html", + "paragraph", + "text", + "ui-generation", + "markup", + "styling" + ], + "examples": [ + { + "inputJson": "{\"textContent\":\"This is a **bold** statement.\",\"format\":\"markdown\",\"classNames\":[\"highlight\",\"intro\"],\"id\":\"p1\",\"inlineStyles\":{\"color\":\"blue\",\"fontWeight\":\"700\"},\"escapeHtml\":true}", + "description": "Generate an HTML paragraph from markdown bold text, with two CSS classes, an id, and inline styles for color and font weight." + }, + { + "inputJson": "{\"textContent\":\"Welcome to the site!\",\"format\":\"plain\",\"classNames\":[],\"id\":\"welcome\",\"inlineStyles\":{},\"escapeHtml\":true}", + "description": "Create a simple paragraph with plain text, an id, no classes or styles." + }, + { + "inputJson": "{\"textContent\":\"Special characters <, > and & should be escaped.\",\"format\":\"plain\",\"classNames\":[\"notice\"],\"id\":\"\",\"inlineStyles\":{\"backgroundColor\":\"yellow\"},\"escapeHtml\":true}", + "description": "Generate a paragraph from plain text containing HTML special characters correctly escaped, with a CSS class and yellow background." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Paragraph", + "context": null + } + }, + { + "name": "frontend-development.generateSentence", + "description": "Generates a natural language sentence based on specified content type and complexity suitable for frontend UI messages or content placeholders. Accepts parameters defining tone, length, and contextual keywords, then produces a coherent, grammatically correct sentence string for user interface display or testing.", + "category": "frontend-development", + "parameters": [ + { + "name": "tone", + "type": "string", + "description": "The tone or style of the generated sentence such as formal, casual, friendly, or professional.", + "required": false, + "defaultValue": "\"neutral\"" + }, + { + "name": "length", + "type": "number", + "description": "Approximate length of the sentence in words; adjusts verbosity accordingly.", + "required": false, + "defaultValue": "15" + }, + { + "name": "keywords", + "type": "array", + "description": "List of keywords or key phrases to include or emphasize in the generated sentence.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en', 'es') to generate the sentence in.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "contextType", + "type": "string", + "description": "Context or category for the sentence such as 'notification', 'error message', 'instruction', or 'placeholder'.", + "required": false, + "defaultValue": "\"general\"" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated sentence string and metadata including length and tone." + }, + "aiAgent": { + "useCase": "Use this tool when a UI or frontend development workflow requires dynamically generated sample or real text suited to specific contexts like notifications, instructions, or placeholders to enhance UX or for testing interface layouts and content adaptation.", + "limitations": "The tool does not provide multi-sentence paragraphs or long-form content. It cannot guarantee domain-specific jargon or exact company terminology without provided keywords or context.", + "examples": [ + "Generate a friendly notification sentence using keywords ['update', 'profile']", + "Create a formal error message about login failure", + "Produce a short placeholder text for a search bar in Spanish" + ] + }, + "tags": [ + "frontend", + "content-generation", + "natural-language", + "ui-text", + "sentence-generation", + "placeholder-text" + ], + "examples": [ + { + "inputJson": "{\"tone\":\"friendly\",\"length\":12,\"keywords\":[\"update\",\"profile\"],\"contextType\":\"notification\"}", + "description": "Generate a friendly, about 12 words notification containing keywords 'update' and 'profile'." + }, + { + "inputJson": "{\"tone\":\"formal\",\"length\":15,\"keywords\":[\"login\",\"failed\"],\"contextType\":\"error message\"}", + "description": "Generate a formal error message stating a login failed." + }, + { + "inputJson": "{\"tone\":\"neutral\",\"length\":6,\"keywords\":[],\"language\":\"es\",\"contextType\":\"placeholder\"}", + "description": "Generate a short neutral placeholder text in Spanish." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Sentence", + "context": null + } + }, + { + "name": "backend-development.analyzeKPI", + "description": "This tool accepts key performance indicator (KPI) data as input, including metric values over time, targets, and context parameters. It performs statistical analysis such as trend detection, variance, and target achievement evaluation. The output is a detailed report with insights, anomaly flags, and growth or decline assessments to inform backend performance optimization and decision-making.", + "category": "backend-development", + "parameters": [ + { + "name": "kpiData", + "type": "array", + "description": "An array of objects representing KPI records, each including a timestamp and metric value. Required for analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "targetValue", + "type": "number", + "description": "The target metric value KPI should reach or maintain. Used to assess target achievement. Optional.", + "required": false, + "defaultValue": "" + }, + { + "name": "timePeriod", + "type": "string", + "description": "The time range over which to analyze KPIs, e.g., 'last_30_days', 'Q1_2024'. Optional; defaults to entire dataset if not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "minimumDataPoints", + "type": "number", + "description": "Minimum number of KPI data points required to perform a valid analysis. Defaults to 5.", + "required": false, + "defaultValue": "5" + }, + { + "name": "detectAnomalies", + "type": "boolean", + "description": "Whether to perform anomaly detection on the KPI data. Defaults to true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An analysis report including trend (positive, negative, stable), variance statistics, target achievement status, anomalies detected, and summary insights." + }, + "aiAgent": { + "useCase": "Use this tool when backend systems need detailed performance analysis from KPI data to track progress against targets, detect anomalies, and understand trends over specified periods. It supports decisions on scaling, optimization, or intervention based on quantified metrics.", + "limitations": "This tool analyzes KPI data only and does not interpret qualitative factors or external influences. It assumes clean, time-series KPI input and does not handle raw log files or databases directly.", + "examples": [ + "Analyze backend API response time KPIs over last month to check if performance targets were met.", + "Evaluate daily user signup KPIs to detect any sudden drop-offs or spikes.", + "Assess server uptime percentage KPIs for the last quarter to report stability trends." + ] + }, + "tags": [ + "backend", + "analytics", + "KPI", + "performance-analysis", + "statistics", + "anomaly-detection" + ], + "examples": [ + { + "inputJson": "{\"kpiData\":[{\"timestamp\":\"2024-04-01T00:00:00Z\",\"value\":95},{\"timestamp\":\"2024-04-02T00:00:00Z\",\"value\":97},{\"timestamp\":\"2024-04-03T00:00:00Z\",\"value\":92},{\"timestamp\":\"2024-04-04T00:00:00Z\",\"value\":90},{\"timestamp\":\"2024-04-05T00:00:00Z\",\"value\":85}],\"targetValue\":90,\"timePeriod\":\"last_5_days\",\"minimumDataPoints\":5,\"detectAnomalies\":true}", + "description": "Analyze five days of API uptime KPI data against a target of 90% to evaluate performance and detect anomalies." + }, + { + "inputJson": "{\"kpiData\":[{\"timestamp\":\"2024-03-01T00:00:00Z\",\"value\":120},{\"timestamp\":\"2024-03-15T00:00:00Z\",\"value\":130},{\"timestamp\":\"2024-04-01T00:00:00Z\",\"value\":125}],\"targetValue\":130,\"timePeriod\":\"Q1_2024\",\"minimumDataPoints\":3,\"detectAnomalies\":false}", + "description": "Analyze quarterly user signups KPI with fewer data points and without anomaly detection." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "KPI", + "context": null + } + }, + { + "name": "frontend-development.generateCSV", + "description": "Generates a CSV string from a given array of objects representing tabular data. Accepts input data and optional configuration parameters like custom delimiters, inclusion of header row, and encoding. Produces a CSV formatted string ready for download or further client-side processing.", + "category": "frontend-development", + "parameters": [ + { + "name": "data", + "type": "array", + "description": "Array of objects where each object represents a row with key-value pairs as columns. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeHeaders", + "type": "boolean", + "description": "Whether to include the object keys as the first CSV header row. Default is true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "delimiter", + "type": "string", + "description": "Character used to separate values in the CSV. Default is comma (,).", + "required": false, + "defaultValue": "," + }, + { + "name": "lineTerminator", + "type": "string", + "description": "String used to terminate lines in the CSV, e.g., \\r\\n or \\n. Default is \\r\\n.", + "required": false, + "defaultValue": "\r\n" + }, + { + "name": "quoteValues", + "type": "boolean", + "description": "Whether to wrap each value in double quotes to escape delimiters inside data. Default is true.", + "required": false, + "defaultValue": "true" + }, + { + "name": "encoding", + "type": "string", + "description": "Text encoding of the output CSV string, such as UTF-8 or ASCII. Default is UTF-8.", + "required": false, + "defaultValue": "UTF-8" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated CSV string under 'csvString' key." + }, + "aiAgent": { + "useCase": "Use this tool when you need to convert structured frontend data (usually in JSON object array form) into a CSV formatted string for generating downloadable reports, exporting datasets, or feeding CSV input into other client-side integrations. It handles common CSV formatting details like delimiters, headers, and quoting.", + "limitations": "This tool does not save files to disk or handle server-side CSV generation. It only produces CSV strings from client-side data. It cannot infer data types or sanitize data beyond simple quoting and escaping.", + "examples": [ + "Generate a CSV string from an array of user objects for export.", + "Create a CSV string with tab delimiter and no headers from sales data.", + "Produce a CSV string encoded in ASCII with newline line terminators." + ] + }, + "tags": [ + "frontend", + "csv", + "data-export", + "string-generation", + "utility" + ], + "examples": [ + { + "inputJson": "{\"data\":[{\"name\":\"Alice\",\"age\":30,\"city\":\"New York\"},{\"name\":\"Bob\",\"age\":25,\"city\":\"Los Angeles\"}],\"includeHeaders\":true}", + "description": "Generate CSV from array of user objects including headers with default settings." + }, + { + "inputJson": "{\"data\":[{\"product\":\"Widget\",\"price\":9.99},{\"product\":\"Gadget\",\"price\":14.99}],\"includeHeaders\":false,\"delimiter\":\"\\t\"}", + "description": "Generate tab-delimited CSV from product data without headers." + }, + { + "inputJson": "{\"data\":[{\"item\":\"Pen\",\"quantity\":10},{\"item\":\"Notebook\",\"quantity\":5}],\"encoding\":\"ASCII\",\"lineTerminator\":\"\\n\"}", + "description": "Generate CSV string encoded as ASCII with Unix style line terminators." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "CSV", + "context": null + } + }, + { + "name": "backend-development.analyzeDashboard", + "description": "Analyzes server-side dashboard analytics data by accepting input metrics, time ranges, and filter criteria. It processes usage data, error rates, and performance metrics to produce actionable insights, including summary statistics, trend analysis, and anomaly detection reports for backend application dashboards.", + "category": "backend-development", + "parameters": [ + { + "name": "dashboardId", + "type": "string", + "description": "Unique identifier of the dashboard to analyze", + "required": true, + "defaultValue": "" + }, + { + "name": "startTime", + "type": "string", + "description": "ISO 8601 timestamp indicating the start of the analysis period", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO 8601 timestamp indicating the end of the analysis period", + "required": true, + "defaultValue": "" + }, + { + "name": "metrics", + "type": "array", + "description": "List of metric names to analyze, such as ['requestCount', 'errorRate', 'responseTime']", + "required": false, + "defaultValue": "[]" + }, + { + "name": "filters", + "type": "object", + "description": "Optional key-value pairs to filter the analysis, such as {'region': 'us-east-1', 'instanceType': 't2.micro'}", + "required": false, + "defaultValue": "{}" + }, + { + "name": "includeAnomalies", + "type": "boolean", + "description": "Whether to include anomaly detection in the analysis output", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing summary statistics, trend data, anomaly reports, and metric breakdowns for the requested dashboard and time period" + }, + "aiAgent": { + "useCase": "Use this tool when you need detailed analytic insights about a backend application dashboard’s performance and usage metrics over a specified time period, helping to identify trends, anomalies, and key statistics for operational monitoring and decision making.", + "limitations": "This tool does not collect raw telemetry data itself and depends on existing data sources linked to the dashboard. It cannot analyze data outside the selected metrics or apply predictive modeling beyond anomaly detection.", + "examples": [ + "Analyze backend dashboard 'dash123' metrics from 2024-01-01 to 2024-01-31 with anomaly detection.", + "Provide error rate trends and usage summaries for the dashboard 'prodDashboard' filtering by region 'eu-west-1'.", + "Get response time and request count analytics for dashboard 'myAppDashboard' without anomaly reports." + ] + }, + "tags": [ + "analysis", + "dashboard", + "backend", + "metrics", + "performance", + "monitoring", + "analytics" + ], + "examples": [ + { + "inputJson": "{\"dashboardId\": \"dash123\", \"startTime\": \"2024-03-01T00:00:00Z\", \"endTime\": \"2024-03-07T23:59:59Z\", \"metrics\": [\"requestCount\", \"errorRate\"], \"filters\": {\"region\": \"us-east-1\"}, \"includeAnomalies\": true}", + "description": "Analyze request count and error rate for dashboard 'dash123' over one week in the US East region, including anomaly detection." + }, + { + "inputJson": "{\"dashboardId\": \"prodDashboard\", \"startTime\": \"2024-02-01T00:00:00Z\", \"endTime\": \"2024-02-28T23:59:59Z\", \"metrics\": [\"responseTime\"], \"filters\": {}, \"includeAnomalies\": false}", + "description": "Analyze response time trends for 'prodDashboard' for February 2024 without anomaly reporting." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Dashboard", + "context": null + } + }, + { + "name": "backend-development.uploadJSON", + "description": "Uploads structured JSON data to a specified backend API endpoint or database service. Accepts JSON string or object, validates syntax, optionally applies authentication headers, and sends the data via HTTP POST or PUT request. Returns success status and server response data or error details.", + "category": "backend-development", + "parameters": [ + { + "name": "jsonData", + "type": "object", + "description": "The JSON data object to upload to the backend service.", + "required": true, + "defaultValue": "" + }, + { + "name": "endpointUrl", + "type": "string", + "description": "The API endpoint URL where the JSON data will be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method to use for upload. Commonly POST or PUT.", + "required": false, + "defaultValue": "POST" + }, + { + "name": "authToken", + "type": "string", + "description": "Optional bearer token for authorization header if API requires authentication.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Timeout in seconds for the HTTP request before considering it failed.", + "required": false, + "defaultValue": "30" + }, + { + "name": "validateBeforeUpload", + "type": "boolean", + "description": "Flag to perform JSON schema validation before uploading if schema provided.", + "required": false, + "defaultValue": "false" + }, + { + "name": "jsonSchema", + "type": "object", + "description": "Optional JSON schema object to validate jsonData before upload if validateBeforeUpload is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the upload status and server response or error information." + }, + "aiAgent": { + "useCase": "Use this tool when you need to send JSON formatted data from an AI agent to a backend service for storage, processing, or integration, supporting optional authentication and validation before upload. It helps automate backend data ingestion tasks.", + "limitations": "This tool does not handle complex multipart uploads or binary data. It requires a reachable HTTP API endpoint. It does not provide advanced conflict resolution or retries beyond basic HTTP error returns.", + "examples": [ + "Upload user profile data JSON to a REST API with authentication.", + "Send configuration settings as JSON to a backend server endpoint for updating system state.", + "Validate and upload JSON payload to a cloud service API using HTTP POST." + ] + }, + "tags": [ + "upload", + "json", + "backend", + "api", + "http", + "authentication", + "validation" + ], + "examples": [ + { + "inputJson": "{\"jsonData\":{\"userId\":123,\"settings\":{\"theme\":\"dark\",\"notifications\":true}},\"endpointUrl\":\"https://api.example.com/user/settings\",\"httpMethod\":\"POST\",\"authToken\":\"Bearer abc123token\",\"timeoutSeconds\":15,\"validateBeforeUpload\":false}", + "description": "Upload user settings JSON data to a secured backend endpoint using POST with authentication." + }, + { + "inputJson": "{\"jsonData\":{\"productId\":\"XYZ\",\"price\":19.99,\"stock\":100},\"endpointUrl\":\"https://inventory.example.com/api/products/xyz\",\"httpMethod\":\"PUT\",\"validateBeforeUpload\":true,\"jsonSchema\":{\"type\":\"object\",\"properties\":{\"productId\":{\"type\":\"string\"},\"price\":{\"type\":\"number\"},\"stock\":{\"type\":\"number\"}},\"required\":[\"productId\",\"price\",\"stock\"]}}", + "description": "Validate and update product information JSON using PUT method on inventory API." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "JSON", + "context": null + } + }, + { + "name": "backend-development.uploadImage", + "description": "Uploads an image file to a specified backend server or cloud storage, accepting image data or URL, processing optional resizing and format conversion, and returns metadata including the accessible URL and storage info.", + "category": "backend-development", + "parameters": [ + { + "name": "imageData", + "type": "string", + "description": "Base64-encoded image data or URL string for the image to upload", + "required": true, + "defaultValue": "" + }, + { + "name": "targetStorage", + "type": "string", + "description": "Destination storage identifier, e.g., 'aws-s3', 'gcp-storage', or 'local'", + "required": true, + "defaultValue": "" + }, + { + "name": "resizeWidth", + "type": "number", + "description": "Optional width in pixels to resize the image; maintains aspect ratio if height not set", + "required": false, + "defaultValue": "" + }, + { + "name": "resizeHeight", + "type": "number", + "description": "Optional height in pixels to resize the image; maintains aspect ratio if width not set", + "required": false, + "defaultValue": "" + }, + { + "name": "convertFormat", + "type": "string", + "description": "Optional output image format to convert to, e.g., 'jpeg', 'png', 'webp'", + "required": false, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "If true, overwrite the file if it already exists at the destination", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs of metadata to associate with the uploaded image", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with image URL, storage location identifier, original and processed image sizes, and any error messages" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to upload image files to backend or cloud storage as part of a server-side workflow, including optional image resizing or format conversion. This supports scenarios like saving user uploads, processing images before serving, or managing media assets programmatically.", + "limitations": "Does not handle advanced image editing beyond resizing and format conversion; does not perform virus scanning on images; dependent on target storage service availability and credentials.", + "examples": [ + "Upload a user profile picture as a base64 string to AWS S3 with resizing to 256x256", + "Convert and upload an image from a URL to local server storage as a PNG file without resizing", + "Upload multiple metadata fields with an image upload to cloud storage" + ] + }, + "tags": [ + "backend", + "image", + "upload", + "media", + "storage", + "image-processing" + ], + "examples": [ + { + "inputJson": "{\"imageData\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA\",\"targetStorage\":\"aws-s3\",\"resizeWidth\":256,\"resizeHeight\":256,\"convertFormat\":\"jpeg\",\"overwriteExisting\":true}", + "description": "Upload a base64 image to AWS S3, resize to 256x256, convert to JPEG, and overwrite if exists." + }, + { + "inputJson": "{\"imageData\":\"https://example.com/image.jpg\",\"targetStorage\":\"local\",\"overwriteExisting\":false}", + "description": "Upload an image by URL to local server storage without resizing or format change." + }, + { + "inputJson": "{\"imageData\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA\",\"targetStorage\":\"gcp-storage\",\"metadata\":{\"author\":\"AI Agent\",\"category\":\"profile-pics\"}}", + "description": "Upload a base64 image to Google Cloud Storage with custom metadata tags." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Image", + "context": null + } + }, + { + "name": "backend-development.formatText", + "description": "This tool accepts a raw text string as input and formats it according to specified options such as line width, indentation style, and text casing. It processes the text by wrapping lines to the desired width, applying indentation spaces or tabs, and converting the text to uppercase, lowercase, or title case as requested. The output is a well-formatted, human-readable string optimized for backend system logs or API responses.", + "category": "backend-development", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The raw text string to be formatted", + "required": true, + "defaultValue": "" + }, + { + "name": "lineWidth", + "type": "number", + "description": "Maximum line length to wrap text (minimum 20)", + "required": false, + "defaultValue": "80" + }, + { + "name": "indentationType", + "type": "string", + "description": "Type of indentation to apply: 'spaces' or 'tabs'", + "required": false, + "defaultValue": "spaces" + }, + { + "name": "indentationSize", + "type": "number", + "description": "Number of spaces or tabs to indent each line (minimum 0)", + "required": false, + "defaultValue": "4" + }, + { + "name": "textCase", + "type": "string", + "description": "Text casing style: 'none', 'uppercase', 'lowercase', or 'titlecase'", + "required": false, + "defaultValue": "none" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted text string under the key 'formattedText'" + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to prepare text output that conforms to specific formatting standards for backend logging, debugging, or API response bodies. It is especially useful for enforcing consistent indentation and line width limits or applying uniform text casing to improve readability in server-side applications.", + "limitations": "This tool does not perform natural language corrections, semantic analysis, or translation. It only formats plain text; it cannot parse markup languages like HTML or Markdown, nor does it support rich text formatting.", + "examples": [ + "Format raw log messages with 100 character line width, using tabs for indentation, and uppercase text.", + "Convert error descriptions to title case and indent with 2 spaces without line wrapping.", + "Wrap paragraphs to 60 characters and convert all text to lowercase using 4 spaces indentation." + ] + }, + "tags": [ + "text", + "formatting", + "backend", + "logging", + "indentation", + "line-wrapping", + "case-conversion" + ], + "examples": [ + { + "inputJson": "{\"text\":\"Error: Invalid user input detected at line 42. Please check the submitted data.\",\"lineWidth\":50,\"indentationType\":\"spaces\",\"indentationSize\":2,\"textCase\":\"uppercase\"}", + "description": "Format error message with max 50 chars per line, 2 spaces indentation, and convert text to uppercase." + }, + { + "inputJson": "{\"text\":\"this is a sample message.\",\"lineWidth\":80,\"indentationType\":\"tabs\",\"indentationSize\":1,\"textCase\":\"titlecase\"}", + "description": "Format a short sentence using tabs for indentation and title casing without line wrapping." + }, + { + "inputJson": "{\"text\":\"WARNING: Low disk space. Please free up some space to prevent data loss.\",\"lineWidth\":60,\"indentationType\":\"spaces\",\"indentationSize\":4,\"textCase\":\"lowercase\"}", + "description": "Wrap warning message to 60 characters, indent by 4 spaces, and convert to lowercase." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Text", + "context": null + } + }, + { + "name": "backend-development.composeMessage", + "description": "This tool creates structured message objects for backend applications by accepting inputs such as recipient info, subject, body text, and optional metadata. It processes these inputs to produce a consistent message object ready for sending, storing, or further processing in server-side workflows.", + "category": "backend-development", + "parameters": [ + { + "name": "recipient", + "type": "string", + "description": "The email address or identifier of the message recipient.", + "required": true, + "defaultValue": "" + }, + { + "name": "subject", + "type": "string", + "description": "The subject line of the message.", + "required": true, + "defaultValue": "" + }, + { + "name": "body", + "type": "string", + "description": "The main content of the message body, supporting plain text or simple markup.", + "required": true, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "List of attachment objects (e.g., filenames or URLs) to include with the message.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs for additional message data such as priority, tags, or custom headers.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "isHtml", + "type": "boolean", + "description": "Flag indicating if the body content is HTML formatted.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "Returns a structured message object containing all inputs organized consistently for downstream backend processing or transport." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to generate standardized message objects for backend workflows such as sending emails, notifications, or logging communications. It ensures consistent structure and supports optional attachments and metadata for richer messages.", + "limitations": "This tool does not handle the actual transmission or delivery of messages, only composition into a structured format.", + "examples": [ + "Compose an email message to user@example.com with a welcome subject and body.", + "Create a notification message with priority metadata and an HTML body.", + "Generate a message object including attachments and custom tags for audit logging." + ] + }, + "tags": [ + "backend", + "message", + "compose", + "email", + "notification", + "communication" + ], + "examples": [ + { + "inputJson": "{\"recipient\":\"user@example.com\",\"subject\":\"Welcome to Our Service\",\"body\":\"Hello! We're glad to have you.\",\"isHtml\":false}", + "description": "Compose a simple welcome text message to a user." + }, + { + "inputJson": "{\"recipient\":\"admin@domain.com\",\"subject\":\"Server Alert\",\"body\":\" High CPU usage detected.
\",\"isHtml\":true,\"metadata\":{\"priority\":\"high\",\"category\":\"alert\"}}", + "description": "Compose an HTML alert message with priority metadata for administration." + }, + { + "inputJson": "{\"recipient\":\"client@business.org\",\"subject\":\"Meeting Notes\",\"body\":\"Please find attached the notes.\",\"attachments\":[{\"filename\":\"notes.pdf\",\"url\":\"https://fileserver/notes.pdf\"}]}", + "description": "Compose a message with an attachment link to share meeting notes." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "compose", + "object": "Message", + "context": null + } + }, + { + "name": "backend-development.generateLink", + "description": "Generates a customized URL link for backend applications based on the given base URL, query parameters, and optional URL path segments. Processes inputs to correctly encode and assemble a valid HTTP or HTTPS link that can be used in API endpoints, redirects or resource references.", + "category": "backend-development", + "parameters": [ + { + "name": "baseUrl", + "type": "string", + "description": "The base URL or domain to start the link from, e.g., 'https://example.com'. Must include protocol.", + "required": true, + "defaultValue": "" + }, + { + "name": "pathSegments", + "type": "array", + "description": "Optional array of path segments (strings) to append to the base URL, e.g., ['api', 'v1', 'users']. These are URI-encoded.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "queryParams", + "type": "object", + "description": "An optional object representing URL query parameters as key-value pairs to be appended to the link. Values will be encoded accordingly.", + "required": false, + "defaultValue": "" + }, + { + "name": "useHttps", + "type": "boolean", + "description": "Whether to enforce HTTPS protocol in the generated link. If false, will keep the protocol from the base URL.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing the full assembled URL string in the 'url' property." + }, + "aiAgent": { + "useCase": "Use this tool whenever you need to programmatically construct valid URLs in backend systems, such as constructing API endpoint references, redirect URLs, or resource links with dynamic path and query parameters. This ensures proper URL encoding and assembly, reducing errors.", + "limitations": "This tool does not validate if the generated link resolves or is reachable, nor does it handle URL fragment identifiers (#). It only assembles URLs syntactically correctly based on inputs.", + "examples": [ + "Generate a user profile API endpoint link with user ID as path segment and include a query parameter for detail level.", + "Construct a redirect link enforcing HTTPS while preserving base domain and adding query filters." + ] + }, + "tags": [ + "URL", + "link generation", + "backend", + "API", + "HTTP", + "query parameters", + "path segments" + ], + "examples": [ + { + "inputJson": "{\"baseUrl\":\"http://example.com\",\"pathSegments\":[\"api\",\"v1\",\"users\",\"123\"],\"queryParams\":{\"active\":\"true\",\"sort\":\"name\"},\"useHttps\":true}", + "description": "Generate an HTTPS API user detail link with query parameters." + }, + { + "inputJson": "{\"baseUrl\":\"https://service.domain.com\",\"pathSegments\":[\"files\",\"download\"],\"queryParams\":{\"fileId\":\"a1b2c3\"},\"useHttps\":true}", + "description": "Generate a secure download link with fileId parameter." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Link", + "context": null + } + }, + { + "name": "backend-development.createComment", + "description": "Creates a new comment associated with a specified resource within a backend system. Accepts inputs including resource type, resource ID, author information, and comment text. Validates inputs and stores the comment, returning a structured response with comment metadata and storage confirmation.", + "category": "backend-development", + "parameters": [ + { + "name": "resourceType", + "type": "string", + "description": "Type or category of the resource the comment is associated with (e.g., 'post', 'ticket').", + "required": true, + "defaultValue": "" + }, + { + "name": "resourceId", + "type": "string", + "description": "Unique identifier of the resource to which the comment is attached.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorId", + "type": "string", + "description": "Identifier of the user creating the comment; used for tracking and attribution.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "Display name of the comment author; can be used in the UI for attribution.", + "required": false, + "defaultValue": "" + }, + { + "name": "commentText", + "type": "string", + "description": "The textual content of the comment to store.", + "required": true, + "defaultValue": "" + }, + { + "name": "parentCommentId", + "type": "string", + "description": "If replying to another comment, the ID of the parent comment. Leave empty for top-level comments.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional metadata for the comment (e.g., tags, flags).", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the stored comment's unique ID, timestamp, status, and associated metadata, confirming successful creation." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically add or submit a comment to a resource in a backend system, such as posting user feedback, notes on tickets, or discussion on content items. It facilitates structured creation of comments with proper attribution and contextual linkage to resources.", + "limitations": "This tool does not perform content moderation, sentiment analysis, or real-time notification dispatch; these should be handled by separate systems or toolchains.", + "examples": [ + "Create a comment replying to a helpdesk ticket with author info and text.", + "Add a top-level comment to a blog post with user ID and message.", + "Append a support note to a project task with optional metadata tags." + ] + }, + "tags": [ + "backend", + "comments", + "API", + "resource-management", + "discussion", + "user-interaction" + ], + "examples": [ + { + "inputJson": "{\"resourceType\":\"post\",\"resourceId\":\"abc123\",\"authorId\":\"user789\",\"authorName\":\"Alice\",\"commentText\":\"Great post, thanks for sharing!\"}", + "description": "Adding a top-level comment expressing appreciation on a blog post." + }, + { + "inputJson": "{\"resourceType\":\"ticket\",\"resourceId\":\"ticket456\",\"authorId\":\"tech234\",\"commentText\":\"Investigating the issue; will update soon.\",\"parentCommentId\":\"cmt001\"}", + "description": "Adding a reply comment to an existing helpdesk ticket comment thread." + }, + { + "inputJson": "{\"resourceType\":\"task\",\"resourceId\":\"task999\",\"authorId\":\"user555\",\"commentText\":\"Completed initial tests.\",\"metadata\":{\"priority\":\"high\",\"status\":\"review\"}}", + "description": "Appending a comment to a project task with metadata tagging its priority and status." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Comment", + "context": null + } + }, + { + "name": "backend-development.createLink", + "description": "Generates a fully formatted HTTP link based on input parameters such as base URL, path segments, query parameters, and optional fragment. Accepts strings and objects for flexible URL construction and outputs a valid, encoded URL string ready for API requests or web navigation.", + "category": "backend-development", + "parameters": [ + { + "name": "baseUrl", + "type": "string", + "description": "The base URL domain (e.g., 'https://example.com') to start the link with, required to form a valid URL.", + "required": true, + "defaultValue": "" + }, + { + "name": "pathSegments", + "type": "array", + "description": "An array of strings representing path segments to be appended to the base URL, joined by slashes.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "queryParams", + "type": "object", + "description": "An object representing key-value pairs for query parameters to be appended after a '?', properly URL-encoded.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "fragment", + "type": "string", + "description": "Optional URL fragment (hash) to append at the end of the URL, e.g., 'section1'.", + "required": false, + "defaultValue": "" + }, + { + "name": "useHttps", + "type": "boolean", + "description": "Flag to enforce HTTPS protocol. If the base URL does not specify protocol or uses HTTP, it will be replaced to HTTPS if true.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object with a single field 'url' containing the complete, encoded URL string combining all inputs." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically construct valid HTTP(S) URLs from separate parts such as domain, path, query parameters, and optional fragments to consume APIs, generate links dynamically, or facilitate navigation in server-side applications.", + "limitations": "Does not validate that the baseUrl is reachable or that query parameter values conform to specific API schemas. It does not support authentication tokens or perform network requests itself.", + "examples": [ + "Create a URL for API endpoint with query filters.", + "Build a user profile link with path and section anchor.", + "Generate a search URL with multiple parameters." + ] + }, + "tags": [ + "backend", + "url", + "link", + "http", + "api", + "web", + "utility" + ], + "examples": [ + { + "inputJson": "{\"baseUrl\":\"https://api.example.com\",\"pathSegments\":[\"v1\",\"users\"],\"queryParams\":{\"id\":\"123\",\"active\":\"true\"},\"fragment\":\"details\",\"useHttps\":true}", + "description": "Creates a user details API link with query params and fragment." + }, + { + "inputJson": "{\"baseUrl\":\"http://example.com\",\"pathSegments\":[\"about\",\"team\"],\"queryParams\":{},\"fragment\":\"\",\"useHttps\":true}", + "description": "Forces HTTPS and creates a team page link." + }, + { + "inputJson": "{\"baseUrl\":\"https://search.example.com\",\"pathSegments\":[],\"queryParams\":{\"q\":\"openai\",\"page\":\"2\"},\"fragment\":\"results\",\"useHttps\":true}", + "description": "Creates a search URL with query and fragment." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Link", + "context": null + } + }, + { + "name": "backend-development.generateArticle", + "description": "Generates a detailed, structured article based on a provided topic and optional style parameters. Accepts inputs such as the main topic, subtopics, desired article length, and tone; processes this information to produce a well-organized, coherent article suitable for blogs, documentation, or educational content. Returns the article text along with key metadata.", + "category": "backend-development", + "parameters": [ + { + "name": "topic", + "type": "string", + "description": "Primary subject or theme to generate the article about.", + "required": true, + "defaultValue": "" + }, + { + "name": "subtopics", + "type": "array", + "description": "Optional list of subtopics or points to include in the article for more detailed coverage.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "length", + "type": "number", + "description": "Desired approximate length of the article in words; influences detail level.", + "required": false, + "defaultValue": "1000" + }, + { + "name": "tone", + "type": "string", + "description": "Preferred tone or style of the article such as formal, casual, technical, or persuasive.", + "required": false, + "defaultValue": "formal" + }, + { + "name": "includeReferences", + "type": "boolean", + "description": "Whether to include references or citations for factual information when applicable.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated article text along with metadata like word count and sections." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically generate comprehensive, coherent articles on specified topics, particularly for blog content, technical documentation, or educational materials. It helps automate writing tasks where structured, readable content is required according to specified style and depth.", + "limitations": "The generated articles might not always reflect the latest information or highly specialized expert knowledge. It cannot replace human expert review for accuracy-sensitive contexts. It may also produce repetitive or generic content if inputs are vague or overly broad.", + "examples": [ + "Generate a 1500-word technical article on blockchain technology with formal tone and including references.", + "Create a casual, 800-word article about sustainable living with specified subtopics like recycling and energy saving.", + "Produce a 1200-word persuasive article on the benefits of remote work without references." + ] + }, + "tags": [ + "article generation", + "content creation", + "backend", + "documentation", + "blog writing", + "AI writing", + "text generation" + ], + "examples": [ + { + "inputJson": "{\"topic\":\"Artificial Intelligence in Healthcare\",\"subtopics\":[\"applications\",\"benefits\",\"challenges\"],\"length\":1200,\"tone\":\"formal\",\"includeReferences\":true}", + "description": "Generate a formal 1200-word article about AI in healthcare covering applications, benefits, and challenges with references." + }, + { + "inputJson": "{\"topic\":\"Travel Tips for Japan\",\"length\":800,\"tone\":\"casual\"}", + "description": "Create a casual, 800-word travel tips article about Japan without specified subtopics or references." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Article", + "context": null + } + }, + { + "name": "backend-development.createQuery", + "description": "Generates a parameterized database query string and corresponding parameters object based on provided specifications, including table name, selected fields, conditions, sorting, pagination, and query type (SELECT, INSERT, UPDATE, DELETE). Inputs specify query components, output is a safe query string and parameters for use in backend database operations.", + "category": "backend-development", + "parameters": [ + { + "name": "queryType", + "type": "string", + "description": "Type of SQL query to generate: SELECT, INSERT, UPDATE, or DELETE.", + "required": true, + "defaultValue": "" + }, + { + "name": "tableName", + "type": "string", + "description": "Name of the database table to query.", + "required": true, + "defaultValue": "" + }, + { + "name": "fields", + "type": "array", + "description": "Array of field names to select or modify. For SELECT, these are columns to retrieve; for INSERT/UPDATE, these are columns to write to.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "conditions", + "type": "object", + "description": "Object representing WHERE clause conditions, where keys are field names and values are matching criteria. Supports simple equality matching.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "sortBy", + "type": "string", + "description": "Field name to sort results by (applicable for SELECT queries).", + "required": false, + "defaultValue": "" + }, + { + "name": "sortOrder", + "type": "string", + "description": "Sort order: ASC or DESC (applicable for SELECT queries).", + "required": false, + "defaultValue": "ASC" + }, + { + "name": "limit", + "type": "number", + "description": "Maximum number of records to return (applicable for SELECT queries).", + "required": false, + "defaultValue": "" + }, + { + "name": "offset", + "type": "number", + "description": "Number of records to skip before starting to return records (applicable for SELECT queries).", + "required": false, + "defaultValue": "" + }, + { + "name": "data", + "type": "object", + "description": "Object with key-value pairs for columns and values to insert or update (required for INSERT and UPDATE queries).", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing 'queryString' with the parameterized SQL query string and 'parameters' array with corresponding parameter values for safe query execution." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to dynamically generate safe and parameterized SQL queries for various operations (SELECT, INSERT, UPDATE, DELETE) based on user input or application logic, avoiding manual string concatenation and reducing SQL injection risks.", + "limitations": "This tool does not support complex query features such as JOINs, subqueries, advanced condition operators (e.g., IN, BETWEEN), or database-specific SQL dialect peculiarities. It handles basic queries with simple WHERE conditions only.", + "examples": [ + "Create a SELECT query to get 'id' and 'name' from 'users' table where 'status'='active', sort by 'created_at' descending, limit 10.", + "Generate an INSERT query to add a new user with fields 'name', 'email', and 'age'.", + "Build an UPDATE query to set 'status'='inactive' for user with id=123." + ] + }, + "tags": [ + "backend", + "database", + "query", + "SQL", + "parameterized", + "select", + "insert", + "update", + "delete" + ], + "examples": [ + { + "inputJson": "{\"queryType\":\"SELECT\",\"tableName\":\"users\",\"fields\":[\"id\",\"name\"],\"conditions\":{\"status\":\"active\"},\"sortBy\":\"created_at\",\"sortOrder\":\"DESC\",\"limit\":10}", + "description": "Generate a SELECT query to retrieve id and name from users where status is active, sorted by created_at descending, limit 10." + }, + { + "inputJson": "{\"queryType\":\"INSERT\",\"tableName\":\"users\",\"data\":{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"age\":30}}", + "description": "Create an INSERT query to add a new user with name, email, and age." + }, + { + "inputJson": "{\"queryType\":\"UPDATE\",\"tableName\":\"users\",\"data\":{\"status\":\"inactive\"},\"conditions\":{\"id\":123}}", + "description": "Build an UPDATE query to set status to inactive for user with id 123." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Query", + "context": null + } + }, + { + "name": "backend-development.createVideo", + "description": "Creates a customizable video file by combining provided media assets such as images, video clips, text overlays, and background audio. Accepts input parameters to set video resolution, format, frame rate, and duration, then processes and merges the media to output a finalized video file URL or binary.", + "category": "backend-development", + "parameters": [ + { + "name": "videoResolution", + "type": "string", + "description": "The desired resolution for the output video, e.g. '1920x1080'.", + "required": true, + "defaultValue": "1920x1080" + }, + { + "name": "videoFormat", + "type": "string", + "description": "The format of the output video file, e.g. 'mp4', 'webm', 'mov'.", + "required": true, + "defaultValue": "mp4" + }, + { + "name": "frameRate", + "type": "number", + "description": "Frame rate of the output video in frames per second.", + "required": false, + "defaultValue": "30" + }, + { + "name": "durationSeconds", + "type": "number", + "description": "Total duration of the video in seconds. If input media is shorter, loops or pads to this length.", + "required": true, + "defaultValue": "" + }, + { + "name": "mediaAssets", + "type": "array", + "description": "Array of media objects (images, video clips, text overlays, audio) with properties defining start time, duration, type, and content/source.", + "required": true, + "defaultValue": "" + }, + { + "name": "backgroundAudio", + "type": "string", + "description": "Optional URL or identifier of background audio track to include in the video.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputStorage", + "type": "object", + "description": "Optional configuration details for storing the output video (e.g., cloud storage info, folder path).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Result object containing the URL or storage location of the created video file and metadata such as file size, duration, and format." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate videos by composing various media elements (images, clips, text, audio) with specific technical settings like resolution and frame rate. It is suited for backend applications automating video creation for marketing, tutorials, or content generation.", + "limitations": "Does not perform advanced video editing effects like transitions or color grading. Input media must be pre-formatted and compatible. Real-time streaming or live video generation is not supported.", + "examples": [ + "Create a 30-second 1080p MP4 video from provided images and text overlays with background music.", + "Generate a video clip by stitching multiple short video segments into a single file with consistent frame rate and resolution.", + "Produce an instructional video by embedding text captions on top of video content and exporting as a web-friendly format." + ] + }, + "tags": [ + "video", + "media-processing", + "backend", + "video-generation", + "automation", + "multimedia" + ], + "examples": [ + { + "inputJson": "{\"videoResolution\":\"1280x720\",\"videoFormat\":\"mp4\",\"frameRate\":24,\"durationSeconds\":60,\"mediaAssets\":[{\"type\":\"image\",\"source\":\"https://example.com/image1.jpg\",\"startTime\":0,\"duration\":30},{\"type\":\"text\",\"content\":\"Welcome to our service!\",\"startTime\":5,\"duration\":10}],\"backgroundAudio\":\"https://example.com/audio.mp3\"}", + "description": "Creates a 60 seconds 720p MP4 video combining an image and a text overlay with background music." + }, + { + "inputJson": "{\"videoResolution\":\"1920x1080\",\"videoFormat\":\"webm\",\"durationSeconds\":120,\"mediaAssets\":[{\"type\":\"video\",\"source\":\"https://example.com/clip1.mp4\",\"startTime\":0,\"duration\":60},{\"type\":\"video\",\"source\":\"https://example.com/clip2.mp4\",\"startTime\":60,\"duration\":60}]}", + "description": "Combines two 1-minute video clips back-to-back into a 2-minute 1080p WebM video file." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Video", + "context": null + } + }, + { + "name": "backend-development.createArticle", + "description": "Creates a new article in the backend system by accepting details such as title, content, author ID, tags, and publication status. Processes this input to store a fully structured article entity and returns the saved article data including its unique identifier and timestamps.", + "category": "backend-development", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the article to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "content", + "type": "string", + "description": "The main body content of the article, supports text and HTML formatting.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorId", + "type": "string", + "description": "Unique identifier of the author creating the article.", + "required": true, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "List of keywords or categories associated with the article for better classification.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "isPublished", + "type": "boolean", + "description": "Flag indicating whether the article should be immediately published or saved as a draft.", + "required": false, + "defaultValue": "false" + }, + { + "name": "summary", + "type": "string", + "description": "Optional brief summary or excerpt of the article content.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the newly created article's unique ID, title, content, authorId, tags, publication status, summary, createdAt, updatedAt timestamps." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically create and store articles in a backend content management system, for example, during CMS automation, content ingestion pipelines, or API-driven publishing workflows. It ensures structured input is processed and stored, returning a full article record with metadata.", + "limitations": "This tool does not perform content validation beyond required fields, such as grammar or plagiarism checking, nor does it handle multimedia attachments or rich media embedding.", + "examples": [ + "Create a new blog post titled 'AI in Healthcare' with tags 'AI','healthcare', authored by user123, and publish immediately.", + "Save a draft article about 'Serverless Architecture Best Practices' by author456 with no tags and include a summary.", + "Create a news update article with minimal content and mark it as unpublished for later review." + ] + }, + "tags": [ + "backend", + "article", + "content-management", + "create", + "api", + "cms" + ], + "examples": [ + { + "inputJson": "{\"title\":\"The Future of AI\",\"content\":\"AI is transforming industries worldwide.\",\"authorId\":\"author001\",\"tags\":[\"AI\",\"technology\"],\"isPublished\":true,\"summary\":\"A brief overview of AI advancements.\"}", + "description": "Creating and publishing a new article with tags and a summary." + }, + { + "inputJson": "{\"title\":\"Weekly Update\",\"content\":\"This week we focused on backend optimization.\",\"authorId\":\"author002\",\"isPublished\":false}", + "description": "Saving a draft article without tags or summary." + }, + { + "inputJson": "{\"title\":\"Cloud Security Tips\",\"content\":\"Implement multi-factor authentication and encryption.\",\"authorId\":\"author789\",\"tags\":[\"security\",\"cloud\"],\"isPublished\":true}", + "description": "Publishing a security tips article with relevant tags." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Article", + "context": null + } + }, + { + "name": "web-development.sendEmail", + "description": "Sends an email message through an SMTP server. Accepts parameters such as recipient addresses, sender address, subject, body content (plain text or HTML), and optional attachments. Processes the inputs to format and dispatch the email, returning success status and message ID or error details.", + "category": "web-development", + "parameters": [ + { + "name": "smtpHost", + "type": "string", + "description": "The hostname or IP address of the SMTP server to connect to.", + "required": true, + "defaultValue": "" + }, + { + "name": "smtpPort", + "type": "number", + "description": "The port number of the SMTP server (commonly 25, 465, or 587).", + "required": true, + "defaultValue": "" + }, + { + "name": "smtpUsername", + "type": "string", + "description": "Username for SMTP authentication if required.", + "required": false, + "defaultValue": "" + }, + { + "name": "smtpPassword", + "type": "string", + "description": "Password for SMTP authentication if required.", + "required": false, + "defaultValue": "" + }, + { + "name": "from", + "type": "string", + "description": "Email address that appears as the sender.", + "required": true, + "defaultValue": "" + }, + { + "name": "to", + "type": "array", + "description": "List of recipient email addresses.", + "required": true, + "defaultValue": "[]" + }, + { + "name": "cc", + "type": "array", + "description": "Optional list of carbon copy email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "Optional list of blind carbon copy email addresses.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyText", + "type": "string", + "description": "Plain text version of the email body.", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "HTML version of the email body.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Optional array of attachments, each object including filename and base64-encoded content.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "useSSL", + "type": "boolean", + "description": "Whether to use SSL/TLS when connecting to the SMTP server.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "An object containing whether the send was successful; if successful, includes a message ID, otherwise an error message." + }, + "aiAgent": { + "useCase": "Use this tool when a system or application needs to programmatically send emails, such as notifications, password resets, marketing emails, or alerts. It enables automated communication via SMTP compliant mail servers and supports attachments and rich text formatting.", + "limitations": "This tool does not handle email queueing, retries on failure, or advanced spam filtering. It requires valid SMTP credentials and network access to the mail server. It does not generate email content automatically.", + "examples": [ + "Send a password reset email to a user.", + "Send a marketing newsletter with an HTML template and embedded images.", + "Send an alert to multiple recipients with attachments from a monitoring system." + ] + }, + "tags": [ + "email", + "smtp", + "communication", + "notification", + "web", + "automation", + "marketing" + ], + "examples": [ + { + "inputJson": "{\"smtpHost\":\"smtp.example.com\",\"smtpPort\":587,\"smtpUsername\":\"user@example.com\",\"smtpPassword\":\"password123\",\"from\":\"no-reply@example.com\",\"to\":[\"user1@example.com\"],\"subject\":\"Welcome!\",\"bodyText\":\"Welcome to our service.\",\"useSSL\":true}", + "description": "Send a simple welcome email to a single recipient using SMTP authentication over TLS." + }, + { + "inputJson": "{\"smtpHost\":\"smtp.mailserver.com\",\"smtpPort\":465,\"smtpUsername\":\"mailer\",\"smtpPassword\":\"secret\",\"from\":\"news@company.com\",\"to\":[\"customer@example.com\"],\"cc\":[\"manager@company.com\"],\"subject\":\"Monthly Newsletter\",\"bodyHtml\":\"Our News
Check out our updates.
\",\"attachments\":[{\"filename\":\"promo.pdf\",\"content\":\"\"}],\"useSSL\":true}", + "description": "Send a marketing newsletter with HTML content, CC recipients, and a PDF attachment securely over SSL." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "send", + "object": "Email", + "context": null + } + }, + { + "name": "automation-frameworks.uploadDocument", + "description": "Uploads a document file to a specified remote storage or document management system. Accepts document content as a file path or base64 string, processes the data for upload, and returns upload status along with document metadata including accessible URL and document ID.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "filePath", + "type": "string", + "description": "Local path to the document file to upload. Required if fileBase64 is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "fileBase64", + "type": "string", + "description": "Base64 encoded string of the document content. Required if filePath is not provided.", + "required": false, + "defaultValue": "" + }, + { + "name": "documentName", + "type": "string", + "description": "Name to assign to the uploaded document, to identify it in the system.", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationFolder", + "type": "string", + "description": "Path or identifier of the folder in the remote storage where the document will be uploaded.", + "required": false, + "defaultValue": "root" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Whether to overwrite an existing document with the same name in the destination folder.", + "required": false, + "defaultValue": "false" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value metadata to associate with the document (e.g., tags, description).", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Upload result containing success status, message, document ID, and access URL or error details." + }, + "aiAgent": { + "useCase": "Use this tool when an automation task or workflow requires programmatically uploading documents to a remote storage or content management system, such as saving reports, logs, or user documents. It supports flexible input formats and metadata annotation.", + "limitations": "This tool does not handle document conversion, scanning, or OCR. It requires valid authentication and permissions for the target remote storage. Large files may require chunked uploads which are not supported in this implementation.", + "examples": [ + "Upload a PDF report from local file path to corporate document repository.", + "Upload a base64 encoded image document to a cloud folder with metadata tags.", + "Overwrite an existing document with updated content under the same name in the destination folder." + ] + }, + "tags": [ + "automation", + "document management", + "upload", + "file handling", + "workflow", + "content management" + ], + "examples": [ + { + "inputJson": "{\"filePath\":\"/reports/financial-summary.pdf\",\"documentName\":\"Q1 Financial Summary.pdf\",\"destinationFolder\":\"finance/reports\",\"overwriteExisting\":false}", + "description": "Upload a PDF report from a local file path to the finance reports folder without overwriting existing documents." + }, + { + "inputJson": "{\"fileBase64\":\"JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNDU4Pj5zdHJlYW0KeJxt0DFMgzAMhuF7vT1XU4WHKT9GnK0onR7pQUzTkllM455N9CQ6LNzvPzsz7bpi5kEUIYZ4sGSSY2Asg4SuATrpQScuMivx7W4BMRRQOyglrRMH14nGC3kOQbOjc+igg2UrfY2oDrqJZHL7THrxvpsRxFPzfLdS+XJ2Na8kquLE2N3nX7lVy9BRS3lgKrJs/BkN4TgUP1kF2avYx+AGnJFHUwplZm9yZgplbmRzdHJlYW0KZW5kb2JqCnhyZWYKMCA3CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDExMSAwMDAwMCBuIAowMDAwMDAwMTQ4IDAwMDAwIG4gCjAwMDAwMDAyMDcgMDAwMDAgbiAKMDAwMDAwMDMwMSAwMDAwMCBuIAowMDAwMDAwNDY3IDAwMDAwIG4gCnRyYWlsZXIKPDwvU2l6ZSA3L1Jvb3QgMSAwIFIvSW5mbyA2IDAgUi9JRCBbPDE0YmU0N2EyZDQ1ZDVmNjZmNmQ3YTcyNGViNmEyNDRkPjw8MTRiZTQ3YTJkNDVkNWY2NmY2ZDdhNzI0ZWI2YTI0NGQ+XT4+CnN0YXJ0eHJlZgowCjU1NgolJUVPRgo=\",\"documentName\":\"imageDoc.jpg\",\"destinationFolder\":\"images/uploads\",\"overwriteExisting\":true,\"metadata\":{\"tag\":\"profile\",\"description\":\"User profile picture\"}}", + "description": "Upload an image document provided as a base64 string to images/uploads folder, overwriting existing and assigning metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "automation-frameworks.generateText", + "description": "Generates customized text content based on specified templates and dynamic variables. Accepts a text template with placeholders, a mapping of variables to replace, and optional formatting settings. Outputs the final generated text string with all placeholders rendered accordingly.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "template", + "type": "string", + "description": "The text template containing placeholders indicated by braces, e.g., 'Hello, {name}!'", + "required": true, + "defaultValue": "" + }, + { + "name": "variables", + "type": "object", + "description": "An object mapping placeholder names to their replacement string values. E.g., {\"name\": \"Alice\"}", + "required": true, + "defaultValue": "" + }, + { + "name": "formattingOptions", + "type": "object", + "description": "Optional formatting options like uppercase, lowercase, or capitalize for the entire output text.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns an object with a single property 'generatedText' containing the final rendered string after variable substitution and formatting." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate customized text outputs in automation workflows, such as emails, reports, notifications, or documentation, by providing templates and dynamic content. It helps automate repetitive text generation tasks with variable input.", + "limitations": "Does not perform natural language generation or correct grammar; only replaces given placeholders. Complex conditional logic or iterative content generation is not supported.", + "examples": [ + "Generate a greeting email body with recipient name and date.", + "Create a report summary with inserted metrics and percentages.", + "Produce a notification message with dynamic user and event details." + ] + }, + "tags": [ + "automation", + "text-generation", + "templating", + "workflow", + "content-generation" + ], + "examples": [ + { + "inputJson": "{\"template\":\"Hello, {firstName} {lastName}! Your appointment is on {date}.\",\"variables\":{\"firstName\":\"John\",\"lastName\":\"Doe\",\"date\":\"2024-07-01\"},\"formattingOptions\":{\"uppercase\":false}}", + "description": "Generate a personalized appointment reminder with the recipient's full name and date." + }, + { + "inputJson": "{\"template\":\"Warning: {device} has reached {threshold}% CPU usage.\",\"variables\":{\"device\":\"Server42\",\"threshold\":\"95\"},\"formattingOptions\":{\"uppercase\":true}}", + "description": "Create an uppercase alert message for system monitoring notifications." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Text", + "context": null + } + }, + { + "name": "automation-frameworks.createTest", + "description": "Generates automated test scripts based on specified parameters including test framework, language, test type, and target functionalities. Accepts inputs defining the test context and outputs ready-to-run test code snippets or files according to chosen conventions and best practices.", + "category": "automation-frameworks", + "parameters": [ + { + "name": "testName", + "type": "string", + "description": "The unique name or identifier for the test case to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "testFramework", + "type": "string", + "description": "The testing framework to use (e.g., Jest, Mocha, PyTest, Selenium).", + "required": true, + "defaultValue": "" + }, + { + "name": "programmingLanguage", + "type": "string", + "description": "The programming language of the test code to generate (e.g., JavaScript, Python, Java).", + "required": true, + "defaultValue": "" + }, + { + "name": "testType", + "type": "string", + "description": "The category of test to create, such as unit, integration, e2e (end-to-end), or functional test.", + "required": true, + "defaultValue": "" + }, + { + "name": "testDescription", + "type": "string", + "description": "A brief description of the intended behavior or features the test should validate.", + "required": false, + "defaultValue": "" + }, + { + "name": "testSteps", + "type": "array", + "description": "An ordered list of steps or actions that the test should perform, expressed as simple descriptive strings.", + "required": true, + "defaultValue": "" + }, + { + "name": "assertions", + "type": "array", + "description": "A list of expected conditions or outcomes that the test should verify, each as a string assertion statement.", + "required": true, + "defaultValue": "" + }, + { + "name": "setupCode", + "type": "string", + "description": "Optional code to run before the test steps, such as initializing environment or mocks.", + "required": false, + "defaultValue": "" + }, + { + "name": "teardownCode", + "type": "string", + "description": "Optional code to run after the test completes, for cleanup purposes.", + "required": false, + "defaultValue": "" + }, + { + "name": "outputFormat", + "type": "string", + "description": "The format in which to return the generated test code (e.g., 'string' for raw code, 'file' for file path).", + "required": false, + "defaultValue": "string" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated test script/code and optionally metadata such as filename or code snippets." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to automate the creation of standardized test cases for software projects. It helps rapidly produce boilerplate test code for common frameworks and languages based on a structured description of what to test, facilitating test coverage and continuous integration workflows.", + "limitations": "Does not execute or validate generated tests. It may not fully capture complex test logic or dynamic environments without additional manual refinement. It cannot generate tests for proprietary or highly domain-specific frameworks not listed in its configuration.", + "examples": [ + "Create a Jest unit test in JavaScript for a function that adds two numbers.", + "Generate a PyTest integration test in Python verifying user login flow steps.", + "Produce a Selenium end-to-end test script in Java checking website navigation and page content." + ] + }, + "tags": [ + "automation", + "testing", + "test-creation", + "code-generation", + "QA", + "software-testing", + "CI-CD" + ], + "examples": [ + { + "inputJson": "{\"testName\":\"addFunctionTest\",\"testFramework\":\"Jest\",\"programmingLanguage\":\"JavaScript\",\"testType\":\"unit\",\"testDescription\":\"Test addition function for correct output\",\"testSteps\":[\"call add(2,3)\"],\"assertions\":[\"result equals 5\"],\"setupCode\":\"const add = require('./add');\",\"teardownCode\":\"\",\"outputFormat\":\"string\"}", + "description": "Generate a Jest JavaScript unit test to verify an add function returns correct sum." + }, + { + "inputJson": "{\"testName\":\"userLoginFlow\",\"testFramework\":\"PyTest\",\"programmingLanguage\":\"Python\",\"testType\":\"integration\",\"testDescription\":\"Verify user can login with valid credentials\",\"testSteps\":[\"navigate to login page\",\"enter username and password\",\"submit login form\"],\"assertions\":[\"login successful message displayed\"],\"setupCode\":\"import requests\",\"teardownCode\":\"\",\"outputFormat\":\"string\"}", + "description": "Create a PyTest integration test for user login workflow with given steps and assertions." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Test", + "context": null + } + }, + { + "name": "api-integration.createReport", + "description": "Creates a detailed report document by aggregating and processing data from specified APIs. Accepts input parameters defining data sources, filters, report format, and layout options. Outputs a structured report in formats like PDF, DOCX, or JSON, ready for distribution or archiving.", + "category": "api-integration", + "parameters": [ + { + "name": "dataSources", + "type": "array", + "description": "List of API endpoints or identifiers to fetch data from for the report.", + "required": true, + "defaultValue": "" + }, + { + "name": "filters", + "type": "object", + "description": "Key-value pairs defining filtering criteria to refine the data fetched from the APIs.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "reportFormat", + "type": "string", + "description": "Desired output format of the report (e.g., PDF, DOCX, JSON).", + "required": true, + "defaultValue": "PDF" + }, + { + "name": "title", + "type": "string", + "description": "Title to display on the report cover page or header.", + "required": false, + "defaultValue": "Annual Report" + }, + { + "name": "includeSummary", + "type": "boolean", + "description": "Whether to include a summary section in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "layoutOptions", + "type": "object", + "description": "Layout configuration details like page orientation, font styles, and section order.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the report content in the chosen format as a base64-encoded string and metadata including report title, creation timestamp, and data sources used." + }, + "aiAgent": { + "useCase": "Use when an integrated report needs to be created by fetching and compiling data from multiple APIs, applying filters, and formatting it into a professional document format for presentation, distribution, or record-keeping.", + "limitations": "Does not perform data validation or quality checks on input APIs; requires accessible and authorized API endpoints. Complex custom report designs may require additional post-processing outside the tool.", + "examples": [ + "Generate a PDF sales report from the sales and marketing APIs filtered by region Q1 2024.", + "Create a DOCX report summarizing product inventory status using warehouse and ERP system APIs.", + "Build a JSON format technical audit report combining security and compliance API data." + ] + }, + "tags": [ + "api-integration", + "report-generation", + "document", + "automation", + "data-aggregation", + "formatting" + ], + "examples": [ + { + "inputJson": "{\"dataSources\": [\"https://api.company.com/sales\", \"https://api.company.com/marketing\"], \"filters\": {\"region\": \"EMEA\", \"quarter\": \"Q1\"}, \"reportFormat\": \"PDF\", \"title\": \"Q1 EMEA Sales Report\", \"includeSummary\": true, \"layoutOptions\": {\"pageOrientation\": \"portrait\", \"font\": \"Arial\"}}", + "description": "Create a PDF report titled 'Q1 EMEA Sales Report' by aggregating sales and marketing data filtered for the EMEA region and Q1 quarter, including summary, with defined layout options." + }, + { + "inputJson": "{\"dataSources\": [\"https://api.warehouse.com/inventory\"], \"reportFormat\": \"DOCX\", \"title\": \"Inventory Status Report\", \"includeSummary\": false}", + "description": "Generate a DOCX report on current inventory status, pulling data from the warehouse inventory API without summary section." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "api-integration.createFunction", + "description": "Creates a new serverless or API function by defining its configuration parameters, code content, and deployment options. Accepts inputs like function name, runtime environment, source code, triggers, and environment variables. Processes these inputs to set up the function in a target platform and returns a deployment status with function details.", + "category": "api-integration", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The unique name to assign to the new function.", + "required": true, + "defaultValue": "" + }, + { + "name": "runtime", + "type": "string", + "description": "The runtime environment for the function, e.g., 'nodejs14', 'python3.9'.", + "required": true, + "defaultValue": "" + }, + { + "name": "code", + "type": "string", + "description": "The source code of the function as a string or base64-encoded content.", + "required": true, + "defaultValue": "" + }, + { + "name": "triggers", + "type": "array", + "description": "List of event triggers (e.g., HTTP endpoints, cron schedules) that activate the function.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "environmentVariables", + "type": "object", + "description": "Key-value pairs defining environment variables available to the function at runtime.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum execution time for the function in seconds before termination.", + "required": false, + "defaultValue": "60" + }, + { + "name": "memoryMB", + "type": "number", + "description": "Amount of memory allocated to the function in megabytes.", + "required": false, + "defaultValue": "256" + }, + { + "name": "description", + "type": "string", + "description": "A text description explaining the purpose of the function.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing deployment status, unique function identifier, endpoint URLs (if applicable), and error messages if any." + }, + "aiAgent": { + "useCase": "Use this tool to automate the creation and deployment of serverless or API functions within various cloud or custom platforms by specifying all necessary code and configuration details in a single operation. Ideal when integrating multiple APIs or serverless workflows.", + "limitations": "Does not support complex multi-function workflows or dependency chaining. Cannot edit or update existing functions, only create new ones. Execution environments and triggers supported depend on the target platform capabilities.", + "examples": [ + "Create a Node.js HTTP API function named 'getUser' that responds to GET requests.", + "Deploy a Python scheduled function triggered every hour with specific environment variables.", + "Create a memory-optimized function with a 120-second timeout to process data asynchronously." + ] + }, + "tags": [ + "api", + "serverless", + "function", + "deployment", + "automation", + "cloud", + "integration" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"helloWorld\",\"runtime\":\"nodejs14\",\"code\":\"exports.handler = async () => { return { statusCode: 200, body: 'Hello World' }; };\",\"triggers\":[{\"type\":\"http\",\"method\":\"GET\",\"path\":\"/hello\"}],\"environmentVariables\":{\"GREETING\":\"Hello World\"},\"timeoutSeconds\":30,\"memoryMB\":128,\"description\":\"Simple HTTP hello world function.\"}", + "description": "Creates a basic Node.js HTTP function returning a hello message." + }, + { + "inputJson": "{\"functionName\":\"dailyCleanup\",\"runtime\":\"python3.9\",\"code\":\"def handler(event, context):\\n print('Cleanup task executed')\",\"triggers\":[{\"type\":\"cron\",\"schedule\":\"0 0 * * *\"}],\"environmentVariables\":{},\"timeoutSeconds\":60,\"memoryMB\":512,\"description\":\"Scheduled daily cleanup function.\"}", + "description": "Creates a Python function triggered daily by a cron schedule for cleanup tasks." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Function", + "context": null + } + }, + { + "name": "agent-management.analyzeAccount", + "description": "Analyzes a specified AI agent account by evaluating usage patterns, configuration settings, error logs, and performance metrics over a given period. Accepts an account identifier and optional date range, processes account data to identify anomalies, inefficiencies, and optimization opportunities, and returns a comprehensive diagnostic report summarizing the account's operational health.", + "category": "agent-management", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "Unique identifier of the AI agent account to analyze.", + "required": true, + "defaultValue": "" + }, + { + "name": "startDate", + "type": "string", + "description": "ISO 8601 formatted string indicating the start date for analysis period (inclusive).", + "required": false, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "ISO 8601 formatted string indicating the end date for analysis period (inclusive).", + "required": false, + "defaultValue": "" + }, + { + "name": "includeErrorLogs", + "type": "boolean", + "description": "Whether to include detailed error logs in the analysis report.", + "required": false, + "defaultValue": "false" + }, + { + "name": "performanceMetrics", + "type": "array", + "description": "List of specific performance metrics to include in the analysis (e.g., ['responseTime', 'throughput']). If empty or omitted, uses all available metrics.", + "required": false, + "defaultValue": "[]" + } + ], + "returns": { + "type": "object", + "description": "A detailed analysis report object including usage statistics, performance summaries, detected anomalies, error log excerpts (if requested), configuration inconsistencies, and suggested optimizations." + }, + "aiAgent": { + "useCase": "Use this tool when evaluating an AI agent account's operational status to identify issues, optimize performance, or prepare reports on usage and health. Especially useful for periodic audits or troubleshooting unexpected behaviors in deployed agents.", + "limitations": "Does not modify any account settings or perform automated fixes. Analysis depends on the availability and completeness of account data and logs. Real-time monitoring is not supported.", + "examples": [ + "Analyze the account 'agent123' logs and performance metrics for the last month including error details.", + "Provide a summary report of usage statistics for account 'agentXYZ' without error logs.", + "Evaluate the 'marketingBot' account's performance focusing on response time and throughput metrics." + ] + }, + "tags": [ + "analysis", + "agent-management", + "account", + "performance", + "diagnostics", + "optimization", + "logging" + ], + "examples": [ + { + "inputJson": "{\"accountId\": \"agent123\", \"startDate\": \"2024-05-01\", \"endDate\": \"2024-05-31\", \"includeErrorLogs\": true, \"performanceMetrics\": [\"responseTime\", \"throughput\"]}", + "description": "Analyze the agent account with ID 'agent123' for May 2024, including error logs and focusing on response time and throughput metrics." + }, + { + "inputJson": "{\"accountId\": \"agentXYZ\", \"includeErrorLogs\": false}", + "description": "Analyze the latest available data for account 'agentXYZ' without including error logs." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "agent-management.generateWord", + "description": "Generates a random or themed word based on provided criteria such as word length, starting letter, language, and category. Useful for naming agents, bots, or creating content prompts. Accepts customizable parameters to tailor word generation to agent needs, outputting one suitable word string.", + "category": "agent-management", + "parameters": [ + { + "name": "language", + "type": "string", + "description": "The language code (e.g., 'en', 'es') to generate the word in.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "minLength", + "type": "number", + "description": "Minimum length of the generated word.", + "required": false, + "defaultValue": "3" + }, + { + "name": "maxLength", + "type": "number", + "description": "Maximum length of the generated word.", + "required": false, + "defaultValue": "10" + }, + { + "name": "startsWith", + "type": "string", + "description": "Optional starting letter(s) the generated word should begin with.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "category", + "type": "string", + "description": "Optional category or theme to base the word on (e.g., 'technology', 'nature').", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "capitalize", + "type": "boolean", + "description": "Whether the generated word should be capitalized (e.g., for proper names).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated word as a string and metadata about the generation parameters." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent requires a single, contextually relevant word for naming, labeling, or creative content generation. It helps provide words tailored by language, length, or theme to fit agent creation or content needs.", + "limitations": "Cannot guarantee the word is unique or always meaningful; depending on parameters, results may be generic or common words. It does not generate multiple words or phrase; limited to single words only.", + "examples": [ + "Generate a technology-related word starting with 'a' for naming a bot.", + "Create a random English word between 5 and 8 letters long.", + "Produce a nature-themed word capitalized for an agent name." + ] + }, + "tags": [ + "agent-management", + "word-generation", + "naming", + "content-generation", + "language" + ], + "examples": [ + { + "inputJson": "{\"language\":\"en\",\"minLength\":5,\"maxLength\":8,\"startsWith\":\"a\",\"category\":\"technology\",\"capitalize\":true}", + "description": "Generate a capitalized English technology-related word starting with 'a' between 5 and 8 letters long." + }, + { + "inputJson": "{\"language\":\"en\",\"minLength\":3,\"maxLength\":6,\"capitalize\":false}", + "description": "Generate a random English word between 3 and 6 letters long." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Word", + "context": null + } + }, + { + "name": "model-management.analyzeDataset", + "description": "Analyzes a given dataset to provide detailed statistics and insights including data types, missing values, distributions, correlations, and potential data quality issues. Accepts datasets in CSV or JSON format with optional specifications about target variables or grouping columns. Produces a structured summary report with descriptive statistics and recommendations for preprocessing.", + "category": "model-management", + "parameters": [ + { + "name": "dataset", + "type": "string", + "description": "The dataset content as a CSV or JSON string input for analysis.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "Format of the input dataset: 'csv' or 'json'.", + "required": true, + "defaultValue": "csv" + }, + { + "name": "targetColumn", + "type": "string", + "description": "Optional name of the target variable column to analyze separately.", + "required": false, + "defaultValue": "" + }, + { + "name": "groupByColumns", + "type": "array", + "description": "Optional array of column names to group data by for subgroup analysis.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeCorrelations", + "type": "boolean", + "description": "Whether to compute pairwise correlations between numeric features.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxSamples", + "type": "number", + "description": "Maximum number of data rows to analyze for efficiency (0 means all).", + "required": false, + "defaultValue": "10000" + } + ], + "returns": { + "type": "object", + "description": "An object containing summary statistics, data quality issues, feature distributions, correlations (if requested), and preprocessing recommendations." + }, + "aiAgent": { + "useCase": "This tool should be used when an AI agent needs a comprehensive overview of a dataset prior to model training or data preprocessing. It helps identify data quality issues, understand feature distributions, and find correlations which impact model feature engineering and selection.", + "limitations": "The tool does not perform data cleaning or transformations. It analyzes only the provided dataset without external context and may be limited by large dataset size despite sampling.", + "examples": [ + "Analyze a CSV dataset to identify missing values and data types before model training.", + "Assess correlations and distributions in a JSON dataset grouped by category.", + "Generate a detailed data report with target variable insights for feature engineering." + ] + }, + "tags": [ + "analysis", + "dataset", + "data-quality", + "statistics", + "model-preparation", + "insights" + ], + "examples": [ + { + "inputJson": "{\"dataset\":\"col1,col2,target\\n1,5,A\\n2,6,B\\n3,,A\\n4,8,B\",\"dataFormat\":\"csv\",\"targetColumn\":\"target\",\"includeCorrelations\":true,\"maxSamples\":1000}", + "description": "Analyze a small CSV dataset with a target column and compute correlations." + }, + { + "inputJson": "{\"dataset\":\"[{\\\"feature1\\\":10, \\\"feature2\\\":100, \\\"group\\\":\\\"A\\\"},{\\\"feature1\\\":15, \\\"feature2\\\":110, \\\"group\\\":\\\"B\\\"}]\",\"dataFormat\":\"json\",\"groupByColumns\":[\"group\"],\"includeCorrelations\":false}", + "description": "Analyze a JSON dataset grouped by 'group' column without computing correlations." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Dataset", + "context": null + } + }, + { + "name": "model-management.analyzeMessage", + "description": "Analyzes textual message inputs using AI models to extract sentiment, intent, key entities, and summarize content. Accepts raw message text and optional model configuration, processes linguistic and semantic features, and returns structured analysis including sentiment score, identified entities, detected user intent, and a concise summary.", + "category": "model-management", + "parameters": [ + { + "name": "messageText", + "type": "string", + "description": "The raw text content of the message to be analyzed.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es') of the message for accurate analysis.", + "required": false, + "defaultValue": "en" + }, + { + "name": "modelVersion", + "type": "string", + "description": "Specific version of the AI model to use for analysis, if applicable.", + "required": false, + "defaultValue": "" + }, + { + "name": "extractSentiment", + "type": "boolean", + "description": "Flag to enable sentiment analysis extraction.", + "required": false, + "defaultValue": "true" + }, + { + "name": "extractEntities", + "type": "boolean", + "description": "Flag to enable named entity extraction from the message.", + "required": false, + "defaultValue": "true" + }, + { + "name": "extractIntent", + "type": "boolean", + "description": "Flag to enable intent detection within the message text.", + "required": false, + "defaultValue": "true" + }, + { + "name": "generateSummary", + "type": "boolean", + "description": "Flag indicating whether to generate a concise summary of the message content.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing analysis results including sentiment (score and label), entities (array with type and text), detected intent with confidence, and optionally a summary string." + }, + "aiAgent": { + "useCase": "Use this tool when needing to understand the emotional tone, main subjects, user intent, or a brief overview of message text to support automated workflows, customer support, chatbot understanding, or content categorization.", + "limitations": "This tool analyzes text only and cannot process non-textual message contents such as images or voice. It may have reduced accuracy on slang, ambiguous, or very short messages.", + "examples": [ + "Analyze customer support messages to detect urgency and route appropriately.", + "Summarize user feedback messages to identify common themes.", + "Detect user intent in chatbot conversations for context-aware replies." + ] + }, + "tags": [ + "analysis", + "nlp", + "sentiment", + "intent", + "entity extraction", + "message processing", + "text summarization" + ], + "examples": [ + { + "inputJson": "{\"messageText\":\"I'm so frustrated with the slow response time from your support team!\", \"language\":\"en\", \"extractSentiment\":true, \"extractEntities\":true, \"extractIntent\":true, \"generateSummary\":true}", + "description": "Analyze a customer complaint message for sentiment, entities, intent, and provide a summary." + }, + { + "inputJson": "{\"messageText\":\"Schedule a meeting with the sales team next Wednesday morning.\", \"extractIntent\":true, \"extractEntities\":true}", + "description": "Identify intent and important entities in a scheduling request message." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Message", + "context": null + } + }, + { + "name": "model-management.createImage", + "description": "Creates a new AI-generated image based on textual prompts and optional style parameters. Accepts a text prompt describing the desired image, optional style settings such as image resolution, color scheme, and artistic style, and returns a URL or base64-encoded string representing the generated image suitable for further use or display.", + "category": "model-management", + "parameters": [ + { + "name": "prompt", + "type": "string", + "description": "A detailed textual description of the image to generate.", + "required": true, + "defaultValue": "" + }, + { + "name": "resolution", + "type": "string", + "description": "The desired resolution of the output image, e.g., '512x512'.", + "required": false, + "defaultValue": "512x512" + }, + { + "name": "style", + "type": "string", + "description": "Artistic style to apply to the image, such as 'realistic', 'cartoon', or 'abstract'.", + "required": false, + "defaultValue": "realistic" + }, + { + "name": "colorScheme", + "type": "string", + "description": "Preferred color scheme, for example 'vibrant', 'pastel', or 'monochrome'.", + "required": false, + "defaultValue": "vibrant" + }, + { + "name": "seed", + "type": "number", + "description": "Optional random seed number for reproducibility of the generated image.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated image data including an accessible URL or a base64 string, the image resolution, and metadata about the generation." + }, + "aiAgent": { + "useCase": "Use this tool when you want to generate images automatically from textual prompts for creative projects, prototyping, digital content creation, or visual assistance tasks. It is suitable for generating diverse images with configurable styles and resolutions, assisting in rapid visual content development or experimentation.", + "limitations": "This tool cannot generate images from inputs other than textual prompts. It may not produce results matching highly specific or abstract concepts perfectly. It does not edit existing images, only creates new images from descriptions.", + "examples": [ + "Generate a realistic portrait of a medieval knight wearing a silver helmet.", + "Create a vibrant cartoon-style image of a futuristic city skyline.", + "Produce an abstract pastel-colored image inspired by ocean waves." + ] + }, + "tags": [ + "image generation", + "AI art", + "text-to-image", + "model deployment", + "creative tools", + "digital content" + ], + "examples": [ + { + "inputJson": "{\"prompt\":\"A futuristic robot standing in a neon-lit cityscape at night\",\"resolution\":\"1024x1024\",\"style\":\"realistic\",\"colorScheme\":\"vibrant\",\"seed\":42}", + "description": "Generates a vibrant realistic image of a robot in a neon city at 1024x1024 resolution." + }, + { + "inputJson": "{\"prompt\":\"Cute cartoon cat wearing a wizard hat\",\"style\":\"cartoon\",\"colorScheme\":\"pastel\"}", + "description": "Creates a pastel-colored cartoon-style image of a cat dressed as a wizard at default resolution." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Image", + "context": null + } + }, + { + "name": "model-management.createAccount", + "description": "Creates a new user account within the AI model management system, accepting inputs like user details and account roles, then processes validation and stores the account data securely, returning the created account identifier and status.", + "category": "model-management", + "parameters": [ + { + "name": "username", + "type": "string", + "description": "Unique username for the new account, required for identification.", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Email address associated with the account for notifications and recovery.", + "required": true, + "defaultValue": "" + }, + { + "name": "password", + "type": "string", + "description": "Secure password for account authentication, must meet security policies.", + "required": true, + "defaultValue": "" + }, + { + "name": "roles", + "type": "array", + "description": "Array of strings specifying roles assigned to the account (e.g., admin, user).", + "required": false, + "defaultValue": "[\"user\"]" + }, + { + "name": "isActive", + "type": "boolean", + "description": "Flag indicating if the account should be active immediately after creation.", + "required": false, + "defaultValue": "true" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs with additional user information (e.g., department).", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the new account ID, username, assigned roles, creation timestamp, and status message." + }, + "aiAgent": { + "useCase": "Use this tool when a new user needs to be registered in the AI model management platform, requiring validated user credentials and role assignments before model access is granted.", + "limitations": "This tool does not handle password strength enforcement beyond basic validation, nor does it send verification emails or handle multi-factor authentication setup.", + "examples": [ + "Create a new admin account for the ML operations team with immediate activation.", + "Register a user with standard \"user\" role and add metadata including their department.", + "Create an inactive account pending email verification before activation." + ] + }, + "tags": [ + "account", + "user-management", + "model-management", + "create", + "security", + "authentication" + ], + "examples": [ + { + "inputJson": "{\"username\":\"jdoe\",\"email\":\"jdoe@example.com\",\"password\":\"S3cur3Pa$$w0rd\",\"roles\":[\"admin\"],\"isActive\":true,\"metadata\":{\"department\":\"ml-ops\"}}", + "description": "Create an active admin account for user 'jdoe' with additional metadata." + }, + { + "inputJson": "{\"username\":\"asmith\",\"email\":\"asmith@example.com\",\"password\":\"defaultPass123\",\"roles\":[\"user\"],\"isActive\":false}", + "description": "Create an inactive standard user account awaiting activation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Account", + "context": null + } + }, + { + "name": "model-management.createDataset", + "description": "Creates a structured dataset from raw data inputs for AI model training and evaluation. Accepts raw data sources (files or URLs), applies optional preprocessing (filtering, normalization), and outputs a dataset object with metadata and sample references ready for model consumption.", + "category": "model-management", + "parameters": [ + { + "name": "datasetName", + "type": "string", + "description": "A unique, human-readable name identifying the dataset to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "rawDataSources", + "type": "array", + "description": "List of raw data inputs as file paths or URLs to include in the dataset.", + "required": true, + "defaultValue": "" + }, + { + "name": "dataFormat", + "type": "string", + "description": "Format of the raw data (e.g., CSV, JSON, image-folder) to properly parse inputs.", + "required": true, + "defaultValue": "" + }, + { + "name": "preprocessingSteps", + "type": "array", + "description": "Optional list of preprocessing operations to apply, such as filtering, normalization, or augmentation.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "targetVariable", + "type": "string", + "description": "Name of the target/output variable in the dataset for supervised learning scenarios.", + "required": false, + "defaultValue": "" + }, + { + "name": "validationSplit", + "type": "number", + "description": "Fraction of data to set aside for validation (0 to 1), default is 0.2.", + "required": false, + "defaultValue": "0.2" + }, + { + "name": "randomSeed", + "type": "number", + "description": "Seed value for random operations like shuffling or splitting to ensure reproducibility.", + "required": false, + "defaultValue": "42" + } + ], + "returns": { + "type": "object", + "description": "An object describing the created dataset including its name, sample count, feature schema, and preprocessing summary." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw data from one or multiple sources and need to create a clean, standardized dataset for training or evaluating AI models. It handles parsing, optional preprocessing, target assignment, and splits data for validation, streamlining dataset creation workflows.", + "limitations": "Does not support real-time data streaming inputs or complex multi-modal dataset assembly beyond basic file and URL sourcing. Advanced preprocessing beyond basic steps may require external tools.", + "examples": [ + "Create a dataset named 'CustomerChurn' from multiple CSV files with normalization and a defined target variable.", + "Generate an image dataset from a folder of images, split 10% for validation, and apply augmentation preprocessing.", + "Assemble a dataset from JSON URLs with no preprocessing and default validation split." + ] + }, + "tags": [ + "dataset", + "creation", + "model-training", + "preprocessing", + "data-management" + ], + "examples": [ + { + "inputJson": "{\"datasetName\":\"CustomerChurn\",\"rawDataSources\":[\"/data/churn_jan.csv\",\"/data/churn_feb.csv\"],\"dataFormat\":\"CSV\",\"preprocessingSteps\":[\"normalize\",\"filterOutliers\"],\"targetVariable\":\"churn\",\"validationSplit\":0.2,\"randomSeed\":1234}", + "description": "Creating a tabular dataset for customer churn prediction from two CSV files with normalization and outlier filtering, using a 20% validation split." + }, + { + "inputJson": "{\"datasetName\":\"CatsVsDogs\",\"rawDataSources\":[\"/images/cats_vs_dogs/\"],\"dataFormat\":\"image-folder\",\"preprocessingSteps\":[\"resize\",\"augment\"],\"validationSplit\":0.1}", + "description": "Constructing an image classification dataset from a folder with resizing and augmentation, reserving 10% for validation." + }, + { + "inputJson": "{\"datasetName\":\"WebLogs\",\"rawDataSources\":[\"https://data.example.com/weblogs.json\"],\"dataFormat\":\"JSON\",\"preprocessingSteps\":[],\"validationSplit\":0.25}", + "description": "Creating a dataset from a JSON web log URL without preprocessing, setting aside 25% for validation." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Dataset", + "context": null + } + }, + { + "name": "model-management.createIssue", + "description": "Creates a new issue in the AI model management system to track bugs, feature requests, or tasks related to AI models. Accepts issue title, description, priority, type, and related model ID as inputs. Outputs issue ID and confirmation status upon creation.", + "category": "model-management", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "Short, descriptive title of the issue to be created.", + "required": true, + "defaultValue": "" + }, + { + "name": "description", + "type": "string", + "description": "Detailed explanation of the issue or request to help developers understand the context.", + "required": true, + "defaultValue": "" + }, + { + "name": "priority", + "type": "string", + "description": "Priority level of the issue, e.g., Low, Medium, High, Critical.", + "required": false, + "defaultValue": "Medium" + }, + { + "name": "issueType", + "type": "string", + "description": "Type of issue to categorize it, e.g., Bug, Feature Request, Task.", + "required": true, + "defaultValue": "Bug" + }, + { + "name": "relatedModelId", + "type": "string", + "description": "Identifier of the AI model related to this issue, if applicable.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the unique issueId assigned by the system and a status message indicating success or failure of issue creation." + }, + "aiAgent": { + "useCase": "AI agents should use this tool when they need to log new issues during AI model lifecycle management, such as detecting a defect during testing, requesting a new feature, or recording maintenance tasks associated with AI models. It helps in organizing and tracking work items efficiently.", + "limitations": "This tool does not perform issue prioritization automatically or integrate with external issue trackers. It only creates issues in the internal AI model management system.", + "examples": [ + "Create a high priority bug issue for model ID '1234' due to model accuracy drop.", + "Log a feature request to add support for TPU accelerators.", + "Report a medium priority task to update model training datasets." + ] + }, + "tags": [ + "issue", + "model-management", + "bug-tracking", + "task-management", + "feature-request", + "AI-models" + ], + "examples": [ + { + "inputJson": "{\"title\":\"Model accuracy decreased after update\",\"description\":\"After the latest retraining, the model accuracy dropped by 5%, need investigation.\",\"priority\":\"High\",\"issueType\":\"Bug\",\"relatedModelId\":\"model_9876\"}", + "description": "Creating a high priority bug issue related to a specific AI model's accuracy regression." + }, + { + "inputJson": "{\"title\":\"Add support for TPU acceleration\",\"description\":\"Request to enable training on TPU hardware to speed up processes.\",\"issueType\":\"Feature Request\"}", + "description": "Logging a feature request to enhance training infrastructure for AI models." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Issue", + "context": null + } + }, + { + "name": "model-management.createCommit", + "description": "Creates a new commit in the version control system integrated with the AI model management platform. Accepts the target branch name, a commit message, and optionally a list of changed files or metadata. Processes these inputs to create a commit record and returns the commit ID, timestamp, and status.", + "category": "model-management", + "parameters": [ + { + "name": "branchName", + "type": "string", + "description": "The name of the branch to commit to (e.g., 'main', 'dev').", + "required": true, + "defaultValue": "" + }, + { + "name": "commitMessage", + "type": "string", + "description": "A descriptive message explaining the purpose of the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "changedFiles", + "type": "array", + "description": "Optional list of file paths that have been changed and should be included in the commit.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "authorName", + "type": "string", + "description": "Optional name of the author making the commit.", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs with additional metadata about the commit (e.g., ticket IDs, tags).", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the commit ID (hash), timestamp of commit creation, branch committed to, and commit status (success or failure with error details)." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically create a commit record during model training iterations, updates to model code, configuration changes, or other version-controlled modifications within the AI model lifecycle management platform. This ensures changes are versioned and traceable in the model management repository.", + "limitations": "This tool does not perform merge operations or resolve conflicts; it only creates commits. It assumes the underlying repository and branch exist and are accessible. It cannot revert commits or manage branch creation.", + "examples": [ + "Create a commit on the 'main' branch with message 'Updated model hyperparameters' including changed files ['config.yaml','train.py'].", + "Commit a change on 'dev' branch with a descriptive message and metadata containing a ticket ID.", + "Create a commit with author name specified for audit tracking without specifying changed files explicitly." + ] + }, + "tags": [ + "version-control", + "commit", + "model-management", + "git", + "repository", + "devops", + "automation" + ], + "examples": [ + { + "inputJson": "{\"branchName\":\"main\",\"commitMessage\":\"Add new feature extractor module\",\"changedFiles\":[\"feature_extractor.py\",\"README.md\"],\"authorName\":\"Jane Doe\",\"metadata\":{\"ticketId\":\"ML-1234\"}}", + "description": "Commit adding a new feature extractor on main branch with related files and a ticket reference." + }, + { + "inputJson": "{\"branchName\":\"dev\",\"commitMessage\":\"Fix bug in training loop\",\"changedFiles\":[\"train.py\"],\"authorName\":\"John Smith\"}", + "description": "Commit a bug fix in the training loop on the dev branch, specifying the author." + }, + { + "inputJson": "{\"branchName\":\"experiment\",\"commitMessage\":\"Initial commit for experiment branch\"}", + "description": "Create an initial commit on a new experiment branch without changed files or metadata." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Commit", + "context": null + } + }, + { + "name": "model-management.createAPI", + "description": "Creates a RESTful API endpoint to serve a deployed AI model. Accepts model identifier, API specifications like routes and methods, authentication options, and scaling preferences. Outputs the endpoint URL, status, and deployment details for integration into applications.", + "category": "model-management", + "parameters": [ + { + "name": "modelId", + "type": "string", + "description": "Unique identifier of the AI model to be exposed via the API.", + "required": true, + "defaultValue": "" + }, + { + "name": "httpMethod", + "type": "string", + "description": "HTTP method for the API endpoint, e.g., GET, POST.", + "required": true, + "defaultValue": "POST" + }, + { + "name": "endpointPath", + "type": "string", + "description": "URL path at which the API will be accessible, e.g., /predict.", + "required": true, + "defaultValue": "/predict" + }, + { + "name": "authenticationRequired", + "type": "boolean", + "description": "Whether to enable authentication for API access.", + "required": false, + "defaultValue": "true" + }, + { + "name": "rateLimitPerMinute", + "type": "number", + "description": "Maximum number of API calls allowed per minute to prevent abuse.", + "required": false, + "defaultValue": "60" + }, + { + "name": "scalingOptions", + "type": "object", + "description": "Configuration object defining autoscaling parameters such as min and max number of replicas.", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing API deployment status, access URL, and metadata such as authentication method and rate limiting." + }, + "aiAgent": { + "useCase": "Use this tool to programmatically create and deploy an API endpoint that serves predictions from a specified AI model. It is ideal for integrating AI models into production systems where RESTful access and controlled usage are required.", + "limitations": "This tool does not train models or validate model correctness; it only exposes already deployed models as APIs. It assumes the modelId corresponds to a valid deployed model accessible in the environment.", + "examples": [ + "Create a POST /predict endpoint for modelId 'abc123' with authentication and rate limiting of 100 calls per minute.", + "Deploy an API endpoint GET /classify without authentication for model 'xyz789'.", + "Set up an autoscaling API endpoint with minimum 2 and maximum 10 replicas for model 'model456'." + ] + }, + "tags": [ + "model-management", + "api", + "deployment", + "rest", + "scaling", + "authentication", + "automation" + ], + "examples": [ + { + "inputJson": "{\"modelId\":\"abc123\",\"httpMethod\":\"POST\",\"endpointPath\":\"/predict\",\"authenticationRequired\":true,\"rateLimitPerMinute\":100,\"scalingOptions\":{\"minReplicas\":2,\"maxReplicas\":8}}", + "description": "Create a secured POST /predict API for model 'abc123' with rate limiting and autoscaling between 2 and 8 replicas." + }, + { + "inputJson": "{\"modelId\":\"xyz789\",\"httpMethod\":\"GET\",\"endpointPath\":\"/classify\",\"authenticationRequired\":false}", + "description": "Deploy an open-access GET /classify API endpoint for model 'xyz789' with default scaling and rate limits." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "API", + "context": null + } + }, + { + "name": "messaging.createEmail", + "description": "Creates a structured email message using provided recipients, subject, body content, attachments, and optional metadata. Accepts inputs for 'to', 'cc', 'bcc' addresses, plain text or HTML body, and attachments as base64 strings. Outputs a complete email object ready for sending through an SMTP or email API client.", + "category": "messaging", + "parameters": [ + { + "name": "to", + "type": "array", + "description": "List of primary recipient email addresses for the email. Must be valid emails. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "cc", + "type": "array", + "description": "List of carbon copy recipient email addresses. Optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "bcc", + "type": "array", + "description": "List of blind carbon copy recipient email addresses. Optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "subject", + "type": "string", + "description": "Subject line of the email. Required.", + "required": true, + "defaultValue": "" + }, + { + "name": "bodyPlain", + "type": "string", + "description": "Plain text version of the email body. At least one of bodyPlain or bodyHtml is required.", + "required": false, + "defaultValue": "" + }, + { + "name": "bodyHtml", + "type": "string", + "description": "HTML version of the email body for rich formatting. Optional but recommended for styled emails.", + "required": false, + "defaultValue": "" + }, + { + "name": "attachments", + "type": "array", + "description": "Array of attachment objects containing filename and base64 encoded content. Optional.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "from", + "type": "string", + "description": "The sender's email address. Optional, defaults to configured default sender.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An email message object containing all fields formatted to be used with standard email sending protocols or APIs." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to programmatically generate a complete and well-structured email message object for sending via an email server or API. Useful for customer support replies, notification generation, or automated outreach that require proper addressing, subject, body content, and optional attachments.", + "limitations": "This tool does not send the email; sending must be handled by a separate SMTP or email service integration. It also does not validate email deliverability or handle inline images beyond base64-encoded attachments.", + "examples": [ + "Generate an email to multiple recipients with both plain text and HTML body to notify about a scheduled maintenance.", + "Create an email with attachments sent to a client with a billing update.", + "Draft a simple email without attachments for a password reset confirmation." + ] + }, + "tags": [ + "messaging", + "email", + "create", + "communication", + "notifications", + "attachments" + ], + "examples": [ + { + "inputJson": "{\"to\":[\"user@example.com\"],\"subject\":\"Welcome to Our Service!\",\"bodyPlain\":\"Hello User,\\nThank you for signing up.\",\"bodyHtml\":\" Hello User,
Thank you for signing up.
\"}", + "description": "Create a basic welcome email with both plain text and HTML body." + }, + { + "inputJson": "{\"to\":[\"client@example.com\"],\"cc\":[\"manager@example.com\"],\"subject\":\"Invoice Attached\",\"bodyPlain\":\"Dear Client,\\nPlease find the invoice attached.\",\"attachments\":[{\"filename\":\"invoice.pdf\",\"content\":\"JVBERi0xLjQKJcfs...\"}]}", + "description": "Email to client with an invoice PDF attached and a CC to manager." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Email", + "context": null + } + }, + { + "name": "email-communication.generateReport", + "description": "Generates a comprehensive email campaign report based on provided email sending data and metrics. Accepts filters like date range, campaign IDs, and metrics selection, processes email sending logs and engagement data, and produces a structured report summarizing delivery rates, open rates, click-through rates, bounce statistics, and unsubscribe counts.", + "category": "email-communication", + "parameters": [ + { + "name": "startDate", + "type": "string", + "description": "Start date for the report in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "endDate", + "type": "string", + "description": "End date for the report in ISO 8601 format (YYYY-MM-DD).", + "required": true, + "defaultValue": "" + }, + { + "name": "campaignIds", + "type": "array", + "description": "List of campaign IDs to include in the report. If empty or omitted, includes all campaigns.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "metrics", + "type": "array", + "description": "Array of metrics to include in the report, e.g., [\"deliveryRate\", \"openRate\", \"clickRate\", \"bounceRate\", \"unsubscribeCount\"].", + "required": false, + "defaultValue": "[\"deliveryRate\",\"openRate\",\"clickRate\",\"bounceRate\",\"unsubscribeCount\"]" + }, + { + "name": "groupBy", + "type": "string", + "description": "Optional grouping of report data such as 'daily', 'weekly', or 'campaign'.", + "required": false, + "defaultValue": "campaign" + } + ], + "returns": { + "type": "object", + "description": "An object containing aggregated email campaign statistics, including totals and percentages for each selected metric, optionally grouped by the specified parameter." + }, + "aiAgent": { + "useCase": "Use this tool when you need to generate detailed performance reports for email campaigns over a specified time period. It helps summarize key engagement metrics quickly to support analytics, decision-making, or automated reporting.", + "limitations": "This tool cannot send emails or access real-time data streams; it relies on historical records and predefined metrics. It does not perform predictive analysis or handle data outside the specified campaign scope.", + "examples": [ + "Generate a weekly report on open and click rates for campaign IDs 123 and 456 between 2024-01-01 and 2024-01-07.", + "Create a monthly comprehensive report covering all email campaigns in February 2024 grouped by campaign.", + "Produce a daily summary of bounce and unsubscribe rates for campaign 789 from 2024-05-01 to 2024-05-05." + ] + }, + "tags": [ + "email", + "reporting", + "campaign", + "metrics", + "analytics", + "automation", + "communication" + ], + "examples": [ + { + "inputJson": "{\"startDate\":\"2024-01-01\",\"endDate\":\"2024-01-31\",\"campaignIds\":[101,102],\"metrics\":[\"openRate\",\"clickRate\"],\"groupBy\":\"daily\"}", + "description": "Generate daily open and click rate metrics for campaigns 101 and 102 in January 2024." + }, + { + "inputJson": "{\"startDate\":\"2024-03-01\",\"endDate\":\"2024-03-31\",\"campaignIds\":[],\"metrics\":[\"deliveryRate\",\"bounceRate\",\"unsubscribeCount\"],\"groupBy\":\"campaign\"}", + "description": "Generate delivery, bounce, and unsubscribe statistics for all campaigns in March 2024 by campaign." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Report", + "context": null + } + }, + { + "name": "infrastructure-management.createReport", + "description": "Generates a comprehensive infrastructure report based on input parameters such as time range, resource types, and regions. The tool collects data from cloud or physical infrastructure monitoring services, processes metrics and logs, and outputs a structured document summarizing infrastructure health, performance, and alerts.", + "category": "infrastructure-management", + "parameters": [ + { + "name": "startTime", + "type": "string", + "description": "ISO8601 UTC timestamp to define the start of the reporting period.", + "required": true, + "defaultValue": "" + }, + { + "name": "endTime", + "type": "string", + "description": "ISO8601 UTC timestamp to define the end of the reporting period.", + "required": true, + "defaultValue": "" + }, + { + "name": "resourceTypes", + "type": "array", + "description": "Array of resource type strings to include in the report (e.g., ['VM','Database','LoadBalancer']). If empty or omitted, all types are included.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "regions", + "type": "array", + "description": "Array of region identifiers to filter the report data. If empty or omitted, includes all regions.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "includePerformanceMetrics", + "type": "boolean", + "description": "Whether to include detailed performance metrics in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeAlerts", + "type": "boolean", + "description": "Whether to include recorded alerts and incidents in the report.", + "required": false, + "defaultValue": "true" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated report document, e.g., 'pdf', 'html', or 'json'.", + "required": false, + "defaultValue": "pdf" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated report's metadata and the report content encoded as a base64 string or raw JSON depending on format. Contains fields for reportType, generatedAt timestamp, and reportData." + }, + "aiAgent": { + "useCase": "This tool is ideal for AI agents automating infrastructure health checks, compliance reporting, or operational reviews. It helps generate snapshot reports on resource status, performance trends, and incidents over a specified timeframe and scope, enabling informed decision making or automated escalation.", + "limitations": "Does not perform real-time monitoring or alert detection; relies on historical collected data accessible to the agent's permissions. Does not modify infrastructure or resolve incidents, only reports.", + "examples": [ + "Create a weekly PDF report for all VMs and databases in the us-east-1 region including performance metrics and alerts.", + "Generate an HTML report for the last 24 hours covering all resource types and all regions without alerts.", + "Produce a JSON report summarizing load balancer performance metrics from the past month, excluding alerts." + ] + }, + "tags": [ + "infrastructure", + "reporting", + "cloud", + "monitoring", + "performance", + "alerts", + "automation" + ], + "examples": [ + { + "inputJson": "{\"startTime\":\"2024-05-01T00:00:00Z\",\"endTime\":\"2024-05-07T23:59:59Z\",\"resourceTypes\":[\"VM\",\"Database\"],\"regions\":[\"us-east-1\"],\"includePerformanceMetrics\":true,\"includeAlerts\":true,\"outputFormat\":\"pdf\"}", + "description": "Generate a PDF report for VMs and Databases in us-east-1 region for one week with metrics and alerts included." + }, + { + "inputJson": "{\"startTime\":\"2024-06-01T00:00:00Z\",\"endTime\":\"2024-06-01T23:59:59Z\",\"resourceTypes\":[],\"regions\":[],\"includePerformanceMetrics\":true,\"includeAlerts\":false,\"outputFormat\":\"html\"}", + "description": "Create an HTML report for all resources across all regions for one day including performance metrics but excluding alerts." + }, + { + "inputJson": "{\"startTime\":\"2024-05-15T00:00:00Z\",\"endTime\":\"2024-05-31T23:59:59Z\",\"resourceTypes\":[\"LoadBalancer\"],\"regions\":[\"eu-central-1\"],\"includePerformanceMetrics\":true,\"includeAlerts\":false,\"outputFormat\":\"json\"}", + "description": "Produce a JSON report of load balancer performance in eu-central-1 for the second half of May, excluding any alerts." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Report", + "context": null + } + }, + { + "name": "security-tools.analyzeAccount", + "description": "This tool analyzes the security posture of a user or service account by examining its permissions, recent activities, and compliance with defined security policies. It accepts account identifiers and optional scope parameters, processes logs and configuration data, and returns a detailed report highlighting vulnerabilities, risky permissions, anomalous behaviors, and policy violations.", + "category": "security-tools", + "parameters": [ + { + "name": "accountId", + "type": "string", + "description": "Unique identifier of the account to analyze (e.g., user ID or service account name).", + "required": true, + "defaultValue": "" + }, + { + "name": "includeActivityLogs", + "type": "boolean", + "description": "Whether to include recent activity logs in the analysis to detect anomalies.", + "required": false, + "defaultValue": "true" + }, + { + "name": "timeRangeDays", + "type": "number", + "description": "Number of past days to consider for activity and compliance analysis.", + "required": false, + "defaultValue": "30" + }, + { + "name": "policySet", + "type": "array", + "description": "List of security policy identifiers to evaluate the account against.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "permissionThresholdLevel", + "type": "string", + "description": "Risk level threshold for highlighting permissions (e.g., 'high', 'medium', 'low').", + "required": false, + "defaultValue": "medium" + } + ], + "returns": { + "type": "object", + "description": "An analysis report including identified vulnerabilities, risky permissions, anomalous activities, compliance status, and actionable recommendations." + }, + "aiAgent": { + "useCase": "Use this tool when you need to assess the security risks associated with a specific account in an organization or system. It is ideal for detecting excessive permissions, suspicious login patterns, or compliance gaps to prevent potential breaches or misuse.", + "limitations": "This tool cannot remediate issues automatically; it provides analysis and recommendations only. It requires valid access to audit logs and permission data. It may not detect all novel or zero-day threats without updated policies and data.", + "examples": [ + "Analyze the security posture of user account 'john.doe' over the last 60 days including activity logs.", + "Assess if service account 'svc_backup' complies with the latest internal security policies.", + "Identify any high-risk permissions assigned to account ID 'user12345'." + ] + }, + "tags": [ + "security", + "account", + "analysis", + "permissions", + "anomaly-detection", + "compliance", + "risk-assessment" + ], + "examples": [ + { + "inputJson": "{\"accountId\":\"john.doe\",\"includeActivityLogs\":true,\"timeRangeDays\":60}", + "description": "Analyze user 'john.doe' activity and permissions over last 60 days." + }, + { + "inputJson": "{\"accountId\":\"svc_backup\",\"policySet\":[\"policy_001\",\"policy_002\"],\"permissionThresholdLevel\":\"high\"}", + "description": "Evaluate 'svc_backup' service account against specified policies, focusing on high-risk permissions." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Account", + "context": null + } + }, + { + "name": "security-tools.downloadFile", + "description": "Downloads a file from a specified URL with optional authentication and validation. Accepts parameters such as URL, destination path, HTTP headers, authentication tokens, and checksum for file integrity verification. The tool fetches the file, saves it locally, and returns status and metadata about the download operation.", + "category": "security-tools", + "parameters": [ + { + "name": "url", + "type": "string", + "description": "The HTTPS URL of the file to download (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "destinationPath", + "type": "string", + "description": "Local file system path where the downloaded file will be saved (required).", + "required": true, + "defaultValue": "" + }, + { + "name": "httpHeaders", + "type": "object", + "description": "Optional HTTP headers to include in the request, as key-value pairs.", + "required": false, + "defaultValue": "{}" + }, + { + "name": "authToken", + "type": "string", + "description": "Optional bearer token for authenticated downloads.", + "required": false, + "defaultValue": "" + }, + { + "name": "timeoutSeconds", + "type": "number", + "description": "Maximum time in seconds to wait for download before timing out.", + "required": false, + "defaultValue": "30" + }, + { + "name": "verifyChecksum", + "type": "boolean", + "description": "Whether to verify the file integrity using checksum if provided.", + "required": false, + "defaultValue": "false" + }, + { + "name": "checksumValue", + "type": "string", + "description": "The expected checksum (e.g., SHA256) to verify against the downloaded file.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object indicating success status, downloaded file path, file size in bytes, checksum of the downloaded file, and an optional error message if failed." + }, + "aiAgent": { + "useCase": "Use this tool when needing to securely download files as part of automation or deployment pipelines, especially when files require authentication or integrity verification. Ideal for fetching configuration files, binaries, or patches in secure environments.", + "limitations": "Does not support FTP or non-HTTP protocols. Cannot handle resumable or chunked downloads. Checksum verification supports only basic string matching; actual checksum calculation depends on implementation.", + "examples": [ + "Download a public file from HTTPS URL to local path.", + "Download a file requiring Bearer token authentication.", + "Download a file and verify its SHA256 checksum." + ] + }, + "tags": [ + "download", + "security", + "file", + "https", + "authentication", + "checksum" + ], + "examples": [ + { + "inputJson": "{\"url\":\"https://example.com/file.zip\",\"destinationPath\":\"/tmp/file.zip\",\"httpHeaders\":{},\"authToken\":\"\",\"timeoutSeconds\":30,\"verifyChecksum\":false,\"checksumValue\":\"\"}", + "description": "Download a public file without authentication or checksum verification." + }, + { + "inputJson": "{\"url\":\"https://secure.example.com/data.json\",\"destinationPath\":\"/var/data/data.json\",\"httpHeaders\":{\"Accept\":\"application/json\"},\"authToken\":\"Bearer abcdef12345\",\"timeoutSeconds\":60,\"verifyChecksum\":false,\"checksumValue\":\"\"}", + "description": "Download a JSON file with Bearer token authentication and custom headers." + }, + { + "inputJson": "{\"url\":\"https://downloads.example.com/app.tar.gz\",\"destinationPath\":\"/apps/app.tar.gz\",\"httpHeaders\":{},\"authToken\":\"\",\"timeoutSeconds\":120,\"verifyChecksum\":true,\"checksumValue\":\"a3b8c9d4e5f67890123456789abcdef1234567890abcdef1234567890abcdef\"}", + "description": "Download a file and verify its SHA256 checksum for integrity." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "File", + "context": null + } + }, + { + "name": "security-tools.analyzeText", + "description": "Analyzes input text to identify potential security risks by detecting sensitive information exposure, malicious content patterns, and code injection attempts. Accepts plain text input, scans for vulnerabilities or security concerns, and outputs a detailed report with findings and risk levels.", + "category": "security-tools", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The input text content to be analyzed for security risks and vulnerabilities.", + "required": true, + "defaultValue": "" + }, + { + "name": "scanForSensitiveData", + "type": "boolean", + "description": "When true, scans the text for sensitive data like passwords, API keys, or personal info.", + "required": false, + "defaultValue": "true" + }, + { + "name": "scanForMaliciousPatterns", + "type": "boolean", + "description": "When true, detects code injection patterns, phishing links, or malicious payloads.", + "required": false, + "defaultValue": "true" + }, + { + "name": "riskThreshold", + "type": "number", + "description": "Minimum risk level (0-10) to include in the output report; lower values report more issues.", + "required": false, + "defaultValue": "3" + } + ], + "returns": { + "type": "object", + "description": "An object containing an array of findings, each detailing the risk type, description, location in text, and assigned risk level from 0 (safe) to 10 (critical). Also includes an overall risk summary." + }, + "aiAgent": { + "useCase": "Use this tool when needing to automatically review text input (e.g., logs, messages, code snippets) for security concerns such as leakage of sensitive information or malicious code patterns, helping prioritize security response and compliance checks.", + "limitations": "Cannot guarantee detection of all possible security risks; deep context understanding is limited and it may produce false positives or negatives. Does not remediate issues, only reports findings.", + "examples": [ + "Analyze a customer's email for exposed password strings.", + "Scan incoming chat messages for possible phishing attempts.", + "Check a code snippet inserted by a user for potential injection risks." + ] + }, + "tags": [ + "security", + "text analysis", + "sensitive data detection", + "code injection", + "risk assessment", + "malicious content" + ], + "examples": [ + { + "inputJson": "{\"text\":\"User password is 'Secret123' and API key abcdef123456\"}", + "description": "Detect exposed passwords and API keys in text" + }, + { + "inputJson": "{\"text\":\" Potential cross-site scripting attempt.\"}", + "description": "Detect malicious script injection patterns" + }, + { + "inputJson": "{\"text\":\"Please send me your bank account password immediately!\"}", + "description": "Flag social engineering phishing attempts in text" + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Text", + "context": null + } + }, + { + "name": "security-tools.downloadCode", + "description": "Downloads source code files securely from a specified remote repository URL. Accepts repository details and authentication parameters, validates access, fetches requested code files or directories, and outputs the code archive or file list with metadata for further security analysis or deployment.", + "category": "security-tools", + "parameters": [ + { + "name": "repositoryUrl", + "type": "string", + "description": "The HTTPS or SSH URL of the remote code repository to download from.", + "required": true, + "defaultValue": "" + }, + { + "name": "branchOrTag", + "type": "string", + "description": "The branch or tag name to download the code from. Defaults to repository default branch if not specified.", + "required": false, + "defaultValue": "main" + }, + { + "name": "filePaths", + "type": "array", + "description": "An optional list of file or directory paths within the repository to download. Downloads entire repository if empty.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "authenticationToken", + "type": "string", + "description": "Optional personal access token or credentials encoded string for private repository authentication.", + "required": false, + "defaultValue": "" + }, + { + "name": "includeSubmodules", + "type": "boolean", + "description": "Whether to recursively download git submodules if they exist.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the downloaded code output: 'zip' archive or 'tar' archive.", + "required": false, + "defaultValue": "zip" + } + ], + "returns": { + "type": "object", + "description": "Returns the download result containing a binary archive of the requested code files along with metadata including repository info, branch/tag, file listing, and integrity hash." + }, + "aiAgent": { + "useCase": "Use this tool whenever an AI agent needs to retrieve source code securely from a version-controlled repository for security assessment, staging, or deployment automation. It supports private and public repositories and selective file downloads, ensuring controlled and authenticated access.", + "limitations": "The tool cannot run code, perform vulnerability analysis, or handle repositories requiring interactive multi-factor authentication beyond token-based methods.", + "examples": [ + "Download the latest code from the main branch of a public GitHub repository.", + "Download specific directories from a private repository using an authentication token.", + "Fetch entire repository code as a zip archive including git submodules." + ] + }, + "tags": [ + "download", + "code", + "repository", + "security", + "fetch", + "git", + "source" + ], + "examples": [ + { + "inputJson": "{\"repositoryUrl\":\"https://github.com/example/project.git\",\"branchOrTag\":\"develop\",\"filePaths\":[\"src\",\"README.md\"],\"authenticationToken\":\"\",\"includeSubmodules\":false,\"outputFormat\":\"zip\"}", + "description": "Download the 'src' directory and 'README.md' file from the 'develop' branch of a public GitHub repository as a zip archive." + }, + { + "inputJson": "{\"repositoryUrl\":\"git@github.com:example/private-repo.git\",\"branchOrTag\":\"release-v1.0\",\"filePaths\":[],\"authenticationToken\":\"ghp_abc123token\",\"includeSubmodules\":true,\"outputFormat\":\"tar\"}", + "description": "Download the entire 'release-v1.0' tagged code from a private repository including submodules, authenticating with a personal access token, output as tar archive." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "download", + "object": "Code", + "context": null + } + }, + { + "name": "security-tools.uploadFile", + "description": "Uploads a file to a secured storage location with optional encryption and virus scanning. The tool accepts file content, filename, and security preferences, processes the file by scanning for malware and applying encryption if requested, then returns a status report including a secure URL for accessing the uploaded file.", + "category": "security-tools", + "parameters": [ + { + "name": "fileContent", + "type": "string", + "description": "Base64 encoded content of the file to be uploaded", + "required": true, + "defaultValue": "" + }, + { + "name": "fileName", + "type": "string", + "description": "Name of the file including extension", + "required": true, + "defaultValue": "" + }, + { + "name": "encrypt", + "type": "boolean", + "description": "Whether to encrypt the file before storage", + "required": false, + "defaultValue": "false" + }, + { + "name": "scanForViruses", + "type": "boolean", + "description": "Whether to perform a virus scan on the uploaded file", + "required": false, + "defaultValue": "true" + }, + { + "name": "accessPermissions", + "type": "string", + "description": "Access level assigned to the file (e.g., 'private', 'public', 'restricted')", + "required": false, + "defaultValue": "private" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional metadata to associate with the file", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing upload status, secure file URL, and scan and encryption results" + }, + "aiAgent": { + "useCase": "Use this tool when you need to securely upload files into a protected environment, ensuring that files are checked for malware and optionally encrypted before storage. Ideal for applications requiring file uploads with security and access management functionalities.", + "limitations": "This tool does not handle large file chunked uploads explicitly, nor does it provide detailed virus scanning report details beyond pass/fail status. It relies on underlying storage infrastructure for durability and access control enforcement.", + "examples": [ + "Upload a user profile picture with encryption enabled and private access.", + "Upload a document without encryption but require a virus scan and make it publicly accessible.", + "Upload a log file with metadata indicating source system and restrict access to internal users only." + ] + }, + "tags": [ + "upload", + "file", + "security", + "encryption", + "virus-scan", + "access-control", + "storage" + ], + "examples": [ + { + "inputJson": "{\"fileContent\":\"VGhpcyBpcyBhIHRlc3QgZmlsZSBjb250ZW50Lg==\",\"fileName\":\"test.txt\",\"encrypt\":true,\"scanForViruses\":true,\"accessPermissions\":\"private\",\"metadata\":{\"uploadedBy\":\"user123\",\"purpose\":\"test upload\"}}", + "description": "Upload a text file with encryption and virus scanning enabled, private access, including metadata." + }, + { + "inputJson": "{\"fileContent\":\"c29tZSBiaW5hcnkgZGF0YQ==\",\"fileName\":\"image.jpg\",\"encrypt\":false,\"scanForViruses\":true,\"accessPermissions\":\"public\"}", + "description": "Upload an image file with virus scanning enabled but no encryption, accessible publicly." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "File", + "context": null + } + }, + { + "name": "security-tools.formatCode", + "description": "Formats source code snippets with customizable style options to improve readability and maintain coding standards. Accepts raw code and optional language and style preferences, and returns formatted code adhering to specified or default formatting rules.", + "category": "security-tools", + "parameters": [ + { + "name": "code", + "type": "string", + "description": "Raw source code text to be formatted.", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language of the input code to apply appropriate syntax formatting (e.g., 'javascript', 'python').", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "styleGuide", + "type": "string", + "description": "Name of the style guide to apply (e.g., 'Google', 'PEP8', 'Airbnb'). If empty, a default formatting style is used.", + "required": false, + "defaultValue": "\"\"" + }, + { + "name": "tabWidth", + "type": "number", + "description": "Number of spaces per indentation level.", + "required": false, + "defaultValue": "4" + }, + { + "name": "useTabs", + "type": "boolean", + "description": "Whether to use tabs for indentation instead of spaces.", + "required": false, + "defaultValue": "false" + }, + { + "name": "semiColons", + "type": "boolean", + "description": "For applicable languages, whether to end statements with semicolons.", + "required": false, + "defaultValue": "true" + }, + { + "name": "printWidth", + "type": "number", + "description": "Maximum line length before code is wrapped to the next line.", + "required": false, + "defaultValue": "80" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted code string and optionally errors if formatting failed." + }, + "aiAgent": { + "useCase": "Use this tool when you have raw source code that needs to be automatically reformatted to improve readability, maintainability, or enforce style guidelines before integration, review, or deployment. It helps standardize code appearance across teams and reduces style-related issues.", + "limitations": "This tool cannot detect or fix semantic code errors or security vulnerabilities. It only reformats code style, relying on the correctness of the input code and cannot support unsupported or unknown languages.", + "examples": [ + "Format a JavaScript snippet to Airbnb style guide conventions.", + "Reformat Python code using PEP8 with 2-space indentation.", + "Apply default styling to a raw HTML snippet without specifying a style guide." + ] + }, + "tags": [ + "formatting", + "code", + "security", + "style", + "code-quality", + "code-style" + ], + "examples": [ + { + "inputJson": "{\"code\":\"function foo(){console.log('bar')}\",\"language\":\"javascript\",\"styleGuide\":\"Airbnb\",\"tabWidth\":2,\"useTabs\":false,\"semiColons\":true,\"printWidth\":80}", + "description": "Format JS function according to Airbnb style with 2 spaces indentation." + }, + { + "inputJson": "{\"code\":\"def my_function():\\nprint(\\\"Hello World\\\")\",\"language\":\"python\",\"styleGuide\":\"PEP8\",\"tabWidth\":4,\"useTabs\":false}", + "description": "Format Python function to PEP8 style with 4 space indentation." + }, + { + "inputJson": "{\"code\":\"Title
\",\"language\":\"html\"}", + "description": "Format basic HTML code snippet without specific style guide." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Code", + "context": null + } + }, + { + "name": "security-tools.formatEmail", + "description": "Formats and sanitizes email content to comply with security best practices. It accepts raw email body text along with optional headers and formats the email by escaping HTML characters, removing potentially malicious scripts, optionally enforcing plain text formatting, and standardizing header fields. The output is a securely formatted email object ready for safe sending or storage.", + "category": "security-tools", + "parameters": [ + { + "name": "emailBody", + "type": "string", + "description": "The raw content of the email body that needs to be formatted and sanitized.", + "required": true, + "defaultValue": "" + }, + { + "name": "headers", + "type": "object", + "description": "Optional email headers (e.g., From, To, Subject) to format and standardize.", + "required": false, + "defaultValue": "" + }, + { + "name": "enforcePlainText", + "type": "boolean", + "description": "If true, converts all email content to plain text, stripping HTML tags to enhance security.", + "required": false, + "defaultValue": "false" + }, + { + "name": "sanitizeScripts", + "type": "boolean", + "description": "If true, removes or neutralizes all script tags and event handlers to prevent XSS attacks in email content.", + "required": false, + "defaultValue": "true" + }, + { + "name": "maxContentLength", + "type": "number", + "description": "Maximum allowed length for the email body content; longer content will be truncated to this length.", + "required": false, + "defaultValue": "10000" + } + ], + "returns": { + "type": "object", + "description": "The sanitized and formatted email object, including cleaned headers and safe, optionally plain-text email body content." + }, + "aiAgent": { + "useCase": "Use this tool when preparing emails for sending or storage to ensure the content is secure against injection attacks and formatted according to security standards. It is especially useful when handling user-generated email content or templated emails where HTML and scripts may be present, to prevent script-based vulnerabilities.", + "limitations": "Does not perform spam filtering, content validation against legal policies, or handle email transport protocols. It focuses solely on formatting and sanitizing the content for security.", + "examples": [ + "Format a user-generated HTML email for safe sending by removing scripts and enforcing plain text.", + "Sanitize email body and standardize headers for logging purposes in a security-conscious system.", + "Truncate overly long email contents while preserving safe formatting for notifications." + ] + }, + "tags": [ + "security", + "email", + "formatting", + "sanitization", + "XSS", + "content-safety", + "emailHeaders" + ], + "examples": [ + { + "inputJson": "{\"emailBody\":\"Welcome!
\",\"headers\":{\"From\":\"user@example.com\",\"To\":\"recipient@example.com\",\"Subject\":\"Test\"},\"enforcePlainText\":true}", + "description": "Convert HTML email with malicious script to safe plain text format, removing scripts and standardizing headers." + }, + { + "inputJson": "{\"emailBody\":\"Hello, check this out!
\",\"headers\":{\"Subject\":\"Hello\"},\"sanitizeScripts\":true}", + "description": "Sanitize HTML email content by removing event handlers and scripts while keeping HTML tags intact." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "format", + "object": "Email", + "context": null + } + }, + { + "name": "security-tools.buildFunction", + "description": "This tool generates secure, parameterized functions in JavaScript for common security-sensitive operations such as input validation, encryption, decryption, hashing, or access control. It accepts a function type and configuration options, then outputs vetted code snippets ready to integrate with secure applications.", + "category": "security-tools", + "parameters": [ + { + "name": "functionType", + "type": "string", + "description": "Type of security function to build (e.g., 'hashing', 'encryption', 'inputValidation').", + "required": true, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Programming language for the output function code (e.g., 'JavaScript', 'Python').", + "required": true, + "defaultValue": "JavaScript" + }, + { + "name": "configOptions", + "type": "object", + "description": "Configuration options specific to the function type, such as hash algorithm or encryption key.", + "required": false, + "defaultValue": "" + }, + { + "name": "useAsync", + "type": "boolean", + "description": "Whether to generate the function as asynchronous (useful for crypto operations).", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated function code as a string, and metadata including function name, description, and any dependencies." + }, + "aiAgent": { + "useCase": "Use this tool when you need to programmatically generate secure and standardized function code snippets for common security tasks such as encryption, hashing, or input validation, especially useful to quickly scaffold a secure function in your application codebase.", + "limitations": "The tool generates code for common, predefined security function types; it cannot create custom complex security protocols or audit existing code for vulnerabilities.", + "examples": [ + "Generate a JavaScript hashing function using SHA-256.", + "Build an asynchronous encryption function in JavaScript with AES-256.", + "Create a synchronous input validation function for email addresses in JavaScript." + ] + }, + "tags": [ + "security", + "code-generation", + "function-builder", + "encryption", + "hashing", + "validation" + ], + "examples": [ + { + "inputJson": "{\"functionType\":\"hashing\",\"language\":\"JavaScript\",\"configOptions\":{\"algorithm\":\"sha256\"},\"useAsync\":false}", + "description": "Generate a synchronous JavaScript function for SHA-256 hashing." + }, + { + "inputJson": "{\"functionType\":\"encryption\",\"language\":\"JavaScript\",\"configOptions\":{\"algorithm\":\"aes-256-cbc\",\"key\":\"your-256-bit-secret\"},\"useAsync\":true}", + "description": "Generate an asynchronous JavaScript AES-256-CBC encryption function." + }, + { + "inputJson": "{\"functionType\":\"inputValidation\",\"language\":\"JavaScript\",\"configOptions\":{\"validationType\":\"email\"},\"useAsync\":false}", + "description": "Generate a synchronous JavaScript function for validating email addresses." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "build", + "object": "Function", + "context": null + } + }, + { + "name": "security-tools.generateWord", + "description": "Generates a secure, random word suitable for use in passwords, passphrases, or security tokens. Accepts parameters to specify desired length, character sets (letters, digits, symbols), and complexity requirements. Outputs a random word string that meets the specified security criteria.", + "category": "security-tools", + "parameters": [ + { + "name": "length", + "type": "number", + "description": "Desired length of the generated word, must be between 4 and 64 characters.", + "required": true, + "defaultValue": "12" + }, + { + "name": "includeUppercase", + "type": "boolean", + "description": "Whether to include uppercase letters in the generated word.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeDigits", + "type": "boolean", + "description": "Whether to include numeric digits in the generated word.", + "required": false, + "defaultValue": "true" + }, + { + "name": "includeSymbols", + "type": "boolean", + "description": "Whether to include symbols/special characters in the generated word.", + "required": false, + "defaultValue": "false" + }, + { + "name": "mustStartWithLetter", + "type": "boolean", + "description": "If true, the word will always start with a letter to improve usability while maintaining security.", + "required": false, + "defaultValue": "true" + } + ], + "returns": { + "type": "object", + "description": "Contains the randomly generated secure word as a string." + }, + "aiAgent": { + "useCase": "Use this tool when generating strong, human-readable secure words or tokens for authentication, password creation, or cryptographic keys that require customizable complexity and length. It helps prevent weak or guessable passwords by ensuring randomness and complexity parameters.", + "limitations": "This tool generates single words only, not multi-word passphrases. It does not assess the semantic meaning or dictionary presence of the word, so some generated words may unintentionally form dictionary words or nonsensical strings.", + "examples": [ + "Generate a 16-character secure password including uppercase, digits and symbols.", + "Create a 10-character word starting with a letter and including digits but no symbols.", + "Generate a 12-character secure token with letters and digits only." + ] + }, + "tags": [ + "security", + "password", + "token", + "random", + "word", + "generation", + "credentials" + ], + "examples": [ + { + "inputJson": "{\"length\":16,\"includeUppercase\":true,\"includeDigits\":true,\"includeSymbols\":true,\"mustStartWithLetter\":true}", + "description": "Generate a 16-character secure password including uppercase letters, digits, and symbols." + }, + { + "inputJson": "{\"length\":10,\"includeUppercase\":true,\"includeDigits\":true,\"includeSymbols\":false,\"mustStartWithLetter\":true}", + "description": "Generate a 10-character word starting with a letter, including digits but no symbols." + }, + { + "inputJson": "{\"length\":12,\"includeUppercase\":true,\"includeDigits\":false,\"includeSymbols\":false,\"mustStartWithLetter\":true}", + "description": "Generate a 12-character secure word with letters only, starting with a letter." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Word", + "context": null + } + }, + { + "name": "security-tools.generateTest", + "description": "Generates automated security test scripts based on specified input parameters such as target application type, security focus area (e.g., authentication, input validation), and testing framework. It outputs ready-to-run test code snippets or full test files to aid developers in automating security testing and improving code robustness.", + "category": "security-tools", + "parameters": [ + { + "name": "applicationType", + "type": "string", + "description": "The type of target application (e.g., web, API, mobile) to tailor the security test accordingly.", + "required": true, + "defaultValue": "" + }, + { + "name": "testFocus", + "type": "string", + "description": "The specific security aspect to test, such as 'authentication', 'authorization', 'inputValidation', or 'sessionManagement'.", + "required": true, + "defaultValue": "" + }, + { + "name": "testingFramework", + "type": "string", + "description": "The preferred testing framework or language (e.g., Jest, Mocha, Pytest) for generating the test code.", + "required": true, + "defaultValue": "" + }, + { + "name": "includeExploitPayloads", + "type": "boolean", + "description": "Whether to include simulated exploit payloads to test vulnerability handling.", + "required": false, + "defaultValue": "false" + }, + { + "name": "outputFormat", + "type": "string", + "description": "Format of the generated test code output, e.g., 'codeSnippet' or 'fullTestFile'.", + "required": false, + "defaultValue": "codeSnippet" + } + ], + "returns": { + "type": "object", + "description": "An object containing the generated test script code as a string, plus metadata about the test such as language and test focus." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to assist developers or security engineers by auto-generating practical security test code for various application types and security aspects. It helps automate creation of security test cases, accelerating vulnerability detection in software development lifecycle.", + "limitations": "Cannot fully replace expert security audits or perform dynamic runtime security testing; limited to generating static test scripts based on input parameters. Generated tests may require manual review and environment setup.", + "examples": [ + "Generate a Jest test code snippet to test authentication security in a web application, including exploit payloads.", + "Create a full Pytest file focusing on input validation testing for an API application without exploit payloads." + ] + }, + "tags": [ + "security", + "test-generation", + "automation", + "code", + "security-testing", + "devsecops" + ], + "examples": [ + { + "inputJson": "{\"applicationType\":\"web\",\"testFocus\":\"authentication\",\"testingFramework\":\"Jest\",\"includeExploitPayloads\":true,\"outputFormat\":\"codeSnippet\"}", + "description": "Generate a Jest test code snippet for authentication security tests with exploit payloads for a web application." + }, + { + "inputJson": "{\"applicationType\":\"API\",\"testFocus\":\"inputValidation\",\"testingFramework\":\"Pytest\",\"includeExploitPayloads\":false,\"outputFormat\":\"fullTestFile\"}", + "description": "Generate a full Pytest test file focusing on input validation for an API application without exploit payloads." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "generate", + "object": "Test", + "context": null + } + }, + { + "name": "security-tools.createAccount", + "description": "Creates a secure user account by accepting details such as username, password, roles, and optional metadata. The tool validates input, hashes the password securely, assigns roles, and outputs a structured account object with a unique identifier and creation timestamp, ready for storage or further processing.", + "category": "security-tools", + "parameters": [ + { + "name": "username", + "type": "string", + "description": "Unique username for the new account", + "required": true, + "defaultValue": "" + }, + { + "name": "password", + "type": "string", + "description": "Plain text password to be securely hashed and stored", + "required": true, + "defaultValue": "" + }, + { + "name": "roles", + "type": "array", + "description": "Array of roles assigned to the user account", + "required": false, + "defaultValue": "[\"user\"]" + }, + { + "name": "email", + "type": "string", + "description": "Optional email address associated with the account", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional additional key-value data to store with the account", + "required": false, + "defaultValue": "{}" + } + ], + "returns": { + "type": "object", + "description": "An object containing the created account's unique ID, username, hashed password, assigned roles, email if provided, metadata, and created timestamp." + }, + "aiAgent": { + "useCase": "Use this tool when needing to programmatically create secure user accounts with proper password hashing and role assignment, ensuring standardized account records for authentication and authorization in applications or systems.", + "limitations": "Does not handle sending confirmation emails or multifactor authentication setup; assumes password meets security policies enforced elsewhere.", + "examples": [ + "Create a new user account with username, password, and default user role.", + "Create an admin account by specifying multiple roles and including metadata.", + "Add an email address and custom metadata when creating an account." + ] + }, + "tags": [ + "security", + "account-management", + "user-creation", + "authentication", + "authorization" + ], + "examples": [ + { + "inputJson": "{\"username\":\"jdoe\",\"password\":\"S3cur3Pass!\",\"roles\":[\"user\"]}", + "description": "Basic user account creation with default role." + }, + { + "inputJson": "{\"username\":\"admin01\",\"password\":\"Adm1nPass!\",\"roles\":[\"admin\",\"user\"],\"email\":\"admin@example.com\"}", + "description": "Admin account creation with multiple roles and email." + }, + { + "inputJson": "{\"username\":\"alice\",\"password\":\"AlicePass123\",\"metadata\":{\"department\":\"sales\",\"location\":\"NYC\"}}", + "description": "User account with additional metadata fields." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Account", + "context": null + } + }, + { + "name": "security-tools.createCommit", + "description": "Creates a secure and properly formatted Git commit with optional signing. It accepts details like commit message, author info, branch target, files to include, and GPG signing options. The tool processes these inputs to generate a commit object or error feedback, ensuring best practices in code versioning and security.", + "category": "security-tools", + "parameters": [ + { + "name": "commitMessage", + "type": "string", + "description": "The descriptive message explaining the commit changes, recommended to follow conventional commits.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorName", + "type": "string", + "description": "The full name of the author making the commit.", + "required": true, + "defaultValue": "" + }, + { + "name": "authorEmail", + "type": "string", + "description": "The email address of the author, used in commit metadata.", + "required": true, + "defaultValue": "" + }, + { + "name": "branchName", + "type": "string", + "description": "The target branch where the commit will be applied; defaults to the current branch if empty.", + "required": false, + "defaultValue": "" + }, + { + "name": "filesChanged", + "type": "array", + "description": "List of file paths to include in the commit; supports new, modified, and deleted files.", + "required": true, + "defaultValue": "" + }, + { + "name": "signCommit", + "type": "boolean", + "description": "Indicates if the commit should be signed using a GPG key.", + "required": false, + "defaultValue": "false" + }, + { + "name": "gpgKeyId", + "type": "string", + "description": "The identifier of the GPG key to sign the commit with; required if signCommit is true.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the commit hash, summary, and status information indicating success or details of failure." + }, + "aiAgent": { + "useCase": "Use this tool when an AI agent needs to perform automated, secure commits to a code repository with proper metadata, including author info and optional signing, ensuring codebase integrity and traceability.", + "limitations": "This tool does not handle pushing commits to remote repositories or resolving merge conflicts; it assumes that file changes are already staged and does not validate file contents beyond their paths.", + "examples": [ + "Create a commit with message, author details, on main branch including changed files without signing.", + "Create a signed commit on feature-branch using specified GPG key for secure audit-proof commits.", + "Generate a commit on default branch with a conventional commit message for automated changelog generation." + ] + }, + "tags": [ + "security", + "git", + "commit", + "version-control", + "signing", + "automation" + ], + "examples": [ + { + "inputJson": "{\"commitMessage\":\"fix: resolve race condition in auth module\",\"authorName\":\"Alex Johnson\",\"authorEmail\":\"alex.johnson@example.com\",\"branchName\":\"main\",\"filesChanged\":[\"src/auth.js\",\"tests/auth.test.js\"],\"signCommit\":false,\"gpgKeyId\":\"\"}", + "description": "Create a standard commit on main branch with multiple file changes and no signing." + }, + { + "inputJson": "{\"commitMessage\":\"feat: add multi-factor authentication support\",\"authorName\":\"Maria Gomez\",\"authorEmail\":\"maria.gomez@example.com\",\"branchName\":\"feature/mfa\",\"filesChanged\":[\"src/mfa.js\",\"config/security.yaml\"],\"signCommit\":true,\"gpgKeyId\":\"ABC123DEF456\"}", + "description": "Create a signed commit on feature branch implementing multi-factor authentication." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Commit", + "context": null + } + }, + { + "name": "customer-support.createCustomer", + "description": "Creates a new customer profile in the customer support system. Accepts customer details such as name, email, phone, address, and optional metadata. Validates input, stores the customer record, and returns a summary including a unique customer ID and confirmation of successful creation.", + "category": "customer-support", + "parameters": [ + { + "name": "firstName", + "type": "string", + "description": "Customer's first name", + "required": true, + "defaultValue": "" + }, + { + "name": "lastName", + "type": "string", + "description": "Customer's last name", + "required": true, + "defaultValue": "" + }, + { + "name": "email", + "type": "string", + "description": "Customer's email address, used for contact and identification", + "required": true, + "defaultValue": "" + }, + { + "name": "phoneNumber", + "type": "string", + "description": "Customer's phone number, formatted with country code", + "required": false, + "defaultValue": "" + }, + { + "name": "address", + "type": "object", + "description": "Customer's address details including street, city, state, postal code, and country", + "required": false, + "defaultValue": "" + }, + { + "name": "metadata", + "type": "object", + "description": "Optional key-value pairs of additional customer attributes or tags", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "Returns the new customer's unique identifier, creation timestamp, and a status message indicating success or error details." + }, + "aiAgent": { + "useCase": "Use this tool when needing to register or onboard a new customer within the customer support platform, such as when a customer first contacts support or is added manually by agents. It ensures customer data is captured in the system for tracking inquiries and service records.", + "limitations": "It does not handle updating existing customers or deleting records. Validation is limited to format and required fields; deeper verification (e.g., email confirmation) must be done separately.", + "examples": [ + "Create a new customer profile with basic contact info to initiate a support ticket.", + "Add optional address details when registering a customer for personalized service.", + "Include additional metadata like customer preferences or account type when creating the profile." + ] + }, + "tags": [ + "customer-support", + "create", + "customer-management", + "onboarding", + "crm" + ], + "examples": [ + { + "inputJson": "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"email\":\"jane.doe@example.com\"}", + "description": "Basic customer creation with mandatory fields only." + }, + { + "inputJson": "{\"firstName\":\"Mark\",\"lastName\":\"Smith\",\"email\":\"mark.smith@example.com\",\"phoneNumber\":\"+1234567890\",\"address\":{\"street\":\"123 Elm St\",\"city\":\"Somewhere\",\"state\":\"CA\",\"postalCode\":\"90210\",\"country\":\"USA\"}}", + "description": "Customer creation including phone number and full address." + }, + { + "inputJson": "{\"firstName\":\"Lucy\",\"lastName\":\"Jones\",\"email\":\"lucy.jones@example.com\",\"metadata\":{\"loyaltyTier\":\"Gold\",\"preferredContact\":\"email\"}}", + "description": "Customer profile with additional metadata for personalized service." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "create", + "object": "Customer", + "context": null + } + }, + { + "name": "documentation-tools.analyzeWord", + "description": "Analyzes a single word within documentation content to extract linguistic and contextual properties. Accepts a word string and optional context text to determine parts of speech, frequency, readability impact, and suggested synonyms. Outputs a detailed analysis object useful for refining documentation clarity and consistency.", + "category": "documentation-tools", + "parameters": [ + { + "name": "word", + "type": "string", + "description": "The single word text to analyze within documentation.", + "required": true, + "defaultValue": "" + }, + { + "name": "contextText", + "type": "string", + "description": "Optional surrounding text to provide context for analysis (e.g., sentence or paragraph).", + "required": false, + "defaultValue": "" + }, + { + "name": "language", + "type": "string", + "description": "Language code of the text (e.g., 'en' for English) to adapt analysis accordingly.", + "required": false, + "defaultValue": "\"en\"" + }, + { + "name": "includeSynonyms", + "type": "boolean", + "description": "Whether to return suggested synonyms for the word to improve clarity or variation.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object containing linguistic properties such as part of speech, usage frequency, readability impact score, and optional synonyms array." + }, + "aiAgent": { + "useCase": "Use this tool when needing to evaluate or improve individual word usage within documentation, such as checking if a word is appropriate, frequently used, or impacts readability, along with getting synonym suggestions for variety or clarity.", + "limitations": "This tool analyzes only a single word and its immediate context, and does not replace full document semantic analysis or style guideline enforcement.", + "examples": [ + "Analyze the word 'optimize' in a software documentation paragraph.", + "Check the part of speech and synonyms for 'performance' in English documentation.", + "Determine if 'utilize' negatively affects readability in given technical text." + ] + }, + "tags": [ + "documentation", + "analysis", + "word", + "linguistics", + "clarity", + "synonyms", + "readability" + ], + "examples": [ + { + "inputJson": "{\"word\":\"optimize\",\"contextText\":\"To optimize your code for better performance, consider refactoring critical functions.\",\"language\":\"en\",\"includeSynonyms\":true}", + "description": "Analyzes the word 'optimize' in a sample sentence to determine its part of speech and provide synonyms." + }, + { + "inputJson": "{\"word\":\"performance\",\"contextText\":\"Performance metrics are crucial for monitoring software health.\",\"language\":\"en\",\"includeSynonyms\":false}", + "description": "Analyzes the word 'performance' with context but without requesting synonyms." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "analyze", + "object": "Word", + "context": null + } + }, + { + "name": "documentation-tools.uploadDocument", + "description": "Uploads a document file to a documentation management system. Accepts inputs such as document content (file path or base64), document metadata (title, author, tags), and destination folder. Processes the upload by validating inputs and storing the document, returning a confirmation including document ID and upload status.", + "category": "documentation-tools", + "parameters": [ + { + "name": "documentContent", + "type": "string", + "description": "Path to the document file or base64 encoded content to be uploaded.", + "required": true, + "defaultValue": "" + }, + { + "name": "title", + "type": "string", + "description": "The title of the document, used for identification and display.", + "required": true, + "defaultValue": "" + }, + { + "name": "author", + "type": "string", + "description": "Name of the author or uploader of the document.", + "required": false, + "defaultValue": "" + }, + { + "name": "tags", + "type": "array", + "description": "List of tags or keywords associated with the document for categorization.", + "required": false, + "defaultValue": "[]" + }, + { + "name": "destinationFolder", + "type": "string", + "description": "The target folder or path within the documentation system where the document should be uploaded.", + "required": false, + "defaultValue": "" + }, + { + "name": "overwriteExisting", + "type": "boolean", + "description": "Flag indicating if an existing document with the same title should be overwritten.", + "required": false, + "defaultValue": "false" + } + ], + "returns": { + "type": "object", + "description": "An object confirming the upload operation containing the new document's unique ID, status message, and any errors encountered." + }, + "aiAgent": { + "useCase": "This tool should be used whenever an AI agent needs to programmatically upload or update documentation files in a managed documentation repository or platform. It is ideal for automating documentation publishing, batch uploads of multiple files, or updating existing files while preserving metadata.", + "limitations": "Does not handle document editing or parsing of document content. It assumes input documents are valid and supported file types. Does not manage version history beyond overwrite flag.", + "examples": [ + "Upload a new user manual PDF to the 'Products' documentation folder with tags 'manual', 'productX'.", + "Update an existing specification document by overwriting it with a newer version and logging the new author.", + "Upload multiple markdown files for release notes, setting author and categorizing by tags." + ] + }, + "tags": [ + "upload", + "documentation", + "file-management", + "metadata", + "automation", + "document-management" + ], + "examples": [ + { + "inputJson": "{\"documentContent\":\"/path/to/user-manual.pdf\",\"title\":\"User Manual Product X\",\"author\":\"Jane Doe\",\"tags\":[\"manual\",\"productX\"],\"destinationFolder\":\"/Products/Manuals/\",\"overwriteExisting\":false}", + "description": "Upload a new user manual PDF with relevant tags and author information to the product manuals folder." + }, + { + "inputJson": "{\"documentContent\":\"/path/to/specification_v2.docx\",\"title\":\"API Specification\",\"author\":\"John Smith\",\"tags\":[\"api\",\"specification\"],\"destinationFolder\":\"/Specs/\",\"overwriteExisting\":true}", + "description": "Overwrite an existing API specification document with a new version and update the author." + } + ], + "qualityScore": 0.95, + "skeleton": { + "verb": "upload", + "object": "Document", + "context": null + } + }, + { + "name": "documentation-tools.buildFunction", + "description": "This tool generates detailed documentation for a single function based on provided function signature, description, parameters, and optionally examples. It processes these inputs to produce a structured, well-formatted documentation snippet suitable for codebases and API docs.", + "category": "documentation-tools", + "parameters": [ + { + "name": "functionName", + "type": "string", + "description": "The name of the function to document.", + "required": true, + "defaultValue": "" + }, + { + "name": "functionDescription", + "type": "string", + "description": "A clear, concise description summarizing the function's purpose and behavior.", + "required": true, + "defaultValue": "" + }, + { + "name": "parameters", + "type": "array", + "description": "An array of parameter objects each with name, type, and description for the function arguments.", + "required": true, + "defaultValue": "" + }, + { + "name": "returnType", + "type": "string", + "description": "The data type or description of the function's return value.", + "required": true, + "defaultValue": "" + }, + { + "name": "returnDescription", + "type": "string", + "description": "A brief explanation of what the function returns.", + "required": false, + "defaultValue": "" + }, + { + "name": "examples", + "type": "array", + "description": "Optional array of usage example objects including code snippets and explanations.", + "required": false, + "defaultValue": "" + } + ], + "returns": { + "type": "object", + "description": "An object containing the formatted function documentation as a string suitable for embedding in documentation files or code comments, plus optional metadata like markdown format." + }, + "aiAgent": { + "useCase": "This tool is useful when an AI agent needs to automatically generate comprehensive and standardized documentation for code functions from partial information. It helps programmers maintain clear docs, improve onboardings, and increase codebase comprehensibility.", + "limitations": "It cannot reverse-engineer undocumented function behavior or verify code correctness; relies entirely on provided inputs for accuracy.", + "examples": [ + "Generate documentation for a utility function that formats dates.", + "Create doc for a function with multiple parameters and a return value.", + "Build documentation snippet for API endpoint handler function." + ] + }, + "tags": [ + "documentation", + "function", + "code-docs", + "developer-tools", + "automation" + ], + "examples": [ + { + "inputJson": "{\"functionName\":\"calculateSum\",\"functionDescription\":\"Calculates the sum of two numbers.\",\"parameters\":[{\"name\":\"a\",\"type\":\"number\",\"description\":\"First number to add.\"},{\"name\":\"b\",\"type\":\"number\",\"description\":\"Second number to add.\"}],\"returnType\":\"number\",\"returnDescription\":\"The sum of the two input numbers.\",\"examples\":[{\"code\":\"calculateSum(2, 3)\",\"description\":\"Returns 5\"}]}", + "description": "Document a simple addition function with two parameters and a numeric return." + }, + { + "inputJson": "{\"functionName\":\"fetchUserData\",\"functionDescription\":\"Fetches user data based on user ID asynchronously.\",\"parameters\":[{\"name\":\"userId\",\"type\":\"string\",\"description\":\"Unique identifier of the user.\"}],\"returnType\":\"Promise