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 | - | OWNER 모드에서 가스를 지불하도록 지정하는 이더리움 체크섬 주소입니다. gasSource가 'OWNER'인 경우에만 필요합니다. OWNER는 실험 단계입니다. m-aws는 이 주소를 저장하지만, 온체인 라우팅이 지원되기 전까지는 SELF처럼 에이전트 자신의 OKRW로 가스를 지불합니다. |
반환값
타입:
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"
}OWNER 모드 에이전트 생성 (실험 단계)
gasSourceAddress는 OWNER 모드에 기록되는 소유자 주소입니다. 본인의 소유자 주소를 넣으세요. 여기 표시된 주소는 예시입니다. OWNER는 실험 단계입니다. m-aws는 이 주소를 저장하지만, 온체인 라우팅이 지원되기 전까지는 SELF처럼 에이전트 자신의 OKRW로 가스를 지불합니다.
{
"name": "TreasuryBot",
"gasSource": "OWNER",
"gasSourceAddress": "0x8F3ac2B1d9E74c05A6B18FE27Dc4913e5A0F7b62"
}