پاسخ ایجنت در قالب ثابت

کاربرد

برنامهٔ ثبت سفارش کیان پاسخی می‌خواهد که هر بار به یک شکل خوانده شود، نه یک پاراگراف متن آزاد. پاسخ نهایی ایجنت را ملزم کنید از یک قالب پاسخ ساختاریافته پیروی کند تا برنامه‌های دیگر بتوانند به شکل آن تکیه کنند.

پیش از شروع

ایجنت سفارشی باید متعلق به فضای کاری فعلی شما باشد، مجوز مدیریت ایجنت‌ها را داشته باشید و قالب پاسخ ساختاریافتهٔ موردنظر را بدانید. مدل انتخاب‌شده باید از پاسخ ساختاریافته پشتیبانی کند.

مراحل

1. «ایجنت‌ها» را باز کنید، ایجنت خود را در «ایجنت‌های من» پیدا و انتخاب کنید. در پنجره‌ای که باز می‌شود «اقدامات ایجنت» (سه نقطه) و بعد «ویرایش ایجنت» را بزنید.
2. «خروجی ساختاریافته» را باز و روشن کنید. تا وقتی خاموش است فیلدها قابل ویرایش نیستند.
3. در «جزئیات قالب»، «نام طرح‌واره» (با یک حرف انگلیسی شروع شود و بعد از آن حرف انگلیسی، رقم، زیرخط یا خط تیره بیاید؛ تا ۶۴ کاراکتر) و «توضیح طرح‌واره» (تا ۵۰۰ کاراکتر) را وارد کنید.
4. در «قالب پاسخ»، «طرح‌واره‌ی JSON» را ویرایش کنید. ریشه باید یک شیء باشد که فهرست ویژگی‌ها را دارد و هر ویژگی به نوعی نیاز دارد: شیء، آرایه، رشته، عدد، عدد صحیح، بولی یا تهی. نام‌های فهرست الزامی‌ها باید در فهرست ویژگی‌ها تعریف شده باشند، آرایه‌ها به تعریف عناصر نیاز دارند و فهرست مقدارهای مجاز نباید خالی باشد.
5. پیام زیر ویرایشگر را بخوانید. یا معتبر بودن طرح‌واره را تأیید می‌کند (سرور هنگام ذخیره دوباره آن را بررسی می‌کند) یا مشکل را توضیح می‌دهد. خطاهای نحوی ممکن است سطر و ستون را نشان دهند و خطاهای طرح‌واره، شرط یا فیلد نامعتبر را. «قالب‌بندی JSON» طرح‌وارهٔ معتبر را مرتب می‌کند و برای طرح‌وارهٔ نامعتبر کاری نمی‌کند.
6. «ذخیره» را بزنید.

نتیجهٔ مورد انتظار

پاسخ نهایی ایجنت از طرح‌واره پیروی می‌کند. طرح‌واره ابزار تازه‌ای به ایجنت نمی‌دهد.

رفع مشکل