К содержимому
Блог

DSML Function Calls: что делать с разметкой в ответе DeepSeek

DSML Function Calls: что делать с разметкой в ответе DeepSeek

Если DeepSeek вернул DSML Function Calls текстом, сначала проверьте choices[0].message.tool_calls в исходном JSON. Строка в content сама по себе не разрешает вызвать функцию. Сохраните форму ответа, сравните её с объектом SDK и повторите запрос с одним инструментом. Ниже пример для deepseek-v4-pro через Relay и порядок проверки аргументов без исполнения произвольных команд.

Что означает DSML Function Calls

В переводе function calls означает «вызовы функций». В запросе «DSML Function Calls перевод» обычно ищут объяснение служебной разметки, которая оказалась в ответе вместо обычного текста или объекта инструмента. По одному фрагменту нельзя установить, на каком участке он появился: у модели, при обработке ответа или при его отображении.

Для приложения на Chat Completions ориентиром служит контракт API: структурированные вызовы находятся в tool_calls, текст в content. Имя функции и строка аргументов входят в объект вызова. Руководство DeepSeek по инструментам также отделяет предложение модели от функции, которую реализует ваше приложение.

Не стройте исполняемый протокол поверх текста DSML. Модель может процитировать разметку из документа или объяснить её на примере. Поиск имени функции регулярным выражением превратит такую цитату в действие.

Как получить минимальный ответ с одним инструментом

Выберите модель в каталоге DeepSeek. Сначала отключите потоковый режим: полный JSON проще сравнить с объектом SDK. Используйте тестовый номер заказа и ключ отдельного приложения. Значение ниже вымышленное; перед запросом замените его своим ключом.

bash
export RELAY_API_KEY="sk-demo-not-a-real-key"
curl -sS -D response-headers.txt \
  https://relay-llm.ru/v1/chat/completions \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role":"user","content":"Узнай статус заказа TEST-1"}],
    "tools": [{
      "type":"function",
      "function":{
        "name":"get_order_status",
        "description":"Возвращает статус тестового заказа",
        "parameters":{
          "type":"object",
          "properties":{"order_id":{"type":"string"}},
          "required":["order_id"],
          "additionalProperties":false
        }
      }
    }]
  }' -o response.json

Откройте response.json локально. Если есть error, сначала разберите HTTP-ошибку. Если пришёл успешный ответ, найдите choices, затем message, content и tool_calls. Само описание инструмента не гарантирует его вызов: модель вправе ответить текстом. Проверьте также, не завершился ли ответ из-за ограничения длины.

Файл заголовков ответа нужен для x-request-id. Не включайте curl -v для пересылки лога: там можно случайно раскрыть заголовок авторизации. Для поддержки достаточно времени, ID модели, HTTP-статуса и идентификатора запроса.

Как проверить аргументы до выполнения функции

Следующий фрагмент читает сохранённый JSON. Он принимает ровно одну разрешённую функцию, один аргумент и конкретный тестовый заказ. Код ничего не запрашивает в рабочей системе.

python
import json
from pathlib import Path

reply = json.loads(Path("response.json").read_text(encoding="utf-8"))
message = reply["choices"][0]["message"]
calls = message.get("tool_calls") or []
if not calls:
    print("Вызовов инструментов нет; content остаётся текстом")
for call in calls:
    if call.get("type") != "function":
        raise ValueError("Неизвестный тип вызова")
    function = call["function"]
    if function["name"] != "get_order_status":
        raise ValueError("Функция не разрешена")
    args = json.loads(function["arguments"])
    if not isinstance(args, dict) or set(args) != {"order_id"}:
        raise ValueError("Неверный набор аргументов")
    if args["order_id"] != "TEST-1":
        raise ValueError("Разрешён только тестовый заказ")
    print("Проверка пройдена:", call["id"])

В рабочем приложении вместо сравнения с TEST-1 нужна проверка доступа пользователя к заказу. Даже корректный JSON не подтверждает такое право. Если затем отправляете результат функции модели, используйте role: "tool" и соответствующий tool_call_id; не собирайте ответ строковой склейкой с пользовательским вводом.

Где искать потерю структуры

Сравните три представления: сетевой JSON, объект SDK и значение, которое отображает интерфейс. Если в JSON есть tool_calls, а интерфейс показывает только текст, проверьте адаптер отображения. Если SDK возвращает строку вместо объекта, найдите сериализацию до бизнес-кода. Если разметка уже в content исходного ответа, сохраните этот случай и проверьте совместимость модели и протокола.

При потоковом ответе аргументы могут приходить фрагментами. Не разбирайте каждый фрагмент как законченный JSON. Сначала соберите вызов целиком по правилам SDK, затем проверьте схему. Воспроизводится только в потоке? Сравните с тем же запросом без stream и изучите документацию стриминга.

Не называйте вероятную причину установленной. Текст DSML не доказывает ни сбой Relay, ни ошибку клиента. Укажите в обращении, в каком именно поле и на каком этапе он найден.

Как проверить исправление без платных запросов

Подайте в обработчик сохранённые обезличенные ответы: обычный текст, корректный вызов, неизвестное имя функции, неверный тип аргумента и текст с имитацией DSML. Действие допускается только во втором случае и после проверки прав. Для остальных обработчик должен вернуть текст или ошибку без побочного эффекта.

Добавьте ограничение числа инструментальных шагов: иначе модель и приложение могут повторять запрос бесконечно. Повтор не исправляет ошибку JSON-парсера. Сначала выясните, нарушена схема ответа или логика вашего обработчика.

DSML Function Calls нужно переводить в команды приложения?

Нет. Для действий используйте структурированный tool_calls выбранного протокола, разрешённые имена функций и проверенные аргументы. Текстовую разметку оставьте текстом.

Что делать, если tool_calls пуст?

Проверьте content и причину завершения ответа. Наличие tools в запросе не обязывает модель вызвать функцию; не восстанавливайте вызов из произвольного текста.

Можно ли отправить полный response.json в поддержку?

Сначала удалите текст пользователя, персональные сведения и секреты. Обычно хватает структуры полей, статуса, модели и x-request-id.

Создать аккаунт для проверки DeepSeek API

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.