Comm Profiles

Communication styles.

2 actions. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

`comm_profiles.list`

GET

List agent comm profiles (per-channel personas).

AI tool: comm_profiles_list
API: GET /api/invoke/comm_profiles.list

Input

Field	Type	Required	Description
`actorId`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "actorId": {
      "type": "string",
      "minLength": 1
    }
  }
}

`comm_profiles.upsert`

POST · mutating

Create or update an agent's comm profile for a channel-kind (slack, discord, internal, …).

AI tool: comm_profiles_upsert
API: POST /api/invoke/comm_profiles.upsert

Input

Field	Type	Required
`actorId`	string	yes
`name`	string	yes
`appliesTo`	string	—
`persona`	string	—
`voice`	object	—
`ttsConfig`	union	—
`allowedChannels`	string[]	—
`autonomyOverride`	union	—
`active`	boolean	—
`id`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "actorId": {
      "type": "string",
      "minLength": 1
    },
    "name": {
      "type": "string"
    },
    "appliesTo": {
      "default": "*",
      "type": "string"
    },
    "persona": {
      "default": "",
      "type": "string"
    },
    "voice": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "ttsConfig": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "allowedChannels": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "autonomyOverride": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "supervised",
            "semi-autonomous",
            "fully-autonomous"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "active": {
      "default": true,
      "type": "boolean"
    },
    "id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "actorId",
    "name"
  ]
}