대화에 파일을 첨부하기 (미리보기)

[이 문서는 시험판 설명서이며 변경될 수 있습니다.]

사용자는 메시지에 파일을 첨부하여 에이전트가 해당 턴에 대해 읽거나 요약하거나 추론할 수 있도록 할 수 있습니다. 첨부파일은 사용자가 턴별로 입력하는 것이지, 매커가 지속적으로 설정한 데이터 소스가 아닙니다.

메모

이 글의 기능은 사용량 기반 청구를 위해 Copilot 크레딧을 사용하는 GitHub Copilot 하네스를 기반으로 합니다. GitHub Copilot 하네스로 구동되는 에이전트 청구 개요에서 Copilot 크레딧에 대해 더 알아보세요.

사용량 기반 청구는 에이전트를 사용, 구축, 테스트, 평가하는 데 적용됩니다. 이러한 행동은 Copilot 크레딧을 소모할 수 있습니다.

첨부 자료와 지식 소스

부착물과 지식 원천 은 서로 다른 개념입니다. 자신의 상황에 맞는 것을 선택하세요.

Concept 누가 그것을 제공하는지요 Scope 일반적인 용도
첨부 최종 사용자, 메시지별 하나의 대화 "이 계약서를 요약해봐", "이 스크린샷에 뭐가 있지?"
지식 출처 제작자, 설계 단계에서 에이전트와의 모든 대화 정책 문서, 제품 카탈로그, 도움말 기사

에이전트가 항상 같은 콘텐츠에 접근할 수 있어야 할 때 지식 소스를 추가하세요. 요청에 고유한 내용일 때 사용자에게 파일을 첨부하도록 요청하세요.

지원되는 첨부 파일 형식

유형 예제 비고
Images .png, .jpg, .gif, .webp 에이전트는 시각 능력이 있는 모델을 사용하여 이미지에 대한 설명이나 질문에 답합니다.
PDF 파일들 .pdf 텍스트가 추출되어 에이전트가 추론할 수 있습니다.
텍스트 문서 .txt, .csv, .html, .md 콘텐츠는 텍스트 형태로 에이전트에게 전달됩니다.
URL들 공개적으로 접근 가능한 HTTP 또는 HTTPS URL 에이전트는 현재 턴의 링크된 파일을 다운로드합니다(이 글 후반부의 URL 다운로드 동작 참조).

사용자가 파일을 첨부하는 곳

사용자는 에이전트가 실행되는 어떤 표면에도 파일을 첨부할 수 있습니다:

  • 에이전트를 테스트할 때 사용하는 Copilot Studio의 미리보기 탭입니다. 더 알아보려면 에이전트 테스트에서 확인하세요.
  • 첨부파일을 지원하는 공개된 채널, 예를 들어 Microsoft Teams, Microsoft 365 Copilot, 웹 채팅 등이 있습니다.

사용자는 메시지 작성기에서 첨부 아이콘을 선택하고, 하나 이상의 파일을 선택한 뒤 선택적 메시지를 추가한 뒤 차례를 보냅니다. 에이전트는 첨부파일과 메시지를 함께 받습니다.

Copilot Studio의 'Test your agent' 창에 있는 메시지 작성자 스크린샷과 첨부 아이콘이 보여요.

에이전트가 애착을 처리하는 방식

  • 에이전트는 메시지를 처리할 때 각 첨부파일을 읽습니다. 첨부 파일은 해당 파일을 보낸 턴에만 영향을 미치며, 같은 대화에서 나중에 에이전트가 이를 다시 참조하는 경우는 예외입니다.
  • 첨부파일이 처리되지 않는 경우(예: 유효하지 않은 파일이나 URL 다운로드 실패), 에이전트는 첨부파일을 건너뛰고 나머지 메시지를 처리합니다. 메시지는 여전히 전송되었습니다.
  • 첨부파일은 지식 원천, 기억, 도구 출력을 대체하지 않습니다. 그것들은 요원이 현재 턴에서 고려하는 또 다른 신호입니다.

URL 첨부 파일

사용자가 URL을 첨부하면, 에이전트는 해당 URL의 파일을 다운로드하여 해당 턴에 업로드된 첨부파일처럼 처리합니다.

  • 다운로드는 30초 이내에 완료되어야 합니다. 응답이 느리면 타임아웃이 발생하고, 그 턴에는 URL이 건너뛸 수 있습니다.
  • URL은 Microsoft 서비스에서 공개적으로 접근 가능해야 합니다. 로그인이 필요하거나 방화벽 뒤에 있는 링크는 작동하지 않습니다.
  • URL 다운로드가 실패해도 메시지는 계속 전송됩니다.

보존 및 제한

첨부 파일은 현재 턴에만 저장되는 것이 아니라 대화가 유지되는 전체 기간 동안 저장됩니다. 사용자가 대화 초반에 파일을 첨부했다면, 에이전트는 이후 턴에 다시 참조할 수 있습니다(예: "이전에 보낸 파일과 비교해 보세요").

항목 Limit
첨부 파일 크기(파일당) 16 MiB
URL 첨부 파일 다운로드 시간 초과 30초
첨부 파일 보존 (대화별) 대화의 마지막 활동 후 28일
실패 시 애착 행동 에이전트는 실패한 첨부 파일을 건너뛰고 메시지를 계속 처리합니다

보존 기간이 지나면 저장된 첨부파일은 대화에서 삭제되어 에이전트가 더 이상 참조할 수 없습니다. 이 동일한 보존 기간은 상담원이 대화 중에 생성하는 모든 파일에 적용됩니다.