> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 오류

> A2A 인증·검증 오류 코드 15종과 각각의 대응 방법을 정리했어요.

## 할 수 있는 일

인증·검증 실패는 JSON-RPC 오류로 와요. **분기는 코드로 하세요.** 메시지는 표시용이에요.

## 인증

| 코드                       | 의미                      |
| ------------------------ | ----------------------- |
| `missing_bearer_token`   | `Authorization` 헤더가 없어요 |
| `malformed_bearer_token` | `Bearer <키>` 형식이 아니에요   |
| `unauthenticated`        | 요청이 인증되지 않았어요           |
| `api_key_not_found`      | 없는 키예요                  |
| `api_key_revoked`        | 폐기된 키예요                 |
| `account_inactive`       | 계정이 비활성이에요              |
| `agent_not_found`        | 키에 연결된 에이전트를 찾을 수 없어요   |
| `agent_inactive`         | 키에 연결된 에이전트가 비활성이에요     |

Agent Card 조회에는 인증이 필요 없어요. 이 오류들은 JSON-RPC 호출에서만 나요.

## 통화 시작

| 코드            | 의미                 |
| ------------- | ------------------ |
| `to_required` | `metadata.to`가 없어요 |

수신번호는 `params.message.metadata.to`에서만 읽어요. 자세한 건
[message/send](/developer/a2a/methods/message-send)를 보세요.

## 태스크

| 코드                           | 의미                    |
| ---------------------------- | --------------------- |
| `task_not_found`             | 없는 태스크예요              |
| `session_principal_mismatch` | 다른 계정의 태스크예요          |
| `session_not_active`         | 이미 끝난 태스크라 답변을 받지 않아요 |
| `call_not_started`           | 아직 통화가 연결되지 않았어요      |

## 답변 검증

| 코드                        | 의미                    |
| ------------------------- | --------------------- |
| `assistant_role_required` | 답변 역할이 `agent`가 아니에요  |
| `assistant_text_required` | 답변에 비어 있지 않은 텍스트가 없어요 |

## 재시도

`call_not_started`만 재시도로 풀려요. 실패가 아니라 아직 이르다는 뜻이니, 태스크를 포기하지
말고 턴을 기다렸다 다시 보내요.

나머지 14종은 요청이나 설정을 고쳐야 해요. 같은 요청을 다시 보내도 같은 오류가 나요.

## 관련 문서

* [message/send](/developer/a2a/methods/message-send)
* [태스크 상태](/developer/a2a/task-states)
* [외부에서 호출받기](/developer/a2a/inbound)