Подключите ассистента к Топазу, чтобы он находил синтаксис, проверял код и читал результаты выполнения. Ассистенту, который читает URL, передайте файл справки из раздела ниже.
Для вызова инструментов установите Топаз и выберите ассистента с поддержкой локального MCP. MCP служит протоколом для получения списка инструментов и их вызова.
Подключите инструменты
Добавьте эту команду в настройки локального сервера MCP вашего клиента.
{
"command": "topaz",
"args": ["mcp", "serve"]
}Клиент запускает установленный исполняемый файл и обменивается сообщениями через стандартный ввод и вывод. Этот способ связи называется stdio. На всех поддерживаемых нативных платформах Топаз включает сервер и рабочий процесс. Отдельно скачивать сервер или задавать путь к рабочему процессу не требуется.
После подключения в списке должны появиться topaz_spec, topaz_examples, topaz_check и topaz_run. Если клиент не запускает topaz, проверьте установку и доступный клиенту путь к исполняемому файлу.
Проверьте подключение вызовом
Вызовите инструмент с JSON из таблицы. Ожидаемые значения также приведены в блоке verification файла mcp.json.
| Инструмент | Вход | Что проверить в ответе |
|---|---|---|
topaz_spec | {"section":"The everyday working set"} | status равен found, ответ содержит запрошенный раздел справки |
topaz_examples | {"concept":"function"} | status равен found, ответ содержит примеры функций из установленной справки |
topaz_check | {"source":"function main() -> int { 42 }\n"} | status равен clean, массив diagnostics пуст |
topaz_run | {"source":"let answer = 40 + 2\nanswer\n"} | status равен completed, поле value равно "42" |
topaz_check возвращает диагностику синтаксиса, имён и типов, сохраняя коды и позиции в исходнике. Если status равен diagnostics, исправьте указанное место в переданном коде и повторите вызов. Поведение приложения также проверяйте на характерных входных данных.
topaz_run проверяет исходник перед запуском нового рабочего процесса. В ответе проверки читайте toolchain и compiler_selection. Ответ запуска содержит сведения о продукте и рабочем процессе в semantic_identity и execution_identity. По умолчанию используется self. Для сравнения эталонный компилятор Rust выбирают явно через --compiler rust. Подробности приведены в разделе Состояние инструментария.
Примените правила Agent Pack
Профиль добавляет именованные правила к проверке исходника. Чтобы применить правила Agent Pack, добавьте "profile":"agent-pack" рядом с source во входных данных topaz_check.
Ответ использует схему topaz.mcp-check-result/v2 и содержит profile: "agent-pack". Если правило профиля отклоняет код, его имя находится в поле диагностики data.profileRule. Измените указанную операцию согласно правилам профиля. Без profile ответ использует схему topaz.mcp-check-result/v1.
Учитывайте права переданного кода
Передавайте код, которому доверяете. Рабочий процесс запрещает операции хоста, но не обеспечивает изоляцию средствами операционной системы.
Каждый вызов создаёт новый рабочий процесс из установленного исполняемого файла Топаза. Код не получает доступ к файлам, сети, обнаружению хоста, обратным вызовам, загрузке компонентов или запасному пути выполнения. Вызовы не разделяют состояние выполнения. Исходник поступает через stdin, не записывается в журнал и не сохраняется.
| Лимит | Поведение |
|---|---|
| Два одновременных запуска | Дополнительные вызовы отклоняются без очереди |
| Пять секунд на запуск | Процесс завершается при превышении предела реального времени |
| Ответ размером 1 MiB | Процесс завершается при превышении размера ответа |
| Отмена вызова | Процесс завершается, сервер освобождает его ресурсы |
Сервер освобождает ресурсы завершённых процессов перед отправкой ответа. Прочитайте статус ответа, прежде чем использовать результат. Эти ограничения не задают жёсткого предела использования CPU или памяти.
Передайте справку ассистенту, который читает URL
Попросите ассистента прочитать этот файл перед написанием кода на Топазе.
https://topaz.ooo/agents.mdВ нём описаны структура файла, синтаксис, доступ к хосту и профили. Также перечислены неподдерживаемые формы, включая Vec<T>, async, try и классы. Для отсутствующих значений справка различает поддерживаемую форму T | null и использование null для любого вида отсутствия.
Другие адреса позволяют выбрать нужный объём справки.
| URL | Содержимое |
|---|---|
https://topaz.ooo/llms.txt | Краткий указатель документов |
https://topaz.ooo/llms-full.txt | Полное английское руководство в Markdown |
https://topaz.ooo/docs/<slug>.md | Одна английская страница с заголовком, исходным маршрутом и разделами спецификации в метаданных |
https://topaz.ooo/version.json | Версия, которую предоставляет сайт |
https://topaz.ooo/mcp.json | Входы инструментов, локальная команда, лимиты выполнения и проверки подключения |
Нужную форму языка ищите в Кратком обзоре синтаксиса. Для связи программы с другими системами перейдите к разделу Границы интеграции.