Créer des rôles personnalisés pour la mémoire Autopilot

Autopilot La mémoire permet à Autopilot de conserver le contexte d'une conversation à l'autre et de contrôler qui peut lire, créer, mettre à jour ou supprimer ce contexte stocké.

Accès par défaut à la mémoire

New Relic fournit un accès par défaut à la mémoire via ces rôles standards :

Accès au niveau du compte

Action	Rôle requis
Lire la mémoire	Lecture seule, Utilisateur standard ou Utilisateur complet (tout niveau d'utilisateur)
Créer ou modifier la mémoire	Administrateur de tous les produits
Supprimer la mémoire	Administrateur de tous les produits

Accès au niveau de l'organisation

Action	Rôle requis
Lire la mémoire à l’échelle de l’organisation	Lecture seule de l’organisation, Gestionnaire de l’organisation ou Administrateur de produit de l’organisation
Créer ou modifier la mémoire à l’échelle de l’organisation	Gestionnaire d'organisation
Supprimer la mémoire dans toute l’organisation	Gestionnaire d'organisation

Vous pourriez avoir besoin d'un rôle personnalisé si les permissions par défaut ne répondent pas aux besoins de votre organisation.

Capacités de mémoire

Lors de la création d’un rôle personnalisé pour la mémoire, utilisez les permissions ci-dessous.

Capacités au niveau du compte

Capacité	Identifiant de permission
Lire la mémoire	`context_management.read.memory`
Créer et mettre à jour la mémoire	`context_management.modify.memory`
Supprimer la mémoire	`context_management.delete.memory`

Capacités au niveau de l’organisation

Capacité	Identifiant de permission
Lire la mémoire à l’échelle de l’organisation	`context_management_org_scoped.read.memory`
Créer et mettre à jour la mémoire dans toute l'organisation	`context_management_org_scoped.modify.memory`
Supprimer la mémoire dans toute l’organisation	`context_management_org_scoped.delete.memory`

Prérequis

Avant de commencer, assurez-vous d’avoir :

Exigences générales de NerdGraph
Rôle de gestionnaire d'organisation, pour créer des rôles personnalisés

Conseil

Vous pouvez également créer un rôle personnalisé pour la mémoire via l'UI. Pour les permissions à sélectionner et la portée à utiliser, consultez Capacités de la mémoire.

Créer un rôle personnalisé via l'API NerdGraph

Chacun des appels d’API suivants gère une partie de la création et de l’attribution d’un rôle personnalisé pour la mémoire. Développez chacun d’eux pour voir ses paramètres d’entrée ainsi qu’un exemple de requête et de réponse.

Utilisez la requête customerAdministration pour récupérer une liste de capacités, leurs ID d’autorisation et les informations associées. Filtrez par fonctionnalité pour obtenir les autorisations de mémoire.

Paramètres d'entrée

paramètres	Type de données	Description
`eq` (Requis)	Chaîne	Définissez la valeur sur `Memory` (au niveau du compte) ou `Memory For Organization` (au niveau de l'organisation) pour récupérer les autorisations correspondantes.

paramètres

Type de données

Description

eq

(Requis)

Chaîne

Définissez la valeur sur

Memory

(au niveau du compte) ou

Memory For Organization

(au niveau de l'organisation) pour récupérer les autorisations correspondantes.

Exemple de requête — au niveau du compte

{
  customerAdministration {
    permissions(filter: { feature: { eq: "Memory" } }) {
      items {
        feature
        category
        id
        product
      }
    }
  }
}

Exemple de réponse

{
  "data": {
    "customerAdministration": {
      "permissions": {
        "items": [
          {
            "category": "READ",
            "feature": "Memory",
            "id": "xxxxx",
            "product": "New Relic AI"
          },
          {
            "category": "MODIFY",
            "feature": "Memory",
            "id": "xxxxxx",
            "product": "New Relic AI"
          },
          {
            "category": "DELETE",
            "feature": "Memory",
            "id": "xxxxxx",
            "product": "New Relic AI"
          }
        ]
      }
    }
  }
}

Exécutez la même requête avec feature: { eq: "Memory For Organization" } pour récupérer les identifiants d'autorisation au niveau de l'organisation (READ, MODIFY, DELETE pour la mémoire pour l'organisation).

À partir de la réponse, copiez les ID de permission où feature est Memory ou Memory For Organization, correspondant au niveau d’accès que vous souhaitez accorder. Vous aurez besoin de ces ID pour créer le rôle personnalisé.

Récupérez l’ID de votre organisation, que vous utiliserez dans les mutations ultérieures. Pour un rôle au niveau du compte, récupérez également l’ID du compte.

Demande d'échantillon

{
  actor {
    organization {
      id
    }
    accounts {
      id
      name
    }
  }
}

Exemple de réponse

{
  "data": {
    "actor": {
      "organization": {
        "id": "YOUR_ORGANIZATION_ID"
      },
      "accounts": [
        {
          "id": "YOUR_ACCOUNT_ID",
          "name": "Your Account Name"
        }
      ]
    }
  }
}

Copiez le ou les ID dont vous avez besoin à partir de la réponse. Vous les utiliserez pour créer le rôle personnalisé.

Utilisez la mutation customRoleCreate pour créer votre rôle personnalisé pour la gestion de la mémoire.

Paramètres d'entrée

paramètres	Type de données	Description
`id` (Requis)	Chaîne	L'ID de l'organisation (au niveau de l'organisation) ou l'ID du compte (au niveau du compte) de l'appel précédent.
`type` (Requis)	Chaîne	Définissez sur `organization` pour un rôle au niveau de l’organisation, ou sur `account` pour un rôle au niveau du compte.
`name` (Requis)	Chaîne	Le nom d'affichage du rôle personnalisé.
`permissionIds` (Requis)	Éventail d'entiers	Les ID d’autorisation de mémoire identifiés ci-dessus.
`scope` (Requis)	Chaîne	Définissez sur `organization` ou `account` , correspondant à `type` .

Exemple de requête — rôle au niveau du compte

mutation {
  customRoleCreate(
    container: { id: "YOUR_ACCOUNT_ID", type: "account" }
    name: "Memory manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "account"
  ) {
    id
  }
}

Exemple de requête — rôle au niveau de l'organisation

mutation {
  customRoleCreate(
    container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
    name: "Memory manager (org-wide)"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Exemple de réponse

{
  "data": {
    "customRoleCreate": {
      "id": 9999999
    }
  }
}

Enregistrez l'identifiant de rôle renvoyé — vous en aurez besoin pour attribuer ce rôle à un groupe d'utilisateurs.

Après avoir créé le rôle personnalisé, attribuez-le à un groupe d'utilisateurs.

Récupérer les ID de groupe

Utilisez la requête customerAdministration pour obtenir une liste des groupes d'utilisateurs disponibles.

Paramètres d'entrée

paramètres	Type de données	Description
`id` (Requis)	Chaîne	Votre identifiant d'organisation.

paramètres

Type de données

Description

id

(Requis)

Chaîne

Votre identifiant d'organisation.

Demande d'échantillon

{
  customerAdministration {
    groups(filter: { organizationId: { eq: "YOUR_ORGANIZATION_ID" } }) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

À partir de la réponse, copiez l’ID de groupe pour le groupe auquel vous souhaitez attribuer le rôle de mémoire.

Attribuer le rôle au groupe

Utilisez la mutation authorizationManagementGrantAccess pour attribuer le rôle personnalisé à un groupe d’utilisateurs.

Paramètres d'entrée

paramètres	Type de données	Description
`roleId` (Requis)	Chaîne	L’ID du rôle personnalisé de l’appel précédent.
`groupId` (Requis)	Chaîne	L'ID du groupe récupéré ci-dessus.

paramètres

Type de données

Description

roleId

(Requis)

Chaîne

L’ID du rôle personnalisé de l’appel précédent.

groupId

(Requis)

Chaîne

L'ID du groupe récupéré ci-dessus.

Exemple de requête — rôle au niveau du compte

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      accountAccessGrants: {
        accountId: "YOUR_ACCOUNT_ID"
        roleId: "YOUR_ROLE_ID"
      }
    }
    groupId: "YOUR_GROUP_ID"
  ) {
    roles {
      id
      name
      accountId
      roleId
      groupId
      displayName
    }
  }
}

Exemple de requête — rôle au niveau de l'organisation

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: { organizationAccessGrants: { roleId: "YOUR_ROLE_ID" } }
    groupId: "YOUR_GROUP_ID"
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Exemple de réponse

{
  "data": {
    "authorizationManagementGrantAccess": {
      "roles": [
        {
          "displayName": "Memory manager",
          "groupId": null,
          "id": "99999999",
          "name": "memory_manager",
          "organizationId": "YOUR_ORGANIZATION_ID",
          "roleId": 99999
        }
      ]
    }
  }
}

Pour plus d'informations sur la mémoire Autopilot, consultez Mémoire Autopilot.

Cette traduction automatique est fournie pour votre commodité.

Créer des rôles personnalisés pour la mémoire Autopilot

Accès par défaut à la mémoire

Accès au niveau du compte

Accès au niveau de l'organisation

Capacités de mémoire

Capacités au niveau du compte

Capacités au niveau de l’organisation

Prérequis

Conseil

Créer un rôle personnalisé via l'API NerdGraph

Rechercher les identifiants d'autorisation requis pour la mémoire

Récupérez votre identifiant d'organisation

Créer le rôle personnalisé

Ajouter le rôle personnalisé à un groupe d'utilisateurs

Cette traduction automatique est fournie pour votre commodité.

Créer des rôles personnalisés pour la mémoire Autopilot

Accès par défaut à la mémoire .css-21sua1{background:none;border:none;width:0;padding:0;}

Accès au niveau du compte

Accès au niveau de l'organisation

Capacités de mémoire

Capacités au niveau du compte

Capacités au niveau de l’organisation

Prérequis

Conseil

Créer un rôle personnalisé via l'API NerdGraph

Récupérez votre identifiant d'organisation

Créer le rôle personnalisé

Ajouter le rôle personnalisé à un groupe d'utilisateurs

Accès par défaut à la mémoire