المهارات scaffolding-openai-agents
🤖

scaffolding-openai-agents

آمن ⚡ يحتوي على سكربتات🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

Создание агентов OpenAI с помощью SDK

Создание ИИ-агентов с нуля требует понимания асинхронных паттернов, интеграции инструментов и передачи управления между агентами. Этот навык предоставляет готовые шаблоны для production-окружения, позволяя сосредоточиться на логике агентов вместо стандартного кода.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "scaffolding-openai-agents". Создайте агента, который помогает студентам изучать Python с асинхронными паттернами и инструментами функций для выполнения кода

النتيجة المتوقعة:

  • Агент настроен с именем, инструкциями и инструментами
  • Асинхронная основная функция с использованием паттерна Runner.run()
  • Декоратор инструмента функции для пользовательских операций
  • Продолжение диалога с историей сообщений
  • Обработка потоковых ответов для вывода в реальном времени

استخدام "scaffolding-openai-agents". Постройте многоагентную систему с триажным агентом, который направляет вопросы о программировании специализированным агентам

النتيجة المتوقعة:

  • Триажный агент с описаниями передачи управления
  • Специализированные агенты для концепций, отладки и упражнений
  • Автоматическая маршрутизация на основе содержимого вопроса
  • Реализация передачи управления агентом с полным переносом контекста

استخدام "scaffolding-openai-agents". Добавьте проверку ввода для предотвращения вопросов, не связанных с программированием, от обработки обучающим агентом

النتيجة المتوقعة:

  • Функция входного ограничения с проверкой ключевых слов программирования
  • GuardrailFunctionOutput с флагом tripwire_triggered
  • Агент настроен со списком input_guardrails
  • Вопросы, не связанные с программированием, заблокированы до обработки агентом

التدقيق الأمني

آمن
v5 • 1/16/2026

Pure documentation skill containing example code patterns and a simple validation script. No malicious code, no credential access, no network exfiltration, no persistence mechanisms. All static findings are false positives from the scanner misinterpreting documentation text and markdown code blocks as executable code.

3
الملفات التي تم فحصها
792
الأسطر التي تم تحليلها
3
النتائج
5
إجمالي عمليات التدقيق

عوامل الخطر

⚡ يحتوي على سكربتات (1)
scripts/verify.py:1-44
🌐 الوصول إلى الشبكة (1)
SKILL.md:213
⚙️ الأوامر الخارجية (1)
SKILL.md:16
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
20
المجتمع
100
الأمان
87
الامتثال للمواصفات

ماذا يمكنك بناءه

Создание обучающих агентов

Создавайте интеллектуальных обучающих агентов, которые объясняют концепции и помогают студентам в изучении материалов

Оркестрация специализированных агентов

Проектируйте многоагентные системы, где специализированные агенты выполняют различные задачи через маршрутизацию с передачей управления

Интеграция агентов с FastAPI

Оберните агентов OpenAI в конечные точки FastAPI для развертывания production API с поддержкой потоковой передачи

جرّب هذه الموجهات

Базовая настройка агента 
Создайте агента с использованием OpenAI Agents SDK, который отвечает на вопросы о программировании на Python. Включите асинхронное использование Runner и потоковые ответы.
Инструменты функций 
Добавьте инструменты функций к существующему агенту. Создайте инструмент просмотра погоды с использованием httpx и инструмент калькулятора, который безопасно вычисляет выражения.
Многоагентная система 
Разработайте многоагентную систему с триажным агентом, который направляет запросы к специализированным агентам. Используйте передачу управления для коммуникации агентов.
Production ограничения 
Добавьте входные и выходные ограничения к агенту. Проверьте, чтобы вопросы пользователя были связаны с программированием, и чтобы выходные данные не содержали готовых решений.

أفضل الممارسات

  • Всегда используйте паттерны async/await с Runner.run() для масштабируемого выполнения агентов
  • Маркируйте агентов четкими описаниями передачи управления для эффективной маршрутизации в многоагентных системах
  • Используйте Pydantic модели с output_type для гарантированных структурированных JSON-ответов
  • Реализуйте ограничения на раннем этапе для проверки входных данных и предотвращения нежелательных выходных данных

تجنب

  • Не используйте eval() в инструментах функций для вычисления выражений - используйте safe_eval или математические библиотеки
  • Не пропускайте проверку входных данных - всегда проверяйте содержимое пользователя перед обработкой
  • Не хардкодьте API-ключи - используйте переменные окружения для учетных данных

الأسئلة المتكررة

В чем разница между передачей управления и агентами как инструментами?
Передача управления полностью передает контроль над разговором другому агенту. Агенты как инструменты позволяют одному агенту вызывать другого как подзадачу, сохраняя контроль.
Как обрабатывать потоковые ответы в production?
Используйте Runner.run_streamed() и итерируйте через stream_events() для получения дельт в реальном времени для вашего потокового ответа FastAPI.
Отправляются ли мои данные в OpenAI при использовании этого навыка?
Да, агенты отправляют данные в OpenAI для обработки. Ознакомьтесь с политикой обработки данных OpenAI на соответствие требованиям перед развертыванием.
Могу ли я использовать это с Claude вместо моделей GPT?
Этот навык разработан для OpenAI Agents SDK. Для агентов Claude используйте специфичные для Claude фреймворки агентов или API-интеграции.
Как предотвратить дачу агентом готовых решений?
Используйте output_guardrails для сканирования ответов на наличие индикаторов решений и срабатывания ловушки при обнаружении.
Какой самый безопасный способ вычисления математических выражений в инструментах?
Используйте математическую библиотеку или ast.literal_eval для безопасного вычисления выражений. Никогда не используйте eval() с ненадежным вводом.

تفاصيل المطور

المؤلف

Asmayaseen

الترخيص

MIT

المستودع

https://github.com/Asmayaseen/hackathon-2/tree/main/.claude/skills/scaffolding-openai-agents

مرجع

main

بنية الملفات

📁 scripts/

📄 verify.py

📄 SKILL.md