Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der [AWS Partner Central API-Referenz. ](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Referenz zu Tools
Der Partner Central Agent MCP Server stellt zwei MCP-Tools zur Verfügung: `sendMessage` für alle Agenteninteraktionen und `getSession` für das Abrufen des Sitzungsstatus. Alle Vorgänge in Partner Central — Anfragen zu Geschäftschancen, Finanzierungsanträge, Dokumentenanalysen — werden in natürlicher Sprache über abgewickelt. `sendMessage`
## Überblick über die Tools
| Tool | Description | Kategorie |
| --- | --- | --- |
| sendMessage | Senden Sie Nachrichten an den Partner Central AI-Agenten. Unterstützt Text, Dateianhänge und Genehmigungsantworten, die von einem Mitarbeiter bearbeitet werden. | Lesen/Schreiben |
| getSession | Rufen Sie den Sitzungsstatus einschließlich Konversationsverlauf, Ereignissen und Metadaten ab. | Read-only |
## `Nachricht senden`
Primäres Tool für alle Interaktionen mit KI-Agenten in Partner Central. Verwenden Sie dieses Tool, um Fragen zu stellen, Aktionen anzufordern, Dokumente zur Analyse anzuhängen und auf Genehmigungsanfragen für Schreibvorgänge zu antworten.
Der Agent behält den Konversationskontext innerhalb einer Sitzung bei, sodass Sie Folgefragen stellen können, ohne den vorherigen Kontext wiederholen zu müssen.
### Parameters
+ `content`(erforderlich) — Eine Reihe von Inhaltsblöcken. Jeder Block muss ein `type` Feld enthalten, das die Blockstruktur bestimmt. Sie können mehrere Blöcke in eine einzelne Nachricht aufnehmen (z. B. Text und Dokumentanhang).
Typen von Inhaltsblöcken:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/partner-central/latest/developer-guide/mcp-tools-reference.html)
+ `catalog`(erforderlich) — Zielumgebung für den Vorgang.
Gültige Werte: `"AWS"` (Produktion), `"Sandbox"` (Testen)
+ `sessionId`(optional) — UUID v4, die eine bestehende Sitzung identifiziert, um fortzufahren. Lassen Sie es aus, um eine neue Sitzung zu erstellen. Format:`session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.
Standard: Eine neue Sitzung wird automatisch erstellt.
+ `stream`(optional) — Aktivieren Sie das Streaming von Server-Sent Ereignissen (SSE) für die Bereitstellung von Antworten in Echtzeit.
Zulässige Werte: `true`, `false`
Standard: `false`
### Antwort
Die Antwort enthält:
| Feld | Description |
| --- | --- |
| sessionId | Sitzungs-ID für Folgemeldungen |
| status | Antwortstatus:"complete","requires\_approval", oder "error" |
| content | Reihe von Antwortinhaltsblöcken vom Agenten |
### Beispiele
#### Einfache Textnachricht (neue Sitzung)
Anforderung:
```
{
"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"
}
}
}
```
Antwort:
```
{
"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"
}
}
```
#### Follow-up Nachricht (bestehende Sitzung)
Anforderung:
```
{
"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"
}
}
}
```
#### Dateianhang
Laden Sie zuerst ein Dokument auf S3 hoch und verweisen Sie dann in der Nachricht darauf:
```
{
"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"
}
}
}
```
Einschränkungen beim Hochladen von Dateien:
+ Maximal 3 Dateien pro Nachricht
+ Größenbeschränkung für Bilder: 3,75 MB
+ Größenbeschränkung für Dokumente: 4,5 MB
+ Zulässige Erweiterungen: `doc``docx`,`pdf`,`png`,`jpeg`,`xlsx`,`csv`, `txt`
+ Dateien müssen hochgeladen werden auf `s3://{bucket}/{your-aws-account-id}/`
+ Die S3-URI muss den `versionId` Abfrageparameter enthalten
### Human-in-the-loop Genehmigungsablauf
Wenn der Agent einen Schreibvorgang ausführen muss (z. B. eine Verkaufschance aktualisieren, einen Finanzierungsantrag einreichen), gibt er einen `"requires_approval"` Status mit den Details der vorgeschlagenen Aktion zurück. Sie müssen mit einem `tool_approval_response` Inhaltsblock antworten.
**Schritt 1 — Der Agent bittet um Genehmigung:**
```
{
"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"
}
}
```
**Schritt 2 — Genehmigen Sie die Aktion:**
```
{
"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"
}
}
}
```
**Schritt 2 (Alternative) — Die Aktion ablehnen:**
```
{
"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"
}
}
}
```
**Schritt 2 (Alternative) — Mit benutzerdefinierter Antwort überschreiben:**
```
{
"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"
}
}
}
```
Werte für die Genehmigungsentscheidung:
| Entscheidung | Behavior |
| --- | --- |
| "approve" | Führen Sie das Tool mit den vorgeschlagenen Parametern aus |
| "reject" | Führen Sie das Tool nicht aus. Optional message erklärt warum. |
| "override" | Geben Sie eine benutzerdefinierte Antwort oder geänderte Anweisungen über message |
### Streamen mit SSE
Aktivieren Sie Streaming, um inkrementelle Antwort-Chunks zu erhalten, während der Agent Ihre Anfrage bearbeitet:
Anforderung:
```
{
"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
}
}
}
```
Der Server antwortet mit einem Stream von SSE-Ereignissen:
```
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`
Ruft den aktuellen Status einer Konversationssitzung ab, einschließlich des vollständigen Konversationsverlaufs, der Ereignisse und der Metadaten. Verwenden Sie diese Option, um den Sitzungsstatus zu überprüfen, vergangene Interaktionen zu überprüfen oder eine Konversation fortzusetzen.
### Parameters
+ `sessionId`(erforderlich) — UUID der abzurufenden Sitzung. Format:. `session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
+ `catalog`(erforderlich) — Umgebung, zu der die Sitzung gehört.
Zulässige Werte: `"AWS"`, `"Sandbox"`
### Antwort
| Feld | Typ | Description |
| --- | --- | --- |
| sessionId | Zeichenfolge | Sitzungs-ID |
| createdAt | Zeichenfolge | ISO 8601-Zeitstempel der Sitzungserstellung |
| lastActivity | Zeichenfolge | ISO 8601-Zeitstempel der letzten Aktivität |
| sequenceNumber | Ganzzahl | Sequenznummer des aktuellen Ereignisses |
| stateType | Zeichenfolge | Aktueller Sitzungsstatus |
| events | Array | Vollständiger Konversationsverlauf (Benutzernachrichten, Antworten der Agenten, Verwendung des Tools) |
| variables | object | Sitzungsvariablen und Metadaten |
| eventCount | Ganzzahl | Gesamtzahl der Ereignisse in der Sitzung |
### Beispiel
Anforderung:
```
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "getSession",
"arguments": {
"sessionId": "session-550e8400-e29b-41d4-a716-446655440000",
"catalog": "AWS"
}
}
}
```
Antwort:
```
{
"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\":{}}"
}
]
}
}
```
## Fehlerbehandlung
Alle Fehler folgen dem JSON-RPC 2.0-Fehlerformat:
```
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32001,
"message": "Authentication failed. Verify your SigV4 credentials and ensure they have not expired."
}
}
```
Die [Fehlercodes](mcp-configuration-reference.md#mcp-config-error-codes) vollständige Liste der Fehlercodes und ihrer Bedeutung finden Sie unter.
**Empfohlene Wiederholungsstrategie**
+ Für `-32004` (LIMIT\_EXCEEDED): Wiederholen Sie den Vorgang mit exponentiellem Backoff ab 1 Sekunde
+ Für `-32603` (INTERNAL\_ERROR): Wiederholen Sie den Vorgang bis zu dreimal mit exponentiellem Backoff
+ Für `-32001` (AUTHENTICATION\_FAILURE): Anmeldeinformationen aktualisieren und erneut versuchen
+ Für alle anderen Fehler: Versuchen Sie es nicht automatisch erneut — überprüfen Sie die Fehlermeldung und korrigieren Sie die Anfrage