문서
에이전트로 발행하기
AI와 대화하면서 글을 올릴 때, 화면 뒤에서 어떤 도구가 어떤 순서로 불리는지 정리했어요.
사람은 무엇을 올릴지만 말해요. AI가 list_accounts로 연결된 채널을 확인하고 publish를 불러요. 계정 id 같은 값은 사람이 몰라도 돼요.
발행은 바로 끝나지 않아요. publish는 202와 발행 id를 먼저 돌려줘요. 각 채널(대상)은 잠시 publishing 상태에 있고, AI는 모든 대상이 published나 failed가 될 때까지 get_post로 상태를 다시 확인해요.
예약은 모든 채널에서 돼요. publish에 scheduledAt을 넣으면 포샌디가 글을 보관했다가 그 시각에 보내요. 채널은 가리지 않아요. scheduledAt에는 시간대 오프셋이 꼭 있어야 해서, AI는 시간대를 짐작하지 말고 사람에게 물어봐야 해요.
예약과 초안은 이렇게 다뤄요.
draft: true를 넣으면 보내지 않고 저장만 해요. 대시보드에서 마무리하거나, AI가update_post로 고친 뒤publish_now로 보내요.list_posts를statusscheduled로 부르면 "이번 주에 뭐 나가?"에 답할 수 있어요.- YouTube, Facebook 피드, 네이버 블로그는 채널 자체 예약 기능도 있어요. API로 그대로 쓸 수 있지만, 여러 채널에 같이 나가는 글이면 글 단위
scheduledAt을 써요.
한 번 왕복하는 전체 흐름
1. list_accounts -> [{ id: "acc_01H...", platform: "threads", status: "active" }]
2. publish -> { id: "post_01H...", status: "publishing" }
3. get_post -> targets[0].status === "publishing"
4. get_post (4s later) -> targets[0].status === "published", url: "https://..."
5. reply -> answers the post (replyTo omitted)
6. list_replies -> the thread, including that reply
7. reply + replyTo -> answers that reply, one level deeper
제한 검사는 발행 전에 끝나요. 고른 채널 중 한 곳이라도 글자 수를 넘으면 어느 채널에도 올라가지 않고, 발행 기록도 생기지 않아요. 일부 채널에만 올라간 글은 정리하기가 더 번거롭기 때문이에요.
재시도는 실패한 대상만 다시 보내요. retry_post는 이미 올라간 대상을 건너뛰어요. 두 번 불러도 같은 글이 두 번 올라가지 않아요.
AI에게 이렇게 말하면 돼요
명령어를 외울 필요 없이 평소 말투로 말하면 돼요. 어떤 도구를 쓸지는 AI가 골라요.
지금 연결된 채널 뭐 있어?
스레드에 올려줘: 오늘 댓글 기능 업데이트했어요.
이 글 스레드용으로 나눠서 올려줘. 읽기 편한 데서 끊어 줘.
올리고 진짜 올라갔는지 확인되면 알려줘.
이 링크의 이미지 가져와서 이 문구랑 같이 올려줘.
사진이 내 노트북에 있어. 올릴 수 있는 링크 하나 줘.
어제 올린 글 반응 어때?
그 글 댓글 보여주고, 가격 물어본 댓글에만 답해줘.
그 답글 숨겨줘.
한 시간 전에 올린 글 지워줘.
오늘 발행 한도 얼마나 남았어?
자주 묻는 것
발행은 얼마나 걸려요?
publish는 202와 발행 id를 바로 돌려주고, 채널에 올라가는 건 그 뒤에 끝나요. AI가 get_post로 다시 확인하면서 모든 대상이 publishing 상태를 벗어날 때까지 기다려요.
한 채널에서 글자 수가 넘치면 어떻게 돼요?
어느 채널에도 올라가지 않고 발행 기록도 생기지 않아요. 검사가 발행보다 먼저 이뤄지기 때문이에요. 채널별 글자 수 제한은 플랫폼에서 확인해요.
재시도를 두 번 해도 괜찮아요?
괜찮아요. retry_post는 실패한 대상만 다시 보내고 이미 올라간 대상은 건너뛰어요. 두 번 불러도 중복으로 올라가지 않아요. 도구별 자세한 설명은 도구 레퍼런스에 있어요.