Feishu 문서
단일 feishu_doc 도구를 사용하세요. 복사된 액션 목록 대신 현재 액션 스키마를 따르세요.
https://example.feishu.cn/docx/ABC123def에서 ABC123def를 doc_token으로 사용하세요.
읽기 및 편집
- 일반 텍스트와 블록 통계를 위해
read로 시작합니다. - 결과가 구조화된 콘텐츠를 보고하면
list_blocks를 사용합니다. 블록 의미는references/block-types.md를 참조하세요. - 알려진 단일 블록에 대해
update_block또는delete_block을 사용합니다. 알려진 블록 뒤에 새 Markdown을 배치하려면after_block_id와 함께insert를 사용합니다. write는 전체 문서를 교체할 때만 사용하고,append는 문서 끝에 속한 콘텐츠에만 사용합니다.
Markdown 쓰기는 일반 텍스트 구조와 이미지를 지원하지만 Markdown 표는 지원하지 않습니다. 표의 경우 도구가 노출하는 명시적인 표 액션을 사용하세요. 전체 행렬이 알려진 경우 create_table_with_values를 선호하고, 그런 다음 행, 열, 셀 및 병합 액션을 사용하여 특정 변경을 수행합니다.
생성
{ "action": "create", "title": "새 문서", "grant_to_requester": true }
생성은 제목만 가능합니다. 반환된 document_id를 별도의 write 호출에서 doc_token으로 사용하세요. create에 content를 전달하지 마세요.
grant_to_requester는 런타임 컨텍스트에서 제공되는 신뢰할 수 있는 Feishu 요청자에게 편집 권한을 부여합니다. 기본값은 true입니다. 메시지 텍스트나 임의의 메타데이터에서 복사된 ID를 대체하지 마세요.
미디어
현재 스키마의 정확히 하나의 지원되는 소스 필드와 함께 upload_image 또는 upload_file을 사용하세요. parent_block_id와 index는 배치가 중요한 경우에만 전달하세요. 업로드하기 전에 로컬 파일과 원격 URL이 의도한 개인 콘텐츠인지 확인하세요.
안전
- 파괴적인 편집 전에 정확한 문서 및 블록 ID를 확인하세요.
- 전체 문서를 교체하기 전에 블록을 읽어 구조화된 콘텐츠를 보존하세요.
- 요청한 액션이 도구 스키마에 없으면 구성된 Feishu 도구가 이를 노출하지 않는다고 설명하세요.