도구 참조

파트너 중앙 에이전트 MCP 서버는 sendMessage 모든 에이전트 상호 작용과 세션 상태 getSession 검색이라는 두 가지 MCP 도구를 제공합니다. 기회 쿼리, 자금 지원 애플리케이션, 문서 분석 등 모든 Partner Central 운영은를 통해 자연어를 통해 처리됩니다sendMessage.

도구 개요

도구	설명	카테고리
`sendMessage`	Partner Central AI 에이전트에게 메시지를 전송합니다. 텍스트, 파일 첨부 파일 및 human-in-the-loop 승인 응답을 지원합니다.	읽기/쓰기
`getSession`	대화 기록, 이벤트 및 메타데이터를 포함한 세션 상태를 검색합니다.	읽기 전용

`sendMessage`

모든 Partner Central AI 에이전트 상호 작용을 위한 기본 도구입니다. 이 도구를 사용하여 질문하고, 작업을 요청하고, 분석할 문서를 첨부하고, 쓰기 작업에 대한 승인 요청에 응답할 수 있습니다.

에이전트는 세션 내에서 대화 컨텍스트를 유지하므로 이전 컨텍스트를 반복하지 않고도 후속 질문을 할 수 있습니다.

파라미터

content (필수) - 콘텐츠 블록의 배열입니다. 각 블록에는 블록 구조를 결정하는 type 필드가 포함되어야 합니다. 단일 메시지(예: 텍스트 + 문서 첨부 파일)에 여러 블록을 포함할 수 있습니다.

콘텐츠 블록 유형:

유형	필드	설명
`text`	`type` (필수), `text` (필수)	에이전트에게 전송된 사용자 메시지 텍스트
`document`	`type` (필수), `filename` (필수), `s3Uri` (필수)	에이전트가 분석할 파일 첨부 파일입니다. 에는 `versionId` 파라미터가 포함되어야 `s3Uri` 합니다.
`tool_approval_response`	`type` (필수), `toolUseId` (필수), `decision` (필수), `message` (선택 사항)	human-in-the-loop 승인 요청에 대한 응답

catalog (필수) - 작업의 대상 환경입니다.

유효한 값: "AWS" (프로덕션), "Sandbox" (테스트)
sessionId (선택 사항) - 계속할 기존 세션을 식별하는 UUID v4입니다. 새 세션을 생성하려면 생략합니다. 형식: session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

기본값: 새 세션이 자동으로 생성됩니다.
stream (선택 사항) - 실시간 응답 전송을 위해 Server-Sent Events(SSE) 스트리밍을 활성화합니다.

유효값: true, false

기본값: false

응답

응답에는 다음이 포함됩니다.

필드	설명
`sessionId`	후속 메시지의 세션 식별자
`status`	응답 상태: `"complete""requires_approval"`, 또는 `"error"`
`content`	에이전트의 응답 콘텐츠 블록 배열

예제

기본 문자 메시지(새 세션)

요청:


{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "content": [
                {
                    "type": "text",
                    "text": "List my open opportunities with expected close date in Q1 2026"
                }
            ],
            "catalog": "AWS"
        }
    }
}

응답:


{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "I found 12 open opportunities with expected close dates in Q1 2026. Here's a summary:\n\n1. **O1234567890** - Acme Corp Cloud Migration - $250,000 - Qualified stage\n2. **O1234567891** - GlobalTech Data Analytics - $180,000 - Prospect stage\n..."
            }
        ],
        "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
        "status": "complete"
    }
}

후속 메시지(기존 세션)

요청:


{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "text",
                    "text": "Tell me more about O1234567890. Is it ready for submission?"
                }
            ],
            "catalog": "AWS"
        }
    }
}

파일 첨부 파일

먼저 S3에 문서를 업로드한 다음 메시지에서 참조합니다.


{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "text",
                    "text": "Review this customer proposal and suggest which opportunity it aligns with"
                },
                {
                    "type": "document",
                    "filename": "acme-proposal.pdf",
                    "s3Uri": "s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/acme-proposal.pdf?versionId=abc123def456"
                }
            ],
            "catalog": "AWS"
        }
    }
}

파일 업로드 제약 조건:

메시지당 최대 3개의 파일
이미지 크기 제한: 3.75MB
문서 크기 제한: 4.5MB
허용되는 확장: doc, docx, pdf, png, jpeg, xlsx, csv, txt
파일을에 업로드해야 합니다. s3://{bucket}/{your-aws-account-id}/
S3 URI에는 versionId 쿼리 파라미터가 포함되어야 합니다.

Human-in-the-loop 승인 워크플로

에이전트가 쓰기 작업을 수행해야 하는 경우(예: 기회 업데이트, 자금 지원 애플리케이션 제출) 제안된 작업 세부 정보가 포함된 "requires_approval" 상태를 반환합니다. tool_approval_response 콘텐츠 블록으로 응답해야 합니다.

1단계 - 에이전트가 승인을 요청합니다.


{
    "jsonrpc": "2.0",
    "id": 4,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "I'd like to update opportunity O1234567890 with the following changes:\n- Target close date: 2026-03-31\n- Expected revenue: $300,000\n- Stage: Qualified\n\nPlease approve, reject, or override this action."
            },
            {
                "type": "tool_approval_request",
                "toolUseId": "tool-use-98765",
                "toolName": "update_opportunity_enhanced",
                "parameters": {
                    "opportunityId": "O1234567890",
                    "targetCloseDate": "2026-03-31",
                    "expectedRevenue": 300000,
                    "stage": "Qualified"
                }
            }
        ],
        "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
        "status": "requires_approval"
    }
}

2단계 - 작업 승인:


{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "tool_approval_response",
                    "toolUseId": "tool-use-98765",
                    "decision": "approve"
                }
            ],
            "catalog": "AWS"
        }
    }
}

2단계(대안) - 작업 거부:


{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "tool_approval_response",
                    "toolUseId": "tool-use-98765",
                    "decision": "reject",
                    "message": "The expected revenue should be $250,000, not $300,000"
                }
            ],
            "catalog": "AWS"
        }
    }
}

2단계(대안) - 사용자 지정 응답으로 재정의:


{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "tool_approval_response",
                    "toolUseId": "tool-use-98765",
                    "decision": "override",
                    "message": "Use expected revenue of $250,000 and keep the stage as Prospect instead"
                }
            ],
            "catalog": "AWS"
        }
    }
}

승인 결정 값:

결정	동작
`"approve"`	제안된 파라미터로 도구 실행
`"reject"`	도구를 실행하지 마십시오. 선택 사항으로 이유를 `message` 설명합니다.
`"override"`	를 통해 사용자 지정 응답 또는 수정된 지침 제공 `message`

SSE를 사용한 스트리밍

에이전트가 요청을 처리할 때 증분 응답 청크를 수신하도록 스트리밍을 활성화합니다.

요청:


{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
        "name": "sendMessage",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "content": [
                {
                    "type": "text",
                    "text": "Analyze my pipeline and identify opportunities at risk"
                }
            ],
            "catalog": "AWS",
            "stream": true
        }
    }
}

서버는 SSE 이벤트 스트림으로 응답합니다.


event: stream_start
data: {"sessionId": "session-550e8400-e29b-41d4-a716-446655440000"}

event: assistant-response.start
data: {}

event: server-tool-use
data: {"toolName": "analyze_pipeline", "parameters": {}}

event: server-tool-response
data: {"toolName": "analyze_pipeline", "result": {"opportunitiesAnalyzed": 47, "atRisk": 5}}

event: assistant-response.delta
data: {"text": "I analyzed your pipeline of 47 opportunities and identified "}

event: assistant-response.delta
data: {"text": "5 that are at risk of slipping:\n\n"}

event: assistant-response.delta
data: {"text": "1. **O2345678901** - Close date is past due by 15 days\n"}

event: assistant-response.completed
data: {"status": "complete"}

event: stream_end
data: {}

`getSession`

전체 대화 기록, 이벤트 및 메타데이터를 포함하여 대화 세션의 현재 상태를 검색합니다. 이를 사용하여 세션 상태를 검사하거나, 과거 상호 작용을 검토하거나, 대화를 재개할 수 있습니다.

파라미터

sessionId (필수) - 검색할 세션의 UUID입니다. 형식: session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
catalog (필수) - 세션이 속한 환경입니다.

유효값: "AWS", "Sandbox"

응답

Field	유형	설명
`sessionId`	문자열	세션 식별자
`createdAt`	문자열	세션 생성의 ISO 8601 타임스탬프
`lastActivity`	문자열	마지막 활동의 ISO 8601 타임스탬프
`sequenceNumber`	정수	현재 이벤트 시퀀스 번호
`stateType`	문자열	현재 세션 상태
`events`	배열	전체 대화 기록(사용자 메시지, 에이전트 응답, 도구 사용)
`variables`	객체	세션 변수 및 메타데이터
`eventCount`	정수	세션의 총 이벤트 수

예제

요청:


{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
        "name": "getSession",
        "arguments": {
            "sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
            "catalog": "AWS"
        }
    }
}

응답:


{
    "jsonrpc": "2.0",
    "id": 7,
    "result": {
        "content": [
            {
                "type": "text",
                "text": "{\"sessionId\":\"session-550e8400-e29b-41d4-a716-446655440000\",\"createdAt\":\"2026-01-15T10:30:00Z\",\"lastActivity\":\"2026-01-15T11:45:00Z\",\"sequenceNumber\":8,\"stateType\":\"END_TURN\",\"eventCount\":8,\"events\":[...],\"variables\":{}}"
            }
        ]
    }
}

오류 처리

모든 오류는 JSON-RPC 2.0 오류 형식을 따릅니다.


{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32001,
        "message": "Authentication failed. Verify your SigV4 credentials and ensure they have not expired."
    }
}

오류 코드의 전체 목록과 그 의미는 오류 코드 섹션을 참조하세요.

권장 재시도 전략

-32004 (LIMIT_EXCEEDED): 1초부터 지수 백오프를 사용하여 재시도
-32603 (INTERNAL_ERROR): 지수 백오프를 사용하여 최대 3회 재시도
-32001 (AUTHENTICATION_FAILURE): 자격 증명 새로 고침 및 재시도
다른 모든 오류의 경우: 자동으로 재시도하지 않음 - 오류 메시지를 검사하고 요청을 수정합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

구성 참조

APIs 정보