Pular para conteúdo principal

Getting Started

Em 4 passos, você terá um agente IA criado, uma orquestração executando e acesso via API. Tempo estimado: 10 minutos.

1

Criar um Agente

Acesse o dashboard e crie seu primeiro agente de IA.

  1. Acesse Dashboard → Agentes
  2. Clique em “Novo Agente”
  3. Defina um nome e o System Prompt (ex: “Você é um analista de mercado especialista em IA”)
  4. Escolha o modelo (Llama 3.3 70B recomendado para início)
  5. 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.
2

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.

  1. Acesse Dashboard → Orquestrações
  2. Clique em “Nova Orquestração”
  3. Adicione o Agente 1 (ex: “Pesquisador”) e o Agente 2 (ex: “Escritor”)
  4. Defina a estratégia: “Sequential” (um após o outro)
  5. 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.

3

Executar via Interface

Execute a orquestração pela UI e veja o resultado em tempo real.

  1. Abra a orquestração criada no Passo 2
  2. Clique em “Executar”
  3. Digite um input de teste (ex: “Analise o mercado de SaaS de IA no Brasil em 2026”)
  4. Acompanhe o streaming em tempo real — cada agente responde em sequência
  5. O resultado final pode ser exportado como PDF ou Markdown
4

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.

Próximos Passos