Assistant
Content may include inaccuracies, outdated information, or technical errors. Users are advised to cross-check critical information before implementation.
The assistant answers questions about models and changes them. It works with the same set of operations that is available to you in the interface, and shows every call in the panel.
A question about a model
- Open the Assistant panel and leave the language switch on Chat.
- Ask the question in plain words: which components have no documentation, what this process depends on.
The open project, model and representation are passed to the assistant with every request, so there is no need to say which model is meant. The language model is chosen by the administrator of the installation.
The assistant reads what is available to you: projects, their models and metamodels, the content of the models, the representations and the layout of a diagram.
Changing a model
State the task: "add three application components and connect them to the order process". The assistant creates models, changes their content, adds representations and moves blocks on diagrams.
Batch changes are atomic: a call that deletes several objects or edits several places in a model either goes through entirely or changes nothing. The result reaches the repository immediately, so the model explorer and the open representations are updated without waiting for the end of the conversation.
If a model is created in a notation the project has not imported yet, the import is added automatically.
Checking the result
Every call appears in the panel as a collapsed entry with the name of the tool. Expand it to see the Arguments and the Result.
If the result is not what you wanted, ask the assistant to undo the change, or fix the model in the editor. To review changes before they are written, use expression mode in the same panel, see The expression console.
Permissions
The assistant acts on your behalf: every call runs under your account and obeys the same rights as an action in the interface. A refusal is visible in the result of the call.
A change also has to be valid. A patch with a feature the metamodel does not have, a wrong identifier or a value of an unsuitable type is rejected; the assistant receives the error and can correct the call, and the model is left unchanged.
External agents
The repository is available over the Model Context Protocol, so an AI agent outside Architeezy can work with the projects as well: a coding assistant, a desktop chat client or an agent of your own. Its set of tools is the same.
There are two differences. The agent gets no context of the workspace: it knows only the text of the request and what it found through the listing tools, so it looks for the project first. And it authenticates on its own, acting with the rights of the account it presents.
The address, the connection settings and the sign-in are on MCP server.