개요

요약

mplx agents 명령어를 사용하면 MPL Core 에셋에 에이전트 ID를 등록하고, Genesis 토큰을 연결하며, 실행 위임을 관리할 수 있습니다 — 모두 터미널에서 가능합니다.

• 도구: agents 명령어 그룹이 포함된 Metaplex CLI (mplx)
• ID: 각 에이전트 ID는 MPL Core 에셋으로부터 파생된 PDA로 저장됩니다
• 위임: 실행자는 에이전트를 대신하여 트랜잭션에 서명하도록 권한을 부여받을 수 있습니다
• 토큰 연결: Genesis 토큰을 에이전트 ID에 영구적으로 연결할 수 있습니다

바로 가기: 사전 요구 사항 · 일반 흐름 · 명령어 참조 · 일반적인 오류 · FAQ · 용어 설명

사전 요구 사항

• Metaplex CLI가 설치되어 PATH에 등록되어 있어야 합니다
• Solana 키페어 파일 (예: ~/.config/solana/id.json)
• 트랜잭션 수수료를 위한 SOL
• mplx config rpcs add로 구성하거나 -r로 전달한 RPC 엔드포인트

설정 확인:

mplx agents --help

일반 흐름

에이전트 ID 등록

agents register를 사용하여 단일 명령어로 MPL Core 에셋을 생성하고 에이전트 ID를 등록합니다. 기본적으로 Metaplex Agent API를 사용하므로 Irys 업로드가 필요하지 않습니다.

mplx agents register \
  --name "My Agent" \
  --description "An autonomous trading agent" \
  --image "./avatar.png"

고급 워크플로우(기존 에셋, 커스텀 문서, 인터랙티브 위저드)의 경우, --use-ix 플래그를 사용하여 registerIdentityV1 명령어를 온체인에 직접 전송하세요. 전체 세부 사항은 에이전트 등록을 참조하세요.

Genesis 토큰 연결

에이전트를 등록하고 Genesis 토큰 런칭을 생성한 후, set-agent-token으로 연결하세요. 이렇게 하면 토큰과 에이전트 ID가 영구적으로 연결됩니다.

mplx agents set-agent-token <AGENT_ASSET> <GENESIS_ACCOUNT>

실행 위임 설정

실행 위임을 통해 지갑이 등록된 에이전트를 대신하여 트랜잭션에 서명할 수 있습니다:

1. 실행자 프로필 등록 (지갑당 일회성):

mplx agents executive register

2. 에이전트를 실행자에게 위임 (에셋 소유자가 실행):

mplx agents executive delegate <AGENT_ASSET> --executive <EXECUTIVE_WALLET>

3. 위임 철회 (소유자 또는 실행자가 실행):

mplx agents executive revoke <AGENT_ASSET>

전체 세부 사항은 실행 위임을 참조하세요.

명령어 참조

참고 사항

• 에이전트 ID는 Agent Registry 프로그램을 통해 MPL Core 에셋으로부터 파생된 PDA로 저장됩니다
• 기본 등록 흐름은 Metaplex Agent API를 사용합니다 — 온체인 직접 등록에는 --use-ix를 사용하세요
• set-agent-token은 지갑이 asset-signer 모드에 있어야 합니다 — Asset-Signer 지갑을 참조하세요
• 각 명령어의 전체 플래그 문서를 보려면 mplx agents <command> --help를 실행하세요
• 개념, 아키텍처, SDK 가이드는 Agent Kit 문서를 참조하세요

일반적인 오류

FAQ

mplx agents 명령어란 무엇인가요? mplx agents 명령어 그룹을 사용하면 MPL Core 에셋에 에이전트 ID를 등록하고, Genesis 토큰을 에이전트에 연결하며, 실행 위임을 관리할 수 있습니다 — 모두 터미널에서 가능합니다.

실행자 프로필이란 무엇인가요? 실행자 프로필은 지갑이 등록된 에이전트로부터 실행 위임을 받을 수 있도록 하는 일회성 온체인 PDA입니다. 등록이 완료되면 실행자는 위임된 에이전트를 대신하여 트랜잭션에 서명할 수 있습니다.

Irys에 업로드하지 않고도 에이전트를 등록할 수 있나요? 네. 기본적으로 register 명령어는 스토리지를 자동으로 처리하는 Metaplex Agent API를 사용합니다. Irys는 온체인 직접 등록을 위해 --use-ix 플래그를 사용할 때만 필요합니다.

에이전트 토큰을 설정한 후 변경할 수 있나요? 아니요. 에이전트 토큰은 set-agent-token 명령어를 사용하여 ID당 한 번만 설정할 수 있습니다. 이 작업은 되돌릴 수 없습니다.

API와 직접 IX 등록 경로의 차이점은 무엇인가요? API 경로(기본값)는 단일 API 호출로 Core 에셋을 생성하고 ID를 등록하며 Irys 업로드가 필요하지 않습니다. 직접 IX 경로(--use-ix)는 registerIdentityV1 명령어를 온체인에 직접 전송하며, 기존 에셋, 커스텀 문서 워크플로우, 또는 인터랙티브 위저드에 필요합니다.

용어 설명