Understanding AI Agents – Hyperfy.ai Owners Manual

AI Agents are the heart of your Hyperfy platform. They are intelligent assistants that you customize to serve specific roles — such as support, onboarding, education, sales, or content creation.

This guide will help you understand how AI agents work on Hyperfy and how to create effective ones using the tools available inside your platform.

🧠 What is an AI Agent in Hyperfy?

An AI Agent is a chatbot that responds in natural language, using a personality and behavior you define. On Hyperfy, each agent has its own identity — created from:

Name: How users identify and refer to the agent

Image: The visual avatar or icon that represents the agent

Description: A short sentence describing what the agent does (visible to users)

Context: A written prompt (up to 2000 characters) that tells the agent how to behave

Model: The AI engine that powers the agent's responses (such as GPT, Claude, or Gemini)

These AI engines are advanced systems trained to understand and respond to human language in real time.

⚙️ Choosing the Right AI Model

Each agent is powered by a different AI model. You can select the one that best fits the agent's purpose.

✅ Models currently available on Hyperfy:

Model	Best For
ChatGPT 4o	Well-rounded conversations, support, education
ChatGPT 4o-mini / 04-mini	Faster performance, light tasks
ChatGPT o3	General/basic agents
Claude 3.5 Sonnet	Human-like tone, onboarding, empathetic replies
Claude 3.7 Sonnet	Deep and thoughtful answers, educational content
Gemini 2.0-flash	Fast, direct responses for simple queries

✅ Quick examples by role:

Agent Type	Suggested Models
Customer support	GPT 4o, Claude 3.5
Education/tutoring	Claude 3.7
Sales or conversion	GPT 4o
Fast, direct help	Gemini 2.0-flash
Casual conversations	GPT 4o-mini
Technical guides	Gemini or Claude 3.7

You can create different agents using different models depending on their function inside your platform.

✍️ Writing the Agent Context

The context is where you define how the agent behaves. It’s a short block of text (up to 2000 characters) that sets the tone, purpose, and rules.

✍️ A good context should include:

Role – What is this agent supposed to do?

Tone – Friendly? Formal? Direct? Playful?

Topics – What kind of questions or situations will the agent handle?

Limits – What should the agent avoid doing?

Audience – Who will talk to this agent?

✅ Example Contexts

🟢 Support Agent (using ChatGPT 4o)

You are a helpful support assistant for a digital platform. You help users understand how things work in a clear and friendly tone. Keep responses short and simple. If a user asks something you can’t answer, kindly suggest they talk to a human.

🟠 Sales Assistant (using Gemini 2.0-flash)

You are a persuasive and confident sales rep. Your goal is to highlight the benefits of the platform and guide users to take action (like creating an account or exploring more). Use short, energetic messages. Avoid technical jargon.

🔵 Tutor Agent (using Claude 3.7)

You are a calm and patient tutor who explains concepts in a simple, step-by-step way. Always assume the user is a beginner. Avoid long paragraphs. Be encouraging and clear.

✅ Best Practices

Be specific: Clear instructions lead to better results

Mention tone and limits: That helps the AI stay consistent

Keep it clear: Write instructions like you're talking to a junior assistant

Use testing to improve: Try using your agent as a user would, and adjust if needed

🧪 Tips for Structuring Your Agents

Create one agent per goal or topic — don’t try to make one do everything

Use clear names and descriptions so users know which agent to talk to

Organize your agents by purpose (support, learning, inspiration, etc.)

🏁 Summary

AI Agents bring your platform to life. With the right model and a well-written context, you can create agents that teach, sell, support, and guide — fully aligned with your brand and voice.

Ready to write better prompts?