Crear roles personalizados para la memoria de Autopilot

Autopilot La memoria permite a Autopilot retener el contexto en las conversaciones y controlar quién puede leer, crear, actualizar o eliminar ese contexto almacenado.

Acceso a memoria predeterminado

New Relic proporciona acceso predeterminado a la memoria a través de estos roles estándar:

Acceso con alcance de cuenta

Acción	Rol requerido
Leer memoria	Solo lectura, usuario estándar o usuario completo (cualquier nivel de usuario)
Crear o modificar memoria	Administrador de todos los productos
Eliminar memoria	Administrador de todos los productos

Acceso con alcance de organización

Acción	Rol requerido
Leer la memoria en toda la organización	Solo lectura de la organización, Administrador de la organización o Administrador de productos de la organización
Crear o modificar la memoria en toda la organización	Administrador de la organización
Eliminar memoria en toda la organización	Administrador de la organización

Es posible que necesite un rol personalizado si los permisos predeterminados no satisfacen las necesidades de su organización.

Capacidades de memoria

Al crear un rol personalizado para memoria, utilice los permisos a continuación.

Capacidades con alcance de cuenta

Capacidad	Identificador de permiso
Leer memoria	`context_management.read.memory`
Crear y actualizar memoria	`context_management.modify.memory`
Eliminar memoria	`context_management.delete.memory`

Capacidades con alcance de organización

Capacidad	Identificador de permiso
Leer la memoria en toda la organización	`context_management_org_scoped.read.memory`
Crear y actualizar memoria en toda la organización	`context_management_org_scoped.modify.memory`
Eliminar memoria en toda la organización	`context_management_org_scoped.delete.memory`

Requisitos previos

Antes de comenzar, cerciorar de tener:

Requisitos generales de NerdGraph
Rol de administrador de la organización, para crear roles personalizados

Sugerencia

También puede crear un rol personalizado para la memoria a través de la UI. Para conocer los permisos que debe seleccionar y el alcance que debe usar, consulte las capacidades de la memoria.

Crear un rol personalizado mediante la API de NerdGraph

Cada una de las siguientes llamadas API maneja una parte de la creación y asignación de un rol personalizado para la memoria. Expanda cada una para ver sus parámetros de entrada y la solicitud y respuesta de muestra.

Use la consulta customerAdministration para recuperar una lista de capacidades, sus ID de permisos e información relacionada. Filtre por característica para obtener los permisos de la memoria.

parámetro de entrada

Parámetro	Tipo de datos	Descripción
`eq` (Requerido)	Cadena	Establezca el valor en `Memory` (con alcance de cuenta) o `Memory For Organization` (con alcance de organización) para recuperar los permisos coincidentes.

Parámetro

Tipo de datos

Descripción

eq

(Requerido)

Cadena

Establezca el valor en

Memory

(con alcance de cuenta) o

Memory For Organization

(con alcance de organización) para recuperar los permisos coincidentes.

Ejemplo de solicitud — a nivel de cuenta

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

Ejemplo de respuesta

{
  "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"
          }
        ]
      }
    }
  }
}

Ejecuta la misma consulta con feature: { eq: "Memory For Organization" } para recuperar los ID de permisos a nivel de organización (READ, MODIFY, DELETE para memoria por organización).

De la respuesta, copia los ID de permiso donde feature sea Memory o Memory For Organization, que coincidan con el nivel de acceso que deseas otorgar. Necesitarás estos ID para crear el rol personalizado.

Recupera el ID de tu organización, que usarás en mutaciones posteriores. Para un rol con alcance de cuenta, recupera también el ID de la cuenta.

Solicitud de muestra

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

Ejemplo de respuesta

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

Copie los ID que necesita de la respuesta. Los usará para crear el rol personalizado.

Use la mutación customRoleCreate para crear su rol personalizado para la gestión de la memoria.

parámetro de entrada

Parámetro	Tipo de datos	Descripción
`id` (Requerido)	Cadena	El ID de la organización (ámbito de organización) o el ID de la cuenta (ámbito de cuenta) de la llamada anterior.
`type` (Requerido)	Cadena	Establézcalo en `organization` para un rol con alcance de organización o en `account` para un rol con alcance de cuenta.
`name` (Requerido)	Cadena	El nombre para mostrar del rol personalizado.
`permissionIds` (Requerido)	Matriz de números enteros	Los ID de permisos de la memoria identificados anteriormente.
`scope` (Requerido)	Cadena	Establezca en `organization` o `account` , que coincida con `type` .

Ejemplo de solicitud — rol con alcance de cuenta

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

Ejemplo de solicitud — rol con alcance de organización

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

Ejemplo de respuesta

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

Guarde el ID de rol devuelto —lo necesitará para asignar este rol a un grupo de usuarios.

Después de crear el rol personalizado, asígnelo a un grupo de usuarios.

Recuperar los ID de grupos

Emplee la consulta customerAdministration para obtener una lista de grupos de usuarios disponibles.

parámetro de entrada

Parámetro	Tipo de datos	Descripción
`id` (Requerido)	Cadena	ID de su organización.

Parámetro

Tipo de datos

Descripción

id

(Requerido)

Cadena

ID de su organización.

Solicitud de muestra

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

De la respuesta, copie el ID de grupo para el grupo al que desea asignar el rol de memoria.

Asigna el rol al grupo

Emplee la mutación authorizationManagementGrantAccess para asignar el rol personalizado a un grupo de usuarios.

parámetro de entrada

Parámetro	Tipo de datos	Descripción
`roleId` (Requerido)	Cadena	El ID del rol personalizado de la llamada anterior.
`groupId` (Requerido)	Cadena	El ID de grupo obtenido anteriormente.

Parámetro

Tipo de datos

Descripción

roleId

(Requerido)

Cadena

El ID del rol personalizado de la llamada anterior.

groupId

(Requerido)

Cadena

El ID de grupo obtenido anteriormente.

Ejemplo de solicitud — rol con alcance de cuenta

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

Ejemplo de solicitud — rol con alcance de organización

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

Ejemplo de respuesta

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

Para obtener más información sobre la memoria de Autopilot, consulta Memoria de Autopilot.

Te ofrecemos esta traducción automática para facilitar la lectura.

Crear roles personalizados para la memoria de Autopilot

Acceso a memoria predeterminado

Acceso con alcance de cuenta

Acceso con alcance de organización

Capacidades de memoria

Capacidades con alcance de cuenta

Capacidades con alcance de organización

Requisitos previos

Sugerencia

Crear un rol personalizado mediante la API de NerdGraph

Buscar los ID de permisos necesarios para la memoria

Recuperar el ID de su organización

Crear el rol personalizado

Agregar el rol personalizado a un grupo de usuarios

Te ofrecemos esta traducción automática para facilitar la lectura.

Crear roles personalizados para la memoria de Autopilot

Acceso a memoria predeterminado .css-21sua1{background:none;border:none;width:0;padding:0;}

Acceso con alcance de cuenta

Acceso con alcance de organización

Capacidades de memoria

Capacidades con alcance de cuenta

Capacidades con alcance de organización

Requisitos previos

Sugerencia

Crear un rol personalizado mediante la API de NerdGraph

Recuperar el ID de su organización

Crear el rol personalizado

Agregar el rol personalizado a un grupo de usuarios

Acceso a memoria predeterminado