agent.create
create(name, gasSource?, gasSourceAddress?) → AgentDetails 마루 체인에 자체 AA 지갑을 가진 새로운 AI 에이전트를 생성합니다. 에이전트는 처음에 PENDING 상태로 생성되며 WaaS가 온체인에 등록함에 따라 ACTIVE 상태가 되기까지 1-3분이 소요됩니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | ✓ | 에이전트의 사람이 읽을 수 있는 이름입니다 (최대 255자, 소유자당 고유). |
gasSource | enum | - | 초기 가스 자금 조달 모드입니다. 'SELF', 'OWNER' 또는 'PAYMASTER'여야 합니다. 기본값은 'PAYMASTER'입니다. |
gasSourceAddress | string | - | 가스를 지불하는 이더리움 체크섬 주소입니다. gasSource가 'OWNER'인 경우에만 필요합니다. |
반환값
타입:
object agentId, name, address, status('PENDING'), gasSource 및 gasSourceAddress를 포함하는 객체를 반환합니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
INVALID_INPUT | InvalidInput | gasSource가 OWNER이지만 주소가 제공되지 않았거나, OWNER가 아닌 모드에 주소가 제공된 경우 발생합니다. |
AGENT_CREATED_GAS_FAILED | AgentCreatedGasFailed | 에이전트가 생성되었지만 가스 출처 변경에 실패했습니다. ACTIVE 상태가 되면 agent.set_gas_source를 통해 재시도할 수 있습니다. |
예제
페이마스터 자금 지원 에이전트 생성
기본 스폰서 가스를 사용하는 에이전트를 생성합니다.
{
"name": "TradingBot_01"
} 소유자 자금 지원 에이전트 생성
{
"name": "TreasuryBot",
"gasSource": "OWNER",
"gasSourceAddress": "0xYourOwnerAddressHere"
}