[이 문서는 시험판 설명서이며 변경될 수 있습니다.]
사용자는 메시지에 파일을 첨부하여 에이전트가 해당 턴에 대해 읽거나 요약하거나 추론할 수 있도록 할 수 있습니다. 첨부파일은 사용자가 턴별로 입력하는 것이지, 매커가 지속적으로 설정한 데이터 소스가 아닙니다.
메모
이 글의 기능은 사용량 기반 청구를 위해 Copilot 크레딧을 사용하는 GitHub Copilot 하네스를 기반으로 합니다. GitHub Copilot 하네스로 구동되는 에이전트 청구 개요에서 Copilot 크레딧에 대해 더 알아보세요.
사용량 기반 청구는 에이전트를 사용, 구축, 테스트, 평가하는 데 적용됩니다. 이러한 행동은 Copilot 크레딧을 소모할 수 있습니다.
첨부 자료와 지식 소스
부착물과 지식 원천 은 서로 다른 개념입니다. 자신의 상황에 맞는 것을 선택하세요.
| Concept | 누가 그것을 제공하는지요 | Scope | 일반적인 용도 |
|---|---|---|---|
| 첨부 | 최종 사용자, 메시지별 | 하나의 대화 | "이 계약서를 요약해봐", "이 스크린샷에 뭐가 있지?" |
| 지식 출처 | 제작자, 설계 단계에서 | 에이전트와의 모든 대화 | 정책 문서, 제품 카탈로그, 도움말 기사 |
에이전트가 항상 같은 콘텐츠에 접근할 수 있어야 할 때 지식 소스를 추가하세요. 요청에 고유한 내용일 때 사용자에게 파일을 첨부하도록 요청하세요.
지원되는 첨부 파일 형식
| 유형 | 예제 | 비고 |
|---|---|---|
| Images | .png, .jpg, .gif, .webp | 에이전트는 시각 능력이 있는 모델을 사용하여 이미지에 대한 설명이나 질문에 답합니다. |
| PDF 파일들 | 텍스트가 추출되어 에이전트가 추론할 수 있습니다. | |
| 텍스트 문서 | .txt, .csv, .html, .md | 콘텐츠는 텍스트 형태로 에이전트에게 전달됩니다. |
| URL들 | 공개적으로 접근 가능한 HTTP 또는 HTTPS URL | 에이전트는 현재 턴의 링크된 파일을 다운로드합니다(이 글 후반부의 URL 다운로드 동작 참조). |
사용자가 파일을 첨부하는 곳
사용자는 에이전트가 실행되는 어떤 표면에도 파일을 첨부할 수 있습니다:
- 에이전트를 테스트할 때 사용하는 Copilot Studio의 미리보기 탭입니다. 더 알아보려면 에이전트 테스트에서 확인하세요.
- 첨부파일을 지원하는 공개된 채널, 예를 들어 Microsoft Teams, Microsoft 365 Copilot, 웹 채팅 등이 있습니다.
사용자는 메시지 작성기에서 첨부 아이콘을 선택하고, 하나 이상의 파일을 선택한 뒤 선택적 메시지를 추가한 뒤 차례를 보냅니다. 에이전트는 첨부파일과 메시지를 함께 받습니다.
에이전트가 애착을 처리하는 방식
- 에이전트는 메시지를 처리할 때 각 첨부파일을 읽습니다. 첨부 파일은 해당 파일을 보낸 턴에만 영향을 미치며, 같은 대화에서 나중에 에이전트가 이를 다시 참조하는 경우는 예외입니다.
- 첨부파일이 처리되지 않는 경우(예: 유효하지 않은 파일이나 URL 다운로드 실패), 에이전트는 첨부파일을 건너뛰고 나머지 메시지를 처리합니다. 메시지는 여전히 전송되었습니다.
- 첨부파일은 지식 원천, 기억, 도구 출력을 대체하지 않습니다. 그것들은 요원이 현재 턴에서 고려하는 또 다른 신호입니다.
URL 첨부 파일
사용자가 URL을 첨부하면, 에이전트는 해당 URL의 파일을 다운로드하여 해당 턴에 업로드된 첨부파일처럼 처리합니다.
- 다운로드는 30초 이내에 완료되어야 합니다. 응답이 느리면 타임아웃이 발생하고, 그 턴에는 URL이 건너뛸 수 있습니다.
- URL은 Microsoft 서비스에서 공개적으로 접근 가능해야 합니다. 로그인이 필요하거나 방화벽 뒤에 있는 링크는 작동하지 않습니다.
- URL 다운로드가 실패해도 메시지는 계속 전송됩니다.
보존 및 제한
첨부 파일은 현재 턴에만 저장되는 것이 아니라 대화가 유지되는 전체 기간 동안 저장됩니다. 사용자가 대화 초반에 파일을 첨부했다면, 에이전트는 이후 턴에 다시 참조할 수 있습니다(예: "이전에 보낸 파일과 비교해 보세요").
| 항목 | Limit |
|---|---|
| 첨부 파일 크기(파일당) | 16 MiB |
| URL 첨부 파일 다운로드 시간 초과 | 30초 |
| 첨부 파일 보존 (대화별) | 대화의 마지막 활동 후 28일 |
| 실패 시 애착 행동 | 에이전트는 실패한 첨부 파일을 건너뛰고 메시지를 계속 처리합니다 |
보존 기간이 지나면 저장된 첨부파일은 대화에서 삭제되어 에이전트가 더 이상 참조할 수 없습니다. 이 동일한 보존 기간은 상담원이 대화 중에 생성하는 모든 파일에 적용됩니다.