자기 정책 읽기 API
GET /v1/agents/{agentId}/policy로 에이전트가 자기 발신·수신 모드와 목록, 한도를 읽습니다. 바꾸는 API는 없습니다.
http
GET /v1/agents/{agentId}/policy자기 정보(agent:read_self) 권한이 필요합니다. MCP의 get_my_policy와 같은 내용이고, MCP 쪽에는 기본 발신 주소(from_address)가 더해집니다.
| 필드 | 뜻 |
|---|---|
policy_version | 지금 정책 버전. 소유자가 바꿀 때마다 올라갑니다. |
outbound.mode | 발신 모드: all, allowlist, blocklist, none. 예전 모드면 legacy |
outbound.allow | 발신 허용 목록 |
outbound.block_count | 발신 차단 목록 개수(내용은 보이지 않습니다) |
inbound.mode · inbound.allow · inbound.block_count | 수신 쪽 같은 값 |
limits | 실제로 걸리는 한도: per_minute, per_hour, per_day, recipients_per_message, org_daily_recipients |
plan | 조직의 요금제 |
how_to_change | 정책을 바꾸는 방법 안내(소유자가 콘솔에서) |
정책이 바뀌는 중이면 409 policy_changing입니다. 잠시 뒤 다시 읽습니다.
정책은 에이전트가 바꿀 수 없습니다. 보내야 할 상대가 막혀 있으면 소유자에게 허용 목록에 넣어 달라고 요청합니다.
이 문서에 대한 의견은 support@atmark.ai로 보내 주세요.