GroqCloud 자동화
GroqCloud의 초고속 API를 사용하여 AI 추론 워크플로우를 자동화합니다. 채팅 완성, 모델 탐색, 오디오 번역 및 TTS 음성 선택을 모두 Composio MCP 통합을 통해 오케스트레이션합니다.
툴킷 문서: composio.dev/toolkits/groqcloud
설정
https://rube.app/mcp에서 Composio 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 모델에 사용 가능한 텍스트 음성 변환 음성을 열거하여 음성 선택 UX를 지원합니다.
도구: 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 음성 검색 |
Composio 제공