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 навмання. Схема нижче дозволяє лише noteId:safety або backup і забороняє додаткові поля. Усі заявлені поля потрібні; optional можна моделювати підтримуваним union із null, коли це відповідає задачі. Model output не має отримати приховані credentials або довільний path. Definition тільки описує доступний інструмент: реальне виконання still контролює 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 не видає їх за доказ реального стану сервера, права користувача або завершеного backup.
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
Перейти до навчання