AWS Partner Central API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 [AWS Partner Central API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ツールリファレンス
Partner Central Agent MCP Server は、`sendMessage`すべてのエージェントインタラクションとセッション状態の取得`getSession`の 2 つの MCP ツールを公開します。Partner Central のすべてのオペレーション — オポチュニティクエリ、資金調達アプリケーション、ドキュメント分析 — は、 を介して自然言語で処理されます`sendMessage`。
## ツールの概要
| ツール | 説明 | カテゴリ |
| --- | --- | --- |
| sendMessage | Partner Central AI エージェントにメッセージを送信します。テキスト、ファイル添付ファイル、ヒューhuman-in-the-loop承認レスポンスをサポートします。 | 読み取り/書き込み |
| getSession | 会話履歴、イベント、メタデータを含むセッション状態を取得します。 | [Read-only] |
## `sendMessage`
すべての Partner Central AI エージェントとのやり取りのためのプライマリツール。このツールを使用して、質問をしたり、アクションをリクエストしたり、分析用のドキュメントをアタッチしたり、書き込みオペレーションの承認リクエストに応答したりできます。
エージェントはセッション内で会話コンテキストを保持するため、以前のコンテキストを繰り返すことなくフォローアップの質問をすることができます。
### パラメータ
+ `content` (必須) — コンテンツブロックの配列。各ブロックには、ブロック構造を決定する`type`フィールドを含める必要があります。1 つのメッセージ (テキストとドキュメントの添付ファイルなど) に複数のブロックを含めることができます。
コンテンツブロックタイプ:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/partner-central/latest/developer-guide/mcp-tools-reference.html)
+ `catalog` (必須) — オペレーションのターゲット環境。
有効な値: `"AWS"` (本番稼働用）、 `"Sandbox"` (テスト用)
+ `sessionId` (オプション) — 続行する既存のセッションを識別する UUID v4。を省略して新しいセッションを作成します。形式: `session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`。
デフォルト: 新しいセッションが自動的に作成されます。
+ `stream` (オプション) — リアルタイムレスポンス配信のサーバー送信イベント (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.75 MB
+ ドキュメントサイズ制限: 4.5 MB
+ 許可される拡張機能: `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"`
### [応答]
| フィールド | タイプ | 説明 |
| --- | --- | --- |
| sessionId | string | セッション識別子 |
| createdAt | string | セッション作成の ISO 8601 タイムスタンプ |
| lastActivity | string | 最後のアクティビティの ISO 8601 タイムスタンプ |
| sequenceNumber | 整数 | 現在のイベントシーケンス番号 |
| stateType | string | 現在のセッション状態 |
| events | array | 完全な会話履歴 (ユーザーメッセージ、エージェントレスポンス、ツールの使用) |
| 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."
}
}
```
エラーコードとその意味の完全なリスト[エラーコード](mcp-configuration-reference.md#mcp-config-error-codes)については、「」を参照してください。
**推奨される再試行戦略**
+ `-32004` (LIMIT\_EXCEEDED): 1 秒から指数バックオフで再試行する
+ `-32603` (INTERNAL\_ERROR): エクスポネンシャルバックオフで最大 3 回再試行する
+ `-32001` (AUTHENTICATION\_FAILURE): 認証情報を更新して再試行する
+ その他のすべてのエラーの場合: 自動的に再試行しないでください — エラーメッセージを調べてリクエストを修正します