OpenSource-Hub

ai-agents-for-beginners

튜토리얼

microsoft/ai-agents-for-beginners

12개 강의로 배우는 AI 에이전트 구축, 실전 코드 포함.

개요

초보자를 위한 AI 에이전트 구축 강좌로, Microsoft Agent Framework와 Azure AI Foundry 기초를 다룹니다. 각 강의에는 문서, 비디오 및 Python 예제 코드가 포함되어 있으며, 50개 이상의 언어 번역을 지원합니다.

README 미리보기

# AI Agents for Beginners - A Course\n\n\n\n## A course teaching everything you need to know to start building AI Agents\n\n[](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)\n[](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)\n[](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)\n[](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)\n[](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)\n\n### 🌐 Multi-Language Support\n\n#### Supported via GitHub Action (Automated & Always Up-to-Date)\n\n\n[Arabic](./translations/ar/README.md) | [Bengali](./translations/bn/README.md) | [Bulgarian](./translations/bg/README.md) | [Burmese (Myanmar)](./translations/my/README.md) | [Chinese (Simplified)](./translations/zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](./translations/zh-HK/README.md) | [Chinese (Traditional, Macau)](./translations/zh-MO/README.md) | [Chinese (Traditional, Taiwan)](./translations/zh-TW/README.md) | [Croatian](./translations/hr/README.md) | [Czech](./translations/cs/README.md) | [Danish](./translations/da/README.md) | [Dutch](./translations/nl/README.md) | [Estonian](./translations/et/README.md) | [Finnish](./translations/fi/README.md) | [French](./translations/fr/README.md) | [German](./translations/de/README.md) | [Greek](./translations/el/README.md) | [Hebrew](./translations/he/README.md) | [Hindi](./translations/hi/README.md) | [Hungarian](./translations/hu/README.md) | [Indonesian](./translations/id/README.md) | [Italian](./translations/it/README.md) | [Japanese](./translations/ja/README.md) | [Kannada](./translations/kn/README.md) | [Khmer](./translations/km/README.md) | [Korean](./translations/ko/README.md) | [Lithuanian](./translations/lt/README.md) | [Malay](./translations/ms/README.md) | [Malayalam](./translations/ml/README.md

FAQ (3)

문제 해결
macOS에서 Python으로 Azure AI Inference endpoint를 사용할 때 SSL certificate verification failed 오류를 해결하는 방법

AzureAIChatCompletionClient 인스턴스화에 connection_verify=certifi.where() 인수를 추가하세요. 이렇게 하면 기본 Azure SDK가 certifi의 CA 번들을 사용하도록 강제됩니다. 먼저 certifi가 설치되어 있는지 확인하세요: pip install --upgrade certifi. 예시:
import certifi
from autogen_ext.models.azure import AzureAIChatCompletionClient

client = AzureAIChatCompletionClient(
model="gpt-4o-mini",
endpoint="https://models.inference.ai.azure.com",
credential=AzureKeyCredential(os.getenv("GITHUB_TOKEN")),
model_info={...},
connection_verify=certifi.where()
)

원본 Issue #256
문제 해결
Semantic Kernel에서 'Argument 'history' has a value that doesn't support encoding' 오류를 어떻게 해결하나요?

Semantic Kernel 프롬프트 템플릿에서 'history' 인수로 문자열이 아닌 값(예: ChatHistory 개체)을 전달하면 자동 인코딩이 실패할 수 있습니다. 해결 방법: 프롬프트 템플릿 정의에서 인수에 allow_dangerously_set_content=True를 설정하거나 전달하기 전에 값을 문자열로 변환하세요. 사용자 정의 개체의 경우 사용자 정의 인코딩 전략을 구현하세요. 이 오류는 일반적으로 KernelFunctionSelectionStrategy와 같은 에이전트 선택 전략 중에 나타납니다.

원본 Issue #305
문제 해결
structured_agent.run()을 호출할 때 Pydantic 모델을 response_format으로 전달하려면 어떻게 해야 하나요?

Pydantic 모델을 options 인수를 통해 전달하세요:

response = await structured_agent.run(
    "I want to fly from London Heathrow to somewhere warm in Europe. "
    "Check what's available.",
    options={"response_format": TravelPlan}
)

options={"response_format": TravelPlan}을 생략하면 에이전트가 TravelPlan 구조화된 출력 스키마를 반환하도록 명시적으로 구성되지 않는다는 의미입니다.

원본 Issue #754