Skip to main content

Support pack

Support pack template, support case assistant on fictitious data with a simulated helpdesk connector.

Reference​

FieldValue
Namesupport
Version1.0.0
LicenceMIT
TypeTemplate
formatpack
domainsupport
Categorysupport
namespaceenterprise-ai-packs
publisherEnterprise AI reference packs
ownerenterprise-ai-packs
compatibility.platform>=1.0.0 <2.0.0
compatibility.sdk>=1.0.0 <2.0.0
compatibility.runtimesnavin
dependenciesNone
Sourcepacks/templates/support/plugin.yaml
Documentationpacks/templates/support/docs/en/README.md, packs/templates/support/docs/fr/README.md

Capabilities​

KindName
toolsupport-search
toolsupport-update-status
connectorsupport-helpdesk
policysupport

Requested permissions​

The administrator grants a subset at install time; only the granted scopes are enforced.

ScopeSensitiveClassificationReason
support.cases.readNoconfidentialRead support case records to answer questions.
support.cases.writeYesconfidentialChange the status of a support case after a human approval.

Data protection​

FieldValue
classification_maxconfidential
piifalse
residencyeu-west-1
retention_days30
dlpmask
fictitious_datatrue
piiDetectionRequiredtrue
maskingPolicymask
externalExportDefaultdeny

Approvals​

Required for: install, upgrade, sensitivePermissions, production, externalExport, resume.

GateQuorumRoles
install1tenant_admin, security_officer
sensitive2tenant_admin, security_officer
production2tenant_admin, security_officer

Security and test flags​

FieldValue
security.signedArtifactRequiredtrue
security.sandboxRequiredtrue
security.dynamicAuthorizationtrue
security.auditRequiredtrue
testFlags.sdkConformancetrue
testFlags.authorizationtrue
testFlags.securitytrue

Configuration​

Properties of spec.configSchema, set by the administrator at install time:

NameTypeConstraints
model_idstring{"minLength": 3}
mcp_serversobject{"additionalProperties": {"additionalProperties": false, "properties": {"url": {"pattern": "^https?://", "type": "string"}}, "required": ["url"], "type": "object"}}

Components​

KindNameVersionDescriptionDetailsPath
Agentsupport-assistant1.0.0Answers questions on support case records and prepares status changes for a human approval.risk_level: limited, autonomy.level: supervised, tools tool:support-search, tool:support-update-statuspacks/templates/support/agents/support-assistant.yaml
Subagentsupport-reviewer1.0.0Reviews a proposed support case status change against the rules before the human approval.risk_level: minimal, autonomy.level: assisted, tools tool:support-searchpacks/templates/support/subagents/support-reviewer.yaml
Promptsupport-summary-Summary of a support case record for a business user.variables record_id, audience, languagepacks/templates/support/prompts/support-summary.yaml
MCP serversupport-mcp-MCP server of the Support pack (official MCP Python SDK, MIT licence).transport: streamable_http, tools support_search, support_update_statuspacks/templates/support/mcp/servers/support-mcp.yaml
MCP toolsupport-search1.0.0Search fictitious support case records through the pack MCP server.action: read, scopes support.cases.read, risk_level: limited, requires_approval: falsepacks/templates/support/mcp/tools/support-search.yaml
MCP toolsupport-update-status1.0.0Change the status of a fictitious support case record, idempotent, after a human approval.action: write, scopes support.cases.write, risk_level: high, requires_approval: truepacks/templates/support/mcp/tools/support-update-status.yaml
Connectorsupport-helpdesk1.0.0helpdesk connector of the Support pack. Simulated on fictitious data until the tenant configures it.system: helpdesk, auth.type: api_key, scopes support.cases.read, support.cases.writepacks/templates/support/connectors/support-helpdesk.yaml
Workflowsupport-status-change-Status change of a support case with a review and a four eyes approval.steps search, review, approval, apply, on_failure: stoppacks/templates/support/workflows/support-status-change.yaml
Knowledge basesupport-knowledge-Knowledge base template of the Support pack (fictitious documents).classification: internalpacks/templates/support/rag/config.yaml
Skillsupport-guidelines1.0.0How the Support assistant handles support case records.scopes support.cases.read, data_classification_max: confidentialpacks/templates/support/skills/support-guidelines/SKILL.md

Evaluations and tests​

NameTypePathThreshold
support-answerspromptfooevaluations/promptfoo.yaml1.0
support-retrievalragasevaluations/ragas.jsonl0.8
KindPath
unittests/unit
integrationtests/integration
authztests/authz
securitytests/security
opapolicies/opa

Files​

KindPath
Rulespacks/templates/support/rules/support-rules.md
Policiespacks/templates/support/policies/opa/support.rego, packs/templates/support/policies/opa/support_test.rego, packs/templates/support/policies/openfga/model.fga, packs/templates/support/policies/openfga/tests.fga.yaml
Observabilitypacks/templates/support/observability/alerts/support.yaml
Knowledge base documentspacks/templates/support/rag/documents/guide.md

Install it​

Validate, build, sign and publish the pack, then install it from the Marketplace: the preflight checks the capabilities and the configuration before the installation.

enterprise-ai plugin validate packs/templates/support
enterprise-ai plugin build packs/templates/support --out /tmp/support-dist
COSIGN_PASSWORD=... enterprise-ai plugin sign packs/templates/support --out /tmp/support-dist --key cosign.key --signer <publisher>
enterprise-ai plugin publish packs/templates/support --out /tmp/support-dist --key cosign.key \
--oci <registry>/packs/support:1.0.0

cosign.key: signing key of your organization. <publisher>: publisher name registered in the Marketplace. <registry>: OCI registry of the Marketplace. Then call POST /v1/marketplace/preflight and POST /v1/marketplace/installations, see the Marketplace guide.