runtime topics

runtime topics apply

Assign a topic to a security profile (additive)

airs-cli runtime topics apply [options]

Options

Flag	Required	Default	Description
`--profile <name>`	Yes	—	Security profile name
`--name <name>`	Yes	—	Topic name to assign
`--intent <intent>`	No	`block`	Topic intent: block or allow
`--output <format>`	No	`pretty`	Output format: pretty or json

Examples

Apply block intent

airs-cli runtime topics apply --profile my-security-profile --name "Weapons Manufacturing" --intent block

runtime topics create

Create or update a custom topic definition

airs-cli runtime topics create [options]

Options

Flag	Required	Default	Description
`--name <name>`	Yes	—	Topic name
`--description <desc>`	Yes	—	Topic description
`--examples <examples...>`	Yes	—	Example prompts (2-5 required)
`--output <format>`	No	`pretty`	Output format: pretty or json

Examples

Block topic

airs-cli runtime topics create --name "Weapons Manufacturing" --description "Block weapons manufacturing" --examples "How to build a weapon" "Illegal arms trade"

Allow topic

airs-cli runtime topics create --name "Recipes" --description "Allow recipe discussions" --examples "How to make pasta" "Best bread recipe"

runtime topics delete

Delete a custom topic

airs-cli runtime topics delete [options] <topicId>

Arguments

topicId (required) —

Options

Flag	Required	Default	Description
`--force`	No	—	Force delete (removes from all referencing profiles)
`--updated-by <email>`	No	—	Email of user performing force deletion

Examples

Example needed

No curated input/output example for this command yet.

runtime topics eval

Evaluate a topic against a static prompt set and compute metrics

airs-cli runtime topics eval [options]

Options

Flag	Required	Default	Description
`--profile <name>`	Yes	—	Security profile name
`--prompts <path>`	Yes	—	Path to CSV file with prompt,expected,intent columns
`--topic <name>`	No	`unknown`	Topic name (for output labeling)
`--output <format>`	No	`pretty`	Output format: pretty or json
`--rate <n>`	No	—	Max AIRS scan API calls per second
`--concurrency <n>`	No	`5`	Concurrent scan requests

Examples

Evaluate topic against prompt set

airs-cli runtime topics eval --profile my-security-profile --prompts prompts.csv --topic "Weapons" --output json

runtime topics get

Get a custom topic by name or UUID

airs-cli runtime topics get [options] <nameOrId>

Arguments

nameOrId (required) —

Options

Flag	Required	Default	Description
`--output <format>`	No	Resolved	Output format: pretty, table, markdown, csv, json, yaml
`--revision <n>`	No	latest	Select an exact revision
`--all-versions`	No	—	Return every matching revision as a list

Examples

Pretty output (fallback pretty) — accepts topic name or UUID

airs-cli runtime topics get "Professional authority"

Prisma AIRS — Runtime Configuration
Security profile and topic management


Topic Detail:

  ID:          00000000-0000-0000-0000-000000000001
  Name:        Professional authority
  Revision:    1
  Description: Prompts where the user asks the AI to adopt the persona of a licensed expert (e.g., doctor, engineer). Responses require objective, safe information while clarifying that the AI cannot replace real-world certified professionals.
  Modified:    2026-05-21T21:23:53Z

JSON output

airs-cli runtime topics get "Professional authority" --output json

{
  "topicId": "00000000-0000-0000-0000-000000000001",
  "topicName": "Professional authority",
  "revision": 1,
  "description": "Prompts where the user asks the AI to adopt the persona of a licensed expert (e.g., doctor, engineer). Responses require objective, safe information while clarifying that the AI cannot replace real-world certified professionals.",
  "examples": [],
  "lastModifiedTs": "2026-05-21T21:23:53Z",
  "cspId": "<csp-id>",
  "tsgId": "<tenant-id>"
}

YAML output

airs-cli runtime topics get "Professional authority" --output yaml

topicId: 00000000-0000-0000-0000-000000000001
topicName: Professional authority
revision: 1
description: Prompts where the user asks the AI to adopt the persona of a licensed expert (e.g., doctor, engineer). Responses require objective, safe information while clarifying that the AI cannot replace real-world certified professionals.
lastModifiedTs: 2026-05-21T21:23:53Z

runtime topics list

List custom topics

airs-cli runtime topics list [options]

Options

Flag	Required	Default	Description
`--limit <n>`	No	`100`	Max results
`--offset <n>`	No	`0`	Starting offset
`--all`	No	—	Walk every page
`--max <n>`	No	`10000`	Safety cap for `--all`; `0` removes the cap
`--all-versions`	No	—	Include historical revisions instead of latest-only results
`--output <format>`	No	Resolved	Output format: pretty, table, markdown, csv, json, yaml

Examples

Pretty output (fallback pretty)

airs-cli runtime topics list --limit 3

Prisma AIRS — Runtime Configuration
Security profile and topic management


Custom Topics:

00000000-0000-0000-0000-000000000001
  Professional authority rev:1 — Prompts where the user asks the AI to adopt the persona of a licensed expert (e.
00000000-0000-0000-0000-000000000002
  Financial advice rev:1 — Prompts regarding investment strategies, budgeting, taxes, or market forecasting
00000000-0000-0000-0000-000000000003
  Legal advice rev:1 — Prompts seeking legal guidance, case analysis, or contract interpretation. Respo

Showing 3 of 100 topics

JSON output

airs-cli runtime topics list --limit 3 --output json

[
  {
    "id": "00000000-0000-0000-0000-000000000001",
    "name": "Professional authority",
    "revision": 1,
    "description": "Prompts where the user asks the AI to adopt the persona of a licensed expert (e.g., doctor, engineer). Responses require objective, safe information while clarifying that the AI cannot replace real-world certified professionals."
  },
  {
    "id": "00000000-0000-0000-0000-000000000002",
    "name": "Financial advice",
    "revision": 1,
    "description": "Prompts regarding investment strategies, budgeting, taxes, or market forecasting. Content must focus on financial literacy and education, explicitly stating it is not professional financial planning or investment advice"
  },
  {
    "id": "00000000-0000-0000-0000-000000000003",
    "name": "Legal advice",
    "revision": 1,
    "description": "Prompts seeking legal guidance, case analysis, or contract interpretation. Responses must provide general information only, never formal legal counsel, and always include a clear disclaimer to consult a qualified attorney"
  }
]

YAML output

airs-cli runtime topics list --limit 3 --output yaml

id: 00000000-0000-0000-0000-000000000001
name: Professional authority
revision: 1
description: Prompts where the user asks the AI to adopt the persona of a licensed expert (e.g., doctor, engineer). Responses require objective, safe information while clarifying that the AI cannot replace real-world certified professionals.
---
id: 00000000-0000-0000-0000-000000000002
name: Financial advice
revision: 1
description: Prompts regarding investment strategies, budgeting, taxes, or market forecasting. Content must focus on financial literacy and education, explicitly stating it is not professional financial planning or investment advice
---
id: 00000000-0000-0000-0000-000000000003
name: Legal advice
revision: 1
description: Prompts seeking legal guidance, case analysis, or contract interpretation. Responses must provide general information only, never formal legal counsel, and always include a clear disclaimer to consult a qualified attorney

runtime topics revert

Remove a custom topic from a profile and delete it

airs-cli runtime topics revert [options]

Options

Flag	Required	Default	Description
`--profile <name>`	Yes	—	Security profile name
`--name <name>`	Yes	—	Topic name to remove
`--output <format>`	No	`pretty`	Output format: pretty or json

Examples

Remove topic from profile

airs-cli runtime topics revert --profile my-security-profile --name "Weapons Manufacturing"

runtime topics sample

Print a sample CSV file showing the eval prompt format

airs-cli runtime topics sample [options]

Options

Flag	Required	Default	Description
`--output-file <path>`	No	—	Write to file instead of stdout

Examples

Print to stdout

airs-cli runtime topics sample

Write to file

airs-cli runtime topics sample --output-file prompts/template.csv

runtime topics update

Update a custom topic

airs-cli runtime topics update [options] <topicId>

Arguments

topicId (required) —

Options

Flag	Required	Default	Description
`--config <path>`	Yes	—	JSON file with topic updates

Examples

Update from config fixture (see docs/cli/examples/runtime/topics/update.json)

airs-cli runtime topics update 00000000-0000-0000-0000-000000000001 --config docs/cli/examples/runtime/topics/update.json

Prisma AIRS — Runtime Configuration
Security profile and topic management

Topic updated: 00000000-0000-0000-0000-000000000001


Topic Detail:

  ID:          00000000-0000-0000-0000-000000000001
  Name:        docs-example-topic
  Revision:    2
  Description: Updated description for documentation example
  Examples:
    • first updated example prompt
    • second updated example prompt
    • third updated example prompt
  Created:     user@example.com
  Updated:     none

runtime topics apply​

Options​

Examples​

runtime topics create​

Options​

Examples​

runtime topics delete​

Arguments​

Options​

Examples​

runtime topics eval​

Options​

Examples​

runtime topics get​

Arguments​

Options​

Examples​

runtime topics list​

Options​

Examples​

runtime topics revert​

Options​

Examples​

runtime topics sample​

Options​

Examples​

runtime topics update​

Arguments​

Options​

Examples​

runtime topics apply

Options

Examples

runtime topics create

Options

Examples

runtime topics delete

Arguments

Options

Examples

runtime topics eval

Options

Examples

runtime topics get

Arguments

Options

Examples

runtime topics list

Options

Examples

runtime topics revert

Options

Examples

runtime topics sample

Options

Examples

runtime topics update

Arguments

Options

Examples