Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 0 additions & 56 deletions source/_generated/agents/docs/admin_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,24 +64,6 @@ Select **Add an Agent** to create a new Agent, then configure the agent settings
| **Enable Tools** | By default some tool use is enabled to allow for features such as integrations with JIRA. Disabling this allows use of models that do not support or are not very good at tool use. Some features will not work without tools. |
| **Access Control** | Set which teams, channels, and users can access this agent |

#### LLM Specific Settings

Some LLMs have additional configuration that can enable rich features, like Web Search.

##### OpenAI, OpenAI Compatible

| Setting | Description |
|---------|-------------|
| **Use Responses API** | OpenAI has introduced a new Responses API to the OpenAI API specification. This API allows for richer tool integration like reasoning, and native tool support like Web Search. |
| **Enable Web Search** | Enabling web search will allow your Agent to leverage OpenAI's (or compatible) native web search tool, enabling Agents to respond with information more recent than the model's cutoff date. Responses API must be enabled in order to configure this setting. |

##### Anthropic

| Setting | Description |
|---------|-------------|
| **Enable Web Search** | Enabling web search will allow your Agent to leverage Anthropic's native web search tool, enabling Agents to respond with information more recent than the model's cutoff date.


Select **Save** to create the agent.

### Provider configuration
Expand Down Expand Up @@ -183,44 +165,6 @@ The plugin configuration is stored in the Mattermost database. To backup:
1. Ensure your regular Mattermost backup includes plugin configurations
2. For larger deployments, consider backing up indexed vector data separately

### Configuration format

The plugin uses a service-based architecture stored in the Mattermost database at `PluginSettings.Plugins["mattermost-ai"]`:

- **Services** define LLM provider configurations (API keys, models, endpoints)
- **Bots** reference services by ID and define agent personalities and access controls

This separation allows multiple bots to share the same LLM service configuration.

**Configuration structure:**
```json
{
"config": {
"services": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"type": "openai",
"apiKey": "sk-...",
"defaultModel": "gpt-4o"
}
],
"bots": [
{
"id": "bot-001",
"name": "ai",
"displayName": "AI Assistant",
"serviceID": "550e8400-e29b-41d4-a716-446655440000",
"customInstructions": "You are a helpful assistant."
}
]
}
}
```

**Supported service types:** `openai`, `anthropic`, `azure`, `openaicompatible`, `asage`, `cohere`

**Legacy format:** Older configurations with embedded service objects within bots are automatically migrated to the current format on plugin startup.

## Troubleshooting

### Logging
Expand Down
2 changes: 1 addition & 1 deletion source/_generated/agents/docs/user_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ Contact your system admin if this feature isn't available for your Mattermost in

For AI models with vision capabilities, attach an image file to your message when chatting with an Agent to ask questions about the image or request analysis. The Agent responds based on the visual content.

Your system admin must enable vision capabilities for your bot, and the underlying AI model must support vision features.
Image analysis is a [Beta](https://docs.mattermost.com/manage/feature-labels.html#beta) feature. Your system admin must enable vision capabilities for your bot, and the underlying AI model must support vision features.

## Record calls to summarize meetings

Expand Down
2 changes: 1 addition & 1 deletion source/agents
Submodule agents updated 136 files
4 changes: 2 additions & 2 deletions source/scripts/generate-certificates/gencert.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# gencert.sh for Mattermost

.. include:: ../../_static/badges/all-commercial.md
:start-after: :nosearch:
```{include} ../../_static/badges/all-commercial.md
```

Generate a self-signed x509v3 certificate for use with multiple URLs / IPs.

Expand Down