Create an agent

import uuid
from naturalpay import Natural
from naturalpay.agents import CreateAgentsRequestLimits

client = Natural()
agent = client.agents.create(
    name="Procurement Agent",
    description="Buys supplies",
    limits=CreateAgentsRequestLimits(per_transaction=100_000),
    idempotency_key=str(uuid.uuid4()),
)

agent_id = agent.data.id

import Natural from "@naturalpay/sdk";

const client = new Natural();
const agent = await client.agents.create({
  name: "Procurement Agent",
  description: "Buys supplies",
  limits: { perTransaction: 100_000 },
  idempotencyKey: crypto.randomUUID(),
});

const agentId = agent.data.id;

natural agents create --json '{
  "name": "Procurement Agent",
  "description": "Buys supplies",
  "limits": { "perTransaction": 100000 }
}' --idempotency-key "$(uuidgen)"

Create an agent called "Procurement Agent" for buying supplies, with a $1,000 per-transaction limit.

curl -X POST https://api.natural.com/agents \
  -H "Authorization: Bearer $NATURAL_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": {
        "name": "Procurement Agent",
        "description": "Buys supplies",
        "limits": { "perTransaction": 100000 }
      }
    }
  }'

key = client.agent_keys.create(
    data={
        "attributes": {},
        "relationships": {
            "agent": {"data": {"type": "agent", "id": agent_id}},
        },
    },
)
print(key.data.attributes.agent_key)

const key = await client.agentKeys.create({
  data: {
    attributes: {},
    relationships: {
      agent: { data: { type: "agent", id: agentId } },
    },
  },
});
console.log(key.data.attributes.agentKey);

natural agent-keys create --agent-id agt_019cd1798d637a4da75dce386343931d

curl -X POST https://api.natural.com/agent-keys \
  -H "Authorization: Bearer $NATURAL_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": {},
      "relationships": {
        "agent": {
          "data": { "type": "agent", "id": "agt_019cd1798d637a4da75dce386343931d" }
        }
      }
    }
  }'