GroqCloud Automation(GroqCloudオートメーション)
GroqCloudの超高速API(チャット補完、モデル発見、音声翻訳、TTS音声選択)をComposio MCP統合を通じて自動化し、AI推論ワークフローを効率化します。
ツールキットドキュメント: composio.dev/toolkits/groqcloud
セットアップ
- Composio MCPサーバー(
https://rube.app/mcp)からGroqCloudアカウントを接続します。 - アクティブな接続がない場合、エージェントが認証リンクを提示します。
- 接続が完了すると、すべての
GROQCLOUD_*ツールが実行可能になります。
コアワークフロー
1. 利用可能モデルの表示
GroqCloudで利用可能な全モデルをリストし、推論実行前に有効なモデルIDを確認します。
ツール: GROQCLOUD_LIST_MODELS
パラメータは不要です。すべてのモデルとメタデータを返します。
チャット補完を呼び出す前に必ずこのツールを実行し、有効で非推奨ではないモデルIDを参照するようにしてください。
2. チャット補完の実行
指定したGroqCloudモデルを使用して、会話プロンプトに対するAI応答を生成します。
ツール: GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | GROQCLOUD_LIST_MODELSで取得したモデルID |
messages | array | はい | {role, content}オブジェクトの順序付きリスト(system、user、assistant) |
temperature | number | いいえ | サンプリング温度 0-2(デフォルト: 1) |
max_completion_tokens | integer | いいえ | 生成する最大トークン数 |
top_p | number | いいえ | 核サンプリング 0-1(デフォルト: 1) |
stop | string/array | いいえ | 最大4つの停止シーケンス |
stream | boolean | いいえ | SSEストリーミングを有効にする(デフォルト: false) |
3. モデル詳細の確認
特定モデルのコンテキストウィンドウや機能など、詳細なメタデータを取得します。
ツール: GROQCLOUD_GROQ_RETRIEVE_MODEL
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | はい | モデル識別子(例: groq-1-large) |
4. 音声の英語翻訳
英語以外の音声ファイルをWhisperモデルを使用して英語テキストに翻訳します。
ツール: GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
file_path | string | はい | 音声ファイルのローカルパス、HTTP(S) URL、またはbase64データURL |
model | string | いいえ | モデルID(デフォルト: whisper-large-v3)。注: whisper-large-v3-turboは翻訳をサポートしていない可能性があります |
response_format | string | いいえ | json、verbose_json、またはtext(デフォルト: json) |
temperature | number | いいえ | サンプリング温度 0-1(デフォルト: 0) |
5. TTS音声のリスト表示
Groq PlayAIモデルで利用可能なテキスト読み上げ音声を列挙し、音声選択UIを駆動します。
ツール: GROQCLOUD_LIST_VOICES
サポートされているTTS音声のセットを返します。注: これは手動で管理される静的リストです。
既知の問題点
| 問題点 | 詳細 |
|---|---|
| モデルリストのネスト | GROQCLOUD_LIST_MODELSのレスポンスはresponse['data']['data']のようにネストされている場合があります。単純なトップレベルの配列を想定しないでください |
| ハードコードされたモデルIDの破損 | 常にGROQCLOUD_LIST_MODELSでモデルIDを動的に取得してください。ハードコードされた名前は、モデルが非推奨になったり名前が変更されたりすると機能しなくなります |
| 音声フォーマットの検証 | GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATIONは無効またはサポートされていない音声フォーマットを警告なく拒否します。呼び出し前に入力を検証してください |
| モデルメタデータの変更 | GROQCLOUD_GROQ_RETRIEVE_MODELから取得したデータ(コンテキストウィンドウ、機能など)はモデル更新により変化する可能性があります。静的なものとして扱わないでください |
| TTS音声の変更 | GROQCLOUD_LIST_VOICESの音声セットは時間の経過とともに減少したり名前が変わったりする可能性があります。存在しない音声には適切に対処してください |
クイックリファレンス
| ツールスラッグ | 目的 |
|---|---|
GROQCLOUD_LIST_MODELS | 利用可能なすべてのモデルとそのメタデータを一覧表示 |
GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION | チャットベースのAI補完を生成 |
GROQCLOUD_GROQ_RETRIEVE_MODEL | 特定モデルの詳細情報を取得 |
GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION | 英語以外の音声を英語テキストに翻訳 |
GROQCLOUD_LIST_VOICES | PlayAIで利用可能なTTS音声を取得 |
Powered by Composio