읽어 오는 양 — 1,000행짜리 표를 붙이면 📏

약 20분.

이 부록에서 하는 것: 「테이블에 있는 행 나열」 도구를 1,000행짜리 표에 붙여 봅니다. 완성 신호: 1,000행 중 어디서 끊겼는지 원시 출력에서 짚고, 먼저 알려 주지는 않는다는 것을 확인한다.

왜 이걸 하나

「테이블에 있는 행 나열」은 표를 통째로 읽어 옵니다. 지원기준 표는 다섯 행이라 통째로 와도 아무 일이 없습니다.

같은 파일에 지원대상목록 이 들어 있습니다. 1,000행입니다. 같은 도구를 여기에 붙이면 무슨 일이 생기는지 봅니다.

단계

  1. 도구 탭에서 도구 추가를 엽니다. 아래쪽 탭에서 Excel Online (Business) 의 테이블에 있는 행 나열을 고릅니다.

    도구 추가 — 같은 커넥터를 한 번 더

    지원기준을 읽는 도구가 이미 있어도 새로 붙입니다. 커넥터는 하나지만, 무엇을 읽을지 정해 둔 도구는 별개입니다.

  2. 세부 정보에서 이름을 아래로 바꿉니다.

     지원대상 조회

    이어서 설명을 씁니다.

     자기계발비로 신청할 수 있는 대상 목록을 조회한다. 대상코드·대상명·지원항목·정가가 들어 있다.

    완료 기준: 도구 목록에 이름이 다른 도구가 둘이 된다.

    세부 정보 — 이름과 설명

    커넥터가 붙여 주는 이름은 테이블에 있는 행 나열 1 · 2 라 사람도 구분하지 못합니다. MS 문서는 오케스트레이터가 「이름과 설명」으로 무엇을 부를지 판단한다고 적습니다 — 설명만 잘 써도 이름이 저 상태면 반쪽입니다.

  3. 입력 항목에서 Table 을 지원대상목록 으로 지정합니다. 나머지 칸은 자기계발비_기준표.xlsx 를 가리키게 사용자 지정 값으로 채웁니다.

    완료 기준: Table 이 사용자 지정 값이고 지원대상목록 이다.

    입력 — Table을 지원대상목록으로

  4. 지침의 「답변 원칙」 아래에 한 줄을 더합니다. 도구 이름 자리에서 / 를 누릅니다.

     - 신청할 수 있는 대상 목록을 묻는 질문은 /지원대상 조회 도구로 한다.

    완료 기준: 도구 이름이 칩으로 바뀐다. 저장합니다.

    지침에 지원대상 조회 지목

    이 줄은 부록이 끝나면 지웁니다. 9번에서 되돌립니다.

  5. 새 테스트 세션에서 물어봅니다.

     자기계발비로 신청할 수 있는 게 뭐가 있어?

    완료 기준: 목록이 표로 나온다. 몇 건인지도, 잘렸다는 말도 없다.

  6. 이어서 건수를 따로 물어봅니다.

     건수가 몇건이야?

    완료 기준: 「총 256건」이라고 답하고, 더 있을 수 있다는 경고가 붙는다.

    답변 — 표, 그리고 따로 물은 건수

    물어보니 알려 줍니다. 「시스템 한 번 조회 시 최대 256건까지만 불러올 수 있어 추가 항목이 더 존재할 수 있습니다」라고 스스로 밝힙니다. 5번의 첫 답에는 없던 문장입니다. 먼저 말해 주지는 않습니다.

    그런데 1,000이라는 숫자는 끝내 안 나옵니다. 에이전트가 아는 값은 자기가 받은 256입니다. 표에 몇 행이 있는지는 모릅니다. 그래서 「담당 부서에 문의하시거나 특정 유형으로 좁혀서 문의해 주세요」로 넘깁니다 — 얼마나 빠졌는지는 아무도 모릅니다.

  7. 계약 테스트 창에서 도구 상자를 눌러 원시 출력을 엽니다. value 배열의 길이를 셉니다.

    완료 기준: 배열이 SD-0256 에서 닫힌다. SD-1000 은 없습니다.

    원시 출력 — SD-0256에서 배열이 닫힌다

    오류가 아닙니다. statusCode 는 200 이고 상자에는 체크가 붙습니다. 성공적으로 끝난 호출인데 전부 오지 않았습니다.

    이 커넥터는 기본적으로 최대 256행을 돌려줍니다.1 전부 가져오려면 페이지 매김을 켜야 하는데, 그 설정은 도구 화면에 없습니다 — 에이전트 흐름으로 내려가야 나옵니다.

  8. value 옆의 복사를 눌러 원시 출력을 전부 가져와, 토크나이저에 붙여 넣습니다. 부록 「에이전트 안에서 일어나는 일」 2부에서 쓴 그 도구입니다.

    원시 출력 복사

    완료 기준: 토큰 수를 숫자로 읽는다. 실측에서는 23,723 토큰 · 47,573자였습니다.

    토크나이저 — 원시 출력의 토큰 수

    이 숫자가 질문 한 번에 오케스트레이터로 넘어간 양입니다. 사용자는 「뭐가 있어?」 여섯 글자를 물었습니다. 지식 문서를 아무리 잘 정리해도, 도구가 이만큼을 실어 나르면 길이는 그쪽에서 정해집니다.

    색이 칠해진 것을 봅니다. ItemInternalId 의 fd350d72-3a24-48f1-9eb9-d733ca02c3f4 한 줄이 토큰 여러 개로 쪼개집니다. 쓰지도 않을 값이 자리를 차지합니다.

    이것이 256행어치입니다. 1,000행이 다 왔다면 네 배입니다.

  9. 되돌립니다. 먼저 지침에서 4번에 더한 줄을 지웁니다.

    완료 기준: 지침이 이 부록을 시작하기 전과 같아진다.

    되돌린 지침

    이어서 도구 목록에서 지원대상 조회 의 사용 설정을 끕니다.

    완료 기준: 지원대상 조회 가 회색 끄기 상태가 된다.

    지원대상 조회를 끈 도구 목록

    지우지 않고 끕니다. 다시 해보고 싶을 때 켜면 됩니다.

    반드시 되돌립니다. 지침 줄과 도구를 남겨 두면 이후 테스트가 다른 조건에서 돌아갑니다.

더 해볼 것 — 에이전트 흐름에서 읽으면

흐름 안의 「테이블에 있는 행 나열」에는 도구 화면에 없던 것이 둘 있습니다.

  무엇을 정하나
필터 쿼리 어떤 것을 읽을지
최대 개수 몇 개를 읽을지

같은 지원대상목록 을 흐름에서 읽어 보면 1,000행이 한 줄이 됩니다.

필터에 쓸 수 있는 함수는 eq · ne · contains · startswith · endswith 다섯 개이고, 한 열에 함수 하나만 걸립니다.1 지원항목 eq '온라인 강의' 는 되고, 두 조건을 한 열에 겹치는 것은 안 됩니다.

확인

  • ① 같은 커넥터로 도구를 하나 더 만들고 이름을 구분되게 지었다
  • ② 1,000행짜리 표를 읽었는데 전부 오지 않는다는 것을 원시 출력에서 확인했다
  • ③ 그 사실이 답변에도 오류에도 드러나지 않는다는 것을 확인했다
  • ④ 질문 한 번에 넘어간 양을 토큰 수로 봤다
  • ⑤ 지침 줄과 도구를 되돌렸다

출처

이 부록은 아래를 토대로 만들었습니다. 제품이 바뀌면 문헌 쪽이 먼저 낡습니다 — 수치나 주기가 걸리면 원문을 다시 확인하세요.

  • 실측 — 2026-08-20 · 전 스텝 실측(9스텝·10컷). 배열은 SD-0256 에서 닫혔고, 원시 출력은 23,723 토큰이었습니다
  • 문헌 — Excel Online (Business) 커넥터 문서1

  1. Excel Online (Business) — Microsoft Learn (확인 2026-08-18). 「List rows present in a table」 항목에 「기본적으로 최대 256행을 돌려준다. 전부 가져오려면 페이지 매김을 켜라」고 적혀 있습니다. 필터 쿼리는 eq · ne · contains · startswith · endswith 만 지원하고 한 열에 함수 하나, 정렬도 한 열만 됩니다. ↩ ↩2 ↩3

이 사이트의 소스는 GitHub에 있습니다. Just the Docs 테마로 만들었습니다.