Construindo com IA¶

Este guia orienta você na criação de produtos na plataforma 4Geeks e na integração deles com nossas capacidades de IA — AI Agents e AI Studio — para criar fluxos de trabalho inteligentes e automatizados.

Criando Produtos¶

Produtos na 4Geeks representam os bens, serviços ou planos de assinatura que você oferece. Você pode criar e gerenciar programaticamente produtos via a API REST.

Autenticação da API¶

Todas as requisições de API exigem sua Live API Key transmitida via o cabeçalho X-Api-Key:

X-Api-Key: sk_live_your_api_key_here

Obtenha suas chaves de API no painel Platform Settings na aba API & Webhooks. Consulte Obter Chaves de API para mais detalhes.

Criar um Produto¶

Envie uma requisição POST para criar um produto:

cURLPythonJavaScript

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true
  }'

import requests

response = requests.post(
    'https://api.4geeks.io/v1/products',
    headers={
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Premium Plan',
        'description': 'Full-featured premium subscription with priority support',
        'active': True
    }
)
print(response.json())

const response = await fetch('https://api.4geeks.io/v1/products', {
    method: 'POST',
    headers: {
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Premium Plan',
        description: 'Full-featured premium subscription with priority support',
        active: true
    })
});
const data = await response.json();
console.log(data);

A resposta inclui o produto criado com seu ID:

{
    "id": "prod_abc123",
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true,
    "created_at": "2026-05-02T10:30:00Z"
}

Listar Produtos¶

Recupere todos os seus produtos com paginação:

cURLPython

curl -X GET 'https://api.4geeks.io/v1/products?limit=10&offset=0' \
  -H 'X-Api-Key: sk_live_your_api_key_here'

import requests

response = requests.get(
    'https://api.4geeks.io/v1/products',
    headers={'X-Api-Key': 'sk_live_your_api_key_here'},
    params={'limit': 10, 'offset': 0}
)
print(response.json())

Resposta:

{
    "items": [
        {
            "id": "prod_abc123",
            "name": "Premium Plan",
            "description": "Full-featured premium subscription with priority support",
            "active": true
        }
    ],
    "total_items": 1,
    "limit": 10,
    "offset": 0
}

Criar um Plano para um Produto¶

Para produtos baseados em assinatura, crie um plano vinculado ao seu produto:

cURL

curl -X POST 'https://api.4geeks.io/v1/plans' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "prod_abc123",
    "amount": 4999,
    "currency": "USD",
    "interval": "month"
  }'

O amount é em centavos (4999 = $49.99). Intervalos suportados: month, year, week.

Integrando Produtos com AI Agents¶

Uma vez que seus produtos estejam criados, você pode conectá-los aos AI Agents da 4Geeks para automatizar fluxos de trabalho de vendas, suporte e cobrança.

Como Funciona¶

Os AI Agents da 4Geeks usam seu catálogo de produtos e documentação como base de conhecimento. Quando um cliente interage com um agente, ele pode:

Recomendar produtos com base nas necessidades do cliente
Responder perguntas sobre preços, funcionalidades e disponibilidade
Processar pedidos e criar sessões de checkout
Lidar com tickets de suporte relacionados a produtos específicos

Passo a Passo: Conectar Produtos a um AI Sales Agent¶

1. Implantar um AI Sales Agent¶

Navegue até o 4Geeks Console e clique em Deploy Agent. Selecione AI Sales Agent e dê um nome.

2. Definir a Fonte de Dados de Treinamento¶

Na configuração do agente, insira a URL da documentação do seu produto como a Training Data Source. Pode ser:

Sua página de catálogo de produtos
Uma página de preços
Documentação da API
Um arquivo llms.txt público (veja abaixo)

O agente rastreia esta URL e usa o conteúdo para responder às perguntas dos clientes com precisão.

3. Definir o Objetivo do Agente¶

Defina um objetivo claro para o agente:

Sell our software products. When a customer asks about features, recommend the
appropriate plan based on their needs. Always mention pricing in USD. Do not
offer discounts higher than 10% without escalation.

4. Conectar um Canal¶

Escolha como os clientes interagirão com o agente:

WhatsApp: Conecte sua conta Meta Business para mensagens
Web Chat: Incorpore o agente no seu site
Voice: Habilite interações por telefone

Consulte Como Criar um WhatsApp AI Agent para um guia detalhado.

5. Testar e Colocar em Produção¶

O agente é executado primeiro em um ambiente de sandbox. Teste interações como:

Customer: "What plans do you offer?"
Agent: "We have three plans: Basic ($19/mo), Pro ($49/mo), and Premium ($99/mo). 
        The Pro plan includes priority support and API access. Would you like to 
        know more about any specific plan?"

Customer: "I need API access for my team of 10."
Agent: "For a team of 10 with API access, I recommend the Pro plan at $49/mo per 
        seat. Would you like me to send you a checkout link to get started?"

Quando estiver satisfeito, clique em Go Live para implantar o agente em produção.

Fluxo de Trabalho AI Agent + Produto¶

Veja como funciona a integração completa:

sequenceDiagram
    participant C as Customer
    participant A as AI Agent
    participant K as Knowledge Base
    participant P as 4Geeks API
    participant O as Checkout

    C->>A: "What products do you have?"
    A->>K: Query product catalog
    K-->>A: Return product data
    A-->>C: List products with pricing
    C->>A: "I want the Premium Plan"
    A->>P: Create checkout session
    P-->>A: Return checkout_url
    A-->>C: Send checkout link
    C->>O: Complete payment

AI Support Agent para Consultas de Produtos¶

Implante um AI Customer Support Agent para lidar com perguntas pós-venda sobre produtos:

Defina a Training Data Source como sua documentação de produtos e FAQ
Defina o objetivo:

Answer customer questions about our products. Help with troubleshooting, 
billing inquiries, and feature explanations. Escalate to a human agent 
if the issue cannot be resolved within 3 interactions.

Conecte ao seu canal preferido (WhatsApp, web chat ou voice)

O agente de suporte pode consultar produtos específicos por ID e obter dados em tempo real do seu catálogo.

Integrando com AI Studio¶

Para funcionalidades personalizadas relacionadas a produtos que vão além dos agentes pré-construídos, use o 4Geeks AI Studio.

O que é o AI Studio?¶

O AI Studio oferece um Arquiteto Sênior humano especializado, aumentado pela 4Geeks AI Factory — uma infraestrutura que orquestra LLMs de alto nível (Claude, Gemini, GPT) para escrever, testar e refatorar código até 5x mais rápido.

Casos de Uso para Integração de Produtos¶

Fluxos de checkout personalizados: Crie experiências de pagamento sob medida para seus produtos
Motor de recomendação de produtos: Crie um sistema de recomendação baseado em IA
Descrições automatizadas de produtos: Gere e atualize conteúdo de produtos em escala
Integrações personalizadas: Conecte seu catálogo de produtos a ferramentas de terceiros (CRM, ERP, analytics)

Primeiros Passos¶

Acesse o 4Geeks Console
Descreva seus requisitos de integração de produtos
Um Arquiteto Sênior é designado ao seu projeto
A AI Factory acelera o desenvolvimento com orquestração multi-modelo
Revise pull requests e implante em produção

Consulte a visão geral do AI Studio e o AI Gateway Privado para mais detalhes.

Usando llms.txt para Integração com IA¶

A 4Geeks publica um arquivo llms.txt público em:

https://docs.4geeks.io/llms.txt

O que é llms.txt?¶

llms.txt é um arquivo padronizado que fornece às ferramentas de IA e LLMs uma visão concisa e legível por máquina da API 4Geeks. Ele inclui:

URL base e detalhes de autenticação
Todos os endpoints disponíveis com métodos, caminhos e descrições
Formatos de requisição/resposta
Exemplos de código em múltiplas linguagens
Códigos de erro e padrões

Como Usar¶

Você pode apontar seus AI Agents, aplicações personalizadas de LLM ou ferramentas de desenvolvimento de IA para este arquivo, para que eles compreendam a estrutura da API 4Geeks sem configuração manual:

Dados de Treinamento para AI Agent: Adicione https://docs.4geeks.io/llms.txt como fonte de dados de treinamento para seus AI Agents
Contexto LLM: Inclua o conteúdo do arquivo em seus prompts de sistema ao criar aplicações de IA personalizadas
Desenvolvimento Assistido por IA: Assistentes de IA em IDEs (Cursor, Copilot, etc.) podem referenciar este arquivo para gerar chamadas de API corretas

Exemplo: Usando llms.txt em um Prompt de Sistema¶

You are an AI assistant that helps users integrate with the 4Geeks platform.
Use the following API reference to generate correct API calls:

[Content from https://docs.4geeks.io/llms.txt]

Isso garante que a IA gere código preciso com os endpoints, cabeçalhos e formatos de requisição corretos.

Próximos Passos¶

Documentação dos 4Geeks AI Agents — Explore todos os agentes disponíveis
Documentação do 4Geeks AI Studio — Saiba mais sobre desenvolvimento aumentado por IA
Referência da API — Documentação completa da API
Obter Chaves de API — Gerencie suas credenciais
Tutoriais de AI Agents — Guias passo a passo

Ainda tem dúvidas? Pergunte na Discord or explore tutoriais