Skip to content

Commit 7fad8b0

Browse files
vinibrslvinibrsl
committed
[docs-freeze] docs: snapshot and changelog for v1.15.3
1 parent cbb8c98 commit 7fad8b0

1,090 files changed

Lines changed: 244030 additions & 38 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/docs.json‎

Lines changed: 2123 additions & 38 deletions
Large diffs are not rendered by default.

‎docs/edge/ar/changelog.mdx‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,40 @@ description: "تحديثات المنتج والتحسينات وإصلاحات
44
icon: "clock"
55
mode: "wide"
66
---
7+
<Update label="16 يوليو 2026">
8+
## v1.15.3
9+
10+
[عرض الإصدار على GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.15.3)
11+
12+
## ما الذي تغير
13+
14+
### الميزات
15+
- إضافة معلمة معرف المنظمة إلى عميل PlusAPI
16+
- إضافة نقاط اعتراض الخطوات وإعادة صياغة توثيق نقاط تنفيذ @on
17+
- توصيل نقاط اعتراض حدود التنفيذ
18+
- إضافة موزع اعتراض عام
19+
- تشغيل التدفقات التصريحية على واجهة المستخدم النصية (خيار الطرية بدون واجهة)
20+
21+
### إصلاحات الأخطاء
22+
- مزامنة حدث بدء التنفيذ المكتمل مع نتيجة خطاف OUTPUT
23+
- إصلاح سمات وكيل المستودع الفارغة
24+
- التأكد من أن خطافات after_llm_call لا تكسر تنفيذ الأدوات الأصلية
25+
- تجنب الإضافة المزدوجة لرد الدور عندما يقوم المعالج بقص التاريخ
26+
- جعل تخزين نتائج الأدوات اختيارياً بدلاً من أن يكون مفعلًا بشكل افتراضي
27+
- التوقف عن إعادة كتابة وصف الأداة المؤلف عند الإنشاء
28+
- كشف استخدام الرموز تحت كلا الاسمين في نتائج الوكيل والطاقم
29+
- الإبلاغ عن مقاييس الاستخدام لكل استدعاء في نتائج بدء التنفيذ
30+
- التوقف عن إعادة تشغيل نية الدور السابق عندما تعيد route_turn() قيمة غير صحيحة
31+
32+
### الوثائق
33+
- تحديث تجميع خطافات التنفيذ وتوثيق جميع سياقات الخطاف
34+
35+
## المساهمون
36+
37+
@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl
38+
39+
</Update>
40+
741
<Update label="16 يوليو 2026">
842
## v1.15.3a2
943

‎docs/edge/en/changelog.mdx‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,40 @@ description: "Product updates, improvements, and bug fixes for CrewAI"
44
icon: "clock"
55
mode: "wide"
66
---
7+
<Update label="Jul 16, 2026">
8+
## v1.15.3
9+
10+
[View release on GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.15.3)
11+
12+
## What's Changed
13+
14+
### Features
15+
- Add organization ID parameter to PlusAPI client
16+
- Add step interception points and rework execution hooks documentation around @on
17+
- Wire execution-boundary interception points
18+
- Add generic interception-hook dispatcher
19+
- Run declarative flows on the TUI (headless terminal fallback)
20+
21+
### Bug Fixes
22+
- Sync kickoff-completed event with OUTPUT hook result
23+
- Fix null repository agent attributes
24+
- Ensure after_llm_call hooks do not break native tool execution
25+
- Avoid double-append of the turn reply when a handler trims history
26+
- Make tool-result caching opt-in instead of on by default
27+
- Stop rewriting the authored tool description at construction
28+
- Expose token usage under both names on agent and crew results
29+
- Report per-call usage metrics on kickoff results
30+
- Stop replaying previous turn's intent when route_turn() returns falsy
31+
32+
### Documentation
33+
- Update execution hooks grouping and document all hook contexts
34+
35+
## Contributors
36+
37+
@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl
38+
39+
</Update>
40+
741
<Update label="Jul 16, 2026">
842
## v1.15.3a2
943

‎docs/edge/ko/changelog.mdx‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,40 @@ description: "CrewAI의 제품 업데이트, 개선 사항 및 버그 수정"
44
icon: "clock"
55
mode: "wide"
66
---
7+
<Update label="2026년 7월 16일">
8+
## v1.15.3
9+
10+
[GitHub 릴리스 보기](https://github.com/crewAIInc/crewAI/releases/tag/1.15.3)
11+
12+
## 변경 사항
13+
14+
### 기능
15+
- PlusAPI 클라이언트에 조직 ID 매개변수 추가
16+
- @on을 중심으로 단계 가로채기 포인트 및 실행 훅 문서 재작업
17+
- 실행 경계 가로채기 포인트 연결
18+
- 일반 가로채기 훅 디스패처 추가
19+
- TUI(헤드리스 터미널 대체)에서 선언적 흐름 실행
20+
21+
### 버그 수정
22+
- OUTPUT 훅 결과와 kickoff-completed 이벤트 동기화
23+
- null 리포지토리 에이전트 속성 수정
24+
- after_llm_call 훅이 네이티브 도구 실행을 방해하지 않도록 보장
25+
- 핸들러가 히스토리를 잘라낼 때 턴 응답의 중복 추가 방지
26+
- 도구 결과 캐싱을 기본값이 아닌 선택 사항으로 설정
27+
- 생성 시 작성된 도구 설명 재작성 중지
28+
- 에이전트 및 크루 결과에서 두 이름 아래의 토큰 사용량 노출
29+
- kickoff 결과에 대한 호출당 사용 메트릭 보고
30+
- route_turn()이 falsy를 반환할 때 이전 턴의 의도를 재생하지 않도록 중지
31+
32+
### 문서화
33+
- 실행 훅 그룹화 업데이트 및 모든 훅 컨텍스트 문서화
34+
35+
## 기여자
36+
37+
@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl
38+
39+
</Update>
40+
741
<Update label="2026년 7월 16일">
842
## v1.15.3a2
943

‎docs/edge/pt-BR/changelog.mdx‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,40 @@ description: "Atualizações de produto, melhorias e correções do CrewAI"
44
icon: "clock"
55
mode: "wide"
66
---
7+
<Update label="16 jul 2026">
8+
## v1.15.3
9+
10+
[Ver release no GitHub](https://github.com/crewAIInc/crewAI/releases/tag/1.15.3)
11+
12+
## O que Mudou
13+
14+
### Funcionalidades
15+
- Adicionar parâmetro de ID da organização ao cliente PlusAPI
16+
- Adicionar pontos de interceptação de etapas e reformular a documentação dos hooks de execução em torno de @on
17+
- Conectar pontos de interceptação de limite de execução
18+
- Adicionar despachador de hook de interceptação genérico
19+
- Executar fluxos declarativos na TUI (fallback de terminal sem interface gráfica)
20+
21+
### Correções de Bugs
22+
- Sincronizar evento de kickoff-completed com o resultado do hook OUTPUT
23+
- Corrigir atributos de agente de repositório nulos
24+
- Garantir que os hooks after_llm_call não quebrem a execução de ferramentas nativas
25+
- Evitar duplicação da resposta da rodada quando um manipulador corta o histórico
26+
- Tornar o cache de resultados de ferramentas opcional em vez de ativado por padrão
27+
- Parar de reescrever a descrição da ferramenta criada na construção
28+
- Expor o uso de tokens sob ambos os nomes nos resultados de agente e equipe
29+
- Relatar métricas de uso por chamada nos resultados de kickoff
30+
- Parar de reproduzir a intenção da rodada anterior quando route_turn() retorna um valor falso
31+
32+
### Documentação
33+
- Atualizar o agrupamento de hooks de execução e documentar todos os contextos de hooks
34+
35+
## Contribuidores
36+
37+
@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl
38+
39+
</Update>
40+
741
<Update label="16 jul 2026">
842
## v1.15.3a2
943

‎docs/v1.15.3/ar/api-reference/inputs.mdx‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: "GET /inputs"
3+
description: "الحصول على المدخلات المطلوبة لطاقمك"
4+
openapi: "/v1.15.3/enterprise-api.en.yaml GET /inputs"
5+
mode: "wide"
6+
---
7+
8+

‎docs/v1.15.3/ar/api-reference/introduction.mdx‎

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
---
2+
title: "مقدمة"
3+
description: "المرجع الكامل لواجهة برمجة تطبيقات CrewAI AMP REST"
4+
icon: "code"
5+
mode: "wide"
6+
---
7+
8+
# واجهة برمجة تطبيقات CrewAI AMP
9+
10+
مرحبًا بك في مرجع واجهة برمجة تطبيقات CrewAI AMP. تتيح لك هذه الواجهة التفاعل برمجيًا مع الأطقم المنشورة، مما يمكّنك من دمجها مع تطبيقاتك وسير عملك وخدماتك.
11+
12+
## البدء السريع
13+
14+
<Steps>
15+
<Step title="الحصول على بيانات اعتماد API">
16+
انتقل إلى صفحة تفاصيل طاقمك في لوحة تحكم CrewAI AMP وانسخ رمز Bearer من علامة تبويب الحالة.
17+
</Step>
18+
19+
<Step title="اكتشاف المدخلات المطلوبة">
20+
استخدم نقطة النهاية `GET /inputs` لمعرفة المعاملات التي يتوقعها طاقمك.
21+
</Step>
22+
23+
<Step title="بدء تنفيذ الطاقم">
24+
استدعِ `POST /kickoff` مع مدخلاتك لبدء تنفيذ الطاقم واستلام
25+
`kickoff_id`.
26+
</Step>
27+
28+
<Step title="مراقبة التقدم">
29+
استخدم `GET /status/{kickoff_id}` للتحقق من حالة التنفيذ واسترجاع النتائج.
30+
</Step>
31+
</Steps>
32+
33+
## المصادقة
34+
35+
تتطلب جميع طلبات API المصادقة باستخدام رمز Bearer. أدرج رمزك في ترويسة `Authorization`:
36+
37+
```bash
38+
curl -H "Authorization: Bearer YOUR_CREW_TOKEN" \
39+
https://your-crew-url.crewai.com/inputs
40+
```
41+
42+
### أنواع الرموز
43+
44+
| نوع الرمز | النطاق | حالة الاستخدام |
45+
| :-------------------- | :------------------------ | :----------------------------------------------------------- |
46+
| **Bearer Token** | وصول على مستوى المؤسسة | عمليات الطاقم الكاملة، مثالي للتكامل بين الخوادم |
47+
| **User Bearer Token** | وصول محدد بالمستخدم | صلاحيات محدودة، مناسب للعمليات الخاصة بالمستخدم |
48+
49+
<Tip>
50+
يمكنك العثور على كلا نوعي الرموز في علامة تبويب الحالة من صفحة تفاصيل طاقمك في
51+
لوحة تحكم CrewAI AMP.
52+
</Tip>
53+
54+
## عنوان URL الأساسي
55+
56+
لكل طاقم منشور نقطة نهاية API فريدة خاصة به:
57+
58+
```
59+
https://your-crew-name.crewai.com
60+
```
61+
62+
استبدل `your-crew-name` بعنوان URL الفعلي لطاقمك من لوحة التحكم.
63+
64+
## سير العمل النموذجي
65+
66+
1. **الاكتشاف**: استدعِ `GET /inputs` لفهم ما يحتاجه طاقمك
67+
2. **التنفيذ**: أرسل المدخلات عبر `POST /kickoff` لبدء المعالجة
68+
3. **المراقبة**: استعلم عن `GET /status/{kickoff_id}` حتى الاكتمال
69+
4. **النتائج**: استخرج المخرجات النهائية من الاستجابة المكتملة
70+
71+
## معالجة الأخطاء
72+
73+
تستخدم الواجهة أكواد حالة HTTP القياسية:
74+
75+
| الكود | المعنى |
76+
| ----- | :----------------------------------------- |
77+
| `200` | نجاح |
78+
| `400` | طلب غير صالح - تنسيق مدخلات غير صحيح |
79+
| `401` | غير مصرّح - رمز bearer غير صالح |
80+
| `404` | غير موجود - المورد غير موجود |
81+
| `422` | خطأ في التحقق - مدخلات مطلوبة مفقودة |
82+
| `500` | خطأ في الخادم - تواصل مع الدعم |
83+
84+
## الاختبار التفاعلي
85+
86+
<Info>
87+
**لماذا لا يوجد زر "إرسال"؟** نظرًا لأن كل مستخدم CrewAI AMP لديه عنوان URL
88+
فريد للطاقم، نستخدم **وضع المرجع** بدلاً من بيئة تفاعلية لتجنب
89+
الالتباس. يوضح لك هذا بالضبط كيف يجب أن تبدو الطلبات بدون
90+
أزرار إرسال غير فعالة.
91+
</Info>
92+
93+
تعرض لك كل صفحة نقطة نهاية:
94+
95+
- **تنسيق الطلب الدقيق** مع جميع المعاملات
96+
- **أمثلة الاستجابة** لحالات النجاح والخطأ
97+
- **عينات الكود** بلغات متعددة (cURL، Python، JavaScript، إلخ)
98+
- **أمثلة المصادقة** بتنسيق رمز Bearer الصحيح
99+
100+
### **لاختبار واجهتك الفعلية:**
101+
102+
<CardGroup cols={2}>
103+
<Card title="نسخ أمثلة cURL" icon="terminal">
104+
انسخ أمثلة cURL واستبدل العنوان URL + الرمز بقيمك الحقيقية
105+
</Card>
106+
<Card title="استخدام Postman/Insomnia" icon="play">
107+
استورد الأمثلة في أداة اختبار API المفضلة لديك
108+
</Card>
109+
</CardGroup>
110+
111+
**مثال على سير العمل:**
112+
113+
1. **انسخ مثال cURL هذا** من أي صفحة نقطة نهاية
114+
2. **استبدل `your-actual-crew-name.crewai.com`** بعنوان URL الحقيقي لطاقمك
115+
3. **استبدل رمز Bearer** برمزك الحقيقي من لوحة التحكم
116+
4. **نفّذ الطلب** في طرفيتك أو عميل API
117+
118+
## هل تحتاج مساعدة؟
119+
120+
<CardGroup cols={2}>
121+
<Card
122+
title="دعم المؤسسات"
123+
icon="headset"
124+
href="mailto:support@crewai.com"
125+
>
126+
احصل على مساعدة في تكامل API واستكشاف الأخطاء وإصلاحها
127+
</Card>
128+
<Card
129+
title="لوحة تحكم المؤسسات"
130+
icon="chart-line"
131+
href="https://app.crewai.com"
132+
>
133+
إدارة أطقمك وعرض سجلات التنفيذ
134+
</Card>
135+
</CardGroup>

‎docs/v1.15.3/ar/api-reference/kickoff.mdx‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: "POST /kickoff"
3+
description: "بدء تنفيذ الطاقم"
4+
openapi: "/v1.15.3/enterprise-api.en.yaml POST /kickoff"
5+
mode: "wide"
6+
---
7+
8+

‎docs/v1.15.3/ar/api-reference/resume.mdx‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: "POST /resume"
3+
description: "استئناف تنفيذ الطاقم مع التغذية الراجعة البشرية"
4+
openapi: "/v1.15.3/enterprise-api.en.yaml POST /resume"
5+
mode: "wide"
6+
---

‎docs/v1.15.3/ar/api-reference/status.mdx‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: "GET /status/{kickoff_id}"
3+
description: "الحصول على حالة التنفيذ"
4+
openapi: "/v1.15.3/enterprise-api.en.yaml GET /status/{kickoff_id}"
5+
mode: "wide"
6+
---

0 commit comments

Comments
 (0)