# IRPCAgent.CreateAgentResponse

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Vault API](https://developer.m-files.com/APIs/gRPC-API/vault/index.md) > [Aino agents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CreateAgentResponse/

Badges: `Vault API / standard` `write` `session` `idempotent` `returns metadata structure version`

Sends one turn to the general Aino agent and returns its answer. Used by M-Files clients; the
request and response formats are internal to them.

- **Service:** [Aino agents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/index.md) `MFiles.IRPCAgent`
- **gRPC method:** `/MFiles.IRPCAgent/CreateAgentResponse`
- **HTTP (mf-http-grpc):** `POST /grpc/v1/create-agent-response`
- **Request:** [`CreateAgentResponseRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CreateAgentResponse/index.md#request)
- **Response:** [`CreateAgentResponseResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCAgent/CreateAgentResponse/index.md#response)
- **Book and level:** Vault API, standard
- **Kind:** write
- **Session:** Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
- **Idempotent:** yes
- **Returns metadata structure version:** yes (in the mfiles-metadata-version-bin trailer)
- **Streaming:** none (unary)

<a id="remarks"></a>

## Remarks

- Requires a vault session of a user and a vault whose subscription includes Aino.
- The server forwards the request as given and returns the agent's answer unchanged.

<a id="request"></a>

## Request: CreateAgentResponseRequest

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `agent_request` | [`AgentRequest`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AgentRequest/index.md) | The request document, in a format internal to the M-Files clients. |
| `agent_request.data` | `string` | The request document, in a format internal to the M-Files clients. |

<a id="response"></a>

## Response: CreateAgentResponseResponse

> Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

| Field | Type | Description |
|---|---|---|
| `agent_response` | [`AgentResponse`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AgentResponse/index.md) | The agent's answer. |
| `agent_response.data` | `string` | The answer document, in a format internal to the M-Files clients. |