create_assistant
Create an AI assistant persona in a workspace to customize investigation and action behavior. The short_name becomes the persona_name for workspace_chat.
Instructions
Create a new AI assistant (persona) in a workspace.
Skill: runwhen-skill://create-ai-assistant (full setup workflow).
An assistant is a persona that tailors how the RunWhen AI investigates and
acts — e.g. an "Azure DevOps Helper" focused on a specific tech stack. The
short_name you choose becomes the persona_name for workspace_chat.
After creating the assistant, shape its behavior by attaching persona-scoped rules and commands:
create_chat_rule(scope_type="persona", scope_id=short_name, ...)
create_chat_command(scope_type="persona", scope_id=short_name, ...)This is an UPSERT — calling it again with an existing short_name REPLACES
the assistant's full configuration (omitted fields reset to defaults). To
change a few fields on an existing assistant, use update_assistant.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| avatar_url | No | Optional avatar image URL (e.g. '/personas/Man1-Happy.svg'). | |
| run_config | No | Run configuration: allow/disallow/budget settings (advanced). | |
| short_name | Yes | Assistant short name (lowercase-kebab-case, e.g. 'azure-devops'). Workspace prefix optional (e.g. 'my-ws--azure-devops'). This is the value you pass as persona_name to workspace_chat. | |
| description | No | What this assistant specializes in (e.g. tech stack, team). | |
| display_name | No | Human-readable display name (e.g. 'Azure DevOps Helper'). | |
| filter_scope | No | Optional scope filter for results (advanced). | |
| search_filters | No | Vector-search filter operators (e.g. {'codebundleTaskTags': ['kubernetes'], 'slxGroup': ['my-group']}). | |
| workspace_name | Yes | The workspace to create the assistant in. | |
| filter_stop_words | No | Words stripped from search queries before matching. | |
| run_confidence_threshold | No | Confidence threshold for automatic task runs (0-1). | |
| filter_codebundle_task_tags | No | Only surface tasks tagged with these (e.g. ['azure', 'devops']). Empty/omitted means no tag filter. | |
| filter_confidence_threshold | No | Confidence threshold for filtering results (0-1). | |
| filter_issue_selection_strategy | No | Issue selection strategy (e.g. 'MOST_SEVERE'). | MOST_SEVERE |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |