Hugging Face

Visão geral

O Hugging Face é a principal plataforma open source de machine learning, onde equipes criam, treinam e fazem deploy de modelos de linguagem, modelos de visão, datasets e aplicações de IA. Com a integração no SquadOS, seus agentes podem executar inferência via chat completion compatível com OpenAI, gerar embeddings de texto, pesquisar e explorar modelos e datasets do Hub, criar repositórios, gerenciar discussões e acompanhar os artigos científicos mais recentes da comunidade de IA.

• Site oficial: https://huggingface.co/
• Documentação na Composio: docs.composio.dev/toolkits/hugging_face

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) ou OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Token de acesso do Hugging Face (User Access Token), obtido em Settings → Access Tokens na sua conta.

Como obter a credencial

1. Acesse huggingface.co e faça login (ou crie uma conta).
2. Clique no seu avatar no canto superior direito e vá em Settings.
3. No menu lateral, clique em Access Tokens.
4. Clique em New token, escolha um nome descritivo e selecione o escopo Write (necessário para criar repositórios e commits) ou Read (somente leitura).
5. Clique em Generate token e copie o valor exibido — esse é o seu api_key.

Dica

Use tokens com o menor escopo necessário. Para operações somente de leitura (pesquisa, inferência pública), um token com escopo Read é suficiente e mais seguro.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Hugging Face.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa o token de acesso obtido acima (ou autoriza via OAuth 2.0).
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Nota

Esta integração expõe 135 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Gerar resposta de chat

HUGGING_FACE_GENERATE_CHAT_COMPLETION

Gera uma resposta a partir de uma lista de mensagens em contexto conversacional. Suporta modelos de linguagem (LLMs) e modelos de visão-linguagem (VLMs). Compatível com o SDK da OpenAI.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
model	string	Sim	ID do modelo a usar para o chat completion. Formato: namespace/modelo ou namespace/modelo:provedor. Exemplos: meta-llama/Llama-3.2-3B-Instruct, Qwen/Qwen2.5-7B-Instruct-1M.
messages	array	Sim	Lista de mensagens que compõem a conversa até o momento. Cada mensagem tem um papel (system, user, assistant, tool) e conteúdo.
temperature	number	Não	Temperatura de amostragem entre 0 e 2. Valores altos como 0,8 tornam a saída mais aleatória; valores baixos como 0,2 tornam a saída mais focada e determinista.
max_tokens	integer	Não	Número máximo de tokens a gerar. Se não especificado, o modelo gera até um ponto de parada natural.
stream	boolean	Não	Se deve transmitir a resposta como Server-Sent Events. Se true, os tokens são retornados conforme gerados.
tools	array	Não	Lista de ferramentas que o modelo pode chamar. Atualmente, apenas funções são suportadas.
top_p	number	Não	Alternativa à temperatura via nucleus sampling. O modelo considera tokens que compõem os top_p% da massa de probabilidade.
response_format	string	Não	Formato da resposta: text (padrão), json_object para modo JSON, ou json_schema para saída estruturada.
seed	integer	Não	Semente aleatória para amostragem determinista. Usar a mesma semente com os mesmos parâmetros deve produzir a mesma saída.
stop	array	Não	Até 4 sequências onde a API para de gerar tokens. O texto retornado não conterá a sequência de parada.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Gerar embeddings de texto

HUGGING_FACE_GENERATE_EMBEDDINGS

Converte texto em vetores de embedding para extração de features, busca semântica e tarefas de similaridade. Use quando precisar de representações numéricas de texto para aplicações de ML.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
inputs	array	Sim	Array de strings de texto a converter em embeddings. Cada string será processada e retornada como um vetor numérico.
model	string	Não	ID do modelo do Hugging Face a usar para gerar os embeddings. Deve ser um modelo de embedding válido do Hub.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar repositório

HUGGING_FACE_CREATE_REPO

Cria um novo repositório (modelo, dataset ou Space) no Hugging Face Hub. Use para inicializar um novo repositório para upload de modelos, datasets ou deploy de aplicações em Spaces.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do repositório a criar. Será o identificador dentro do namespace.
type	string	Não	Tipo de repositório: model, dataset ou space. Padrão: model.
private	boolean	Não	Se o repositório deve ser privado. Se não especificado, segue a configuração de visibilidade padrão da conta.
organization	string	Não	Namespace da organização para criar o repositório. Se não fornecido, o repositório é criado no namespace pessoal.
sdk	string	Não	SDK para Spaces: gradio, streamlit, docker ou static.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter informações do modelo

HUGGING_FACE_GET_MODEL_INFO

Recupera informações detalhadas sobre um repositório de modelo do Hugging Face. Use quando precisar de metadados abrangentes, incluindo downloads, curtidas, tags, configuração, arquivos e mais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório do modelo. Por exemplo, bert-base-uncased em google-bert/bert-base-uncased.
namespace	string	Sim	Namespace (organização ou usuário) proprietário do repositório. Por exemplo, google-bert em google-bert/bert-base-uncased.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar datasets

HUGGING_FACE_LIST_DATASETS

Lista datasets no Hugging Face Hub. Use para descobrir ou buscar datasets. Suporta filtragem por autor, consulta de busca, tags e ordenação por diversas propriedades.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
search	string	Não	Filtra por substrings em nomes de dataset e nomes de usuário. Use para buscar datasets por palavra-chave.
author	string	Não	Filtra datasets por autor ou organização.
filter	string	Não	Filtra por tags. Use para encontrar datasets com tags específicas de tipo de tarefa, idiomas ou licenças.
sort	string	Não	Propriedade de ordenação: lastModified, trending, likes ou downloads.
limit	integer	Não	Limite de datasets retornados. Padrão: 100.
cursor	string	Não	Cursor de paginação para buscar a próxima página de resultados.
direction	string	Não	Direção de ordenação: asc ou desc.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar em dataset

HUGGING_FACE_SEARCH_DATASET

Pesquisa texto em um split de dataset no Hugging Face. Busca em colunas do tipo string, mesmo que os valores estejam aninhados em dicionários. Use quando precisar encontrar texto ou padrões específicos dentro do conteúdo de um dataset.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
dataset	string	Sim	Nome do dataset. Use o formato proprietario/nome-dataset para datasets de usuários ou apenas nome-dataset para datasets oficiais.
config	string	Sim	Nome da configuração/subconjunto do dataset.
split	string	Sim	Nome do split do dataset a pesquisar.
query	string	Sim	Texto a buscar no dataset. Pesquisa em todas as colunas do tipo string, mesmo que os valores estejam aninhados em dicionários.
length	integer	Não	Comprimento do slice (número de linhas a retornar). Valor máximo: 100.
offset	integer	Não	Deslocamento do slice para paginação. Padrão: 0.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter primeiras linhas do dataset

HUGGING_FACE_GET_DATASET_FIRST_ROWS

Obtém as primeiras 100 linhas de um split de dataset junto com os tipos de dados e features das colunas. Use para visualizar ou amostrar o conteúdo de um dataset.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
dataset	string	Sim	Nome do dataset no formato namespace/nome. Por exemplo, cornell-movie-review-data/rotten_tomatoes ou squad.
config	string	Sim	Nome da configuração/subconjunto do dataset. Use default para datasets sem configurações.
split	string	Sim	Nome do split do dataset do qual recuperar as linhas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter informações do dataset

HUGGING_FACE_GET_DATASET_INFO

Obtém informações gerais sobre um dataset, incluindo descrição, citação, página inicial, licença e features (esquemas de colunas). Use para entender a estrutura do dataset, os splits disponíveis e os metadados antes de trabalhar com os dados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
dataset	string	Sim	Nome do dataset. Formato: namespace/nome-repo (ex.: rajpurkar/squad, ibm/duorc).
config	string	Não	Nome da configuração/subconjunto a recuperar. Se não fornecido, retorna informações da configuração padrão.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Filtrar linhas do dataset

HUGGING_FACE_FILTER_DATASET_ROWS

Filtra linhas de um dataset no Hugging Face com base em critérios especificados. Use quando precisar recuperar linhas específicas de um dataset com base em condições de coluna.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
where	string	Sim	Condição de filtro no formato de expressão SQL (ex.: column = 'value').
split	string	Sim	Nome do split do dataset.
config	string	Sim	Nome da configuração/subconjunto do dataset.
dataset	string	Sim	Nome do dataset no formato namespace/nome.
length	integer	Não	Número máximo de linhas a retornar.
offset	integer	Não	Número de linhas a pular para paginação.
orderby	string	Não	Coluna pela qual ordenar os resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter informações do Space

HUGGING_FACE_GET_SPACE_INFO

Recupera informações detalhadas sobre um repositório Space do Hugging Face. Use para obter metadados, tipo de SDK, configuração de hardware, status de runtime ou outras informações sobre um Space específico.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo_id	string	Sim	ID do repositório Space no formato autor/nome-space (ex.: Qwen/Qwen3-TTS, stabilityai/stable-diffusion).
revision	string	Não	Revisão Git (branch, tag ou SHA de commit) para recuperar informações. Padrão: branch principal.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar Spaces no Hugging Face Hub

HUGGING_FACE_LIST_SPACES

Lista Spaces no Hugging Face Hub com opções de filtragem. Use para descobrir ou buscar aplicações de demonstração de ML hospedadas no Hugging Face.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
search	string	Não	Filtra por substrings em nomes de repositórios e nomes de usuários.
author	string	Não	Filtra Spaces por um autor ou organização específico.
filter	string	Não	Filtra por tags (ex.: gradio, streamlit).
sort	string	Não	Propriedade de ordenação: lastModified, likes, trending ou created.
limit	integer	Não	Número máximo de Spaces a retornar. Deve estar entre 1 e 500.
direction	string	Não	Direção da ordenação: 1 para crescente ou -1 para decrescente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar endpoints de inferência

HUGGING_FACE_LIST_ENDPOINTS

Lista os Inference Endpoints do Hugging Face para um usuário ou organização específico. Use para recuperar endpoints, opcionalmente filtrados por tags ou nome.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
namespace	string	Sim	Nome do usuário ou organização para listar os endpoints.
search	string	Não	Filtra endpoints por substring do nome.
tags	string	Não	Filtra endpoints por tags (separadas por vírgula).
limit	integer	Não	Número máximo de endpoints a retornar por página. Padrão: 20.
cursor	string	Não	Cursor de paginação para buscar a próxima ou página anterior de resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar artigos científicos

HUGGING_FACE_SEARCH_PAPERS

Realiza busca semântica/híbrida em artigos científicos no Hugging Face. Use quando precisar encontrar artigos de pesquisa por palavras-chave, tópicos ou autores.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Não	String de consulta para encontrar artigos relevantes. Use palavras-chave, títulos ou tópicos. Suporta busca semântica e texto completo híbrida.
limit	integer	Não	Número máximo de artigos a retornar. Se não especificado, usa o limite padrão da API.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter artigos diários

HUGGING_FACE_GET_DAILY_PAPERS

Recupera os artigos diários do Hugging Face. Use para buscar os mais recentes artigos de pesquisa em IA/ML compartilhados na plataforma.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
date	string	Não	Filtra artigos por data específica (formato YYYY-MM-DD).
sort	string	Não	Opção de ordenação para artigos diários: publishedAt ou trending.
limit	integer	Não	Número máximo de artigos a retornar por página. Padrão: 50.
month	string	Não	Filtra artigos por mês específico (formato YYYY-MM).
submitter	string	Não	Filtra artigos por nome de usuário do submissor.
p	integer	Não	Número da página para paginação (índice baseado em 0). Padrão: 0.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar documentação

HUGGING_FACE_SEARCH_DOCS

Pesquisa na documentação do Hugging Face em todos os produtos e bibliotecas. Use para encontrar informações sobre ferramentas HF, modelos, datasets ou uso da API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Sim	String de consulta de busca para encontrar páginas de documentação relevantes. Use palavras-chave relacionadas ao tópico.
limit	integer	Não	Número máximo de resultados a retornar. Padrão: 10.
offset	integer	Não	Número de resultados a pular para paginação.
product	string	Não	Produto HF para filtrar a busca de documentação (ex.: hub, transformers, diffusers, datasets, gradio).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter repositórios em alta

HUGGING_FACE_GET_TRENDING

Recupera os repositórios em alta no Hugging Face. Use para descobrir modelos, datasets ou Spaces populares que estão atualmente em destaque na plataforma.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
type	string	Não	Filtro de tipo de repositório: all, dataset, model ou space.
limit	integer	Não	Número máximo de repositórios em alta a retornar. Padrão: 10.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter informações do usuário autenticado

HUGGING_FACE_GET_WHOAMI

Obtém informações sobre o usuário autenticado no Hugging Face, incluindo nome de usuário, e-mail, organizações e detalhes do token. Use para identificar o usuário atual a partir de um token de acesso ou recuperar informações do perfil.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar discussão

HUGGING_FACE_CREATE_DISCUSSIONS

Cria uma nova discussão em um repositório do Hugging Face (modelo, dataset ou Space). Use para iniciar uma conversa, reportar um problema ou criar uma pull request de discussão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório onde a discussão será criada.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, spaces ou datasets.
title	string	Sim	Título da discussão. Deve ter entre 3 e 200 caracteres.
description	string	Sim	Conteúdo/descrição da discussão. Pode conter formatação Markdown. Máximo: 65.536 caracteres.
pull_request	boolean	Não	Se a discussão deve ser criada como pull request.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Comentar em discussão

HUGGING_FACE_CREATE_DISCUSSIONS_COMMENT

Cria um novo comentário em uma discussão de repositório do Hugging Face. Use para adicionar comentários ou respostas em discussões sobre modelos, datasets ou Spaces.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório onde a discussão existe. Por exemplo, gpt2 ou my-dataset.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, spaces ou datasets.
num	string	Sim	Número ou ID da discussão a comentar.
comment	string	Sim	Texto do comentário a publicar na discussão. Deve ter entre 1 e 65.536 caracteres.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Alterar status da discussão

HUGGING_FACE_CHANGE_DISCUSSIONS_STATUS

Altera o status de uma discussão em um repositório do Hugging Face. Use quando precisar abrir ou fechar discussões em modelos, datasets ou Spaces.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
num	string	Sim	Número ou ID da discussão a alterar o status.
repo	string	Sim	Nome do repositório onde a discussão existe. Por exemplo, bert-base-uncased ou my-dataset.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, spaces ou datasets.
status	string	Sim	Novo status da discussão: open para reabrir ou closed para fechar.
comment	string	Não	Comentário opcional a adicionar ao alterar o status.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar discussões

HUGGING_FACE_LIST_DISCUSSIONS

Lista todas as discussões de um repositório do Hugging Face. Use para recuperar discussões abertas, fechadas ou pull requests de um modelo, dataset ou Space.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, spaces ou datasets.
status	string	Não	Filtra pelo status da discussão: open, closed ou all.
type	string	Não	Filtra pelo tipo: discussion ou pull_request.
p	integer	Não	Número da página para paginação (índice baseado em 0).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar coleção

HUGGING_FACE_CREATE_COLLECTION

Cria uma nova coleção no Hugging Face. Use para organizar e curar modelos, datasets, Spaces, artigos ou outras coleções em uma coleção nomeada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
namespace	string	Sim	Namespace (nome de usuário ou organização) sob o qual criar a coleção.
title	string	Sim	Título da coleção. Deve ter entre 1 e 60 caracteres.
description	string	Não	Descrição opcional para a coleção. Máximo: 150 caracteres.
private	boolean	Não	Se não fornecido, a coleção será pública.
item	object	Não	Item a ser adicionado à coleção na criação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar coleções

HUGGING_FACE_LIST_COLLECTIONS

Lista coleções no Hugging Face Hub. Use para descobrir coleções de modelos, datasets, Spaces ou artigos. Coleções são grupos curados de repositórios organizados por usuários.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
owner	string	Não	Filtra coleções por nome de usuário ou organização proprietário.
item	string	Não	Filtra coleções que contêm um item específico (formato: tipo/namespace/repo).
sort	string	Não	Critério de ordenação das coleções.
limit	integer	Não	Número máximo de coleções a retornar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar arquivos do repositório

HUGGING_FACE_LIST_REPO_TREE

Lista arquivos e diretórios em um repositório do Hugging Face Hub. Use para explorar a estrutura de um repositório de modelo, dataset ou Space.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, spaces ou datasets.
path	string	Não	Caminho específico dentro do repositório para listar. Se omitido, lista a raiz.
rev	string	Não	Revisão Git (branch, tag ou commit hash). Padrão: branch principal.
recursive	boolean	Não	Se deve listar arquivos recursivamente em subdirectórios.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar commit em dataset

HUGGING_FACE_CREATE_DATASETS_COMMIT

Cria um commit em um repositório de dataset do Hugging Face. Use para adicionar, atualizar ou excluir arquivos em um dataset. Suporta arquivos regulares e Large File Storage (LFS) para arquivos binários grandes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório do dataset.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do dataset.
branch	string	Sim	Branch onde o commit será criado.
commit_message	string	Sim	Mensagem do commit (máximo: 500 caracteres).
operations	array	Sim	Lista de operações de arquivo a executar. Cada operação especifica o caminho e o conteúdo do arquivo.
create_pr	boolean	Não	Se deve criar uma pull request em vez de commitar diretamente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar commit em modelo

HUGGING_FACE_CREATE_MODELS_COMMIT

Cria um commit em um repositório de modelo do Hugging Face. Use para adicionar, atualizar ou excluir arquivos de modelo. Suporta LFS para arquivos grandes como pesos de modelo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório do modelo.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do modelo.
branch	string	Sim	Branch onde o commit será criado.
commit_message	string	Sim	Mensagem do commit (máximo: 500 caracteres).
operations	array	Sim	Lista de operações de arquivo a executar.
create_pr	boolean	Não	Se deve criar uma pull request em vez de commitar diretamente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar commit em Space

HUGGING_FACE_CREATE_SPACES_COMMIT

Cria um commit em um repositório Space do Hugging Face. Use para adicionar, atualizar ou excluir arquivos de um Space. Suporta criação de pull request opcional em vez de commit direto.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório Space.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do Space.
branch	string	Sim	Branch onde o commit será criado.
commit_message	string	Sim	Mensagem do commit (máximo: 500 caracteres).
operations	array	Sim	Lista de operações de arquivo a executar.
create_pr	boolean	Não	Se deve criar uma pull request em vez de commitar diretamente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar notificações

HUGGING_FACE_LIST_NOTIFICATIONS

Lista as notificações do usuário autenticado no Hugging Face. Use para monitorar atividades relevantes em repositórios seguidos, discussões e pull requests.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
type	string	Não	Filtra por tipo de notificação.
status	string	Não	Filtra por status da notificação: read ou unread.
p	integer	Não	Número da página para paginação (índice baseado em 0).
limit	integer	Não	Número máximo de notificações a retornar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar ou atualizar secret do Space

HUGGING_FACE_CREATE_OR_UPDATE_SPACE_SECRET

Cria ou atualiza um secret em um Space do Hugging Face. Use para gerenciar variáveis de ambiente sensíveis, como chaves de API e tokens usados pelo Space.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório Space.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do Space.
key	string	Sim	Nome do secret (chave).
value	string	Sim	Valor do secret.
description	string	Não	Descrição opcional do secret.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Solicitar acesso ao repositório

HUGGING_FACE_REQUEST_ACCESS

Envia uma solicitação de acesso para um repositório com acesso controlado (gated) no Hugging Face. Use quando precisar solicitar acesso a modelos ou datasets com acesso restrito.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
repo	string	Sim	Nome do repositório cujo acesso está sendo solicitado.
namespace	string	Sim	Namespace (nome de usuário ou organização) proprietário do repositório.
repo_type	string	Sim	Tipo do repositório: models, datasets ou spaces.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.