Getting Started

This guide walks you through creating your first AI agent and making your first API call.

Prerequisites

• An Agentix account at app.agentix.cl 
• An organization (created automatically on signup)

Quickstart

1. Create an Agent

1. Log in to the Agentix Dashboard 
2. Navigate to Agents in the sidebar
3. Click Create Agent
4. Give your agent a name, description, and system instructions
5. Choose a model (GPT-4o, Claude, etc.)
6. Click Save

You can also start from a template. Agentix provides pre-built templates for customer support, ecommerce, veterinary, and restaurant use cases.

2. Get Your API Key

1. Go to Settings > API Keys
2. Click Create API Key
3. Copy the key (format: agx_live_...)
4. Store it securely — you will not be able to see it again

See Authentication for full details on API key management.

3. Make Your First API Call

Send a message to your agent using the Chat API:

curl -X POST https://app.agentix.cl/api/public/agents/YOUR_AGENT_ID/chat \
  -H "Authorization: Bearer agx_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello, what can you help me with?",
    "sessionId": "session-001"
  }'

The response streams back as text by default. You will receive the agent’s response based on its instructions, knowledge base, and available tools.

4. Embed the Widget (Optional)

To add the chat widget to your website, include the embed script:

<script
  src="https://cdn.agentix.cl/widget/v1/embed.js"
  data-agent-id="YOUR_AGENT_ID"
  data-api-key="agx_live_YOUR_API_KEY"
></script>

The widget appears as a floating button in the corner of your page. See Widget Guide for customization options.

Next Steps

• Authentication - Learn about API key scopes and security
• Chat API - Full chat endpoint documentation
• Widget Customization - Theme and behavior options
• TypeScript SDK - Use the client library instead of raw HTTP