محیط
متغیرهای محیطی مقادیر قابل استفادهٔ مجدد را ذخیره می‌کنند که می‌توانید در درخواست‌های بازپخش، خودکارسازی و گردش‌های کار به آن‌ها ارجاع دهید.
ایجاد و ویرایش متغیرها
- محیط را از ناوبری سمت چپ باز کنید.
- روی جدید کلیک کنید.
- نامی وارد کنید که با حرف یا زیرخط شروع شود و پس از آن حروف، اعداد، زیرخط یا خط تیره بیاید؛ حداکثر 64 نویسه.
- مقدار را وارد کنید.
- اگر مقدار حساس است، مانند کلید API، توکن یا گذرواژه، محرمانه را فعال کنید. مقادیر محرمانه در رابط پوشانده می‌شوند و از زمینهٔ هوش مصنوعی کنار گذاشته می‌شوند.
- روی ذخیره کلیک کنید.
برای ویرایش متغیر موجود، روی ردیف آن کلیک کنید و نام یا مقدار را به‌روز کنید.
استفاده از متغیرها در درخواست‌ها
با پیشوند env. به متغیر محیطی ارجاع دهید:
{{env.VARIABLE_NAME}}نمونه‌ها:
- فیلد میزبان:
{{env.TARGET_HOST}}؛ نام میزبان را ذخیره کنید، نه URL کامل. - سرآیند مجوزدهی:
Bearer {{env.AUTH_TOKEN}}. - بدنهٔ درخواست:
{"tenant": "{{env.TENANT_ID}}"}؛ برای جایگزینی داخل بدنه، قالب‌بندی متغیرهای بدنه را در بازپخش فعال کنید.
Ogma جای‌نگهدارهای معتبر محیطی را هنگام ارسال جایگزین می‌کند. متغیر مفقود خطا ایجاد می‌کند، به‌جای آنکه مقدار جایگزین‌نشده را بی‌صدا ارسال کند. ارسال‌های خام و هگز بازپخش، بایت‌های دقیق را حفظ می‌کنند و جای‌نگهدارها را گسترش نمی‌دهند.
دامنهٔ متغیر
برای مقادیر مشترک میان پروژه‌های این فضای کاری Ogma، سراسری و برای مقادیر متعلق به پروژهٔ فعال، پروژه را انتخاب کنید. مقادیر پروژه بر مقادیر سراسری هم‌نام اولویت دارند. بازپخش از جایگزینی در سطح مجموعه و نشست نیز پشتیبانی می‌کند؛ ترتیب اولویت نشست، مجموعه، پروژه و سپس سراسری است.
تبدیل‌ها و مقادیر پویا
تبدیل‌ها را با خط عمودی اضافه کنید، برای مثال {{env.AUTH_TOKEN|base64_encode}} یا {{env.SEARCH|url_encode}}. زنجیره از چپ به راست اعمال می‌شود. خروجی را با یک درخواست آزمایشی بررسی کنید: نام تبدیل‌های ناشناخته نادیده گرفته می‌شوند و به‌عنوان خطا گزارش نمی‌شوند.
مقادیر داخلی به متغیر ذخیره‌شده نیاز ندارند:
| جای‌نگهدار | مقدار |
|---|---|
{{$timestamp}} | زمان فعلی Unix بر حسب میلی‌ثانیه. |
{{$timestamp_s}} | زمان فعلی Unix بر حسب ثانیه. |
{{$uuid}} | یک UUID جدید. |
{{$random(16)}} | 16 بایت تصادفی با نمایش هگز. |
{{$date(%Y-%m-%d)}} | تاریخ فعلی UTC با استفاده از الگوی قالب تاریخ. |
مقادیر ذخیره‌شده به‌صورت بازگشتی گسترش نمی‌یابند. اگر مقدار شامل جای‌نگهدار دیگری باشد، آن متن تودرتو بدون تغییر باقی می‌ماند.
دسترسی دستیار هوش مصنوعی
دستیار هوش مصنوعی می‌تواند نام و مقدار متغیرهای غیرمحرمانه را برای فراهم کردن زمینه بخواند، وقتی از آن می‌خواهید درخواست را تحلیل کند یا طرح آزمون بنویسد. متغیرهای محرمانه هرگز در زمینهٔ هوش مصنوعی گنجانده نمی‌شوند.
کاربردهای رایج
| متغیر | مقدار نمونه |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci...؛ آن را محرمانه علامت بزنید |
TARGET_HOST | app.example.com |
API_KEY | sk-...؛ آن را محرمانه علامت بزنید |
USER_ID | 12345 |