# البدء السريع

أرسل أول استدعاء عبر بوابة Azoth، واحتفظ بإيصاله، وجِد قراره المختوم — في نحو خمس دقائق، ودون تغيير موجّهاتك.

> تحتاج إلى مساحة عمل في Azoth ومفتاح مزوّد محفوظ في **الإعدادات › المزوّدون والنماذج**. وتتطلب أمثلة SDK الإصدار 18 من Node.js أو أحدث.

[أنشئ حسابًا مجانيًا →](https://www.azothos.ai/auth/signup)

### 1. أنشئ مفتاح API

في **الإعدادات › الوصول**، أنشئ مفتاح API وانسخه إلى `AZOTH_API_KEY`: فهو يُعرض مرة واحدة فقط. تحصل مساحات العمل المجانية على مفاتيح `az_test_…`، والخطط المدفوعة على مفاتيح `az_live_…`.

### 2. أرسل استدعاءً عبر البوابة

تتحدث البوابة بصيغة المحادثة الخاصة بـ OpenAI على `/api/v1/chat/completions`. ويطبع الخيار `-D -` ترويسات الاستجابة، حيث يرد الإيصال.

```
curl -sS -D - https://www.azothos.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $AZOTH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{ "role": "user", "content": "Say hello in one word." }]
  }'

# HTTP/2 200
# x-azoth-receipt: eyJhbGciOiJFZERTQSIs…
# x-azoth-provider: openai
# x-azoth-model: gpt-4o-mini
# x-azoth-cost-usd: 0.00000330
```

### 3. أو وجّه عميل OpenAI لديك إلى Azoth

غيّر عنوان URL الأساسي والمفتاح — ولا شيء آخر في شيفرتك. تضيف الدالة `azothGatewayHeaders` من `@azothos/sdk` ترويسات Azoth الاختيارية، وترفض أي قيمة كانت البوابة سترفضها. ويعيد `.withResponse()` أيضًا ترويسات الاستجابة، حيث يرد الإيصال.

```
import OpenAI from 'openai';
import { azothGatewayHeaders } from '@azothos/sdk';

const openai = new OpenAI({
  baseURL: 'https://www.azothos.ai/api/v1',
  apiKey: process.env.AZOTH_API_KEY,
  defaultHeaders: azothGatewayHeaders({ usecaseId: process.env.AZOTH_USECASE_ID }),
});

const { data, response } = await openai.chat.completions
  .create({
    model: 'gpt-4o-mini',
    messages: [{ role: 'user', content: 'Say hello in one word.' }],
  })
  .withResponse();

console.log(data.choices[0].message.content);
console.log(response.headers.get('x-azoth-receipt'));
```

### 4. أو من Python

تعمل الحزمة `openai` بالطريقة نفسها: غيّر `base_url` والمفتاح. ويحتفظ `with_raw_response` بترويسات الاستجابة، حيث يرد الإيصال.

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.azothos.ai/api/v1",
    api_key=os.environ["AZOTH_API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Say hello in one word."}],
)
print(raw.parse().choices[0].message.content)
print(raw.headers.get("x-azoth-receipt"))
```

### 5. احتفظ بالإيصال

تحمل كل إجابة غير متدفقة، مخدومة كانت أو محظورة، إيصالًا موقّعًا في `X-Azoth-Receipt` — وفي `azoth.receipt` ضمن جسم JSON للإجابة المخدومة. يسمّي الإيصال القرار دون أي محتوى: احتفظ به مع سجلاتك. أما الإجابة المتدفقة فتحمل `X-Azoth-Trace-Id` بدلًا منه: يُختم قرارها عند انتهاء التدفق.

### 6. جِد القرار

في **الإثباتات › القرارات** يظهر الاستدعاء مع نتيجته وقواعده وقانونه. ويفتح زر **تحقّق بنفسك** أداة التحقق دون اتصال: الصق الإيصال، ثم اختر الملف.

## كيف يعمل

يمرّ الاستدعاء عبر البوابة بهذه الخطوات، بهذا الترتيب:

1. يُفحص المفتاح والجسم. ويحصل النظام المتاح للجمهور أولًا على مستوى حمايته من استنزاف التكاليف ([الأنظمة العامة](https://www.azothos.ai/ar/docs/rules#exhaustion)).
2. يُربط الاستدعاء بتفويضه: الترويسة `X-Azoth-Usecase`، وإلا فالوكيل أو الموصّل أو المفتاح المرتبط به، وإلا فالتفويض الافتراضي لمساحة العمل.
3. تُطبَّق القواعد: الإيقاف الطارئ، وحالة التفويض، والميزانيات، والسيادة، وقواعد السياسات، والقانون المطبَّق، والموافقة البشرية.
4. يجيب النموذج، لدى المزوّد الذي تسمح به القواعد. أما التوجيه والذاكرة المؤقتة فإثراءات تعمل ضمن هذه القواعد.
5. يُختم القرار في سجل مساحة العمل المتسلسل بالتجزئة — بما في ذلك حالات الرفض — وتخرج الإجابة مع إيصالها.

## أوضاع الحوكمة

تتبع صرامةُ التعامل مع استدعاء دون تفويض معتمد وضعَ الحوكمة: الأشدّ بين وضع النشر (`GOVERNANCE_PROFILE`) والوضع الذي اختارته مساحة العمل في **الإعدادات › المؤسسة** — يمكن لمساحة العمل تشديده، لا تخفيفه أبدًا ([وضع الحوكمة](https://www.azothos.ai/ar/docs/admin#governance-mode)). الوضع `observe`، وهو الافتراضي، يختم ويخدم؛ والوضع `govern` ينبّه أيضًا؛ والوضع `enforce` يرفض. ويُرفض التفويض المتوقف، والنظام المصنّف ممارسةً محظورة، في كل الأوضاع.

## التالي

- [صرّح بمن هو مسؤول عن كل استخدام](https://www.azothos.ai/ar/docs/mandates)
- [اكتب القواعد التي تطبّقها البوابة](https://www.azothos.ai/ar/docs/rules)
- [اقرأ السجل والإيصالات](https://www.azothos.ai/ar/docs/proof)
- [استخدم SDK وواجهة REST API](https://www.azothos.ai/ar/docs/sdk)
