defi-agents

Frequently Asked Questions

General Questions

What is an AI agent?

An AI agent is a specialized version of ChatGPT or Claude with specific instructions for one task. Instead of a generalist that tries to do everything, an agent focuses on doing one thing exceptionally well.

Do I need coding skills to create an agent?

No. Creating an agent is about writing clear instructions in plain English. If you can explain what you want to a person, you can create an agent.

Which platform should I use?

Can I use the same agent across platforms?

The core system prompt works across platforms, but you’ll need to recreate the agent in each. Copy your prompt and adapt the setup process for each platform.

Creating Agents

How long does it take to create an agent?

What makes a good agent?

  1. Specific role (not generic)
  2. Clear instructions (no ambiguity)
  3. Consistent output (same quality every time)
  4. Appropriate scope (not too broad or narrow)
  5. Well-tested (tried with real examples)

How specific should my instructions be?

Very specific. Instead of “be helpful,” say:

Can I make an agent that does multiple things?

You can, but specialized agents perform better. Instead of one “productivity agent,” create separate agents for:

How do I know if my agent is working well?

Test it 5-10 times with real scenarios. If you consistently get quality results without having to clarify or correct, it’s working.

AI Agents Library Marketplace

How do I submit an agent to AI Agents Library?

  1. Fork the repository: github.com/nirholas/AI-Agents-Library
  2. Create your agent in /src/your-agent-name.json
  3. Test thoroughly
  4. Submit a Pull Request
  5. Our team reviews within 48-72 hours

Do I need to translate my agent?

No. Submit in English. Our automated i18n workflow translates to 18 languages automatically.

Can I update an agent after submission?

Yes. Submit a new Pull Request with your changes. Explain what changed and why in the PR description.

Can I delete or unpublish an agent?

Yes. Open an issue or PR requesting removal. Provide your reasoning.

How do I get credit for my agent?

Your GitHub username is listed as the author. Users see this when browsing the marketplace.

Can I monetize my agent?

Currently, the marketplace is free and open-source. Monetization features may be added in the future.

Sperax Portfolio Agents

What is the Sperax Portfolio master agent?

The Sperax Portfolio (🎯) is an all-in-one master agent that consolidates all 16 portfolio specialist agents into one comprehensive interface. It’s recommended for most users as it provides access to 100% of portfolio features while maintaining conversation context.

Current Status:

What domain do the Sperax portfolio agents use?

Currently, the Sperax portfolio agents (Dashboard, Trading Assistant, DCA Bot, etc.) use sperax.fun for testing and development purposes.

Will the domain change in the future?

Yes, likely. Once SperaxOS is officially live in production, the domain may change to something like:

However, everything is still in flux and subject to change as the platform evolves.

Should I hardcode sperax.fun URLs?

If you’re building integrations or creating custom agents, be aware that:

Monitor the repository for updates when the domain migration occurs.

Will there be a migration guide?

Yes. When the domain changes, we’ll provide:

Technical Questions

What’s the difference between temperature and top_p?

Both control randomness, but use different methods:

Don’t adjust both—pick one.

When should I increase temperature?

When should I decrease temperature?

What are presence_penalty and frequency_penalty?

Both reduce repetition:

Increase both to avoid repetitive language.

How long can my system prompt be?

Technically very long (thousands of words), but shorter is usually better:

Beyond that, the model may miss details.

Can my agent access the internet?

Depends on platform:

Can my agent use uploaded files?

Yes:

Troubleshooting

My agent gives inconsistent responses

Solution: Lower temperature to 0.1-0.3. Add more explicit instructions about output format.

My agent is too repetitive

Solution: Increase presence_penalty (0.5-1.0) and frequency_penalty (0.5-1.0).

My agent doesn’t follow my instructions

Solution:

  1. Make instructions more explicit
  2. Use numbered lists for multi-step processes
  3. Add examples of desired behavior
  4. Simplify—may be too complex

My agent’s responses are too long

Solution: Add explicit length limits:

My agent’s tone is wrong

Solution: Define tone explicitly with examples:

My agent keeps saying “as an AI…”

Solution: Add to instructions: “Never mention being an AI. Respond directly as the role you’re playing.”

Agent Teams (AI Agents Library)

What is an Agent Team?

Multiple specialized agents working together on a conversation. Each contributes their expertise, coordinated by a host agent.

How do Agent Teams work?

  1. You ask a question
  2. Host agent determines which team members should respond
  3. Agents discuss and build on each other’s insights
  4. You get comprehensive answer from multiple perspectives

Can I interrupt an Agent Team?

Yes. Pause at any time. The conversation freezes and you can redirect or provide input.

How many agents can be in a team?

Recommended: 3-5 agents Maximum: Usually 8-10 before coordination becomes difficult

Can agents see each other’s messages?

Yes. That’s how they collaborate. They build on previous responses.

Can I use private messaging in teams?

Yes. Click an agent’s avatar or use @ mention to send direct messages.

Best Practices

Should I create one mega-agent or multiple specialized ones?

Multiple specialized agents. They’re easier to:

How often should I update my agents?

When you notice patterns:

Otherwise, if it works, don’t fix it.

Can I share my agents with my team?

Should I make my agent public?

Benefits:

Drawbacks:

For company-specific agents, keep private.

Getting Help

Where can I get help?

How do I report a bug?

Open an issue with:

  1. Agent identifier or link
  2. What you expected
  3. What actually happened
  4. Steps to reproduce
  5. Platform (ChatGPT/Claude/AI Agents Library)

How do I request a feature?

Open an issue with “Feature Request” label. Explain:

Can I request someone create an agent?

Yes. Open an issue describing what you need. Community members may build it.

Still have questions? Join our Discord or open an issue on GitHub.

This site is open source. Improve this page.