Autopilot 메모리를 사용하면 Autopilot 이(가) 대화 전반에 걸쳐 컨텍스트를 유지하고 저장된 컨텍스트를 읽고, 생성하고, 업데이트하거나 삭제할 수 있는 사람을 제어할 수 있습니다.
기본 메모리 액세스
뉴렐릭은 다음 표준 역할을 통해 메모리에 대한 기본 액세스를 제공합니다:
계정 범위의 액세스
동작 | 필수 역할 |
|---|
메모리 읽기 | 읽기 전용, 표준 사용자 또는 전체 사용자(모든 사용자 티어) |
메모리 생성 또는 수정 | 모든 제품 관리자 |
메모리 삭제 | 모든 제품 관리자 |
조직 범위 액세스
동작 | 필수 역할 |
|---|
조직 전체의 메모리 읽기 | 조직 읽기 전용, 조직 관리자 또는 조직 제품 관리자 |
조직 전체의 메모리 생성 또는 수정 | 조직 관리자 |
조직 전체의 메모리 삭제 | 조직 관리자 |
기본 권한이 조직의 요구 사항을 충족하지 않는 경우 사용자 지정 역할이 필요할 수 있습니다.
메모리 기능
메모리에 대한 사용자 지정 역할을 빌드할 때 아래 권한을 사용합니다.
계정 범위 기능
능력 | 권한 식별자 |
|---|
메모리 읽기 | context_management.read.memory
|
메모리 생성 및 업데이트 | context_management.modify.memory
|
메모리 삭제 | context_management.delete.memory
|
조직 범위 기능
능력 | 권한 식별자 |
|---|
조직 전체의 메모리 읽기 | context_management_org_scoped.read.memory
|
조직 전체의 메모리 생성 및 업데이트 | context_management_org_scoped.modify.memory
|
조직 전체의 메모리 삭제 | context_management_org_scoped.delete.memory
|
전제 조건
시작하기 전에 다음 사항을 확인하세요.
NerdGraph API를 통해 사용자 지정 역할 생성
다음의 각 API 호출은 메모리에 대한 사용자 지정 역할을 생성하고 할당하는 작업의 한 부분을 처리합니다. 입력 파라미터와 샘플 요청 및 응답을 확인하려면 각각을 확장하세요.
customerAdministration 쿼리를 사용하여 기능 목록, 해당 권한 ID 및 관련 정보를 검색합니다. 기능별로 필터링하여 메모리 권한을 가져옵니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 설명 |
|---|
eq
(필수의) | 문자열 | 일치하는 권한을 검색하려면 값을 Memory
(계정 범위) 또는 Memory For Organization
(조직 범위)로 설정합니다. |
샘플 요청 ― 계정 범위
permissions(filter: { feature: { eq: "Memory" } }) {
샘플 응답
"customerAdministration": {
"product": "New Relic AI"
"product": "New Relic AI"
"product": "New Relic AI"
조직 범위 권한 ID(조직용 메모리에 대한 READ, MODIFY, DELETE)를 검색하려면 feature: { eq: "Memory For Organization" } 을(를) 사용하여 동일한 쿼리를 실행합니다.
응답에서 부여하려는 액세스 수준과 일치하는 feature 이(가) Memory 또는 Memory For Organization인 권한 ID를 복사합니다. 사용자 지정 역할을 생성하려면 이 ID가 필요합니다.
이후 뮤테이션에서 사용할 조직 ID를 검색합니다. 계정 범위 역할의 경우 계정 ID도 검색합니다.
샘플 요청
샘플 응답
"id": "YOUR_ORGANIZATION_ID"
"name": "Your Account Name"
응답에서 필요한 ID를 복사합니다. 사용자 지정 역할을 생성하는 데 사용합니다.
customRoleCreate 뮤테이션을 사용하여 메모리 관리를 위한 사용자 정의 역할을 생성합니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 설명 |
|---|
id
(필수의) | 문자열 | 이전 호출의 조직 ID(조직 범위) 또는 계정 ID(계정 범위)입니다. |
type
(필수의) | 문자열 | 조직 범위 역할의 경우 organization
(으)로 설정하고, 계정 범위 역할의 경우 account
(으)로 설정합니다. |
name
(필수의) | 문자열 | 사용자 지정 역할의 표시 이름입니다. |
permissionIds
(필수의) | 정수 배열 | 위에서 식별된 메모리 권한 ID입니다. |
scope
(필수의) | 문자열 | type
에 맞춰 organization
또는 account
로 설정합니다. |
샘플 요청 ― 계정 범위 역할
container: { id: "YOUR_ACCOUNT_ID", type: "account" }
permissionIds: [xxxxx, xxxxx]
샘플 요청 ― 조직 범위 역할
container: { id: "YOUR_ORGANIZATION_ID", type: "organization" }
name: "Memory manager (org-wide)"
permissionIds: [xxxxx, xxxxx]
샘플 응답
반환된 역할 ID를 저장합니다 ― 이 역할을 사용자 그룹에 할당하려면 이 ID가 필요합니다.
사용자 지정 역할을 생성한 후 사용자 그룹에 할당합니다.
그룹 ID 검색
customerAdministration 쿼리를 사용하여 사용 가능한 사용자 그룹 목록을 가져옵니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 설명 |
|---|
id
(필수의) | 문자열 | 귀하의 조직 ID입니다. |
샘플 요청
groups(filter: { organizationId: { eq: "YOUR_ORGANIZATION_ID" } }) {
응답에서 메모리 역할을 할당하려는 그룹의 그룹 ID를 복사합니다.
그룹에 역할을 할당합니다.
authorizationManagementGrantAccess 변형을 사용하여 사용자 그룹에 사용자 정의 역할을 할당합니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 설명 |
|---|
roleId
(필수의) | 문자열 | 이전 호출의 사용자 정의 역할 ID입니다. |
groupId
(필수의) | 문자열 | 위에서 조회한 그룹 ID입니다. |
샘플 요청 ― 계정 범위 역할
authorizationManagementGrantAccess(
accountId: "YOUR_ACCOUNT_ID"
샘플 요청 ― 조직 범위 역할
authorizationManagementGrantAccess(
grantAccessOptions: { organizationAccessGrants: { roleId: "YOUR_ROLE_ID" } }
샘플 응답
"authorizationManagementGrantAccess": {
"displayName": "Memory manager",
"name": "memory_manager",
"organizationId": "YOUR_ORGANIZATION_ID",
Autopilot 메모리에 대한 자세한 내용은 Autopilot 메모리를 참조하세요.