feishu-doc

Documentos Feishu

Use a ferramenta única feishu_doc. Siga seu esquema de ação atual, em vez de uma lista de ações copiada.

De https://example.feishu.cn/docx/ABC123def, use ABC123def como doc_token.

Leitura e edição

1. Comece com read para texto simples e estatísticas de blocos.
2. Se o resultado reportar conteúdo estruturado, use list_blocks; veja references/block-types.md para significados de blocos.
3. Use update_block ou delete_block para um bloco conhecido. Use insert com after_block_id para colocar novo Markdown após um bloco conhecido.
4. Use write apenas ao substituir o documento inteiro; use append apenas para conteúdo que pertence ao final.

Escritas em Markdown suportam estrutura de texto comum e imagens, mas não tabelas em Markdown. Para tabelas, use as ações explícitas de tabela expostas pela ferramenta. Prefira create_table_with_values quando a matriz completa for conhecida, depois use as ações de linha, coluna, célula e mesclagem para alterações direcionadas.

Criar document

{ "action": "create", "title": "Novo Documento", "grant_to_requester": true }

A criação é apenas com título. Use o document_id retornado como doc_token em uma chamada write separada. Não passe content para create.

grant_to_requester concede acesso de edição ao solicitante Feishu confiável fornecido pelo contexto de execução. O padrão é verdadeiro. Nunca substitua uma identidade copiada do texto da mensagem ou metadados arbitrários.

Mídia

Use upload_image ou upload_file com exatamente um campo de origem suportado do esquema atual. Passe parent_block_id e index apenas quando o posicionamento for importante. Confirme que arquivos locais e URLs remotas são o conteúdo privado pretendido antes de fazer upload.

Segurança

• Resolva IDs exatos de documentos e blocos antes de edições destrutivas.
• Preserve conteúdo estruturado lendo blocos antes da substituição do documento inteiro.
• Se uma ação solicitada estiver ausente do esquema da ferramenta, explique que a ferramenta Feishu configurada não a expõe.