> ## 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

> A2A로 다른 AI 에이전트가 Tello 에이전트를 호출하게 연결해요.

## 할 수 있는 일

외부 에이전트가 A2A 프로토콜(JSON-RPC)로 Tello 에이전트를 호출하게 연결해요. Agent Card로
기능 명세를 조회하고 `message/send`로 메시지를 보내요. 발급한 키마다 연결할 에이전트를
지정할 수 있어요.

```bash A2A Endpoint theme={null}
https://api.telloai.io
```

## 시작하기 전에

포털 로그인이 필요해요. 키에 에이전트를 연결하려면 에이전트를 먼저 만들어 두면 선택할 수
있어요(연결은 선택이에요).

## 사용 방법

포털 **A2A** 화면 위쪽의 **A2A Endpoint**와 **Agent Card** 주소를 복사해요.
`+ 새 Key 발급`에서 키 이름과 **연결 에이전트**(선택)를 정해 발급해요. 발급된 키의 연결
에이전트는 목록의 드롭다운에서 언제든 바꿀 수 있어요.

인증은 `Authorization: Bearer <A2A_KEY>` 헤더를 써요.

### Agent Card

에이전트의 능력·엔드포인트 정보는 well-known 경로에 있어요.

```bash theme={null}
curl "https://api.telloai.io/.well-known/agent-card.json" \
  -H "Authorization: Bearer <YOUR_A2A_KEY>"
```

### 메시지 전송

`message/send` 메서드로 작업을 넘겨요.

```bash theme={null}
curl -X POST "https://api.telloai.io" \
  -H "Authorization: Bearer <YOUR_A2A_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{ "kind": "text", "text": "예약 확인 전화를 걸어줘" }],
        "messageId": "msg-1"
      }
    }
  }'
```

| 필드                         | 설명                  |
| -------------------------- | ------------------- |
| `jsonrpc`                  | 고정값 `"2.0"`         |
| `id`                       | 요청 식별자              |
| `method`                   | `message/send`      |
| `params.message.role`      | `user`              |
| `params.message.parts`     | `{ kind, text }` 배열 |
| `params.message.messageId` | 메시지 식별자             |

<Warning>
  실제 통화가 발신돼요. 통제된 테스트 수신번호로만 시험하세요.
</Warning>

## 주의사항

* 전체 키는 발급 직후 한 번만 볼 수 있어요. 분실하면 폐기 후 재발급해요.
* 연결 에이전트는 **에이전트 미지정**으로 둘 수도 있어요.
* 폐기하면 즉시 사용할 수 없어요.
* A2A 도구를 [도구 관리](/agents/tools)에 등록할 때 서버가 Agent Card를 자동 조회하지 않아요.
  이름·설명·인증을 직접 입력해요.

## 관련 문서

* [MCP](/developer/mcp)
* [에이전트 관리](/agents/manage)