> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hugging Face

> モデル、データセット、Spaces、推論、コレクション、議論、論文、リポジトリ管理

# Hugging Face

ShanoneのHugging Face連携では、Hubのほぼ全機能——モデル、データセット、Spaces、サーバーレス推論、推論エンドポイント、コレクション、議論/PR、論文、リポジトリ操作、セキュリティスキャン、Webhookを扱う87のツールをエージェントが利用できるようになります。

## はじめに

<Steps>
  <Step title="Hugging Face アクセストークンを取得する">
    Hugging Faceアカウントの**Settings → Access Tokens**からトークンを生成します。
  </Step>

  <Step title="Shanoneに登録する">
    Shanoneダッシュボードの**Integrations**を開き、Hugging Faceを選択してアクセストークンを貼り付けます。
  </Step>

  <Step title="リクエストを再試行する">
    保存が完了すると、`huggingface_*`ツールへの`shanone_execute_tool`呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

ShanoneはHugging Face用に**87のツール**を提供しており、以下のカテゴリに分類されています。

<AccordionGroup>
  <Accordion title="モデル">
    `huggingface_list_models`, `huggingface_get_model_info`, `huggingface_list_user_models`, `huggingface_create_model_repo`, `huggingface_delete_model_repo`, `huggingface_update_model_settings`
  </Accordion>

  <Accordion title="データセット">
    `huggingface_list_datasets`, `huggingface_get_dataset_info`, `huggingface_create_dataset_repo`, `huggingface_delete_dataset_repo`, `huggingface_get_dataset_rows`, `huggingface_filter_dataset_rows`, `huggingface_search_dataset`, `huggingface_get_dataset_statistics`, `huggingface_get_dataset_splits`, `huggingface_get_dataset_size`, `huggingface_list_parquet_files`
  </Accordion>

  <Accordion title="Spaces">
    `huggingface_list_spaces`, `huggingface_get_space_info`, `huggingface_create_space_repo`, `huggingface_delete_space_repo`, `huggingface_restart_space`, `huggingface_pause_space`
  </Accordion>

  <Accordion title="推論">
    `huggingface_text_generation`, `huggingface_text_classification`, `huggingface_feature_extraction`, `huggingface_chat_completion`, `huggingface_image_classification`, `huggingface_summarization`, `huggingface_text_to_image`, `huggingface_image_to_text`, `huggingface_translation`, `huggingface_question_answering`, `huggingface_zero_shot_classification`, `huggingface_token_classification`, `huggingface_fill_mask`, `huggingface_automatic_speech_recognition`
  </Accordion>

  <Accordion title="推論エンドポイント">
    `huggingface_list_inference_endpoints`, `huggingface_get_inference_endpoint`, `huggingface_create_inference_endpoint`, `huggingface_update_inference_endpoint`, `huggingface_delete_inference_endpoint`, `huggingface_pause_inference_endpoint`, `huggingface_resume_inference_endpoint`, `huggingface_scale_inference_endpoint`
  </Accordion>

  <Accordion title="リポジトリ操作">
    `huggingface_create_branch`, `huggingface_delete_branch`, `huggingface_create_tag`, `huggingface_delete_tag`, `huggingface_list_repo_refs`, `huggingface_list_commits`, `huggingface_list_repo_files`
  </Accordion>

  <Accordion title="コレクション">
    `huggingface_create_collection`, `huggingface_list_collections`, `huggingface_get_collection`, `huggingface_add_to_collection`, `huggingface_remove_from_collection`, `huggingface_delete_collection`
  </Accordion>

  <Accordion title="議論 & プルリクエスト">
    `huggingface_create_discussion`, `huggingface_list_discussions`, `huggingface_get_discussion`, `huggingface_create_discussion_comment`, `huggingface_change_discussion_status`, `huggingface_merge_pull_request`
  </Accordion>

  <Accordion title="論文">
    `huggingface_search_papers`, `huggingface_get_daily_papers`, `huggingface_get_paper`, `huggingface_list_paper_comments`, `huggingface_create_paper_comment`
  </Accordion>

  <Accordion title="セキュリティ & アクセス申請">
    `huggingface_get_security_scan`, `huggingface_request_repo_access`, `huggingface_list_access_requests`, `huggingface_handle_access_request`
  </Accordion>

  <Accordion title="組織 & ユーザー">
    `huggingface_get_organization`, `huggingface_list_organization_members`, `huggingface_get_organization_repos`, `huggingface_get_user_info`
  </Accordion>

  <Accordion title="Webhook & 利用状況">
    `huggingface_create_webhook`, `huggingface_list_webhooks`, `huggingface_get_webhook`, `huggingface_update_webhook`, `huggingface_enable_webhook`, `huggingface_disable_webhook`, `huggingface_delete_webhook`, `huggingface_get_billing_usage`, `huggingface_get_compute_usage`, `huggingface_get_storage_usage`
  </Accordion>
</AccordionGroup>

## よくある使い方

<CardGroup cols={2}>
  <Card title="モデル/データセットの調査" icon="search">
    タスクやタグでモデル・データセットを検索し、用途に最も適したものを要約する
  </Card>

  <Card title="サーバーレス推論" icon="cpu">
    自前のモデルをホストせずにテキスト生成・分類・画像タスクを直接実行する
  </Card>

  <Card title="エンドポイントのライフサイクル管理" icon="server">
    専用の推論エンドポイントを立ち上げ、スケールし、アイドル時は一時停止してコストを抑える
  </Card>

  <Card title="リポジトリメンテナンス" icon="git-branch">
    ブランチ/タグを管理し、議論やPRをレビューし、マージ前にセキュリティスキャン結果を確認する
  </Card>
</CardGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="huggingface_text_generationなど推論呼び出しが503を返す">
    サーバーレス推論APIのモデルはコールドスタート状態でロードが必要な場合があります——少し待ってから再試行するか、頻繁に呼び出すモデルには`huggingface_create_inference_endpoint`を使ってコールドスタートを完全に回避してください。
  </Accordion>

  <Accordion title="大きなデータセットでhuggingface_get_dataset_rowsが遅い、またはタイムアウトする">
    行単位で大きなデータセット全体をページングするより、具体的な条件を指定した`huggingface_filter_dataset_rows`、または`huggingface_list_parquet_files`と独自処理の組み合わせを優先してください。
  </Accordion>

  <Accordion title="huggingface_create_model_repoやデータセット/Space版で権限エラーが発生する">
    組織のネームスペース下でリポジトリを作成するには、トークンのアカウントがその組織の書き込み権限を持つメンバーである必要があります——`huggingface_list_organization_members`で確認するか、代わりに個人のネームスペース下で作成してください。
  </Accordion>
</AccordionGroup>