Admin API로 커스텀 에이전트 관리하기

엔터프라이즈 요금제의 관리자라면 Admin API를 사용하여 워크스페이스의 커스텀 에이전트를 관리할 수 있습니다. 에이전트별로 설정을 일일이 클릭하는 대신, 팀에서 에이전트 및 사용 정보를 자체 도구로 가져와 여러 에이전트에 동일한 규칙을 한꺼번에 적용할 수 있습니다. Admin API는 조직 소유의 관리자 토큰을 사용하는 엔터프라이즈 조직 관리자만 사용할 수 있습니다.

• 워크스페이스의 커스텀 에이전트 전체 보기. 각 에이전트를 누가 만들었는지, 활성 상태인지, 어떤 모델을 사용하는지, 마지막으로 언제 실행되었는지, 무엇에 사용 권한이 있는지 등 모든 에이전트 리스트를 확인하세요.

• 커스텀 에이전트 사용 권한 추적. 에이전트의 공유 권한을 업데이트하세요.

• 크레딧 사용 추적. 각 에이전트가 사용한 크레딧을 확인하고 크레딧 사용 추적을 일괄적으로 하세요.

• 크레딧 한도 설정. 단일 에이전트에 대한 크레딧 한도를 설정하거나 변경하고, 모든 커스텀 에이전트에 대한 워크스페이스 기본값을 설정하세요.

• 에이전트 생성 권한 선택. 워크스페이스의 에이전트 생성 정책을 설정하고, 필요에 따라 워크스페이스 전체의 모든 에이전트를 일시정지하세요.

• 에이전트 켜기 또는 끄기. 특정 에이전트의 설정을 삭제하지 않고 실행을 중지했다가 나중에 다시 켤 수 있습니다.

• 에이전트 삭제. 에이전트 사용을 중단합니다. 설정은 유지되므로 필요할 때 복구할 수 있습니다.

• 엔터프라이즈 요금제로 워크스페이스를 이용해야 합니다.

• Admin API는 개인 통합 토큰이 아닌 조직에서 설정한 조직 수준의 관리자 사용 권한을 사용합니다. 설정 단계는 개발자 문서 →를 참조하세요.

Admin API가 수행하는 모든 작업에는 Notion에서 해당하는 제어 기능이 있습니다.

• 에이전트 디렉터리(설정 → Notion AI → 에이전트)에서 워크스페이스의 에이전트를 확인하고 관리할 수 있습니다.

• Notion 크레딧 대시보드에서 에이전트 크레딧 사용량을 확인할 수 있습니다.

• 생성 제어 설정을 통해 에이전트 생성 권한을 지정할 수 있습니다.

1회성 변경에는 설정을 사용하세요. 이러한 작업을 자동화하거나, 여러 에이전트를 한꺼번에 관리하거나, 사용 데이터를 자체 리포트 도구로 가져와야 할 때는 Admin API를 사용하세요.

• 크레딧 사용량을 내부 보고서로 가져와 각 팀이 커스텀 에이전트 비용을 확인할 수 있도록 하세요.

• 여러 에이전트에 동일한 제한이나 규칙을 한 번에 적용하세요.

• 계속 유지해야 하는 에이전트의 소유권을 이전하세요. 더 이상 필요하지 않은 에이전트는 끄거나 삭제하세요.