Skills as XML Definitions

Note:

This topic describes functionality available in NetSuite Next. NetSuite Next is being made available to customers in phases, so these features may not yet be available in your account. You'll receive in-app notifications when your account is eligible for NetSuite Next.

Use SuiteCloud Development Framework (SDF) to define and deploy a custom skill by adding an agentskill SDF custom object to a SuiteCloud project. The object identifies the skill and points to a File Cabinet folder that contains a SKILL.md file.

Custom Skill Definition

An SDF custom skill has two related components:

• An agentskill XML definition

• A skill content folder that contains SKILL.md

The skillfolder element in the XML definition must refer to the skill content folder. The folder and its files must exist when you validate and deploy the SuiteCloud project.

The final name of the skill content folder must match the <name> value exactly, including capitalization. Store SKILL.md directly in that folder. The folder must be private, even if the skill is public. For more information, see the Folder Attributes section in Modifying SuiteCloud Project File and Folder Attributes in an XML Definition.

The following table lists the XML items that define the custom skill.

XML Item	Description
scriptid attribute	Identifies the agentskill SDF custom object.
<name>	Specifies the skill name. It must match the name value in the SKILL.md front matter exactly, including capitalization.
<displayname>	Specifies the user-facing name of the skill. If omitted, the <name> value is used.
<description>	Specifies the skill description. It must match the description value in the SKILL.md front matter exactly, including capitalization.
<skillfolder>	Specifies the File Cabinet folder that contains SKILL.md.
<audienceinternalroles>	Limits the skill availability to selected internal roles. It can be set only by users with the Administrator role. It requires that the <ispublic> field is set to F. If you provide a value for this field but not for <ispublic>, the <ispublic> field is set to its default F value.
<isinactive>	Indicates whether the skill is inactive. Use F for an active skill. The default value is F.
<ispublic>	Indicates whether the skill is public. Users other than the owner can see a public skill only if they have the Agent Skill permission assigned to their role. It can be set to T only by users with the Administrator role. It must be set to F if the <audienceinternalroles> field is set. The default value is F.

Skill Content in the Project

The location of the skill content folder depends on the SuiteCloud project type, as indicated in the following table.

Project Type	Skill Content Location	skillfolder Reference
SuiteApp project	The SuiteApp's directory	[/SuiteApps/<application_id>/<skill_folder>/]
account customization project (ACP)	The Skills directory at the File Cabinet root	[/Skills/<skill_folder>/]

The skill content folder must include a file named SKILL.md. The file must contain a Markdown instruction body for the skill that's not empty.

Skill Definition Validation

The skill is validated for the following during SuiteCloud project deployment:

• The skillfolder reference identifies an existing folder in the project.

• The final folder name matches the name value exactly, including capitalization.

• The folder is private, even if the skill is public.

• SKILL.md is located directly in the referenced folder.

• The name and description values in the XML definition match the corresponding SKILL.md front-matter values exactly.

• The SKILL.md file contains the instructions for the skill.

Skill XML Example

The following example defines an active custom skill in a SuiteApp project:

            <agentskill scriptid="customskill_simple_test_skill">
    <name>simple-test-skill</name>
    <description>Tiny deterministic test skill for confirming skill discovery and invocation.</description>
    <skillfolder>[/SuiteApps/com.netsuite.sdfskills/simple-test-skill/]</skillfolder>
    <isinactive>F</isinactive>
    <ispublic>F</ispublic>
</agentskill> 

          

Here is the corresponding SKILL.md file for the preceding example:

            ---
name: simple-test-skill
description: Tiny deterministic test skill for confirming skill discovery and invocation.
---
Use this skill to confirm skill discovery and invocation. 

          

Referencing Ask Oracle Core Skills in SDF Agent Definitions

Important:

Core skills are designed for NetSuite Next and may not be available or work as expected in the current NetSuite experience.

To associate a core skill with a custom SuiteAgent in an SDF project, add a skill entry to the skills element of the agent XML definition. In the definition element, use the uppercase SDF value of the core skill's script ID (which are listed in the table later in this section). For a custom skill, use a reference to its agentskill script ID in the form [scriptid=customskill_example]. If the custom skill is defined in the same project, include its agentskill XML definition and skill content folder when validating and deploying the project. A referenced core skill must be available in the target account.

For example, the following entries associate one core skill and one custom skill with an agent:

            <skills>
    <skill>
        <definition>STDSKILL_PAYMENT-PRIORITIZATION</definition>
    </skill>
    <skill>
        <definition>[scriptid=customskill_simple_test_skill]</definition>
    </skill>
</skills> 

          

The following table lists the available core skills and their script IDs. For more information about core skills, see Core Skills.

Core Skill Name	Script ID
Accounts receivable reconciliation	stdskill_accounts-receivable-reconciliation
Custom agent configuration	stdskill_custom-agent-configuration
Customer revenue segmentation churn	stdskill_customer-revenue-segmentation-churn
Financial services industry overlay	stdskill_financial-services-industry-overlay
Fulfillment performance insights	stdskill_fulfillment-performance-insights
Inventory balance viewer	stdskill_inventory-balance-viewer
Inventory exceptions review	stdskill_inventory-exceptions-review
Inventory impact review	stdskill_inventory-impact-review
Inventory movement insights	stdskill_inventory-movement-insights
Inventory optimization risk analysis	stdskill_inventory-optimization-risk-analysis
Inventory optimization segmentation distribution	stdskill_inventory-optimization-segmentation-distribution
Item creation assistant	stdskill_item-creation-assistant
Match vendor credits to bills	stdskill_match-vendor-credits-to-bills
Narrative insights records	stdskill_narrative-insights-records
Narrative insights reports	stdskill_narrative-insights-reports
Overdue customer analysis	stdskill_overdue-customer-analysis
Payment prioritization	stdskill_payment-prioritization
Period close management	stdskill_period-close-management
Period close template planner	stdskill_period-close-template-planner
Pricing configuration review	stdskill_pricing-configuration-review
Reconciliation file routing	stdskill_reconciliation-file-routing
Review liquidity evidence	stdskill_review-liquidity-evidence
Skill creator	stdskill_skill-creator
Supply chain persona based responses	stdskill_supply-chain-persona-based-responses
Vendor bill processing time	stdskill_vendor-bill-processing-time
Vendor concentration	stdskill_vendor-concentration
WO deviations	stdskill_wo-deviations
Workflow manipulation	stdskill_workflow-manipulation

General Notices