밀란 요바노비치, ASP .NET Core에서 PDF 문서 생성 - 그의 선택은 IronPDF

에이전트 프레임워크는 무엇인가

이 프레임워크는 두 가지 주요 기능을 제공합니다. 에이전트는 입력을 처리하고, 툴과 MCP 서버를 호출하며, 응답을 생성하는 개별 LLM-구동 작업자입니다. 워크플로우는 유형 안전 라우팅, 체크포인트, 사람의 루프 지원과 함께 여러 에이전트와 기능을 연결하는 그래프 기반 오케스트레이션입니다.

이 두 면을 중심으로, 프레임워크는 팀이 Enterprise AI 툴링에서 기대하는 구성 요소를 제공합니다: Azure OpenAI, OpenAI, Anthropic, Ollama 및 Microsoft Foundry를 아우르는 모델 클라이언트; 세션 기반 상태 관리; 메모리를 위한 컨텍스트 제공자; 에이전트 행동을 가로채기 위한 미들웨어; 툴 통합을 위한 MCP 클라이언트.

"Semantic Kernel 및 AutoGen의 후속 작업" 프레이밍은 중요합니다. Microsoft는 메뉴에 또 다른 프레임워크를 추가하는 대신 통합하고 있습니다. 어떤 .NET 에이전트 스택에 커밋하려고 기다려왔던 팀에게, 이는 이제 더 명확한 답입니다.

문서의 가장 과소평가된 줄

에이전트 대 워크플로를 사용할 시기를 설명하는 섹션에 문장이 포함되어 있으며, 전체 페이지보다 더 많은 작업을 합니다:

작업을 처리하는 함수를 쓸 수 있다면 AI 에이전트를 사용하는 대신 그렇게 하십시오.

이는 솔직한 엔지니어링 프레이밍이며, 에이전트 도입에 대한 모든 대화의 출발점이어야 합니다. 에이전트는 마법이 아닙니다. 그들은 어떤 도구를 호출할지, 어떤 순서로 호출할지 선택할 수 있는 LLM입니다. 작업이 결정론적일 때, 함수는 더 빠르고, 더 저렴하며, 더 신뢰할 수 있습니다. 에이전트는 작업을 통해 나가는 경로가 진정으로 열린 경우 제자리를 찾습니다.

라이브러리 팀에게, 이것은 허가를 주는 신호입니다. 우리의 라이브러리는 그들이 작업을 위임할 때 에이전트가 호출하는 함수입니다. 프레임워크는 라이브러리 코드를 대체하지 않습니다; 그것에 의존합니다.

.NET 라이브러리가 적합한 곳

도구는 에이전트와 사용자가 실제로 원하는 작업 사이의 연결 조직입니다. 에이전트가 '이 사용자는 우리가 방금 요약한 데이터에서 생성된 PDF를 원하고 있다'고 결정할 때, 스스로 PDF를 생성하지 않습니다. 그것은 그런 작업을 하는 도구를 호출합니다.

생산 AI 애플리케이션의 대부분의 유용한 도구는 문서, 데이터 또는 외부 시스템에 대한 작업으로 축소됩니다. 문서 처리 공간에서 작업하는 .NET 팀에게, 이는 IronPDF, IronOCR, IronXL와 같은 라이브러리와 직접적으로 연결됩니다. 에이전트가 호출할 수 있는 함수로 래핑된 IronPDF를 사용하는 구체적인 예:

[Description("Generates a PDF from HTML content and saves it to disk")]
public static string GenerateHtmlPdf(
    [Description("The HTML content to render")] string html,
    [Description("The output file path")] string outputPath)
{
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(outputPath);
    return $"PDF saved to {outputPath}";
}

[Description("Generates a PDF from HTML content and saves it to disk")]
public static string GenerateHtmlPdf(
    [Description("The HTML content to render")] string html,
    [Description("The output file path")] string outputPath)
{
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(outputPath);
    return $"PDF saved to {outputPath}";
}

Imports System.ComponentModel

<Description("Generates a PDF from HTML content and saves it to disk")>
Public Shared Function GenerateHtmlPdf(
    <Description("The HTML content to render")> html As String,
    <Description("The output file path")> outputPath As String) As String

    Dim renderer = New ChromePdfRenderer()
    Using pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs(outputPath)
    End Using
    Return $"PDF saved to {outputPath}"
End Function

이 함수를 에이전트에 도구로 등록하면, 에이전트는 필요에 따라 스타일이 적용된 PDF 보고서를 생성할 수 있습니다. 같은 패턴은 OCR (스캔 문서에서 텍스트 추출), 스프레드시트 작업 (XLSX 데이터를 읽거나 쓰기), 문서 변환에도 적용됩니다. 각 라이브러리는 기능을 노출하며, 각 기능은 에이전트 도구가 됩니다.

문서 파이프라인을 위한 워크플로

워크플로 표면은 별도로 볼 가치가 있습니다. 작업 중 생산에서의 문서 처리는 거의 단일 단계가 아닙니다. 보통의 실제 파이프라인은 다음과 같습니다: 스캔된 송장을 OCR 처리하여 구조화된 필드를 추출하고, 이를 비즈니스 규칙과 대조하고, 검증된 데이터를 엑셀 장부에 작성하고, 고객을 위한 PDF 영수증을 생성합니다.

그 시퀀스는 단계 간의 유형 안전 라우팅으로 깔끔하게 그래프 기반 워크플로에 매핑됩니다. 각 노드는 함수 또는 에이전트이며, 각 전환은 잘 정의된 입력 및 출력 유형을 가지며, 워크플로는 장기 실행 작업에 대한 체크포인트와 어떤 단계에서도의 인간 검토를 지원합니다.

이 오케스트레이션을 사용자 정의 코드로 수작업으로 작성해 온 팀에게, 워크플로 표면은 에이전트 프레임워크에서 가장 조사할 가치가 있는 부분입니다.

툴 호출이나 워크플로 노드를 지원하기 위해 PDF, OCR, Excel, Word 또는 바코드 기능이 필요한 팀에게, Iron Suite는 모든 다섯 개의 생산 테스트된 구현을 제공합니다. 무료 체험을 시작하십시오, 신용 카드 필요 없음.

제한 사항 및 고려사항

커밋하기 전에 몇 가지 유의할 가치가 있는 사항:

• 프레임워크는 새 것입니다. 이는 Semantic Kernel 및 AutoGen에서 성숙한 개념을 통합하지만, 통합된 API 표면은 자체적으로 최근입니다. API는 계속해서 발전할 것입니다.
• 서드 파티 모델 및 도구 위험. Microsoft의 자체 문서는 통합하는 모든 서드 파티 시스템 (비-Azure 모델, 외부 에이전트, 서드 파티 도구)은 데이터 처리, 비용 및 보안에 대한 책임이 자신에게 남아 있다고 명시하고 있습니다. 이는 올바른 프레이밍이며 주의해서 읽을 가치가 있습니다.
• 프로덕션 가드레일은 여전히 사용자의 책임입니다. 콘텐츠 필터, 책임 있는 AI 완화, 텔레메트리 및 특정 사용 사례에 대한 품질 테스트는 프레임워크에 의해 제공되지 않습니다. 프레임워크는 빌딩 블록을 제공합니다; 그 주위의 시스템은 사용자 몫입니다.

요약

Microsoft 에이전트 프레임워크는 .NET 팀이 프로덕션 AI 애플리케이션을 구축하기 위한 안정적 기반을 찾는 순간에 도달한, 회사의 AI-에이전트 작업의 신뢰할 수 있는 통합입니다. 그것의 가장 중요한 프레임링은 또한 가장 간과되고 있습니다: 에이전트는 실제 일을 수행하는 함수와 라이브러리 주위에 포장될 때 가장 유용합니다.

라이브러리 팀에게는, 그것이 우리가 기다려 왔던 자리입니다.