# Seguridad

Microsoft se toma muy en serio la seguridad de nuestros productos y servicios de software, lo que incluye todos los repositorios de código fuente gestionados a través de nuestras organizaciones en GitHub, que incluyen [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) y [Xamarin](https://github.com/xamarin).

Si crees que has encontrado una vulnerabilidad de seguridad en algún repositorio propiedad de Microsoft que cumpla con la [definición de vulnerabilidad de seguridad de Microsoft](https://aka.ms/security.md/definition), infórmanos como se describe a continuación.

## Informar problemas de seguridad

**Por favor, no informes vulnerabilidades de seguridad a través de issues públicos en GitHub.**

En su lugar, repórtalas al Microsoft Security Response Center (MSRC) en [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).

Si prefieres enviar tu informe sin iniciar sesión, envía un correo electrónico a [secure@microsoft.com](mailto:secure@microsoft.com). Si es posible, cifra tu mensaje con nuestra clave PGP; puedes descargarla desde la [página de claves PGP del Microsoft Security Response Center](https://aka.ms/security.md/msrc/pgp).

Deberías recibir una respuesta en un plazo de 24 horas. Si por alguna razón no la recibes, haz un seguimiento por correo electrónico para asegurarte de que recibimos tu mensaje original. Puedes encontrar información adicional en [microsoft.com/msrc](https://www.microsoft.com/msrc).

Incluye la información solicitada que se detalla a continuación (tanto como puedas proporcionar) para ayudarnos a entender mejor la naturaleza y el alcance del posible problema:

* Tipo de problema (por ejemplo, desbordamiento de búfer, inyección SQL, scripting entre sitios, etc.)
* Rutas completas de los archivos fuente relacionados con la manifestación del problema
* Ubicación del código fuente afectado (tag/branch/commit o URL directa)
* Cualquier configuración especial requerida para reproducir el problema
* Instrucciones paso a paso para reproducir el problema
* Código de prueba de concepto o de explotación (si es posible)
* Impacto del problema, incluyendo cómo un atacante podría explotarlo

Esta información nos ayudará a priorizar tu informe más rápidamente.

Si estás informando como parte de un programa de recompensas por errores, los informes más completos pueden contribuir a una mayor recompensa. Visita nuestra página del [Programa de Recompensas por Errores de Microsoft](https://aka.ms/security.md/msrc/bounty) para más detalles sobre nuestros programas activos.

## Idiomas preferidos

Preferimos que todas las comunicaciones se realicen en inglés.

## Política

Microsoft sigue el principio de [Divulgación Coordinada de Vulnerabilidades](https://aka.ms/security.md/cvd).

**Descargo de responsabilidad**:
Este documento ha sido traducido utilizando servicios de traducción automática basados en inteligencia artificial. Si bien nos esforzamos por garantizar la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o imprecisiones. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional realizada por humanos. No nos hacemos responsables de malentendidos o interpretaciones erróneas que puedan surgir del uso de esta traducción.


# TODO: El responsable de este repositorio aún no ha editado este archivo

**PROPIETARIO DEL REPOSITORIO**: ¿Deseas soporte de Customer Service & Support (CSS) para este producto/proyecto?

- **Sin soporte CSS:** Completa esta plantilla con información sobre cómo reportar problemas y obtener ayuda.
- **Con soporte CSS:** Llena un formulario de ingreso en [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS trabajará contigo para determinar los próximos pasos.
- **¿No estás seguro?** Llena el formulario como si la respuesta fuera "Sí". CSS te ayudará a decidir.

*Luego elimina este primer encabezado de este archivo SUPPORT.MD antes de publicar tu repositorio.*

## Soporte

## Cómo reportar problemas y obtener ayuda

Este proyecto utiliza GitHub Issues para rastrear errores y solicitudes de características. Por favor, busca en los problemas existentes antes de reportar nuevos problemas para evitar duplicados. Para nuevos problemas, reporta tu error o solicitud de característica como un nuevo Issue.

Para obtener ayuda y hacer preguntas sobre el uso de este proyecto, por favor **RESPONSABLE DEL REPOSITORIO: INSERTA INSTRUCCIONES AQUÍ
SOBRE CÓMO CONTACTAR A LOS RESPONSABLES DEL REPOSITORIO O A LA COMUNIDAD PARA OBTENER AYUDA. PODRÍA SER UNA ETIQUETA EN STACK OVERFLOW U OTRO
CANAL. ¿DÓNDE AYUDARÁS A LAS PERSONAS?**.

## Política de soporte de Microsoft

El soporte para este **PROYECTO o PRODUCTO** se limita a los recursos mencionados anteriormente.

**Descargo de responsabilidad**:
Este documento ha sido traducido utilizando servicios de traducción automática basados en inteligencia artificial. Si bien nos esforzamos por lograr precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional realizada por humanos. No nos hacemos responsables de malentendidos o interpretaciones erróneas que puedan surgir del uso de esta traducción.

10 Lessons to Get Started Building AI Agents


# Code de Conduite Open Source de Microsoft

Ce projet a adopté le [Code de Conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/).

Ressources :

- [Code de Conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/)
- [FAQ sur le Code de Conduite de Microsoft](https://opensource.microsoft.com/codeofconduct/faq/)
- Contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou préoccupation

**Avertissement** :
Ce document a été traduit à l'aide de services de traduction automatique basés sur l'intelligence artificielle. Bien que nous nous efforcions d'assurer l'exactitude, veuillez noter que les traductions automatisées peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d'origine doit être considéré comme la source faisant autorité. Pour des informations critiques, il est recommandé de faire appel à une traduction humaine professionnelle. Nous déclinons toute responsabilité en cas de malentendus ou d'interprétations erronées résultant de l'utilisation de cette traduction.


# Agents IA pour Débutants - Un Cours

![IA Générative pour Débutants](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.fr.png?WT.mc_id=academic-105485-koreyst)

## 10 Leçons pour apprendre tout ce qu'il faut savoir pour commencer à créer des Agents IA

[![Licence GitHub](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![Contributeurs GitHub](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![Problèmes GitHub](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![Pull-requests GitHub](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Bienvenus](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![Observateurs GitHub](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![Forks GitHub](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![Étoiles GitHub](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 Support Multilingue

| Langue               | Code | Lien vers le README traduit                           | Dernière mise à jour |
|----------------------|------|------------------------------------------------------|-----------------------|
| Chinois (Simplifié)  | zh   | [Traduction en Chinois](../zh/README.md)  | 2025-02-13           |
| Chinois (Traditionnel)| tw   | [Traduction en Chinois](../tw/README.md)  | 2025-02-13           |
| Français             | fr   | [Traduction en Français](./README.md) | 2025-02-13           |
| Japonais             | ja   | [Traduction en Japonais](../ja/README.md) | 2025-02-13           |
| Coréen               | ko   | [Traduction en Coréen](../ko/README.md)   | 2025-02-13           |
| Espagnol             | es   | [Traduction en Espagnol](../es/README.md) | 2025-02-13           |

> **Remarque :**
> Ces traductions ont été générées automatiquement à l'aide de l'outil open-source [co-op-translator](https://github.com/Azure/co-op-translator) et peuvent contenir des erreurs ou des imprécisions. Pour des informations critiques, veuillez vous référer au texte original ou consulter une traduction humaine professionnelle. Si vous souhaitez contribuer ou mettre à jour une traduction, rendez-vous sur le dépôt, où vous pouvez facilement apporter des modifications grâce à des commandes simples.

## 🌱 Pour Commencer

Ce cours comprend 10 leçons qui couvrent les bases de la création d'Agents IA. Chaque leçon aborde un sujet spécifique, alors commencez où vous voulez !

Si c'est la première fois que vous travaillez avec des modèles d'IA Générative, consultez notre cours [IA Générative pour Débutants](https://aka.ms/genai-beginners), qui propose 21 leçons sur la création avec GenAI.

### Pour exécuter le code de ce cours

Ce cours inclut des exemples de code dans chaque leçon qui contient un `code_samples` dossier. Ce code utilise ces services pour les modèles :

- [Modèles Github](https://aka.ms/ai-agents-beginners/github-models) - Gratuit / Limité
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - Compte Azure requis

Ce cours utilise également ces frameworks et services pour Agents IA :

- [Service d'Agents Azure AI](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

Pour plus d'informations sur l'exécution du code de ce cours, rendez-vous sur la page [Configuration du Cours](./00-course-setup/README.md).

N'oubliez pas de [mettre une étoile (🌟) à ce dépôt](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) et de [forker ce dépôt](https://github.com/microsoft/ai-agents-for-beginners/fork) pour exécuter le code.

## 🙏 Vous voulez aider ?

Vous avez des suggestions ou avez trouvé des fautes d'orthographe ou des erreurs dans le code ? [Signalez un problème](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) ou [Créez une pull request](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)

Si vous êtes bloqué ou avez des questions sur la création d'Agents IA, rejoignez notre [Discord Communauté Azure AI](https://discord.gg/kzRShWzttr).

## 📂 Chaque leçon comprend

- Une leçon écrite dans le README (vidéos disponibles en mars 2025)
- Des exemples de code Python prenant en charge Azure AI Foundry et les modèles Github (Gratuit)
- Des liens vers des ressources supplémentaires pour continuer votre apprentissage

## 🗃 Leçons

| **Leçon**                            | **Lien**                                   | **Apprentissage Supplémentaire** |
|---------------------------------------|--------------------------------------------|-----------------------------------|
| Introduction aux Agents IA et Cas d'Utilisation | [Introduction aux Agents IA et Cas d'Utilisation](./01-intro-to-ai-agents/README.md) | En savoir plus                   |
| Explorer les cadres agentiques         | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | En savoir plus     |
| Comprendre les modèles de conception agentiques | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | En savoir plus     |
| Modèle de conception pour l'utilisation d'outils | [Tool Use Design Pattern](./04-tool-use/README.md)                    | En savoir plus     |
| Agentic RAG                            | [Agentic RAG](./05-agentic-rag/README.md)                 | En savoir plus     |
| Construire des agents IA de confiance  | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | En savoir plus     |
| Modèle de conception pour la planification | [Planning Design Pattern](./07-planning-design/README.md)             | En savoir plus     |
| Modèle de conception multi-agents      | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | En savoir plus     |
| Modèle de conception pour la métacognition | [Metacognition Design Pattern](./09-metacognition/README.md)               | En savoir plus     |
| Agents IA en production                | [AI Agents in Production](./10-ai-agents-production/README.md)        | En savoir plus     |

## 🎒 Autres cours

Notre équipe propose d'autres cours ! Découvrez :

- [Generative AI for Beginners](https://aka.ms/genai-beginners)
- [ML for Beginners](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Data Science for Beginners](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [AI for Beginners](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## Contribution

Ce projet accueille volontiers les contributions et suggestions. La plupart des contributions nécessitent que vous acceptiez un
Contributor License Agreement (CLA) déclarant que vous avez le droit, et que vous accordez effectivement, les droits pour que nous utilisions votre contribution. Pour plus de détails, visitez <https://cla.opensource.microsoft.com>.

Lorsque vous soumettez une pull request, un bot CLA déterminera automatiquement si vous devez fournir un CLA et annotera la PR en conséquence (par exemple, vérification de statut, commentaire). Suivez simplement les instructions fournies par le bot. Vous n'aurez à faire cela qu'une seule fois pour tous les dépôts utilisant notre CLA.

Ce projet a adopté le [Code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/).
Pour plus d'informations, consultez la [FAQ sur le Code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou
contactez [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou commentaire supplémentaire.

## Marques déposées

Ce projet peut contenir des marques ou des logos pour des projets, produits ou services. L'utilisation autorisée des marques ou logos Microsoft est soumise aux
[Directives sur les marques et logos de Microsoft](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general).
L'utilisation des marques ou logos Microsoft dans des versions modifiées de ce projet ne doit pas prêter à confusion ou impliquer un parrainage par Microsoft.
Toute utilisation de marques ou logos de tiers est soumise aux politiques de ces tiers.

**Avertissement** :
Ce document a été traduit à l'aide de services de traduction automatique basés sur l'intelligence artificielle. Bien que nous nous efforcions d'assurer l'exactitude, veuillez noter que les traductions automatisées peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d'origine doit être considéré comme la source faisant autorité. Pour des informations critiques, il est recommandé de faire appel à une traduction humaine professionnelle. Nous déclinons toute responsabilité en cas de malentendus ou d'interprétations erronées résultant de l'utilisation de cette traduction.


# Sécurité

Microsoft prend très au sérieux la sécurité de ses produits et services logiciels, y compris tous les dépôts de code source gérés via nos organisations GitHub, qui incluent [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) et [Xamarin](https://github.com/xamarin).

Si vous pensez avoir identifié une vulnérabilité de sécurité dans un dépôt appartenant à Microsoft et répondant à [la définition d'une vulnérabilité de sécurité de Microsoft](https://aka.ms/security.md/definition), veuillez nous en informer comme décrit ci-dessous.

## Signaler des problèmes de sécurité

**Veuillez ne pas signaler de vulnérabilités de sécurité via les tickets publics sur GitHub.**

Au lieu de cela, veuillez les signaler au Microsoft Security Response Center (MSRC) à l'adresse suivante : [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).

Si vous préférez soumettre votre rapport sans vous connecter, envoyez un e-mail à [secure@microsoft.com](mailto:secure@microsoft.com). Si possible, chiffrez votre message avec notre clé PGP ; vous pouvez la télécharger depuis la page [Microsoft Security Response Center PGP Key](https://aka.ms/security.md/msrc/pgp).

Vous devriez recevoir une réponse dans un délai de 24 heures. Si, pour une raison quelconque, vous ne recevez pas de réponse, veuillez effectuer un suivi par e-mail pour vous assurer que nous avons bien reçu votre message initial. Des informations supplémentaires sont disponibles sur [microsoft.com/msrc](https://www.microsoft.com/msrc).

Veuillez inclure les informations demandées ci-dessous (autant que possible) pour nous aider à mieux comprendre la nature et l'étendue du problème potentiel :

* Type de problème (par exemple, débordement de tampon, injection SQL, cross-site scripting, etc.)
* Chemins complets des fichiers source liés à la manifestation du problème
* Emplacement du code source affecté (tag/branche/commit ou URL directe)
* Toute configuration spéciale requise pour reproduire le problème
* Instructions détaillées pour reproduire le problème
* Code de preuve de concept ou d'exploitation (si possible)
* Impact du problème, y compris la manière dont un attaquant pourrait exploiter la vulnérabilité

Ces informations nous aideront à prioriser votre rapport plus rapidement.

Si vous signalez dans le cadre d'un programme de récompense pour bugs, des rapports plus détaillés peuvent contribuer à une récompense plus élevée. Veuillez visiter notre page [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) pour plus de détails sur nos programmes actifs.

## Langues préférées

Nous préférons que toutes les communications soient rédigées en anglais.

## Politique

Microsoft adhère au principe de la [Divulgation Coordonnée des Vulnérabilités](https://aka.ms/security.md/cvd).
```

**Avertissement** :
Ce document a été traduit à l'aide de services de traduction automatique basés sur l'intelligence artificielle. Bien que nous nous efforcions d'assurer l'exactitude, veuillez noter que les traductions automatisées peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d'origine doit être considéré comme la source faisant autorité. Pour des informations critiques, il est recommandé de recourir à une traduction humaine professionnelle. Nous déclinons toute responsabilité en cas de malentendus ou d'interprétations erronées découlant de l'utilisation de cette traduction.


# TODO : Le responsable de ce dépôt n'a pas encore modifié ce fichier

**PROPRIÉTAIRE DU DÉPÔT** : Souhaitez-vous un support du service client et assistance (CSS) pour ce produit/projet ?

- **Pas de support CSS :** Complétez ce modèle avec des informations sur la manière de signaler des problèmes et d'obtenir de l'aide.
- **Support CSS activé :** Remplissez un formulaire d'intégration sur [aka.ms/onboardsupport](https://aka.ms/onboardsupport). Le CSS collaborera avec vous pour déterminer les prochaines étapes.
- **Pas sûr ?** Remplissez un formulaire d'intégration comme si la réponse était "Oui". Le CSS vous aidera à décider.

*Ensuite, supprimez ce premier titre de ce fichier SUPPORT.MD avant de publier votre dépôt.*

## Support

## Comment signaler des problèmes et obtenir de l'aide

Ce projet utilise GitHub Issues pour suivre les bugs et les demandes de fonctionnalités. Veuillez rechercher les problèmes existants avant d'en créer de nouveaux afin d'éviter les doublons. Pour signaler un nouveau problème, soumettez votre bug ou demande de fonctionnalité en tant que nouvel "Issue".

Pour toute aide ou question concernant l'utilisation de ce projet, veuillez **RESPONSABLE DU DÉPÔT : INSÉREZ ICI LES INSTRUCTIONS POUR CONTACTER LES PROPRIÉTAIRES DU DÉPÔT OU LA COMMUNAUTÉ POUR OBTENIR DE L'AIDE. CELA POURRAIT ÊTRE UN TAG STACK OVERFLOW OU UN AUTRE CANAL. COMMENT AIDEREZ-VOUS LES UTILISATEURS ?**.

## Politique de support Microsoft

Le support pour ce **PROJET ou PRODUIT** se limite aux ressources listées ci-dessus.

**Avertissement** :
Ce document a été traduit à l'aide de services de traduction automatique basés sur l'intelligence artificielle. Bien que nous nous efforcions d'assurer l'exactitude, veuillez noter que les traductions automatiques peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue d'origine doit être considéré comme la source faisant autorité. Pour des informations critiques, il est recommandé de recourir à une traduction humaine professionnelle. Nous déclinons toute responsabilité en cas de malentendus ou d'interprétations erronées résultant de l'utilisation de cette traduction.


# Microsoft 開源行為守則

此項目採用了 [Microsoft 開源行為守則](https://opensource.microsoft.com/codeofconduct/)。

相關資源：

- [Microsoft 開源行為守則](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft 行為守則常見問題](https://opensource.microsoft.com/codeofconduct/faq/)
- 如有疑問或關注，請聯繫 [opencode@microsoft.com](mailto:opencode@microsoft.com)

**免責聲明**:
本文件已使用機器翻譯服務進行翻譯。我們致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文文件為權威來源。對於關鍵資訊，建議尋求專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或錯誤解釋概不負責。


# 初學者 AI Agents 課程

![Generative AI For Beginners](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.hk.png?WT.mc_id=academic-105485-koreyst)

## 10 個課堂，教你從零開始建立 AI Agents 所需的一切

[![GitHub license](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 多語言支援

| 語言                 | 代碼 | 翻譯後的 README 連結                                   | 最後更新日期 |
|----------------------|------|---------------------------------------------------------|--------------|
| 簡體中文            | zh   | [中文翻譯](../zh/README.md)                | 2025-02-13   |
| 繁體中文            | tw   | [中文翻譯](../tw/README.md)                | 2025-02-13   |
| 香港繁體中文        | hk   | [中文翻譯](../hk/README.md)                | 2025-02-13   |
| 法語                | fr   | [法語翻譯](../fr/README.md)                | 2025-02-13   |
| 日語                | ja   | [日語翻譯](../ja/README.md)                | 2025-02-13   |
| 韓語                | ko   | [韓語翻譯](../ko/README.md)                | 2025-02-13   |
| 葡萄牙語            | pt   | [葡萄牙語翻譯](../pt/README.md)            | 2025-02-13   |
| 西班牙語            | es   | [西班牙語翻譯](../es/README.md)            | 2025-02-13   |

## 🌱 快速開始

呢個課程有 10 個課堂，覆蓋建立 AI Agents 嘅基本知識。每個課堂都有自己嘅主題，所以你可以由你鍾意嘅地方開始學！

如果你係第一次接觸生成式 AI 模型，建議先睇下我哋嘅 [Generative AI For Beginners](https://aka.ms/genai-beginners) 課程，呢個課程有 21 個課堂教你點樣使用 GenAI。

### 點樣執行呢個課程嘅程式碼

呢個課程每個課堂都有 `code_samples` 資料夾內嘅程式碼範例。呢啲程式碼會用到以下模型服務：

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - 免費 / 有限制
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需要 Azure 帳戶

另外，課程會用到以下 AI Agent 框架同服務：

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

想了解更多點樣執行呢個課程嘅程式碼，可以睇下 [Course Setup](./00-course-setup/README.md)。

記得幫呢個 repo [加星 (🌟)](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) 同 [fork](https://github.com/microsoft/ai-agents-for-beginners/fork) 嚟執行程式碼。

## 🙏 想幫手？

如果你有建議，或者發現拼寫或者程式碼錯誤，可以 [提交問題](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) 或者 [建立 pull request](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)。

如果你有問題或者唔知點樣建立 AI Agents，可以加入我哋嘅 [Azure AI Community Discord](https://discord.gg/kzRShWzttr) 問問題。

## 📂 每個課堂包含

- 一個寫喺 README 入面嘅課堂內容（影片將於 2025 年 3 月推出）
- 支援 Azure AI Foundry 同 Github Models 嘅 Python 程式碼範例（免費）
- 連結到額外學習資源，幫助你進一步學習

## 🗃 課堂內容

| **課堂**                              | **連結**                                   | **額外學習**       |
|----------------------------------------|--------------------------------------------|--------------------|
| AI Agents 同應用案例簡介               | [Intro to AI Agents and Use Cases](./01-intro-to-ai-agents/README.md)          | Learn More         |
| 探索 Agentic 框架                     | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | Learn More         |
| 理解 Agentic 設計模式                 | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | Learn More         |
| 工具使用設計模式                     | [Tool Use Design Pattern](./04-tool-use/README.md)                    | Learn More         |
| Agentic RAG                          | [Agentic RAG](./05-agentic-rag/README.md)                 | Learn More         |
| 建立值得信任嘅 AI Agents               | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | Learn More         |
| 計劃設計模式                         | [Planning Design Pattern](./07-planning-design/README.md)             | Learn More         |
| 多 Agent 設計模式                    | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | Learn More         |
| 元認知設計模式           | [Metacognition Design Pattern](./09-metacognition/README.md)               | 了解更多         |
| 生產中的 AI 代理         | [AI Agents in Production](./10-ai-agents-production/README.md)        | 了解更多         |

## 🎒 其他課程

我哋嘅團隊仲有製作其他課程！睇吓呢啲：

- [Generative AI for Beginners](https://aka.ms/genai-beginners)
- [ML for Beginners](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Data Science for Beginners](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [AI for Beginners](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## 貢獻

呢個項目歡迎任何貢獻同建議。大部分嘅貢獻需要你同意一份貢獻者許可協議 (Contributor License Agreement, CLA)，聲明你有權授權並且確實授權我哋使用你嘅貢獻。詳情請睇 <https://cla.opensource.microsoft.com>。

當你提交一個 pull request 嘅時候，一個 CLA bot 會自動判斷你需唔需要提供 CLA，並會適當地標註 PR（例如：狀態檢查、留言）。只需要跟住 bot 提供嘅指示操作即可。你只需要喺所有使用我哋 CLA 嘅 repo 中做一次呢個步驟。

呢個項目採用了 [Microsoft 開源行為準則](https://opensource.microsoft.com/codeofconduct/)。更多資訊可以參考 [行為準則 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)，或者聯絡 [opencode@microsoft.com](mailto:opencode@microsoft.com) 提出其他問題或者意見。

## 商標

呢個項目可能包含項目、產品或者服務嘅商標或者標誌。使用 Microsoft 商標或者標誌必須遵守並符合 [Microsoft 商標及品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。喺修改版本嘅項目中使用 Microsoft 商標或者標誌唔可以引起混淆或者暗示係 Microsoft 嘅贊助。任何使用第三方商標或者標誌嘅行為需要遵守第三方嘅政策。

**免責聲明**:
本文件是使用機器翻譯人工智能服務翻譯的。我們雖然致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文語言的文件作為權威來源。對於關鍵資訊，建議尋求專業人工翻譯。我們對於使用本翻譯而引起的任何誤解或誤譯概不負責。


# 保安

Microsoft 非常重視我們軟件產品和服務的安全性，這包括通過我們的 GitHub 組織管理的所有源代碼庫，例如 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。

如果你認為你發現了任何 Microsoft 擁有的代碼庫中存在的安全漏洞，並且該漏洞符合 [Microsoft 對安全漏洞的定義](https://aka.ms/security.md/definition)，請按照以下描述向我們報告。

## 報告安全問題

**請不要通過公開的 GitHub 問題報告安全漏洞。**

相反，請通過 Microsoft Security Response Center (MSRC) 報告，網址為 [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report)。

如果你更願意在未登錄的情況下提交，請發送電子郵件至 [secure@microsoft.com](mailto:secure@microsoft.com)。如有可能，請使用我們的 PGP 密鑰加密你的信息；可以從 [Microsoft Security Response Center PGP Key 頁面](https://aka.ms/security.md/msrc/pgp) 下載。

你應該會在 24 小時內收到回覆。如果出於某些原因未收到，請通過電子郵件跟進，以確保我們收到了你的原始消息。更多資訊可以在 [microsoft.com/msrc](https://www.microsoft.com/msrc) 找到。

請包括以下列出的信息（提供越多越好），以幫助我們更好地理解可能問題的性質和範圍：

* 問題類型（例如，緩衝區溢出、SQL 注入、跨站腳本攻擊等）
* 與問題表現相關的源文件完整路徑
* 受影響源代碼的位置（標籤/分支/提交或直接 URL）
* 重現問題所需的任何特殊配置
* 重現問題的逐步操作說明
* 概念驗證或漏洞利用代碼（如果可能）
* 問題的影響，包括攻擊者可能如何利用該問題

這些信息將幫助我們更快速地處理你的報告。

如果你是為了參與漏洞賞金計劃進行報告，更完整的報告可能有助於獲得更高的賞金獎勵。請訪問我們的 [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) 頁面，了解更多有關我們現行計劃的詳情。

## 首選語言

我們更希望所有的通信以英文進行。

## 政策

Microsoft 遵循 [協調漏洞披露](https://aka.ms/security.md/cvd) 的原則。

**免責聲明**:
本文件經由機器人工智能翻譯服務進行翻譯。我們致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文文件作為權威來源。對於關鍵資訊，建議尋求專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或誤讀概不負責。


# TODO: 此 Repo 的維護者尚未編輯此文件

**REPO 擁有者**：你希望為此產品/項目提供客戶服務與支持 (CSS) 嗎？

- **不需要 CSS 支持**：請填寫此模板，提供有關如何提交問題和獲取幫助的信息。
- **需要 CSS 支持**：請填寫 [aka.ms/onboardsupport](https://aka.ms/onboardsupport) 上的申請表。CSS 會與你合作/幫助你確定下一步操作。
- **不確定？** 請按照「需要」的情況填寫申請表。CSS 會幫助你做出決定。

*然後在發布你的 Repo 之前，從這個 SUPPORT.MD 文件中刪除此第一個標題。*

## 支持

## 如何提交問題與獲取幫助

此項目使用 GitHub Issues 來跟蹤漏洞和功能請求。在提交新問題之前，請先搜索現有的問題以避免重複。對於新問題，請將你的漏洞或功能請求作為新 Issue 提交。

如果需要幫助或對使用此項目有疑問，請 **REPO 維護者：在這裡插入與 Repo 擁有者或社區互動以獲得幫助的說明。可以是一個 Stack Overflow 標籤或其他渠道。你會在哪裡幫助人們？**。

## Microsoft 支持政策

對於此 **項目或產品** 的支持僅限於上述列出的資源。

**免責聲明**:
本文件是使用機器翻譯人工智能服務進行翻譯的。我們努力確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文作為權威來源。對於關鍵資訊，建議使用專業人工翻譯。我們對於因使用此翻譯而引起的任何誤解或誤讀概不負責。


# Microsoft オープンソース行動規範

このプロジェクトは、[Microsoft オープンソース行動規範](https://opensource.microsoft.com/codeofconduct/) を採用しています。

リソース:

- [Microsoft オープンソース行動規範](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft 行動規範 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
- 質問や懸念がある場合は、[opencode@microsoft.com](mailto:opencode@microsoft.com) にお問い合わせください
```

**免責事項**:
この文書は、AI翻訳サービスを使用して機械翻訳されたものです。正確性を追求しておりますが、自動翻訳には誤りや不正確さが含まれる可能性があることをご承知おきください。原文（原言語の文書）が公式な情報源として優先されるべきです。重要な情報については、専門の人間による翻訳をお勧めします。本翻訳の使用により生じた誤解や誤認について、当方は一切の責任を負いかねます。


# 初心者向け AI エージェント - コース

![Generative AI For Beginners](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.ja.png?WT.mc_id=academic-105485-koreyst)

## AIエージェントを作成するために必要なすべてを学べる10のレッスン

[![GitHub license](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 多言語対応

| 言語                  | コード | 翻訳されたREADMEへのリンク                              | 最終更新日 |
|-----------------------|--------|---------------------------------------------------------|------------|
| 中国語（簡体字）       | zh     | [Chinese Translation](../zh/README.md)      | 2025-02-13 |
| 中国語（繁体字）       | tw     | [Chinese Translation](../tw/README.md)      | 2025-02-13 |
| フランス語            | fr     | [French Translation](../fr/README.md)       | 2025-02-13 |
| 日本語                | ja     | [Japanese Translation](./README.md)     | 2025-02-13 |
| 韓国語                | ko     | [Korean Translation](../ko/README.md)       | 2025-02-13 |
| スペイン語            | es     | [Spanish Translation](../es/README.md)      | 2025-02-13 |

> **Note:**
> これらの翻訳は、オープンソースの[co-op-translator](https://github.com/Azure/co-op-translator)を使用して自動生成されています。そのため、誤りや不正確な箇所が含まれている可能性があります。重要な情報については、元のテキストを参照するか、専門の人間翻訳を依頼してください。翻訳の貢献や更新を希望される場合は、リポジトリをご覧いただき、簡単なコマンドで貢献できます。

## 🌱 始めるには

このコースでは、AIエージェント構築の基礎を学ぶための10のレッスンを提供しています。それぞれのレッスンは独立したトピックを扱っているので、好きなところから始めてください！

初めて生成AIモデルを使用する場合は、21のレッスンで構成された[Generative AI For Beginners](https://aka.ms/genai-beginners)コースをチェックしてください。

### コースのコードを実行するには

このコースには、各レッスンに`code_samples`フォルダが含まれるコード例があります。このコードでは以下のモデルサービスを使用します：

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - 無料 / 制限あり
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - Azureアカウントが必要

また、このコースでは以下のAIエージェントフレームワークとサービスを使用します：

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

コースのコードを実行する方法についての詳細は、[Course Setup](./00-course-setup/README.md)をご覧ください。

リポジトリを[スター (🌟)](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst)したり、[フォーク](https://github.com/microsoft/ai-agents-for-beginners/fork)してコードを実行することをお忘れなく。

## 🙏 貢献したいですか？

提案がある、またはスペルミスやコードのエラーを見つけた場合は、[問題を報告する](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst)か、[プルリクエストを作成する](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)ことでお知らせください。

AIエージェントの構築で行き詰まったり質問がある場合は、[Azure AI Community Discord](https://discord.gg/kzRShWzttr)に参加してください。

## 📂 各レッスンには以下が含まれます

- READMEに記載されたレッスン内容（ビデオは2025年3月公開予定）
- Azure AI FoundryとGithub Models（無料）をサポートするPythonコードサンプル
- 学習を継続するための追加リソースへのリンク

## 🗃 レッスン一覧

| **レッスン**                            | **リンク**                                   | **追加学習**       |
|----------------------------------------|--------------------------------------------|--------------------|
| AIエージェントとユースケースの紹介      | [Intro to AI Agents and Use Cases](./01-intro-to-ai-agents/README.md)          | Learn More         |
| エージェントフレームワークの探求           | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | 詳しく見る         |
| エージェントデザインパターンの理解          | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | 詳しく見る         |
| ツール使用デザインパターン                | [Tool Use Design Pattern](./04-tool-use/README.md)                    | 詳しく見る         |
| エージェントRAG                            | [Agentic RAG](./05-agentic-rag/README.md)                 | 詳しく見る         |
| 信頼できるAIエージェントの構築             | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | 詳しく見る         |
| プランニングデザインパターン              | [Planning Design Pattern](./07-planning-design/README.md)             | 詳しく見る         |
| マルチエージェントデザインパターン         | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | 詳しく見る         |
| メタ認知デザインパターン                  | [Metacognition Design Pattern](./09-metacognition/README.md)               | 詳しく見る         |
| 本番環境でのAIエージェント                | [AI Agents in Production](./10-ai-agents-production/README.md)        | 詳しく見る         |

## 🎒 その他のコース

私たちのチームでは他にもコースを提供しています！ぜひチェックしてください：

- [Generative AI for Beginners](https://aka.ms/genai-beginners)
- [ML for Beginners](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Data Science for Beginners](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [AI for Beginners](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## コントリビューション

このプロジェクトでは、貢献や提案を歓迎しています。ほとんどの貢献には、Contributor License Agreement (CLA) に同意する必要があります。CLAに同意することで、あなたがその貢献を行う権利を有し、またその貢献を当方が使用する権利を付与することを宣言します。詳細については、<https://cla.opensource.microsoft.com> をご覧ください。

プルリクエストを送信すると、CLAボットが自動的にCLAの提供が必要かどうかを判断し、PRに適切なステータス（例：ステータスチェック、コメント）を付けます。ボットの指示に従うだけでOKです。CLAは、当方のCLAを使用しているすべてのリポジトリで一度だけ提供すれば済みます。

このプロジェクトでは、[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) を採用しています。詳細については、[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) をご覧いただくか、追加の質問やコメントがある場合は [opencode@microsoft.com](mailto:opencode@microsoft.com) にご連絡ください。

## 商標について

このプロジェクトには、プロジェクト、製品、またはサービスに関連する商標やロゴが含まれている場合があります。Microsoftの商標やロゴの使用は、[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general) に従う必要があります。また、Microsoft商標やロゴを改変したバージョンで使用する場合、混乱を引き起こしたりMicrosoftのスポンサーシップを示唆するような使用をしてはいけません。第三者の商標やロゴの使用については、それぞれの第三者のポリシーに従う必要があります。

**免責事項**:
本書類は、機械ベースのAI翻訳サービスを使用して翻訳されています。正確性を追求しておりますが、自動翻訳には誤りや不正確な部分が含まれる可能性があることをご承知おきください。元の言語で記載された原本を信頼できる情報源としてご参照ください。重要な情報については、専門の人間による翻訳をお勧めします。本翻訳の使用に起因する誤解や誤認について、当社は一切の責任を負いかねます。


# セキュリティ

Microsoft は、ソフトウェア製品やサービスのセキュリティを非常に重要視しています。これには、[Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet)、および [Xamarin](https://github.com/xamarin) を含む、GitHub 組織を通じて管理されているすべてのソースコードリポジトリが含まれます。

もし、[Microsoft のセキュリティ脆弱性の定義](https://aka.ms/security.md/definition) に該当するセキュリティ脆弱性を Microsoft が所有するリポジトリで発見した場合は、以下に記載された方法で報告してください。

## セキュリティ問題の報告

**セキュリティ脆弱性を公開 GitHub Issue を通じて報告しないでください。**

代わりに、Microsoft Security Response Center (MSRC) に [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report) から報告してください。

ログインせずに報告したい場合は、[secure@microsoft.com](mailto:secure@microsoft.com) にメールを送信してください。可能であれば、メッセージを PGP キーで暗号化してください。PGP キーは [Microsoft Security Response Center PGP Key ページ](https://aka.ms/security.md/msrc/pgp) からダウンロードできます。

通常、24 時間以内に応答を受け取ることができます。万が一応答がない場合は、元のメッセージが届いているか確認するため、メールで再度ご連絡ください。追加情報については [microsoft.com/msrc](https://www.microsoft.com/msrc) をご覧ください。

以下にリストされた情報を可能な限り提供してください。これにより、問題の性質や範囲をよりよく理解することができます：

* 問題の種類（例: バッファオーバーフロー、SQL インジェクション、クロスサイトスクリプティングなど）
* 問題が発生しているソースファイルの完全なパス
* 影響を受けるソースコードの場所（タグ/ブランチ/コミット、または直接の URL）
* 問題を再現するために必要な特別な設定
* 問題を再現するための手順
* PoC（概念実証）やエクスプロイトコード（可能であれば）
* 問題の影響範囲（攻撃者がどのように問題を悪用する可能性があるかを含む）

これらの情報を提供していただくことで、報告内容の優先順位付けを迅速に行うことができます。

バグバウンティプログラムで報告する場合、詳細なレポートを提出することで、より高い報酬を得られる可能性があります。詳細については、[Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) ページをご覧ください。

## 推奨言語

すべてのやり取りは英語で行うことを推奨します。

## ポリシー

Microsoft は、[Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd) の原則に従っています。

**免責事項**:
この文書は、機械ベースのAI翻訳サービスを使用して翻訳されています。正確性を追求しておりますが、自動翻訳にはエラーや不正確な部分が含まれる場合があります。元の言語で記載された原文を正式な情報源としてお考えください。重要な情報については、専門の人間による翻訳を推奨します。この翻訳の使用により生じた誤解や誤解釈について、当方は一切の責任を負いかねます。


# TODO: このリポジトリの管理者はまだこのファイルを編集していません

**リポジトリ管理者**: このプロダクト/プロジェクトに対してカスタマーサービス＆サポート（CSS）のサポートを希望しますか？

- **CSSサポートなし:** 問題の報告方法やヘルプを得る方法についての情報をこのテンプレートに記入してください。
- **CSSサポートあり:** [aka.ms/onboardsupport](https://aka.ms/onboardsupport) でインテークフォームに記入してください。CSSが次のステップを一緒に検討し、サポートします。
- **よくわからない場合:** 回答が「はい」であるかのようにインテークフォームに記入してください。CSSが判断を手伝います。

*その後、このSUPPORT.MDファイルからこの最初の見出しを削除してからリポジトリを公開してください。*

## サポート

## 問題の報告方法とヘルプの取得方法

このプロジェクトでは、GitHub Issues を使用してバグや機能リクエストを追跡しています。重複を避けるために、新しい問題を報告する前に既存の問題を検索してください。新しい問題については、新しい Issue としてバグや機能リクエストを報告してください。

このプロジェクトの使用方法に関するヘルプや質問については、**リポジトリ管理者: このプロジェクトのオーナーまたはコミュニティにヘルプを依頼する方法をここに記載してください。Stack Overflow のタグやその他のチャンネルが含まれるかもしれません。どこで人々をサポートしますか？**。

## Microsoft サポートポリシー

この **プロジェクトまたは製品** に対するサポートは、上記に記載されているリソースに限定されています。

**免責事項**:
本書類は、機械翻訳AIサービスを使用して翻訳されています。正確性を追求しておりますが、自動翻訳には誤りや不正確な表現が含まれる可能性があります。本書類の原文を信頼できる情報源と見なしてください。重要な情報については、専門の人間による翻訳を推奨します。本翻訳の利用により生じた誤解や誤解釈について、当方は一切の責任を負いかねます。


# Microsoft 오픈 소스 행동 강령

이 프로젝트는 [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/)을 채택했습니다.

리소스:

- [Microsoft 오픈 소스 행동 강령](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft 행동 강령 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
- 질문이나 우려 사항이 있으시면 [opencode@microsoft.com](mailto:opencode@microsoft.com)으로 연락하세요.

**면책 조항**:
이 문서는 AI 기반 기계 번역 서비스를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원문이 작성된 언어의 문서를 신뢰할 수 있는 권위 있는 자료로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생할 수 있는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.


# 초보자를 위한 AI 에이전트 - 강의

![Generative AI For Beginners](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.ko.png?WT.mc_id=academic-105485-koreyst)

## 🌐 다국어 지원

| 언어                  | 코드 | 번역된 README 링크                                      | 마지막 업데이트 |
|----------------------|------|---------------------------------------------------------|-----------------|
| 중국어 (간체)        | zh   | [Chinese Translation](../zh/README.md)      | 2025-02-13      |
| 중국어 (번체)        | tw   | [Chinese Translation](../tw/README.md)      | 2025-02-13      |
| 프랑스어             | fr   | [French Translation](../fr/README.md)       | 2025-02-13      |
| 일본어               | ja   | [Japanese Translation](../ja/README.md)     | 2025-02-13      |
| 한국어               | ko   | [Korean Translation](./README.md)       | 2025-02-13      |
| 스페인어             | es   | [Spanish Translation](../es/README.md)      | 2025-02-13      |

> **참고:**
> 이 번역은 오픈 소스 [co-op-translator](https://github.com/Azure/co-op-translator)를 사용하여 자동 생성되었으며, 오류나 부정확성이 포함될 수 있습니다.
> 중요한 정보의 경우 원본 텍스트를 참고하거나 전문 번역가의 도움을 받는 것을 권장합니다.
> 번역을 추가하거나 수정하고 싶다면, 해당 저장소를 방문하여 간단한 명령어로 기여할 수 있습니다.

## AI 에이전트를 구축하기 위해 알아야 할 모든 것을 가르치는 10개의 강의

[![GitHub license](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌱 시작하기

이 강의는 AI 에이전트를 구축하는 기본 개념을 다루는 10개의 강의로 구성되어 있습니다. 각 강의는 독립적인 주제를 다루므로 원하는 곳부터 시작할 수 있습니다!

Generative AI 모델을 처음 접하는 경우, 21개의 강의로 구성된 [Generative AI For Beginners](https://aka.ms/genai-beginners) 강의를 먼저 확인해 보세요.

### 이 강의의 코드를 실행하려면

이 강의의 각 강의에는 `code_samples` 폴더가 포함된 코드 예제가 있습니다. 이 코드는 다음 서비스를 사용하여 모델을 실행합니다:

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - 무료 / 제한적
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - Azure 계정 필요

또한 이 강의에서는 다음 AI 에이전트 프레임워크와 서비스를 사용합니다:

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

이 강의의 코드를 실행하는 방법에 대한 자세한 내용은 [Course Setup](./00-course-setup/README.md)을 참조하세요.

이 저장소를 [별표(🌟)로 표시하기](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst)와 [포크하기](https://github.com/microsoft/ai-agents-for-beginners/fork)를 잊지 마세요.

## 🙏 도움을 주고 싶으신가요?

제안 사항이 있거나 철자 또는 코드 오류를 발견하셨나요? [이슈 등록하기](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) 또는 [풀 리퀘스트 생성하기](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)

AI 에이전트를 구축하는 데 어려움을 겪거나 질문이 있으시면 [Azure AI Community Discord](https://discord.gg/kzRShWzttr)에 참여하세요.

## 📂 각 강의에는 다음이 포함됩니다

- README에 작성된 강의 내용 (비디오는 2025년 3월 공개 예정)
- Azure AI Foundry와 Github Models(무료)을 지원하는 Python 코드 샘플
- 학습을 이어갈 수 있는 추가 리소스 링크

## 🗃 강의 목록

| **강의**                              | **링크**                                   | **추가 학습**      |
|----------------------------------------|--------------------------------------------|--------------------|
| AI 에이전트와 활용 사례 소개            | [Intro to AI Agents and Use Cases](./01-intro-to-ai-agents/README.md)          | Learn More         |
| 에이전틱 프레임워크 탐구               | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | Learn More         |
| 에이전틱 디자인 패턴 이해하기           | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | Learn More         |
| 도구 활용 디자인 패턴                  | [Tool Use Design Pattern](./04-tool-use/README.md)                    | Learn More         |
| 에이전틱 RAG                           | [Agentic RAG](./05-agentic-rag/README.md)                 | Learn More         |
| 신뢰할 수 있는 AI 에이전트 구축하기      | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | Learn More         |
| 계획 디자인 패턴                       | [Planning Design Pattern](./07-planning-design/README.md)             | Learn More         |
| 다중 에이전트 디자인 패턴              | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | Learn More         |
| 메타인지 설계 패턴 | [Metacognition Design Pattern](./09-metacognition/README.md) | 더 알아보기 |
| AI 에이전트 프로덕션 활용 | [AI Agents in Production](./10-ai-agents-production/README.md) | 더 알아보기 |

## 🎒 기타 강의

우리 팀에서 제공하는 다른 강의도 확인해 보세요!

- [초보자를 위한 생성형 AI](https://aka.ms/genai-beginners)
- [초보자를 위한 머신러닝](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [초보자를 위한 데이터 과학](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [초보자를 위한 AI](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## 기여하기

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 기여자 라이선스 계약(Contributor License Agreement, CLA)에 동의해야 합니다. CLA는 여러분이 기여한 내용을 사용할 권리를 우리에게 부여할 수 있는 권리를 보유하고 있음을 선언하는 문서입니다. 자세한 내용은 <https://cla.opensource.microsoft.com>를 참조하세요.

풀 리퀘스트를 제출하면 CLA 봇이 자동으로 여러분이 CLA를 제공해야 하는지 여부를 확인하고 PR에 적절히 표시(예: 상태 확인, 댓글)합니다. 봇이 제공하는 지침을 따르기만 하면 됩니다. 이 작업은 CLA를 사용하는 모든 저장소에서 한 번만 진행하면 됩니다.

이 프로젝트는 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)를 채택하고 있습니다. 자세한 내용은 [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)를 참조하거나, 추가 질문이나 의견이 있으면 [opencode@microsoft.com](mailto:opencode@microsoft.com)으로 연락하세요.

## 상표

이 프로젝트에는 프로젝트, 제품, 서비스와 관련된 상표 또는 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 허가된 사용은 [Microsoft의 상표 및 브랜드 가이드라인](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)을 따라야 합니다. 이 프로젝트의 수정된 버전에서 Microsoft 상표 또는 로고를 사용하는 경우 혼란을 초래하거나 Microsoft의 후원을 암시해서는 안 됩니다. 제3자 상표 또는 로고의 사용은 해당 제3자의 정책을 따라야 합니다.

**면책 조항**:
이 문서는 기계 기반 AI 번역 서비스를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있습니다. 원어로 작성된 원본 문서를 신뢰할 수 있는 권위 있는 자료로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 오역에 대해 당사는 책임을 지지 않습니다.


# 보안

Microsoft는 소프트웨어 제품과 서비스의 보안을 매우 중요하게 생각합니다. 이는 [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin)과 같은 GitHub 조직을 통해 관리되는 모든 소스 코드 저장소를 포함합니다.

만약 [Microsoft의 보안 취약성 정의](https://aka.ms/security.md/definition)에 해당하는 보안 취약성을 Microsoft 소유의 저장소에서 발견했다고 생각되면, 아래 설명된 절차에 따라 보고해 주시기 바랍니다.

## 보안 문제 보고

**공개 GitHub 이슈를 통해 보안 취약성을 보고하지 마십시오.**

대신, Microsoft Security Response Center (MSRC)에 [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report)를 통해 보고해 주십시오.

로그인 없이 제출을 원하시는 경우, [secure@microsoft.com](mailto:secure@microsoft.com)으로 이메일을 보내주시기 바랍니다. 가능하다면, 메시지를 Microsoft의 PGP 키로 암호화하여 보내주십시오. PGP 키는 [Microsoft Security Response Center PGP Key 페이지](https://aka.ms/security.md/msrc/pgp)에서 다운로드할 수 있습니다.

보통 24시간 이내에 응답을 받을 수 있습니다. 만약 그렇지 않은 경우, 원본 메시지가 제대로 전달되었는지 확인하기 위해 이메일로 다시 문의해 주시기 바랍니다. 추가 정보는 [microsoft.com/msrc](https://www.microsoft.com/msrc)에서 확인할 수 있습니다.

문제를 보다 잘 이해하고 범위를 파악할 수 있도록 아래에 나열된 정보를 가능한 한 많이 포함해 주시기 바랍니다:

* 문제 유형 (예: 버퍼 오버플로우, SQL 인젝션, 크로스 사이트 스크립팅 등)
* 문제와 관련된 소스 파일의 전체 경로
* 영향을 받는 소스 코드의 위치 (태그/브랜치/커밋 또는 직접 URL)
* 문제를 재현하기 위해 필요한 특별한 구성
* 문제를 재현하는 단계별 설명
* 개념 증명 또는 익스플로잇 코드 (가능한 경우)
* 문제의 영향, 공격자가 이를 어떻게 악용할 수 있는지 포함

이 정보는 보고서를 더 신속히 검토하는 데 도움이 됩니다.

버그 바운티 프로그램에 보고하는 경우, 더 완전한 보고서는 더 높은 보상으로 이어질 수 있습니다. 현재 진행 중인 프로그램에 대한 자세한 내용은 [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) 페이지를 방문해 주십시오.

## 선호하는 언어

모든 소통은 영어로 이루어지기를 선호합니다.

## 정책

Microsoft는 [Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd) 원칙을 따릅니다.
```

**면책 조항**:
이 문서는 기계 기반 AI 번역 서비스를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있습니다. 원본 문서의 해당 언어 버전을 신뢰할 수 있는 권위 있는 자료로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.


# TODO: 이 저장소의 관리자가 아직 이 파일을 편집하지 않았습니다

**저장소 소유자**: 이 제품/프로젝트에 대해 고객 서비스 및 지원(CSS)을 받으시겠습니까?

- **CSS 지원 없음:** 문제를 제기하고 도움을 받는 방법에 대한 정보를 포함하여 이 템플릿을 작성하세요.
- **CSS 지원 있음:** [aka.ms/onboardsupport](https://aka.ms/onboardsupport)에서 접수 양식을 작성하세요. CSS가 다음 단계를 결정하는 데 도움을 주거나 지원할 것입니다.
- **잘 모르겠음?** 답변이 "예"라고 가정하고 접수 양식을 작성하세요. CSS가 결정을 도와드릴 것입니다.

*그런 다음 저장소를 게시하기 전에 이 SUPPORT.MD 파일에서 이 첫 번째 제목을 제거하세요.*

## 지원

## 문제 제기 및 도움 받는 방법

이 프로젝트는 GitHub Issues를 사용하여 버그와 기능 요청을 추적합니다. 중복을 피하기 위해 새 문제를 제기하기 전에 기존 문제를 검색하세요. 새로운 문제를 제기하려면, 버그 또는 기능 요청을 새로운 Issue로 제출하세요.

이 프로젝트를 사용하는 데 대한 도움이나 질문이 있는 경우, **저장소 관리자: 도움을 받기 위해 저장소 소유자나 커뮤니티와 소통하는 방법에 대한 지침을 여기에 삽입하세요. 스택 오버플로 태그 또는 다른 채널일 수 있습니다. 어디에서 사람들을 도울 예정인가요?**.

## Microsoft 지원 정책

이 **프로젝트 또는 제품**에 대한 지원은 위에 나열된 리소스에 한정됩니다.

**면책 조항**:
이 문서는 기계 기반 AI 번역 서비스를 사용하여 번역되었습니다. 정확성을 위해 최선을 다하고 있지만, 자동 번역에는 오류나 부정확성이 포함될 수 있습니다. 원문은 해당 언어로 작성된 문서를 신뢰할 수 있는 권위 있는 자료로 간주해야 합니다. 중요한 정보의 경우, 전문적인 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.


# Código de Conduta de Código Aberto da Microsoft

Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/).

Recursos:

- [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/)
- [Perguntas Frequentes sobre o Código de Conduta da Microsoft](https://opensource.microsoft.com/codeofconduct/faq/)
- Entre em contato com [opencode@microsoft.com](mailto:opencode@microsoft.com) para dúvidas ou preocupações

**Aviso Legal**:
Este documento foi traduzido utilizando serviços de tradução baseados em IA. Embora nos esforcemos para alcançar precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se uma tradução humana profissional. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.


# Agentes de IA para Iniciantes - Um Curso

![IA Generativa para Iniciantes](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.pt.png?WT.mc_id=academic-105485-koreyst)

## 10 Aulas ensinando tudo o que você precisa saber para começar a construir Agentes de IA

[![Licença do GitHub](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![Contribuidores do GitHub](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![Problemas no GitHub](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![Pull Requests no GitHub](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Bem-vindos](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![Observadores no GitHub](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![Forks no GitHub](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![Estrelas no GitHub](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 Suporte a Múltiplos Idiomas

| Idioma              | Código | Link para README Traduzido                            | Última Atualização |
|---------------------|--------|------------------------------------------------------|--------------------|
| Chinês (Simplificado) | zh    | [Tradução para Chinês](../zh/README.md) | 2025-02-13        |
| Chinês (Tradicional) | tw    | [Tradução para Chinês](../tw/README.md) | 2025-02-13        |
| Chinês (Hong Kong)  | hk    | [Tradução para Chinês](../hk/README.md) | 2025-02-13        |
| Francês            | fr    | [Tradução para Francês](../fr/README.md) | 2025-02-13        |
| Japonês            | ja    | [Tradução para Japonês](../ja/README.md) | 2025-02-13        |
| Coreano            | ko    | [Tradução para Coreano](../ko/README.md) | 2025-02-13        |
| Português          | pt    | [Tradução para Português](../pt/README.md) | 2025-02-13        |
| Espanhol           | es    | [Tradução para Espanhol](../es/README.md) | 2025-02-13        |

## 🌱 Começando

Este curso contém 10 aulas cobrindo os fundamentos para construir Agentes de IA. Cada aula aborda um tópico específico, então você pode começar por onde preferir!

Se esta for sua primeira vez construindo com modelos de IA Generativa, confira nosso curso [IA Generativa para Iniciantes](https://aka.ms/genai-beginners), que tem 21 aulas sobre como trabalhar com GenAI.

### Para executar o código deste curso

Este curso inclui exemplos de código em cada aula que possuem uma pasta `code_samples`. Este código utiliza os seguintes serviços para Modelos:

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - Gratuito / Limitado
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - Requer conta Azure

Este curso também utiliza os seguintes frameworks e serviços de Agentes de IA:

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

Para mais informações sobre como executar o código deste curso, acesse a página de [Configuração do Curso](./00-course-setup/README.md).

Não se esqueça de [dar uma estrela (🌟) neste repositório](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) e de [fazer um fork deste repositório](https://github.com/microsoft/ai-agents-for-beginners/fork) para executar o código.

## 🙏 Quer ajudar?

Tem sugestões ou encontrou erros de digitação ou no código? [Abra um problema](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) ou [Crie um pull request](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst).

Se você ficar preso ou tiver dúvidas sobre como construir Agentes de IA, junte-se à nossa [Comunidade Azure AI no Discord](https://discord.gg/kzRShWzttr).

## 📂 Cada aula inclui

- Uma lição escrita localizada no README (Vídeos disponíveis em março de 2025)
- Exemplos de código em Python compatíveis com Azure AI Foundry e Github Models (Gratuitos)
- Links para recursos adicionais para continuar seu aprendizado

## 🗃 Aulas

| **Aula**                              | **Link**                                   | **Aprendizado Adicional** |
|---------------------------------------|-------------------------------------------|---------------------------|
| Introdução a Agentes de IA e Casos de Uso | [Introdução a Agentes de IA e Casos de Uso](./01-intro-to-ai-agents/README.md)  | Saiba Mais               |
| Explorando Frameworks Agentes         | [Explorando Frameworks Agentes](./02-explore-agentic-frameworks/README.md)      | Saiba Mais               |
| Compreendendo Padrões de Design Agentes | [Compreendendo Padrões de Design Agentes](./03-agentic-design-patterns/README.md) | Saiba Mais               |
| Padrão de Design para Uso de Ferramentas | [Padrão de Design para Uso de Ferramentas](./04-tool-use/README.md)             | Saiba Mais               |
| Agente RAG                            | [Agente RAG](./05-agentic-rag/README.md)                                       | Saiba Mais               |
| Construindo Agentes de IA Confiáveis   | [Construindo Agentes de IA Confiáveis](./06-building-trustworthy-agents/README.md) | Saiba Mais           |
| Padrão de Design de Planejamento      | [Padrão de Design de Planejamento](./07-planning-design/README.md)             | Saiba Mais               |
| Padrão de Design Multi-Agente         | [Padrão de Design Multi-Agente](./08-multi-agent/README.md)                    | Saiba Mais               |
| Padrão de Design de Metacognição        | [Padrão de Design de Metacognição](./09-metacognition/README.md)            | Saiba Mais         |
| Agentes de IA em Produção               | [Agentes de IA em Produção](./10-ai-agents-production/README.md)            | Saiba Mais         |

## 🎒 Outros Cursos

Nossa equipe produz outros cursos! Confira:

- [IA Generativa para Iniciantes](https://aka.ms/genai-beginners)
- [ML para Iniciantes](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Ciência de Dados para Iniciantes](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [IA para Iniciantes](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## Contribuindo

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um
Contrato de Licença de Contribuidor (CLA) declarando que você tem o direito de, e realmente está, nos conceder
os direitos para usar sua contribuição. Para mais detalhes, visite <https://cla.opensource.microsoft.com>.

Quando você enviar um pull request, um bot do CLA determinará automaticamente se você precisa fornecer
um CLA e marcará o PR de forma apropriada (por exemplo, verificação de status, comentário). Basta seguir as instruções
fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que utilizam nosso CLA.

Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/).
Para mais informações, veja as [Perguntas Frequentes sobre o Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou
entre em contato com [opencode@microsoft.com](mailto:opencode@microsoft.com) para quaisquer dúvidas ou comentários adicionais.

## Marcas Registradas

Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado de marcas registradas ou logotipos da Microsoft está sujeito e deve seguir as
[Diretrizes de Marca e Logotipo da Microsoft](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general).
O uso de marcas registradas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio da Microsoft.
Qualquer uso de marcas registradas ou logotipos de terceiros está sujeito às políticas desses terceiros.

**Aviso Legal**:
Este documento foi traduzido utilizando serviços de tradução baseados em IA. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte oficial. Para informações críticas, recomenda-se a tradução humana profissional. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.


# Segurança

A Microsoft leva a segurança de seus produtos e serviços de software muito a sério, incluindo todos os repositórios de código-fonte gerenciados por meio de nossas organizações no GitHub, que incluem [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) e [Xamarin](https://github.com/xamarin).

Se você acredita ter encontrado uma vulnerabilidade de segurança em qualquer repositório pertencente à Microsoft que atenda à [definição de vulnerabilidade de segurança da Microsoft](https://aka.ms/security.md/definition), por favor, informe-nos conforme descrito abaixo.

## Relatando Problemas de Segurança

**Por favor, não relate vulnerabilidades de segurança por meio de issues públicas no GitHub.**

Em vez disso, relate-as ao Centro de Resposta de Segurança da Microsoft (MSRC) em [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).

Se preferir enviar sem fazer login, envie um e-mail para [secure@microsoft.com](mailto:secure@microsoft.com). Sempre que possível, criptografe sua mensagem com nossa chave PGP; faça o download na [página da Chave PGP do Centro de Resposta de Segurança da Microsoft](https://aka.ms/security.md/msrc/pgp).

Você deve receber uma resposta dentro de 24 horas. Caso não receba, por algum motivo, entre em contato novamente por e-mail para garantir que recebemos sua mensagem original. Informações adicionais podem ser encontradas em [microsoft.com/msrc](https://www.microsoft.com/msrc).

Inclua as informações solicitadas abaixo (na medida do possível) para nos ajudar a entender melhor a natureza e o alcance do possível problema:

* Tipo de problema (ex.: buffer overflow, SQL injection, cross-site scripting, etc.)
* Caminhos completos dos arquivos de origem relacionados à manifestação do problema
* A localização do código-fonte afetado (tag/branch/commit ou URL direta)
* Qualquer configuração especial necessária para reproduzir o problema
* Instruções passo a passo para reproduzir o problema
* Código de prova de conceito ou exploit (se possível)
* Impacto do problema, incluindo como um invasor pode explorar o problema

Essas informações nos ajudarão a priorizar sua denúncia de forma mais rápida.

Se você estiver relatando como parte de um programa de recompensa por bugs, relatórios mais detalhados podem contribuir para um prêmio maior. Visite a página do [Programa de Recompensa por Bugs da Microsoft](https://aka.ms/security.md/msrc/bounty) para mais detalhes sobre nossos programas ativos.

## Idiomas Preferenciais

Preferimos que todas as comunicações sejam feitas em inglês.

## Política

A Microsoft segue o princípio de [Divulgação Coordenada de Vulnerabilidades](https://aka.ms/security.md/cvd).

**Aviso Legal**:
Este documento foi traduzido utilizando serviços de tradução baseados em IA. Embora nos esforcemos para alcançar precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.


# TODO: O mantenedor deste repositório ainda não editou este arquivo

**PROPRIETÁRIO DO REPO**: Você deseja suporte do Customer Service & Support (CSS) para este produto/projeto?

- **Sem suporte do CSS:** Preencha este modelo com informações sobre como registrar problemas e obter ajuda.
- **Com suporte do CSS:** Preencha um formulário de entrada em [aka.ms/onboardsupport](https://aka.ms/onboardsupport). O CSS trabalhará com você/ajudará a determinar os próximos passos.
- **Não tem certeza?** Preencha um formulário de entrada como se a resposta fosse "Sim". O CSS ajudará você a decidir.

*Depois, remova este primeiro cabeçalho deste arquivo SUPPORT.MD antes de publicar seu repositório.*

## Suporte

## Como registrar problemas e obter ajuda

Este projeto utiliza o GitHub Issues para rastrear bugs e solicitações de funcionalidades. Por favor, pesquise os problemas existentes antes de registrar novos problemas para evitar duplicidades. Para novos problemas, registre seu bug ou solicitação de funcionalidade como um novo Issue.

Para obter ajuda e esclarecer dúvidas sobre como usar este projeto, por favor **MANTENEDOR DO REPO: INSIRA INSTRUÇÕES AQUI SOBRE COMO OS PROPRIETÁRIOS DO REPO OU A COMUNIDADE PODEM AJUDAR. PODERIA SER UMA TAG NO STACK OVERFLOW OU OUTRO CANAL. ONDE VOCÊ AJUDARÁ AS PESSOAS?**.

## Política de Suporte da Microsoft

O suporte para este **PROJETO ou PRODUTO** é limitado aos recursos listados acima.

**Aviso Legal**:
Este documento foi traduzido utilizando serviços de tradução baseados em IA. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte oficial. Para informações críticas, recomenda-se a tradução profissional feita por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.


# 微軟開源行為準則

此專案採用了 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)（微軟開源行為準則）。

相關資源：

- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
- 如有任何問題或疑慮，請聯繫 [opencode@microsoft.com](mailto:opencode@microsoft.com)

**免責聲明**：
本文件使用基於機器的人工智能翻譯服務進行翻譯。儘管我們努力確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文作為權威來源。對於關鍵信息，建議尋求專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或錯誤解釋概不負責。


# 初學者的 AI Agents 課程

![Generative AI For Beginners](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.tw.png?WT.mc_id=academic-105485-koreyst)

## 10 堂課教你從零開始建立 AI Agents 所需的一切

[![GitHub license](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 多語言支援

| 語言                  | 代碼 | 已翻譯的 README 連結                                   | 最後更新日期   |
|-----------------------|------|-----------------------------------------------------|--------------|
| 簡體中文              | zh   | [Chinese Translation](../zh/README.md)  | 2025-02-13   |
| 繁體中文              | tw   | [Chinese Translation](./README.md)  | 2025-02-13   |
| 法文                  | fr   | [French Translation](../fr/README.md)   | 2025-02-13   |
| 日文                  | ja   | [Japanese Translation](../ja/README.md) | 2025-02-13   |
| 韓文                  | ko   | [Korean Translation](../ko/README.md)   | 2025-02-13   |
| 西班牙文              | es   | [Spanish Translation](../es/README.md)  | 2025-02-13   |

> **注意：**
> 這些翻譯是使用開源工具 [co-op-translator](https://github.com/Azure/co-op-translator) 自動生成的，可能包含錯誤或不準確之處。如需重要資訊，請參考原文或尋求專業人工翻譯。如果您希望貢獻或更新翻譯，請訪問此儲存庫，您可以使用簡單的指令輕鬆進行貢獻。

## 🌱 快速開始

本課程包含 10 堂課，涵蓋建立 AI Agents 的基礎知識。每堂課探討不同的主題，您可以自由選擇從任何地方開始！

如果您是第一次接觸生成式 AI 模型，建議先參考我們的 [Generative AI For Beginners](https://aka.ms/genai-beginners) 課程，該課程包含 21 堂課，專注於使用生成式 AI 建構專案。

### 如何執行本課程的程式碼

本課程的每堂課都有一個包含程式碼範例的 `code_samples` 資料夾。這些程式碼使用以下模型服務：

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - 免費 / 有限功能
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需 Azure 帳戶

本課程也使用以下 AI Agent 框架與服務：

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

如需更多有關執行本課程程式碼的資訊，請參考 [課程設定](./00-course-setup/README.md)。

別忘了 [收藏 (🌟) 這個儲存庫](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) 並 [分叉 (fork) 這個儲存庫](https://github.com/microsoft/ai-agents-for-beginners/fork) 來執行程式碼。

## 🙏 想要幫忙嗎？

有任何建議或發現拼寫或程式碼錯誤？[提出問題](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) 或 [建立拉取請求](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)。

如果您遇到問題或有關於建立 AI Agents 的任何疑問，歡迎加入我們的 [Azure AI 社群 Discord](https://discord.gg/kzRShWzttr)。

## 📂 每堂課內容包含

- 一份書面課程，位於 README 中（影片將於 2025 年 3 月推出）
- 支援 Azure AI Foundry 和 Github Models（免費）的 Python 程式碼範例
- 延伸學習資源的連結

## 🗃 課程清單

| **課程**                             | **連結**                                   | **延伸學習**     |
|--------------------------------------|--------------------------------------------|------------------|
| AI Agents 與應用場景介紹             | [Intro to AI Agents and Use Cases](./01-intro-to-ai-agents/README.md) | 繼續學習         |
| 探索 Agentic 框架                     | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | 了解更多         |
| 理解 Agentic 設計模式                 | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | 了解更多         |
| 工具使用設計模式                     | [Tool Use Design Pattern](./04-tool-use/README.md)                    | 了解更多         |
| Agentic RAG                          | [Agentic RAG](./05-agentic-rag/README.md)                 | 了解更多         |
| 建立值得信賴的 AI Agent              | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | 了解更多         |
| 規劃設計模式                         | [Planning Design Pattern](./07-planning-design/README.md)             | 了解更多         |
| 多代理設計模式                       | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | 了解更多         |
| 後設認知設計模式                     | [Metacognition Design Pattern](./09-metacognition/README.md)               | 了解更多         |
| 生產環境中的 AI Agent                | [AI Agents in Production](./10-ai-agents-production/README.md)        | 了解更多         |

## 🎒 其他課程

我們的團隊還製作了其他課程！看看以下內容：

- [Generative AI for Beginners](https://aka.ms/genai-beginners)
- [ML for Beginners](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Data Science for Beginners](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [AI for Beginners](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## 貢獻指南

我們歡迎任何貢獻與建議。大多數貢獻需要您同意一份貢獻者授權協議 (CLA)，聲明您擁有授權我們使用您貢獻的權利，並且您確實授予了我們這樣的權利。詳情請參考 <https://cla.opensource.microsoft.com>。

當您提交 Pull Request 時，CLA 機器人會自動判斷您是否需要提供 CLA 並適當標註 PR（例如，狀態檢查、評論）。只需按照機器人的指示操作即可。您只需要在所有使用我們 CLA 的 repo 中執行一次這個操作。

此專案已採用 [Microsoft 開源行為準則](https://opensource.microsoft.com/codeofconduct/)。如需更多資訊，請參閱 [行為準則 FAQ](https://opensource.microsoft.com/codeofconduct/faq/)，或聯繫 [opencode@microsoft.com](mailto:opencode@microsoft.com) 提出任何其他問題或意見。

## 商標

此專案可能包含專案、產品或服務的商標或標誌。經授權使用 Microsoft 商標或標誌需遵循 [Microsoft 的商標與品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。修改版專案中使用 Microsoft 商標或標誌不得引起混淆或暗示 Microsoft 的贊助。任何第三方商標或標誌的使用則需遵守該第三方的政策。

**免責聲明**：
本文檔是使用基於機器的人工智能翻譯服務翻譯的。儘管我們努力確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原始語言的文件作為權威來源。對於關鍵信息，建議尋求專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或誤讀概不負責。


# 安全性

Microsoft 非常重視我們軟體產品與服務的安全性，這也包括透過我們 GitHub 組織管理的所有原始碼庫，例如 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。

如果您認為在任何 Microsoft 擁有的儲存庫中發現了符合 [Microsoft 的安全性漏洞定義](https://aka.ms/security.md/definition) 的安全性漏洞，請按照以下說明向我們回報。

## 回報安全性問題

**請勿透過公開的 GitHub 問題回報安全性漏洞。**

請改為透過 Microsoft Security Response Center (MSRC) 提交回報：[https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report)。

如果您希望在不登入的情況下提交，請發送電子郵件至 [secure@microsoft.com](mailto:secure@microsoft.com)。如果可能，請使用我們的 PGP 金鑰加密您的訊息；您可以從 [Microsoft Security Response Center PGP Key 頁面](https://aka.ms/security.md/msrc/pgp) 下載。

您應該會在 24 小時內收到回應。如果因某些原因未收到回應，請透過電子郵件再次跟進，以確保我們收到您的原始訊息。更多資訊請參閱 [microsoft.com/msrc](https://www.microsoft.com/msrc)。

請盡量提供以下所列的相關資訊（能提供越多越好），以幫助我們更好地理解問題的性質和範圍：

* 問題類型（例如：緩衝區溢位、SQL 注入、跨站腳本攻擊等）
* 與問題相關的原始檔案完整路徑
* 受影響原始碼的位置（標籤/分支/提交或直接 URL）
* 重現問題所需的任何特殊配置
* 重現問題的逐步指導
* 概念驗證或攻擊程式碼（如果可能）
* 問題的影響，包括攻擊者可能如何利用該問題

這些資訊將幫助我們更快速地分類您的回報。

如果您是為了漏洞賞金計畫進行回報，提供更完整的報告可能會有助於獲得更高的獎勵。更多詳細資訊請參閱我們的 [Microsoft 漏洞賞金計畫](https://aka.ms/security.md/msrc/bounty) 頁面。

## 優先語言

我們希望所有的溝通能以英文進行。

## 政策

Microsoft 遵循 [協調式漏洞揭露](https://aka.ms/security.md/cvd) 原則。

**免責聲明**：
本文件已使用基於人工智能的機器翻譯服務進行翻譯。我們雖然致力於追求準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原文語言的原始文件作為權威來源。對於關鍵信息，建議尋求專業人工翻譯。我們對因使用本翻譯而產生的任何誤解或錯誤解讀概不負責。


# TODO: 此存放庫的維護者尚未編輯此檔案

**存放庫擁有者**：您希望為此產品/專案提供客戶服務與支援 (CSS) 嗎？

- **不需要 CSS 支援**：請填寫此範本，提供關於如何提交問題和獲取幫助的資訊。
- **需要 CSS 支援**：請填寫 [aka.ms/onboardsupport](https://aka.ms/onboardsupport) 上的申請表。CSS 將與您合作，協助確定後續步驟。
- **不確定？** 請像回答「是」一樣填寫申請表。CSS 將協助您進行決策。

*在發佈您的存放庫之前，請從此 SUPPORT.MD 檔案中移除此第一個標題。*

## 支援

## 如何提交問題與獲取幫助

此專案使用 GitHub Issues 來追蹤錯誤和功能需求。請在提交新問題之前，先搜尋現有的問題，以避免重複。對於新問題，請將您的錯誤或功能需求作為新 Issue 提交。

如果您需要幫助或對使用此專案有任何疑問，請 **存放庫維護者：在此插入指導用戶如何聯繫存放庫擁有者或社群的說明。可以是 Stack Overflow 的標籤或其他管道。您會在哪裡協助用戶？**。

## Microsoft 支援政策

對此 **專案或產品** 的支援僅限於上面列出的資源。

**免責聲明**：
本文件使用機器翻譯服務進行翻譯。我們致力於提供準確的翻譯，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原始語言的文件作為權威來源。對於關鍵資訊，建議尋求專業的人工作翻譯。我們對於使用此翻譯而引起的任何誤解或誤讀概不負責。


# 微软开源行为准则

本项目已采用 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。

资源：

- [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft 行为准则常见问题](https://opensource.microsoft.com/codeofconduct/faq/)
- 如果有任何问题或疑虑，请联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)

**免责声明**：
本文件通过基于机器的人工智能翻译服务进行翻译。尽管我们努力确保准确性，但请注意，自动翻译可能包含错误或不准确之处。应以原始语言的文件作为权威来源。对于关键信息，建议寻求专业人工翻译服务。因使用此翻译而导致的任何误解或误读，我们概不负责。


# 初学者的 AI 代理课程

![生成式 AI 入门](../../translated_images/repo-thumbnail.fdd5f487bb7274d4a08459d76907ec4914de268c99637e9af082b1d3eb0730e2.zh.png?WT.mc_id=academic-105485-koreyst)

## 10 节课程，教您从零开始构建 AI 代理的一切知识

[![GitHub license](https://img.shields.io/github/license/microsoft/ai-agents-for-beginners.svg)](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[![GitHub contributors](https://img.shields.io/github/contributors/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[![GitHub issues](https://img.shields.io/github/issues/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/microsoft/ai-agents-for-beginners.svg)](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)

[![GitHub watchers](https://img.shields.io/github/watchers/microsoft/ai-agents-for-beginners.svg?style=social&label=Watch)](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[![GitHub forks](https://img.shields.io/github/forks/microsoft/ai-agents-for-beginners.svg?style=social&label=Fork)](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[![GitHub stars](https://img.shields.io/github/stars/microsoft/ai-agents-for-beginners.svg?style=social&label=Star)](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)

[![Azure AI Discord](https://dcbadge.limes.pink/api/server/kzRShWzttr)](https://discord.gg/kzRShWzttr)

## 🌐 多语言支持

| 语言                 | 代码 | 翻译后的 README 链接                                   | 最后更新日期       |
|----------------------|------|-----------------------------------------------------|--------------------|
| 简体中文             | zh   | [中文翻译](./README.md)              | 2025-02-13         |
| 繁体中文             | tw   | [中文翻译](../tw/README.md)              | 2025-02-13         |
| 法语                 | fr   | [法语翻译](../fr/README.md)              | 2025-02-13         |
| 日语                 | ja   | [日语翻译](../ja/README.md)              | 2025-02-13         |
| 韩语                 | ko   | [韩语翻译](../ko/README.md)              | 2025-02-13         |
| 西班牙语             | es   | [西班牙语翻译](../es/README.md)          | 2025-02-13         |

> **注意:**
> 这些翻译是使用开源工具 [co-op-translator](https://github.com/Azure/co-op-translator) 自动生成的，可能存在错误或不准确之处。对于重要信息，请参考原文或寻求专业人工翻译。如果您想贡献或更新翻译，请访问该仓库，您可以通过简单的命令轻松进行贡献。

## 🌱 快速开始

本课程包含 10 节课，涵盖构建 AI 代理的基础知识。每节课都专注于一个独立主题，因此您可以从任何感兴趣的地方开始！

如果这是您第一次使用生成式 AI 模型进行构建，请查看我们的 [生成式 AI 入门课程](https://aka.ms/genai-beginners)，该课程包含 21 节课，讲解如何使用生成式 AI。

### 如何运行本课程的代码

本课程在每节课中提供了包含 `code_samples` 文件夹的代码示例。这些代码使用以下模型服务：

- [Github Models](https://aka.ms/ai-agents-beginners/github-models) - 免费 / 有限
- [Azure AI Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需要 Azure 账号

此外，本课程还使用以下 AI 代理框架和服务：

- [Azure AI Agent Service](https://aka.ms/ai-agents-beginners/ai-agent-service)
- [Semantic Kernel](https://aka.ms/ai-agents-beginners/semantic-kernel)
- [AutoGen](https://aka.ms/ai-agents/autogen)

有关运行本课程代码的更多信息，请参阅 [课程设置](./00-course-setup/README.md)。

别忘了 [给这个仓库点星 (🌟)](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) 和 [fork 这个仓库](https://github.com/microsoft/ai-agents-for-beginners/fork) 来运行代码。

## 🙏 想要贡献？

您有建议或发现拼写或代码错误吗？请[提交问题](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst)或[创建拉取请求](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)。

如果您遇到困难或对构建 AI 代理有任何疑问，请加入我们的 [Azure AI 社区 Discord](https://discord.gg/kzRShWzttr)。

## 📂 每节课包括

- 写在 README 中的课程内容（视频将于 2025 年 3 月上线）
- 支持 Azure AI Foundry 和 Github Models（免费）的 Python 代码示例
- 指向额外学习资源的链接，帮助您继续学习

## 🗃 课程目录

| **课程**                             | **链接**                                   | **额外学习资源**   |
|-------------------------------------|------------------------------------------|--------------------|
| AI 代理简介及应用场景               | [AI 代理简介及应用场景](./01-intro-to-ai-agents/README.md) | 了解更多           |
| 探索 Agentic 框架                | [Exploring Agentic Frameworks](./02-explore-agentic-frameworks/README.md)  | 了解更多         |
| 理解 Agentic 设计模式            | [Understanding Agentic Design Patterns](./03-agentic-design-patterns/README.md)  | 了解更多         |
| 工具使用设计模式                 | [Tool Use Design Pattern](./04-tool-use/README.md)                    | 了解更多         |
| Agentic RAG                      | [Agentic RAG](./05-agentic-rag/README.md)                 | 了解更多         |
| 构建可信赖的 AI 代理             | [Building Trustworthy AI Agents](./06-building-trustworthy-agents/README.md) | 了解更多         |
| 规划设计模式                     | [Planning Design Pattern](./07-planning-design/README.md)             | 了解更多         |
| 多代理设计模式                   | [Muilt-Agent Design Pattern](./08-multi-agent/README.md)                 | 了解更多         |
| 元认知设计模式                   | [Metacognition Design Pattern](./09-metacognition/README.md)               | 了解更多         |
| 生产环境中的 AI 代理             | [AI Agents in Production](./10-ai-agents-production/README.md)        | 了解更多         |

## 🎒 其他课程

我们的团队还制作了其他课程！欢迎查看：

- [Generative AI for Beginners](https://aka.ms/genai-beginners)
- [ML for Beginners](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
- [Data Science for Beginners](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
- [AI for Beginners](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)

## 贡献指南

本项目欢迎贡献和建议。大多数贡献需要您同意一份贡献者许可协议 (CLA)，声明您有权并实际授予我们使用您贡献的权利。详情请访问 <https://cla.opensource.microsoft.com>。

当您提交一个 pull request 时，CLA 机器人会自动判断您是否需要提供 CLA，并相应地标记 PR（例如状态检查、评论）。只需按照机器人提供的指示操作即可。您只需在所有使用我们 CLA 的仓库中执行一次此操作。

本项目采用了 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。
如需更多信息，请参阅 [行为准则 FAQ](https://opensource.microsoft.com/codeofconduct/faq/) 或通过 [opencode@microsoft.com](mailto:opencode@microsoft.com) 联系我们提出其他问题或评论。

## 商标声明

本项目可能包含项目、产品或服务的商标或徽标。使用 Microsoft 商标或徽标需获得授权，并必须遵循 [Microsoft 的商标和品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。
在修改版本的项目中使用 Microsoft 商标或徽标不得引起混淆或暗示 Microsoft 的赞助。
任何对第三方商标或徽标的使用均需遵守该第三方的政策。

**免责声明**：
本文档通过基于机器的AI翻译服务翻译而成。尽管我们努力确保准确性，但请注意，自动翻译可能包含错误或不准确之处。应以原始语言的文档作为权威来源。对于关键信息，建议寻求专业人工翻译。因使用本翻译而引起的任何误解或误读，我们概不负责。


# 安全性

Microsoft 非常重视我们软件产品和服务的安全性，这包括通过我们的 GitHub 组织管理的所有源代码库，这些组织包括 [Microsoft](https://github.com/Microsoft)、[Azure](https://github.com/Azure)、[DotNet](https://github.com/dotnet)、[AspNet](https://github.com/aspnet) 和 [Xamarin](https://github.com/xamarin)。

如果您认为在任何 Microsoft 拥有的代码库中发现了安全漏洞，并且该漏洞符合 [Microsoft 对安全漏洞的定义](https://aka.ms/security.md/definition)，请按照以下说明向我们报告。

## 报告安全问题

**请不要通过公开的 GitHub 问题报告安全漏洞。**

请通过 Microsoft 安全响应中心 (MSRC) 报告安全问题，访问 [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report)。

如果您希望在不登录的情况下提交报告，可以发送电子邮件至 [secure@microsoft.com](mailto:secure@microsoft.com)。 如果可能，请使用我们的 PGP 密钥加密您的消息；您可以从 [Microsoft 安全响应中心 PGP 密钥页面](https://aka.ms/security.md/msrc/pgp) 下载。

您应该会在 24 小时内收到回复。如果由于某种原因未收到，请通过电子邮件进行跟进，以确保我们收到了您的原始消息。更多信息可在 [microsoft.com/msrc](https://www.microsoft.com/msrc) 查阅。

请尽可能提供以下所需信息，以帮助我们更好地理解可能问题的性质和范围：

* 问题类型（例如，缓冲区溢出、SQL 注入、跨站脚本攻击等）
* 与问题表现相关的源文件的完整路径
* 受影响源代码的位置（标签/分支/提交或直接 URL）
* 重现问题所需的任何特殊配置
* 重现问题的逐步说明
* 概念验证代码或漏洞利用代码（如果可能）
* 问题的影响，包括攻击者可能如何利用该问题

这些信息将帮助我们更快速地对您的报告进行分类和处理。

如果您是为漏洞奖励计划报告问题，更完整的报告可能会获得更高的奖励金额。有关我们当前活动计划的更多详细信息，请访问 [Microsoft 漏洞奖励计划](https://aka.ms/security.md/msrc/bounty) 页面。

## 优先语言

我们优先使用英语进行所有交流。

## 政策

Microsoft 遵循 [协调漏洞披露](https://aka.ms/security.md/cvd) 原则。

**免责声明**：
本文件使用基于机器的人工智能翻译服务进行翻译。尽管我们尽力确保准确性，但请注意，自动翻译可能包含错误或不准确之处。原始语言的文件应被视为权威来源。对于关键信息，建议寻求专业人工翻译。对于因使用本翻译而导致的任何误解或误读，我们概不负责。


# 待办事项：此仓库的维护者尚未编辑此文件

**仓库所有者**：您是否希望为此产品/项目提供客户服务与支持 (CSS)？

- **不需要 CSS 支持**：请使用本模板填写有关如何提交问题和获取帮助的信息。
- **需要 CSS 支持**：请填写 [aka.ms/onboardsupport](https://aka.ms/onboardsupport) 上的接收表单。CSS 将与您合作/帮助您确定下一步行动。
- **不确定？** 请按照“需要”填写接收表单。CSS 将帮助您做出决定。

*然后在发布您的仓库之前，从这个 SUPPORT.MD 文件中删除这一部分标题。*

## 支持

## 如何提交问题并获取帮助

此项目使用 GitHub Issues 来跟踪漏洞和功能请求。在提交新问题之前，请先搜索现有问题以避免重复。对于新问题，请将您的漏洞或功能请求作为一个新 Issue 提交。

如果您需要帮助或对使用此项目有疑问，请 **仓库维护者：在此插入与仓库所有者或社区联系以获取帮助的说明。可以是 Stack Overflow 标签或其他渠道。您会在哪里为人们提供帮助？**。

## Microsoft 支持政策

对于此 **项目或产品** 的支持仅限于上述列出的资源。

**免责声明**：
本文件使用基于机器的人工智能翻译服务进行翻译。尽管我们努力确保准确性，但请注意，自动翻译可能包含错误或不准确之处。应以原始语言的原始文件为权威来源。对于关键信息，建议使用专业人工翻译。因使用本翻译而引起的任何误解或误读，我们概不负责。


---
name: Bug report
about: Create a report to help us improve
title: ''
labels: ''
assignees: ''

---

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

**Expected behavior**
A clear and concise description of what you expected to happen.

**Screenshots**
If applicable, add screenshots to help explain your problem.

**Desktop (please complete the following information):**
 - OS: [e.g. iOS]
 - Browser [e.g. chrome, safari]
 - Version [e.g. 22]

**Smartphone (please complete the following information):**
 - Device: [e.g. iPhone6]
 - OS: [e.g. iOS8.1]
 - Browser [e.g. stock browser, safari]
 - Version [e.g. 22]

**Additional context**
Add any other context about the problem here.


```markdown
# Kurseinrichtung

## Einführung

In dieser Lektion wird erklärt, wie die Codebeispiele dieses Kurses ausgeführt werden können.

## Anforderungen

- Ein GitHub-Konto
- Python 3.12+

## Dieses Repository klonen oder forken

Um zu beginnen, klonen oder forken Sie bitte das GitHub-Repository. Dadurch erstellen Sie Ihre eigene Version des Kursmaterials, sodass Sie den Code ausführen, testen und anpassen können!

Dies können Sie tun, indem Sie auf den Link [fork the repo](https://github.com/microsoft/ai-agents-for-beginners/fork) klicken.

Sie sollten nun Ihre eigene geforkte Version dieses Kurses haben, wie unten gezeigt:

![Geforktes Repository](../../../translated_images/forked-repo.eea246a73044cc984a1e462349e36e7336204f00785e3187b7399905feeada07.de.png)

## Abrufen Ihres GitHub Personal Access Token (PAT)

Dieser Kurs verwendet derzeit den GitHub Models Marketplace, um kostenlosen Zugriff auf Large Language Models (LLMs) bereitzustellen, die zur Erstellung von KI-Agenten verwendet werden.

Um auf diesen Service zuzugreifen, müssen Sie ein GitHub Personal Access Token erstellen.

Dies können Sie tun, indem Sie zu Ihren [Personal Access Tokens settings](https://github.com/settings/personal-access-tokens) in Ihrem GitHub-Konto gehen.

Wählen Sie die `Fine-grained tokens`-Optionen auf der linken Seite Ihres Bildschirms.

Wählen Sie anschließend `Generate new token`.

![Token generieren](../../../translated_images/generate-token.361ec40abe59b84ac68d63c23e2b6854d6fad82bd4e41feb98fc0e6f030e8ef7.de.png)

Kopieren Sie Ihren neu erstellten Token. Sie werden diesen nun in Ihre `.env`-Datei einfügen, die in diesem Kurs enthalten ist.

## Hinzufügen zu Ihren Umgebungsvariablen

Um Ihre `.env`-Datei zu erstellen, führen Sie den folgenden Befehl in Ihrem Terminal aus:

```bash
cp .env.example .env
```

Dieser Befehl kopiert die Beispieldatei und erstellt eine `.env`-Datei in Ihrem Verzeichnis.

Öffnen Sie diese Datei und fügen Sie den erstellten Token in das Feld `GITHUB_TOKEN=` der .env-Datei ein.

## Erforderliche Pakete installieren

Um sicherzustellen, dass Sie alle erforderlichen Python-Pakete für die Ausführung des Codes haben, führen Sie den folgenden Befehl in Ihrem Terminal aus.

Wir empfehlen, eine Python-virtuelle Umgebung zu erstellen, um Konflikte und Probleme zu vermeiden.

```bash
pip install -r requirements.txt
```

Dies sollte die benötigten Python-Pakete installieren.

Sie sind nun bereit, den Code dieses Kurses auszuführen. Viel Spaß beim Erforschen der Welt der KI-Agenten!

Falls Sie Probleme bei der Einrichtung haben, treten Sie unserem [Azure AI Community Discord](https://discord.gg/kzRShWzttr) bei oder [erstellen Sie ein Issue](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst).
```

**Haftungsausschluss**:
Dieses Dokument wurde mit KI-gestützten maschinellen Übersetzungsdiensten übersetzt. Obwohl wir uns um Genauigkeit bemühen, weisen wir darauf hin, dass automatisierte Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner ursprünglichen Sprache sollte als maßgebliche Quelle betrachtet werden. Für kritische Informationen wird eine professionelle menschliche Übersetzung empfohlen. Wir haften nicht für Missverständnisse oder Fehlinterpretationen, die aus der Nutzung dieser Übersetzung entstehen.