Pular para o conteúdo principal

​
CrewAI AMP API

Bem-vindo à referência da API do CrewAI AMP. Esta API permite que você interaja programaticamente com seus crews implantados, possibilitando a integração com seus aplicativos, fluxos de trabalho e serviços.

​
Início Rápido

1

Obtenha suas credenciais de API

Navegue até a página de detalhes do seu crew no painel do CrewAI AMP e copie seu Bearer Token na aba Status.
2

Descubra os Inputs Necessários

Use o endpoint GET /inputs para ver quais parâmetros seu crew espera.
3

Inicie uma Execução de Crew

Chame POST /kickoff com seus inputs para iniciar a execução do crew e receber um kickoff_id.
4

Monitore o Progresso

Use GET /status/{kickoff_id} para checar o status da execução e recuperar os resultados.

​
Autenticação

Todas as requisições à API exigem autenticação usando um Bearer token. Inclua seu token no header Authorization:

​
Tipos de Token

Você pode encontrar ambos os tipos de token na aba Status da página de detalhes do seu crew no painel do CrewAI AMP.

​
URL Base

Cada crew implantado possui um endpoint de API único:
Substitua your-crew-name pela URL real do seu crew no painel.

​
Fluxo Típico

  1. Descoberta: Chame GET /inputs para entender o que seu crew precisa
  2. Execução: Envie os inputs via POST /kickoff para iniciar o processamento
  3. Monitoramento: Faça polling em GET /status/{kickoff_id} até a conclusão
  4. Resultados: Extraia o output final da resposta concluída

​
Tratamento de Erros

A API utiliza códigos de status HTTP padrão:

​
Testes Interativos

Por que não há botão “Enviar”? Como cada usuário do CrewAI AMP possui sua própria URL de crew, utilizamos o modo referência em vez de um playground interativo para evitar confusão. Isso mostra exatamente como as requisições devem ser feitas, sem botões de envio não funcionais.
Cada página de endpoint mostra para você:
  • ✅ Formato exato da requisição com todos os parâmetros
  • ✅ Exemplos de resposta para casos de sucesso e erro
  • ✅ Exemplos de código em várias linguagens (cURL, Python, JavaScript, etc.)
  • ✅ Exemplos de autenticação com o formato adequado de Bearer token

​
Para testar sua API de verdade:

Copie Exemplos cURL

Copie os exemplos cURL e substitua a URL + token por seus valores reais

Use Postman/Insomnia

Importe os exemplos na sua ferramenta de testes de API preferida
Exemplo de fluxo:
  1. Copie este exemplo cURL de qualquer página de endpoint
  2. Substitua your-actual-crew-name.crewai.com pela URL real do seu crew
  3. Substitua o Bearer token pelo seu token real do painel
  4. Execute a requisição no seu terminal ou cliente de API

​
Precisa de Ajuda?

Suporte Enterprise

Obtenha ajuda com integração da API e resolução de problemas

Painel Enterprise

Gerencie seus crews e visualize logs de execução