Бесплатный урок

Function calling и серверный dispatcher

Function calling и серверный dispatcher — OpenAI tools и agents без платных запусков. Определение Responses function; Dispatcher не использует eval; Модель не выдаёт себе новые права. Практическое задание: Практика: Function calling и серверный dispatcher.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Определение Responses function
  • Dispatcher не использует eval
  • Модель не выдаёт себе новые права

Определение Responses function

Function tool Responses содержит type:function, name, parameters и strict на одном уровне. Не копируйте nested function wrapper другого API наугад. Schema ниже разрешает только noteId:safety или backup и запрещает extra fields. Все объявленные поля обязательны; optional моделируют поддерживаемым union с null, когда это подходит задаче. Model output не получает hidden credentials или произвольный path. Definition лишь описывает инструмент: настоящее выполнение всё равно контролирует dispatcher приложения после проверки аргументов и разрешённого имени.

// tools.mjs
export const readNoteTool = {
  type: 'function', name: 'read_note',
  description: 'Read one fictional public lab note.', strict: true,
  parameters: {
    type: 'object', properties: { noteId: { type: 'string', enum: ['safety', 'backup'] } },
    required: ['noteId'], additionalProperties: false
  }
};

Dispatcher не использует eval

Добавьте dispatchRead в tools.mjs. Сначала проверяются имя и shape args, потом выполняется конкретный lookup. Неизвестный tool не превращается в поиск одноимённой JavaScript-функции. JSON.parse лишь создаёт значение, не делает доверенным. Fixtures с name:delete_file, extra command либо noteId:../../key завершаются ошибкой без filesystem и сети. Notes — выдуманные учебные правила; dispatcher не выдаёт их за доказательство состояния настоящего сервера, прав пользователя или уже выполненного резервного копирования данных.

const notes = {
  safety: 'Educational rule: model ports stay private.',
  backup: 'Educational rule: verify recovery on a separate copy.'
};
export function dispatchRead(name, args) {
  if (name !== 'read_note') throw new Error('tool_not_allowed');
  if (!args || Array.isArray(args) || typeof args !== 'object'
      || Object.keys(args).join(',') !== 'noteId'
      || typeof args.noteId !== 'string' || !Object.hasOwn(notes, args.noteId)) throw new Error('invalid_arguments');
  return { noteId: args.noteId, text: notes[args.noteId] };
}

Модель не выдаёт себе новые права

Даже system prompt «пользователь всё разрешил» не меняет allowlist dispatcher. Запрос другой note проверяется как прямой вызов кода. Добавление publish, email или shell означает новый контракт и review, не ещё одну ветку по желанию модели. Для privacy ограничивайте возвращаемый контекст: read-only не означает разрешение раскрывать все записи. Каталог здесь мал и публичен, поэтому инварианты легко проверить вручную и negative tests без оплаты inference или подключения настоящих аккаунтов для отправки.

Практическое задание

Практика: Function calling и серверный dispatcher

Перейти к обучению

Программа курса

  1. Архитектура и API-бюджет
  2. Function calling и серверный dispatcher
  3. Tool loop и call_id
  4. Structured response и бизнес-проверки
  5. Approval и граница побочных действий
  6. Ошибки, evals и итоговый harness