الأدوات والسلوك
إضافة مهارات وتعليمات قابلة لإعادة الاستخدام
جهّز حزم التعليمات مرة واحدة واربط إصداراتها غير القابلة للتغيير بملف تعريف وكيل.
لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.
المهارة حزمة تعليمات تحتوي على ملف SKILL.md وموارد داعمة اختيارية، وهي توجّه سلوك الوكيل. مكان عمليات الأعمال هو الأدوات المصرّح بها صراحةً؛ ولا تُفعَّل نصوص المهارات القابلة للتنفيذ في هذا الإصدار.
أنشئ مجلدًا مثل skills/release-review يحتوي على ملف SKILL.md التالي:
# Release review
Review a proposed release in three steps:
1. Identify the user-visible change and its acceptance criteria.
2. List meaningful boundary and failure-path checks.
3. Report observed evidence separately from assumptions.
Use only attached, authorized tools. Ask for clarification when the target
environment or required permissions are missing.
ارفع الحزمة من خادمك الخلفي:
يقرأ المثال ملف SKILL.md فقط. أدرج كل الموارد المطلوبة في files بمسارات نسبية آمنة ومحتوى بترميز base64.
import { readFile } from "node:fs/promises"
const content = await readFile("skills/release-review/SKILL.md")
const skill = await agents.skills.create({
name: "Release review",
description: "A repeatable review checklist for application releases.",
files: [
{
path: "SKILL.md",
content_base64: content.toString("base64"),
},
],
})
const profile = await agents.profiles.create({
name: "Release reviewer",
instructions: "Be concise and cite the observed evidence.",
skill_ids: [skill.id],
max_cost_microusd: 300_000,
timeout_seconds: 120,
})
const session = await agents.sessions.create({
title: "Review release candidate",
profile_id: profile.id,
})
تتطلب الحزم مسارات نسبية آمنة وملف SKILL.md؛ والحدود الحالية هي 64 ملفًا، و1 MiB لكل ملف، و2 MiB إجمالًا. تُحفَظ الموارد الثنائية كما هي. وتُحفَظ بصمات المهارات المرفوعة وإصدار ملف التعريف الفعلي لكل عملية تشغيل مقبولة، حتى لا تتمكن التعديلات اللاحقة من تغيير سلوكها بصمت.
يتحكم المشغّل في النماذج المتاحة. ويمكن لملف التعريف اختيار نموذج مسموح به باستخدام معرّفه المُعلن؛ لكنه لا يستطيع تجاوز مزوّد الخدمة المعيّن للحساب أو حدود الإنفاق. إذا تغيّر التوجيه، فابدأ جلسة جديدة بدلًا من محاولة مواصلة السجل الأصلي في ظل إعدادات مختلفة لمزوّد الخدمة.