ComposioHQ/GroqCloud-Automation

Automação GroqCloud

Automatize fluxos de trabalho de inferência de IA usando a API ultrarrápida do GroqCloud — completações de chat, descoberta de modelos, tradução de áudio e seleção de vozes TTS — tudo orquestrado através da integração MCP do Composio.

Documentação do toolkit: composio.dev/toolkits/groqcloud

---

Configuração

1. Conecte sua conta GroqCloud através do servidor MCP do Composio em https://rube.app/mcp
2. O agente solicitará um link de autenticação se nenhuma conexão ativa existir
3. Uma vez conectado, todas as ferramentas GROQCLOUD_* estarão disponíveis para execução

---

Fluxos de Trabalho Principais

1. Descobrir Modelos Disponíveis

Liste todos os modelos disponíveis no GroqCloud para encontrar IDs de modelo válidos antes de executar inferência.

Ferramenta: GROQCLOUD_LIST_MODELS

Nenhum parâmetro necessário — retorna todos os modelos disponíveis com metadados.

Use isto como pré-requisito antes de qualquer chamada de completação de chat para garantir que você faça referência a um ID de modelo válido e não obsoleto.

---

2. Executar Completations de Chat

Gere respostas de IA para prompts conversacionais usando um modelo GroqCloud especificado.

Ferramenta: GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION

Parâmetro	Tipo	Obrigatório	Descrição
model	string	Sim	ID do modelo de GROQCLOUD_LIST_MODELS
messages	array	Sim	Lista ordenada de objetos {role, content} (system, user, assistant)
temperature	number	Não	Temperatura de amostragem 0-2 (padrão: 1)
max_completion_tokens	integer	Não	Máximo de tokens a serem gerados
top_p	number	Não	Amostragem de núcleo 0-1 (padrão: 1)
stop	string/array	Não	Até 4 sequências de parada
stream	boolean	Não	Ativar streaming SSE (padrão: falso)

---

3. Inspecionar Detalhes do Modelo

Recupere metadados detalhados para um modelo específico, incluindo janela de contexto e capacidades.

Ferramenta: GROQCLOUD_GROQ_RETRIEVE_MODEL

Parâmetro	Tipo	Obrigatório	Descrição
model	string	Sim	Identificador do modelo (ex.: groq-1-large)

---

4. Traduzir Áudio para Inglês

Traduza arquivos de áudio não-ingleses para texto em inglês usando modelos Whisper.

Ferramenta: GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION

Parâmetro	Tipo	Obrigatório	Descrição
file_path	string	Sim	Caminho local, URL HTTP(S) ou URL de dados base64 para áudio
model	string	Não	ID do modelo (padrão: whisper-large-v3). Nota: whisper-large-v3-turbo pode não suportar traduções
response_format	string	Não	json, verbose_json ou text (padrão: json)
temperature	number	Não	Temperatura de amostragem 0-1 (padrão: 0)

---

5. Listar Vozes TTS

Enumere as vozes de texto-para-fala disponíveis para os modelos Groq PlayAI para orientar a seleção de voz na interface do usuário.

Ferramenta: GROQCLOUD_LIST_VOICES

Retorna o conjunto de vozes TTS suportadas. Nota: esta é uma lista estática mantida manualmente.

---

Armadilhas Conhecidas

Armadilha	Detalhes
Lista de modelos aninhada	A resposta de GROQCLOUD_LIST_MODELS pode estar aninhada em response['data']['data'] — não assuma um array plano de nível superior
IDs de modelo fixos quebram	Sempre busque IDs de modelo dinamicamente via GROQCLOUD_LIST_MODELS; nomes fixos podem quebrar quando modelos forem depreciados ou renomeados
Validação de formato de áudio	GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION rejeita formatos de áudio inválidos ou não suportados silenciosamente — valide as entradas antes de chamar
Metadados do modelo mudam	Dados de GROQCLOUD_GROQ_RETRIEVE_MODEL (janela de contexto, recursos) podem mudar à medida que os modelos são atualizados — não trate como estático
Alterações nas vozes TTS	Conjuntos de vozes de GROQCLOUD_LIST_VOICES podem diminuir ou renomear ao longo do tempo — lide com vozes ausentes de forma elegante

---

Referência Rápida

Slug da Ferramenta	Propósito
GROQCLOUD_LIST_MODELS	Listar todos os modelos disponíveis e metadados
GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION	Gerar completações de IA baseadas em chat
GROQCLOUD_GROQ_RETRIEVE_MODEL	Obter informações detalhadas para um modelo específico
GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION	Traduzir áudio não-inglês para texto em inglês
GROQCLOUD_LIST_VOICES	Recuperar vozes TTS disponíveis para PlayAI

---

Desenvolvido por Composio