> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt > Use this file to discover all available pages before exploring further. # Agent 연동 > AIHubMix가 AI Agent에 제공하는 전체 연동 엔트리: agents.md 연동 가이드, llms.txt 기계 판독 인덱스, 모델별 llms.txt 호출 가이드, Playground Skill, Playground 딥링크. 항목마다 복사 가능한 명령 한 줄을 제공합니다. AIHubMix는 AI Agent(Claude Code, Codex, Cursor, Cline 등 코딩 어시스턴트)를 위한 기계 판독형 연동 엔트리를 제공합니다. Agent는 모델 발견, 호출 코드 생성, 연결 검증을 스스로 수행하고, 구성이 완료된 Playground 링크를 사용자에게 전달할 수 있습니다. 이 페이지는 전체 엔트리를 정리하며, 항목마다 복사 가능한 명령 한 줄을 제공합니다. ## 한 문장으로 시작하기 아래 문장을 AI Agent에게 보내세요: ```text theme={null} Fetch https://aihubmix.com/agents.md and follow it. ``` `agents.md`는 Agent가 직접 실행하도록 작성된 연동 가이드입니다: API Key 확인, 실시간 카탈로그에서 모델 선택, 프로토콜별 호출, 엔드투엔드 검증 단계를 담고 있으며 문제 해결 표도 포함합니다. ## 엔트리 개요 | 엔트리 | 주소 | 용도 | | ---------------- | ----------------------------------------------------------- | ------------------------------------------------------------ | | Agent 연동 가이드 | `https://aihubmix.com/agents.md` | Agent가 스스로 연동과 검증을 완료하는 단계별 가이드 | | 사이트 기계 판독 인덱스 | `https://aihubmix.com/llms.txt` | 사이트 전체 기능과 문서에 대한 LLM 판독형 인덱스 | | 문서 기계 판독 인덱스 | `https://docs.aihubmix.com/llms.txt` | 문서 사이트 전체 페이지 인덱스, 문서 페이지 주소 뒤에 `.md`를 붙이면 플레인 텍스트를 가져올 수 있음 | | 모델별 호출 가이드 | `https://aihubmix.com/model/{model_id}/llms.txt` | 개별 모델의 가격, 검증된 기능, 프로토콜 엔드포인트, 실행 가능한 예제 | | Playground Skill | `https://aihubmix.com/skills/playground` | 모델 체험, 파라미터 조정, 모델 비교, 미디어 생성을 위한 Agent 스킬 파일 | | 실시간 모델 카탈로그 | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | 인증 없이 접근 가능한 JSON, 가격과 메타데이터 포함 | ## 모델별 llms.txt 모든 모델에는 가격, 검증된 기능 목록, 지원 프로토콜 엔드포인트, 실행 가능한 예제를 포함한 기계 판독형 호출 가이드가 있습니다: ```bash theme={null} curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt ``` 모델 상세 페이지의 `llms.txt` 탭에서 해당 파일을 바로 열 수 있습니다. 아직 검증이 완료되지 않은 모델은 실시간 카탈로그와 파라미터 schema를 안내하는 문서를 반환하며, 검증되지 않은 기능 설명은 포함하지 않습니다. ## Playground Skill Playground의 기능(모델 체험, 파라미터 조정, 동일 프롬프트 비교, 이미지 및 비디오 생성, 딥링크 전달)을 Agent에게 맡기세요: ```text theme={null} Run curl -fsSL https://aihubmix.com/skills/playground and follow it. ``` Skill은 `/.well-known/skills/aihubmix-playground/SKILL.md`에도 게시되어 있으며, [GitHub 저장소](https://github.com/AIhubmix/skills)를 통해 `npx skills add AIhubmix/skills` 명령으로 설치할 수도 있습니다. 연동 및 통합 시나리오에는 [AIHubMix API Skill](/ko/skills)을 사용하세요. ## Playground 딥링크 Agent는 사용자가 브라우저에서 이미 구성된 Playground 세션을 이어받을 수 있도록 바로가기 링크를 생성할 수 있습니다: * 다중 모델 비교: `https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1` (최대 6개) * 구성 바로가기: `https://playground.aihubmix.com/?config=`, JSON 형식은 `{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}`이며, `draft`는 입력창에 미리 채워질 뿐 전송되지 않습니다 링크 파라미터는 일회성입니다: 페이지가 로드되면 주소창의 파라미터는 즉시 제거되며, 어떤 키도 포함하지 않습니다. ## 코드 생성 npm 패키지 [`@aihubmix/codegen`](https://www.npmjs.com/package/@aihubmix/codegen)은 4개 프로토콜, 7개 언어의 프로그래밍 방식 코드 생성을 제공하며, 생성되는 요청 본문은 Playground가 실제로 전송하는 요청 본문과 동일합니다. [`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema)는 파라미터 schema를 codegen 입력으로 변환합니다. ## 자주 묻는 질문 ### Agent는 연동 성공을 어떻게 검증하나요? `agents.md`에는 엔드투엔드 검증 단계가 포함되어 있습니다: 정확한 응답을 요구하는 최소 요청을 보내고, 응답 본문과 모델의 회신 내용을 확인합니다. HTTP 200이 곧 성공을 의미하지 않으므로 응답 내용을 반드시 확인해야 합니다. ### 호출에는 어떤 자격 증명이 필요한가요? AIHubMix API Key 하나가 필요하며, 환경 변수 `AIHUBMIX_API_KEY`로 전달합니다. Key는 [콘솔](https://console.aihubmix.com/token)에서 생성할 수 있습니다. Key를 코드, 스크립트, 대화에 작성하지 마세요. ### 모델별 llms.txt는 어떤 모델을 지원하나요? 검증이 완료된 모델은 전체 문서(공식 검증 데이터 기반의 기능 목록)를 반환하며, 나머지 모델은 안내 문서를 반환합니다. 지원 범위는 검증 진행에 따라 확대됩니다. ### 현재 MCP 지원 상황은 어떤가요? MCP 엔드포인트는 현재 이미지 생성 서비스를 제공하며, 기능 확장이 진행 중입니다. 현재 단계에서는 Skill과 agents.md를 우선 사용해 연동하는 것을 권장합니다. *** 마지막 업데이트: 2026-08-20