Skip to content

Enum: MessageContextAiRoleIdEnum

Specifies the functional role of the AI within the context of this message,

such as retrieving information, assisting reasoning, executing a tool, or

generating content.

URI: ocsf:MessageContextAiRoleIdEnum

Permissible Values

Value Meaning Description
UNKNOWN None Unknown role type
USER None The human user initiating a request
ASSISTANT None The AI model generating a response
TOOL None A callable tool or API invoked by the assistant
AGENT None A software agent that performs tasks with autonomy or delegated intent
ORCHESTRATOR None The component coordinating multiple agents or tools
RETRIEVER None A component that retrieves information or context from a knowledge source
OTHER None Other role type not covered above

Slots

Name Description
ai_role_id Specifies the functional role of the AI within the context of this message,

Identifier and Mapping Information

Schema Source

LinkML Source

name: MessageContextAiRoleIdEnum
description: 'Specifies the functional role of the AI within the context of this message,

  such as retrieving information, assisting reasoning, executing a tool, or

  generating content.'
from_schema: https://w3id.org/lmodel/ocsf
rank: 1000
permissible_values:
  UNKNOWN:
    text: UNKNOWN
    description: Unknown role type.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '0'
      caption:
        tag: caption
        value: Unknown
  USER:
    text: USER
    description: The human user initiating a request.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '1'
      caption:
        tag: caption
        value: User
  ASSISTANT:
    text: ASSISTANT
    description: The AI model generating a response.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '2'
      caption:
        tag: caption
        value: Assistant
  TOOL:
    text: TOOL
    description: A callable tool or API invoked by the assistant.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '3'
      caption:
        tag: caption
        value: Tool
  AGENT:
    text: AGENT
    description: A software agent that performs tasks with autonomy or delegated intent.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '4'
      caption:
        tag: caption
        value: Agent
  ORCHESTRATOR:
    text: ORCHESTRATOR
    description: The component coordinating multiple agents or tools.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '5'
      caption:
        tag: caption
        value: Orchestrator
  RETRIEVER:
    text: RETRIEVER
    description: 'A component that retrieves information or context from a knowledge
      source

      (e.g., vector DB, search system, or API).'
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '6'
      caption:
        tag: caption
        value: Retriever
  OTHER:
    text: OTHER
    description: Other role type not covered above.
    annotations:
      ocsf_uid:
        tag: ocsf_uid
        value: '99'
      caption:
        tag: caption
        value: Other