Zhenfy

Quick Start

Web UI

  1. Create an account — Sign up with your email and verify it.
  2. Create an agent — Click Create Agent on the dashboard. Give it a name and a system prompt.
  3. Wait for ready — The agent deploys in 30-60 seconds. Status changes from creating to ready.
  4. Chat — Open the agent and start a conversation. Use the session sidebar to manage multiple conversations.

API

1. Get an API token

Go to Settings in the web UI and click Create Token. Copy it immediately — it's only shown once. All API calls use this token for authentication.

export TOKEN="zat_your_token_here"

2. Create an agent

AGENT_ID=$(curl -s -X POST https://zhenfy.ai/api/agent/v1/agents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Assistant",
    "system_prompt": "You are a helpful assistant."
  }' | jq -r '.data.id')

3. Wait for ready

while [ "$(curl -s https://zhenfy.ai/api/agent/v1/agents/$AGENT_ID/status \
  -H "Authorization: Bearer $TOKEN" | jq -r '.data.status')" != "ready" ]; do
  sleep 5; done
echo "Ready!"

4. Chat

curl -s -X POST https://zhenfy.ai/api/agent/v1/agents/$AGENT_ID/chat \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello!"}' | jq '.data.response'

The response includes a session_id. Pass it in subsequent requests to continue the conversation.

← What is Zhenfy AgentCore Concepts →