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

# Crea Risposta

> L'AI eseguirà azioni come cercare e navigare pagine web per trovare la risposta al compito fornito. Il tempo di esecuzione è di 3-30s a seconda della complessità.  Per compiti più lunghi, usa invece l'endpoint dell'agente. Vedi [Caratteristica Agente](/features/agents). Vedi [Caratteristica Risposte](/features/answers).

## Introduzione

L'endpoint **Crea Risposta** ti permette di creare una nuova risposta nel sistema. Questo è utile quando hai bisogno di aggiungere risposte programmaticamente.

## Richiesta

Per creare una risposta, invia una richiesta `POST` all'endpoint `/v1/answers` con il payload JSON appropriato.

### Corpo della Richiesta

Il corpo della richiesta deve contenere i seguenti campi:

* **question**: La domanda a cui questa risposta si riferisce.
* **answer**: Il testo della risposta.
* **metadata**: (opzionale) Informazioni aggiuntive sulla risposta.

### Esempio di Richiesta

```json theme={null}
{
  "question": "Qual è la capitale d'Italia?",
  "answer": "Roma",
  "metadata": {
    "source": "Enciclopedia"
  }
}
```

## Risposta

Se la richiesta è riuscita, il server restituirà una risposta con codice di stato `201 Created`, insieme ai dettagli della risposta appena creata.

### Esempio di Risposta

```json theme={null}
{
  "id": "12345",
  "question": "Qual è la capitale d'Italia?",
  "answer": "Roma",
  "metadata": {
    "source": "Enciclopedia"
  },
  "created_at": "2023-10-01T12:00:00Z"
}
```

## Errori

Se c'è un problema con la richiesta, il server restituirà un codice di stato di errore e un messaggio di errore descrittivo.

### Esempi di Errori

* `400 Bad Request`: Il corpo della richiesta è malformato o mancano campi obbligatori.
* `401 Unauthorized`: Non hai l'autorizzazione per creare risposte.
* `500 Internal Server Error`: Si è verificato un errore imprevisto sul server.

## Note

Assicurati di avere le autorizzazioni necessarie per utilizzare questo endpoint. Consulta la documentazione sull'autenticazione per ulteriori dettagli.


## OpenAPI

````yaml it/openapi/answers.json POST /v1/answers
openapi: 3.0.3
info:
  title: API Risposte
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/answers:
    post:
      summary: Crea Risposta
      description: >-
        L'AI eseguirà azioni come cercare e navigare pagine web per trovare la
        risposta al compito fornito. Il tempo di esecuzione è di 3-30s a seconda
        della complessità.  Per compiti più lunghi, usa invece l'endpoint
        dell'agente. Vedi [Caratteristica Agente](/features/agents). Vedi
        [Caratteristica Risposte](/features/answers).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                task:
                  type: string
                  description: Il compito da eseguire.
                json_format:
                  type: object
                  description: >-
                    L'oggetto JSON di output desiderato con valori vuoti come
                    schema, o semplicemente descrivi i dati che vuoi come
                    stringa.
              required:
                - task
      responses:
        '200':
          description: Risposta riuscita con la risposta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  object:
                    type: string
                  created:
                    type: integer
                  metadata:
                    type: object
                  task:
                    type: string
                  result:
                    type: object
                    properties:
                      json_content:
                        type: string
                      json_hosted_url:
                        type: string
        '400':
          description: Richiesta Errata (Compito Mancante)
        '402':
          description: Chiave API Non Valida
        '500':
          description: Errore Interno del Server
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Intestazione di autenticazione Bearer del tipo Bearer <token>, dove
        <token> è il tuo token di autenticazione.

````