O que lark-openapi-explorer faz?
Exploração de OpenAPI nativa do Feishu/Lark: descobre interfaces OpenAPI nativas da documentação oficial que não foram encapsuladas pela CLI. Use quando as necessidades do usuário não podem ser atendidas pelos skills lark-* existentes ou pelos comandos registrados do lark-cli, sendo necessário encontrar e invocar a OpenAPI nativa do Feishu.
Visão Geral
Este skill consulta a documentação oficial do Feishu OpenAPI para localizar endpoints que ainda não estão disponíveis como comandos CLI ou skills dedicados. Ele extrai o schema da API, parâmetros e exemplos de uso, permitindo que o agente construa e execute requisições HTTP personalizadas.
Como usar
- Identificação da necessidade: Quando o usuário solicita uma operação não coberta pelos comandos
lark-cliou skills comolark-doc,lark-sheetetc. - Pesquisa: O skill pesquisa na documentação oficial (https://open.feishu.cn/document) por palavras-chave relacionadas.
- Resultados: Retorna os endpoints encontrados, incluindo método HTTP, caminho, parâmetros e descrição.
- Execução: O agente pode então invocar o endpoint usando
curlou SDK, utilizando as credenciais previamente configuradas.
Pré-requisitos
- Token de acesso do Feishu configurado (via variável de ambiente
FEISHU_TOKENou arquivo de configuração). - Acesso à internet para consultar a documentação oficial.
Exemplo
# Suponha que o usuário queira criar um registro em um aplicativo personalizado
# Este comando seria gerado dinamicamente com base na documentação
curl -X POST https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records \
-H "Authorization: Bearer $FEISHU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"fields": {"Nome": "João", "Idade": 30}}'
Limitações
- Depende da disponibilidade e precisão da documentação oficial.
- Pode exigir interpretação adicional para schemas complexos.
Suporte
Para problemas, consulte a documentação do Feishu OpenAPI ou o repositório do skill.