Getting Started
Em 4 passos, você terá um agente IA criado, uma orquestração executando e acesso via API. Tempo estimado: 10 minutos.
Criar um Agente
Acesse o dashboard e crie seu primeiro agente de IA.
- → Acesse Dashboard → Agentes
- → Clique em “Novo Agente”
- → Defina um nome e o System Prompt (ex: “Você é um analista de mercado especialista em IA”)
- → Escolha o modelo (Llama 3.3 70B recomendado para início)
- → Clique em “Criar”
System Prompt de exemplo:
Você é um analista de mercado especialista em IA e tecnologia. Seu objetivo é fornecer análises precisas, com dados e exemplos concretos. Sempre cite fontes quando relevante. Responda em português brasileiro.
Criar uma Orquestração com 2 Agentes
Orquestrações encadeiam múltiplos agentes em sequência. O output de um agente vira o input do próximo.
- → Acesse Dashboard → Orquestrações
- → Clique em “Nova Orquestração”
- → Adicione o Agente 1 (ex: “Pesquisador”) e o Agente 2 (ex: “Escritor”)
- → Defina a estratégia: “Sequential” (um após o outro)
- → Salve a orquestração
Dica: Use o AI Creator
Descreva seu processo em texto e o AI Creator gera a orquestração automaticamente. Acesse via botão “Criar com IA” na lista de orquestrações.
Executar via Interface
Execute a orquestração pela UI e veja o resultado em tempo real.
- → Abra a orquestração criada no Passo 2
- → Clique em “Executar”
- → Digite um input de teste (ex: “Analise o mercado de SaaS de IA no Brasil em 2026”)
- → Acompanhe o streaming em tempo real — cada agente responde em sequência
- → O resultado final pode ser exportado como PDF ou Markdown
Executar via API
Integre Sofia AI em seus sistemas usando a API REST.
1. Gere uma API Key em Dashboard → API Keys
2. Execute a orquestração:
curl -X POST https://sofiaia.roilabs.com.br/api/v1/orchestrations/SEU_ID/execute \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": "Analise o mercado de SaaS de IA no Brasil"}'3. Faça polling para obter o resultado:
curl https://sofiaia.roilabs.com.br/api/v1/executions/EXECUTION_ID \ -H "Authorization: Bearer SUA_API_KEY"
Consulte a referência completa da API para ver todos os endpoints disponíveis.