Partager via

Vue d’ensemble de l’API de résumé des données (version préliminaire)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Les créateurs utilisent l’API de résumé Power Pages pour ajouter un résumé du contenu de la page avec l’IA générative. Cette fonctionnalité permet aux utilisateurs du site d’avoir un aperçu du contenu d’une page sans lire la page entière. L’API est basée sur l’API web Power Pages, qui fournit un résumé des données pour les tables Dataverse utilisées sur les pages.

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Prérequis

  • Activez les paramètres du site pour l’API web.
  • Seules les tables prises en charge par l’API web Power Pages sont disponibles pour le résumé. Pour en savoir plus sur l’API web Power Pages, consultez Vue d’ensemble de l’API web.
  • Cette fonctionnalité n’est pas disponible dans les régions Government Community Cloud (GCC), Government Community Cloud - High (GCC High) ou Department of Defense (DoD).

Paramètres du site

Activez les pages dans votre API web et définissez les paramètres du site suivants pour la fonctionnalité d’API de résumé.

Nom du paramètre du site Description
Résumé/Données/Activer Activez ou désactivez la fonctionnalité de résumé.
Par défaut : false
Valeurs valides : true, false
Résumé/invite/{any_identifier}

Utilisez ces paramètres pour fournir des instructions de synthèse.
Type : chaîne

Exemple :
Nom : Summarization/prompt/case_summary
Valeur : Résumer les détails clés et les informations critiques
Résumé/Données/ContentSizeLimit Modifiez la limite de la taille d’entrée pour le contenu du résumé.
Type : entier
Valeur par défaut : 100000 caractères

Schéma API

méthode URI Exemple JSON
PUBLICATION [URI du site]/_api/summarization/data/v1.0/tablesetname { "InstructionIdentifier":"", "RecommendationConfig":"" }
Nom de la propriété Description
InstructionIdentifier Cette propriété est facultative. Pour transmettre des instructions supplémentaires pour le résumé, utilisez les paramètres du site pour ajouter l’invite. Indiquez toujours le nom du paramètre de site tel qu’il a été défini précédemment.
RecommendationConfig Cette propriété est facultative. Utilisez cette propriété pour transmettre l’invite recommandée par l’API de résumé. La valeur doit être hachée et rester inchangée.

Nonte

L’API suit les spécifications Open Data Protocol (OData) standard prises en charge par l’API web Power Pages. L’API de résumé prend en charge toutes les opérations de lecture disponibles dans l’API web Power Pages.

Sample

Résumez le type de cas, le sujet, la description et l’historique du cas en mettant l’accent sur les détails clés et les informations importantes.

Demander

POST [Power Pages URL]/_api/summarization/data/v1.0/incidents(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)?$select=description,title&$expand=incident_adx_portalcomments($select=description)
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

Body:
{
"InstructionIdentifier": "Summarization/prompt/case_summary"
}

Response

HTTP/1.1 200 OK
OData-Version: 4.0
{
  "Summary": "The data results provide information…",
  "Recommendations": [
    {
      "Text": "would you like to know about…?",
      "Config": "HSYmaicakjvIwTFYeCIjKOyC7nQ4RTSiDJ+/LBK56r4="
    }
  ]
}

La réponse de résumé fournit des invites recommandées pour affiner le résumé. Pour utiliser ces recommandations, transmettez la valeur de configuration dans le corps de la demande sans la propriété InstructionIdentifier.

Sécurité

L’API de résumé respecte la sécurité basée sur les rôles configurée pour les autorisations de table et de colonne. Il ne prend en compte que les enregistrements auxquels l’utilisateur peut accéder pour le résumé.

Authentification de l’API de résumé

Il n’est pas nécessaire d’inclure un code d’authentification, car la session de l’application gère l’authentification et l’autorisation. Tous les appels de l’API web doivent inclure un jeton de falsification de requête intersites (CSRF).

Codes et messages d’erreur

Le tableau suivant décrit les différents codes et messages d’erreur que vous pouvez rencontrer lorsque vous utilisez l’API de résumé.

Code statut Code d'erreur Message d'erreur
400 90041001 Les fonctionnalités d’IA générative sont désactivées
400 90041003 Résumé des données désactivé pour ce site. Activez-le à l’aide des paramètres du site.
400 90041004 La longueur du contenu dépasse la limite
400 90041005 Aucun enregistrement à résumer n’a été trouvé
400 90041006 Une erreur s’est produite lors du résumé du contenu.

FAQ sur l’API de résumé des données

  • Last updated on