Rufen Sie den Endpunkt auf - Amazon SageMaker
AnforderungAntwort

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.

Rufen Sie den Endpunkt auf

Nachdem der Endpunkt ausgeführt wurde, verwenden Sie die SageMaker Runtime InvokeEndpointAPIim SageMaker Runtime-Dienst, um Anfragen an den Endpunkt zu senden oder ihn aufzurufen. Als Antwort darauf werden die Anfragen vom Clarify-Erklärer als Erklärungsanfragen behandelt. SageMaker

Anmerkung

Wählen Sie eine der folgenden Optionen aus, um einen Endpunkt aufzurufen:

Anforderung

Der InvokeEndpoint API hat einen optionalen ParameterEnableExplanations, der dem Header zugeordnet ist. HTTP X-Amzn-SageMaker-Enable-Explanations Wenn dieser Parameter angegeben wird, überschreibt er den EnableExplanations-Parameter von ClarifyExplainerConfig.

Anmerkung

Die Accept Parameter ContentType und von InvokeEndpoint API sind erforderlich. Zu den unterstützten Formaten gehören MIME Typ text/csv undapplication/jsonlines.

Verwenden Sie den sagemaker_runtime_client, um wie folgt eine Anfrage an den Endpunkt zu senden:

response = sagemaker_runtime_client.invoke_endpoint(
    EndpointName='name-of-your-endpoint',
    EnableExplanations='`true`',
    ContentType='text/csv',
    Accept='text/csv',
    Body='1,2,3,4',  # single record (of four numerical features)
)

Bei Endpunkten mit mehreren Modellen übergeben Sie in der vorherigen Beispielanforderung einen zusätzlichen TargetModel Parameter, der angibt, auf welches Modell der Endpunkt ausgerichtet werden soll. Der Multimodell-Endpunkt lädt Zielmodelle nach Bedarf dynamisch. Weitere Informationen zu Endpunkten mit mehreren Modellen finden Sie unter. Multimodell-Endpunkte Im Beispielnotizbuch SageMaker Clarify Online Explainability on Multi-Model Endpoint finden Sie ein Beispiel dafür, wie Sie mehrere Zielmodelle von einem einzigen Endpunkt aus einrichten und aufrufen können.

Antwort

Wenn der Endpunkt mit ExplainerConfig erstellt wird, wird ein neues Antwortschema verwendet. Dieses neue Schema unterscheidet sich von einem Endpunkt, für den der angegebene ExplainerConfig-Parameter fehlt und nicht mit diesem kompatibel ist.

Der MIME Typ der Antwort istapplication/json, und die Nutzlast der Antwort kann von -8 Byte bis UTF zu einem Objekt dekodiert werden. JSON Die folgende Abbildung zeigt, dass die Mitglieder dieses JSON Objekts wie folgt sind:

  • version: Die Version des Antwortschemas im Zeichenfolgeformat. Beispiel, 1.0.

  • predictions: Die Vorhersagen, die die Anfrage macht, haben folgende Eigenschaften:

    • content_type: Der MIME Typ der Vorhersagen, die sich auf die Antwort ContentType des Modellcontainers beziehen.

    • data: Die Datenzeichenfolge mit den Vorhersagen, die als Nutzlast der Antwort des Modellcontainers für die Anfrage geliefert wurde.

  • label_headers: Die Label-Header des LabelHeaders-Parameters. Dies wird entweder in der Erklärkonfiguration oder in der Ausgabe des Modellcontainers bereitgestellt.

  • explanations: Die Erläuterungen finden Sie in der Anforderungsnutzlast. Wenn keine Datensätze erklärt werden, gibt dieses Mitglied das leere Objekt {} zurück.

    • kernel_shap: Ein Schlüssel, der sich auf eine Reihe von SHAP Kernel-Erklärungen für jeden Datensatz in der Anfrage bezieht. Wenn ein Datensatz nicht erklärt wird, ist die entsprechende Erklärung null.

Das kernel_shap-Element hat die folgenden Mitglieder:

  • feature_header: Der Header-Name der Funktionen, die durch den FeatureHeaders-Parameter in der Erklärkonfiguration ExplainerConfig bereitgestellt werden.

  • feature_type: Der Feature-Typ, der vom Erklärer abgeleitet oder im FeatureTypes-Parameter in der ExplainerConfig angegeben wurde. Dieses Element ist nur für NLP Erklärbarkeitsprobleme verfügbar.

  • attributions: Eine Reihe von Zuordnungsobjekten. Textmerkmale können mehrere Zuordnungsobjekte haben, jedes für eine Einheit. Das Zuordnungsobjekt hat die folgenden Mitglieder:

    • attribution: Eine Liste von Wahrscheinlichkeitswerten, die für jede Klasse angegeben ist.

    • description: Die Beschreibung der Texteinheiten, nur für NLP Erklärbarkeitsprobleme verfügbar.

      • partial_text: Der Teil des Textes, der vom Erklärer erklärt wurde.

      • start_idx: Ein auf Null basierender Index zur Identifizierung der Array-Position am Anfang des partiellen Textfragments.